From 7148576e77b394f7084fe4a0a2c2de4a7005f151 Mon Sep 17 00:00:00 2001
From: Mouse <mouse0w0@qq.com>
Date: Wed, 17 Jul 2024 21:58:59 +0800
Subject: [PATCH] Deployed c2c736e with MkDocs version: 1.6.0

---
 01-first-steps/index.html                     | 368 ++++++++---------
 02-the-game-loop/index.html                   | 371 ++++++++---------
 03-a-brief-about-coordinates/index.html       | 371 ++++++++---------
 04-rendering/index.html                       | 371 ++++++++---------
 05-more-on-rendering/index.html               | 371 ++++++++---------
 06-transformations/index.html                 | 371 ++++++++---------
 07-textures/index.html                        | 371 ++++++++---------
 08-camera/index.html                          | 371 ++++++++---------
 09-loading-more-complex-models/index.html     | 371 ++++++++---------
 10-let-there-be-light/index.html              | 371 ++++++++---------
 11-let-there-be-even-more-light/index.html    | 371 ++++++++---------
 12-game-hud/index.html                        | 371 ++++++++---------
 13-sky-box-and-some-optimizations/index.html  | 371 ++++++++---------
 14-height-maps/index.html                     | 371 ++++++++---------
 15-terrain-collisions/index.html              | 376 ++++++++----------
 16-fog/index.html                             | 371 ++++++++---------
 17-normal-mapping/index.html                  | 371 ++++++++---------
 18-shadows/index.html                         | 371 ++++++++---------
 19-animations/index.html                      | 371 ++++++++---------
 20-particles/index.html                       | 371 ++++++++---------
 21-instanced-rendering/index.html             | 371 ++++++++---------
 22-audio/index.html                           | 371 ++++++++---------
 23-3d-object-picking/index.html               | 371 ++++++++---------
 24-hud-revisited/index.html                   | 371 ++++++++---------
 25-optimizations-frustum-culling/index.html   | 371 ++++++++---------
 26-cascaded-shadow-maps/index.html            | 371 ++++++++---------
 27-assimp/index.html                          | 371 ++++++++---------
 28-deferred-shading/index.html                | 371 ++++++++---------
 404.html                                      | 341 ++++++++--------
 a01-opengl-debugging/index.html               | 371 ++++++++---------
 .../fonts/Roboto-Slab-Bold.woff               | Bin
 .../fonts/Roboto-Slab-Bold.woff2              | Bin
 .../fonts/Roboto-Slab-Regular.woff            | Bin
 .../fonts/Roboto-Slab-Regular.woff2           | Bin
 {fonts => css/fonts}/fontawesome-webfont.eot  | Bin
 {fonts => css/fonts}/fontawesome-webfont.svg  |   0
 {fonts => css/fonts}/fontawesome-webfont.ttf  | Bin
 {fonts => css/fonts}/fontawesome-webfont.woff | Bin
 .../fonts}/fontawesome-webfont.woff2          | Bin
 .../fonts/lato-bold-italic.woff               | Bin
 .../fonts/lato-bold-italic.woff2              | Bin
 {fonts/Lato => css/fonts}/lato-bold.woff      | Bin
 {fonts/Lato => css/fonts}/lato-bold.woff2     | Bin
 .../fonts/lato-normal-italic.woff             | Bin
 .../fonts/lato-normal-italic.woff2            | Bin
 .../fonts/lato-normal.woff                    | Bin
 .../fonts/lato-normal.woff2                   | Bin
 css/theme.css                                 |  13 +-
 css/theme_extra.css                           |  40 +-
 fonts/Lato/lato-bold.eot                      | Bin 256056 -> 0 bytes
 fonts/Lato/lato-bold.ttf                      | Bin 600856 -> 0 bytes
 fonts/Lato/lato-bolditalic.eot                | Bin 266158 -> 0 bytes
 fonts/Lato/lato-bolditalic.ttf                | Bin 622572 -> 0 bytes
 fonts/Lato/lato-italic.eot                    | Bin 268604 -> 0 bytes
 fonts/Lato/lato-italic.ttf                    | Bin 639388 -> 0 bytes
 fonts/Lato/lato-regular.eot                   | Bin 253461 -> 0 bytes
 fonts/Lato/lato-regular.ttf                   | Bin 607720 -> 0 bytes
 fonts/RobotoSlab/roboto-slab-v7-bold.eot      | Bin 79520 -> 0 bytes
 fonts/RobotoSlab/roboto-slab-v7-bold.ttf      | Bin 170616 -> 0 bytes
 fonts/RobotoSlab/roboto-slab-v7-regular.eot   | Bin 78331 -> 0 bytes
 fonts/RobotoSlab/roboto-slab-v7-regular.ttf   | Bin 169064 -> 0 bytes
 fonts/RobotoSlab/roboto-slab.eot              | Bin 78331 -> 0 bytes
 glossary/index.html                           | 370 ++++++++---------
 index.html                                    | 366 ++++++++---------
 js/html5shiv.min.js                           |   4 +
 js/jquery-2.1.1.min.js                        |   4 -
 js/jquery-3.6.0.min.js                        |   2 +
 js/modernizr-2.8.3.min.js                     |   1 -
 js/theme.js                                   |   5 +-
 search.html                                   | 343 ++++++++--------
 search/lunr.js                                |   2 +-
 search/main.js                                |   9 +-
 search/search_index.json                      |   2 +-
 sitemap.xml                                   | 155 --------
 sitemap.xml.gz                                | Bin 217 -> 127 bytes
 75 files changed, 5703 insertions(+), 6715 deletions(-)
 rename fonts/RobotoSlab/roboto-slab-v7-bold.woff => css/fonts/Roboto-Slab-Bold.woff (100%)
 rename fonts/RobotoSlab/roboto-slab-v7-bold.woff2 => css/fonts/Roboto-Slab-Bold.woff2 (100%)
 rename fonts/RobotoSlab/roboto-slab-v7-regular.woff => css/fonts/Roboto-Slab-Regular.woff (100%)
 rename fonts/RobotoSlab/roboto-slab-v7-regular.woff2 => css/fonts/Roboto-Slab-Regular.woff2 (100%)
 rename {fonts => css/fonts}/fontawesome-webfont.eot (100%)
 rename {fonts => css/fonts}/fontawesome-webfont.svg (100%)
 rename {fonts => css/fonts}/fontawesome-webfont.ttf (100%)
 rename {fonts => css/fonts}/fontawesome-webfont.woff (100%)
 rename {fonts => css/fonts}/fontawesome-webfont.woff2 (100%)
 rename fonts/Lato/lato-bolditalic.woff => css/fonts/lato-bold-italic.woff (100%)
 rename fonts/Lato/lato-bolditalic.woff2 => css/fonts/lato-bold-italic.woff2 (100%)
 rename {fonts/Lato => css/fonts}/lato-bold.woff (100%)
 rename {fonts/Lato => css/fonts}/lato-bold.woff2 (100%)
 rename fonts/Lato/lato-italic.woff => css/fonts/lato-normal-italic.woff (100%)
 rename fonts/Lato/lato-italic.woff2 => css/fonts/lato-normal-italic.woff2 (100%)
 rename fonts/Lato/lato-regular.woff => css/fonts/lato-normal.woff (100%)
 rename fonts/Lato/lato-regular.woff2 => css/fonts/lato-normal.woff2 (100%)
 delete mode 100755 fonts/Lato/lato-bold.eot
 delete mode 100755 fonts/Lato/lato-bold.ttf
 delete mode 100755 fonts/Lato/lato-bolditalic.eot
 delete mode 100755 fonts/Lato/lato-bolditalic.ttf
 delete mode 100755 fonts/Lato/lato-italic.eot
 delete mode 100755 fonts/Lato/lato-italic.ttf
 delete mode 100755 fonts/Lato/lato-regular.eot
 delete mode 100755 fonts/Lato/lato-regular.ttf
 delete mode 100755 fonts/RobotoSlab/roboto-slab-v7-bold.eot
 delete mode 100755 fonts/RobotoSlab/roboto-slab-v7-bold.ttf
 delete mode 100755 fonts/RobotoSlab/roboto-slab-v7-regular.eot
 delete mode 100755 fonts/RobotoSlab/roboto-slab-v7-regular.ttf
 delete mode 100755 fonts/RobotoSlab/roboto-slab.eot
 create mode 100755 js/html5shiv.min.js
 delete mode 100755 js/jquery-2.1.1.min.js
 create mode 100755 js/jquery-3.6.0.min.js
 delete mode 100755 js/modernizr-2.8.3.min.js

diff --git a/01-first-steps/index.html b/01-first-steps/index.html
index ef7bd53..6716a9b 100755
--- a/01-first-steps/index.html
+++ b/01-first-steps/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>事前准备 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u4e8b\u524d\u51c6\u5907";
-    var mkdocs_page_input_path = "01-first-steps.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>事前准备 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u4e8b\u524d\u51c6\u5907";
+        var mkdocs_page_input_path = "01-first-steps.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">事前准备</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">事前准备</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>事前准备</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">事前准备</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/01-first-steps.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/01-first-steps.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="first-steps">事前准备（First Steps）</h1>
 <p>在本书中，我们将学习开发3D游戏所涉及的主要技术。本书将使用Java语言和Java轻量级游戏库(<a href="http://www.lwjgl.org/">LWJGL</a>)来编写示例代码。LWJGL库允许我们访问底层的API（应用程序接口），例如OpenGL。</p>
@@ -269,29 +250,21 @@
 <p><strong>本书中源代码发布于<a href="https://github.com/lwjglgamedev/lwjglbook"><strong>GitHub</strong></a></strong>。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
         <a href="../02-the-game-loop/" class="btn btn-neutral float-right" title="游戏循环">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -299,11 +272,11 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -312,15 +285,16 @@
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/02-the-game-loop/index.html b/02-the-game-loop/index.html
index f6da4de..518d65b 100755
--- a/02-the-game-loop/index.html
+++ b/02-the-game-loop/index.html
@@ -1,210 +1,191 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>游戏循环 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6e38\u620f\u5faa\u73af";
-    var mkdocs_page_input_path = "02-the-game-loop.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>游戏循环 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6e38\u620f\u5faa\u73af";
+        var mkdocs_page_input_path = "02-the-game-loop.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">游戏循环</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">游戏循环</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#osx">平台差异（OSX）</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>游戏循环</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">游戏循环</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/02-the-game-loop.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/02-the-game-loop.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="the-game-loop">游戏循环（The Game Loop）</h1>
 <p>在本章中，我们将通过创建游戏循环来开始开发游戏引擎。游戏循环是每个游戏的核心部分，它基本上是一个无休止的循环，负责周期地处理用户的输入、更新游戏状态和渲染图像到屏幕上。</p>
@@ -430,31 +411,22 @@ protected void render() {
 <p>这将使程序使用OpenGL 3.2到4.1之间的最高版本。如果没有上述代码，就会使用旧版本的OpenGL。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../01-first-steps/" class="btn btn-neutral float-left" title="事前准备"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../03-a-brief-about-coordinates/" class="btn btn-neutral float-right" title="坐标简介">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../01-first-steps/" class="btn btn-neutral" title="事前准备"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -462,11 +434,11 @@ protected void render() {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -477,15 +449,16 @@ protected void render() {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/03-a-brief-about-coordinates/index.html b/03-a-brief-about-coordinates/index.html
index 7d92c6a..a84ffe9 100755
--- a/03-a-brief-about-coordinates/index.html
+++ b/03-a-brief-about-coordinates/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>坐标简介 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u5750\u6807\u7b80\u4ecb";
-    var mkdocs_page_input_path = "03-a-brief-about-coordinates.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>坐标简介 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u5750\u6807\u7b80\u4ecb";
+        var mkdocs_page_input_path = "03-a-brief-about-coordinates.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">坐标简介</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">坐标简介</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>坐标简介</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">坐标简介</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/03-a-brief-about-coordinates.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/03-a-brief-about-coordinates.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="a-brief-about-coordinates">坐标简介（A brief about coordinates）</h1>
 <p>本章中我们将讨论坐标和坐标系（Coordinate System），尝试以简单的方式介绍一些基本的数学概念，为后面章节将要介绍的技术和内容提供帮助。我们将会将一些内容简化，以易于学习，但牺牲了准确性。</p>
@@ -229,31 +210,22 @@
 <p>如果你不能清楚地理解这些概念，别担心。在下一章中，它们将用实例表现出来。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../02-the-game-loop/" class="btn btn-neutral float-left" title="游戏循环"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../04-rendering/" class="btn btn-neutral float-right" title="渲染">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../02-the-game-loop/" class="btn btn-neutral" title="游戏循环"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -261,11 +233,11 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -276,15 +248,16 @@
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/04-rendering/index.html b/04-rendering/index.html
index 5ed46e8..3765a5e 100755
--- a/04-rendering/index.html
+++ b/04-rendering/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>渲染 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6e32\u67d3";
-    var mkdocs_page_input_path = "04-rendering.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>渲染 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6e32\u67d3";
+        var mkdocs_page_input_path = "04-rendering.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">渲染</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">渲染</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>渲染</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">渲染</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/04-rendering.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/04-rendering.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="rendering">渲染（Rendering）</h1>
 <p>在本章中，我们将学习用OpenGL渲染场景时要做的事项。如果你已经习惯了OpenGL的旧版本，习惯了使用固定管线，你可能会跳过这一章，不想知道为什么它需要这么复杂。它其实更简单、更灵活，你只需要给它一个表现的机会。现代OpenGL使你只需考虑一个问题，这可以使你以更合理的方式组织代码和开发。</p>
@@ -537,31 +518,22 @@ glBindVertexArray(0);
 <p>这就是我们的第一个三角形！你也许会想这并不会使它成为前十名的游戏，你的想法是对的。你也可以认为这是一件无聊的事情来画一个无聊的三角形。但请记住，我们正在介绍关键的概念，并准备基于架构来做更复杂的事情，请耐心等待，继续阅读。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../03-a-brief-about-coordinates/" class="btn btn-neutral float-left" title="坐标简介"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../05-more-on-rendering/" class="btn btn-neutral float-right" title="渲染补充">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../03-a-brief-about-coordinates/" class="btn btn-neutral" title="坐标简介"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -569,11 +541,11 @@ glBindVertexArray(0);
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -584,15 +556,16 @@ glBindVertexArray(0);
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/05-more-on-rendering/index.html b/05-more-on-rendering/index.html
index e251f8c..d3e278f 100755
--- a/05-more-on-rendering/index.html
+++ b/05-more-on-rendering/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>渲染补充 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6e32\u67d3\u8865\u5145";
-    var mkdocs_page_input_path = "05-more-on-rendering.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>渲染补充 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6e32\u67d3\u8865\u5145";
+        var mkdocs_page_input_path = "05-more-on-rendering.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">渲染补充</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">渲染补充</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>渲染补充</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">渲染补充</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/05-more-on-rendering.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/05-more-on-rendering.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="more-on-rendering">渲染补充（More on Rendering）</h1>
 <p>本章我们将继续讲述OpenGL如何渲染物体。为了整理代码，我们要创建一个名为<code>Mesh</code>的新类，把一个位置数组作为输入，为需要加载到显卡中的模型创建VBO和VAO对象。</p>
@@ -465,31 +446,22 @@ void main()
 <p><img alt="色彩鲜艳的正方形" src="../_static/05/coloured_quad.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../04-rendering/" class="btn btn-neutral float-left" title="渲染"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../06-transformations/" class="btn btn-neutral float-right" title="变换">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../04-rendering/" class="btn btn-neutral" title="渲染"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -497,11 +469,11 @@ void main()
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -512,15 +484,16 @@ void main()
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/06-transformations/index.html b/06-transformations/index.html
index 2c3dc1b..4028be9 100755
--- a/06-transformations/index.html
+++ b/06-transformations/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>变换 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u53d8\u6362";
-    var mkdocs_page_input_path = "06-transformations.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>变换 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u53d8\u6362";
+        var mkdocs_page_input_path = "06-transformations.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">变换</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">变换</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">投影</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#_2">使用变换</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>变换</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">变换</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/06-transformations.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/06-transformations.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="transformations">变换（Transformations）</h1>
 <h2 id="_1">投影</h2>
@@ -569,31 +550,22 @@ void main()
 <p>最后只需要修改<code>DummyGame</code>类，创建一个<code>GameItem</code>实例，让其与<code>Mesh</code>关联，并添加一些逻辑来位移、旋转和缩放四边形。因为这只是个测试示例，没有添加太多内容，所以你可以在本书的源代码中找到相关代码。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../05-more-on-rendering/" class="btn btn-neutral float-left" title="渲染补充"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../07-textures/" class="btn btn-neutral float-right" title="纹理">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../05-more-on-rendering/" class="btn btn-neutral" title="渲染补充"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -601,11 +573,11 @@ void main()
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -616,15 +588,16 @@ void main()
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/07-textures/index.html b/07-textures/index.html
index 89eee70..af21b34 100755
--- a/07-textures/index.html
+++ b/07-textures/index.html
@@ -1,77 +1,70 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>纹理 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u7eb9\u7406";
-    var mkdocs_page_input_path = "07-textures.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>纹理 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u7eb9\u7406";
+        var mkdocs_page_input_path = "07-textures.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">纹理</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">纹理</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">创建一个三维立方体</a>
     </li>
@@ -80,135 +73,123 @@
     <li class="toctree-l2"><a class="reference internal" href="#_3">透明纹理简介</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>纹理</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">纹理</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/07-textures.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/07-textures.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="textures">纹理（Textures）</h1>
 <h2 id="_1">创建一个三维立方体</h2>
@@ -524,31 +505,22 @@ glBindTexture(GL_TEXTURE_2D, texture.getId());
 <p>即使启用了混合并设置了功能，也可能看不到正确的透明效果。其原因是深度测试，当使用深度值丢弃片元时，我们可能将具有透明度的片元与背景混合，而不是与它们后面的片元混合，这将得到错误的渲染结果。为了解决该问题，我们需要先绘制不透明物体，然后按深度递减顺序绘制具有透明度的物体（应先绘制较远物体）。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../06-transformations/" class="btn btn-neutral float-left" title="变换"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../08-camera/" class="btn btn-neutral float-right" title="摄像机">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../06-transformations/" class="btn btn-neutral" title="变换"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -556,11 +528,11 @@ glBindTexture(GL_TEXTURE_2D, texture.getId());
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -571,15 +543,16 @@ glBindTexture(GL_TEXTURE_2D, texture.getId());
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/08-camera/index.html b/08-camera/index.html
index ae193ce..2e7d2e8 100755
--- a/08-camera/index.html
+++ b/08-camera/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>摄像机 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6444\u50cf\u673a";
-    var mkdocs_page_input_path = "08-camera.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>摄像机 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6444\u50cf\u673a";
+        var mkdocs_page_input_path = "08-camera.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">摄像机</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">摄像机</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>摄像机</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">摄像机</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/08-camera.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/08-camera.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="camera">摄像机（Camera）</h1>
 <p>本章中我们将学习如何在渲染的三维场景中移动。该功能就像是有一台可以在三维世界中运动的摄像机，然而事实上摄像机就是描述该功能的术语。</p>
@@ -503,31 +484,22 @@ gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4};
 <p><img alt="立方体们" src="../_static/08/cubes.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../07-textures/" class="btn btn-neutral float-left" title="纹理"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../09-loading-more-complex-models/" class="btn btn-neutral float-right" title="加载更复杂的模型">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../07-textures/" class="btn btn-neutral" title="纹理"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -535,11 +507,11 @@ gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4};
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -550,15 +522,16 @@ gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4};
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/09-loading-more-complex-models/index.html b/09-loading-more-complex-models/index.html
index 32fc8de..1d629c3 100755
--- a/09-loading-more-complex-models/index.html
+++ b/09-loading-more-complex-models/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>加载更复杂的模型 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b";
-    var mkdocs_page_input_path = "09-loading-more-complex-models.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>加载更复杂的模型 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b";
+        var mkdocs_page_input_path = "09-loading-more-complex-models.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">加载更复杂的模型</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">加载更复杂的模型</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>加载更复杂的模型</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">加载更复杂的模型</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/09-loading-more-complex-models.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/09-loading-more-complex-models.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="loading-more-complex-models">加载更复杂的模型（Loading more complex models）</h1>
 <p>本章中我们将学习加载在外部文件中定义的复杂模型。这些模型将使用3D建模工具(例如<a href="https://www.blender.org/">Blender</a>)创建。到目前为止，我们已经通过直接编码定义其几何图形的数组来创建模型。但在本章中，我们将学习如何加载以OBJ格式定义的模型。</p>
@@ -513,31 +494,22 @@ gameItems = new GameItem[]{gameItem};
 <p><img alt="边分割" src="../_static/09/edge_split.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../08-camera/" class="btn btn-neutral float-left" title="摄像机"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../10-let-there-be-light/" class="btn btn-neutral float-right" title="要有光">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../08-camera/" class="btn btn-neutral" title="摄像机"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -545,11 +517,11 @@ gameItems = new GameItem[]{gameItem};
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -560,15 +532,16 @@ gameItems = new GameItem[]{gameItem};
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/10-let-there-be-light/index.html b/10-let-there-be-light/index.html
index f90871c..856577e 100755
--- a/10-let-there-be-light/index.html
+++ b/10-let-there-be-light/index.html
@@ -1,89 +1,82 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>要有光 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u8981\u6709\u5149";
-    var mkdocs_page_input_path = "10-let-there-be-light.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>要有光 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u8981\u6709\u5149";
+        var mkdocs_page_input_path = "10-let-there-be-light.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">要有光</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">要有光</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">环境光分量</a>
     </li>
@@ -96,123 +89,111 @@
     <li class="toctree-l2"><a class="reference internal" href="#_5">实现</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>要有光</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">要有光</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/10-let-there-be-light.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/10-let-there-be-light.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="let-there-be-light">要有光（Let there be light）</h1>
 <p>在本章中，我们将学习如何为3D游戏引擎添加光照。我们不会去实现一个完美的光照模型，因为抛开复杂性不谈，它还需要消耗大量的计算机资源，相反我们只需要一个近似的、像样的光照效果：我们将使用名为 <strong>Phong</strong> 的着色算法（由Bui Tuong Phong开发）。另一个需要注意的是，我们将只模拟光照，但不会模拟这些光照所产生的阴影（这将在后续章节中实现）。</p>
@@ -514,31 +495,22 @@ shaderProgram.setUniform(&quot;pointLight&quot;, currPointLight);
 <p><img alt="光照效果" src="../_static/10/lightning_result.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../09-loading-more-complex-models/" class="btn btn-neutral float-left" title="加载更复杂的模型"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../11-let-there-be-even-more-light/" class="btn btn-neutral float-right" title="要有更多的光">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../09-loading-more-complex-models/" class="btn btn-neutral" title="加载更复杂的模型"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -546,11 +518,11 @@ shaderProgram.setUniform(&quot;pointLight&quot;, currPointLight);
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -561,15 +533,16 @@ shaderProgram.setUniform(&quot;pointLight&quot;, currPointLight);
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/11-let-there-be-even-more-light/index.html b/11-let-there-be-even-more-light/index.html
index 3018542..b1fc04f 100755
--- a/11-let-there-be-even-more-light/index.html
+++ b/11-let-there-be-even-more-light/index.html
@@ -1,93 +1,86 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>要有更多的光 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u8981\u6709\u66f4\u591a\u7684\u5149";
-    var mkdocs_page_input_path = "11-let-there-be-even-more-light.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>要有更多的光 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u8981\u6709\u66f4\u591a\u7684\u5149";
+        var mkdocs_page_input_path = "11-let-there-be-even-more-light.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">要有更多的光</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">要有更多的光</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">平行光</a>
     </li>
@@ -96,119 +89,107 @@
     <li class="toctree-l2"><a class="reference internal" href="#_3">多光源</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>要有更多的光</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">要有更多的光</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/11-let-there-be-even-more-light.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/11-let-there-be-even-more-light.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="let-there-be-even-more-light">要有更多的光（Let there be even more light）</h1>
 <p>在本章中，我们将实现在此前章节中介绍的其他类型的光。我们先从平行光开始。</p>
@@ -463,31 +444,22 @@ public void setUniform(String uniformName, SpotLight spotLight, int pos) {
 <p><img alt="多光源" src="../_static/11/multiple_lights.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../10-let-there-be-light/" class="btn btn-neutral float-left" title="要有光"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../12-game-hud/" class="btn btn-neutral float-right" title="游戏HUD">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../10-let-there-be-light/" class="btn btn-neutral" title="要有光"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -495,11 +467,11 @@ public void setUniform(String uniformName, SpotLight spotLight, int pos) {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -510,15 +482,16 @@ public void setUniform(String uniformName, SpotLight spotLight, int pos) {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/12-game-hud/index.html b/12-game-hud/index.html
index 3c265a9..8a263f9 100755
--- a/12-game-hud/index.html
+++ b/12-game-hud/index.html
@@ -1,97 +1,90 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>游戏HUD - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6e38\u620fHUD";
-    var mkdocs_page_input_path = "12-game-hud.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>游戏HUD - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6e38\u620fHUD";
+        var mkdocs_page_input_path = "12-game-hud.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">游戏HUD</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">游戏HUD</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">文本渲染</a>
     </li>
@@ -102,115 +95,103 @@
     <li class="toctree-l2"><a class="reference internal" href="#osx">OSX</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>游戏HUD</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">游戏HUD</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/12-game-hud.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/12-game-hud.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="hudgame-hud">游戏HUD（Game HUD）</h1>
 <p>在本章中，我们将为游戏创建一个HUD（Heads-Up Display，平视显示器）。换句话说，就是一组用于在三维场景上，随时显示相关信息的二维图形和文本。本例中将创建一个简单的HUD，这可为我们展现一些显示信息的基本技术。</p>
@@ -704,31 +685,22 @@ if (mouseInput.isRightButtonPressed()) {
 <p>一个更简洁的方法是使用<a href="https://github.com/nothings/stb/">stb</a>库来渲染文本。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../11-let-there-be-even-more-light/" class="btn btn-neutral float-left" title="要有更多的光"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../13-sky-box-and-some-optimizations/" class="btn btn-neutral float-right" title="天空盒与一些优化">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../11-let-there-be-even-more-light/" class="btn btn-neutral" title="要有更多的光"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -736,11 +708,11 @@ if (mouseInput.isRightButtonPressed()) {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -751,15 +723,16 @@ if (mouseInput.isRightButtonPressed()) {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/13-sky-box-and-some-optimizations/index.html b/13-sky-box-and-some-optimizations/index.html
index 67d29a2..dc4baab 100755
--- a/13-sky-box-and-some-optimizations/index.html
+++ b/13-sky-box-and-some-optimizations/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>天空盒与一些优化 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316";
-    var mkdocs_page_input_path = "13-sky-box-and-some-optimizations.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>天空盒与一些优化 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316";
+        var mkdocs_page_input_path = "13-sky-box-and-some-optimizations.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">天空盒与一些优化</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">天空盒与一些优化</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">天空盒</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#_2">一些优化</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>天空盒与一些优化</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">天空盒与一些优化</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/13-sky-box-and-some-optimizations.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/13-sky-box-and-some-optimizations.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="sky-box-and-some-optimizations">天空盒与一些优化 (Sky Box and some optimizations)</h1>
 <h2 id="_1">天空盒</h2>
@@ -468,31 +449,22 @@ public void renderList(List&lt;GameItem&gt; gameItems, Consumer&lt;GameItem&gt;
 <p>你可以在源代码中查阅所有细节。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../12-game-hud/" class="btn btn-neutral float-left" title="游戏HUD"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../14-height-maps/" class="btn btn-neutral float-right" title="高度图">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../12-game-hud/" class="btn btn-neutral" title="游戏HUD"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -500,11 +472,11 @@ public void renderList(List&lt;GameItem&gt; gameItems, Consumer&lt;GameItem&gt;
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -515,15 +487,16 @@ public void renderList(List&lt;GameItem&gt; gameItems, Consumer&lt;GameItem&gt;
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/14-height-maps/index.html b/14-height-maps/index.html
index 61910a5..7761d4f 100755
--- a/14-height-maps/index.html
+++ b/14-height-maps/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>高度图 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u9ad8\u5ea6\u56fe";
-    var mkdocs_page_input_path = "14-height-maps.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>高度图 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u9ad8\u5ea6\u56fe";
+        var mkdocs_page_input_path = "14-height-maps.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">高度图</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">高度图</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>高度图</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">高度图</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/14-height-maps.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/14-height-maps.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="height-maps">高度图（Height Maps）</h1>
 <p>本章中我们将学习如何使用高度图创建复杂的地形。在开始前，你会注意到我们做了一些重构。我们创建了一些新的包和移动了一些类以更好地组织它们。你可以在源代码中了解这些改变。</p>
@@ -451,31 +432,22 @@ public class Terrain {
 <p>你可以在地形周围移动相机，看看它是如何渲染的。由于还没有实现碰撞检测，你可以穿过它并从上面看它。由于我们已经启用了面剔除，当从下面观察时，地形的某些部分不会渲染。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../13-sky-box-and-some-optimizations/" class="btn btn-neutral float-left" title="天空盒与一些优化"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../15-terrain-collisions/" class="btn btn-neutral float-right" title="地形碰撞">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../13-sky-box-and-some-optimizations/" class="btn btn-neutral" title="天空盒与一些优化"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -483,11 +455,11 @@ public class Terrain {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -498,15 +470,16 @@ public class Terrain {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/15-terrain-collisions/index.html b/15-terrain-collisions/index.html
index 7e86ca9..bb62711 100755
--- a/15-terrain-collisions/index.html
+++ b/15-terrain-collisions/index.html
@@ -1,215 +1,195 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>地形碰撞 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u5730\u5f62\u78b0\u649e";
-    var mkdocs_page_input_path = "15-terrain-collisions.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>地形碰撞 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u5730\u5f62\u78b0\u649e";
+        var mkdocs_page_input_path = "15-terrain-collisions.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">地形碰撞</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">地形碰撞</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>地形碰撞</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">地形碰撞</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/15-terrain-collisions.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/15-terrain-collisions.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="terrain-collisions">地形碰撞（Terrain Collisions）</h1>
 <p>此前我们创建了一个地形，接下来就是检测碰撞以避免穿过它。回忆一下之前的内容，一个地形是由地形块组成的，每个地形块都是由高度图生成的，高度图用于设置构成地形的三角形的顶点高度。</p>
 <p>为了检测碰撞，我们必须将当前所在位置的<strong>Y</strong>值与当前地形点的<strong>Y</strong>值进行比较。如果有碰撞，我们需要回到地形上方。很简单的想法，是吗？确实是这样，但在比较之前，我们需要进行几次计算。</p>
-<p>我们首先要定义的是我们对“当前位置”这个词的理解。由于我们还没有一个球员的概念，答案很简单，当前的位置将是相机的位置。因此，我们已经有了比较的组成部分之一，因此，接下来要计算的是当前位置的地形高度。
-首先要定义的是“当前位置”这个词的概念。由于我们还没有一个“玩家”的概念，因此当前位置将是摄像机的位置。这样我们就有了比较的一方，因此接下来要计算当前位置的地形高度。</p>
-<p>如上所是，地形由地形块组成，如下图所示。</p>
+<p>首先要定义的是“当前位置”这个词的概念。由于我们还没有一个“玩家”的概念，当前位置将是摄像机的位置。这样我们就有了比较的一方，因此接下来要计算当前位置的地形高度。</p>
+<p>如上所述，地形由地形块组成，如下图所示。</p>
 <p><img alt="地形网格" src="../_static/15/terrain_grid.png" /></p>
 <p>每个地形块都是由相同的高度图网格构成，但被精确地缩放和位移，以形成看起来像是连续的景观的地形网格。</p>
 <p>所以首先要做的是确定当前位置(摄像机位置)在哪个地形块。为了得到它，我们将基于位移和缩放来计算每个地形块的包围盒(<strong>BoundingBox</strong>)。因为地形在运行时不会移动或缩放，所以我们可以在<code>Terrain</code>类的构造方法中计算。这样就可以在任何时候访问它们，而不需要在每个游戏循环周期中重复这些计算。</p>
@@ -433,31 +413,22 @@ if ( camera.getPosition().y &lt;= height )  {
 <p>有许多可行的解决方案可以避免这个效应，最简单的解决方法是将要进行的计算分成增量较小的多份。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../14-height-maps/" class="btn btn-neutral float-left" title="高度图"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../16-fog/" class="btn btn-neutral float-right" title="雾">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../14-height-maps/" class="btn btn-neutral" title="高度图"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -465,11 +436,11 @@ if ( camera.getPosition().y &lt;= height )  {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -480,15 +451,16 @@ if ( camera.getPosition().y &lt;= height )  {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/16-fog/index.html b/16-fog/index.html
index ecd9eff..104145c 100755
--- a/16-fog/index.html
+++ b/16-fog/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>雾 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u96fe";
-    var mkdocs_page_input_path = "16-fog.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>雾 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u96fe";
+        var mkdocs_page_input_path = "16-fog.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">雾</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">雾</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>雾</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">雾</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/16-fog.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/16-fog.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="fog">雾（Fog）</h1>
 <p>在处理更复杂的问题之前，我们将学习如何在游戏引擎中创建雾特效。有了这个特效，就可以模拟遥远的物体变暗，似乎消失在浓雾中。</p>
@@ -365,31 +346,22 @@ public void setUniform(String uniformName, Fog fog) {
 <p><img alt="雾灰色背景" src="../_static/16/fog_clear_colour_grey.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../15-terrain-collisions/" class="btn btn-neutral float-left" title="地形碰撞"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../17-normal-mapping/" class="btn btn-neutral float-right" title="法线贴图">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../15-terrain-collisions/" class="btn btn-neutral" title="地形碰撞"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -397,11 +369,11 @@ public void setUniform(String uniformName, Fog fog) {
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -412,15 +384,16 @@ public void setUniform(String uniformName, Fog fog) {
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/17-normal-mapping/index.html b/17-normal-mapping/index.html
index 610407d..3571423 100755
--- a/17-normal-mapping/index.html
+++ b/17-normal-mapping/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>法线贴图 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u6cd5\u7ebf\u8d34\u56fe";
-    var mkdocs_page_input_path = "17-normal-mapping.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>法线贴图 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u6cd5\u7ebf\u8d34\u56fe";
+        var mkdocs_page_input_path = "17-normal-mapping.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">法线贴图</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">法线贴图</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>法线贴图</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">法线贴图</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/17-normal-mapping.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/17-normal-mapping.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="normal-mapping">法线贴图（Normal Mapping）</h1>
 <p>本章中将讲解一项技术，它将极大地改善我们的3D模型的外观。到目前为止，我们已经能够将纹理使用到复杂的3D模型上，但这还离真实物体的样子很远。现实世界中的物体表面不是完全光滑的，它们有我们的3D模型目前所不具有的瑕疵。</p>
@@ -345,31 +326,22 @@ sceneShaderProgram.setUniform(&quot;normalMap&quot;, 1);
 <p>我们现在仍使用这个简单的实现，但请记住，你必须总是使用在模型空间中定义的法线贴图。如果使用切线空间中定义的贴图，就会变得很奇怪。为了能够让它们一同工作，我们需要使用特定的矩阵来将坐标变换到切线空间。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../16-fog/" class="btn btn-neutral float-left" title="雾"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../18-shadows/" class="btn btn-neutral float-right" title="阴影">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../16-fog/" class="btn btn-neutral" title="雾"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -377,11 +349,11 @@ sceneShaderProgram.setUniform(&quot;normalMap&quot;, 1);
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -392,15 +364,16 @@ sceneShaderProgram.setUniform(&quot;normalMap&quot;, 1);
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/18-shadows/index.html b/18-shadows/index.html
index bbf474d..4f1eb22 100755
--- a/18-shadows/index.html
+++ b/18-shadows/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>阴影 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u9634\u5f71";
-    var mkdocs_page_input_path = "18-shadows.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>阴影 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u9634\u5f71";
+        var mkdocs_page_input_path = "18-shadows.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">阴影</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">阴影</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">阴影映射</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#_2">改进阴影映射</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>阴影</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">阴影</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/18-shadows.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/18-shadows.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="shadows">阴影（Shadows）</h1>
 <h2 id="_1">阴影映射</h2>
@@ -501,31 +482,22 @@ shadowFactor /= 9.0;
 <p>为了渲染多个光源，你只需要为每个光源渲染一个深度图。在渲染场景时，你需要采样所有的深度图来计算合适的阴影系数。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../17-normal-mapping/" class="btn btn-neutral float-left" title="法线贴图"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../19-animations/" class="btn btn-neutral float-right" title="动画">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../17-normal-mapping/" class="btn btn-neutral" title="法线贴图"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -533,11 +505,11 @@ shadowFactor /= 9.0;
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -548,15 +520,16 @@ shadowFactor /= 9.0;
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/19-animations/index.html b/19-animations/index.html
index 59a86cc..983765b 100755
--- a/19-animations/index.html
+++ b/19-animations/index.html
@@ -1,125 +1,118 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>动画 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u52a8\u753b";
-    var mkdocs_page_input_path = "19-animations.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>动画 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u52a8\u753b";
+        var mkdocs_page_input_path = "19-animations.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">动画</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">动画</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">引言</a>
     </li>
@@ -128,87 +121,75 @@
     <li class="toctree-l2"><a class="reference internal" href="#_3">修正动画问题</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>动画</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">动画</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/19-animations.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/19-animations.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="animations">动画（Animations）</h1>
 <h2 id="_1">引言</h2>
@@ -942,31 +923,22 @@ void main()
 <p>这就是全部内容了，现在你已经有了一个用于动画MD5模型的可工作示例。源代码仍能改进，你可以修改在每个渲染周期中加载的矩阵，以便在帧之间插入。你可以查看本章中使用的资源，了解如何实现该功能。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../18-shadows/" class="btn btn-neutral float-left" title="阴影"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../20-particles/" class="btn btn-neutral float-right" title="粒子">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../18-shadows/" class="btn btn-neutral" title="阴影"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -974,11 +946,11 @@ void main()
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -989,15 +961,16 @@ void main()
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/20-particles/index.html b/20-particles/index.html
index e0056d8..40f974d 100755
--- a/20-particles/index.html
+++ b/20-particles/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>粒子 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u7c92\u5b50";
-    var mkdocs_page_input_path = "20-particles.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>粒子 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u7c92\u5b50";
+        var mkdocs_page_input_path = "20-particles.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">粒子</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">粒子</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">基础</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#texture-atlas">纹理集（Texture Atlas）</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>粒子</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">粒子</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/20-particles.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/20-particles.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="particles">粒子（Particles）</h1>
 <h2 id="_1">基础</h2>
@@ -832,31 +813,22 @@ void main()
 <p>现在，我们有了粒子动画。在下章中，我们讲学习如何优化渲染流程。我们正在渲染具有相同网格的多个元素，并为每个元素进行绘制调用。在下章中，我们讲学习如何在单个调用中渲染它们。这种技术不仅适用于粒子，也适用于渲染共享同一模型，但被放在不同位置或具有不同纹理的多个元素的场景。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../19-animations/" class="btn btn-neutral float-left" title="动画"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../21-instanced-rendering/" class="btn btn-neutral float-right" title="实例化渲染">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../19-animations/" class="btn btn-neutral" title="动画"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -864,11 +836,11 @@ void main()
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -879,15 +851,16 @@ void main()
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/21-instanced-rendering/index.html b/21-instanced-rendering/index.html
index 9f4a917..3e32e65 100755
--- a/21-instanced-rendering/index.html
+++ b/21-instanced-rendering/index.html
@@ -1,133 +1,126 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>实例化渲染 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u5b9e\u4f8b\u5316\u6e32\u67d3";
-    var mkdocs_page_input_path = "21-instanced-rendering.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>实例化渲染 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u5b9e\u4f8b\u5316\u6e32\u67d3";
+        var mkdocs_page_input_path = "21-instanced-rendering.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">实例化渲染</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">实例化渲染</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">很多实例</a>
     </li>
@@ -136,79 +129,67 @@
     <li class="toctree-l2"><a class="reference internal" href="#_3">扩展</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>实例化渲染</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">实例化渲染</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/21-instanced-rendering.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/21-instanced-rendering.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="instanced-rendering">实例化渲染（Instanced Rendering）</h1>
 <h2 id="_1">很多实例</h2>
@@ -396,31 +377,22 @@ void main()
 <p>请记住，这还有很大的优化空间，但这本书的目的是指导你学习LWJGL和OpenGL的概念和技术。我们的目标不是创建一个完整的游戏引擎（绝对不是一个体素引擎，它需要不同的方法和更多的优化）。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../20-particles/" class="btn btn-neutral float-left" title="粒子"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../22-audio/" class="btn btn-neutral float-right" title="音效">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../20-particles/" class="btn btn-neutral" title="粒子"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -428,11 +400,11 @@ void main()
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -443,15 +415,16 @@ void main()
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/22-audio/index.html b/22-audio/index.html
index 0c31b06..c17c981 100755
--- a/22-audio/index.html
+++ b/22-audio/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>音效 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u97f3\u6548";
-    var mkdocs_page_input_path = "22-audio.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>音效 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u97f3\u6548";
+        var mkdocs_page_input_path = "22-audio.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">音效</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">音效</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>音效</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">音效</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/22-audio.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/22-audio.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="audio">音频（Audio）</h1>
 <p>在此之前我们一直在处理图像，但每个游戏的另一个关键面是音频。本章将在<a href="https://www.openal.org" title="OpenAL">OpenAL</a>（Open Audio Library，开放音频库）的帮助下实现这个功能。OpenAL就像是OpenGL在音频的相似物，它允许我们通过抽象层播放声音。该层将我们与音频子系统的复杂底层隔离开来。此外，它还允许我们可以三维场景中特定的位置设置声音，“渲染”声音，随着距离衰减并根据它们的速度进行修改（模拟<a href="https://en.wikipedia.org/wiki/Doppler_effect">多普勒效应</a>）。</p>
@@ -430,31 +411,22 @@ listener.setOrientation(at, up);
 <p>后记，OpenAL还允许你通过使用<code>alDistanceModel</code>并传递你想使用的模型（<code>AL11.AL_EXPONENT_DISTANCE</code>，<code>AL_EXPONENT_DISTANCE_CLAMP</code>，等等）。你可以用它们来播放并检查效果。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../21-instanced-rendering/" class="btn btn-neutral float-left" title="实例化渲染"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../23-3d-object-picking/" class="btn btn-neutral float-right" title="三维物体选取">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../21-instanced-rendering/" class="btn btn-neutral" title="实例化渲染"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -462,11 +434,11 @@ listener.setOrientation(at, up);
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -477,15 +449,16 @@ listener.setOrientation(at, up);
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/23-3d-object-picking/index.html b/23-3d-object-picking/index.html
index e94b0f2..bafa9a7 100755
--- a/23-3d-object-picking/index.html
+++ b/23-3d-object-picking/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>三维物体选取 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u4e09\u7ef4\u7269\u4f53\u9009\u53d6";
-    var mkdocs_page_input_path = "23-3d-object-picking.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>三维物体选取 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u4e09\u7ef4\u7269\u4f53\u9009\u53d6";
+        var mkdocs_page_input_path = "23-3d-object-picking.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">三维物体选取</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">三维物体选取</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">摄像机选取</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#_2">鼠标选取</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>三维物体选取</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">三维物体选取</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/23-3d-object-picking.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/23-3d-object-picking.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="3d-object-picking">三维物体选取（3D Object Picking）</h1>
 <h2 id="_1">摄像机选取</h2>
@@ -333,31 +314,22 @@ this.selectDetector.selectGameItem(gameItems, camera);
 <p>之后你可以参考一篇<a href="https://capnramses.github.io/opengl/raycasting.html" title="优秀文章">优秀文章</a>中背完所解释的步骤的细节，其中包含了涉及不同方案的非常详细的说明。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../22-audio/" class="btn btn-neutral float-left" title="音效"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../24-hud-revisited/" class="btn btn-neutral float-right" title="回顾HUD - NanoVG">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../22-audio/" class="btn btn-neutral" title="音效"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -365,11 +337,11 @@ this.selectDetector.selectGameItem(gameItems, camera);
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -380,15 +352,16 @@ this.selectDetector.selectGameItem(gameItems, camera);
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/24-hud-revisited/index.html b/24-hud-revisited/index.html
index b7cee7e..f63cf93 100755
--- a/24-hud-revisited/index.html
+++ b/24-hud-revisited/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>回顾HUD - NanoVG - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u56de\u987eHUD - NanoVG";
-    var mkdocs_page_input_path = "24-hud-revisited.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>回顾HUD - NanoVG - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u56de\u987eHUD - NanoVG";
+        var mkdocs_page_input_path = "24-hud-revisited.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">回顾HUD - NanoVG</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">回顾HUD - NanoVG</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>回顾HUD - NanoVG</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">回顾HUD - NanoVG</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/24-hud-revisited.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/24-hud-revisited.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="hud-nanovghud-revisited-nanovg">回顾HUD - NanoVG（HUD Revisited - NanoVG）</h1>
 <p>在此前的章节中，我们讲解了如何使用正交投影在场景顶部创建一个HUD以渲染图形和纹理。在本章中，我们将学习如何使用<a href="https://github.com/memononen/nanovg">NanoVG</a>库来渲染抗锯齿矢量图形，从而以简单的方式创建更复杂的HUD。</p>
@@ -311,31 +292,22 @@ window.restoreState();
 <p><img alt="Hud" src="../_static/24/hud.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../23-3d-object-picking/" class="btn btn-neutral float-left" title="三维物体选取"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../25-optimizations-frustum-culling/" class="btn btn-neutral float-right" title="优化 - 截锥剔除">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../23-3d-object-picking/" class="btn btn-neutral" title="三维物体选取"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -343,11 +315,11 @@ window.restoreState();
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -358,15 +330,16 @@ window.restoreState();
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/25-optimizations-frustum-culling/index.html b/25-optimizations-frustum-culling/index.html
index 3071c6b..bc3b195 100755
--- a/25-optimizations-frustum-culling/index.html
+++ b/25-optimizations-frustum-culling/index.html
@@ -1,210 +1,191 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>优化 - 截锥剔除 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u4f18\u5316 - \u622a\u9525\u5254\u9664";
-    var mkdocs_page_input_path = "25-optimizations-frustum-culling.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>优化 - 截锥剔除 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u4f18\u5316 - \u622a\u9525\u5254\u9664";
+        var mkdocs_page_input_path = "25-optimizations-frustum-culling.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">优化 - 截锥剔除</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">优化 - 截锥剔除</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#-">优化 - 截锥剔除一</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>优化 - 截锥剔除</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">优化 - 截锥剔除</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/25-optimizations-frustum-culling.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/25-optimizations-frustum-culling.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="-optimizations-frustum-culling">优化 - 截锥剔除（Optimizations - Frustum Culling）</h1>
 <h2 id="-">优化 - 截锥剔除一</h2>
@@ -346,31 +327,22 @@ frustumFilter.filter(scene.getGameInstancedMeshes());
 <p>使用该方法，你甚至可以达到更高的FPS。此外，还向<code>Window</code>类中添加了一个全局标记，以启用或禁用截锥剔除。<code>GameItem</code>类也有启用或禁用过滤的标记，因为对于某些项，截锥剔除过滤可能没有意义。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../24-hud-revisited/" class="btn btn-neutral float-left" title="回顾HUD - NanoVG"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../26-cascaded-shadow-maps/" class="btn btn-neutral float-right" title="级联阴影映射">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../24-hud-revisited/" class="btn btn-neutral" title="回顾HUD - NanoVG"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -378,11 +350,11 @@ frustumFilter.filter(scene.getGameInstancedMeshes());
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -393,15 +365,16 @@ frustumFilter.filter(scene.getGameInstancedMeshes());
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/26-cascaded-shadow-maps/index.html b/26-cascaded-shadow-maps/index.html
index 3e8ecc9..58f87f1 100755
--- a/26-cascaded-shadow-maps/index.html
+++ b/26-cascaded-shadow-maps/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>级联阴影映射 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u7ea7\u8054\u9634\u5f71\u6620\u5c04";
-    var mkdocs_page_input_path = "26-cascaded-shadow-maps.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>级联阴影映射 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u7ea7\u8054\u9634\u5f71\u6620\u5c04";
+        var mkdocs_page_input_path = "26-cascaded-shadow-maps.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">级联阴影映射</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">级联阴影映射</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>级联阴影映射</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">级联阴影映射</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/26-cascaded-shadow-maps.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/26-cascaded-shadow-maps.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="cascaded-shadow-maps">级联阴影映射（Cascaded Shadow Maps）</h1>
 <p>在阴影一章中，我们介绍了阴影映射技术，以便在渲染三维场景时使用平行光显示阴影。此前介绍的方案中要求你手动调整一些参数以改进效果。在本章中，我们将修改该技术，以自动化所有流程，并改进在开放空间中的效果。为了达到目的，我们将使用一种称为级联阴影映射（CMS，Cascaded Shadow Map）的技术。</p>
@@ -387,31 +368,22 @@ uniform sampler2D shadowMap_2;
 <p><img alt="最终效果" src="../_static/26/csmpng.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../25-optimizations-frustum-culling/" class="btn btn-neutral float-left" title="优化 - 截锥剔除"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../27-assimp/" class="btn btn-neutral float-right" title="Assimp库">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../25-optimizations-frustum-culling/" class="btn btn-neutral" title="优化 - 截锥剔除"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -419,11 +391,11 @@ uniform sampler2D shadowMap_2;
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -434,15 +406,16 @@ uniform sampler2D shadowMap_2;
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/27-assimp/index.html b/27-assimp/index.html
index 0058e6f..20c6f37 100755
--- a/27-assimp/index.html
+++ b/27-assimp/index.html
@@ -1,212 +1,193 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>Assimp库 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "Assimp\u5e93";
-    var mkdocs_page_input_path = "27-assimp.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>Assimp库 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "Assimp\u5e93";
+        var mkdocs_page_input_path = "27-assimp.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">Assimp库</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">Assimp库</a>
     <ul class="current">
     <li class="toctree-l2"><a class="reference internal" href="#_1">静态网格</a>
     </li>
     <li class="toctree-l2"><a class="reference internal" href="#_2">动画</a>
     </li>
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>Assimp库</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">Assimp库</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/27-assimp.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/27-assimp.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="assimpassimp">Assimp库（Assimp）</h1>
 <h2 id="_1">静态网格</h2>
@@ -601,31 +582,22 @@ Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures),
 <p>这个示例的复杂之处在于Assimp结构的调整，使其适应本书中使用的引擎，并预先计算每个帧的数据。此外，这些概念与动画一章中的概念类似。你可以尝试修改源代码以在帧之间插入，以获得更平滑的动画。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../26-cascaded-shadow-maps/" class="btn btn-neutral float-left" title="级联阴影映射"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../28-deferred-shading/" class="btn btn-neutral float-right" title="延迟着色法">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../26-cascaded-shadow-maps/" class="btn btn-neutral" title="级联阴影映射"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -633,11 +605,11 @@ Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures),
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -648,15 +620,16 @@ Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures),
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/28-deferred-shading/index.html b/28-deferred-shading/index.html
index b1d69cc..0e87ae8 100755
--- a/28-deferred-shading/index.html
+++ b/28-deferred-shading/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>延迟着色法 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u5ef6\u8fdf\u7740\u8272\u6cd5";
-    var mkdocs_page_input_path = "28-deferred-shading.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>延迟着色法 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u5ef6\u8fdf\u7740\u8272\u6cd5";
+        var mkdocs_page_input_path = "28-deferred-shading.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">延迟着色法</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">延迟着色法</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>延迟着色法</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">延迟着色法</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/28-deferred-shading.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/28-deferred-shading.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="deferred-shading">延迟着色法（Deferred Shading）</h1>
 <p>到目前为止，我们渲染三维场景的方式称为正向渲染法（Forward Rendering）。我们首先渲染3D对象，并在片元着色器中应用纹理和光照效果。如果我们有一个具有多种光照和复杂效果的复杂片元着色器处理阶段，这种方法就不是很高效。此外，我们最终可能会将这些效果应用到稍后可能由于深度测试而被丢弃的片元上（尽管这并不完全正确，如果我们启用<a href="https://www.khronos.org/opengl/wiki/Early_Fragment_Test">早期片元测试</a>的话）。</p>
@@ -988,31 +969,22 @@ uniform sampler2D depthText;
 <p>最后要注意的一点是，如果你想了解这些技术在现实中的应用，可以查看<a href="http://www.adriancourreges.com/blog/2015/11/02/gta-v-graphics-study/" title="GTA V - Graphics Study">这个极好的说明</a>，了解GTA V的帧是如何渲染的。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../27-assimp/" class="btn btn-neutral float-left" title="Assimp库"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../a01-opengl-debugging/" class="btn btn-neutral float-right" title="附录 A - OpenGL调试">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../27-assimp/" class="btn btn-neutral" title="Assimp库"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -1020,11 +992,11 @@ uniform sampler2D depthText;
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -1035,15 +1007,16 @@ uniform sampler2D depthText;
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/404.html b/404.html
index 96431a7..951d57f 100755
--- a/404.html
+++ b/404.html
@@ -1,194 +1,178 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="/img/favicon.ico">
-  <title>Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="/css/theme.css" />
-  <link rel="stylesheet" href="/css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script src="/js/jquery-2.1.1.min.js" defer></script>
-  <script src="/js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="/img/favicon.ico" />
+    <title>Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="/css/theme.css" />
+    <link rel="stylesheet" href="/css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+    <!--[if lt IE 9]>
+      <script src="/js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href="/." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href="/." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="//search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="/glossary/">术语表</a>
-                    </li>
-                </ul>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="/glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="/.">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="/.">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="/.">Docs</a> &raquo;</li>
-    
-    
+    <li><a href="/." class="icon icon-home" aria-label="Docs"></a></li>
     <li class="wy-breadcrumbs-aside">
-      
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
 
   <h1 id="404-page-not-found">404</h1>
@@ -197,22 +181,18 @@
 
 
             </div>
-          </div>
-          <footer>
-  
+          </div><footer>
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -220,26 +200,27 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
     
   </span>
 </div>
-    <script>var base_url = '/';</script>
-    <script src="/js/theme_extra.js" defer></script>
-    <script src="/js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="/search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="/js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "/";</script>
+    <script src="/js/theme_extra.js"></script>
+    <script src="/js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="/search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/a01-opengl-debugging/index.html b/a01-opengl-debugging/index.html
index 55a9f00..d84bc30 100755
--- a/a01-opengl-debugging/index.html
+++ b/a01-opengl-debugging/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>附录 A - OpenGL调试 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u9644\u5f55 A - OpenGL\u8c03\u8bd5";
-    var mkdocs_page_input_path = "a01-opengl-debugging.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>附录 A - OpenGL调试 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u9644\u5f55 A - OpenGL\u8c03\u8bd5";
+        var mkdocs_page_input_path = "a01-opengl-debugging.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">附录 A - OpenGL调试</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">附录 A - OpenGL调试</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
-                    </li>
-                </ul>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>附录 A - OpenGL调试</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">附录 A - OpenGL调试</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/a01-opengl-debugging.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/a01-opengl-debugging.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="a-openglopengl-debugging">附录 A - OpenGL调试（OpenGL Debugging）</h1>
 <p>调试OpenGL程序可能是一项艰巨的任务。在大多数情况下，你会看到一个黑屏，你无法知道到底发生了什么。为了缓解这个窘况，我们可以使用一些现有的工具来提供关于渲染流程的更多信息。</p>
@@ -234,31 +215,22 @@
 <p><img alt="管线状态" src="../_static/a01/pipeline_state.png" /></p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../28-deferred-shading/" class="btn btn-neutral float-left" title="延迟着色法"><span class="icon icon-circle-arrow-left"></span> Previous</a>
         <a href="../glossary/" class="btn btn-neutral float-right" title="术语表">Next <span class="icon icon-circle-arrow-right"></span></a>
-      
-      
-        <a href="../28-deferred-shading/" class="btn btn-neutral" title="延迟着色法"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -266,11 +238,11 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -281,15 +253,16 @@
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/fonts/RobotoSlab/roboto-slab-v7-bold.woff b/css/fonts/Roboto-Slab-Bold.woff
similarity index 100%
rename from fonts/RobotoSlab/roboto-slab-v7-bold.woff
rename to css/fonts/Roboto-Slab-Bold.woff
diff --git a/fonts/RobotoSlab/roboto-slab-v7-bold.woff2 b/css/fonts/Roboto-Slab-Bold.woff2
similarity index 100%
rename from fonts/RobotoSlab/roboto-slab-v7-bold.woff2
rename to css/fonts/Roboto-Slab-Bold.woff2
diff --git a/fonts/RobotoSlab/roboto-slab-v7-regular.woff b/css/fonts/Roboto-Slab-Regular.woff
similarity index 100%
rename from fonts/RobotoSlab/roboto-slab-v7-regular.woff
rename to css/fonts/Roboto-Slab-Regular.woff
diff --git a/fonts/RobotoSlab/roboto-slab-v7-regular.woff2 b/css/fonts/Roboto-Slab-Regular.woff2
similarity index 100%
rename from fonts/RobotoSlab/roboto-slab-v7-regular.woff2
rename to css/fonts/Roboto-Slab-Regular.woff2
diff --git a/fonts/fontawesome-webfont.eot b/css/fonts/fontawesome-webfont.eot
similarity index 100%
rename from fonts/fontawesome-webfont.eot
rename to css/fonts/fontawesome-webfont.eot
diff --git a/fonts/fontawesome-webfont.svg b/css/fonts/fontawesome-webfont.svg
similarity index 100%
rename from fonts/fontawesome-webfont.svg
rename to css/fonts/fontawesome-webfont.svg
diff --git a/fonts/fontawesome-webfont.ttf b/css/fonts/fontawesome-webfont.ttf
similarity index 100%
rename from fonts/fontawesome-webfont.ttf
rename to css/fonts/fontawesome-webfont.ttf
diff --git a/fonts/fontawesome-webfont.woff b/css/fonts/fontawesome-webfont.woff
similarity index 100%
rename from fonts/fontawesome-webfont.woff
rename to css/fonts/fontawesome-webfont.woff
diff --git a/fonts/fontawesome-webfont.woff2 b/css/fonts/fontawesome-webfont.woff2
similarity index 100%
rename from fonts/fontawesome-webfont.woff2
rename to css/fonts/fontawesome-webfont.woff2
diff --git a/fonts/Lato/lato-bolditalic.woff b/css/fonts/lato-bold-italic.woff
similarity index 100%
rename from fonts/Lato/lato-bolditalic.woff
rename to css/fonts/lato-bold-italic.woff
diff --git a/fonts/Lato/lato-bolditalic.woff2 b/css/fonts/lato-bold-italic.woff2
similarity index 100%
rename from fonts/Lato/lato-bolditalic.woff2
rename to css/fonts/lato-bold-italic.woff2
diff --git a/fonts/Lato/lato-bold.woff b/css/fonts/lato-bold.woff
similarity index 100%
rename from fonts/Lato/lato-bold.woff
rename to css/fonts/lato-bold.woff
diff --git a/fonts/Lato/lato-bold.woff2 b/css/fonts/lato-bold.woff2
similarity index 100%
rename from fonts/Lato/lato-bold.woff2
rename to css/fonts/lato-bold.woff2
diff --git a/fonts/Lato/lato-italic.woff b/css/fonts/lato-normal-italic.woff
similarity index 100%
rename from fonts/Lato/lato-italic.woff
rename to css/fonts/lato-normal-italic.woff
diff --git a/fonts/Lato/lato-italic.woff2 b/css/fonts/lato-normal-italic.woff2
similarity index 100%
rename from fonts/Lato/lato-italic.woff2
rename to css/fonts/lato-normal-italic.woff2
diff --git a/fonts/Lato/lato-regular.woff b/css/fonts/lato-normal.woff
similarity index 100%
rename from fonts/Lato/lato-regular.woff
rename to css/fonts/lato-normal.woff
diff --git a/fonts/Lato/lato-regular.woff2 b/css/fonts/lato-normal.woff2
similarity index 100%
rename from fonts/Lato/lato-regular.woff2
rename to css/fonts/lato-normal.woff2
diff --git a/css/theme.css b/css/theme.css
index bb00f2f..ad77300 100755
--- a/css/theme.css
+++ b/css/theme.css
@@ -3,12 +3,11 @@
  * theme. To aid upgradability this file should *not* be edited.
  * modifications we need should be included in theme_extra.css.
  *
- * https://github.com/rtfd/sphinx_rtd_theme
+ * https://github.com/readthedocs/sphinx_rtd_theme
  */
 
- /* sphinx_rtd_theme version 0.4.1 | MIT license */
- /* Built 20180727 10:07 */
- *{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}[hidden]{display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:hover,a:active{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;color:#000;text-decoration:none}mark{background:#ff0;color:#000;font-style:italic;font-weight:bold}pre,code,.rst-content tt,.rst-content code,kbd,samp{font-family:monospace,serif;_font-family:"courier new",monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:before,q:after{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}ul,ol,dl{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure{margin:0}form{margin:0}fieldset{border:0;margin:0;padding:0}label{cursor:pointer}legend{border:0;*margin-left:-7px;padding:0;white-space:normal}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0;*width:13px;*height:13px}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top;resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none !important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{html,body,section{background:none !important}*{box-shadow:none !important;text-shadow:none !important;filter:none !important;-ms-filter:none !important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:""}pre,blockquote{page-break-inside:avoid}thead{display:table-header-group}tr,img{page-break-inside:avoid}img{max-width:100% !important}@page{margin:.5cm}p,h2,.rst-content .toctree-wrapper p.caption,h3{orphans:3;widows:3}h2,.rst-content .toctree-wrapper p.caption,h3{page-break-after:avoid}}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition,.btn,input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"],select,textarea,.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a,.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a,.wy-nav-top a{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}/*!
-  *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
-  *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
-  */@font-face{font-family:'FontAwesome';src:url("../fonts/fontawesome-webfont.eot?v=4.7.0");src:url("../fonts/fontawesome-webfont.eot?#iefix&v=4.7.0") format("embedded-opentype"),url("../fonts/fontawesome-webfont.woff2?v=4.7.0") format("woff2"),url("../fonts/fontawesome-webfont.woff?v=4.7.0") format("woff"),url("../fonts/fontawesome-webfont.ttf?v=4.7.0") format("truetype"),url("../fonts/fontawesome-webfont.svg?v=4.7.0#fontawesomeregular") format("svg");font-weight:normal;font-style:normal}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.3333333333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.2857142857em;text-align:center}.fa-ul{padding-left:0;margin-left:2.1428571429em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.1428571429em;width:2.1428571429em;top:.1428571429em;text-align:center}.fa-li.fa-lg{left:-1.8571428571em}.fa-border{padding:.2em .25em .15em;border:solid 0.08em #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa.fa-pull-left,.wy-menu-vertical li span.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-left.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-left.toctree-expand,.rst-content .fa-pull-left.admonition-title,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content dl dt .fa-pull-left.headerlink,.rst-content p.caption .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.rst-content code.download span.fa-pull-left:first-child,.fa-pull-left.icon{margin-right:.3em}.fa.fa-pull-right,.wy-menu-vertical li span.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a span.fa-pull-right.toctree-expand,.wy-menu-vertical li.current>a span.fa-pull-right.toctree-expand,.rst-content .fa-pull-right.admonition-title,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content dl dt .fa-pull-right.headerlink,.rst-content p.caption .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.rst-content code.download span.fa-pull-right:first-child,.fa-pull-right.icon{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.wy-menu-vertical li span.pull-left.toctree-expand,.wy-menu-vertical li.on a span.pull-left.toctree-expand,.wy-menu-vertical li.current>a span.pull-left.toctree-expand,.rst-content .pull-left.admonition-title,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content dl dt .pull-left.headerlink,.rst-content p.caption .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.rst-content code.download span.pull-left:first-child,.pull-left.icon{margin-right:.3em}.fa.pull-right,.wy-menu-vertical li span.pull-right.toctree-expand,.wy-menu-vertical li.on a span.pull-right.toctree-expand,.wy-menu-vertical li.current>a span.pull-right.toctree-expand,.rst-content .pull-right.admonition-title,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content dl dt .pull-right.headerlink,.rst-content p.caption .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.rst-content code.download span.pull-right:first-child,.pull-right.icon{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s infinite linear;animation:fa-spin 2s infinite linear}.fa-pulse{-webkit-animation:fa-spin 1s infinite steps(8);animation:fa-spin 1s infinite steps(8)}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}100%{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scale(-1, 1);-ms-transform:scale(-1, 1);transform:scale(-1, 1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scale(1, -1);-ms-transform:scale(1, -1);transform:scale(1, -1)}:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270,:root .fa-flip-horizontal,:root .fa-flip-vertical{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-remove:before,.fa-close:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-gear:before,.fa-cog:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-rotate-right:before,.fa-repeat:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-photo:before,.fa-image:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.rst-content .admonition-title:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-warning:before,.fa-exclamation-triangle:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-gears:before,.fa-cogs:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-save:before,.fa-floppy-o:before{content:""}.fa-square:before{content:""}.fa-navicon:before,.fa-reorder:before,.fa-bars:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.wy-dropdown .caret:before,.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-unsorted:before,.fa-sort:before{content:""}.fa-sort-down:before,.fa-sort-desc:before{content:""}.fa-sort-up:before,.fa-sort-asc:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-legal:before,.fa-gavel:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-flash:before,.fa-bolt:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-paste:before,.fa-clipboard:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-unlink:before,.fa-chain-broken:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-toggle-down:before,.fa-caret-square-o-down:before{content:""}.fa-toggle-up:before,.fa-caret-square-o-up:before{content:""}.fa-toggle-right:before,.fa-caret-square-o-right:before{content:""}.fa-euro:before,.fa-eur:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-rupee:before,.fa-inr:before{content:""}.fa-cny:before,.fa-rmb:before,.fa-yen:before,.fa-jpy:before{content:""}.fa-ruble:before,.fa-rouble:before,.fa-rub:before{content:""}.fa-won:before,.fa-krw:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-toggle-left:before,.fa-caret-square-o-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-turkish-lira:before,.fa-try:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li span.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-institution:before,.fa-bank:before,.fa-university:before{content:""}.fa-mortar-board:before,.fa-graduation-cap:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-photo-o:before,.fa-file-picture-o:before,.fa-file-image-o:before{content:""}.fa-file-zip-o:before,.fa-file-archive-o:before{content:""}.fa-file-sound-o:before,.fa-file-audio-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-saver:before,.fa-support:before,.fa-life-ring:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-resistance:before,.fa-rebel:before{content:""}.fa-ge:before,.fa-empire:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-y-combinator-square:before,.fa-yc-square:before,.fa-hacker-news:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-send:before,.fa-paper-plane:before{content:""}.fa-send-o:before,.fa-paper-plane-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-soccer-ball-o:before,.fa-futbol-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-shekel:before,.fa-sheqel:before,.fa-ils:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-hotel:before,.fa-bed:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-yc:before,.fa-y-combinator:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery:before,.fa-battery-full:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-stop-o:before,.fa-hand-paper-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-tv:before,.fa-television:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-asl-interpreting:before,.fa-american-sign-language-interpreting:before{content:""}.fa-deafness:before,.fa-hard-of-hearing:before,.fa-deaf:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-signing:before,.fa-sign-language:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-vcard:before,.fa-address-card:before{content:""}.fa-vcard-o:before,.fa-address-card-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer:before,.fa-thermometer-full:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bathtub:before,.fa-s15:before,.fa-bath:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,.rst-content .admonition-title,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.rst-content code.download span:first-child,.icon,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context{font-family:inherit}.fa:before,.wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li.on a span.toctree-expand:before,.wy-menu-vertical li.current>a span.toctree-expand:before,.rst-content .admonition-title:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content dl dt .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before,.icon:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before{font-family:"FontAwesome";display:inline-block;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa,a .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li a span.toctree-expand,.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand,a .rst-content .admonition-title,.rst-content a .admonition-title,a .rst-content h1 .headerlink,.rst-content h1 a .headerlink,a .rst-content h2 .headerlink,.rst-content h2 a .headerlink,a .rst-content h3 .headerlink,.rst-content h3 a .headerlink,a .rst-content h4 .headerlink,.rst-content h4 a .headerlink,a .rst-content h5 .headerlink,.rst-content h5 a .headerlink,a .rst-content h6 .headerlink,.rst-content h6 a .headerlink,a .rst-content dl dt .headerlink,.rst-content dl dt a .headerlink,a .rst-content p.caption .headerlink,.rst-content p.caption a .headerlink,a .rst-content table>caption .headerlink,.rst-content table>caption a .headerlink,a .rst-content tt.download span:first-child,.rst-content tt.download a span:first-child,a .rst-content code.download span:first-child,.rst-content code.download a span:first-child,a .icon{display:inline-block;text-decoration:inherit}.btn .fa,.btn .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .btn span.toctree-expand,.btn .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .btn span.toctree-expand,.btn .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .btn span.toctree-expand,.btn .rst-content .admonition-title,.rst-content .btn .admonition-title,.btn .rst-content h1 .headerlink,.rst-content h1 .btn .headerlink,.btn .rst-content h2 .headerlink,.rst-content h2 .btn .headerlink,.btn .rst-content h3 .headerlink,.rst-content h3 .btn .headerlink,.btn .rst-content h4 .headerlink,.rst-content h4 .btn .headerlink,.btn .rst-content h5 .headerlink,.rst-content h5 .btn .headerlink,.btn .rst-content h6 .headerlink,.rst-content h6 .btn .headerlink,.btn .rst-content dl dt .headerlink,.rst-content dl dt .btn .headerlink,.btn .rst-content p.caption .headerlink,.rst-content p.caption .btn .headerlink,.btn .rst-content table>caption .headerlink,.rst-content table>caption .btn .headerlink,.btn .rst-content tt.download span:first-child,.rst-content tt.download .btn span:first-child,.btn .rst-content code.download span:first-child,.rst-content code.download .btn span:first-child,.btn .icon,.nav .fa,.nav .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .nav span.toctree-expand,.nav .wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.on a .nav span.toctree-expand,.nav .wy-menu-vertical li.current>a span.toctree-expand,.wy-menu-vertical li.current>a .nav span.toctree-expand,.nav .rst-content .admonition-title,.rst-content .nav .admonition-title,.nav .rst-content h1 .headerlink,.rst-content h1 .nav .headerlink,.nav .rst-content h2 .headerlink,.rst-content h2 .nav .headerlink,.nav .rst-content h3 .headerlink,.rst-content h3 .nav .headerlink,.nav .rst-content h4 .headerlink,.rst-content h4 .nav .headerlink,.nav .rst-content h5 .headerlink,.rst-content h5 .nav .headerlink,.nav .rst-content h6 .headerlink,.rst-content h6 .nav .headerlink,.nav .rst-content dl dt .headerlink,.rst-content dl dt .nav .headerlink,.nav .rst-content p.caption .headerlink,.rst-content p.caption .nav .headerlink,.nav .rst-content table>caption .headerlink,.rst-content table>caption .nav .headerlink,.nav .rst-content tt.download span:first-child,.rst-content tt.download .nav span:first-child,.nav .rst-content code.download span:first-child,.rst-content code.download .nav span:first-child,.nav .icon{display:inline}.btn .fa.fa-large,.btn .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .btn span.fa-large.toctree-expand,.btn .rst-content .fa-large.admonition-title,.rst-content .btn .fa-large.admonition-title,.btn .rst-content h1 .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.btn .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .btn .fa-large.headerlink,.btn .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .btn .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .btn span.fa-large:first-child,.btn .rst-content code.download span.fa-large:first-child,.rst-content code.download .btn span.fa-large:first-child,.btn .fa-large.icon,.nav .fa.fa-large,.nav .wy-menu-vertical li span.fa-large.toctree-expand,.wy-menu-vertical li .nav span.fa-large.toctree-expand,.nav .rst-content .fa-large.admonition-title,.rst-content .nav .fa-large.admonition-title,.nav .rst-content h1 .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.nav .rst-content dl dt .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.nav .rst-content p.caption .fa-large.headerlink,.rst-content p.caption .nav .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.nav .rst-content code.download span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.nav .fa-large.icon{line-height:.9em}.btn .fa.fa-spin,.btn .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .btn span.fa-spin.toctree-expand,.btn .rst-content .fa-spin.admonition-title,.rst-content .btn .fa-spin.admonition-title,.btn .rst-content h1 .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.btn .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .btn .fa-spin.headerlink,.btn .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .btn .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .btn span.fa-spin:first-child,.btn .rst-content code.download span.fa-spin:first-child,.rst-content code.download .btn span.fa-spin:first-child,.btn .fa-spin.icon,.nav .fa.fa-spin,.nav .wy-menu-vertical li span.fa-spin.toctree-expand,.wy-menu-vertical li .nav span.fa-spin.toctree-expand,.nav .rst-content .fa-spin.admonition-title,.rst-content .nav .fa-spin.admonition-title,.nav .rst-content h1 .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.nav .rst-content dl dt .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.nav .rst-content p.caption .fa-spin.headerlink,.rst-content p.caption .nav .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.nav .rst-content code.download span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.nav .fa-spin.icon{display:inline-block}.btn.fa:before,.wy-menu-vertical li span.btn.toctree-expand:before,.rst-content .btn.admonition-title:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content dl dt .btn.headerlink:before,.rst-content p.caption .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.rst-content code.download span.btn:first-child:before,.btn.icon:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.wy-menu-vertical li span.btn.toctree-expand:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content p.caption .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.rst-content code.download span.btn:first-child:hover:before,.btn.icon:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .wy-menu-vertical li span.toctree-expand:before,.wy-menu-vertical li .btn-mini span.toctree-expand:before,.btn-mini .rst-content .admonition-title:before,.rst-content .btn-mini .admonition-title:before,.btn-mini .rst-content h1 .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.btn-mini .rst-content dl dt .headerlink:before,.rst-content dl dt .btn-mini .headerlink:before,.btn-mini .rst-content p.caption .headerlink:before,.rst-content p.caption .btn-mini .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.rst-content tt.download .btn-mini span:first-child:before,.btn-mini .rst-content code.download span:first-child:before,.rst-content code.download .btn-mini span:first-child:before,.btn-mini .icon:before{font-size:14px;vertical-align:-15%}.wy-alert,.rst-content .note,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .warning,.rst-content .seealso,.rst-content .admonition-todo,.rst-content .admonition{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.wy-alert-title,.rst-content .admonition-title{color:#fff;font-weight:bold;display:block;color:#fff;background:#6ab0de;margin:-12px;padding:6px 12px;margin-bottom:12px}.wy-alert.wy-alert-danger,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.admonition{background:#fdf3f2}.wy-alert.wy-alert-danger .wy-alert-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .danger .wy-alert-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .danger .admonition-title,.rst-content .error .admonition-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition .admonition-title{background:#f29f97}.wy-alert.wy-alert-warning,.rst-content .wy-alert-warning.note,.rst-content .attention,.rst-content .caution,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.tip,.rst-content .warning,.rst-content .wy-alert-warning.seealso,.rst-content .admonition-todo,.rst-content .wy-alert-warning.admonition{background:#ffedcc}.wy-alert.wy-alert-warning .wy-alert-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .attention .wy-alert-title,.rst-content .caution .wy-alert-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .attention .admonition-title,.rst-content .caution .admonition-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .warning .admonition-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .admonition-todo .admonition-title,.rst-content .wy-alert-warning.admonition .admonition-title{background:#f0b37e}.wy-alert.wy-alert-info,.rst-content .note,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.rst-content .seealso,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.admonition{background:#e7f2fa}.wy-alert.wy-alert-info .wy-alert-title,.rst-content .note .wy-alert-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.rst-content .note .admonition-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .seealso .admonition-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition .admonition-title{background:#6ab0de}.wy-alert.wy-alert-success,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.warning,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.admonition{background:#dbfaf4}.wy-alert.wy-alert-success .wy-alert-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .hint .wy-alert-title,.rst-content .important .wy-alert-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .hint .admonition-title,.rst-content .important .admonition-title,.rst-content .tip .admonition-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition .admonition-title{background:#1abc9c}.wy-alert.wy-alert-neutral,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.admonition{background:#f3f6f6}.wy-alert.wy-alert-neutral .wy-alert-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition .admonition-title{color:#404040;background:#e1e4e5}.wy-alert.wy-alert-neutral a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a{color:#2980B9}.wy-alert p:last-child,.rst-content .note p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.rst-content .seealso p:last-child,.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0px;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,0.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27AE60}.wy-tray-container li.wy-tray-item-info{background:#2980B9}.wy-tray-container li.wy-tray-item-warning{background:#E67E22}.wy-tray-container li.wy-tray-item-danger{background:#E74C3C}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width: 768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px 12px;color:#fff;border:1px solid rgba(0,0,0,0.1);background-color:#27AE60;text-decoration:none;font-weight:normal;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:0px 1px 2px -1px rgba(255,255,255,0.5) inset,0px -2px 0px 0px rgba(0,0,0,0.1) inset;outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:0px -1px 0px 0px rgba(0,0,0,0.05) inset,0px 2px 0px 0px rgba(0,0,0,0.1) inset;padding:8px 12px 6px 12px}.btn:visited{color:#fff}.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn-disabled:hover,.btn-disabled:focus,.btn-disabled:active{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980B9 !important}.btn-info:hover{background-color:#2e8ece !important}.btn-neutral{background-color:#f3f6f6 !important;color:#404040 !important}.btn-neutral:hover{background-color:#e5ebeb !important;color:#404040}.btn-neutral:visited{color:#404040 !important}.btn-success{background-color:#27AE60 !important}.btn-success:hover{background-color:#295 !important}.btn-danger{background-color:#E74C3C !important}.btn-danger:hover{background-color:#ea6153 !important}.btn-warning{background-color:#E67E22 !important}.btn-warning:hover{background-color:#e98b39 !important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f !important}.btn-link{background-color:transparent !important;color:#2980B9;box-shadow:none;border-color:transparent !important}.btn-link:hover{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:active{background-color:transparent !important;color:#409ad5 !important;box-shadow:none}.btn-link:visited{color:#9B59B6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:before,.wy-btn-group:after{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:solid 1px #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,0.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980B9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:solid 1px #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type="search"]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980B9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned input,.wy-form-aligned textarea,.wy-form-aligned select,.wy-form-aligned .wy-help-inline,.wy-form-aligned label{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{border:0;margin:0;padding:0}legend{display:block;width:100%;border:0;padding:0;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label{display:block;margin:0 0 .3125em 0;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;*zoom:1;max-width:68em;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group:before,.wy-control-group:after{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#E74C3C}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full input[type="text"],.wy-control-group .wy-form-full input[type="password"],.wy-control-group .wy-form-full input[type="email"],.wy-control-group .wy-form-full input[type="url"],.wy-control-group .wy-form-full input[type="date"],.wy-control-group .wy-form-full input[type="month"],.wy-control-group .wy-form-full input[type="time"],.wy-control-group .wy-form-full input[type="datetime"],.wy-control-group .wy-form-full input[type="datetime-local"],.wy-control-group .wy-form-full input[type="week"],.wy-control-group .wy-form-full input[type="number"],.wy-control-group .wy-form-full input[type="search"],.wy-control-group .wy-form-full input[type="tel"],.wy-control-group .wy-form-full input[type="color"],.wy-control-group .wy-form-halves input[type="text"],.wy-control-group .wy-form-halves input[type="password"],.wy-control-group .wy-form-halves input[type="email"],.wy-control-group .wy-form-halves input[type="url"],.wy-control-group .wy-form-halves input[type="date"],.wy-control-group .wy-form-halves input[type="month"],.wy-control-group .wy-form-halves input[type="time"],.wy-control-group .wy-form-halves input[type="datetime"],.wy-control-group .wy-form-halves input[type="datetime-local"],.wy-control-group .wy-form-halves input[type="week"],.wy-control-group .wy-form-halves input[type="number"],.wy-control-group .wy-form-halves input[type="search"],.wy-control-group .wy-form-halves input[type="tel"],.wy-control-group .wy-form-halves input[type="color"],.wy-control-group .wy-form-thirds input[type="text"],.wy-control-group .wy-form-thirds input[type="password"],.wy-control-group .wy-form-thirds input[type="email"],.wy-control-group .wy-form-thirds input[type="url"],.wy-control-group .wy-form-thirds input[type="date"],.wy-control-group .wy-form-thirds input[type="month"],.wy-control-group .wy-form-thirds input[type="time"],.wy-control-group .wy-form-thirds input[type="datetime"],.wy-control-group .wy-form-thirds input[type="datetime-local"],.wy-control-group .wy-form-thirds input[type="week"],.wy-control-group .wy-form-thirds input[type="number"],.wy-control-group .wy-form-thirds input[type="search"],.wy-control-group .wy-form-thirds input[type="tel"],.wy-control-group .wy-form-thirds input[type="color"]{width:100%}.wy-control-group .wy-form-full{float:left;display:block;margin-right:2.3576515979%;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.3576515979%;width:48.821174201%}.wy-control-group .wy-form-halves:last-child{margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(2n+1){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.3576515979%;width:31.7615656014%}.wy-control-group .wy-form-thirds:last-child{margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control{margin:6px 0 0 0;font-size:90%}.wy-control-no-input{display:inline-block;margin:6px 0 0 0;font-size:90%}.wy-control-group.fluid-input input[type="text"],.wy-control-group.fluid-input input[type="password"],.wy-control-group.fluid-input input[type="email"],.wy-control-group.fluid-input input[type="url"],.wy-control-group.fluid-input input[type="date"],.wy-control-group.fluid-input input[type="month"],.wy-control-group.fluid-input input[type="time"],.wy-control-group.fluid-input input[type="datetime"],.wy-control-group.fluid-input input[type="datetime-local"],.wy-control-group.fluid-input input[type="week"],.wy-control-group.fluid-input input[type="number"],.wy-control-group.fluid-input input[type="search"],.wy-control-group.fluid-input input[type="tel"],.wy-control-group.fluid-input input[type="color"]{width:100%}.wy-form-message-inline{display:inline-block;padding-left:.3em;color:#666;vertical-align:middle;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;*overflow:visible}input[type="text"],input[type="password"],input[type="email"],input[type="url"],input[type="date"],input[type="month"],input[type="time"],input[type="datetime"],input[type="datetime-local"],input[type="week"],input[type="number"],input[type="search"],input[type="tel"],input[type="color"]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type="datetime-local"]{padding:.34375em .625em}input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type="search"]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}input[type="text"]:focus,input[type="password"]:focus,input[type="email"]:focus,input[type="url"]:focus,input[type="date"]:focus,input[type="month"]:focus,input[type="time"]:focus,input[type="datetime"]:focus,input[type="datetime-local"]:focus,input[type="week"]:focus,input[type="number"]:focus,input[type="search"]:focus,input[type="tel"]:focus,input[type="color"]:focus{outline:0;outline:thin dotted \9;border-color:#333}input.no-focus:focus{border-color:#ccc !important}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus{outline:thin dotted #333;outline:1px auto #129FEA}input[type="text"][disabled],input[type="password"][disabled],input[type="email"][disabled],input[type="url"][disabled],input[type="date"][disabled],input[type="month"][disabled],input[type="time"][disabled],input[type="datetime"][disabled],input[type="datetime-local"][disabled],input[type="week"][disabled],input[type="number"][disabled],input[type="search"][disabled],input[type="tel"][disabled],input[type="color"][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,textarea:focus:invalid,select:focus:invalid{color:#E74C3C;border:1px solid #E74C3C}input:focus:invalid:focus,textarea:focus:invalid:focus,select:focus:invalid:focus{border-color:#E74C3C}input[type="file"]:focus:invalid:focus,input[type="radio"]:focus:invalid:focus,input[type="checkbox"]:focus:invalid:focus{outline-color:#E74C3C}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type="radio"][disabled],input[type="checkbox"][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:solid 1px #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{position:absolute;content:"";display:block;left:0;top:0;width:36px;height:12px;border-radius:4px;background:#ccc;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{position:absolute;content:"";display:block;width:18px;height:18px;border-radius:4px;background:#999;left:-3px;top:-3px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27AE60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#E74C3C}.wy-control-group.wy-control-group-error input[type="text"],.wy-control-group.wy-control-group-error input[type="password"],.wy-control-group.wy-control-group-error input[type="email"],.wy-control-group.wy-control-group-error input[type="url"],.wy-control-group.wy-control-group-error input[type="date"],.wy-control-group.wy-control-group-error input[type="month"],.wy-control-group.wy-control-group-error input[type="time"],.wy-control-group.wy-control-group-error input[type="datetime"],.wy-control-group.wy-control-group-error input[type="datetime-local"],.wy-control-group.wy-control-group-error input[type="week"],.wy-control-group.wy-control-group-error input[type="number"],.wy-control-group.wy-control-group-error input[type="search"],.wy-control-group.wy-control-group-error input[type="tel"],.wy-control-group.wy-control-group-error input[type="color"]{border:solid 1px #E74C3C}.wy-control-group.wy-control-group-error textarea{border:solid 1px #E74C3C}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27AE60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#E74C3C}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#E67E22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980B9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width: 480px){.wy-form button[type="submit"]{margin:.7em 0 0}.wy-form input[type="text"],.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:.3em;display:block}.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type="password"],.wy-form input[type="email"],.wy-form input[type="url"],.wy-form input[type="date"],.wy-form input[type="month"],.wy-form input[type="time"],.wy-form input[type="datetime"],.wy-form input[type="datetime-local"],.wy-form input[type="week"],.wy-form input[type="number"],.wy-form input[type="search"],.wy-form input[type="tel"],.wy-form input[type="color"]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0 0}.wy-form .wy-help-inline,.wy-form-message-inline,.wy-form-message{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width: 768px){.tablet-hide{display:none}}@media screen and (max-width: 480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.wy-table,.rst-content table.docutils,.rst-content table.field-list{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.wy-table caption,.rst-content table.docutils caption,.rst-content table.field-list caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td,.wy-table th,.rst-content table.docutils th,.rst-content table.field-list th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.wy-table td:first-child,.rst-content table.docutils td:first-child,.rst-content table.field-list td:first-child,.wy-table th:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list th:first-child{border-left-width:0}.wy-table thead,.rst-content table.docutils thead,.rst-content table.field-list thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.wy-table thead th,.rst-content table.docutils thead th,.rst-content table.field-list thead th{font-weight:bold;border-bottom:solid 2px #e1e4e5}.wy-table td,.rst-content table.docutils td,.rst-content table.field-list td{background-color:transparent;vertical-align:middle}.wy-table td p,.rst-content table.docutils td p,.rst-content table.field-list td p{line-height:18px}.wy-table td p:last-child,.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child{margin-bottom:0}.wy-table .wy-table-cell-min,.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min{width:1%;padding-right:0}.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox],.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:gray;font-size:90%}.wy-table-tertiary{color:gray;font-size:80%}.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td,.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td{background-color:#f3f6f6}.wy-table-backed{background-color:#f3f6f6}.wy-table-bordered-all,.rst-content table.docutils{border:1px solid #e1e4e5}.wy-table-bordered-all td,.rst-content table.docutils td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.wy-table-bordered-all tbody>tr:last-child td,.rst-content table.docutils tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px 0;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0 !important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980B9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9B59B6}html{height:100%;overflow-x:hidden}body{font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;font-weight:normal;color:#404040;min-height:100%;overflow-x:hidden;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#E67E22 !important}a.wy-text-warning:hover{color:#eb9950 !important}.wy-text-info{color:#2980B9 !important}a.wy-text-info:hover{color:#409ad5 !important}.wy-text-success{color:#27AE60 !important}a.wy-text-success:hover{color:#36d278 !important}.wy-text-danger{color:#E74C3C !important}a.wy-text-danger:hover{color:#ed7669 !important}.wy-text-neutral{color:#404040 !important}a.wy-text-neutral:hover{color:#595959 !important}h1,h2,.rst-content .toctree-wrapper p.caption,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif}p{line-height:24px;margin:0;font-size:16px;margin-bottom:24px}h1{font-size:175%}h2,.rst-content .toctree-wrapper p.caption{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}code,.rst-content tt,.rst-content code{white-space:nowrap;max-width:100%;background:#fff;border:solid 1px #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;color:#E74C3C;overflow-x:auto}code.code-large,.rst-content tt.code-large{font-size:90%}.wy-plain-list-disc,.rst-content .section ul,.rst-content .toctree-wrapper ul,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.wy-plain-list-disc li,.rst-content .section ul li,.rst-content .toctree-wrapper ul li,article ul li{list-style:disc;margin-left:24px}.wy-plain-list-disc li p:last-child,.rst-content .section ul li p:last-child,.rst-content .toctree-wrapper ul li p:last-child,article ul li p:last-child{margin-bottom:0}.wy-plain-list-disc li ul,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li ul,article ul li ul{margin-bottom:0}.wy-plain-list-disc li li,.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,article ul li li{list-style:circle}.wy-plain-list-disc li li li,.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,article ul li li li{list-style:square}.wy-plain-list-disc li ol li,.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,article ul li ol li{list-style:decimal}.wy-plain-list-decimal,.rst-content .section ol,.rst-content ol.arabic,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.wy-plain-list-decimal li,.rst-content .section ol li,.rst-content ol.arabic li,article ol li{list-style:decimal;margin-left:24px}.wy-plain-list-decimal li p:last-child,.rst-content .section ol li p:last-child,.rst-content ol.arabic li p:last-child,article ol li p:last-child{margin-bottom:0}.wy-plain-list-decimal li ul,.rst-content .section ol li ul,.rst-content ol.arabic li ul,article ol li ul{margin-bottom:0}.wy-plain-list-decimal li ul li,.rst-content .section ol li ul li,.rst-content ol.arabic li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:before,.wy-breadcrumbs:after{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs li{display:inline-block}.wy-breadcrumbs li.wy-breadcrumbs-aside{float:right}.wy-breadcrumbs li a{display:inline-block;padding:5px}.wy-breadcrumbs li a:first-child{padding-left:0}.wy-breadcrumbs li code,.wy-breadcrumbs li .rst-content tt,.rst-content .wy-breadcrumbs li tt{padding:5px;border:none;background:none}.wy-breadcrumbs li code.literal,.wy-breadcrumbs li .rst-content tt.literal,.rst-content .wy-breadcrumbs li tt.literal{color:#404040}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width: 480px){.wy-breadcrumbs-extra{display:none}.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:before,.wy-menu-horiz:after{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz ul,.wy-menu-horiz li{display:inline-block}.wy-menu-horiz li:hover{background:rgba(255,255,255,0.1)}.wy-menu-horiz li.divide-left{border-left:solid 1px #404040}.wy-menu-horiz li.divide-right{border-right:solid 1px #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{height:32px;display:inline-block;line-height:32px;padding:0 1.618em;margin-bottom:0;display:block;font-weight:bold;text-transform:uppercase;font-size:80%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:solid 1px #404040}.wy-menu-vertical li.divide-bottom{border-bottom:solid 1px #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:gray;border-right:solid 1px #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.wy-menu-vertical li code,.wy-menu-vertical li .rst-content tt,.rst-content .wy-menu-vertical li tt{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li span.toctree-expand{display:block;float:left;margin-left:-1.2em;font-size:.8em;line-height:1.6em;color:#4d4d4d}.wy-menu-vertical li.on a,.wy-menu-vertical li.current>a{color:#404040;padding:.4045em 1.618em;font-weight:bold;position:relative;background:#fcfcfc;border:none;padding-left:1.618em -4px}.wy-menu-vertical li.on a:hover,.wy-menu-vertical li.current>a:hover{background:#fcfcfc}.wy-menu-vertical li.on a:hover span.toctree-expand,.wy-menu-vertical li.current>a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.on a span.toctree-expand,.wy-menu-vertical li.current>a span.toctree-expand{display:block;font-size:.8em;line-height:1.6em;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:solid 1px #c9c9c9;border-top:solid 1px #c9c9c9}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a{color:#404040}.wy-menu-vertical li.toctree-l1.current li.toctree-l2>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>ul{display:none}.wy-menu-vertical li.toctree-l1.current li.toctree-l2.current>ul,.wy-menu-vertical li.toctree-l2.current li.toctree-l3.current>ul{display:block}.wy-menu-vertical li.toctree-l2.current>a{background:#c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{display:block;background:#c9c9c9;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l2 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l2 span.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3{font-size:.9em}.wy-menu-vertical li.toctree-l3.current>a{background:#bdbdbd;padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{display:block;background:#bdbdbd;padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l3 a:hover span.toctree-expand{color:gray}.wy-menu-vertical li.toctree-l3 span.toctree-expand{color:#969696}.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:normal}.wy-menu-vertical a{display:inline-block;line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover span.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980B9;cursor:pointer;color:#fff}.wy-menu-vertical a:active span.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980B9;text-align:center;padding:.809em;display:block;color:#fcfcfc;margin-bottom:.809em}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em auto;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-side-nav-search>a,.wy-side-nav-search .wy-dropdown>a{color:#fcfcfc;font-size:100%;font-weight:bold;display:inline-block;padding:4px 6px;margin-bottom:.809em}.wy-side-nav-search>a:hover,.wy-side-nav-search .wy-dropdown>a:hover{background:rgba(255,255,255,0.1)}.wy-side-nav-search>a img.logo,.wy-side-nav-search .wy-dropdown>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search>a.icon img.logo,.wy-side-nav-search .wy-dropdown>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:normal;color:rgba(255,255,255,0.3)}.wy-nav .wy-menu-vertical header{color:#2980B9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980B9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980B9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:before,.wy-nav-top:after{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:bold}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980B9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,0.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:gray}footer p{margin-bottom:12px}footer span.commit code,footer span.commit .rst-content tt,.rst-content footer span.commit tt{padding:0px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:1em;background:none;border:none;color:gray}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:before,.rst-footer-buttons:after{width:100%}.rst-footer-buttons:before,.rst-footer-buttons:after{display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:before,.rst-breadcrumbs-buttons:after{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:solid 1px #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:solid 1px #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:gray;font-size:90%}@media screen and (max-width: 768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-side-scroll{width:auto}.wy-side-nav-search{width:auto}.wy-menu.wy-menu-vertical{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width: 1100px){.wy-nav-content-wrap{background:rgba(0,0,0,0.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,footer,.wy-nav-side{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .wy-menu-vertical li span.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version span.toctree-expand,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content p.caption .headerlink,.rst-content p.caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .icon{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up{height:auto;max-height:100%}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content img{max-width:100%;height:auto}.rst-content div.figure{margin-bottom:24px}.rst-content div.figure p.caption{font-style:italic}.rst-content div.figure p:last-child.caption{margin-bottom:0px}.rst-content div.figure.align-center{text-align:center}.rst-content .section>img,.rst-content .section>a>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;display:block;overflow:auto}.rst-content pre.literal-block,.rst-content div[class^='highlight']{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px 0}.rst-content pre.literal-block div[class^='highlight'],.rst-content div[class^='highlight'] div[class^='highlight']{padding:0px;border:none;margin:0}.rst-content div[class^='highlight'] td.code{width:100%}.rst-content .linenodiv pre{border-right:solid 1px #e6e9ea;margin:0;padding:12px 12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^='highlight'] pre{white-space:pre;margin:0;padding:12px 12px;display:block;overflow:auto}.rst-content div[class^='highlight'] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content pre.literal-block,.rst-content div[class^='highlight'] pre,.rst-content .linenodiv pre{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;font-size:12px;line-height:1.4}@media print{.rst-content .codeblock,.rst-content div[class^='highlight'],.rst-content div[class^='highlight'] pre{white-space:pre-wrap}}.rst-content .note .last,.rst-content .attention .last,.rst-content .caution .last,.rst-content .danger .last,.rst-content .error .last,.rst-content .hint .last,.rst-content .important .last,.rst-content .tip .last,.rst-content .warning .last,.rst-content .seealso .last,.rst-content .admonition-todo .last,.rst-content .admonition .last{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,0.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent !important;border-color:rgba(0,0,0,0.1) !important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha li{list-style:upper-alpha}.rst-content .section ol p,.rst-content .section ul p{margin-bottom:12px}.rst-content .section ol p:last-child,.rst-content .section ul p:last-child{margin-bottom:24px}.rst-content .line-block{margin-left:0px;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0px}.rst-content .topic-title{font-weight:bold;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0px 0px 24px 24px}.rst-content .align-left{float:left;margin:0px 24px 24px 0px}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content .toctree-wrapper p.caption .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content dl dt .headerlink,.rst-content p.caption .headerlink,.rst-content table>caption .headerlink{visibility:hidden;font-size:14px}.rst-content h1 .headerlink:after,.rst-content h2 .headerlink:after,.rst-content .toctree-wrapper p.caption .headerlink:after,.rst-content h3 .headerlink:after,.rst-content h4 .headerlink:after,.rst-content h5 .headerlink:after,.rst-content h6 .headerlink:after,.rst-content dl dt .headerlink:after,.rst-content p.caption .headerlink:after,.rst-content table>caption .headerlink:after{content:"";font-family:FontAwesome}.rst-content h1:hover .headerlink:after,.rst-content h2:hover .headerlink:after,.rst-content .toctree-wrapper p.caption:hover .headerlink:after,.rst-content h3:hover .headerlink:after,.rst-content h4:hover .headerlink:after,.rst-content h5:hover .headerlink:after,.rst-content h6:hover .headerlink:after,.rst-content dl dt:hover .headerlink:after,.rst-content p.caption:hover .headerlink:after,.rst-content table>caption:hover .headerlink:after{visibility:visible}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:solid 1px #e1e4e5}.rst-content .sidebar p,.rst-content .sidebar ul,.rst-content .sidebar dl{font-size:90%}.rst-content .sidebar .last{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:"Roboto Slab","ff-tisa-web-pro","Georgia",Arial,sans-serif;font-weight:bold;background:#e1e4e5;padding:6px 12px;margin:-24px;margin-bottom:24px;font-size:100%}.rst-content .highlighted{background:#F1C40F;display:inline-block;font-weight:bold;padding:0 6px}.rst-content .footnote-reference,.rst-content .citation-reference{vertical-align:baseline;position:relative;top:-0.4em;line-height:0;font-size:90%}.rst-content table.docutils.citation,.rst-content table.docutils.footnote{background:none;border:none;color:gray}.rst-content table.docutils.citation td,.rst-content table.docutils.citation tr,.rst-content table.docutils.footnote td,.rst-content table.docutils.footnote tr{border:none;background-color:transparent !important;white-space:normal}.rst-content table.docutils.citation td.label,.rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}.rst-content table.docutils.citation tt,.rst-content table.docutils.citation code,.rst-content table.docutils.footnote tt,.rst-content table.docutils.footnote code{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}.rst-content table.docutils td .last,.rst-content table.docutils td .last :last-child{margin-bottom:0}.rst-content table.field-list{border:none}.rst-content table.field-list td{border:none}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content tt,.rst-content tt,.rst-content code{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace;padding:2px 5px}.rst-content tt big,.rst-content tt em,.rst-content tt big,.rst-content code big,.rst-content tt em,.rst-content code em{font-size:100% !important;line-height:normal}.rst-content tt.literal,.rst-content tt.literal,.rst-content code.literal{color:#E74C3C}.rst-content tt.xref,a .rst-content tt,.rst-content tt.xref,.rst-content code.xref,a .rst-content tt,a .rst-content code{font-weight:bold;color:#404040}.rst-content pre,.rst-content kbd,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",Courier,monospace}.rst-content a tt,.rst-content a tt,.rst-content a code{color:#2980B9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:bold;margin-bottom:12px}.rst-content dl p,.rst-content dl table,.rst-content dl ul,.rst-content dl ol{margin-bottom:12px !important}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl:not(.docutils){margin-bottom:24px}.rst-content dl:not(.docutils) dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980B9;border-top:solid 3px #6ab0de;padding:6px;position:relative}.rst-content dl:not(.docutils) dt:before{color:#6ab0de}.rst-content dl:not(.docutils) dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dl dt{margin-bottom:6px;border:none;border-left:solid 3px #ccc;background:#f0f0f0;color:#555}.rst-content dl:not(.docutils) dl dt .headerlink{color:#404040;font-size:100% !important}.rst-content dl:not(.docutils) dt:first-child{margin-top:0}.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) tt,.rst-content dl:not(.docutils) code{font-weight:bold}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname,.rst-content dl:not(.docutils) tt.descclassname,.rst-content dl:not(.docutils) code.descclassname{background-color:transparent;border:none;padding:0;font-size:100% !important}.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) tt.descname,.rst-content dl:not(.docutils) code.descname{font-weight:bold}.rst-content dl:not(.docutils) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:bold}.rst-content dl:not(.docutils) .property{display:inline-block;padding-right:8px}.rst-content .viewcode-link,.rst-content .viewcode-back{display:inline-block;color:#27AE60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:bold}.rst-content tt.download,.rst-content code.download{background:inherit;padding:inherit;font-weight:normal;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content tt.download span:first-child,.rst-content code.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content tt.download span:first-child:before,.rst-content code.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .versionmodified{font-style:italic}@media screen and (max-width: 480px){.rst-content .sidebar{width:100%}}span[id*='MathJax-Span']{color:#404040}.math{text-align:center}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-regular.eot");src:url("../fonts/Lato/lato-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-regular.woff2") format("woff2"),url("../fonts/Lato/lato-regular.woff") format("woff"),url("../fonts/Lato/lato-regular.ttf") format("truetype");font-weight:400;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bold.eot");src:url("../fonts/Lato/lato-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bold.woff2") format("woff2"),url("../fonts/Lato/lato-bold.woff") format("woff"),url("../fonts/Lato/lato-bold.ttf") format("truetype");font-weight:700;font-style:normal}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-bolditalic.eot");src:url("../fonts/Lato/lato-bolditalic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-bolditalic.woff2") format("woff2"),url("../fonts/Lato/lato-bolditalic.woff") format("woff"),url("../fonts/Lato/lato-bolditalic.ttf") format("truetype");font-weight:700;font-style:italic}@font-face{font-family:"Lato";src:url("../fonts/Lato/lato-italic.eot");src:url("../fonts/Lato/lato-italic.eot?#iefix") format("embedded-opentype"),url("../fonts/Lato/lato-italic.woff2") format("woff2"),url("../fonts/Lato/lato-italic.woff") format("woff"),url("../fonts/Lato/lato-italic.ttf") format("truetype");font-weight:400;font-style:italic}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:400;src:url("../fonts/RobotoSlab/roboto-slab.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.ttf") format("truetype")}@font-face{font-family:"Roboto Slab";font-style:normal;font-weight:700;src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot");src:url("../fonts/RobotoSlab/roboto-slab-v7-bold.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-bold.ttf") format("truetype")}
+ /* sphinx_rtd_theme version 1.2.0 | MIT license */
+html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*!
+ *  Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
+ *  License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
+ */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block}
diff --git a/css/theme_extra.css b/css/theme_extra.css
index ec7002a..ab0631a 100755
--- a/css/theme_extra.css
+++ b/css/theme_extra.css
@@ -21,11 +21,11 @@
  * https://github.com/mkdocs/mkdocs/issues/233
  */
 .rst-content pre code {
-  white-space: pre;
-  word-wrap: normal;
-  display: block;
-  padding: 12px;
-  font-size: 12px;
+    white-space: pre;
+    word-wrap: normal;
+    display: block;
+    padding: 12px;
+    font-size: 12px;
 }
 
 /**
@@ -77,9 +77,9 @@ pre .cs, pre .c {
  * https://github.com/mkdocs/mkdocs/issues/319
  */
 .rst-content .no-highlight {
-  display: block;
-  padding: 0.5em;
-  color: #333;
+    display: block;
+    padding: 0.5em;
+    color: #333;
 }
 
 
@@ -103,7 +103,7 @@ pre .cs, pre .c {
 form .search-query {
     width: 100%;
     border-radius: 50px;
-    padding: 6px 12px;  /* csslint allow: box-model */
+    padding: 6px 12px;
     border-color: #D1D4D5;
 }
 
@@ -113,16 +113,16 @@ form .search-query {
  * https://github.com/mkdocs/mkdocs/issues/656
  */
  .rst-content .admonition code {
-  color: #404040;
-  border: 1px solid #c7c9cb;
-  border: 1px solid rgba(0, 0, 0, 0.2);
-  background: #f8fbfd;
-  background: rgba(255, 255, 255, 0.7);
+    color: #404040;
+    border: 1px solid #c7c9cb;
+    border: 1px solid rgba(0, 0, 0, 0.2);
+    background: #f8fbfd;
+    background: rgba(255, 255, 255, 0.7);
 }
 
 /*
  * Account for wide tables which go off the side.
- * Override borders to avoid wierdness on narrow tables.
+ * Override borders to avoid weirdness on narrow tables.
  *
  * https://github.com/mkdocs/mkdocs/issues/834
  * https://github.com/mkdocs/mkdocs/pull/1034
@@ -135,8 +135,8 @@ form .search-query {
 }
 
 td, th {
-   border: 1px solid #e1e4e5 !important; /* csslint allow: important */
-   border-collapse: collapse;
+    border: 1px solid #e1e4e5 !important;
+    border-collapse: collapse;
 }
 
 /*
@@ -155,6 +155,12 @@ td, th {
     padding-bottom: 40px;
 }
 
+/* For section-index only */
+.wy-menu-vertical .current-section p {
+    background-color: #e3e3e3;
+    color: #404040;
+}
+
 /*
  * The second step of above amendment: Here we make sure the items are aligned
  * correctly within the .rst-current-version container. Using flexbox, we
diff --git a/fonts/Lato/lato-bold.eot b/fonts/Lato/lato-bold.eot
deleted file mode 100755
index 3361183a419c188282a8545eaa8d8e298b8ffaab..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 256056
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%0D|Pb8&JeGAMp5L<
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

diff --git a/fonts/Lato/lato-bold.ttf b/fonts/Lato/lato-bold.ttf
deleted file mode 100755
index 29f691d5ed0c2d3d224423bb0288e6bd59292511..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 600856
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%0DlAp?9S$v1aS+zA8SL`rj9s3ipCNfYQ`8n;ahbfV
z|Ae|}B8{|2pfX8hHnCV850uVJnDxO1SGdi{=Neb9HgZ{2GCAKEbU>b30Z+I>W%RU;
zC#uF8?M{<LkIV;X+fDgM65FguPeL*XNme*T=+=kt<T6Yg$AY*x8w#3HR{<evGZ?^F
z5N*Mhg~Ff+`+0nW&8=*$Q}`N7MTMkRS5M`$>gHMMM{ALF!6oIQLV@DX*vM#a2^j!4
zE9$5~@kLc&-xM0dYU8ef*k}tfHt;@oQHRM|&X$ZWhmJaQ58;I{S!o3&a|OU&&xagV
zDBT$ppn>pWAYlMtStfNDAe^q$5iAdVuRMPAn&?QQ(^AzJDz4XY-PW}xE~-VRRPtq!
zv64Y+QK5h(;#-nsI!oMDSxNjVbaeQx2dy>33Gcirhe~OQC@Z5PeIdAcT$XsDSzR6#
z>I=}mQ&Be%uY#TrHh9Jc%!+L^rMc0oXtxE+@Qj0w0K(j5>aQ*9iW<xwtKU)C;gkiV
z08s!Ys8E?yR=uetk!XY3+D4VMh$|{$uQEDSu8={Wl!_BRchV!zhcXY<LcWl%Q^@7(
zJu-12x3B=90q7Tp{5_EZTNij5gf(Lh;=P{)#xn9WfG8$X38}X=BC|+X1WzJS^4N*Q
z=>%*0&zub*1B*S#6|e<r+0S+$5e?6*1s&cE@*EUyB+r>WGou8FN%t9TmAAOor#fvk
zfJqAyzU})8<YXvD){)5~7809a4?3yah&Ik`3^ojxDu5*DK4)|%DO?lS69WDFX2uei
zJM<!v-f?B(bY<n~1p6(dtjit9N_WWRHm!(0{oCK}I012JdG*vyL=TJ`Y*i^rF9To*
zHou^e`qMI1SZVXhZDG5FeTu$Yqb--{Bt;ru(u&8|LLJZh1jYw`3MpJwpPV=W7Z`Hg
z!gC|g=Vo{=y32BUNHm8Y3c(-NnxFo3<o);2d#ULU$lnruFg`6X(<|WpctfBh6n=t(
z_5_Y128SjEUK&QPQOunMqE;l}Yj`20md6fMI-_<mK}f9ugGzJe1A&Yqm5HU&<1z+}
zkjVk30NjF=7wj>KEMhx^_~)Bdwi21#ZI%}hZ%;iW)QKcqfrz|e?!@7-;W^{9{?|F<
zv`&3Fcg~u~9}x37N3n-;);2@ZA2u4GEW~`NyT-5f>iBFq96PR5u=O-caf7+8+|1=Q
zf(U>*faDib*W$i_&OjW8HOTr|h~xCrCs>99q?krLN5EXDPB?EEWknVV=uz<RR{<|5
z!VgKf3;?64^!XEF9hmbYs`7aiM!#OhmhlRC0;4{ew(c<ya|N>Q1I|?=^e+QF2@978
zPz(i7Or*|gq5*7h>U8u$EK>2g_&dfGOf%==KcEVyl`-e#AcfSAA*13~APU6vQ-C!E
zVBEP_6ATSq8JEGF0Biaq!kW-gMBtJtgvJVh6B;W3PHPOjEY<|0LHN?SS>yZyVND3%
zdV^^*t+VH%Sztmi2G2~YGx7~>z*x}}Qe^<G!ZhFofCj&iCu5Trcw9@OJ3v@7kX8o3
z`Hs^@@no<Cpj|kJWGU<cc!_;mew2k40ce1mqc|S2v`?nyeV4kaPc9X_O;Sjc<O~1e
zw7f`)3q_yG-I8y@b11m$j*x9|*Rdcf0xmx(Y{>{RB=RE}J1s4He#jeM%p-&g2ZXB-
zij{$-TrJC3TQ+ZAw0iZg>`h};)ytY3U`AJ0jWr<vkjitB|DclK!$x&(5yFmdQzw%%
zADj@Nu_EON^B9m#9}1GJs?N@;`;FxeMR)T4x{2OEpm(AUzL_5g%!hASe6kt-BMGT3
zY-?&IhzG!KA4@`mPGrM7p%clmCI|6-W}ciNXTA&LYk;<~U;*_it0Z4m_W`Xejl23-
znH!Y&I$y?9YK+oyu&>Ll`q=!4UMG_AHC&!LpQjJ1QQ)>)phuUI8m^^qW!S0-b%o<g
z^=y~4u&B@^mVwVKT<oeV)pCmT8jeUA<rkUD>&(GA6<5HO^CVJ{%wAb)P5O0i1Md6u
z6XfrRBj6uI`H8TAPE&|3r!#WopDW9HD&iq2BS4HgWw5Kl6oUP%0KzWUsH47x08?d3
z#%FoV#J{pznN^JHN}I^HiTgQm6l0OT4Kjo!ETcFUB$U$ualq(>D+4+28P$=vA0_ow
zm+1M>R*{%1l(4xRQ_vxE2_(H{wyFQhD}_P<m&-EUfdm>43pA-wK`1?O8$pQ0jnXT$
zH|_W*2yGZR<U@l!xe@j@lPf3PN)@_NvhJAd^^C9RBR81zaDsmyfiqi(fK52lUhnA}
z&O})2R7R^<Sn&%zK140Ws?D##f6U$}p>85qz<q^q9lXmKO9>m=a*T_inFjYKXe8)#
zfi}WGte_K&HMtTYg-7Z$sNc}~;(mYJr+rgp@X9=jP^GJBl)A~9=m{i-H56;ULVu1G
z@t0Lpl=&m9b9%*m7Nr?ZzyhEv73RL1I*QLS(ixCBFoz#W)Yx1Pnv;v7(M3t~gD#fQ
z?M3W?U~i?_T-ghCp6MTW(b3AQfaf6j2Xa3ncks3W(|K+x9XRF;-U-4HjSHaEVq>hy
zCGd5uN(^r(A_)#>zfwuE$U=u&V$q5UxKN2oz~RX$_I-u<u4J37ea8at#&wRtn7-1g
z73)eBp?Ug{TUOE>vfF`#g9R1jm;vWNkkK`e4-(5KR6Gp<WI;0cy?efURH9~AaD_m4
zOR`jA_Nl2)NwHY)T~pGStop7%4CC^UZ<Dp~41`HD3Kf{L$i_#N+>ud21+zwslC0Hv
zHU1j6l%C{rfAB7GH?QceU+|?|aZ!<+Lw>~PqC+QY;hF_R(f($Ml}lgvx<;9ntB}i-
z3X|Jl@8x60O<MQQpYc~+lKdsx2jW$Oy@;>AQDAWgwDyoygmirw#U?4Ou8w3=G+mVG
z4@*tTqy_wBpwcFg+X6aByrvcy#c(nUl`d&3>RaLdCaHx>e+fgL{yX_0@g3+BNYu33
z9xWMoA~S+2ZK9=TgRsr-vNo)2XdE;G0R%*nL0KO5MMo9ezfar=Z5)@5HV69ZTy|Zp
z3Y6hcus9OYif-QDq_hL$5oC50&fg$sKlsB@)(t?%F|vm^`{*i_&bb(VLy5I^rNX8a
zQv@Z^TID5?{OlD`IgSDc##!%%Q+}Dup9)`5*5HwLjS<nn@C}1QH;x1XBR38W-Y^`1
zbzTB{rI~XL&i|FUH}U<AG!wK0Gx^y#azdc3DnTBMGnF348A4Ou9mARm<1W&%_bN2l
zO@yv)6L^M{zRnnk9wh#3FesQxuuBdR>tSBO)0MtM(eBETdl50Qez``<E>KlEWm+zm
z<Z}znMMgUx-KJ8d&FwEL*v~6unY2U<o>u}g^djt2v`(3QddU-!!VO{t4TiX=4_KkH
zy+R(g&wBhBu?X*1Hu({cXMz1X-%*TPqKrBsHuYnpl*Q-)WZpc`1MFB<nxIuIu7Lai
zwrUy=L-Z6NtHF5#nGK^fshzs_3iV=di89<*_2LO0U%-wPx^81B404ry!{;(xfwD7T
zsq|?{@xuk&Z72`cH>np$Kj^+luZP8F$c<9seU(j47QUWuRIb_0X_Xj(jUy5o$RjYf
zB>D{XE&LfYyEC6M&wM-U0c3^BCZmd81D4U+Sx=kwTq18Vb&}Z4(IY(^&H^ANAWRGZ
z!}~~J<J74|5<p2D;2V~;rxxif0ru|;i}e+o$LFcIPF|q$&XbRJGHc(*8Y3d?3-~z<
z%|@P9bb>^r#OEvV_Eg$zl|5ee^`+p$-=Gh*dVOtSxS5H(Mex}e^I0jL@pSYd7_5tO
zKg#+E;0&b`hH#tD+ZsateyBMLdt3y5C*VM3{k~WOnw5h{qp65TmGR}NVuiP^<V>j1
zEe3z2!>9q@GsljckEW`jq%&0)mi&WgEHD>`v^8;_kSD}#1fdO2x((omrVU3huCn+A
z;)+^7Dyj1-i`&NIs%X4IQ^u7EwMK_F78Sc2LuXhACE>c1GdWac%9kPw8lE1n(T0j4
z;P!bKM=xcj_QJkHPIh!=C<h{KBRUijr1qXr8VjyAN+i0i1t#_5M9)=}StTI~s-w|r
z`ri^2c@6Go<{7Y-xg2tk>u~z1z4T*O(GTG#iByGRJ$e+JyPf1UN(udMb6g*-AqvDQ
z=*tP#?Zg7kd~A~j#nux~KFOI+*P(SL^B#qNY5?=XvD0wpAg+rU++C>4W}>lBtJf6X
zMz6Y1q}9PU#I1x+B9%($ACo_kz<&hh!9Gf?Bx}g?n6s1l<jL#@j^H=?p&ti`3i2rV
zFZ@2p(Tk!2$)i(WoO+gc_nvzQBmJ8>@5%6gj-Gn<6q!#hqJKje@5y=396Ops?}I<Y
zcaI*u`{+?LKGf!Sq0MnTcA&f-AoHibAjj`c|L!>XB$Y(?h7=@pPOXnj+$t0aIY6kO
zdWQ_Ecj!^|j!e;sJISA}%qh!}E+IjJsZN5N`;c4=a*m&7RWO$?C`y+p4UoO@QSD<)
zIE)aLMTH_R{3+n96G))=rZeI3B%Gi$N(JgyZxHJsaX}%ARm5)Ph{QL(N>bmFS$PsA
z{BM#9s`U<oR%EUyfwVmpW|79|)cJ`O68`<5Li6O@`}q?34$wOC?uU-9f&G~elLWU1
zqK=Yl-lQ)QEcVGS`&pl!C7AiU^nK!-_fb!uB`Wb;{^$3RThEf){}=Bg5@)GrX1$M%
z`Uky(R_PGaxwEXlF@4*Sw~u^;+B;+ClaEaO@LAX+Bt3O6j4|_jG)6NF63}z<5&F7k
zpCz^vPtiXlY5IqGdEmn<o`$@DL<oF%HF<d#uERfD$|?hH@$W&WdM@wbJS#gkJ)e-|
zQS5l$58x|s$H2o-#C{Un9tfyL4rsKNNDUTHK;kfq%Slu{L0#M2am&7y7W2w|w{$eu
zwg;CDftf-715DVV@v?UI9<`?Is$ZQx{j00WH0o34jw@fB&O1f#A@-dj@?N~M1KA!h
zw=87KD)3xDQ^+VRMr16Y1|xFt<3yl+yi!f^REl;o*+RcZe?}c;{gCd}#uijS*<4}R
zG4(Y2<j-Jl!m(#JLcgWCjO|P;Y5t5f#C9jl*X#4IA1*5!zJC6K>(JNh$~K?d-!ypY
z<D*AEKDD@c|M|`IKS+LHU|&zqK9q@?`TCx0{MHv&@BGO<i~8^W$<8$|-a0O&-(uDb
zEEv{RFct`sF@s!;NX-a($p>kveZpav{QlzKh;jT4B?@>*AypahO#Pji1CAL!=fHE2
z<(7h&LMk6j16~3GSEzu6;F#$PEH?c$S+R*@Dwfgru-Wv555+2(giG{lBr*-r%auq~
z613T=@0;44bfv~@))22cI!qVK*(a$YF`r&y*62;dJ$!Kyh4&;-BiKXiv)Bf-<G?he
z?;%JIEj>#i!IK7;2o%&xLi{Eu8Ehv3JtTC*vG7t~+2*<}?=5qeEBaE$?>RN}IKewR
zq^}-tc}Q&r@4u<5(QoMv(YrR1yXCg2tEj=hnml5)raUYo4Euade$~=*^xsb}c>1~X
zBT8Gb%(3I1^D9VW!tmi);)?1JeE|2dm41Nrb*OKS_+05IdlWkgMgUZ6L+(S+QbXmE
zunieF5j1J2)0A}N{>{~?y^jo!ZLg8}ye}0>L`4ObrmCy{{N&0NFA(|n*7ugm*=rRl
z9#uSiJL~Pr?N4vn`uMI+m8!0z*ONNj&?2-s9b%cyViFp5Jon|-?jtzQFN63Yl~ArO
ztX!Nl!Z{m)*uy0IS=fc|;J!k<DYX^+xp0Z(#NXhB#I7FfOvneRZGb(J_SSB-cC<I?
zcD!~dRd?_w$IP)v%p_!&7=<Qh(6Zy86jFsq#m9C8pc0AD>EIXzVlJ!cdQ>LuNEfS6
zP&n>Vu{f-Kn@{aKz|LnIoVXuB=*J4CA2~V)QU+#R$l(YGAvkd`r|3FQnWE8{`KF&9
ztV8MUbWQD@76HfZ5^9|Z|IT9~T1Na?dSIue%xMxCylm<dXqwe^<duzkUcbJH#T5(s
zod#(Cz`j$P_d$PD;Ix4Gu|O`rLhy-^dGFzVC8j@Ntp)!t*xwNAgS8Xbb+D@lXOcwe
z48X=ivjsnapA$*}3BU|%ZKS?(Wt*E7O&H=TntM-Wi;-;%nd8il*|CH%t|I<*cd{9N
z95z38hgd2LkKFdNV<jo|)bID+_m>mPE9B^hk&)Yfe$3mUCUtx7habkk`i7o?51#V{
zMT1;yfgP6iAL4z5OXnhF2ssCWa^z$wMrRY7*f5oXEQ8RBRW4SZ*iqpzH^gjQiIRKq
zJ6wf?Yl}6QJr$7up8V43xLISVSbh6Y#c+FEp-i+5LH_&I6&CG#Je5U3ybKxeUHXpe
zRylgQT8+k3XOCmmbsc&a<iP*l_sHaCQ%T#MsV#3D?bdj!Y_=+|ru*m{TT*wWRtSt5
zF^ppky`B|-oaPcF5uux?+gb1WT#^VLCZ1|E8Z3DcEC7HHG3uSDi1t@oER_p_fq7N7
z$*S#7O^iNyO-FL`17nMBj;f=J8%oB5b^T!_#Z}0f$Y_;!L3q_;JL`$Ec+lCidqLlh
z4y(0(S<T8vx79XX^U}8UFCFTviZl(zltsEoPl&Hk2+C|l-qnv^4f8+!2l~l$zY!|)
zU;2$PDC`L##xng(&M)`(CUHME;eJj$u&n1$_~_BeYp?xJU5W(mczny2$I(8mf&6&i
z1zAky{SoieHIPGR4V)i1O>?tnqYOzIA%o@(1qrW-ZiCR|1Jwey*I*inbqtq_f7LV`
zQ&C){tdWe@|7?;Z_rI~fRxE|nD)9GR+38i5wS{?*I3Q@7x(k|wmg`_1P|XQ0LOpUL
z)s=JaFe_QTcPB(e@7~Q`bi-&Eg+`;A6XCHN7EV5X`XmaFK5^zL$--+MTe<zU>swKB
z$d!-pUnrqL5rG`X^y92T(2wE1LVEnneMO!;1^3l&r<M@?=$oIDU!xxnc!<v_R=`6;
zpWw4lOMvxb_-rw}0QCdmx7hAQcNT@b3TS4Gu!!J)0Ob!N^?v*T1!94omU=Cg5*a<s
zD&SDR{9LS-iMdbm<V8hF!4pLinHmyHT%gHLbu5w4(hq7)U|%oRCK56A#ii_Ss!%NW
zqu3x27-S!!Tv2Ggi0O;amqEzw0QjZ!(z}bf1@d#RE+J%GgpR&Tln2MWuA%V!XS>~H
zik7M?_aACM`rgg0`ie!BM>Qrs@Oc~S%8cFR(<_P3BxagLoc)b8B-0xM<uby!(Od6T
z4n6koI|t7^dU{Z4^~kLMhqm{CkE%)oM|19-k~)*=ncgxblT0$1NoLY}@4bg4gb)%4
zCG_5VFH%I2B1KS&4I7An3c4=pTGn;dZT7CaqQKm|@7z0+1VnfL@BJV7k<7hw?>XNo
zUpZf$xb^H*WGdA^w*&QMB~Y7a_yTgMXUScxQkri8y4}gM*vu)-4Vp#<R!oRdR#d}^
zmb4m|G}eA0NE99%qIN`P%<65(Fyt=3xVXA*Kmz>AQrwr*FsIZ=xSOYxCTgXw^g>(N
z`hpUEq}d`68MWZ17@blvaYJkO@%aUjPMTlUIHmf`HoVVF)E<_N{dNEk>Kl*Xn;A3y
zJIjyyDP20q@jjmg>>LG(QZ&uh?MZIUGED6&?001B>T2HH<Ib3Vusg0S%M)SDYDx^#
z$OTTLIj1!-Osx<&BXRlBsK(V}9@>?idNRAbVEHpM7XD#tl~5O}#<)V$62O&wc0th?
z|5Zvp?71|^Rre0?j4Y5<Xv#ZET?0yCLoA7vxOZ?6NX0bFKvEIw9bLgRC@&B%4%G4Z
zHkBtzoiw)CM%bM)o9H%%k~Y3H8rhu@cJT;9c~CJ@)U7DrE^sugdvUeeB^u3JL<uch
zURkU2h%s;Z;_&zsY_vfEJBDtce?dKwyVzZKd?Z%nYT}X<F*$ZAF^6hbsd6JCBSQ5_
zr4V@t>vRC>9mR5maF)aC#JKs>6dHSl`PmdA^<b0*#VDQu9th_kH-cn@$DTn#$Un;f
zsZAT^l$6YAh?Oh0g=*r>5ZN9|?Au5EGWh^INE|2iz8fUhM2cQPkn30+CnKzIX%xT0
z6~-uB6$wgZLWN5a6Psq_@r-G)znt^FhnmQBuBn+x9g(*V@-;F(`^c?Xu4$P`osr}i
ze0>vC(*Qr%FxU#9sdU{flaCnzfFl2XhXV`_?UUdiGO)BKL!rnRSNhdg8?P=-!x9b^
z_|;b^3^h^5-h>id_V_A~hN>eLWlY>!JO0S*ESBcw7hZVzkMuknK?YyX$lx#oIL8of
z8$Q8qh4-l+zWRz>z<QS&yy9I<EWJXsUxU|ReGX8&SuewTbj_q;vW~?e+9^Of!b8EJ
zhz}-ubSiaGasS2bjg?!j%ysuA^9i*|;IS3Wtc#6ro>yGdVS$s%0`E4`pi-x<{ovp|
z-yCiV;~kJFd9mGlCQaYdYBox}``Je@0B~xhjs-pr{bvEihjqie1k3*nSAoyqvq39Z
zU_HU50{{dSq6XZe;ot`vK3HS;jD>O_xT3(v<ID$DskL(I&&nLv9`7D!u7dirye{Q&
zG|yO@7?Y`{*1sK<FF{siR@7qelBi4-vPkl6Z&B;j8FqKA@y0dEY_y>!mknKuiS(`@
z7DUES@irIHlU^hgq{kAm)=0`7qr$lwR59q4NUQhF*mQxgD4pu3=kgf)Nf-<8%-hDo
zY)X8bxdUMKlMd6tLbFRs{UKDTwa5=pKccWTQE3X4E_Rzgp=Qf-tZB7oKUh`^`b44>
zaJ(x(Cv;F{MsMk?-sj9to}f638t|<r?71fZ2G|d97Q+(>?y!kCcOLW)KQvy9%o+QM
zf0vr5|A<}Y^8>i^f%A$e0i3;(%^y;`W$C80IzuJ;1QNU6yv6j2G}I?-mD<;JJTJUB
zhh9g#*WZVJLF$Em@d`4d9@*e`j-LJgzi%5kz12y|`|I(KjGNi<@7z9gx_{6#a_|`x
zxb$uPV>QE_J#&`+=eC}y3B=*w?e+C{?woGAPfVX&&?m&f``4SEXFS(>0ml_*KJclx
znfd|oh@*(-+grpO?;2RXZNy}t60{zG`v$auWf2-{nU^8E)EnOI)DQmG0bOoFStkFh
zzO|-y2jaK|2fPc~LqAo4*@soeH%4JE=v)1;v7M<4M-X^IGI(W?s?jJMnGzo@qQ3WT
zpnhO&y&a7$)mDiz%#X-H;gS&Ve%8A;vG)%VP!8vaZuS#k^~T=3nB!wx5`E(H$w;(?
zfX-u%53BG1_-|s0?pIdemGb+PVVM9sy23q-_2kPCSg9x}4Ar<SDJ8^xY3uWH?kOs|
zzkV<EWOw&@BzaVyoRp;Fkvxf#4<Tw!Ll+!>vt~WmBaReiSH`ukYw6n98r@l^h!c4V
zHQG2fabMn)rhG-l(^Kv3rEv>yT^9<qMuTzkWfXqk5aM4NV8aQoM{HIL;5e7R{M_7m
z=a=P^MAhGS_aB>{UO4Z_n9X0du*tA!yp9^`7;8Js0uM$GXvR=7tmKjqA6)~o^f6V&
zn#sC)i^EVD*3}O_p!X00yorJLaC|aDw&9&bKb?aK^pQAHjbf;`s2{1fP>lEcuZ`Al
z6eu(DLJcy+39}i#^?pyJzf7$|vtG_3qYMhF)RLvuW}DFy63eZ30X~8{#_oiE06+YD
z6=SK7yapjXCag4ha_NH*yAwdpQ0arIGl3!0^PyV#P4qX)g+f*G5L6t@L$M(WF+x-v
zYV~bvD2@>=7g7NNHSrm7o-gozBbTH1MM7`67rdV!o|`(xl|cU^xB?p;vp#xPawX8;
z&0W+4Rwf|hbj0_y%6k2scWw^h4TjsOfHBO1HWVXc0M~Um8$cUk4L}cn*|VUfPiMaS
z?7ahNh@Z0Z{R6{|5xHtraAN<V>5#_6ST`jh*g_nlaj*h-=TT@E`@}&Lz)gT;a<J(i
z+ND!e!!ih1N2%}ab++>p&nzxL{LaDi=6VNKH4(W`tK`OKL`>g_g}CL3^Fol5dWRzj
zArATQ6x#nIw2$pK?np+pl@JSa5A6dxJ&8<j&!&Eeo%Py&Oe@IlXi@b`k5ESRVcis0
zu*KUBufjjbsRa17nEfo+C<~w^pWFCI5CYE3h_ML~7N3-a!$kmzKv$hgtFwG!HhW(D
znAMF<8^&jbasu;b9_npa+*PcX=t8Q~Ht*S2zWL{KGlN-J;uA?WYh<ArZkAx+^fz1A
ze0-#xE7Z!!Zb$`?l-RwY;i;J?r>8_YqXfKh`K@kg%NfKzAx-VYa;B0K$>T>Wou(!4
zA82bl`r}@!OA~^}K%Mc80qYv>J_c<1j3xhH55h4pb3w-Sxv$^X74&~P3U`%T&!wJ5
zg@V45KkWJ4p}>ATKs~@NhsDA47mFaYW6xbgCuWZib0PBiFtwoN@Z!?4O;;D*E<j~Z
zTvtqeaJv*hjumUdLb4ZL-n`{s57dY8_5%TqZrjo`cUQe;v?M_9H8>L<gW!%M*ssY%
zOUC+Of>v+QDNI-j<N?ma-ACORI8Dvuxe8k+Eyx26wjwdn6&IzKbI4uSuzU-W;&;?^
z>hqIbM$lk~T1pmz@c>o7$M7s_H+vlPfenLqI+=mS1@CJ5hdnNB_L*7C2$g~)TXJKn
zdW50f`17>K7v(bJQKWT4)X@lc!*hF#lMa3GhsQD8EGHd{?x+1N0cXV!k1$6Dr{Qdj
zaT;g^KBv?4*mVcBU>*Gwh{d(h!~!EU<u%v{4Vv+5YC*60G48$4E)XPUexd3NNUb1g
zVZ3IJ|5!q0C^tTUaPNJ9x-oe(hbq-(nX|N10m=IMRiQ#62t;QDYB<sh(1}2yL?L{Y
z9tU|ODf`x|si|a=K1+G4g?)qw6!LF<pv#Li<?Bd2Ul>SWYKZAUA?Ow-()0lDK;MA~
zAA5X?YY4Mq2m$C>N9j3HY5bTq82z(CZ*kK%?RlVlCnBF8=zMG_-~fZ;nh5f|;G5SP
z7kAQRfhewBKaNItVs(CtTiShz`rEnf)U6k$0%G51acM$7|AeLjFh6?8WmE(6gCX)G
zM5OO5ac3GR$e<4#0GK?nW7b2HTwMoVpSqbE>geOi0(tU?a7SKiO4(qU*-$#C@nX0X
zm3t46f8r^~Re^bvHdM_!zdV2XteN4gU~#zB7-26P=ZUXL)lV14h*9o4-O_kid9V<c
z0?lNBem@wzld;Z51Cs+f8(&Toa0ti2BlJW?nn76zN_5m6Qat1S&d&R06o-(!lIeTe
z+xN^U;h~F@FCJXl64!Tu`r+_{)DJK8_rCyw-MsGmCM73Ny081nm>s=tckhld#0*#a
z$_Fp>-&RZIr76tbVX0wmz~(SoMgUt6NC*c$#pkn|KQr<Hb3B4~3~)Zf=Q`lqh(6c(
z9HmCiXW&gc>a5pDJ#@`?)Q2Lre5e`iiK1?N{k8A#M^#W?Wlb!PX39ht=h;V}1qs0G
z+05Dv=b`e;k=SSV_XLL7OsD?Jx$dZ$|BLj{_S&Z-rE~$B-;pBzLen>_>tas;81(@G
zQP`mEmtgQ#VuTnhGC^!TmZsPfs2`OEpAZwG10m*qAnxVVR1~IE1fybhXdtpnjUdSM
zqH5}eQN1sIndk%|=Ibzd7<%92-TyMiw;15#PI~=7Qt;;*1noF14AvWiE)dY2G+il~
zTof5uG`R%5O+{~gYh6ykhBr4}xk897MdQ*_I`hn|4{x;O&3mY)@8qI<0uKwfJ@jvm
z5!w!Cs@L&A_+|9&i2}ACkA~w5nVzt40!#&L(AZ``wBv3KIUVWAO=()<@0{R3c0%Xc
zhABHt8Lus$bYe~>4F(EJ$|*||#@UF!S_;RerHw5xYm>@jQQkO1K~}Q3W5;-Rdwpqp
z-u&a^`%W$d@NPceUOT?c)2cMb!WIk&2b%L8;8PxrOMdkjmhz)<-8u}7&z>@z?VOh4
z@o=EDJj@aeE&DAtz~=(^T6Xj$Yjb)E{(zocxMAhO;=b}kiC7hyQ~TM*na`~(Y-^u2
zk*AH*n-jq915i)*gPG_Yx4Wlge1`JR-D7IIbtauyyrifqsb_s{&tX^mOFQH9>~fC6
zSrqF79bo5!jD8hh2ioM9fd&5!aFDxMSK*ZYsWz)8|Fyfr*x8X#pQiJPtY|^`gsfi!
z)qB(>&90x6^9I)24t>J~D<vH#<zHJ`+Wa-E9=*bxpYWU|bZu;|UpLnM8{9iFwKx^e
z)3o7vif>=lKra3bcK&F4xqoqi=K@?s02j8$-Uin&>m3aaH=5pJK5$03u^S)|f}MBJ
z4}m+reRTuU`nmhf$42)F^qGC0SreaG$xnxU=R*kK0io895AH-g4(el{Z$A9R))Ulc
zS10#hM$$)`_ADE)mkU!2`kd;X+=-9O1*^+*GoQRbT~la?w-2v)duO%pSQmbIk}AHy
zHcuTU5t&uOqE*k$Sa@kw;j#PGlHGWJs~|`7MVJFjZ{ct<YQQ*dZg{`L*@d;0D))_b
z-RPO1%GgIfxV3Y5khe_(*^iHX&`%xk$(3L?1xbFCope;DKU{cf<Y){6Jk<U1&jK(o
ze7u*jR(h6f+*3K`>Fuqi+>YeTMt4N<hO0{}SI_8*N)v#erK@7F4k&_p<BIR7UrGlG
z^w!E5<#}BN@uFZ^s5Jcjyk@u5Gv&zSv`H;Ra!F=ceRTPzN!haKG*h3359P@;u3S_5
z*bCOoDvPTr+blQP!h=HaF$Uz!-E0cx35deocm)W6zuwGjYJ@X^5*kX6Q8#{L8(;hU
zHoovX;waG0d4SjN0xU|}<NY`F#70I>%mJMP7k**86+WnQv0>i>zpz%3oN#w-G1~p<
z<cHWSaRd>WTx4pT%(JU^U1zhP78QLxg%_*d$vzUTaMdPjwaK+EMKqM@4iASy-8Ti^
z??F0klzCLKM#5FqlQ4g;#L6PP55b*y9pS9%Nu0k|YPp4Dspx#5P{Uph@(OS`+6IOx
z>zyiNaBl=pbYf;*t;m{XKl|jQ9c@tw-H_bB{ltkc-hTT`U5+ZjDx=;<ZznWO&n%kT
z=pg=$Eq#;ey$3ova-Glqg&P8~mC+TWS6+GL`iT?7S+exUQ&b~*=oC7Bmf5dR@0xrP
z-oZ=&@Zt`26X_QdFoCBPKKKkr##34LzU-E@ZE=|cI~$`aq7jQE2|^hWYLrFg$E%dC
zVtZVM>N<-!OTD6x%${|mXXg1;MM02cLa7#s<y>v){Pvnj8FGb~+5nwn{sZTNlkhQX
zgoc9@;Lr4q^~JP99(dDXeKGdl@umJ{^u=(W$^WK7TEsbN(cWv$$rJAuW!kF0t%=GK
z?H1?d9RE(9<uoNke0Rx^9DY*dvgLi7Y4eCqh9?^@eixBoa%Rcbo~2R^R@7v*Bb6zV
zDnQRfny7!-p^%zAH9RaH*N4?m@9DJYDAlahA&bUHEw{#pg{RuTgE8R!isv8u%#Mb~
zuQnPrAO>pUBVmT|;<s|#w_?pDtM*<~c9DFSIMddC{d$$nB_v-^N8%oMeCUAzEhdTq
z4U%612=uzo1NmhZ(=V+f#o4iF<uG=m!hwI-3lWYiFoRg1&YE>Rr-nBe601H^di{Fo
zktop`j$9ilxb%v|6&ar?1s@re+Q7LvL_x7qs`(%9^K8fx9uXcyEst{Wc&W6!0DFxE
z8C-pOVQ?83UMeQk5VkQs7>`;P8Ef@%z0<4?-7U(BYKQH3{rK@pn@e<3lwr8^T|^?D
zgAl1!!VC}gbw|gkJ$RCtDZrBqbBukt0-;|RxqqzKwm`d`-Ps{K@PuzV+kU2ABAn2h
z@YJXo_fI8R^bE6{Ba_X{E3D@e(AS7=3+vly-!zz5))TN^f1;*d$5o7d`v$#4rNErc
zM=NQx$9n?ceG1yZdSLvn|9w6CDJtta^ESrITThI<i}3;Ql9LYa;q%u2gp_pS<j?m0
zEI(e_Dx#qb1A~_az)Q%(>?)%161pW95mLSJ_c0Sg1t7pb0_U4&U7>CG)c_IgWh|p3
z3Px*yX;~SgCRYD44mh;9n}U(n@4Gv!{q<n&Z>~KyJ}xH4ftob6u|-RhQ<vn7dvs-a
z_Tp#eS}V;wG8FRVhp2hkW3zSEvMGh&$Cs89TQ{o^)4qmco`$bbVdo)YadBqpvbfj<
zMfv64RY4&*XO7>OD3sSDmh;$%h-+F{S+l&=fpSldub5XG9p5lJzw=ZfL2?jy7l98w
zb&UK12F!yI-l6MVaL%gP`zLBU`6gNFoy1@wS$Y-|QHZ?-orDD51Is9!9_~^nc<ps+
z#%s#Rz?Z@!0)ym&R|AdmOGQxOdJp-OQbYyW>tkZ-?dZA~A8nyMIM}e{&>rZHO_(1r
z@v*e-7y_bU+8MM$#Kvpau3x+M>$a&GA*W89IF)&4^S3}Mf%aLjudAVbkcIs6GA2zx
z9cUUG#PkHni{0!+tZJ*~-dd$T<UMv+;Dr!f#0RL8I{6J8wB8L7KO!~$lREX8Z~Lo+
zs7Ig)quvE=u>gI~7f{Cydc-qP3JT`}l!Kmk6ZAWRPasZ!rT}AwOTgX)_;l+C^%80N
z5pDKk6yWAF-YIw|GINs;uy;ZmP+P<gJJ$Yy5g({5tt$r1>;(G%rxpJ=+<rZ(c|*6q
zDYRV|l(}gZs;Az_EH`k(=n~y1!d^w>L1>fK6XUEY!+K(9b68JI9=skACp%ode2nXQ
zV)9{WtO9#>pzZ8n){BoLL)pAW+;U-67~+AU6lykJ!gCGyPyPkk#==#GPnX2#h=Gov
zX)7_1HVou-VzM5CN1Z@%G<Xz7fA|OXX288~0QUlEdpX00N7Tdqd~dX~pnF6$O#8Uf
z#ug(hT<Na$Oq}mePtyqLX|(*psPR*#yT_kdRm)B3tBey#+SQ`a)LdTW!XrIh56;Ss
zFc5dmPLs9pnR!SM-&_jnV9-TiiO&&7G(klroS-HN`{@D9uucrjFuROCm`)&$wKQ~I
z9RzW#*enbRVbJu0oqt%T{oeu4JlqH?T(xF=Cg*>KytpKc`UQA<U3kU3BNP4${51Wg
zbHZc2#E6BTW~jHbHRk95ra7OiM6~%S?LQeF&Tt$-q;${ynUn8nyp1Y95m~*st!7G&
ziea^WZl|{L1aCbv2-O`%L?+lvB+TgzW}li!EcN~>jkSPv0|eTWw?duy^_}ArJg!uI
zPDWB(WH535EEZSE{Bw}cdU}>bB)C_cG5s78KJUW;EC=G8-Iyl$d{O)(qFn`s8JCOv
zC86h@vC)OY%q2vtk4(4AeVj06^1WR#fgvI_E$IacoGnFYm!B&#IE>|_7oaa%2aLzz
zXNrKjFYNww;H00aVvtAJB0vhb3N#wyDy}UAw3gBTCf-f~$b)}^?eW|&0l;`l{a~;X
z{J-h~Gj5{*01#g5W9&~@EPOs@<`s719m-!?+8n050`?~`&G&EvsW+t#g+ogHksI{U
z9~3UZ58<lNP-XacLZ{*n^n?>>#wN4(o#<%7Zf=S6US_eRda6p3YcS-g(P@L^7WN>`
z1fSL~X#BPVIJABUTkJr{_4`jTTBs3auLY?g;Z#!pe4)2Bst2%m;?rv?@|K*P-gRhp
z4xLwOLC8IGAq|yNs^OyzOpYn^Auh^Nxc;?OeNV5e@+Xtpw}UChGBh;w3Dje+fVm}z
zk0D$G>PZ0I!G3!jkY3=_0@MpjSde%Fi{qj@fJ3<<3ueujAB@80Po2IX>=yRhD_Z&N
zAg)mYethW4y3L!{EnB{3&2n_bU(^{2oj`e>H6^eHbE%`G1Nz1~RLl+hhE~!+Wu1f7
zd<zRnz<E;ug`43ycntD+?WWH=uxFVNUI?9}Z6d=yE_6nMku%V_k#j1a2j^7V2mV9R
z4{zLdF7=;~PyieBw3W~w)-Bzw_1|Nhl_TBJ$6{ME=uUlHRQ^}gL7n<qCC6O!q}2Ei
z%tdbpVl+1mM?c)oP4W1F(z0R!Hdq@*7WQ*+obTf{CJs^rEB5Q#dXM`0pVYUb`~U2V
zPe=8Lo<EJYk90Y38un@4(D&?*p&lgThdWBX!vu1;NbqQFCYA;9Vh%ej&>BrIuDJ|;
zxDb*S>!?i85wBuB3sxHTZnh*mGG*Y{U~0yUgFOxN9M_X`u!ayEEkXBnYowg9A+^Tw
zPeVa=60O;+EUPXnSb2HT;N>mV?pQ*7b4z=<BEBeA>9U)`%yD?GxZt1t6YS-?={Lbq
z@viz!@U6ghRv+-Rev|c{AJpn~JxSu&63>hoT@zZH6H5|J;Q|>iDdpig9Xomw!%gWi
z^)0D1@VBe&9F22JqTIT$19?fV9H|@%vUMaC+RMA$>hu&yPcmyve$I$?6Z^CtBQF8m
zztU~~F3@U3UIL`KCUunm27m%fR$N`L|JahHjW-B?4N+#AOQ>7WIs@j9gnCmZ*lRde
zVYI&N*DT0CUzldOU62pax3)Fw#wFd2F(v1XtnlpNC8c$XpZ<zldE4$-S-iIMhJIv!
z4zOWgw-MNA^9gJ|nws3U0okwlVX9u&o#bOSqc_^^U`+6HuU~hLp!VB;SRh|9`V*S^
z_-Hlb1v8@Mq*eN0YDq^dW9Ez_z4NYasVdueWntE|jtWhBxJxaFN-B!W8J{1yZ`YK8
zi&8lu-HLVSxP;>1#SN7*OM<Fh9wrW!iNfNV7gjuaczk_?XcZoR1n3+m!}!5hYt;C`
zUQ7F7_*9+Da<Hmtl_sDXJ#;wFP}`EhaKPbk0KsPA>6eTFTLC@&-<&;53ERti+WdF~
z{^SKv$8ZYlM<U=Ing)|VAHRXV!G>~I`gk`P<r`hW)M|V6h)wCQciR_tP{ZF6U10nr
zAfx3&u7G$LKUjyD9}we*jimI6l)fC%ID=COJD+Oxmupm}XlFi6*R-5A{n6BFT+>pI
zYg%>}SfZh(Woi_ZO3C`ylb@eM4|2Gb>z|)8_`;^D@-(`vrPN+Ox2$}2wJjL!z<jfQ
zNY7Srrhu+b5CErT6ZT;QYH6c0Yyv%zLE&a5*`~*Ap%s=QECOc`OjIEkG{B&DOQn@H
zK5elD5?8`K_=ec2O4f7>EYe_6(B4_An#)N^(M!wu$fRl&r+etXiq74Ap7PCC=kxGg
zq0ki<hCfJ)=Q^5$<kHXxwLvl_xyc?Z1zquHfx!g%GeIJY`<q8Myq?|DJXyF$X1PWN
z-7f<xoOR{tcjj*R?%Bo4jS=RjIZGqVf0LIv7KRGxK#=SZhXpH+Q9u*u`!%5N&xbX@
zGf!KKxY#WbLk&7PFj<dS0DQskv2c^oeFK+Zl8s{R_bV(Bq`6RQ;>=opYFiuzQ_$Z;
z4LyE<8hWw|LYz1c?E6ncOCThK)|s6-jmg*}EWUAW;WD$D6Ba$G0A$lY2>HRX=nO0M
zdPtlNK%71>!|wogd0;{v3_u_UKW^;)HU8M5S|PDjWgKW84+*Ui&IHN=Wj}pp!?s!c
zgJo34?=}FvM_G`GdY}5?%o(x;Lig6c`|(;_A$%>13rGR6^YDHz%taPl;FlpBh&G3V
z^^z7L^iZ`3%&wp)gXkJKWBWBDIAs)V72&9no?JvtK)Wqk>STO$Nik8vS6L!%W$QB>
zs&nVgSu}H!1|ObLxwyMn*=@*FicB__zIQy@O?)`DIKo<)(;Fk0AT(=5djr+>^r&rX
zr<O!m7maynaY<A`hbL3W(nw88-s(Av0f*TEweah67%vHVbHX6nFdg7F%3QE#0ZNm_
zD1o9D5E{Y;oiZbqfzU%Mvqpvh%LjHqT5@wqSbbkQo`tOYgVa^WbKrzHoftY~(YC**
zh2Xv$)T<vJI&{dYX@6fJ7eRzyFiQB~5HZwBZ8H_=n%1_qqF0Q$>h86zFb?m>5;^+X
z`!S)UF9{8fm!QH3jrSjG0a}pzSPKDeHb89zm_azzO9XoCp^9@P(t1I9(J*W-^!=I@
zd}=3}#5U#i7F81OFAFYN`po=F@ABoSY}tjydE6z${%KSGhWe9h-3sd7v3n;aQwDO$
zI&`1A@7`|c?}ecsxvkJ&Fi_etxIe5FH;>ZdW9=&JeV;B=FQ74jR-2FH=@}iUhTk7a
z%tKU`O)H7qcF)R{JN~pfGrD?qnIcAr5`N6r{UV66mQg=)I)cRE0;4U#;7m+z=xIof
zX<Slgt1r)ua0f$1I75`%rioUDrZkRkOtDtat8U(5Cw?;Lws|JcqIAUR^vQeLikJ0Q
z$@oz!?-y=#O(FHZ3NG&dgm`!X-=xz*2D-$$+>G8*8_u)V8ZHn4uaPKtdXq|*)K-R5
z(x=5i6f*3WKn=ZLLcy*r2cM+KfCgsIaE)+`$LA#2HhkDb%!S3}F`7Ur4e}`)Vg&If
zf*?}*ClM+e(MZ6k^!2pD80a+ww$mzfmxPn@iRNMDjIdxe59)PNkErj}ygw@x%BO^>
zgIAnVe@f^ft7V8PkTmHL-=g_yBlY0|>bphMhZ~{tbh!Rot7grVH;qnq1=82ET!xMC
zu^wqESx&>{DX)<YYuBcwZYwL_mh$3S_?Wi6qGEd*e2kl)kug7R?b?zEi}yJq5C31g
z7PcgMS*NCEp>+`^=C3@GN?r@x@EPz^CRv+cCxR9Ugbtjd48j-85cZ4R2$+21Qb^VO
z4AFk^vA-3SQ_ER>-b3_9w2-yw_$f++zOE{}7023ibMT?l=xa(;Sx&wI(;83;_<0%T
z8}_)KcGjT1=zRo9;G(@dK~u+J!Y^g)%ilO+1=MnpGp?Tc@#<9+1{t2vX1T}q8I`Nk
zp)J&Ab-YxmfMn`Y?=oW16{6F-pJPThb#m`VQPL}+HXV=!reD_c&@U#65|e}t|3Sjx
z!*~SjL{lQf`9LZTTFM|pvC<3ig81Ulcfgs|i@@PqAMpw}$If6~9a?jE^}^NtQ0qp-
zndH5NHY_{5Y|*lQX+r3DG>i6^B_S5(OweZN%K_TBCg{(pK|(GEJMieS8IRcvuzzST
zACU1e<G}nq9nr^9+H%UANcg^!Gwp&5YE2_qd1h#b*%I~8C)5}BP+^9+ifnhp;_$+P
zt@{<F83$Sqt?t#R!#bbYQqVu9JsD^GXTK_IaM+tFvLrH=Hp6DAC`=J~72O*j>u=fB
zsnMvWY=5}9u-`Q0C-#wv&r?4=@BsDGh5k82T-*8%MCD|9m-g;+Rc?NH_Uza9wx}c3
zxVFI7n=>;#aUGjFx>wgkno6dYg^!LQblNEpVzA!KL#<#fWB(hda1qP`cCN?((SR8*
zgaa{hf?qM<b4_Hzh2h*qazn7*0uc|340feLFXRZ-W(lMX6wE7i$2R5LJgqY`vIpzp
zWmb>YR+(Xfa@{E%8jnp;mTarZbA_CrC~_`GR@QV+S96Uey}Q0N(o^Y*h;WwQ+P<he
zcm4MJYR7CJmjL;0I?|S{UYqM4TyjrS&59{wqMP((wJou=M;c3(PACzgX6nay;*kJ|
z8wDB-VGW?W<ON7^^=r_ALUM779_rhSCf8CiwhO>Hb%bsMcf^Q<X*VfF;LNjp%;ZHX
z>R!|z8k5tUJcjsUG2C6ULsGl&q5d({diaOhrkz|^DcnrXfc#}pN^lJIX+iZa^m9~_
zkxzXEH~4Davg#$xaa1qy!?H0;QLVjk5r}9+Kn2Kb<+RKO+#mdHX}=ak3z0q<jh=h(
zBl8JqK-oYx19oj8rB19D!2vFitL}&P9TSpl71Iid=O*9S2q|1>AxyUP+Sc;1Pa@(#
zD2i0K3OBr2Q6Yc;Sx;th?6?p~NY%o$*$Or5wUFxNXZkz#FKm{h@4RQLOA*>GvwWsm
z_VgF4??-_zOb=QRVLs0rTZH`_!nH~<`{oT~P$LfQ<$z_+R-hFdV7^Jvq~P<Ao(n<y
zOo=)!T}%#_$AWYrj5QTz7{^Kjv4udTdDItiXgc-dF>|myG&CX@J(l>dBU@fK#sv;g
z+5xV^@aC4i?<E47mz_t#^Qe*d>pduMj=tXMYS2^f-*bwZpjV+*>TrY!?LKwSDMIP}
z_!Lb?sv(c@M39Goj)~a*&;g9TI2s?MLt07Am2nyV0B#e$GdC>~(yq_=DCx0y;AM~L
zAwpzxK<rjRMr)o^j9rS#{=8)H^qfqKVY}fIb*2uL>nS<bNY0&5I<YEQA=Cv|+9u6k
zl|Sd1rMbnaCk#k$$kS1iS<2PA8aLE3muo>%k}NK&%Iw=vRyr7CT9_=-@@p5(6UDgm
zY_%oe11aJyjV^F1Q~Gzdjad;Ny|7rI<&VevrV{pzl-@TfBl~7VzQ_1_=bpi23*>q5
zO~B&(k8L|ArpDF`<`FBKyr+2t><-D&KW;7`{}e)dL-D0(>ggOTw+k(<B3E}peNmQ9
zCY6S>Ugwl9J3GDm;DUOIY|?aMtIYDgY|;7uY~GK;E>9unN0={*+Hye9jW8HOZt+l<
z!m1WybOc?<j~sA71!*q_)&$3NU{(vl3Xl%w)HFJ=;Anvb)Fl3V<q%fDY^ysfAF>-m
zBXy76{9~v|@f7P9@Z#j@qT)4UJvE&*9&ExhSC{3=)435mp*c3m<hJV)a`JN$bmo%&
z{EAifo11^LZX$azKjOyXa0!vg3*&|JG8Jl>GOi*cu{GDiQ$$MIf_acu#b}67iTEOo
zqc}0TCesoViSqAKZIO=8Va+H10<t5VTd|6OHUE}*{{s(@f4TJ{Oh`Z%OjH_c47N8j
zani6!F+*o4F?{UGUvhTZ;FC-955zVsC@-Ji7`vZX-*J3#Y3btQ9p0J5`r<kDv9a}Y
zioG*2Uak%JgdAdZz$Y%wJq7p%M+)ZuT5{H{b^iYZb(V;D%6t7O*jxR8%NyC4iUvVe
zAwr-R0p~@mw<!x{CLeq1#s|bUawe*wPI|LR-7OpW4tkfyw{57B1>VGXY;gVn^*Sri
zYuiuGBJ%!&9u7drN@bA+oMt*#SV9KNZ?MHjF@X_TRnEeOZg*r&B##IZYUIh4PT7~_
zmy4cX2cZCbQ7=yv$~Jc%UUH)xnjiX!8c&GWe+4hxVY>nFYsO^YB1GwZ8>=E~jXZF6
zhL)=0Wncd3+z;y#c%lhVc8P9=4O<f0`6Cg;fp99AAAmVg&*A-Yfs;i9?So5*)((Zd
zn-9|8!5WYm`#BF@pAd-sy6|`Od-Pc0OL)`k*iTL+f^Lzlz0fpn8@~^2<7eOrT-kZQ
z*FjE&+unV+4cs@hkH4q)0*7~N%YNeMKGxn_Bm*1WKmH!S4iMbhLcGp-@Mh0GC{vI7
z2-rala`71on2FDKp4lllP8+BfHhM9BpO9(<{N6CLroVv|9d-!yeFRp*{XA{^FXy6`
zY}w)|ZF31xfmjwos%m%5x35^g$TIo9Zo96ubs%@mW3k50DRa~2J~lHM@yz)hDd{~$
z7RV--(waSHR~$IKUzu=laxyppaK%t7R-y=XSG!ek$+wlH+?&*rp<g~FyERo=y#Cc?
z<UO}0)-A4&j;>!^hd);=YKmLAk$eZn1`1Tx9?-AgGZw&0hvv{Dg2)tF<wc+2ahwio
z5B2@RzdyfcVv23dy;F298G@*-FlT0DSo*rZKgdMYXjJ_4!4tDPkIXM%vu8`>VQhOz
zdwl1j)F3PIAU&4{s6jfe20NNCaW#xuADbOUrjt?W0Y=^)aFaay=_OfxuDn!&p0tSM
zF@=f!DS0i465I4^herqE%<0(K>j}2F!T<&b<QEMV##N-DwbfJI!B$^z4%BZ4-eqF+
z8gL%=FC@spIQoV$X8PlE@G^6JezI76zyi%1QI7b&L(}>XO!By!rp=nx<i<>?GDR-Z
zhKw*JPxJKI)0;i5O;MTAGDu@6l8}9l=|#Cqy3^cUt13IzbQdHgq*o<(w2!c&tmy~F
z*3D_oawlZfrR7&kP4P;hS|$z>E5U?947~@mV-p)w5gfG&kzaZ&s|=?h(SlwEpSaX;
zT*V?iD~LKy9cRVgC?zt3)p^C`meQ=EguZbtkzB5+rMoYoD7(y3UXrU0ew$e8UHmpn
zB68(N3y;Ya5?5VTSXfq_O9BBU!svXL2-c7YXdL>MJ)V67<Ufc9^2bQS0^*4Q;T|Rj
z3jjVG@e2X;EgVLOi4ub@9^zwvR-;qTLrx=NyjU7S%Jb%oF*Y_=scILtB!wlvvTw^5
zhg;ep)6soD9&HlD)~-CaR9Dy5YEH<5c)GWuYvxr|E^M&x-BG`?EuL-WNflv9jcHmy
z1bx|pw(5q;O_yiRdG($;5YSkM#yx*xb6*O47YH~*??*WQuqxSy>6jCs+92qGWx&4?
zL45;soK;Cpq<)-la_PcRInKNzPaj{t5@NjXAwRrjAU_P07?pgPGAyMbS@|9I6`MxQ
z;6Q2!th*ec7v@pz%J2k8aekH&df~5H1$qOYRRwU4BZ!{!&IwgcZmznZ(IG^Ic!IPw
zTc#<}(o^Ma3(9oL)SPmA*8*)sabs8fi6^f=WXg$GU9YWnw}HRnt%(B%`V$F)KwP07
z^vkjk2NWwq_(q7eBqJNDtcyEpT_sRu{aIpzcgBlyXNd!Un9!bJC%yyl1B$>#@h#}U
zO?WKWe}b7C5N~cH5I_O}T=LuNO`B5Nw@>gq@}%C$5D2r!B-EwWy5a`%Sj3GZM7Si}
zG5OSz_upo-Ix&HWDr`@vn3Sst;Su{_Zv_s03w5d`U_Y*e9-&d@;74yQI3i-34ZV|S
z?IPF67*c7LlmH^8f8j9O!$^RB$?UKiyK_tldOjaAt7QoiB4grQVB?N2PL4L4r9y*7
z!nzb3S28|3xiY^nE;`*J;%Dq`uU%9h9n-j?x%EH}mm4flD~Ts<cAFhaBJ=rLc{nQb
z%t$VLWL)>di;IOytx^~wx2g)KRYaL%&DN5>?7E^@cXZJhm#d@Lp5PFGgB`B(nhbT$
z2SC4`1v0{K&>O$Q$1u6UqzDt6N2OX@?V`Gh1r7G-!qzdZh0#q7*{wOw2&*_n(>QT%
zR_C7nq?qFNuJ+=X{6u$7utY#C)s;kBn@b%r<rC7g+VkTr2D8K9%7&UZ#sOulL1eF;
zRh-(88EcM=Nw&HYTxLN;keJDBJoGu>#VS~L0&56NA(+Ns%>>Bm7<=L1>LW1VyQ%r)
z6EfjuH+nIuHzCE98Ch1G19eA=%OW!pQe6|Qm(W6L`6c3CnQ1Gf(on72W^-#prP7sY
znV6PzgB`kx{T}F=az@h<;5y+Wq=Zp8-$qG*kO=V&nofI&2AlvA=bFs!%+e8)g`!{r
zl3NrwI?b8mierNkPb_RbIIpO9)icwUotu{uJ^8t<_HMVqt_Ve^;u~k@=TE7$#gz3V
zQ4g|hp+ad;Y=J}0wNH3xL3LNj^2hu7pWRT?a`ek>r%~L8i@5AiNjObA_>gbs+%W9`
zmyO$L2ewa<=cq@oH$-C6Q6Z5tq@(jXsvvW2PGM~gqA7<eETtTjfhVYXn2*9CCD+Ej
z1)3%gEuCUwiA&|+s4$iXGJ?ZihjibxcAZt2IsL$;zt5ZZ_sa*SXTs;pf1fw^AD7_s
zn55p#r(PKtxO!@HZxa4|bztBX{F&G=7aktW%p8P==Q0m7jSO5py#+tJ<up8d^%V2@
z)KyFa>W97y6hVx50bJ0FfFQ#ffw9eJ52mBT>D3tVfaeIrLYgS(1sYf<VPd#H$i%{W
zJoV7bjV~`sDc<td`Xz5P)W5N0{o7lLQx;v>IOD<8BwmCd++fd$UcK}Fqm|3ui0@uj
zd34{-)iLRIL%1M<$95$b557oU-+7Yy{NjYB>guKm7m@7bP89UwU~%$Fu)4~nUW&R-
z-AGA7S16As1#zw;!b=-u@pujleaEc<z7I2OVrYg1lYaQ2xAn*vfMf&x*U%y_W1->J
z)c^AEmM<Tk5K8@k<qZ@bKJC%3*6;qR2AeFTafSWWRcrbR!iaY7fzYB!>ndEeg&8{9
zasQ2h866LQyT!W-G6~$b;j_c7w51}_7MVEyo{lR$_fJX+RYXDgMl3TELtg@qe~#9z
zfa4&-UccA@fSz)acK)Uh`Cv+z*~`;HKq9Y~T=!>VOvo!!h9<re6l-{o=tU%P3vrE|
zo}?}#b<@i-DhTAgNMv}2WM*g?a<zc2S4H;$+V<b<L*$zqq-VeV8-4wono3W`-;v?>
zI)$zwOvBqi9ETx7|8Q2~90dFc4M>9iH6&0KsNchk5z8}NdY}+f4C}z?G~i$j55SYe
zb83f06%?d0JJeUb>8w+KG1!Aw3(ScnZXF65Vj;D=B+)EbgJ<GdWnT025-JFC5eAn|
zZ^=`VUz*Y&?Es{XOEY<IMwn%2yDQhiN8Xjhd{8szx~Kt}8GTYXSeF<=40<<*B-RfW
zGV>J_3iB08TT%WecyZ`1{lkFGHs1mEdxqGcHKV{b#pS!BgzIRqMHPwOukgGQ-%<Sk
z75JP48u*Xn%M^5=@eX35e*iSil7RdzgS`()m4Kk*sRb;isX9$bu{si{JRt6G1ceQU
z)A-~)coH)Nnk$p>L|Q?FIofUc?jI-iW{h_wH>PNS9cI1u%-zDoT3Q^{$-4AK7nbW2
zqKx5oo4}gu%vl~^+?hh>AfpCd77*3eZ(FrZfaBfVRf+On1&)n-&?U>P?MbV-cTO>+
zd@yK5Dp7E-E~Uy5CYOL?HqMh)Mx6=nfiW8bln9^K*K-Q#{Z~44A7?5j1UMY9BB=F?
z2TuzT_yk8Q32B;!&p}*<+F_MX1{265g~(X)M(v8$ct_jv8daquzDilQvOV6}zN$`9
z<%p{!wl*I4$9hGJ+tZ}j`0=5p=7S$^R5W?qEsFL3IMDb}c<qwo6DAyATobN`N^ty|
zB@a*Ndw6jTUvGgNF<Wk4SR}GJ<88u)7jACbdh5bMq0Q;Ci5FbB0q{2fJr;8pfF3zI
zU=Y@k7PWCnMZ6R&7ZmIQVg<RChF2D^js+|?@bzz!ZeZ&4AhFo)r`@hQDL4D8aXV*^
zjZ4bfwQ-)KwxYbQBbnj~WjY-J&fBSRZf8n{+*O`%G3CJ-n|$<r>FYq>m#%*c)AyG*
zrHrjDP$%(Z4255F&;3UyZHav)cFQCn@N1%d1fDYsjzT%vi&u#?2920n7s_J?s<e=>
zS#R@{rCFdzDl-2z3xLu(s?khfpr>bGGy^~Z<=_*DU_XH04QTUz*LIC1O9(Ndty*K{
zPQiYPdSWb{h!b0>L2<{|f|a@{8K>>coq3=mIX7A-Ed%!)4uK|JL}557$(=T7oRS2}
zjC#EW2(*CZ3+MqjUV`%i>_Y5CjJF$Rtqje_nmgEb*oF>;aiB!b?Vn-GV(ew_6N{~7
z0|i^fkYu*cZ0hy!g_3*HCX~e-GwYg53~4cP_|Q;p%yg)s#*_kF(3|&FO}~8No;;o)
zWp8WC-c$iEW$mtmwdk=JC3R}Sr6NPqxG5=UH(Wh6{g0K#*6AA?(wnmELNQhqfM3pk
z*cFh+E&(p^QGkO*Zwn^a5SDTW8)b}F3>S5?t_2FX9dmvde`H>1$OGSgyPsFH`0&`N
zCz7h5_8g>($w_QmB8ED7bAn@Ys_mM1n?)={VVuD659Z7~*hPVFJJsH~Z(3$~I_;k!
zn>G1#YIBB`!;=d^S{=Fpa_c6T%Ru@>H(HAc)*^t;$nZ@U@mNNvA}mA^l1@B*L1PJ8
zQS!Hf6@gaG1@z~C5y2ZZwNR5yv%&k5MuuXk`%yRbrdSWn(sW}U@U33D56m}zs}JCt
zbU2B~#oCZg_Z5o!(wc)-6#uPod0>?0!XfI%Z@)z?pM4BHs%ssNU-bz6-VXx~L_cGG
z37SH-3;GT9d1{UD%Q)B~MjyKblJ2YaI>Id@<TkxLkSo{Q<YOrpx$uHIDyWsGiAu7d
z;J<N@*&U?`YYmE0Usx}7WmUPTO{@>7O$pUmE*bHyF2ND6QpGzGbdzo!){7}?yfPS3
zRp>MdQN~*+F=QuCXw0#Pq9>`+P<u{eqJNIKVj9*oysJm?_R+9n{^JK0vr2lx7*<LC
zatF*WsG|a*k~)St2w(;u3!9GD5oiUV!;;L@hHt+mc;K+~0ktuqI{Wtl4_3xoX~2yM
zVhTJ!sRnd>7<dHrJ|~cIY$;7!8K1M^b0^5KBg!F$?csEqaCg+vlR1up^T4n9s0ZS$
z0b9Vp#8ei6b1GDefouv^D0r#Ej(cO;6UJ?6wUtKb%^69Oq_k9daVO5niF1~w7CO3O
z3+J^Y=(D@BG`Y&?9J_4XWbjh#ZE1FwB!HJ<1TV?Cy7i5X%1B;$ATN-|&lP8y6;`oO
zp$}sP@DuYYZEEcKXIxsE2bGGT>aW=VJeJ{?;xMNr*qA>q$JLk_$(5O%s{G<nj)RV@
z5GqXE87vD^iW(J)Anr6JMAHC&g&d%P_rtl?5HJPS9{4M3F}(+JhVEm%%bEtdXe?>d
z5k-FX3RKQl?dx~AYid<_WwoLuDY;ouT~SsgZ%s{ZM^B_q+S{pUb|*C{I_{m6n$o|!
z1Aoz`7z3Kg=hX+7uXs=$laLUjKD>O{LC92?gd~$6UscbuIh{6M{i??&PkMA!9Utz;
z^6OVVM#EbSwCqg|3H;O^Fbj6;Z}U@z*fP<oK8EVkcKJ?1Sic3j5Wf!;=A~GWzy~3k
znbKY*KB>#XdKq(5M^ff)KQ~PQZYtI3ftzx0-R?wZYP#H2masl%UQ_SZmMG`=dwW~A
zWn^q?opA4XXH@H!2~G2(<3lC<FuBI8sA$DLs|C&4)7s_&Pf4t}wL)RmD8l$qN`#7v
zkIK#&;i!Bz7jsmeOd}ZPsR=fB^~UG==UiT223fh1%hq3>)BoJYYPW5+I2dd)_dQ%X
zt2(-<w6rL?dRFPf_ra}TCSPPO_;=q6>km3zwyyxwowGn|kzpE!xhatcX&O3?Eh^4l
z^vvApkK|{ENW`K@XTA$ZgBf$iq#9ziLhcygq+x_V*sCPJg%>VU%jj6IC5`sr&|oT(
zW}+xSfHpza<#gJP05uK3jp#=r{nROXebZR0h<|Yo!une1d?Jhn$+uJ*g2~T0qRGd8
zU8qWGajBK@CMj0Fs$CW-+95T$)G8;w<5a0#CaHHR(cnGK4pqfN0mI06xM!A1&G5|a
z*J$qj0F?(|_?+`Kz+l3ba*<zVhP_6Mlvtmlg|z9z<p;2ikd~@_Ph7%4i~?%L$0zv8
z!2aM+b_lyKP{lj^aXkiV6p-xQcS4hiq#@iX!F+BQdkQC%`U2uXZwD8q3t)B9^W~-I
zD<1ISzs(nh91ASu|1xV-Vw9D)d85iGy#C*(?k%O_-{E2e#u)%(=y7U4S{HCOKnh+s
zMu?uH;Tn}xCGoNADB{Tx$9yJ}%GoPSTC8zuVQ5i4Zs#DhGbi9Y(++5Of7Q-`If(Y}
zw^#Xtpxn0e*KThHWT2hYeqvI<9vmC!8L8~#uUV0}^IfPr8^woW75=)jd(MrnDT~MC
zYa^eIFQlywAj89SVzHEVfEl>64Jep2s)8=KW)YAFdM~RVbfzw>Lt}%N1zrqVU%^lw
zFl#0HOj0ynf~fBS*F=a>qdAwKK(YEa2}@@^IBCH%CGkOeg(NnsHLs;hMx8}n+Kl{4
zN5`)IB<#8$UzMAz2nmbdHJ93A8=E|Bg*v%9v9Q-sk=a{p&2)DOm7rnt#O>LmFv&tv
z2aiq~dwfw*xY{On*l!gR=c0|9Hy4k~P`X{1cVtonflD|KLuCguu`J+;0D?V^!1puY
z{$l#Rh4_}ak8ZzjBTnA+ehhKxuJ>b!?RUK&O<cX}eJgS7uJ_}JPwsj@ig@y__wB?>
zcfD_h3L8(rxGkvbuHRc&X5aVE-SvALiTnHQ_hZNxfA{-X^6B6GKAL>wcfYs(m-pky
zSAO^XDDu?res3rL{JY<qS)ugzHl&5Wuy5dOj{+9LuNe@>f^E$pPNEst*?+v@gd2b-
zbztu+0R4@UuA~R)hKDs5G>!H9+R?6`_!!JEEh5-y>q@HGJFBQ<)w#hLPc6%@ZA8t&
zeEVOi^{L&3R&&AF)Kth2q|fdo_hd+9?tz1odd{pUD}ey1@$b$+*CGrz#nz&(<c#k8
zNNZtNQX2T3({#21;7NgVD6T7?3lb9JbLtZrM857BVKSD0=-?4{a7V^XA}_ryQ@3Kq
zj1{`fwsa5ZNhHpiw6q$hM3GQ+ZpEVF6;Dr{`t*w8MJxLHa_1Z!H}2@1+`co$j0WfI
zdGlsF8#0WnQbTe{RCINw*_>G&9aWNS@ctBiW=ZFLlhe{B-`Bb1Omxh_!J18dsi}RN
zY6cHtdd!C0q2F*6pclq`H6Fafn_<rH;1yiIQ-#kEKFS;AzdT8N?rEEsQ#7yH>1>`?
zR5ZWEd0u8o)Myegk4w;K5-l>~fiR=)@tc1Pi&Q+tUV8iE&93LA^y5%e*i1hzWfj$|
zXm>i>SJc$40n^NwHFYT!4vEB3k&;vzD;CF=qA83M3aWz#U9P)5ScV@ggS|8pD#tzu
zG7nRY6z8%A`A#B0J_74ss=Y$~QHZqqL1s<TX_KNNBBGMCx+F;RafXnzo*Fy$RIB$(
z)~h;?RR(T*I`|tAVfA1-mqxB2nmN+~NOTP9;jEzL>?CplQA6K*D1h+YtAyvWIDPOO
z_*eMufmN2hoP9LFh)xsWX99nZ4ta@-@XT=%JXq<rz+VgU&@s=z-lLxxqMtcNg1-l&
zH-l%kvQN?N0A9i0hXSO&cB1ezFb`$aL9!C+H&}2EEcP&$VPzthOv(ex1!h55B$nMd
zHDsl+s$(Flar5}3n4HQ2Cr9>>kYmZI%8yezaxBReNoIazI8}pZPUpch2lE3n_o^l_
zN*3ENzoM+aG$A%lxAl-K&lTe?az`ddNrCZb$-iln@HE0iGt&xia`9dbq;A`*0|86_
zZ|+wnvUWs@ymROO-`~&VAy3=f5e%6J81nz$mQVU`C;@U6MV$dUOw(Qx>YEWP7W<Ds
z{}b;MRzM4>BSYC&Krf>Moe}nbrB%$h1|Tiy;;g|~iUjQdD7?V2NpuGpzEfgGk3?xB
zBhBX6EQ`Qw4iT`k+arP<?9dQd_m-5gxbW}Tl;o~LE2g-`i`o+t+ZPr4{<1b2WHQa<
zv!HE~o72PD;UUW<y+Q1CXai-i6?Z2kk1LLjE*_Vh1a<6*v5D;q3JMmqx!rB}Z#!0R
z0DjIS>WKNIA%H+7WCvWIB09+TNFH352H@*?L<jq2`nrt%ejIY5k68VHgE<gm@HpMZ
zQn=@(@8yCo1#=IcBdu`H=z9*HN3|o*lLhp5%=0A5MJ>bc{fs^!Cqw_0Jly{l6aYDi
zy5YKlhUd=fe)KgfmYfRTx3N0_k2k@JoCEw|W3M=uK;#nrik6+x9o19+xf36WG&G6Y
z;l0e({2J|`UEpzK4UKm&ark7-9FUo_4ekEG+`{yNM=RYix$vN0Fs_g43nlxhMY1w~
zR-67IW#-fxhtiR2v6p5f$XIJI{TvO!&6^sxRpzLlRgl#)c2d!EHypLq^-fGA1WE(g
zZ()wAhWO~;oB^1FDsCxU=fm~q^mR24Uq3b^Bg#1q@O=$^ojW8$AJEseeEfY5e4jvH
z*9GD0Lby(*uj}#iLm$G%4*_|D1YKDlMgw@Jb!a`OnEelEvol};$SV+Q!rlck0M?Me
zNd%&a=mLu);)e`J7(l#ZB4c~-i!5B00Ih-wC+z%L4e=gO4zz6R^~5*K%BR>i2U^v>
ztvjLX)b*V^e>&Bb(7mnwgSDnO^nHlCWl2N(rY@(mYg2o}k`{Le#g8+sT^})a^|6k*
zZ|!Ss-S^hqj$^CGM$oWg`6LVACs;FYVAvbsIu~FiShGMC32O`E!#TW2+V>kmK5(5&
z2>*Z+48(`fK5!n9-y7Lrh9wpm;aHN27>|Fw2p;5;WE6GXg#yt(MBMnq?u1QdU0~>Y
z<<kTjNf0}g`Z+Zy%Q8?l-K-A`d*1bqi0g1qP3NXsrk0_=^2wH1ZaO)J`U<_&Yc^3|
z**z81gm9Hf0?C{&LJ^qVc6TKb!&fNB8bkG?o$)5>0<#W9LwZ&Q`1TU0pUsTTK;B?|
z3D*<<j<3Prg*6tB6-|N{5VrWSbud<}@df<={sHk4pRC{q1j*Zz2#{?MGjRcBQ5UXL
zFQ82LA4a8pV6=x^ml;EXwX&asV+<b=bJsPm#d(9*Hm@V?Iu#Y+YKV?$aH7v-&^z>r
z=XV+O2^L}W>sU1&5kLi?JnA{>hesbJm)#kwhW8r0zmr}sF}V4G-3Z1I1MRVZ0%@R4
z9TQRoOLlumm5wEI5lfN4LfO%~{QI`<B@32^)~&xdf3J7@cC;I@kW{dQ*#Eb`p}y(;
zBf(T_(f#kdjNz^v`hndJI1h4&h_(gXW?KT2I^O0Su|$Pr%x7$7!ZHFr_|n@3;)Y!2
z1c)W@7%MNxCm;K8ZQkN(V~m+HtxOc3KPLPBYgVG&r1SoXK!n(&r7{gK?yer68>i%{
z!t0Ga3pSUpd1qg@_}P<)I7RNC_u~3eMSOw1KrYi5H3#>V$t+-$4UGsXm02Es$Y3*s
z@`~NH$?D22e^|6OBq9{Pg!zXWTQGk*)<oa_Hga9e{)RY};r*S7jP#zzp7*f7J<R^5
zH#zCT`<su5WhdeuMt|T3IuaXW=i`0+O4?L`MjXVpov{UGo2O-W!_Dy1ahJkjb9cuC
zrdXzBJnk7V$8w^G{coc+6U?T!@y`Af@9f8(hkY%F%eQ+irpp#P^%;tYH(dmH$$;@g
zYVs<(5_qg204$ue#ubb*B&Mq{wHh{-N&z!*mNlPx0D@O(lP1891KfNTKnqdXR3b6C
zG#$1i125mR##&vP?NBE7Zfg>55cVEVOAIq8!p#ZbC6hM0BPFhDd$(}Cuzo{)Qb>e|
zud}&L4+odK6&8&whzQ{*BJJ`xx5yHrFve!qCKfH}%H+QBc35>rtwbW#Xai9UKe}XU
zecH^9OzvBM4$E=02_(V@IhS682}AMZyQ~8N96AD+E_Mzfwj@1@yFm`V_ZS(8xWWGB
zYV;RlbyIt6__pxc&3&oqvri2Qwh1a1#Ha97l5nLyO6_!H$3}|8icnG^I<R8yZgpf-
zl1aq6_)=KKqKEp%om^2J`1(6xdG;D1pC^`Zy_;B&)-H?(dpr*&{3htRA%~1;B+k>X
z_XTeq9Op@Ibohmjnm{n1P!R-O=0!!N#f`gf^6JN&MPX{8P$5%9I*lFOXoXcnU5v8Y
zYGcs9Zq=q2ZX%S1`0l#Bvx}C_N($zSRC<+Ya9U4Wgta=m&lVDLX=i9n**1U$yeC+J
zuun(R2_~@=P!04~bcAX_5!7ebA9(}<rVdd*pFOnV+_@E`?FzgLk{I}|FUD<vuRH_c
z9l@)24hj=L8iVn$$RPl=X!GXHR!wnS_kEMsJmxG8#iNQ)7-3Z7P!F{i^+2fW-^mJF
zUCbpKXwT#>dxTYU=g@QmU9l0?*|j0y7=rh60*uQF<H9v@jX+qiU@$5O6zCR^;E_Ng
z^nGHb2U5X5iOSeIPmQOS*f&S~{_DM8_w}K=DTgMfa%U2p@W>R~ZlsP$Ht?uV_8p~;
z68l!7B3sS;YTPHo)9(HMj`Lr<7WW$ZNEqmF_r$HoIR6(P&RbrK3Cyxg%bteW+zWAU
zVWu}NCJ-1}>TBtf%yHc4{{x%{8eai8e+F=#U>*Jp^Q~sUmn(oT1nbE6___n;Pzviy
zu#PJ6HJtSz=gCCiYg6p_8oVr7T71nqCd1eM{XnoDqGf<y_`a3?{y43#tA>08U95TV
zejnDQ!uwt1r=WX;B||=rNc+8gO6|G=6>fX4pg!~wwG1tK3N50RF>^c@C6UjQS+K%@
z<Nj!gxn#kuXYhaY?O7u5DZCbIQ3&}6Ii2x^qgP+X=tZ$=1_I+~{S7`Rc<yqa_=h$*
zR?pFxW@pBCceYry$#Hsaq<L<hv%3Rd{pNS1j3<(C?{h?}j4Ga37PQOlP#e_L!+anB
zx8IFa<MBX#n}9Lo^DJD2J^*2dF|N@ACGK(XmB$5PZ^W^3G>*!ed}i|7$XP)xK_84i
zIsRE<&7QM=`ODcoPrdTWQ_#lxfEDB%@;W__;OQlmu_Y)GNr(_>yfV>_2D~ETYoZIP
zR)or)dmpVHht@!e4wxedgCJM4(qJxmpoNCc!DHV4@?PRAuNW<figTLLB(IqG>g-wK
zydXF<{LuTTuN(Eg2k)PT_wT3Q=lkA=et~m9_5xGlY2s_#uUCX7iR}?!Gu;6#yxmRh
zdjC)$j}sDp_&s|37XbE00CsRrhZ<}2+rVK=iR2^rO&PWx%cvd1lyTJD_n(6ya0MaH
z{1y5Jlp{ZfT5}}eHv_w0sDdq2P42!mf!yuiMrY5GkX7+Tl=>7ZfWqF)yrYlE=ZRhL
zKD~?R9YpMctpoEpJK!Ct2EPl=GXW+hF67)B-t}a`J17VqfcoqK^U3$gFY$bX2fZZ-
zd4iBE2$4<HW$My$ltI0@6vd&K71Wz3eIZJtE-nMrRqQgjj9EgxNnHle0sa>9GnN`Y
z$*^4s@8mm`9Jtt^Uu4G`{c3X8tv=+DS=>6U8!I*3TAkY>yYm`GfgaW{Uubl2j*(g2
z-eto#60K6H6(2<D2moRR@iD*vCkPNmTqar`@yRIIkHjyccz!LSa9vP&7DN;@t5i^e
z!g*|iNhXL>NH{^A`f8b$BPo$`qLt-(lS0Y~Y7}(R56IY2ib{Q{zFetg$<UGU|0-50
z#_P@QOE&d_ReIGWtvP8t+*+g5yzqifu^Q&OCZK~TA$sV&?az1!*>H)Hvm2gxV#8Tv
zynK1-3okHh+JlU6`lI84@O<{5H>p_kAZTh}tUUpj2oC`V+tGA`c>+I`y98w{!E0MQ
z)Qec46P5)8$iTM^=mYk)9`;k?c0iSG8QWxwx8c%t0)tb(2&x826gn~6WimPhAZ97k
zGEyRNTSZU{j|*+VKJnlturoGHWRcru^?0l{cVko{7_<`c;TF?cBA<}se&K{eFFP<O
zoLn8s#(-;sQ}(T{Bq=)29`UeNBeRN5wCcjpHJwfCE{>*7qbi+27*1^=1V$KZWk55`
zSq=0HPC|^XgjNhoWfth)!nJr{WDqtf!yU;yGA;ndm7y}V)v8untryE|@pfxPeVJ5L
z(O3@18*8m-tdNQ;QFxSEWwWW&QIErSWevXPN`phh6^&(44tNgcnhZ!Bx|bM37J}Tx
zr}JGi*85>ml6C{+BkUJNOOy2E%KRbBFjJ#4oIpZ}Zd+`WE>dk2ac%l;V{W3}nAe@f
zmWwk(+++0#d|9v*CSPdGck3hb$1z_x3+2(ld>%hiwSp5BsnUj^JTgou3soCKH6hBF
ztXNl5o|R1GD|$m?wN>H}zL0YwSmh{6jIPeI#Pb#7Lt`Sc!a}6Mcwga|l|3+@OJO`9
zv4MFF`ybpM$~l~(#V-egK@$s;GF0jCMCnn4ZLEt!L;%dur5>#zcWf3H!Bwa^Qx(JI
z@%U<qTBMYSLq(xzTTphUCzI!JSlEdI#kioDyw)U7M^Ox!!&giXid3Y9fDM-VmJACE
z;={fHdoVGP_!|48iCljDh+h_`B}tqqR1D%4WE970bDx}+TmUwQOnYIHjh`1H3g$`W
zx`?Rg*IrX8J*v-x#YzFC)oTjSj$TJoj#X@OY3-aqfk==T(>o<2Ihq?-9Hx+jO=O!4
zlkprut|5S91<(?F#>GA2|4e>T5VEjXJyIhT$CN&{aO1{}53gIdZowOyBQ)GPb{HFM
z(KQ^cY#Yj}OsE_jgkR`@RQ#bZTCT7OKMYqe{ggpJ<DnlcuhN|icZB8D+PB_Xv*vtp
zF?xfj+_9>sV%f3^Lb4OX2O4H#0OkoO-S5oPujUFTio+spYN0;6Bhy~w!P6xS;Ynb+
zY|(#&e<Ks7%PcG`M3+5x&X@;=5;8JpLAj}wAe{o9WB^PXU@UCFR1gPn#EMap=)y`&
zu*AY|P-WuY@u9?pGU8JLckK>L0){-88M<m=<k7^$*Oo00%0Qh_uC^17$U_qbK1I(}
z{$+YEjMp}FgP05B1;0S%9PO9H!8QeQ1x7xO7?QWppQIy4Xxes+kI?i1+Ex^rST;7b
zcu<=W6vhM6r&o+qe=nE(0llh_?1<>r7$bzdzz|NUVSZ6gPf<*8KK4QQD80MTlIF+{
z3<5uoIcA<JFf1^_#8WN`7lpI91*xglqMr1M2)N6vY4p$>q$jJe3?u^7l0rgIn&{%x
zpTLn`h&J>2yz-KqoRV@LpAWuK<GNn1RcQj_2LHWk<xkUMgH@{f7h%jX(2l{^PJ-ED
z1~(~e_=2+Ou{hn(#uzg{oL^p)lT%a<AIvdm+}IcERjT0FX+N!8_3y#BK#i*QWsqYn
zU>BKz?IJ8-EIzwP4f#)^g#9_(gY&ZQUJvUi;bB|h-lb9Z3gO;LxQE&N3R(^>A-+Ux
zRx;cJD1G+|$wiR+2;X~YXvlZZ2{xL3+D3C^_+2T$GC<pCjt8)P&*i{##q_-s!|!In
zy$<>wMDqHcD~ESm=zEV0+jnx|ImR}0a=4Ftc&?J}_tX&Od$*eWfGA_X1MpoLwihLk
z8ls)^D%`vJ|1kF+fK^sW-}pUGxi_TW+$1+WxoJ0zRMG>akWfM(^p5l<3IYn)MU<if
zVnu8yqI6j_AS*0jT~`;|x~^?kS9jI5qAn`A&;5RL&hy-s1n~QR@BjPueKE;A=ggTi
zr_7u=Gjlxcj+c|AR<jD&E1q_%fRFb>`IDzy9AK-77Ufk>yDflC<FMD<zv}JQ0Je~5
zQU2_yOZaZ)<xY9ZWg}7b<-FYM?oPdKAz~IX&2OXb8=n3mJ0MHrus1z@bGlQY_sA%R
z@pZ$Rg)twZ-NaP)TYzDVbl4zw9J6rPi=J|qq3$?ViE=NQqV#ej+{>k*Y%yTql@9Bp
z9hRm*Z{fVsVdD|Q-O3&U47}1|Rlv7E3IPnf(qVCct>*NBS30a2u!}hCHTN$%tOl@!
zye@d<gYRZu4!qJ~+3q;$a$XL+(qVbhNol!?dq40%#=RWzV5IE89CreSzjfGb`7^0f
znFAQ+xCeF<V9x=DIj+M7OSwq)zZ|d^JTRoXU}g@(9M{WDL%S`?`zZGkBCJKbrP2{;
z0qzQAhIy~UT2Zc!=)?V^QMVsplX$r&OsZb459$u%u$^vAhvAzvnb+Or{!xcDqTFB(
z!<x}y{Q;ZGVS7C7wxI4P4%_SQ)XO!Y+yveR){G7tgmNP}Y`>=;?Q){jsz#%4u#V{E
z%B9KDRC6!D{^+SYR+<D_ngDynLrXRAT}=3tKY7Z<0k)cGp*5r98wS`s4tvcc>98um
zIRCI_=&qK=vM*q_@N%a-Z8)W8r7L(FuY1bnN;NFi9ECRC@bIq)uq+OH(=#`4hbyPz
zelA^EMzV|5u=}JXkYVla(dv8ZyU<%p$YzTtm3i=kg-nA92>nK2Jx?@f9J9-<&T<6m
z#FWYXkS7Qh#!B*%4aUh+x_Zow(;Bj^vCclJp|w++GF#T4TE~v>D=Y7nW{oag(r?=J
z!_sE0n8l=h>rt{kCsLHWsF9acU#&j$!H?g5FlNm1i38F@E0^7}XYqYF1}B~#>*}NJ
z!fr3W6CGPParIbMQ21WxkDX_y);#_GkKepEcI?WD&FP_4%WmCs>3!Otw9ihD#d$d1
z{i^C#e+N4*<*{<Wrk@KB&k|EPG_Jm;2Hj)9dqSfaI|=tt8Cl3zqT(Nmv6S1OYRmY?
zGMr^9^zAJCW95}GGIVYm{>l0cH!*_j5-fW7y2JD49$wp?**JOe_097RuN%$|-V(Bn
z-L`V%t?Z7Ldq=SRL(5toZJ)7n)_U!qw+26~EnPA4R&8PPy(6^0bnq`%&RVZj%~&;L
z@TzH5Rnt}t9<pjimGm4?wYLL#^Yx1-H)gi4JtU9oSlayP@EI#+t<^rgCHNt2>GBb`
zXqUF!+pfJMzO0<NmL;zbevsXYFYJzHeCa>r#u-&rGj1G0NYMz%?=TOqY?uX!h=|F+
zjeb7-WXhmz)j|V--6-&EYb%p8kQ2?BWmlcZA61UGyen-Mxf1EC%kb<opjmcgl8V9G
zUVz#x((shBW~XxiyfOL=a5|gIQdZoOFrLj{skz!DwMCoQTZ+-L**z`V(%!pQzBBZa
zTN5T|cduYlo9k>d+fm^93fcMQw?GHjbLBg2((}#%Wy#59z%-yNC8cbD%qur*OA7X^
z_-pIJTN1`;_blg?Ti6o?t}og9+Pr4Ap<vI-cUmu5pD>QiU#@9wlDS!%P(VD8OugmX
z<Vy36&|y;1+b;eobdD1)dU9peoQ>nhZJJY6HD}Yf@$g_cF=y)3xpSvZoudW~Uq83D
zcJBJ&!*7|xf6iIDbk5wROWp3X-zi%ZE8^y5so?CR)Fi>wV~W+1DqxJ?`ylVey;8j*
za@J$%LE$(2`6xIXdL6}BNcA_R54&b!MqO$zIUy^nG&St@+t1v@HfY0}u9#5PEBGcH
zi5wL<?7)8Zf(FeQ{lm#e>aYGu?_a=OETtSbaI?C!>b&^)yy`S$&`C(huleMrGlX5)
z9G_PO7=5d8q*dj`cXnz^*ao8sNW@OGaTD&Ca9*Z-9Kt*cYHvEKeSh>Qi#RH6axIoN
z-7j6~x*0{tsxR5mS5e+Wfn>kxyQ}d3><?N4`@?$nj5d%M#!Tb1%cb7f!*EvVJ|}6J
zRqCy~fJTc1_7%AwoH_J^@ZOw>H28y>hr=iA3&JOvnze`3BHWQhlI4^8Lx#icmYh})
z&(607UFqhdFZMxx5)zikz7&^9+lDx{;o?El6Cfv73@dJ1Se!p;!;JDVC5b`FQQ?_s
zt*wFXoVI@3E*^dB>`FZ+vTq*b`daCiahvDY+F~vS)e|o|d$+IW=fH^r$9wZ4^S(4{
z4=W$TC&~9M0eXs^=tHUjA3Ev!9d~ddvXxSJdR$NKa)kb#fV{l~kHTKolGbN_*~N#E
zg8Vw9Am>j9xNb5R44PS2r$04dbjf&8pmRiwt$ON;dSnwpLh?29pIOHfl2<v0FKx}D
zgya*28!R8sfuNak&LZKA9*YZ0jbTT?nMuEq5=#%qU;YaX582gx=r&wt%cU*7$LEaN
zvaES(TW)oxwS4~8xmWBGLB*NK<UC>0yy;7qE}9u%)ZDvfSY@6)C1Rk_0mDrfr=+~$
z%UVZY;joq0_D`*z+g8|8eG!i<ZtPPzU|UPSG+5y9)RxhcS)#)<KZhe{Fum7<6{qUc
z0+Dzka2^bSoD{@!xk;%6lQAsWP7!7z&AjyY>xN~wOs{i}a9*3A$*#^FT;<3gGP}BZ
zc5A+)a!3xlDl`9DJm^ht01jLGY{=kicTQ`%a`vz|vt@-NSNl=zGh%-2fLRS`X$`Xm
z)XpE#M`fY8jujSj+_2eKHci`k?O@D##4pLmL1QpK>4TFZ(<KP;y!1n<+33^-TL^o(
zxH&(1{N!oU_;>0Oc88=S)qTT;ExLbZ;ewg=oJh$LmtXB@9HRZz_4nQ^J33NZr$|L3
z7dOnjKRYY~Cw{WM{3y?r$@kp}7IoQIh1@h4BhPKRbVF<Ft(P=5UUF+|>xN64I^&#W
zNr|Q8Twj`)ROXCh->*7;ZC?bAu3B~cn!bInIlgN8^7@#V`sLH{Gd8w<ImRK0_7(YK
zvWn9!5#|(TQXx#bOtSwdNdv<(v(tm?S&95{XR6eeSee`y8p0yN+ZkL#h~{?pPdHqB
zf_(`z^EbWp?ccEMdAeadgv9og)i;)u^{*?6E{w~aG_<5-;`PHuTtB|BqW2^A!3FP~
zJ>J;AaX@R|x+b<KI3#`0lHmidn^9ef95C&h2eTk&wzeC(*m(C(k_)_oM5a09>k}Gl
zGvp7(%O+-wvGtHOkX8hZ8Z5_oiD7-q`t+@+E$&lVT2fMaM^2?9ykz{<L))&IP!gVA
zk$YLus3nb!i$@l9*wXUjD(mVhOPZytDhmtx_v>9)sr|)TRMV8zym)wi{_w@kSxq%X
z)_!-^&KZ)IH)Kxj9W>9!U=CS9Cq!o!O=1TvTf9WY!-nalHl%-p$%yEoJ7-uarK8T?
zt^v0ApVHt5SyG%_6&%v1cvVQ_^c4-1PRm(0Bx7^#aL4C`nRkzjt3dLQ%zm}CY55hI
z1*!2tX>ChdvkKc6_A8$}s?GUGI4%qr{B3@cKExR1(X4_o#NsjW5?hQbZX=f2;<P!W
z!wtjs#$-DOEoyc4nYwCN*@U+G#GzrSR(pD8VP<J#MN?(bJtNqc@{01RTP+2{E^TaE
zJ*^_vS(?1S8WEci+fZ9RAih9?V*s_^hW5V#4{BiZFgi<1#&G_0R#s4yFzr>umhxB;
zR85cBIcJB|O<dA2_|hR+g9Z$1%^!W$h(Q;RsEJ*a-#6S6lkAL-&q)ZMFnh{~qT-ag
z2upBeQk-;*ctH7-reBhfFnesnWuuGJ2h46NvPLFFq$OITQgh?_7am~MwfQBPxuLcY
zS;0IWfyw-D&=?}P1S^qF1m<xiEXjuCG6stFDppsOUsPS)yP$fyIYfmadFs&OqVd<Z
zx2_mjU`@$SSQR@c|CF?|uC}4NrmnBH&JvFFGA)-3ZN6%1W$A>ghLlg9Fs|^^>`Yom
zg_tKr7$en$s135hSIQ1<uYzR}j!jsPWmfiutiC3N#KjJKMSCDRTa9O1zhrBlNomT`
zPOPydz4>Oc{d#G#3kOT?6C-^Dd{Ov=HYkWS5RATXFDdCGTQK}2YD*8YOl!7X+ZyYT
zKe@Q1I>t58Q6k-%Q5~NiL&*o2`xEU-Q;K;AR-B1^6;tZ!%tL;L0hYe?!?zbLb7=3d
z;S_-F1NuMI{!06(rS0SEMvYjuY{b%K?dC_8wU7I`*>Y%9`?6*2OP972eOo2mr%5;i
zqAu<)wju|ECh<5V_zcJ!*(|e}Y-BKMVU1vSO_9h_CgG4(5FcU9v_)jcpi@D?!&)aK
zr5CHO2IVK$ESobb&KwzKH5c{W^7wAt*y3ymT+)-km9BC-q}qoK1?`e)78@fikmsU(
z3n)NhS1bO_lFY7O=^y+0iY=G32QI(&3c_)pvP8PpjI1LP#>T{0j512fQcv;7SqzkS
zf_T>zD~L_X&Xz;MGD}jz8tO7DvTdn-r}kG?!~7oP$dIi`+0kVU@%eR`MeWsT9OoF|
ze3QHinVBXVaN()~IxQZaqyFQLGra%QzNxK)>KejQN;1u%s+yIV6swG7S^Y;B4I0*1
z7M-1BWohX_<|r(C;A~K)z+Uh?Z22Z8e8^Zs^_Gmd(51>0Hn$*C<GLL){Skk@qnDGj
zaV246gO-NIWo)U&2YY6Lwgu=gW+RpD(i`eFoO}39OPRj4ld6%S@2c!<O8VWY6|KE9
z`&AT0Cp)&JR<#yn_OB>Zhdc7CCN*SGQk^{fl8Ikv9Bu(GPjOy4Fb+L&ll<Q@Y>#xy
zQ+66XTC$<K2i~&F(9v(%bhNb`Z5=sZTUi;L1sm*%&TKg}G_xc%tP$gvWlKTo9I0UA
zWnj#`J+u|cteN^5X))UR*8CObNCmjnQ@^_5AZ<K7%pUe!cbrA=e-GqHn>oi*y&QKy
z1W2Z}${6X7e6FQ|wjO31qScA#>;{^2Lk86~hNWWCg{VqaR-&DS(JTVbyPbTjAI&W`
zm)cs4wule$uqO1_maPXqbU))i?uiTC5+hyI4HE=i9p~eLD&_*4-`&DvZ5#L^>7EC<
zv~b`u^qDeKF5_z}f%bTP9R@nVcL}YGtiG3KHM`3vPEiC?zKGbyq{I@^@=8d{i&bW_
z=`_W62E<ba##hoB?n;kX@8_jwC7<?Hn3#dVo!!xcRiHg|LG+kJ%;{IyQ;N9l1hd~~
zU$GebimcBNLwgHkm?S4>`0hLGUSs2V$R`%GhX7UceGb}^G7@}Ninio@?ED{*1E$%^
zG3oc}WJ4~_=ApBbALRS*3}u~k3^oI(Rop|o%s3+v$JnN^O9!Ux4M{F_LJbSqn=){j
zvaa{Ac{M4;j;JU{aZ1g+VR%{#RZU}Ii&*CVy$MpnPVt!fZ7K5Gj6Ix|pBR(gJ8snQ
z=2e9mX|ZWY%M2BkVIJ4WwP+ji$%ezFt`0eHUnex8jHmG|uhR}@r?8(J>GT1MWwLVL
zG^?Y;ky+-5m~KrMzi=AdnsO8H?S&N$eL>c)a-{1biI)NMpk&J#Fkr~!Wv%tI$F;SO
zue|ey{n6<Ksy#L>J1zFkSVy)a_MY2um<szJlAHen^4*k%T##GTLtLkkRZEuav}IMQ
z{GT0v%TIsI7F?;__0K>5OWVAXE&5p7d?j1-$*Ip^_LEDrXMQ>Ot9EEDYwJAdVgu<v
zgVt(K{c@0a83g@4K4`PK5%<Iy*kuPIzU*Se_idyT2L>mDJ63QBZ43CDXO8pv&QG&G
zfB%2|t}JYt-Q?Kotg3SEO>dgj<oA~=50G@vNAu<Qn!Y!usw#W0qiNQ!Z+QPiRpkfo
zpZI!qv-i)gU*ocyrdIVSE9+A=wJF=2mpuS~;eS<A2V{5t$M>7>?^=KQtE^9-GOFeK
zyS&P`obT`8eVMi}XuA1c_=(qo@0Xi4!&B_frmr!pW1+Yr#u(=u_^HvE8aK0075m9{
zR$+(5CIz`Zg!7BOw>fRuq)fsSypsRIwLYqgxk3jd7K1AIB{o_|ha_K=k_srf<BoBz
zh0h-kf~514&nb(xPCV&H`Ep=4a`In@9<E)>7G_4;LrUcyu+!Qt3*-nDnGNzw%j2SL
zEH);pcX3fnoJ~!NO&vG?@_s*m6K+GQnh<2TPGW5}3B4UQSU*z>rcIxmeMT||p>9Ne
zNqJn3k{eZ6TofG_ZKj&@uIRfXG%`rVo3y>G5qWd-GIQfAD#~J0N*$pVsXQ_`C^#uO
z-dsJ<mJYwdKIztkveuH9gDoMJ;AFsS1|ok^az<IYHL<L<SaOC&1gS`Nf^5wZx%2X(
zqF8iH9HC1sO$)WKLE+H`i7}a_$p(%2(?O&1ODr5RI2F;wrNuE+H#)xDAjS2nl?977
ziIyU?=^$E)U6s@(uNav-mpAECP5l!?*KMAzXU)phSvK$TzCV8(7Goin<$+~GYvRGO
zIIt{#`n1W}LA`<^LVP|Z6!?7n`4xYxG!)TZywc+yT9b<$HljAYkD!)xu}8HtYPH$H
z?<=@YDxP2}V!aq%-JyswoHSzaUJ<4DPX!d`a_-84J1mEEZAg%<ck&zdii8Q$P-*b^
zgo?OR$%VF{kjSi<H|&)O<6Td=4oyfXk9$2PD-w@h3_5#Q-ZgkrV_aGC+i}4OW29DB
z$C!i=`&&t6_J&P^T<_VOv2VxqN*LqnkOq%Q2#$L*CMQZuf0D}w(|@GTrG?5vbQ&hl
zRWbu&s@HNS2ONt2lUJV~8*UA+YglQv6kc@uOnG!vT8=$3KEV;!yCk|QwPoeRGME<e
zUX4Tfj_0Ni$5}X@e29z;X0kOSUP1_$aM>ysh9V0kk(4Yk+!l$9bnx`9Wzvs>XVxVo
z_nXoD;Jx=gxM1PDORqj~S$RtTX-zD*35hZ(L%nt}yNiCl$ujHO3kqBNBr|P1dqNwp
zDB4u^h&DZB)<tut1-)*rnYng!*_08D_9pkF`xZA!+w9K2t2=Iq%SOlfd0Ub!(_wRj
zkF1lY`f)fbCFw-lc<s$PHg9a3`Qa0-<InsY)I4^mi6MU@&gY^$JtB%@IPTgUDRtVL
z<J(T0XdBDsX;%gXjc+}1V(3^CB3f2z_p&DtdnF=KaYnX#>|u0&QYZy_VxI5sl|I2|
zX#v4#7xecVsUn(}$NK`A)b1OehH$m6fDr*zFt__655l#`gP`XFjp`?5mX#_g63@UX
z;l?r(dPQJf(7vtfkN<~-Z{Ezp|8rt}YwP+G|Itow-mIPe&++xGiw0b^=greMt~&kZ
zo~xS%T)Fqn)2nX8?^g|wZbkVoMfopz`5&k}#}#%5%Iv*rz<{ezp4X+{fd|9sLnF@5
zfwWPcRw+}N(k(55PV*j6*ri3Ho~WU913xQ09|Vmrzl-#@8VBy~au0N<pP$#dyx|;_
zN;?dTvtfbOEzV?lCJVIu*g3l*dHNAf_Bgm4r%3Q{f;%Fv^m?LMsnbr?2d8Ieh7Xja
zAD=h}dCJ||ckSU3EF`osxiZmpQ2tnoy+C>j`280gRUvhat89xsmJ4oSu%Q&3+|HYw
z(c>t8;~1X1Ib%qjlO9KCSTVgZWL0sWkl?E1;u1u@r~MRflb-GE)P6WeAJ_vC;g2}m
zMolj7x3Il1t940RT2OpyL1smMT5WB=OoY-`#ErZ=vrvsVXU|A37;~nEzhH%Y+oXkX
z4_;@CZiFH`aUmY;^H^ySRp9A<Pu-Mv#U(`sTO#UGii<`}nLQyqAtyfGnH*yY@0-6U
zwr0e|gGO96I=^+;fI(S9E*;#kWMW+it2jrO@z9(cVhhd9EXl8}W(NxU$K|F*SrgMD
zk|M1|O|u827mvQIVeIULgiEHEOc~Ofcp_Jyv-jThLUvd3c(u{s!O%$-w=%eHP--%~
zuhhdbkq^D5%CCH>&5l>IquI<?hQ-Ed_n)H&xL)j^)s*s#G|{#FdVBJlZzkE+D2vWX
zqR;r`@yx;wD1l;hXuF2-%{waerv<L+upsq7uzG_QJK~<A%BG6OQdsiS?bg(=p^5cv
z6Uv6In%c+Nx@eFyJ7({&2JORh^g_AE^`C<H0p+y~F!e`R7vRVlTQO~QTjQm}3M{u)
zl}p#1yGOqJ6x|!qK4m0Vg{@jfkRZ}!lkc(j4v;{$9y+CruBhu@R?=9XdiK47!S+Xb
z<DIALM-01uVoAx+Nx5-_(bjWxhF#uN*SB>5?wr_bY)rOO`+4x@_Te{AudJSN-N4~X
z2Bn7t%eS1bKi)MI#jQMaP3(Z`j%5UkHHEYFG$3*xM=YCd&$enG94xJkWbwf^?Y?u6
ztK73ICOy77!?mo$A?=8%F1c8WIX88RXMKyivT=Ug4wq!U(s8*8{mMp<+h7vW-M&wl
zIRSgzb!XI8^zBpDH!LwPrI_x}O8fk<826fujY~!qU6xys9$qrxnzo@=k1q*#RDOGo
zp0SIYOXz|vE<epiS8Toe^)H|+w*Ge*7ixF*>vG+uNayUlcYV{nP78YO6PthwCrU2p
z*~Z0m!!5L>$G%F{1-+}Qi}I@;J(WKwc2z=tinU<miq>|#6H+{MYVVRfHN>o*qmS~`
zy1sQa)eW_-J2JCBEgUyta`}*}CX`lAy{Z{WNgYwRAyU?zvqz-E8T&QK_zFagpjXDA
zi3JlV<^APnPs_-XcwU*`xzSg|{_7k)J+B79HvUE#EPHZbg~Lk?dc1$H9DX`NPkmIE
z`F5c5Ro}mEIY)Q8Y7D=TdfM}h99{*m74TJfVOoTLKYQ%ie=kU<==4*P&NYG;s$fXJ
z{AO18@S+Bul(R8|f4kOkVQf+M{AL|QyUBM}oQp;O8wv@__^sShJoAQhlq~pT_N1j;
zAV)sxqO+WR@j`ptodP3G_^n;?8UH-2WHK;ckXDm*L2KMR=fZTH&cPSj>+>l*^M5M?
zykkoGkJ!U6L<7385mx7%M;~&vUue%SKs#cW|JL67?uAkCH%877=z4(~lX^jet;BcH
zpE}JK+PkjG6#MOcQ9bKZ=vPBbbI>2}XkM^}b%BFB`8ViWo%1e~75`h>7yIfrvdeeg
z8!P{UG_niiP0R)8XRhiC<;ewTYtqu+$N|#d3_XDKx6!7>m@Vhg-`EA(8+y_WEX&TX
z*?oRN>cgsY=t$>P`Lw(L51A}*CWii`Oi(;A&Q_!musX&m(plu1J?ZMFu(R$5C4}dI
zxuz@FLg~*kVt-&uMyV^L@vbN26RzE4`|y4vKOlT1JiNrilnaE4J;>lhO?c+OgJg&@
zk?!z3?_uh<C3A+Yd3x^Lj<v&vt?igQ_vtmmq<M2Y)(jiAM*M}ZXloIhCA}@b#BHx#
zFu*p+y>*QP*rMW5i|XqaQ?~oX_4SKJ6>mjsdrGQ^aZjb3UD93s#pnL`TvRk_QG@YS
z{|TDUeyhNF2fp;ZOeSl(g0qdYBGYk~+w|q%mo&T~nOTiGz@A^9`^dO?qK|mxko(?K
zdE_^;6iS&HtVS}w(Xiz2Uuy0<)nDh0dnC6$-)>@^A<A9AeU{==t%b-(WIU~bXRoeV
zb<5B@ZhrZjUx(gu!^%44U7It_HhS`&Bi6(Wa1XpRDVNJXs_*mIR*DpdeF+wLGF`|&
zqSm?_uB_{S&8qc4qQ1ZP8Eayu?L>4=DsX_0@I#WL&1YciMH~RdeEWC|cs-F|KtRwn
zELlDJB(dISqB4^2+z^qI+nsw7jQ3}wBYsGLyOU%pGt2VzL6^WkFrQ8ygqwUBWxAX2
zHji_&$7A7o?b+zeq=Rn;N86L5r^PyAg6~NzZ!0Zp?N^p)Pm2!Tl0<(Et?PrQg+H<O
zLRx{yAW5r;N_0e)P8yh(mX#Kjlpa|!Wneyj1<w%IuN*_a-@sVn!4~H2A8u#lXirzP
zdh!`CzX9SSe@sZ!Zh`Xv>=Wcy;Hm4$M9p(CWas2WY`8TUnWmkhs-8`nSB3xEEOWYi
zZBQX@m-oVl^9x`*O!T-vGp9?>0v<x11a!A-=MO70Li%}hirp6S-oa$NgmB_IT5&;z
zQm@Ex?RyJ+)U;I_uo_$8Pxhnv-5z{DJe&+X%?A2@^f<n216^g{PLo}hWaK7KLLTz&
z#$7W!Kd1n&peHKV|3=^ORy+9lDQKrX95W)&Te}O5V9AAK{T8{>&28r)LHprB&`=2e
zpSJvPp){yOLk(qRPbkWajm<1dAWpEuG05C*w1-UYF|H*vT$Y82#hKC3nZ=1lcK3k4
z|GI&%3)LmhvK+u1KrE1VU04Eck>y!f4H?P5djqQ>CHi~1AVz*t<n<^=I>fwqOSyLm
zBqfW4AIYhed2w-hm0&k!T&1!JdEvi8UvW<sm>*F^z9yJNeZua`*aix_;bAzn6q-}Z
zYCij1q=F|KjmQPB{*K4)ROiRX!<~d;d64X##RgjzsbLnL{5^!)&NqiiKLxdP-*#3v
zZQthUf}nv7{{Hjt4@Tr!C&1G~wy5K+`4N@`-g(hS&J45mHM0f9UarEkGgMt>N5nXD
zzoiV6+u#pGG4s(d^@c;UEaJ)3e19T@Ty9gOzG}2RTFH9OsYb`*=Zo|+MyZw*b#i!g
z=qtz)5q{lu-v9nFBo?l_c!!fkAcqCwS!o0<j771b+q9?T<u1HyEaCgx$o@3bltwhD
zSmm@ylfohrl7_=vh%D+A%&LY&#MyfH?v+rOW$QnuB|EutcuCdFv@G-Q@!(XIGdepZ
zDh&~B*}2W7$;q*kBDsHVp;?xG4XVf9(g9K`!0o3vyiwU8=bKv)d9eovUK#he!;!0o
zX>Yo3SE|&{G2cw^f*_Y>xt0|rk8mzf7KYj5QexLTbJEN)QSp(G=iuKOcbWVIVoD*;
zV29OT_?EtpDoP*Sc~?}Qq|wTTr1W36Cpl2|Cu9+rBv%q27;=0`lU(=7mB)_hbegc%
z-T|H1`&c&U1ijcB3(Y2ZVbH~VZ_M$5!>>)YnSTa+k0}>9N+sk*q4N1=6Q4^NrUSls
z+%Eurn&a8+e$@xhEORLKSVeDlH1LR+*V)Ql*v}sZ{1EUA0Q>~46Zch^s}ESx&|k<|
z{^AgZ2NTBF@w3>@oYKhkmnWs$PQ9JeC;HIpq}*uDWl2kl|Hx+jHaYI2sHkr-<}K!6
z={-xLz+!k2>EexTYQ1u7(b0axb1EF+M~lW@X-Uj(nO$GkU`;DbX_?#P05#lK81zw$
zWY031cBGy>hP7+C@7wUMe#30U1DuzT$<nWucXi(6pjFHr{CAM@iTtqn5XO<~bRrAo
zAbEV}6ZFq~=z*=Mk3Qa~&6KWnAA*;FNu_)9O6l6ur)O>0u;=^lXKvn%BD~BjlsQag
z7-f^OO9>k`%sPEqo3(lKjMKQ*rS;+ZRLXO|#LMstcy{-lC^AcXXXDJ%-_PV_I#Fh%
z`$b*`XmF)J^7O2`?wY0j<@*^MH_kvA$#g&qmKM9Wf#={^poUq=LyJY&$brnh?FGF@
z_RGrZH?ns@d*95Piwbgzi*pK!w6_X}R-~j<3@z+Eq&zvfd`NF+X{j@>q=e|aLs^d8
z0z)_rJO`O{v-a$M_Jg`tdxgCP5_p*_JY{%3DCy=WwWI6@<qB5$0DT9cH={84A>ND!
zj<Ed?Jiy-4UZMJ%@O`cL&iFgw(po&rGzg!2KY-=U+Zd!>uiWQ8LZhQ1^sx+UO}X#v
zz7_I}7VSk=^8mGDl%cVq_sC;-iGMzT&m6~Jv@p3Iyuv;J@06@Ua<K+Ma=rGYb}9=0
zV<jwByYiCzf)kSxdfj~)@%Lh-UAhyw6)1MMi^Q%(_yT((p`eD#0TI(#knq)m>Ud9#
zr-=3Z&h>BPE+Tx7DEV@zd0qGTRD|}jj}Q~;gD*b;k7TW0%&u1d<3-Aa&une=B6c-!
z-l!~=9x&gn<Ahplc)XHZik)((ZcG#MiegS7w`#t2{Yy$vC&w4mq@@Z9Q`2e+;=dAn
zs#dO$K2baPnDaEO(kHHQ>=(5|JAVImKHfRXr{*<$f6PLx2}N<J%BNb(sb5YhBa}bQ
z+4DiQwn4hcO=aDeD4*i>3GAg=F<H2Yw<E+>`Sk35l+8QpmSVN#)&J7I<ZE-bGFSSm
zc{ko&sB&Ls`T##`OzZGd!hW?A`yhS)z5ab7|6Xf)CE)vC&HGTV`W*Ge_mSPypP`hZ
z{f{9(o-yqdR4_#T6BR59?bG*Te&5IQ@3p2=p6}0@KlRkFc2CjkU(UZLA;&NARg#)C
zn)i8lQmasXiEjVOthg%g%k&IIc({trH<aeGONg?=`rL%%j4c#InOG3xu-BGKS7)?|
zU}Y&Gn}U_K8|6Xa=H$fLmyf)De35EdV+$KP;fk}L`UNk`3p)=98q6J_p&4t2>tFio
zCOD!{gfai;OPUB84VSpLLO;lLA6m^FIw3(6HC;x8{H!fLL*$mv+%Tb~uPT)|3Yv@K
z*}Zw~%Z4Q7$E3y85cypQlLvPm()&;|{?-|NY*!^m*oxY!OZ|F8>uECH(|KOK7jxg)
zb$xcxs26w9?nehYr=R!X9I+q$09jguxDb+<0eY)c1l5s8a2u+mS`x5yfdd&yb|4mg
zJp7~6O>^C(uRQ5q#NqF256eviNA4r)<CEBWXufPi?%x@JQ%r#HJmYE<IbL|}02B^e
ziFt$nqZlrE*X55dD4qWB>x)~i>z{8)iwjH1?42}p$<S;^>xyyPvst<8Gwpljn#eeL
zUQpxQb?sLkzPevR(mnB3OOVAmU}|N_u&R`$d3kL5*<y9a%-A9Xe-cgP81^`5vCwWx
zhc{}FG@!A{2yLqNgEmzeadyAb_+jT(dA8K>;fJ6fHcllMbr8J99Pm^{HYpev@C!x9
z!jn)u>PER8`R@)TSKCus75dTN?dun(mdCIKKMY9IUbp7vJp1C3bxB$}`!w#BD_)UL
zDqp0HDmgY~Q%-ncn(NC7b}AvZV{FT@!J}Rfd>epv=b~MjAqZ@bU@_vqTq%WrU`(`<
z%dD32KK)ra|F0FVgt7SaGxTrB?b~wgJG3A1e><N_xf}n_!sKr@b>xQKxOn5!xnZk6
z-n7P^+V9MN*}#d<WP}Y{GVw@y*f6OKy5VlTg>-}QrV_nkr0c!hQ-&JfRXcmHUp#$M
zWp3b;O5ocf?KWwpFCL0C<YyN>?)=d{vv=fHB<Dqhrv*jpk>!WJ9WXe|mORr4pXPWT
z#yjx*ji+1$^>w9(y`()co4w-y%2P#N7n0C7zxSfbyTNsEB+K<j)U|KeQ?UoC;n;uD
z)jwdcWYaz=i^~FdaH+@C*ReJxaQN@!hXh=^T4_aWi~)Z^D(CQA?P~RE;7F&;+`#jK
zbX36I-<cJTN5Fq4V@+Z0eU3SCqsrgtU>{Qr<k7ib5_<Ab_s{C3;+urIgZBa+$CRfx
zK6c6}_?vWcDnt2l=p7LMGP@-#W>1-g-Im!S;}GR3Go#xw`((&WPnj{uOG9m41CaNv
zkliv?pQp^F-Im$sd2^&5G_Td$x`*T0Wh&zR+9wzJ;JH&Tb1^To+tiDf*&}mROz-=;
zZp-YGi*-Dc(3VY<VLx#^drel+mUM*5U=L~4c3^Beu!q)TWd_(XacUL*C6#c(grj2x
zd^7oL?etzSPpLrC$IhnKFW<Rf!Okn{>#v}n%j>1RX)`Nl&hJ;V)&2C$1t(be_DfGb
za>K-;@!LMVEweg1-DZyrR;?E4t>s5=Y-zdi=<?-9SGTmRK6-YeJ!wQ^>C_y{<<GOA
z`yOHuFD@#Za?|$X3vNGq;%Zw=Ltbizs;X9yj`{NdPJYdhJL#tP0gz2kyQkwPqw}s3
zjJ+mC=(;>P9yA`(Mn%#;CAjmzgZLi{`#t{m(MPP~*tla-vg@Dt@h(tcZT$)y(ZGSN
zmh@#2DOm{|wC;7wq0_2FcOHm(CZ(dafQ7}{vT~o!YMfM&82`~n(&4Dwvat<$7OBv6
zORw~TYUBzsYtsm~WNOrQDAmXb5n`$$o^y;m*u#h4@NOaA;sl2s3jqN>+-|sf)%90h
zb^WTV*?Va-t7a^yubsbZWy9c`o?W{1_p1k0&bfV}Ei=iQ4fpei5MnZWZ10{OJNE7G
zEF<QYP0h8muX}dc%IDV(8M5~Il@~vG(>QBLV!AU%XDu_$*8U~^-hCrDYC-~g2ajdC
z<^iIenO@Z%khbAGgms}BXH%Iy#VwIZ8MZSuo)_(y=@FE@&iw)}>#=%D*TLeMbl1l4
zoZMQEotBv%)0!CM8MTR*+cF+Ia6oIKHNMUDv-%juA)T-wi;QA==a;R3H@kk8f1+GZ
zlr53N*Kv5ec2qirGm4DYEwo>`zVBY?{vI;#&xm(!L>J&6$Q{$O$u$jb;s%qsEt}gW
zteD(n4z9%mr!n5~MnErHoHw(wdQyG*;`sv?6!*Jl`h<<MEBY;cWM=WO#>)5*b8`Hn
z=~>TYH%%(HoRKa1e1Or41()UJj$1Qz=RFOz`x@F>ZalK=npbacx22b)G$+I=+gWB_
z4Q9xduQ4%I82W_VEui~H&>hKr2MVzky}4UR;i3HCcu+<cKzzQ$+RLe5!UkKzpy<cI
z;WIF43;Qq4Q_DRiVKM&cS!7E_4ksTppUH6gXKPVXXcnJ+viD5i%q*u_Mgh^zuKF{}
zfW)9N!+?Cp#|$eFBXNRlcYOi)V!V~|jk*nEb~A?`G;POEX3Eqallx*ljG{S3S`>xw
zJNbB2LdF^pp_=fMG#BE?z~C7?JzmBWHp4Aj4Z3A3Iwibd_M90x10z!Gcn!3A%Cwn_
zmMxn;Z_)%LOv&Vr%GT^zanYT#k@%~=X!Kk}-_=&tdCXu(xfv{}EIiWLP(0C&yeOml
z_iOQaIJRnF@3xs0{N35Kt0&dXXzLS}Fsj&VE~7p+p^x;Q7UUH2!1&SW?IG{8Sol7f
zVT?iNd#${^W<y(fwTHMUqmRkwd~LLLaA_7&!E9+B5}q)k$RN$=SWgd-QVJN1+hf`j
z(&u<bK7$QpH`2^x1Nk@`xd0@!jQ>4EE0w3ZpEjklHmMepx(#-%@u+`TKB^9b{UTjn
zMdL2t$ZqB3Yt>H0Z9a&Sof6+(Q1&|aX`y#B9{11susiu2v1^Yh)sRzTpy?XJj$9Pj
z7qLAWDJf{weYi=NQ`{w5pFxFKF?gR?B#01t;IPsEzU}g(s|QY*S~{xMQGMw{bIU5b
z@;0^g_8XV<9v+fvOXxR#<(M^h<_wu%|0+9j&22YbJ9vIuc}#RtsG2gUy=wL?qvkwT
z7S}L*a-VTqR*s5DXfO2Rb#hsFQfW)x4dFJt0KaTS$*_v#cV|u=1!HSkbTsd0oAwxF
zb_aQ@pJSeQ#j!C@5GmoEC%n^k)z<dj9lcAsb|>ZT@1K~2N8Zg3(If9cc;r0|kGzko
zp1y5aee)F$Pp+KM+T;k14UM(FF@14ZLTiCvAFvRDmOaOUw)XJ!duT##O0N(r#<I!%
zJ)iUGlm(0S0n_h0-v>Mm@Ksm~>C%%Bvt%RwiNo96-|@bun=GO{+vGZi^2V7xouAnW
z&x0I}%zNxGc!i5jQyKd+<`I4>(5g^Jk)DvV<=?|{@UUrJ=T;7zz%FIgGV*}R*neEX
z95#+!!YXA2u$urQ8N*D4+FE%N=xd<4h6@TIgz22er7)%#t}Mi^3v+>IhT*ub`vc%8
zRhT<%?xhv{0pRP7taJ`^1SVl(elG%NHcqX<8qKt)M#u|_8=R2?*Sv7;WhXYY_X_Ig
zn-y!<1pS5JYln}#Zd`9#pdcAEXMmAT=-$;P6VfmV`BhdPU^T#9FSi;%p&=<~=rP$&
zD@#mqJd@oxsoXFW4D74&*OR%aAVhPiL8>m!g2FBAT`4mM!XWDp+{7`In+L8AxAv0B
zKrrA*?HgtYGN!EreX=PQcK>(4(@@y(hJaw4IQ5-8Cd>HUY*BGqhQR{?ZJz(~%jrra
z7f<C0ckqHRACY8MQLd~UwQJhgQP~Y8Nv>Tp_Oy>`ub7gf9=u`gnHjs=e;&1a+L@8h
zui1D{aYSTdZBtv}^lMV%292FwGG_I}qGl;SAxn8|#>|A0A;kqsdR)}pspW-ZR`1Q!
ze$RT#4m-lF4khNQc!B62dGprnOJ`Gh4^1h}jF~^KY;a*Lo-m(sP5woQ%U`Y?Q1b9T
zL?mL=>UqC}c2P(k{_uPUkI|bL+1RtVGDo>VV6)TZG`&;{CHk_wnKe}t`==*Yw3Q&S
z8nlO?gu<Ax{tqu4ear01zKgfbRC61~lwu$tnYoY-M%PHQ$Qyg(go)P-%WSCa{5HKH
z%n`jwK0qS+xoel4+&D@q9a){qW*-(}TK<B9$(j2@3`#5Lrq~IhP1uy6J5UgvXKH{>
z41}Rja6)74>`%q3Cl1VyRBe$FwMn`4WlpOxH}Fi$8K$ccp|@wJsB-({`KixDMFhw7
zuFt(&S8lY|*v-1q@M<C^F440KV&(66XA#s13%b6skv4<C4r8tgf;^1d=S@FnjmU7c
zwweu{%K|P5RVGAQGwybgWiBdY;zf@dMC@nV1rgM~DHXa&vs%Y<Qqj`JlVqM&%K4wj
z{)BrddZ!A*r7s;CN7CO(G{@TI=89WeZ{BFMJ3l(<u|9~ly`DvB-}n$#l#6GcqI!jd
z2etMtyyvFZ1Qo{<5@sYK;d-og^hxb2oyhsc6(OM^;=LH?5E!!;6^V9Jyrt%#5Mmo2
zG5yLt)=qXCZgJu?>Bki0r@w>!()oF0<YzGvp~-R9<C#rUs(X*lxkt0g!BG)!*sP%m
zv5|X|tH)FqjLA86Y_7E^h83E7*-~Pl*=5B<ynJ*{LTRM-l{qLXC6<)Em<ZZqtKAN!
zN)D{<drhXZLZ%M{>><_{ux-fxC}555cx2u!1q}M04r6YIRK{VCd0@CZkVZ)1*o%jH
zU=g@Z8pV)<T5iLGL;_#9cA1pTpkW}7wnQ-K%9%K?S#j3QCl4bV-74D=Ol?P?G#|E7
zyN%u+7k^+IbjtLgy+t->s5Gj+5b?lUx3#}}bwhNbG7`7E=7^vfYP_{MH)M)67#Gvy
z<wWb+H`dyN7KT`qAoC@`N$k@upqqQFE=$t(=xD7Ytu{HiHjNFlMmx2q`c@=XrLwlD
zXxHR4w$$m2#)aRew40;xcPjroCtBN>Ds7LUiZ#i}HK-V6Gb&<yCTM+FwHvvxN#6bP
zx{!B(RdN{Qoq%Z<<FfcJ%IU;fUC+{Tbi2F4utwUI4ajxWK_@ZehSDjsO7DB;9f=7)
zM9_2QOx*k93=oB~U2oc@FS@zZ-_i9BA9%E_(iiRn*k4VwDvMaQli#Mpji*fd;<51L
z@EIY&A;GgkQzCYM_PMq-IDB4kczE!<&`<`E!%Q=@Ez&V}#|7u!(6)4+dt;=wPkO_>
z8~36(qZopdZ}J|0mmY6KAMbh<N_&ob9=l8$FI_=64g0mR)#_Sor8M5rcTAtc;Vu1A
zk~4Rv_Z?eaIIN|AN<uc17SlpZNK44fr$vfi(hG?1uxEea-beiMcvr;QDP9H{>O5Qz
z4($~>KPV}DB(Xfiyf`=_EOfCN%K7ye_;r%_MQ1T|jymbNKpwNqKUc}peu3<AyIl{e
zoze`;<2VO&qMy+2@!uaYA9Iy)(zog|oYrB$Q4awsLFal=S?hihdjoVnzPVy&Q`Vkc
zLI1RC4zVwBZ;!f<yUt20ai1$QT-*FIlf&+Cy)WI2zRD6@E`FKCVfVTIfqP%%{gyEN
zzg)^;bKEKHe#}Z)sx+B?g<k;rdAWAKIt%kN3xAN=+?o+^iog!akD--x|KhN!v$WH$
z2}7+@hh{WPtjHahVK>{u9cd27pw{9F7B0aK|La6)g==l!*w#Mj71_}tA#L`E_^9Og
zklWN9uFVoip?=JVZRMYkyXnX|f&QzXC<1<^wnhG#+cPc#KsLvkcHk$YH;3dzz?1O@
zV$#TEO*{(*?Si|k;gF9TJt-<9haJrxFu5}PjFO(sjynfTu23KZ<w@!Mc<vf2xibrD
zE^5kRQmX4VPD_mYJLyC7M9^|IwF&##-%KYle#OcLw~BQxn|5{n17ARQ=ikg>?qo|d
zV7m>N>uZ#Ig_qmofuWo!lb74;f!UQ!?mvRpuq=CEHsJe<B@M9s9+<b>lO9-zr`!P#
ztW??VKA>(x-Gd&O%`Cg$vjhS5ln0ii-0Y@%DfG+(3pbnGZ(4!@>+ryum1FL$Ja^9_
z4{U%r-F?5A=H+1ztWjC#evtR$84oPm9PB;<e+$`k!~?rsndNSWf2EA`j?O>V!|J#0
zdJEpiH9hNrU7>6+jo|$Ig9kPn{9D8Ma@+%ZOS#J(fqO2Td_1tfnM2(c3;Dd9^uS)w
z?spHxNkBF|=Yc(?J?^f>ERs#ndtmW+FD*g+7O<~9usr2PcL(*2m3U!lr@O;~+gDa*
zz_exB6Yf5+1;}im>y(%qu07fV?i*kel+}M4<y@-(y9l;FS^ZSN-~%+)y^ZZuYDs=@
zI~(?-TGkQQ>|89(vey<|Cg+zZO-@*^F$bZ5yZ=aQ+Z^w~iF}8E9RMuG18dZ_xF5v+
zjuqp9m1_Ik2e4PmX1fR0to_Tqm28^oCmz^O$|%fp@KvqyfsFy|O~9%RnC4KXxC?RL
zfm>(;=Gv)D(K<M+)&uj*OSR4eyBKZk=WX=$z{UY~ABXkxz}f*j1wT1i?eBrjQ^vS=
za$4#=uy(-i=CDRTn5f%ez&c;R+sHOfUsE@*0S3&)*9dR7*??)sv?cBjkY`F(2W#_a
zjIj@qP48{Y59~*<I$Dtr6}f#=;lB3vOWIp_|8-tmZurx*2g?6uK^?Zphn_n}J-f|H
z_5Ps!h0RMU4BN~1&S#~vj)Z9Kb%qVFhxYV(Pig;P^D-)f9-(^dW_f-`PO3JB{m`{u
zxu8?8w_p2=&2v^M+o)c<@=!-nhU+y6x)Iu&ip_W-`Ufe*`&Vf%mlnRHJ+t~by;G@c
zcRwe}aXv(da+t?t7eESlJO}soONYX9?9q;J?cUX}6)RLzS+*@a3aNMN)@s^k<$@<@
z%a@l9fdB~-z>`kB`tT2Uy9Y(p_n}d98hJhPouM(P#3?$JQ8m|y)oixfOL>YaNxP*<
zYqgh^AoW3pYp^c$kROIYJLb*p)^?y~RLD-M$Zn9vuwqmVi_zYd?lbt}(`LDE-N&>&
zsGHF1QK~yc-puk)H7ZpbDK4@Yo%8*9YO@kgAKPaP`1FZlxIrVz`tlXm1%j`=_!Qe4
zR+xl|qTRcXSp{F^zi6*VCnQ8mD<*0V_HqmLGXRHoY$~a*N5ZpXbsPm>aOPG$8Xn0p
zxW0dlT_(oHz@g7`|FO}l4||ETdAX?DfqP+Z+s699p&x9vb0$Ay?xhmxvkq`BFUCu?
zp=J>7+O$=!@u@4uHGs#cH&>SU_%ut?sMb1Urg>L>N6<T<dmcY@gexRi9FI0=gK24?
z9hBufCS4lyN9S<{Jq<{c_tBt=jI`1arfoUGLUb<o)<z{e(-P!^4X!3>?@&*h-Q!_=
zQtb>aNipywpXRLEqP=TR5on^=6O7EjKJ*xC$xK5Iau^@4Ln%cDmWsb|#<{koaU7j*
z9Fz9?)F-cc^oPcZYU>Nhs66s0uUsdpu9eBx(8~)kUgbDeP*r`rqJlURrthPgeOPKl
zG#Jo1^<L!)UKe&jpLt!5Qzf6*_aEO*<=d5yOI?4ER*OEO>^bK3!)lc?tJ199cN`Cd
z^Zi1)$@N-BQC^zz@6yg`^6evu)}C+(cGIxwIAYH5uAbILCOZX+QfWO~bAB8&WI7J#
zXB@{A8ZnOJ><?_S1f@BUj`D!@MSGu)qwgugaRNJ^!0=dy{JBs4U?Ah8r4N=?uGbrV
znCgi-qm=KcO$Y-YUL#R4ZnGA?baFLop`yyNU29otxhTi^tgpWeEI*uh95k;#(0;d?
z%?)=%>pSwd+WTu+T}UX?@%xTXmZ;|uZJpYCqOMoGeWq!=x>v@5MqeCE<!zG%f-nD%
zwVwnIuc%``f5~xp<y{~Sbd=0;29DQ%6)1e9UaIJYA^LoHAl4J!EAhwi;&%dvR|2-Z
z#i{U!LEzY?_eJL;jWI+$-ydjzVHT}tcw=1`Y#l5}muUg@4E=yJfa?eGx#7BWBK^S1
zMN`-I{Ny#)4^m1(4dGPUkzyBuDUeQoIWP2siXdGu&F^p~>q4nJInURwF6X7)404{N
zCd~~)PV4)VM<%HrnWPKrP?kz85i*HO>@V5R5J_Eec-KspA(Q;|1(}4Bp)YWu<fTI&
z6MvcHr!Pp$b$x-$B!hmv9?5P)VbGo-9mS(EFvuiQQAlZcfXgJKZZ|T?PiJWMQ5g)G
z1R3hPW{v$(m;2B%rcKn|(De&L-Ujm6<`GGl0NVZgG`zP%Ean0!#V#$Ls5MF-4&^-V
z2}duk8`0h-a2UFS#Kn<70^I@P$Sc3$6GXDa!etQ{W{4skgU}opBoVLfI{hjn5skA!
zL$_n3R~C8$s}ofZK@xfE>3oJ9@`|DGV02v98X$#2Z0I#~21p?;zkGP?kwLoLA0lsW
z&;}WLSdVgFFqwpqE-YOvinuI<5CrB^4X)Yp@sXlEzQ=W=JJ3Y#Mt5Lb3<)HS(moPH
z=fcyI?!dSt5@_J)O_Hc99zzy+l?Uuqh5{h82a-k{OXur<fHd;O!FlhiJ!s`dU7<XP
zdTU4`>0|A~d#fyD(%yY+lCcX+l%~`2_ZeS(UiiwTm$cvQWAmWd8gj|i0Si)e0+&n1
zeA3s2(_b!qp}j4tdd1RfuJ3tmE|$FWO0SP6p#9`Yr}nKt;3Jb>)*KvzE|j|9VCbl?
zO!`6-D7-RB`cP}+C=8(#h@(6Z$A_l{4v$QdHEkS6;SoyR=>W868#;hoMLK|?zZ-H?
z*9o!TTF~`MA;1)iqTLT6sIo>HDV)t@i>$p2A*irK5@fus?(_(n;{keve9+J%=xk=R
ztMl7OkKiKEqepnfphu7J$ie^|J?atIPIQsT&ImoiD;NE7bkPAkdW1(hrhUM50FQ`7
zUjk$~$vr~{po186fPB_qO!er54yjDYx`29y?qCQyukOHw9CQa=z6I3lsyoEx3Ecr=
z$^zYiBovL6e?5O4z)yE*mW1lS1=RU;0Fs4kckw3Bh9L(7<rCh>)3-e#fX_0xW*hPe
zLb!JA`*JFYr*q&?J@Uz4j}Y>SBY_@4rzI~Pf%1u~5jZOOYY`-%czw<NDG4ZV{ch!x
zpANz5M9mMld@}kk>hZIwzYZ}Mi;5e5AfeD}?IqcwJVXa2zV?0gNso-u^#Gh^p$7Qq
z48A(FN7wR-C?Q1QZbp0-5=w~h@v;lYB+*_EI1CXbaOk>(5Ksa~qx6wDCk5=g9y)r`
zC4_hqNT5qVJayUgygHvyCLo%0g+OQ%B$<RtaQZcVPBLf+MyLGGNqRk@NQgRz#5pOz
z4xr1V$B(e-`m`L}AU~?lM?)Xb=Yp?HI;!nE!sdpQr5Q4*b4`PMFu}oyzec_8WzyfY
zS435>Ogh&22CuElq=5Rezf3x<{ZrKU5lK(DqBsKYIVk`~SGo3+K;k2m_PUxl5?v?-
z_M?kT`o<+tcxBRY*Bp+)M<!v6eC9Uk03?$P9RMr%jfv7UZs_pN2chFxNgyG+AnhN&
z(;k3=7ZPR2qx)T(CrXQB!blo<>jjJxO=hk;%z|bs#z{WtI)sYIeMz#&m_J>|iK=ql
zfvS2%(QB^LytZ*H>x!c*pP@ex63j?L7IFOnH0Z)8kd7{VCjEg>WEiqY`iRsAVDJc|
z^T~eZg6vP>DmZ91WS`Dw84nFPb^Bp(n0DW4Hi3;X#8yPG_R?BbB#qVeG^4K0YYWwd
z+Q4O(S)s~?)&SvUmZ@?rlm<vJZ@b-$Q-IDOE!QA!YePc$`OIkZd^&?y{C%pqd3CQ0
z^v6+tUY((to%w>Jpi$E0p}!pEc0ohllU@(GoyLZGrCWzQZ)i92*He#pMu#r1o*)ET
zhg2$LnbDrH9`I5lObk>Fg3PNWkPz!&79qckI)cZ#tQW>_|NDnN;`)J`>M%BtUq0&;
zGRW?G-iORuyPKb<3^~`moTnp_5R%^`^NL6QKv34LeM=ci;zzXAt^Bd`z7Z=04qaCe
z@`vO2Ku*)oM?KNeldd4-4@dGPJ0t9L{y2=Y5oWVc79fB8wFMGD90RT>_|eFxFI{Dj
zpRypTy)R@?gCDPrbJ6zW3>WPX**CiWP^$bx=M~C!r)Sfqcv#zWoXs{@W*ai-?5I-Z
zQ%3<K9vk(#?rl`{l=hsc>XktqXCLFWbr}>;KR^b3ru|LS_mM$&oc)0#@XDZb<2a-J
zN8s=gLF+q9IS%i+$R7vvD*v-pr}ncz;uS)-cTVRx3?UR~12ANeA@ec41~tgr1J2#X
z{)YC-bRo1)dk6xL^@=s5(7l~g8|0_rB8)SUA#?RJ73m9QWL%{cD-;G6QmShV@<GxV
zo=QlAB=Xf6bi095uS*72sxFiUs_vCWf9QOjW6-6MS6&;o2M-QmU=@l3;qVbgPq?fc
ziE%RON(<*X^}}Oi?bJwlAVgk~w9nPZ@pwcM=HR(yKUO5ker~An%0NRVfp(qkd-;_R
zQ`kg9Cb`x@`YDPuEx>kQ?31D{vCUs^kgL3UgK-WvbbxMTQh@FtE!TAizk95%>x<g;
z=nh_y^r}a95XUmXAD?}&o4FmJJ2W$2)q#XkpxiHqDckqVe}azuTvs;apTS?R%zw03
z0v+~8=~fvS4pXD(te+>}PU1_n!Rhp`Oa0s#5=C`&eSySROc>QIhP9I}ue>rp(9S@$
z4;gj_nGK+^g&<R)GLW4?Vo5@t8FY6uJ^?xdtJCca{5)pV6XR3fqn*Ln0Q-2%43Yd)
zMznA9-+O(}_ax{bffLyXuaxUh9u()R9_mq-{q+PP**fI;;!Jgpdj5KX5N6O5gdFp)
z$K{wuQSiHqAOQw*0+(IzU0mk2z()nXHrz)A9K(AXZ@RZhh47<-?};k%&%pOY`zm=@
z(e-kBL_@(QxlfMzufziQo_PFJBy%(OMKS71=700Q{}1~|u`u{mehEJy2{~ubzWW#H
z38}CA5BTToHkm~10zAx~P>Ly@!F1e+XK<a-uGYSAlV8;fhVO=}JAaez{8GB{U+LD*
z<tO-?1o*?ay7<i?r`$<tm-`L*N$$(2`>E+^?mch8X)hZ-Y6Y#0RdI%wTJNEam4=sE
zVrrsrQo}D8Hu%dShD50`KMWtWMF7a^BPNOzVy0Y^L;9BWCx4ABytEpF>tE^H$F+4&
zNH01zZDJ`GR0e)V|Bw6P`0%>L7~`(~Ip~K|eZu{+<r~vX_`jWDhw3(!+VT4d*Ok()
z+;zFH!gu_H>pCTa|4#l@HuX99%e@b8G5E{5k7Evz-`rb#ekW-i?&sYv0|vjjUyC{H
zE@hg#Ono0~>Mer~*Jkxccb%miu(v(1e`{+sm-~LeJ`*s^jc3&FO;20$c(ysj&Ezxq
zt~>A!N7>Un)n2IU2`Ob(aCBU9v?Wjb1efm{R)t%G;2R1$FVOc*Q<RPFP<0n*e$k*s
zQ`E2Ap%#mPu_-if&VH+Y4?gA5+qW{vAU6#M{9IF6mFtO^Br80b<mhC3bjW=3bsHE9
ziePD!{f_VXoqN>NrYgN3+!q<$a8hl173Is@rX{e!Os}t=wpef9fY+%a(GqwtT|Mpo
zM%0xZun37Xgbs@%N=tf#@(m)x8W?~lTv?NO>qamkf_T7)<{|J2TnC>@2Rz$(ySzSm
z4GGeTm7I)qM8@+k0o^M+f1ggv`kMsq6y7s)n8kWve^e0V^CR;1?4gDPq3rBtv~?V9
zWq?0KC1U7`=ovJfUd}4s-s<R##HYh!qO8F$P=f~jsl1JASLnSlJJA!hSFhhaY4nI1
zy8nJLzTnGlxzzo&Qc3%U@m6G@544TkS_>wP85Eb1ecahJrJ`W+n1ONFOO%psT%c(!
zC}qgY^*6B=-0#&5t9*v9g*MYGMN5me^R>_>-OPWdIaaDvxDS{|pwI9pb#KOe!B4yg
zN8@%xxy>{Udo$#`jWa~dT~;>jj4dO{;@Tx;l}6;`ATJMcPO=BbQr1bTXI5^5PiY7D
z-xc#rWV)N}+GS6(p7}SN=F8Ol2bmNR#ni-vu~g^J@CS{BUo^F4%rC^^;N`g6k}{%Z
zxPF$#DyXMyh=`u|AWKZ3I`_f{_d`)fpI3-SL*TL_Lz8EKLduevBS~Y`_<1}hCc}LC
z3GL*9HjwH+p9F~<0b0$aR@bfplD+talRRcLu>GvluyJE_1bO=>CT!Z2kVxbJcPDVy
z>bS)Og3msmKRVh}p4+pQxc8)ipA$)F$By;zG9sGrBa3HZ!X0;js~D$dWv=^>$UW3K
zg69sZam~k1*#y5`_fEcFP?@cInHpZE*0rmfGKb7O2hn-(h%%);;AvD!LC?pSH}D5W
z`^cHpIYML`a?Qt2qM6D(7*M8)m#KB__bKxzau#{<RCo5(@r>~)^I$-ka(_JV`5bMs
znKy$D_<Xv*7kptAM2G(EE1z$mnc<+}`9}5N7ur)j>Lbd_dKuJn{{&rX1@?+`w1nkr
z+D#!B-N5(y!P7kD_p@xD@<AT>Q-1JZ54^({Zhq1OKkN&KFSbF?5kL3>5Byo?^tKx`
z+yg(xa?lS+^h@1=S0d3LCPPM0s1SEZlpTChGl%@ZlVM5WVM$^8<;P#oC<s~T+PN^O
zF#S!bnng+J?BlfYWn~i_n#1)`Mgntcf3s%;p}`yVMNgYwxzpT#N1La?%gfK#=6&6@
znem2H#cbznQ(LR90B)Tx>@$Yl-Jk{X+kn6A%NNT|5BweGJ5IYi@OORTkk<yD_x#|~
zJ@5|<IMHJ<=0S#u&jZpJeCZ0R@zndss7Le72mTK~c$266Cw_2m`=1(c-o7zUGE97)
z1h(&?Pc|Je>hbyhj@}M3O0sNxK_r3icjSB&d=TG9<NHb9?_Rv>!+vms9$DSy2ltE*
z@MO6)#GL-*z8&NFInE2AJbuM#fl0=HmU1<#GJ`o1d7@1wKQQ8vS6EJ>|D4tOX&+Mx
z&Jj~-+AerrB;wT8N$JRma?g-}Ied9e+9Gv_cAAA#mQEL<dW<;)Uv_=$ku?snIDjKw
z1vGl$eYMRTPUkOQct0JE2o!Y%{Ll?N{oObjd+@*MfmiErNE_hs!s~TB&>H>VjXmIR
z@WW5JjQAd=*68rRa6Ddkt#A3?viE39K#ynbse>i7L;d1#gFlpQ4}2q!d;NQIz<16+
zpYOc_zH>hMe7~B$d-$25a(?=J7wsGTqilWPx6k(kj^F#8^VjFQ6!4w%+2?y;`<&lC
z-}!!r*b?yFg?5qcTkJ^!&i8zRV{Pesl@{;IM=63KatnO?%49Nkav7v@8MIeM1iS&~
z<0RmR<w1OJ{{rQI!FZ^qINIC!#!jiz=$~hEkCC^Gjm)r~mHL<9rOxD1sk-x@1+HH<
zhV{vO6;aA1Qo3}cY<#xsjI>W%bV{51S2jy~H_@T)c!$#fyM^)w+6YAyT`tb2Jlzb!
z=p1;qln0gJ)oeYn4}Y~Z!(o+<wa)3Am{LD`p!WSc>u<Y$?S@xws7vWTy@}<u-2D8t
zu8-ct>!iJlTFaBf!=$q=xoq0&6|*)>&|f5-eE((jXc1Aj{}<ba9ZmTdR8TBD#VC9F
z9Ycwic+_;CY~*$i>^u@QS*1UF8F26*XTfKm1u|jB4i6g^AG=bT(H$4q&|~ub7zWr5
zI4>-HF~`h&Tuzu?VwVzJTg%5shqKR2Zc$$QmoHrXM28PWUWzC_$1Er)oA$Exyu5&u
z924;U?7nW{2mIi)pNsM**?rj0naRj|QG^+ZGzVsS^)%bax7AaE4`o%Xb-{Se{nR$i
z-7)?A**w@7>(Wb>UHUwW+;+~y9gr#($d^lauI5HiR0zd~Qj5T1p8{jK{>r2vGutVS
zhCbBda9GO|3gQdJSwHU>Q$>kIQj_OZ-#W~jT7=WS^3_rENC163Vl3~$#H~%4LI~X%
zV(UezNy5XFr$Zx~Z#=qk#4XipN=o(YBIruLnvFSWY~XYz-OD?ao>oe7=}$pXy{-w3
zviv{D*P)0xrFj&B*F#KPLQ{GX2cE9PQ;^7~7LG_;k;29ke0o8NUgXPt4&b&4!#}w%
zteY^^f=&N^L~!|hSzq{}otqzixpn4cAw^vxTCWdVe$rt3ywTvcH9iHw@ED{kkF9Ff
zhsd)A)yKHb1IdrIbAVyr6>Af4S_=YxlG)uFUz?Zs=KF$9nC$+H!~f(9S3mK<ulI$U
zV+^>-6ns7QA_IQ`;xYAhd$s$(Z&h)Mf&Pt!tsdrk7pyGaor^~#;|<7IdXE?j(_!VC
z)%!-WJMG^rSo<%Fe~g76U$Ee~cKR{b-=2Q@9g))R#ujb#7Ohoz{o+4p|9$8o?Z3wt
zNVjZ3BHsVM+Y|g&O86dzT^i%C+w`u%4?p-`KRE4eqWpf-=RW1V@B@BulG~zuhcBGV
zVF5qv3+HDw0YBmgr+FdZCr$t6dnE1UB^Vz-;S)uvPWeB!pZ%(trB$7ak+J7>A&i9>
zh7JG?74qmsoU22)HAgmm1<U5&(SLpi@>}t7dD1fvyXiaR4AHFj1#-qS2f=esAKBY@
zo5PS-B^Ejdi@rbQ<%ycc&tn|U-Vt#3>%<caoyP?HU2l114L^?w_<KI^k{~({3HS#F
zoap3hl;Ajz5uDCLI=wS_JDxFDA2#Z7IGtNKK6M+f2i|J;^L|4^^Ndwb(e*Tt#vp1B
zbQ@l;UF03xZlmkp!I|hO$gBi@CNlF_`AV!)#%GC;P*w-YC5D{kGCL9(`8eM5tH89m
zBZ<V%&+;<;=wn@{ef+*O!G4O}-f8(Oo+Mynl;ixkGwzi3ma&fTc8byG^*+3q<ALMF
z6_$=sMfAAwUEAtA7tArnT+ojC!c7NFzaVR&BzTDRVKYIWHL^n>p^Hdmc0p{FPa?&C
zD^K|!?x@Ha-cQ>l7Rx#KY)OO)n&oJk+mce4W^Jf*JuTK$_k711!)XTe(>X@Wffm;{
zG?z6c0N&SyJW#NQeHQ@lC*W?};{XqxHw2z)7fu4e!vf&-Iv%VTzw(Vbo*KX_5%&x{
zQ2G$D?fQlAxMAx=c@C$!t=4KI39hecI*0IfS(!0jRG#aOu*PB>PnbUCx??MJ!NGj3
zkX;|y3)oJMN5E+<2>1~{IIVR7Kgo7-IoFC@xr1RRHQ+BGTOQF9i2r~e9<sFwJbT#|
zZ+X7I3ix5YJoZa<7N-+8#hlK|@ssa+Jnsd1i%I19Kat*o&i39+79wp0csB~T7I2$Y
z1o0HRXc%_U|1Dg^Z$G*YFwiB&0dV4zp!XzOrt1T1IlVd@`oMCZ^0eoQ@*M^qZHsSt
zb1Yj#<!PP*PV<zPSAFKGAKYi2`oZ;is?8ug{9G;Y^cVA#<}b?A{1tGY`RfPwnZJH;
zeg1aA-=O2iyv7*N{N-cdnb#O~;Nfr@XUywn!5^H@;dbSrXRtI@@PWe(K4b_!@N+r;
zt|<ZEIX}GLUEc+K=X~*g*JjXn4}V~HAo{)E-4<To;1lc){@*ng@SXF^Ti^9Xz<16!
z@Aoe4bN+e1yKln0|0CCfkb?&M?Cx9f1M?4X>2)9YUIBNX0{nKqjzszW;%v#`cUwqS
z3;0ty{1uenfczo`yhA^WQe)%!Iu+#)>*YTI{0i*zM)@Opd1Sq0C;561<xg(afP$|%
zwjbk)`HXz&4z{1xEdHiBUW)?z`8uUKSf{R^+<ynWTbj;;tJ^x@({Qx$i<d6;_5*@{
z4<aZQ@tsCL*k|`}I9^xr=idRn-*&*Oy?j+4?w%j&HXZ&s^7>N#c)=&i?tAyI@uF{X
z5Z>PraL8Tv^NhdpBkF0Gec%brcg_>c_Ya9zH0%7}eO+@o{G$MPKLOW95S-6zfv3Og
zV=AxxmzSscEa24w?)o+WUa#Z-YXH2l2mB2Jk2{^0r}ZuH*XZryyaM{Y@LH{c=mFDz
z!#q3J95~lE+OHu8YkbDTCN1IZ$0Cp34nD3nkOKKg?<D~j;L^(|PgXbmpo?^D-209v
zOoaQ!%XQ0tcSXg#YB@-jlM}6#dDY`<Q&^ZJUHSa_Az|S;?K!cD;f_H|N6NdXn;fT1
zIXlwuM}~2H_Ql$l(P<6&`s9V%yF>o;(=2Sev~qc11J@jr7P)Tc{n-XNO>Lx`C_gJa
zZRq?ec*Ehz$hS$ScK&n%7pE}sRU%Ff$|myDB5HNv*TqGV+FV;{(HQLq7S=zzG>UDE
zugv>gi_b4~RM-;}q}aq**J_B{M`G;km$Z1-<CXT%{0z}P_V<OHpQ8N(tj-5c`hbA%
zWd%CDYkld3ywuOz+P{3^I6n(G_8Iv*zVF4LUy^C>R{Wsx)vor-;rxQ>Vcu`7TZMri
z(26K8y3Sv?-zco}z}BrS?AS46KVQiicubpZ(Bz8?=L+CL8{x>a`W@dBsqG8_2Mvd5
zd^rvO@~sDZoT#@=+v*F4F0I4y&VX;;X`7Ox<GEKouKo$UqIP7{93>M!`Ce*1fxcwn
z55)Z9$qq9d9-L&0!Jm|Z&5qygm{F8^)O_M=v(}ngpIx7-waCiXe~L<ou?DdN*5vT;
z6f4^u6cv-eqi5wERSlhgs;!l)9QBEv6V)A3P*g<chiL;cvzpUnM?@64w)|gjpZE(~
z_z6DtG^b(Ll%fQ`IGl7b0Y53F8@d?hmkwv2NpQ0gc%Zw{T#OfZ*u_3@IyVaV0d|!S
zoMfkfKV`tN)`ZR?;4iSH2A?=QmX8xHwpi}~;R!t?XIr0^AMFY=e|?)Z-WC-i{a04V
ze=#Ore!j7)bFI2V?qv<{tjZXWEH45|56zVOOtiI&{gG|=z^U&7ev(~j^xc;>tgFQW
z57w0r%~)5Uneb>^ec`Z6>2UXVL4W4^iNJ3&oAvVdS{~$cRKVw$F-d?2=K-_Ad5aSa
z#%Q;0dk%yfHfaGTo{RE^O<KT-=K}teZj%;p(pLn$!xzrirhp&zg>!vHz>oOBz3m<+
zIMy=9k8=*c31QrZ=40GWQB)(pp#JoPS(#5(wC&pI6AOGEj?lg~o|Z74nvmXlNc;Z9
zMT=f!5fAyi6QMsOfd?h{!xF?p_X_Y(=6X>g1SFkbO6ku1{{`Cc{>EA}y}zOJAM<L9
z&$!b(<a}mtGbl8k`9OE`0{)I4|H&34;P3jvxh+V*-}8f$El9vWFyKTFmp25byLlQ%
zx|{c<%RA2eZUa1R)gCu1m@hK&J0o6zVt6m~H4zDyaK6upC}ZIeINlXxjI=TG(%p`k
zl`|IftGWBX`!DjD8&h_DcSm{|9u=YYE}~R(`i9Poz;{J9#U_tzD4XgGUH%+X?(vx~
zcWLgESBAybXQyN!8-An@k3D@<A2xWy*COfaoM*VF2X8!MLVf{)XILvt_yzcW|Eu43
zCpd*Qh}mhZanD%eo*(x@2Aum7c<~B<0w26V3qADQ?29j`-qRk|G^-HpdFkc0D$$Si
zzWwmP$%aLiN!YN&cXu)MpX<`1UW<mG(18QteO-@nIP$jpmG39u?miq&I<vr2t)=qv
zy#wI&Iv(Vy1RihsMjg*I4ksO0;HeRK-1!0US~^u5{N!gdULJSL1|M(N_t+%9$L?j&
z{jfhkJ}L-q#62#`GyOIb**9(a1txyQ&F%6bmk!R%9CT^xAOCp!+v}TJZhh;vKWaZn
zr?Q%7_N|%PnBn?G`s;uzcg>!^|JoK!2D<-Q+~_B#o68KyXN=!o({bK^0jGH;;3rL|
zU|W~q=VVfj{4eg_12C#8`yZeC=DnFoCYjzcnLe3JdYklKNFkKa34~4vN>L<;iWD12
z6Hq`D)D?9tNc|!pc5J)4O;>l_rtZ2c>({U4tFGUml9&HE_r6KqgaqAPcfa4?e+x-I
z_r7z_J?GqZ?z#5@V+LsNvU<{8+nBo2y^oFk^*wS#UgHA?2I~C7XC9DOTG{;!x@S-a
zjE9v`9)vQ*yW|0xtaTXW3e#u2N+0A~LBb_UDsGh;p6J9lRFJuHM0O^VxV~fmWR&{y
z6_fWb3$&zy<dt#3OGhxl-_k|?f}+3q^{Sh?4ht$Oez{&@_CB0m{nlYLOA^UjL+bV$
z;lXp!ItuYr{!kYx|5s!<_A3lO7Ts%sc@Mr<6vba6@ihNLnES`mzL@40?v3WBIQByf
z-yegcei{Ae6~F19yU6H6Uk=_X)CI&r#nUk!^TYfbacu8VdN8+<eFt-!IQm@<yrHO|
z^@G(Zt>1shaI7E0kAT+{%VGHk@MBRN-VsyKu@CceikH^F515zJ{D4=%AGnDu-9T*d
zsMsQJ@UtGO=#weR`xBBa*8CA2)uoflTxGMaUVHVdvWDxQxVmw}wM#PE;(ey1@^Ont
zb+3h_)sR$k_0i?m{bn@(1FPAa>P^mTNQ;cfOU*2sx_0`!N7s!^E@;YRPjxKqDr?CP
zq?Jy;d4AjNE1Jf&$m)giX7zm@Ub4V`8{UtQ*NeQ5^^)WeQXh-v7q&&^fb!Jf{F%}b
zb^sk57bqR-Ye76f=|D6YmO|-4E9Q4n`@r=K?5!$(%5aeDPHImKe+hArE6oo$Xc@Og
z@L5rQr#KoO3LMQ}$-nYV3IEF5e^)-(=fQHodi=xf@4&eXIGq9A<PV12+o{8%#nD4-
zF90uZe^UZ{bA2zs-cCB*+kv?;tn@?J2hja<_@#($?5M5EZ4Z;>;x?$vf8v%7JZd_c
zk7v6&+xb^M_(0@(i^w$bx-=j64mbU6+|zk!I*<oBGdZFjnY^A?{DkV!1A3In5!R<s
z`JR>Iur7__`{X#ROBuc$d?nSiy`)k-Ju1DQGZ;S<gJXMP`HzsPluwo)=kN@FEC$Cp
zJi|}QaoWBa{<s{cb9jb75rZ%4r}GqPmz6uf&vViI(0^1@JEL@<|Cl7pkMd;ro5RpK
z7NtYwgYzfMk8zVz37bF3>P>xoEd3B!H$-|<|Mx(5h;;N3vhN=y!3)#X{q+;>jo}OX
zS^N&;G9`Y*r{(ol94C{}7pd3|Yd)DgV9h7zALnU|&IU4-wr{4-FZ%IYSbiz48ubkR
z3uxDmk#v+R#0*B`cqtC@2785a!851{QTu{?kpEF`)sXn17#!=%@*m+g%krZgG5ll<
zj{0Qy^V}xdK8)f<O-R6Ti{ju9*aYPh;6Ndi0uHmLbb`xuIFyMacN~E`gY9_!6;BTn
zp;Y{v%O5Wu(`dzK6TC^^kUxqMlHf|xl9BN`lB0E62oZB#CN49{Br1$<?gQ=_y|MR`
zq$Kitv#A$0%>IpKft+c*Xn&kR<@`L+Q8_Ri<;L)n1a@UWUtfS6@XquAyh=g!qWG^N
z@k22<>V@S$qWD^tAL%pvB;xRX0HqId1`i<Z5%H)<zrzX~kV>8Sx8Bb_4yNmf#varq
z25dyF%?f<N<@LVC<tbMNoT58(bZYA8O!8+NnkLNUe}p{KwK6N~qu%T39s;Y&ARe%e
zV3TfY12jMMk>C;UuRGc>qw`oyUC@?T{x=op2lCUtisgTN==?DHeT^~~AEA8Wnt<kq
zeI)Q?f?xl}L3r)?Zzv8H4tx&eukUptj{DStoBH(`ojOKGJVEp0+JfQby(?(`CkEja
zy`Le@bTKUd*oUxsJt651_Q4@u;Uc=zieL18K7{THdVkIpC|3-jJM1m^_0-<7sJ$Ih
z{1SPSaI`CiA5*+1!%-Iue_rt(jkTe4fH$yWVo}30?ewV`T+;LFoxM)(({CQrX}J%2
zbKvFdhMd%IK6q=9C1l{;zaFBjBhj*8EL~6Sgq8(%@>j+K#9Yd77)u$R5Bmt4=-e<H
z>cS}wETHzO7>pl`!Lcu5`47k7`}^_ZF*v>*%JQFx!Dsa2r(*B{`ln;?Z~F5;*(Kvs
zJ*OXk8gZxx<saUE&?;cRhDh&vLXTLC?q=|6;u9x2c#eiXAkUW!ymlDo?pS<Vd+M0#
z(U%wXzIyDd>D%T-mIYI_ws7mXj*_~|#$`DxW^FooW&6a+w#s~uGet{I3dtFz{<_kV
zQf|?G6_?&NwfAbPuQgbdVh%Q4(ik4oRGs5iRxX_H3c8Z<ZS{Qc$8Vx<Q&5?Z_h-uL
z0%t!ZS&=se>d4=ts_w^s#qhp1(A{Q+6R0zJYhgbfUQn&+&;Q#2I?7FOwmM4x_fZ`A
zp*Dm3!2B2Z;S``*<Q45hb)x^9x8?d!J=TxEE63G*KmI2<E-U-bQGCd<LF>`7`}u;m
z!K2?$p6-j5!B36B@0IW%y#Bm^jDVV)k*8C?3bRFu!)Q~`7vbCapF)JBUeSow0;iBL
z{uY+OR*RiF!6kEncc^HXQwey(;T_N#DQK5k6Id2J422s~+?@uu?s#f#Sz+>Tr;T)Q
zS!n|Xq|s?6m<nB!wl<87tbBgQT;sT!s2yb;`)bnq{LQA^z$9{#z>xe`oh#k7)7qS!
z@8NEqvb5i-$n`G&AH3JjEV^`RO~RcOrPQw4?kmXotqT?~VEf`NLN>MiQ8Bj9)_Aa4
zH>~mJM%xEG;El1dSS49|;C4$7ZdYHlK|n>Y)%-B}Ot-9o^d4kybf*m8K-y>%5_8#`
z-b2^{$&b<JaD7X^&2ma9Klr!geI4nG(h-y7?UB>ZX6+~f{w)*j8*>3rDh`s}v@c~i
z_FW7=g*c>B9ORy;uqiqQBoFTuhN$-)9#mqH-T25Jc0TYn)=*s#dvF!s(W0FdZsT%$
z7vBn<Qe*z)>J;uSN5QDbCEYrr+p=`Tl+utjMc0r%f6--yOP{XtOj~qyRqNH0vIqB4
zS<}v}T(K*)>_GR_+b^pT60An@bHSTa>2Iv{)O0q!kUyh2WBoO|cW!|fj_i~0X~cP#
z6pt>jr;c3O93I<RTi{U!7cTOqc#}<S<Hxs;88x+G?PJSaA!{6!$tt)%AcMB8JSvMb
zM8$9zk22_cI~0fUi1{#9!FVLYVLSpHY<HD-FU57#E5XD?J7?J&!YXxi6B?Qum?#)(
z6;TD~L$<Ve8YB41-vti{FPu5}0eW?!df-Ljo*`ZjzVFM%akb#VFk3s_ri7M88<E};
zhAPqe(YH6LjpWmMA5{E6hT}NK@WaF4M`Lh|pJ4gVAP)2H=-Zw!n#cNR;D`&phQ|zv
zj$-U>ylGmi#hg;m7^$0A=L^=)s*s+fZH9+3m$HX4*FJGg_n}5*y7a{5nzjkou_rF4
z(-$!};)|HKjBACikn4NBFQWXM_KmO~PS`7W7B2yr50oA~oxnOpc;k@vf=bxZ1#O^}
zbIYws$WCH;!-^PoT5c-cfW6_Liz@4YtC_8{vG;q}7B=Inod&mAIZ>J0zNW3I<fh5^
z1}9}OJ?)n+Kj~~Z*^O)_?REvkuXKL%be+Md{oj`vj9U%jUCIZjO%wn>&~HdOhIgjn
zEp60s3E(g;&4M40zY)ej*&Ex?Mh;5&Svd}E<gkSAljGq3037HwLfg3y4AY=MUFCr2
zqfgZqmk2{NnF}Aa#uu){jQM4y(`(^<%&~d!J|=l!aHCmz!E@F<u@6{Z^J96FNy(0R
z$C`70{h!Dyl?Cz|zJOQr5YKI2z*o<OuWH9~!Qb<B!Qi4LdG~#${wwX1P!CGQR(>m$
zYd!GvG1XfI#SbWcI3#{B2FEte@*f@sKN^GMc*XLch{16@Vfd*Se1QJx7#!`0<v)Ws
z$dvLAZ@+4Au1)%f9Jp;@pshxG3OpC53M%!<#S=>wUuzUpSuOJ`E2q}w!^^nM>0Ot1
z7cYK%<Jb}FPIb?HU}b|Nz+II$xi++F+3vRPQ6X2r#hPOCmY>~x>FG`5s;@e9d1)AJ
z`QkDhqV8b(ALARvtS(^t2V^qGxiGCGc|-A#499f_tNZZ*negw@xiHKBE0(`+JL*)1
zzcoOIZ=!Q#mjAZ{IONAUGQ)o##gR`s7ezb>Ee>T4`?bg~${yN0)<dIc8b<cRpFL7C
zzxqX05}Yz~UY>4<<3`yt?_OSeF+HVMq*?j=3(gkZm@r|}bE{;^1J^jrgVUj}=V2$#
zsHlZ{1fdV79f?X^LEx=;Jr~pQOQ+H<==agI$TK%7;eq64d$AAf>z%(PB#xeafBnK3
z6T5Bswb=W=-qeN_SUGzM_WsY+G&=(1z3kCGPN7X)wai!LylQt}q~GRh&p_|r-1PHJ
z$a~HK=>6ZUJlYM`H((#C*Q5FqHV)Va=yd?UIf_G!lg$30FO}?1d|Hmfd4Y%FynvGF
z8SKCc-s~A5AsS-`jf$NZfT^B&sCM^VbwA(Jykhc{ZrR(9(}rxI-_;s~2g@%Rn=OAj
z^8D+A+wpg_kN&pZ-yf0us0?YpiSupRX5eJ?ko_h+_rY-RVsbC3Cqw=!Y(ua+vx01Z
zxlX!xFZYu0tfCO)iWB4L8``iKk&f&QO!tDum^Zh%=VD&bJ~VjD`kCy#?Yw~pw0kd$
z9jcTqvWK>*J!QcBwTAk$8jx4;y}}X;WRU^qNj@9E6~{Rr*atz+B>xoP;M+l8VJw@{
z8B<y>Bb?QR<Y1AqM7*&F*{fcA=EjVvJ`I->n0w>+Ah&wkww{e#6-hXMO5)2uYyZlI
zxcKYrae;;f4N2mNBjR$h?Fi)u{9Ib$M<7#J^WmHW-V2s+ekJuOP@KHM1^eq&J&+&j
zCFO^D{r3P4_43N<^&|AGlcEdjg)JT*kcJr0!PUxWTQMp*%j&mR6i8JX-P>QID<@pn
zo-3$tHYbjrwo;sUM4V6VX7z#im{+NMM>DzehoW*<uO7e^$N5L2{HdD&uZhZiFpq35
zN<|;t#-y{;SY-&$iZ`AUmr;Eb&EGbysY>AT{q%A6JE(rzW%}8%qi2JppOO7FDyNUM
zU+dQ66YT}VX)LN6^&TqgNla(aI>Nh+9Mu`c$s7EUsLoWc4CE*8^K707wy3^#00)^I
zkjdmnbR|V?@jJ-mLPcIoBpKsYw7N2_K1Vs|_B)6pR^3tajoR;3YV_exqp~=}MQEM#
z#XU-qj=Sh21FzII@B`Z4VEl9pj&mcH|4a;ipdWuZ2FE^)<v$vOW4su{560j)S7Z1o
z32%gP<V(00Er2&6L;HJKnl~^U=`;Lr432y<{7ei!kpDE|P;W{Hd<zMRYOrve+ruV3
zu6*H9G-(V9)73B@T&o7F?Ds6d-w<G1QXHW(`(-zEU(&KLuLn=gHY}et##5&C*zM^h
zW6GgN3HYiS+wx}bxwNc$#eEC%+8WB7iHZ4KZzTPJ2Oqklrjk2#zIE0Qy6Y?{xyiGP
zCa1?4uAf#g)}QawH{bN^)k~k=I?m|Ja+RTb?f+e#h2vDt(Dq{FJmd<BN%>nO53kwF
zWzU_EMklkzr`M;ui!(k>9C!WU#otjKdj|BeD|Ym1yK#2mx2onm?6^St8EltFW9$#@
zp4sKW7#!`M;inkh2c9qGIkgXPbechIMBgGxe-+|%t;_H;B!S^DkCwf^4D;u^5tr!T
zz8A}XvTq^KBZ`qQukL}h8hG01qd3%gZ!82ygi3v}x1=LvS>=wolWv%r-7}@Vc3DB$
zkYN!8J<46BO=SzWPwDOEZke^Pyr9=PM2rMFdq8I3vy$@;>+v5Tk9{9PU6DukkUV1S
zei599wfe~w$kO%5(o|rn2RclWB>q)-rNja}UQJmj<Cow0!V7oOGUteQD38#1<#|-T
zU7Q(ya*8=n)?I*O94O2*;FZ$oOceam*y72mbHwS)Ecg4$GLn)q%6$IvOefEMBk~-{
z^pzr33K;$@hq}#yb45rmprGZD_xqMmy*vZwfvN^@I1jW0#uiR7RlG%M1>B5#T4uJ5
zLd(Uun&hbhPct|aWUk~d<h%fH9FhFVFQ4mo7W22s81o~eUk4?hG0&YpA$f%<Z!ba3
z_tN!xXCK<$fxauL%wTVl!@C3nicTuCgMBM$ei$veS#&I6`46-F^z2lVfNM&IAD8gg
zA%B^GYgUR2XC(Z0fak$G*3tZ@B>XMFBQpA@Wpu(UKWy5<Eqan{hoO%WC9l%)pO#DB
z=(}o2{*OxZUj-eF<T>OA9AJ26>uP#t>lpB}QFTt@GpIP&cMqwD^b`0Uv@Ip18{j+m
z2sDLrQP7q#!Wp*oY=QrgZFF`?UJ`Ly5BZ@@lPe%Ud`B(riXLW9*f!RI{p=p#0qo~$
z$}^J*t_^5iIHkmM2+C$LX{?TYlqat5F}M{O?a)m9LTqS*yE<^<4~wfItUNeo&GcZU
zFHY$Ug(99rwD}5ZHq?wNsLlVrVdb<)T>N^ARu2cX`OpOo0PDx~y&>MgrPH#pw;5#9
z=HLa)Nb(}i{^kV5LGhpL7{t{2_2+h6XxHb@i)}HCkz+?BVRL;4K@L0r4mn)Giu7uz
z9K4AnX^6J}UE~0L@q-|Tc5259X}dbycRA|6?>WG&pyOotV_0c$R;l*hIAv05sKA@J
zVMEUju%%(@O8eE-d^YvRT>|AO6)!2aP}{i;)>7GYY+?8@91}1<#c{5PIGm;02tO#D
zjdD6Lwm<^K&&qM=w>M*b=w3q?lv@OGb(tK!qc#TvUumy}Gpm8qW#$Xlphe2<b#WTI
zKSBIj=kb*G^yDPD^?io0_dW4UAkFI6|K?QeIA4-ZIE$66x9ddM`8a<l(LyS$Hu1)6
zhaMjMd?{uuAE+nDn^Rm$|DFt$y%*=m{0b_kLw(?ZfcmWwSCbVeKM8-SZ!xVOoGRi%
zfDdlpp*=n8*7fY+cJ?mib{^rjV#o#3Sq^P@;{Y9K!$1e@;b-DTE`%``ls?3-Qu+|T
z+DG~7drdscr4D>2yeEBkpSX{kG=QtD5?>&1t{!k0$p{8Nv#zH|YED-2=pJMcSybva
z9}zRjua0a!!Wnx%g=G+{?;Xkm19TN#oQ~EP>_U|cJ~-$<p&Ns(5jaf-8<_a-z_bBe
z;!vJ6fmpRCPj5)BXc&_-ca7K4GG%W5<eR4F_Dq?WT9@xSH*s9?%ru_M9_=Yev0geg
zGBU?j*tugSP8H_OcjmX|;cp9P73K6ADPOdFI_@k1esI6=O&N}JeTJWj;;_a=ekB~@
z%${ZS5bssJ26!FVC1W*)X*@DFxNbw3r|{LU<n`zovZ{loq9y4UR_#Ioh#7-y6)bd3
zUqs~r-(dlbw}{F&mem@1ToWT$Q3GKm3^;VV4maGnUs7quaA|88H$8V8`UJ1La&^zL
zkI(HuZy~qcou(lLq=QL*fW5q?oFs0IEAV6Qb9bO-?(vCR#q<g9x%|A+R0)n5v>nh9
z%;9iuu$1XY+EZaTuDck1GzQ1H0mF|+aX7bmj_Qu#FJZ*}5cCg3^V4$C23Y<xQ5@&P
z19YIzx`)xhx#j>4eb&7azE6&WzY=h%FFOqRbMU<AQ0}tml)2w{uu1TT2X|4wrn6;K
zgVEbKro9kn(5GV5of4fWgXG71i$YeMK8qPxckvFD8OE$=9lLlsZ((=KQ<>v90`oMy
zB?$7<JLhHi!5AEM!SWxD!BH0sKOTeQJdNQeVsM<NG5k~vK0yC;434(J@;{3>*f!-8
zWNTJ<LDbln$mZH+cGDnTj&rrkpIqP4vi`~C-A}C_Idc6|-Pc`v?R7V-S;L!JH@<ic
z9)E7#{Nk!>UfkGv{_cYhK6v=Z4}W+Fis+XG?mMuuKl*o;4L;6tYHPG?utB+ga1Vyz
zZ%BLhD31^6o(jW%#qhqp^bG-wQ)2jAvi#%eUJJv2E5pm_UJJv2AH|U$I{!c%#v3XN
zCA1hhUjzC(Dy27w55adcz{2#3a?lh6(h=$-VF3hmRgzj%SX`1L+i}rx&<9ah3a*>%
z%EfTi_>|sXuepJ#j=V|_!_`zScwj{hY7{kGaoN5(!IJ)yaQrj(oCifxg`O{@C*WqM
z#ZTDy#1*J%)cj>9Z=RHBt4os(zeV+}!Wbr6cYbP2-LRjaIQYh8byi_)6O{?XHXVi7
zCiI=l(|e-d3F~9<-}K{KVsP9Kq2<6niJZ;=ezP1G`uP%?hQX_b!K-6%j1OhymJNf~
z4ujXn;Dg#rRIc>C21dUkCjW4K1g=kLe%QN^$zh;xg1rld=l31w+1hd$?aL0r%?sE^
ztP+p$8Q?c!``OXB6+BU+QipN%674lo!#KYzuw#TudFk{T*k>P;5BuziHTN!=v}Hj_
zb@%-XrmV`t9vI_MGN#-(ZTgzADRmY1Hn%see_?I+i#x^_<%%<e@!52|!Ez~|%PAiR
zOW+5{f$~H3g*e&?j8Cw}`LdtSTxcN|<&&OE3$kh1xAJ@Itv&14U!3R7M;0$W!k1)I
zK53i}l^4b;48zBefj&XlY4|oF=41`t0J0TTT}-N-2OD3C30lxcWh~Pzomqy$C3bdf
zj=G?Lb7fS$^yr+7JFap5{zV?2q+n3@o05(@J39BT2&PI59lEpYfy{MNnU=-ENCx)`
zQ}xb|n)Y@bSM_s3^@_@*`o=Xpykuj8AE58i@CWmgUkPhAh?TT5e3iJG`!mQnpuqgF
zwnG0L%oi+Z41oLK59D78)xk|S^}w7Q3>8A%*X7+by*bk$m<{?0S9)zEY}~c0=Y|_@
zP4x)MaWgLUo;K;@9oe<%6>K|-yp$YdHV9?>nc5)Z^^C;p6|kO=@dWD$;0fwLaq1_*
z`~k%&$ggCnl;?4<KlmQ-3>I_&&*)|vVv~^aKkowmPhK$Xxu7y)P3)|P=aPfKBg|;H
z_XO-OsGK<^lXD;Vq5#La1I0-n!)g3%F2z?u9Y9}F`^31~Tsp=v{O~aN(I^h{&0IQ0
zv-~f?;tusl=>T2@f3WyYx-&4;5kByr6z24w;p0Avw;4_8#f`ZmCuTNJp9vZ+y5!Ez
zq6IVCq&<P+k)>HR>E_Jlj@cc}nFVuioxSLAxw71lXi2hE7x=RS$-eZO_UhI(9T9K<
zN*e;!K(-?#2a+=D=ZvUXJ~`4<Ms>^Ti{l65|4e_qHp=To-p6`@oH74ARg;uIpg0Kb
zB#4;WaFvvntHL|XDJ@~UoEEh=#37Cu7r+WE3FIW+t2_pBnmEk-n8{A=$d?O??iA9_
z+)7VJs+GqEThK{gOZeM_S9*cS-Gk=V8qGyTIc>1;N7sWqU}?j>O!w2Tg?eLOe>2$t
zxF6d7AB0Mf(`wo$yacL1Sp>zqxOV^tw_fOCcjCg0AJElS5#|V?H-X}G3g<}>7W_`u
z(#oOkzs;W2d8x(q!$QGjyN;N|Pjb`kUb`tytJ921$x>e!h_b=DZ5dbPbk0jA4vS5E
z`e^T)dBxfUtyYV65CA(Uq&i*A>P7@=9|7n?-ez?JoFnhUgpcM2U&NOKxbR*-zE2q(
zz*Sbnp$mKz;v0Voc(x)>p(u&1aD>J&4onW=W@a=KDcq5i1b@<B(ZA8a#oqrJsBCNT
z)=}fH4D6vxR{Kpi^;qSVgrLRqKU*!;^XlxJ(xQ)Der5A7SRLS;>QP$f>w!n5@H_`U
znJoARX<tHd#Q_QT!@0gi3<o{q-v4#c{D9*;ndLt`Ku2h#er-noj0~@&{V&UZN=ARY
zfa|X7DgEOz`ZY58r)6~H<sOaFf%AN0S-pTx5b6bd0>8((HS}DcpQfX|M$3_KsNXK?
z$3`6d*xUi;$EM$d-y71MK-WxTmM-+$GS9Z(*l)a&9%Ho)p$oizkSF)U-96V|FQ&w5
zb;I_4wR3Om=6BQ0m9osFq|7q9*>e6X<~L91H)K%op7m7yE@DR;7e`<_WPDdrf4}4e
zgKhe6<x+5dJ6BQP{l$4;HYL>1@r>%6Q_6IhFkow>Zva>4P#vykw#kD^7#(#A%};T~
z0SO1&RR1T#sqGw;<^O=%4$FU7hQB~<lhHpT!=IqG$?~6)(SMEF=6Xv1xGewEGWw@w
zxV+q>Q92Mq@e5WjYGcQF5%#&D?Zu>{ZAQz1bf`DfPh+CCi8$D%kj88izk|^SbgbS-
zZ4;x#{vO->R!gAnX)u_G>Xt!f`!P<>#L~QUn~(Lp*coluA<iAvkjbM(Lb81w_w25}
z!=8t?Z;}+Xa>>p?29=5y_~T-B{@rV=-uF+`aM-r-o$4dm`qQ+{P+R1bGTYib&<04K
zgfD|J>=TM_p#9we#RIg>48{+};Mi}o{D)(3T*ET_L=298E{30q!3XG^j={g_&;O+2
z!6-kxRmSJDG5Lp}55CJ!=$;=f7yLB+bfCWIH)8l3G57#KN9FXXFNEd?Ux-XTv~3{{
zZA<ZU*0y5OKaQ5ex5wbU{rEH~hGChwMb59{gyQhm0_bxY#Cpo=0kNJB(zd+}VtQma
z_*x&1%1QZ&3Vkh<U+}fa`9)s~!?z+1{roaGkF^uz1p5-w939VK!TCe@7eYs2&y{+q
zN@6$5g`LvocvpU+vF472ldf;i?wLvh2Of-`tP)R1TjSXiYTL>#***m~b7n0pE8xyX
zx5}}8)c$bILiqw82jh2AtX+bSgW+(Zhqu!{6*ty6#qqW91L(woU(QbTO>y!*;!r;|
zoIAjMK?uPO4YdsO;~^cpnO*TmdoAuq#|O`!#c#w*f9eXUUN$)5;vL3U)hS6Y44NGC
zoYT_#hrAg%IWzLO6pIsiGQpltgxc&T;01ikWEbUiFn%xwM;m1M569rxwitdQ2FG;^
z!_P!<*t?1Fc+QdHuy?aVRxY+Jmj6j|JC%_NWU2!h!QQDKr;zkT9Clcr3I}!@i{UCu
zUiV3|U;A4jQS+SE=XjgU5f6Wo?2La)YdK^K{#iWYGLZ#FPonr1oYFUv&-6y|K)_FQ
zA<+r4pk>f8Y%`PzD<3H~jp0}~hM!mk$)GnL^oDT*F!LR9&tP~q&HTv0`kQo7zCReG
z%HiuF?xS*4fuG7l^$L5zs8<DxhZ&3?jKNW_EdSvc9P7^T6Np3IDIKW0O`(W`h6vAY
z4l>dR@9BMA8%%lpIdSf9-G0sQw0d=%N&9n62%5mxe{m+0yObwfrrwW|i(RggWX{a&
zk@45h2gFE6`QFHTpgf5Wu$RYW^~AX~<L`KXeyl(Cp%jPn4|`?#u`g!%PsQX%J7xHp
z7#!`9;ZJ@iI)mhewlzo}&r0+QK{*{%Pg_B*;NO4+HnvNKqZ}B1GzLdL8Ga@PAIN_=
zio+PwLFGpCllRLc`mjGH!-e+{2fY@;I{ygGuMjSD2=yPZhcH(-aIZXqR-8R9A0qK|
z`V5G~>z!dRkdH*8GTx*Yleihi7^mPuW3H9k^mLcAz|c$kKG3J~7V@=l4EEUbp?IBA
z3d$UaRikHZan*=X$MSRLWI|@KSDWN?rrE>~@~>*lA6w#Xb0o#Zhg*t9O-XLNvLoPg
z`je9_#v~2DfYa(NTARseBZV0mzOu2|;^T=nyWc;$#Z{3X;0);jSTdUuK?XSIbdaw}
z1>;HhSMg-vv<6E&uw*4g8R@=K8B56(1u-lEPc6z@xE9rR@Q<fKyjZNiw<zjBWez;L
zCv1%T&6r{_`5Zc}*=2I3THP%LX^j!Lzj9)JZn;CrTMXR?`AmI+E>M~gj(8I-wkwl;
zDUF>qm0cq<Qd|ymBKI}eLptcES2#@L@n!z8m}4w32GgK9aCQDvqthjr?QUCfZegC&
zZ8d|`3!G(TWyyKd8qxv{oprTy!h$<a3({__Z){C8B<gEDA&WZH)KynDe`H2FR1bBK
z1@+CM^@UM!&{@18&$p3vSYJQX*Xpr2L&if(yjqQKOlf*!f!kj(u^?Pz6HHKDe_2K<
zRM%|gCibe_VSi?*3G3XNVKd>8TPz#u%=w|t8oUcbItQk<GMNuPF^by~a9C%9#_V&1
zvo&$$IY}W;vfdUKaaL4SB$v)>%?yp0TUFd%8`L}acXb|zAtPg9ac+V>fmJ-Ec~NuW
z?3N6F&Ghm#Co8|t!1+l5+<yh0DR%UE@X6<>$mPY4){~1DKOak<bV*F%i>1OlXyLG?
zR_-QSRhwyy61d{wNCFEmk)IX;J#QqL!L%zcKjbz$T0EuW3oSmgDm~!MHLemDl6`8y
zWNx-+k1BQxJd8bl?$2CUI125_N$+Ks?fAlJAGpaFLa{OIy4Vb|)WdxNwBw;Ddv}g5
z`(WD<E)8J+(yd0K3wk_3`2S9Cq{e4gTT?ydIgjWqem+n>F57NS%o{mrWL|K@{Mwq1
z3U_M2Xbpri@&c9PbL)%v7roA8uQxf#C%&jp5R@iUyh*3=a>06?QP3D{X*JmnrCO`k
za6)ovVM=4M-=13F3}opNLhhs@qpc+`tuD)vg!c0P_xcgV1m$k74B8^N<YD$H4+g>*
zVq>H)xh6ZaA=`1#=eCE<hYksA>`rfSYo>UNwE0qCAlL?73AC%FU|VIX-5@bLv@7_s
zL>31?V{TIqK5KBNS}mbugCRL&v8K8W!p)+NeEx_v#bq$KQmj^%gzcp79QPiv0KGx6
zj)lc6*6{-BN^|z85=+3WN-&x13Bof5cgSi@!J?2ZEy@{gEP~5^XK51!U6O^I9im(U
zeerH?F31DomCdljQ!K^h;5F)A9I0}lzk<i(gT^oIdb2P|?Xui+t;wgeXg1z$_6ifB
z8}c4fZ5L-~61M0QPxy@*yYcHp<1wB3FDNIX7^U2;=mGi=CkkDivFD&_d#?(UAPve^
zwn5(nJ493$?3M$1&vYT~TtI$Vq>B9=S8YLVl`(l{{>(WCtKBJw+yS#+e`twEBP@1>
z^TN4lm(E2sjY#p~4}Vaf2+yh-y(nMW4~~YizBO)xR8%f#NlR;4P+7TPWLnzD1(o?Z
zIr#-SIl|#kb7xKMg67oJ<^{Dioy{R}{)mwy8yZHA905gO8GS}>G>QBZWspc}(}J3s
zE-a&~re;A?syHvUj27-QZY0bxh8jBu?Ja}Sa5?d1bSyC^>wRe^gSV|r8a#0vIkd!J
z<K<(g)zTTr3IP{5cG`?Da3^$nrYrITC^y<}>}uTHq}!gXnD?F4=>fY|W!3n#-ju{c
z3*lmRVNzy+=_VWRO%`9~j3&D@2LBZFPy_}56mTB}I?VpAabVM>81`KF{;~M}1WN)m
zL^JF_R}}@_Ws^&iOCs6&G_}R3w>f+czav;&RUC8{jVmsn?-tU`aq)3Jqs3?m6lbP2
z<R{0Q?79YRq83Kf1e4id3036>t8-oH9<)O*%nR;SmD7kGn47VUjv4}MFuLtc7vvyG
z^b`}#*okR6(<HyjJAK_cy<Q)$)x-%!zOl+%rnL}-$=GOKnS9%-zv(P$wPvy%`Uaq1
z4`XmT_#atMG1Ow8OJCwnRC^i=GwX942fZHXdf;h-Pu<DxptpErCK)Fl^#+Z4g8TRI
znmn{wj4g+CEl~#91M+l1jg2?LMSgPkt2<0izE+c{QtLJK$|NHa<BSH~PXo0+Uv2Ow
zIs?)%Li?KnbZ`$9j#y$-591yX+{oWgRO%40_5(#Ir#!gH8aG1F@X9!$F)n$-{o75+
z%4{KCh&PrCNrpzVQz%s@2mll)owRh%2j&#BC1gJ90Yk8y@suPNR=!{~o6Tq3#ZG6D
z`$ZGf26%Eq-DU$%ur_Ah4-BGoNfxFWi1tt1><3LY^%Rw+US&7ldF0^-O-6OQD!xoG
zC*Jdra<@6*4zqcAf|;25;<USM_63RYJwP7l8~S|Q1XzgyeSvmwvGl76)w`OTAg6!$
zA)v2n=QTp9Hu;{1{%A_L(`@e6GV-@;?FkF)JwV$8ZL<}4?_Woj^otScqHbEnPqYsE
z4PCG8HQV@BRlFc1s9Hc`prEUg%)cRTn-b0#Q;g=2>FGoWB!x4iFwVRIG$E=L?gdlA
z*%6#Kn1c|`^oH}5cg2nb!;jyBDEZl8Z=d3(R&Bscls8HD)UAZ?fC%+5pl+or0ZBwy
z`2jqiE*>=cboPLFNRu0Qg=_gD=u~!RE-dSAKYt5-Ii1Q2A~NV*VK{RI9{|{Z*#iq3
zhztO=sG&;IO=WRVKowkD#wC@sXXcIZy=6<*3%uTC6aUATWzQVx<+grv%55P}i}{Hr
z@HD)o(Ik}x#h#>)+mWDi`O}ib=R@f_mGFyBcZCh&oNf9vOE>I+fefaAUndjl5`sT4
z@Lmm$ZV21L-py)+*_Ivtu7<y1uvBG^-FtSA`1zi{+&T8K%-rC(8)g&ToEygnbAdqb
zSJ(aG_I9=SL(-vXzx@~MICWvFIC0XA9YreTit}4lg&j9eCWlfBVa?k25R|E*ck;a^
z;=Jf1aV~v-YZl;USmRbuKZz<xOQy%XAugBkg4?9n@zTgLk`gK4*+Zi!EtNSxz4znB
zYdQ*>uh~C+`u?k%3#VVx*!xLF-urp;@}})xRB_p}gunfEqI`B~#o}Gl0DOB>D3|0V
zOupga*_Z!tNpbO#A6`ED;Tt9=h_B^_HpQuZ%lAHc>5eb{qqFlrzSwc;lY5u@)N#Q7
z9N;sa`hQ*n87hS)aTKn_#kqs<s@`8ye9R!cTEd@2obInPIyGV&=I`sI`7w5j;bjaL
zQ9kkXOfJJ~B|1%m@cLos*Gcqu(ENB8Afr<*;q8FO(U`8+U{eL(-r7!m43ov>P%g$?
zu>2#r8!4Z2D2_e`#Nq8NlmmPxrHgY1rBivx(#H%+r*e^{Ka1)8@`1Ovkk5hizE1jm
zR8H{rR&2UBYfw6s*TDB;)1Y)JH(C1N@~Qj=(rLWv5dmZ4UI)H7#Yb!52l!+#Zj-&y
zL~)^X7`$p2yjqUa`ZGE;a-7-$!^?)jYlp$><+zM~og5#wUT8P0+=`g|=v!lWWeko!
zG>R)u#o*|JV)*GOE-vSf&=@Mj!H&o^OrD6-_J(+n;R<d*t}*EW0p%)vJ;e6`0p)u^
zdcPb30?PS<^nQ5<1eEv1(oyagOGo)%kS;49^>9HtZI@X8fKdJ|>8O_rzmMuC*e}1R
zo|^i;P+m^;4gD3`@oe}3cFb^W-xL>`hQX_b!K-6%Y^RJ)*)VwRFnE0oj_qwIKG7~2
z{R%0+34Eyqv|hhq^|~5<z?c^XyoJViDPW(pe;I^txko3((peV11$Tn3$nPmH%}?~?
z1>4qn0%NDnDaJh_@tE=t>?AAqW<%{fgU6w385Jl^vtgV*l^-h~<%i|NIH7oCNW4n1
zXGpvnUOGTMP&(8;7@Zo$?E^TqONN)l&_{VQyjHPq$o%!N12+`?x)}N>Z=?fuaW(vi
z@<Z*B(XUXPli_G*46jr?CgIEZ0xEBYk5pVYfYWx3IE)|2KU(fE=~PY^NvHA}oZc@t
z7(cLHgVX!v2jj<(<wxZh6sR08@;#O3;B;B}RIY>5`{fAj8bYt6+RNmFcFp8N<s8jH
z^#F1eqVmS5E0DJ=y}R#Au9DjS?-5sg)CV&Zm|yG#e4p?s&}I0?h(o)e`N5}e1fK!!
zmBJb=>UinyDXy96FK!Ih&u<9uTyIYOh*8dPvMzi4Wp(u1a-cZ}z6Dp8w8xbLmm@@v
zn!#&!wg@*TN?_*9p3|p`YYz02SV9kE9+_1?0_}_OjqQf=Cp1ZXe?;pufLBTQZwBGj
z68<{i<EZ=@of?Kq^ii)2FO%~BC#5rh*UIQrQafS!>t(o{ew~C5DPNF#6VTs9_08yv
zkn-ORc%zKZMutm#qW)R_atY6%d=B6h5}o4|M|)uTD<%A8isLv;aX1&v?BE58<2cOl
z(};r|{1E!bzkn`bUDB^hSiA-Uutag=$}wgu9W=}T#hO;0k}<ZfAhCE;`^u5=>T3&2
zd!|kqe|fN{uH;eZ8|^wr!RW~3j@rx_;r}iw;6LoWZ|1W0vE2IJ>=Cu7^QBN`9_<U>
zLt7O}rTsI8qfQuJCgGPu>>i=EeHQa8K2q$WZHD2vug35bF*w>h!#|F}(WWR4eUO~a
z0A4i=UM<I|4jG*qIZkbd;bp_%wZq``a$H8gPL5NXV)Pq^!AHn(8J$KsE~8UE3|<j~
zqph)WD`Rl9HHyRe8M!>s));;oaTrr-#bd%NFgDQpqeJ}x|JI;%y#iehgR_zyB`UFd
zaA}MOiC}4}T=B?>^!f>DCG{WV&$w~?qN8gX+wb}PO&{F&n|)J?=Wm`=7stgJ<Ht_V
zX<s+)A?2C>Xk9rmt9e?-^%KKmZa%f>x}WZ7BjR(UmK(d}`71l_UB56eU*~h#`RoUm
zja@svfTL|;G4O})+vP&TkQV2R8(1O3rV8|ub_ged6*8<-!^pF6XM!bBGkx#tD|>Ex
zb5s4JdY3ifhr4@5!Bw$3lToR)Bqi`%%~dO|s@e6E8|vc4CrN{L+>OUC<Mbw%PcM$$
zve(Lg{EbnQJ^6;&W1)#;*}P^AumWwQ1>!INi`x8uF`Fk4AJUJbtx{ZQ8V0W#2CtUm
z)HWEM8aYmFnBir^;I+fx^>SQBzfO)*+hg?0hrugiaI`&^zcPx$Tgv}M_oNv<l3U2+
zgE;M55QljN=Erezm~<+qi=<O|4NmW`7tAw;q>p_VE1$}5@b~@lg?Yxed{5;$_<LFT
zRIY>5`{f%HsC+MyPUU<-dQ{#p&ye#6ZFoQUu^xpsl7KrMA-q2V8Uvi~H%AX+`Dsi$
zcju@D)lO%1=ctc9y5*I1mCbMguBcJ|s<-r){_?Te`Qu7F;v{Zu_2OG6c0G7it?=M$
z;wq{?q|e@+_>9{9A;l{chZd@ttTusM|AsiY0PmLJc*hOJ6(=R!-uF3QM&C>OlF~UT
zodE{=@ZKlV`5#7ytc#WlINpCiad@lp@&TN_jll57WAbCU3_mHumry$BD24aSAZ7r6
zM&FW*2hV>d?O$+1swA94@8na%30Uymb1FXA|H34huN}GK?m2VrS}{_q)U|fsIdkTn
zD_V8r`OBWa@A~Pvu}@8MtLEReq^xYoUGslDYuCc!;)T0raVsJ-*FW&wqCrnh!rbKZ
zzRv^~l|ip01DFLyaavc3!&_Qk4d7Ik3_lrz`#=T^e~#gbv7p0;Fh9Y5RjD|s_#!Gx
z)mDnD0S_vS{M#&@gTJ9~3&A-55lzQV5WhP@%LhvkZct-6BI29^-;{xLuo&ed&<DiB
zjsTv~#yw;-#w6G`W`-Fok<3!f`g3qIa_+Gm`qa9D)AyxRW;qP0HM#1!x6H^gX110^
zCRO_DmTn&_&Uj>Wy(>S(B7V$0E`DJR7y0bjLF@k1`i>%hbA7R18?I=}AG^FY1quhg
zk&k@znGy88L%dEZ`~chlKDLR_RssZed%$M%30Pl04)Yd<D^4H|bFmb-^RWuX$1-Uj
z4>$6`OUt~TxW^NQ8^@qRu)PSUZ(#w;e!=r)Fi{Ivmmj=(_O1m*#&B)!q=k*kcaF_k
z&^0fuS?{rDl#DK$IcNUmD^|?Cq+?o9Yf*~9=+G&5mNsXPnP2R#sf?I>t2;)m7@uJX
z*X2#O!@baxYO0&|k0_1Q+mdXFHp*W%!~rz}f1`)yFEz{pb)+pGWEdQ{7iGES0+z#5
zvong_>3Y3SW0qny$=_Fl1btp(OM=PW$-+1f3{e}<0hKkz#1pI=r#Rt)AE?W|KHfrg
z2D?nCGsR0X9Cb`_h@Ar*bVl=o8Bm`(I2ejcRBD}44gcV+C$O?osf$ahl_l^GiSU*l
zfwwrgl(Lr4)XQ|)?mh6g%|__om+Nxec=r!C)n4Mt338Ef3kt8@XNAi$dLIEK-^Ue<
zTTpcEJ{!FgnDGg7FNvR1F??dZ7@sGiIJ8N6W{x<pUJ&=YkMR#}%S&S}>Fzu5Kj<N8
zd5~#D@V=|oh`+SuIrD7d&((47{?r*Uer|9jBqSUD+f?A>`ESm1mBIGZ-d|^Ca@ncV
zQ+i+Id7EDx=V=H8M!3n*05%1b8!&MW<fer`V3OsB|Kn@t%5yz%Q)Ca>fs!CEi{(5g
zUQ5=)C!m`~_~rqsGmtjwY$?NmmN1^;tY0_*5zUxC1KQJ8ibIc!`SAzfDv(7EZLfaB
zNguc#F}<$ubFvI{A4hK;L)8T#yu_%KO;6FNNt;RcklvJPPb>9#OVb^W^ir>{G|dhh
zBQJIwnK$o92Uq#^d*0GCha(MAO4981v=S`$O7Sn`0p$mvn-b_DlmvE4xmQ3IUCRCB
zW|f1k#dBbLtHf>t`{8W(<MF(JYuczW7G7&j)tgdGh9u?wwu2AeS(TfZs!f{EwW8de
ziTf1LGxBRxYB<?n+xIm8ThQ=Q1&R&Jou%AC)<T++)GFMNCSlyGEI-8{ja-Ups2lNN
zQm)bh4fG8JS3UQfN_*~ZMhnuEw?SHfH2(_g(9FTECwy}i+&uLncZ7ZeTUl2LW4=Dl
z9fAHE($*@k7k<L$N7L3~8lQiZrYXeVDJ^}gFin6xIi=<NM;q?F7n0z+i>4_$lorK#
z{0`o7r{A65kKO3EefJNRH-+3uexcMuOoGBZ$R4J+BO}5P3gGcX8q>lfB5rPC7^3Rj
zk;ZVi0e?0CPaR4pd6VBU)b|~OzgNB){XP|_K`PuHUE24VYPawd*k(SogYi&JdXW<L
zG6Zg}p&<ZKhbHtrEFvHpLse2d_$E8pv7={NA!e_be=9NQJO0ft5<||%$s>u0quL*z
zvSC(!@w`nFCSRXkqcZCCc5iODZJs;79v+x<>G`RpUEABI?&vBl?b<Q5eS25wnXXy0
z7A~AMt4mm?cYM9hU{&tZj=!e7YxDRCTRY3jvZiSg^d|k~i;5<cxDAfP-q+hUFRZ9o
zxVf!uOBemw)!p5-u)CY-Z;RrW%KP~%aQuYl*KBqHT@j=R7J@1@mzY~xnoAbjE$2T_
zIxKeXWqV?x{Yh=Wa+KWDN$x&s@h6}Sybm;bB^nS+3H@5AxFj_k!rfJ6@A(hl4VuMB
zN!)F>aBp^s^Nv~q+9#3L6A69`*e0|aoU`r4xg0qQjNx1kV!emJ<?ovBRTo9`!@Jke
z$M)xk_rxSRk44|3hIseAs?sP9@ymD7{P4D(>W{SCze?q{4T(QW<T#c~^Fz6FWcjgN
zM&~gyi{Vi2A8ENP|NCSv#bGZ?P}6?#16r=^?wA-{cGnEx5Km2Leu$?&CZhvu2!?~_
znaQ&O-dj`iKZxSweKx<tvlPN8;cdYGQ!00dA`EgHj2}?QaCl>0$`9q<D$D=lC=TUH
z`JvoVv|OYQ=UQohPkQfBui@rt3b7Bthr)XA;a~iwQd4*e{_MR+IM2;f9gj^@9cO97
ze@9AHN#q0dujzNtcaqYhN7cU;8=zc5O8Gm;2dc^PG}Yv2+OXeoiicE5+%=S@n)S#8
zC_i-cC<!p)5DWkXKtBEs?ixz}!hBdzf4=XRUf)rE8@C1QCJv*T2!^=ebW|CHsjBoV
zIh3BJTerX+GW_UKi_2<^J9ecjXgV*POm=>uw-7<CGbhqtP(OX^REgYvwGZe)ZyTkT
zOM+3#A#yM+V%U78D`5HguhI)Gr`EgDEuyIQxsu*78$WeB-Z7az1$kuio47AjXJA}~
z`2syB7@;vpaIw4&&KBUTc_3z%?3llCV(8%HdGjV83{BivXiqEjxFcb^Jsfd+3e)WT
zCcN^!vazueuYV_xxC_HJTe#2-KOs*c%D+%0a35(fZVk&DL|=(z$;#)#gG<;mf5Z5|
zJu~Lbn{iKY{Cf5MP&$-=rPC6`5gDxu$}6j@E6W$OLJ%-f%u_kJXVfK3>abV{M&l>Y
zp+<I0ULm{l{*b4+TV0Yfc44_E&u=pM^E~AX$HJnC(gC}9MmX`E=?Ev-?e_tbDFAdp
z91@-XTl^5S@D3MJpQ15PGEL(!5~g<+!BmUf>B&zq!{a`lU}4ZWvpuMbQ|Sx!s-sqb
zl5+y)r0lBT#Jx?vM59`#F;=BRJ2vw(;qJa7I!hdyu5w7aFqGLeLXI^Al(Ug?B~te4
zfU-Ky;YqRlt7-qgClAGW;8_PcOaeoVzKMbBVu-DS7%E&EtI4tUnZ`g-&{Gh!v{q^i
z5ja$&6W(dsJ26<5orHHkRE|lnGHP^cV<NTp^PoQ+=r5VI(tb*MSqYrZ63q9g^#ukX
z791!*c-&JEvSw7G&Wt)Q7E+0YWJ7!WSMa*CSL8PIy^il*3vjm|T)$PsZ8$1EO&W5=
z?0t8`1cNAKd0-rag_PCLZ4jS2a)gW!@7zb;*oS$9bKC~?PZR=t0L!f+$bnS85YCa3
zyD*)<irb)Sy&#>xiWJ}dJ$%0f>amU0gTQ<p?vgZe+j@H+IV$eE`)*P!z8YH(ft_gv
zF7G?KpM3FC@l|9)mIv33K`XsUsVHKN(0u!k-Usysq2SUM^NM$Z?22)`wZr(nlYAj2
zzKZJ@NSiON<!1GLq=411Af2y7{|YS9B?k+6@Nr*#=ZMti>WKL&t&vaAnVj}umZd8)
zdt|mLtu8NH;7nFyejcOuB+xr4(ZfLoPa|NYE4cTl8-#Rc1?^6gE`c{DtTacen^Q-0
z*83h`m6va{nm8dluP)7$J#u!W3&xS7a7t=f-%%Jxyce!EO4txa=kG^Ts>Ww!PpA%s
zswZS;jju|%IVUSEFE1@CM|>}5bg{=%JUS=4waD!*YRwK86ofPK^P%pfRLmtG0Iwhy
zL7Jmj=rjc6g71ZV+V?blXC2H9tjW)P`jEKkVeVz|-W@xL`#a}(mD2Iyx{eNo@Gu`;
zmVi&lYKg$>a`3}mP(`>;J;kkAd1I54$L3|V7JH87W*yDWZLpP1EOC0_KhBbgWj0$K
zS7Wo)k~$kL|JEpv0{9FtmXrImxBOvpRfG5@$@;+$K!#C!Q__|bv_|aUm?odR@WQ>l
zy`1vJM<5!M+CjGXBksTYp2V190b&i+sp^0l%qlgQ%B~o**^9Z*m__=7N^oc#Ri<Yt
z59$|>25w6m+a_lhbLDP#Iai!Lxy|RPM!VW8e8H`Sxf<H1T^&}3OW<y+5<B^H`~2<O
zI=64{+_rtb>V5bF|2J>jwt4ssznohO^R~g?{P(tjZ-mb6^S9yO`0u~392o1a<BY0a
z+E>E#f-W(wY)_7=70#KF&LnSAO5Kdoj3B&T5X4{n!W2tRaZO6rsABK!#P7D`N`LGo
z0oq<*Z2p)tY6^y@TTna{UDe~3V0vLnR&&I4JF&YhDd~}v?B+=FZU@LDS2)OhslFTh
z#M0~wZj}kc387#>&9)ffEm1qTQ(?_p!hPv29+mB@_08y>qH}1gxE<b-QCY!8|LpE|
ztvSvUAZk}>M_tgEaC_BO2*8KmQ_Q-3)!UVPdIpxoXK-JtlK-x<yfcR@OW4QC+EWc>
zO_s{4+5u%{{+sLN5EJ>uefx3d4a;trDGAUCz^WM+(9q8KCX?B05?>Riim#bXW)sOH
zk9-}M>~hB4zI5r{c>2o~S3n=LviDtO0`wzj)7VYJ!4y2N&h2}A>AtvRw=-^!xOnSU
zl4FAZh`(fg=qJLL+z9n==omyB4maZS&Rx4YRcAk&56y<Q*H8FvZiH&e1$l%8pJU@-
zdA<Xk4^?LJw)*GjbL+oB#LC|PAa55>s|yC}rWFVC@`5U}w|qh*GQQlqHa9;n7qTlp
z<ZmNyt44qOxBPAF+cNK(-28l)ZNs<!aJk@P7Jkfqt;TU-sPzTzbOf1O2d$k;wxt%j
zT?HYVEmYug7pB^_%-=jEe9yeai|5@Pp0Y(X!BvoIv!xceToKF@A@%v~*EG+%{PJ1N
z*R;bp0p;<{+}Eny@25QewJ0yH2$mZm4OrgHWy@yvm-lb2A5py7`xh<)UMj#j5%ks2
zOW(e$^YhO;#b0lq|M_Rkmd-<-34Jfi>}|s5ox68;iog179(3SfZ=8bf{j;))=0R(x
zmJ4qhBfaU=e!1n_wgX-9O=`yC+?_k;fA$%)kp`8GD^|Zw?TDR!EJ7vXXh|B-_M&#E
z+LfD^pS#vuK0XqeP!5v<qFBQ3CbL!J@LThsZ<o+dr`HC9wbP3Q^Po?$Tz)rK%)TXq
zzKt#Sf{*`6p5YFsKlXi!cOwW8*#XldH5?%g+aS&e9dvkP26nih!_Ea4ILz)b{vQ`>
za9G7o?$tSU$;q`@H9C7-{8V0uv*~IxYFuueTUV7?rE|n-0W>AoWId_Ta)Ke$nxZjj
z9llW`4X#A3QIpadG6<Yj6KV}<%-W>Ds8)kJ(W*}!3A3QP#T%5izTZJ#WmlAdaG6YK
zXAqSA4$C&C9B^*1sZ7-2T1~iVPM6D>>~j4@`bom+_1O+bc71w&lhxXopI)Dnl#~O1
zHCnAr;yJfH$>mD2yQ4qfOU|uMNvY0F4tc#H`R}OfCxutJ+cgRB2C@Rr7p2yapc!VD
zdcxg)-5RG}Q*(YD{-{<Li@RL*`^ggchknPmaJQ?reCv0@WBA<z_}v5lOnGC(OwDC|
zw=jE7!F>!B@AsvIOFSIU&)h}Ghwm=0d%gD?@g?!)-mhP)?SAJ&q7eUN&#Fzof9fTd
zOuaw7Hp>ovzcDIKbD6pmc6!6`YS&xTr#ObcPIDRD*iA8*E1_R?sC-?jaS$h<f_&g2
zk-qKXf3BG<+{7^H+Y9o6oV&zpG?V*sqw9q(^{3~Iub*UN)1^X>W`cSRTQj1!9d_zf
z(BI;QERXxJnhBqLz37Pp`yV(ocjx*a%YIkSJapQdQ=H?SIP>5W(k~KC{z}aR;hTSe
zrtte=Y5oiN9HVlAK322wj)#^TE>7|Lc)L1>OW|kk?o)jDPIv8VoQjl_3Ql;vZuz?(
zihZh=?U}V1Os^TWnRsTgOH9;Mz}y0Q$^N+otY<YgHmCUNI@NX2xx~pUpkJLV{Ekzo
zUxEC%Y|%yUfr#D>i{}g3g+CYG1954%z#VUMI8rTQ_L8cs=KSPln@tm!Qj^m%HmQ2?
z1h3oSbvR50yGnI87pF7DTMXcbw56uHBTebzTZv|?+uK-|RFviA^dVooHr@bCV_!d+
zZ|4-M=6@|uf{TmO15bL&QwVmFfTskr&EsvVO)APpp1g9N{twD&Jn-aD|A^gJ!0t=<
zmir2}sZDNMlb&dbGaUY8ht90Yu@{vTI|`;Xg#Fd+C3)k@e2G@IHqm9%jhPY2Oh`=7
zl_&d6Dqr24+Pukish+Y4g(-H>(Rh9u=TJ3$?_~>{6O-+<Y&id_E2CxCLfKQ~W&bbM
zyF>UBF>Cff{{^erA<xqDdmqs!1<i0JhF<URo6Nx^y?Vb`OP<?j@+awZNdU2*)Yd!r
zImE2C{eARQUa^imd)JWkzGwc>#%jREzWprv$dc)GDJgZ+OG-NGQ&Q?XO0qLDvU4&s
z)jtZ<c9fNM)CB@{__H=3ZmMpmud1qVfYm&<ceJG%u%&;z3{?{?V@7QtP&*@9MtyyC
zHT+*H<6mA6qL>S1IMvUgzY8oQ+Ht~y9%EE+7r4a8Ip^vOYE5!YPPj6|w$JUdgpBIv
zM87`4mgIHiH-t&9_`1gr4-mt)BhC}%LSN{FHw*qwnyP9spi8t4&~*C^12q2ye1e^j
zb6_WFIEoBxjZ0p-sFN-_nIk_@CBn5o7N<2oD?ihbY&Pi3aoP4rVWA^yTvdv<YI;T4
z)S$XCE<QdXzOk~pAwef~ME;r?6_M!;sUcXNp?tu0$T_f`@3UOt1x-A3{Ua)CXt}f#
zik6$2B9;5UQeS8*pgW)DHg=~1_|h>jO}fPeUeuHu9gU!{*^9_}eZXY&*b?JS4xKw>
z+&2d{LlRt#`7lsBJ>Z~8$+M`-b=pL4BsG}pO0bwXM{k=x!Rt=(*L0K>&uB<B8$XV=
zQ=i)KJ(n$<9w-}b2eS8$(<ORbQrY#XX2VCc?EkfT6UAcTPh1dWjytc+c^!M*2T?i7
z)52BhwtX&a&-?bN_gNgSyoRv&8p*?kCm!XFfvqm)=Ws!g-*={?O0pzjry#yga@~GC
z(m9HBz9)W`2!B$hL7N4W#`{!Yt%$W7{$`UUXgO+oacXwCK50ts_^JEKoPmAGNfy5j
zMxA%{Z~>JkD<v~D8yr_8uiEd%AAYw!K|Dm;>JomAG7Z`)mUr=z*fkwr(V`4VlVgh7
zi(IITSX5TZoT(_AYM%#x_}w}vioBzP=oIW5{@wNK0x8@Db7{~ot=|Rrj`Y|{gI;Sq
zZ_&8p-Ts7qGwdc_y(%Tsu+qZ2oDjM8uF(p7cfp+CE|~xRU37$Vp$x-HGw)6UI`0@^
zpHuOFjh_nWGk0nl;RSjH+|Ph_iNZg!yGvk%WE(n!=$czYTGJS}DtUZ&w@06tsMhnz
z?t0;OZS@}*^)-gYj+-v~jZdqIZ?nKW4C-3Jx09W!7b$HVe}*M*Cp+EssY8(GZ?f9Q
z)qh~n*BBQitzY_EUqW0Qvm-g*{}^qRV6hM8oY5|awp;{r2K152?nj|_heWudQ@5PD
z-e^~rz-DWLxtw$8aIyeRE%9{Ps8Gwe(^@0cy&U?LBA6q5R~k4uAn)iCqBIOh<9pzv
z255|gy5OF#G!n53QA+wRM1gy1)ZEBj5cfG&sp6{zi+=Mxdv+W2s&T6L!g%{FdxSq3
zwVUG%noG6Dug+?;H(Sj!Y<~j&YM_oIp^pCyZGMhHyCvSBUZgdA^}Z$^X<Pq@wEty%
z!;>e%3S~0*z;V5h3H?F|QHKUatqhK0xotJsu~z&F!cttx`RK;YPj*3=3dey%*CluG
zs#C8Om#>}=QS@+~RzCQcna?-dl@Ir8h57+7G~h$|xiT62>Hi8oga=kLK4OX`S%Vm3
zeEeUL#~?n!#C|~x@}L;hzBOdW>YHug^@ys)T@beQis0WL*aHB6zp!UD*><h?rlb#-
zBnGlz0HA^zQZL^lAG{6tSS|i)P_d+Q0HB65q+Y&9KK>4QK)e-yHN;81MCVBKazZ#{
zf}vzIjEv}w$$n#?GRt`=f5rybFRTp+H~7+QYFlPa+K8)X6uGJwv_f^DO@Ci>-h_Rw
z3~9eizJH-QyKVkwpR@goH(|dlL)tHs=MfeR>~VZMok4pX=(sNl3%JEmatUmh?AoO)
zgCE<smBY5lw(V7)eKvpRPN*vQX#H>wYXZdb1-Kbhm&fp)1CRm5A=V!D0;IE+aPo=8
zU)by(xbG=?vJ7_y@YOjQ{JU%ABTFK4_rJDmyVy7TQk`9+OL7?UMs$>qUOqZCFzV{5
z&l_xHOz(c>8#<?QgJ#5%t>acbb7N!o$}0^#xcJh7j_lE$CHWI7{N0u;3u*ZEd|SQ~
z_~GE~_FII#Jiawn3mnC+U8F@LP73-j7?;|gy#z)L`E%UxDE&Nmf~*#vARC)Ec1bRG
z*T9YA)@pc;Y-?v}^@{rz<h3=FITI7}_w?U8j!)2MOvabV+Jdzez3Zd5kk7}5t6p5Y
z9Ns81`m$VQ+0k3bsT@<`jKfAalar-T^arm<XP@Y?pj`T3>%hjv6<VtWqTL!Jb@S?c
zDfP3;D@GQi*uDDZ^f?PJE1v!E+L3kZp17v_P~-1(2D{sy+rGAK!n&#1a3IJ&J+Cfo
zXukQSwO5?kHm<b^iU&RVp!^&Dj`A0OzvcJc1Tj9J3dgbjEG{2nIOseG?!yDU#6GEv
zeh#>nt|;<MX2-U9MN{&UHEyFm=)Zl-779$xPu6%47}dIE3m=|(>!lTD%M!OK;dJj;
zN5uV8cQ2_nTNk@c+Uc{&`XgBXzFP54Wd)R9-hX~xdRZIG0*k=_AQ=LeYthIc8I#J2
z*lWLwGrkn^J2rL{$+#KB?x2gm$KEs>u1RHl@g5o1=esG7us~McA{<lr;iq)j3G`Zc
zO=mTnWrl+Q*oB47=?j)#9=YtP&29O!w|4Y&?dV9qb$!*e`iRY|7vl12!^Y}WCst0{
zd&7K>804nw>t|m*Vh_Bz<3eX6oZwI>olpjxz%k3o%I%Lnf`-8WMF)X;#%(uMQ|h`F
zD0x|AsZ{c&O+B}esYEF&V0ujH8;(5uFbJQ%x2AlIl}Xr{aSYy~E1Mjs5k36?C$_Cp
zoEX{Kv2{*<+vcY(i(I~RK{}o)E2y7dwf@$OjvZa_n9yyotM8eA!`?|NPpqnjLv(Ns
z4r;f1&xosM*XzaeM;>|zRStax*7Z6#yQHChR=PtdI{^#7294w|Gbc=*zIyeNyE^mo
zyY?+w{Rx*iW$cK_;tS-<!j5a3$6hxhA|3=9NG}oY4^*kH1$uB6jo_9jZiTXGsvoQw
zj(9}K`=uIloW`svCBM1N;n9S|&q9LFzKgid@Q*!WEe`}LtPhKSa+sDaGdQ`kKvxN8
zPIhw-0Nn)O69b0(`&6sZ$~xH8Alq@qYf9<9v)@Q=_Jyq~jXmtStSu?SW6UdRyR6Y$
zQrA=;YPocT_&OgpI6XR}%N&0%dH!C(;7!i=-R3SDm6Jc-VIEVRJFz-Qi-&qa`AR~|
zN3Q}7ln{dj8iK<ocs8z}SV{08iTEz@;~|pg7S8JIoV8HUv~8SU#+@zeyt%FGDzRxL
z)CJGa?B*(g7Vfaq+a&!M&}Ai#Km36NiRdMN65ijn<M!LRv$xay*>G3n&s8_lI~mbs
zNyq4cwkMstje4hwpph1lQ$%03sbl<>uJV$Fw@sh5HM=A+-EIq|glrgMgi&gqJZr7d
zEO^DIGgIj4mMsg)Dl?{7;te{3hVzz<%P*N+;fdGGH0vauKazNsopIwndPe;4>8FWJ
zb#1Sc<cq)H&Z36^*oJSW!##y|_(lnTfTw}jpMDx@j{3wq9d9AKAuTG+09;f`JAKx#
zMaXV%&D{F(Dy53!%%->`eQx^G{Dak(w5BJzOWk@CA88`LWqc_)paVx9!KZ>3DpnAD
zI|1Tz=+Y<$k1o=}lTuAP4WZ-*ewyIag<Y>b;`3;CYCQJzr=Aj~CcSSpioY{DH2Mtj
zfZ6b+K`Z_Y8D+Zi0DX+ButI#Ek@JXEPx1M8ac6r^O65NS>ChixIWWL0A)Gf5R)P^?
zxfmz}+yC^j_=xh62RZI>OLkI@<s`>FxWkdGJ)*V7S!_qOP6w6X4aRhvcxPG~>9VF9
zAq?}Z#wOlx%SkHAARRW1#1HBL<%Vv^FoX_A3&N0JBlppKn_DNI0Q&PCc0C!(DUq_?
zNOsyXOyUo?vs$xwi6hrSI<UQ>E#3k2V%opeEQJTqTYkx<HId@V2@}S3j|>J|yW1u_
zCD=-fv&!Be3&IW4BW1H2Qa=G<F<LJHEj&pswNPjrR@V5VilCJ7BovwG&vqx2RacV3
z2OR$R#c@_k%2VeitZ4DKG=`l*z~~BFGYWqscAJeq(j|&tb7zB96LOoExh-Lkg9rFt
z3S~hoG1wOT7ovcdzVh@dT$}L6-V@v?j1wLY?dB~>RybI~?tnDGr5gogS8elC*%PlG
z1$SIzJ=MhLk8L53iK834C*|Z!>TZPJ$BcyI-$aq5+|9QG9T*SLcR>3zHFF}wyjp^~
zMz0>ehZo`7|9o&Aui@c;Hyn8X2M)h5U5JCLJ=Kc^zoR6{tyz?)6*R(hJ^)Pw+RnoX
zE~C+vAhvU7?Pl>2ORm!iI+|*5I!xjtDTPT{W-`?Xk>kM6<I1PGT!?SR{sX%puy=f)
z;t!4#D;M{Y+G}63M%8Naf+ZRB9_|+ShQn`^&(m*kh#UBd_F+R1;L05-7G?a4&_b5R
zP>Z2U6jS+5QUd$_=o6t)CJ}4&7y&8C%E^I{-l~+8stMV`#(cP#ei?@EVmL3><DdC9
zqTB;(fg7;hnTH=QgJ-iEvhA6pyDA)|73IzXtwo>gO-(K<HKsQe9pX2eiW^3St7p~t
z)aH<<7Ot#MsHjUW%Jgf*C*T+=%r)S)+LsjpB?el<T|K=I^}P%00MLREk7xTO{3PLV
zebBp?=7;+-7%tTI!WnwNHxI(=d!2}j;A0W!J&{uWy52`A{s)>L?n#pH^4@(Ee`*k3
z(fbABj32z~K;q|d#*f4&#C1ye6ATxh8^li;mJ9mWFFp)!<<L8XL*O~09VZM-(tlNv
z+|>Pl?VTomPITNuME46ZHJCx#xvP6O!fD~#xXZpt2VR=t{M%wG8w`Ymdk-MW8hNC5
zMo|1s2}hZ7iW>1h_|-7y)+p+L1-cT2H4+=+s$@q&{cIV7tCr}r4`2Vq(E|He;!ZA}
zP`c<^6S+lNql}#~_x`Kug+!Z?Tdm!FO=Wvsfz1O;g9Vp&7cV}&acoI(^lU!anm4&N
zv}#%JShh@wcUE6@=yF%c8h6hwoD#CN!j_+HnDa=(ae5pd>Qe)2g%9yOHmDx!c>+%;
z15V$9r#Q}s5Qp=EFsFQ<FNeAHgQyd;wSNGI!vj)J8$40(g0oTJjPj6k_27qc;DIcD
z?;N8)-=7lk>*pE+>=!JL^oc5!vO=AU^hiL*!`!DDLU&+oga@ZMbJ~aztut1Ps$DR3
z%((WF)=L|_M=XIX)g3lps?WB|<`4UA;Zc{hWS069C3^gN;O`Kf1rE@&4M}d-^+-&x
zM~S8SZF_Eo#|;y|f4+!S_%)n+nn>%Z!kBGTH=W*PkT5$n!|7^fRe49XRMsWJ`6m@z
zF`XK8*@U-9sCH6r%b5CzCFC{|pI@Ug8Blh_%1`D(aBmID?mN>ArMPVT6cVZdnqz@x
zstafafTo_&{8#WPya{z553fqVD;;?0LWy)V8f3s$!C{hRbET##wTUVDp2WJ!l;Tvg
zw`x|6O3<5B8h=n}bfsD%^+{QkDY<RsK0<X3^`8j!|HVb<28W@`-z2A7my`)~A(RDW
z`mf*>+S6osKhX?>e1NY7=9R*&+ymqRz!yLt_A<Wr$d6(;xsJBK{R&0=b!xm{1veFf
ziYyqLupJ&#y-m{_`#w|uRrooim(cXB{8pNNlz%7secU)`r_t}X3Sa(zl)Zm=RK@wf
z|D3ZyHW6#8F;GRMl4y{ih!JCm8Z;`#s9B8|6fx9jqXrBT1#MK6@Iyq4N?Tg6Vx^T<
zTG2OXRBBTb3tF^Mvq+WJrA9$T3u}HX6|<lFdG&pLuJ85v@7t^QoynXzGjpDuo!y)n
z5C1*RIuS2}4NE_A$bSay@#i=EziX6-`xn5-Q2%?!Kal;O^YCwI|L?z#Tf%>+$M+AW
zv5CQ;i*rsIT7CajWBaGnl-7^?PXCq>!-_}b9~(RI=E*nD`oI5-=zss2Tppet)b$4?
zhYcMzB6n#<Rz`+DvGdzG;X~7ZIKD9F+mXStfq#$78F}bw1taUSAGzcI`|ru>AI%Me
z&mx5b1;K_RzL!1N4zZ&2F9w}4D8cu&WBHrvEW6fte$fBDOMW8%?hAiO=nDK>!m+`T
zdf(~40n+^mzmGMBef28#-+fWvp%|0+fBzQodpD5(zxS6o;%n&o3dU3Xc{4{&<lDs1
zVWW>b;-nLgKKjH_r=1#P56wU3JIN!)UR+#UG4{y)-#I3KXpnvCX`@a!`j``D2G38P
zzu~5vo|`|J|4O55)}yi5qch7$e)IU$r@#EkiZ7p@ntOC^+0wtSyz!}fr%fE5drWSy
zW9aA+M;tL?^w70OpK!v_rG+E?pHV3oc;=WRM~}+Q9X0yMV}iR!oN(0Ok%gsRAQ*k)
z&#pi9)a!qC<4eOYzv=D^&u_e}u<)|R^Dn&nrpt%FbpLxliN${M-u*9?POY9kY4Vdx
zrjEW~+Ko4jn>4+8YAM6xfB(nlwEZuE?<Z;HgKjviWFWGCB9h|y7B#RH4l<4#VKvX!
z;l9rywXhL7+40HmgXhCuo)<L)s-PbB@Nbfp0_C!bVV~KdEs!u9QU*KB4x{X0wDTSE
z4v#`PtTfA}&g^Eh?^54)=fO6!BRGD<T0WO(D~Dq_oOcw*a`_K|hZdU+t2O%``A6?G
zJEjI2;h@>@4zpt?n~mW75%p%rQGR48>@fR&18><fpx#m0um)Pq^5(-z*uXueYT)My
zm9Wq3MCv(lq**~8P)`BJM~{Q8W+#yzGaS0i3TbyN<;HF{JDGM*nQS)BIcRojIZOlE
z8XpDP8o$x(v}I;R{9Z&`Mf`p`b)8-VjX>KIIB!B5_Z?~b4C*glV*cnNJF^KmUc&K`
zy=D_T&Cbd(J9~xMIaRRMtSlP}fb=BlKX)9gF*~o?teo@CZ#27r;}^^`yD$Sd??URD
z%+JZ|V2{~FEx^x;V%TPOG3Q;(^;PnFWvkgGLx6KGEdt73%C%lr15J>C9<wTbuj(|5
zac*q6+2wga*~`1kuHbsFSZ`KMJ=L|a5;`Ddb|vMm<lHOCyK;xwl#x&mT*DOVy{a0v
znbnj7=hid>=T6OlIv{;@Iczn%W*Crn%{rjJ)5>54aBNz)*|kxizH3QOF9ga?UuJe)
zHqc&e4shKw8qIz{-Va*MuFr#nSzU|S4Ww_N{Ed{mvD55_LtwR8J-^pCnB7zel)ZT#
z>@~Zk4pL?fRnTEJliz3dn9ZWCTPb_%KC?#p+(>^LX}9s9+3aaBAIQ6ndT-liHm3=w
zw~2b1$iKY|Hk#eR&pYa2huPd>ppAJ3rO*PcW_R-YowdM$JG;#8q7OeJ??=ncnzMoY
zX4<&B7`B?-(+DZEdxt|gtT&s_`S)?oeU!Z~VRk=#zn}IO@N)sj7I1zGZMKkZSps{^
z7B;|Ip!}jdsDaf$-HWHe2D2qa&}#Mo^*pfNY$<InZGjzT50dxbeBk_L)cH^uaQ;KI
z`_MMChlc=V9;Uw!bI!vYdziX@oB`DH<2qOeZ9sj?$zMJaCPNb}hxM=(y3HQR1I~G*
z!|YMgkJi94v&U%nu^zJ(l>bQ%bejE?GCzw#6|99W*lV_uwtl|N>=&?Vz1iwDW{=aC
zUk-u!W=|BtKC?CS>&azizZwVB_f$F1_q81V^)MjsH%s84+0#Y9@u#by4w|3^R=`@=
zXtu5Z>LF$JTYmo??fq`K*)w_2XtsVFbeR3V99n>Lf4>$e`+Lvtf^M@v)B^d>7Qr5~
z4aKn8?70kB3G0Dte2((Zar`;@_k1?w0cD@B1nPLc36{WW*Z>`7|HJYBnFpM+kv2B=
zm~EomrhR5FltQ=Ji*>LZHo^|GR<5J902+XDFAalfW-sSJ4N(8fJI!7h2gLW4HGK3H
z0_Xm*)$G-JNSOVp7)bw#dfPa+tqHo!{#*nrAZ7Mi4Qw`R9|r5qI?93iJ9^AsuZC8$
zzi{j?&1PFNfPQWr4wQW(3e^8bhuND2u)*xF#lY{|s(`X@O@>ahw<-7bUbDZ=1Ae|k
z{qMGzy_W;)%(@DJ^W&wk(rkM+P}g?adA|&n!9KGc9N$4-c2H)=M%Zcgch3EL6Lgz>
zPz|dgW%gkekpCfNKWqic@_*Y&`JMD@C;2-$=O5)z3-sq7#O<FMK$(9w1AY1^3e#Y#
zS%Q8gC@<>yxz=n~4ip1rcCCO;vwv~yW6t}SzJI&~Rs(f?yv?k8ByhZ&_CKMWPu4-o
z>{HJFlrp;ufO>cDHQPhp9@3u~(C%kz%s%J%=al<`I==9qU1ocSK%3c@c|hJ*&1V13
zhDP9=eMQh?w!g+KNtxsl=rH@5-@m4vo+dN@(%s9sePyuOtiKl8%u>{oYBf7R{sGSU
z&v008_6@&(!?_1nn|({2-}+CkV_*m0>L<fyzPmR;4}YuF!+Z<Ek-+l;!fp#9jX*lm
zVL?VU?66=^Eq@-eXXlXR{D*Lr&}BiCpV5sLWKM>C7Gy24;LtqSYQd0cKwXFN^RNwU
z&n<#Z3l49BgWRr-0(BiR&w?XsfOB%HEjWt*-uEcdxoa#K%CTXbKdj4w@0CKrf}<&O
zG(V4-Z^7{4Pz#$aIJOAL8&M2(u*`zv3W2&tQpd=>7JQ%M$Jbjhs?37CAwa$PYb`jT
zjm4Qp3ko<k+MvaPlQMvQj~NGhEGS%J!C2}W+sYy`=bu79Podp$oPTOLHxYASHMiX-
z^XDnYit1p81*bPb!h#6}Ks#rY0`(Ttr(%wuSq<wfDB=8)H5N>)f%O)Y8gOpuRtwIe
z{<D@qCx2#@0q37HAGoG6>Y0=c{62}_&*k^?GGGntv7ns%@-7R`&w~{fTu=lXEx51|
z$e&DqCa<;NB933g?-flJTs#i;Sx`w|D(6{n$uMZM;8OZ^8Ru5fmsq6*m($i2oOcE1
zRTn@V?6BZU&bhMFf+>X-T*dLLIH#rvIIo6!r;dcp7F<09sN-r+AGF|_M%Zh?H0qwl
z`PcIM^kNIHqy6iuVL2o$sI3C}Q_J<u7zZsD{Gbe|=lUqD1o~80YrzdUum(CTxRLg5
zr2LKiek1MtupCI&kA!v5W5G@I_a@r9X@><jQ~u@xXoODKXTdGCu)%@`1JW}~VF_^V
zEc!W%yjhgHl|D6QK(__6>wxRKZ3XcAoEq3>K@)v#DhKj!r@q^pEx02a8ZDU1&$;wz
zUNNkNRtxSV|1R?Rz7#ZPz&PMK?xw$Y@3esLN&(-Kf_qn5FuxS`Sa9Eb=(6B`^6#Gq
z8=(^pTCiX}P^N`8T55p07FI!r1&cU;Q44fiu(-~GB_m;(1rH1Z>Rd|Smr`~q#~&;J
zu3;HJm#wtmp=_YcL$vd7Ijn=77W}vfnxPeXELcvP%Qsu_h{0r_okuA92<JV*@keRv
zQO<v~7C7gzY0v`n`>`%KXu*n+PzLot-78jG@RKN117&_X1eROyvm&70pCv3<N!gYA
z%pcYk{CtH4zo6b#Ij|CFfAw&noz-m?JYETVE%+tBKS3RQUkcU~0(no;|0k*YSJ|-B
zf~RU>hXrfNU%SnMUz7jqO5oUU$bXvOpPmOP3)YnaZLjOG;J2iIM_+!&InPkXGabf*
zuz-H9rw_lUj^8IN_(LNcwBXrsu-bwRWw6<T=Y|30o^Q6`e=>k$8)<9f8Vfc>VXFl%
zR9o=kNZ>kNY~{~z&V7lpFLBOG`z&~wwqEYC;1%k6r3w-jY^EQZ4_fd?+W+Hv3tr6w
z%DuYTf<IC2Ptz=Dqn)-+3;tXOZ5F&%2$Xq^GVP^69qrWHL3<rdu)~7a`T2Uc1%Fv%
z!Im1Jt*y<FvfvGVzOe^Lze)P9LoC>4u+4(ENWZn&g10&UZO-TWO7ITH-kAop@ot#~
z?@hL#YZ$ay5MN@!_TfNX@2|ID#|EIUe;*0eunfrmJI6oZ+z+VdgL$wTHp5N}J~ZIx
z&Pv!}!9SK;@Xu@@@1t>W(1JvR1-oc>SC0k%nr6Yr!+^YQ&h4hXPw4L_ocn2w1-qlL
z&4N8`K;CE6_c>+0sI_2k4y?D}%WR<UUlqYV3-*nKVn|q!B%NFfZ5Di84jk{HY!7wx
z4g=cnU1LEXKl^C6Zy8XY?+rm;7wom5KLdsX_4ijo15mDiJ#2%$7NmwiAyh&GEQ9s1
z)q(?D$A4(+n;f8xZ)pFU)vy6*<C~NP2dV#HhXn%#KtI!zP3J)o`0vz_rrtE?rq{wo
z=m5@7cUx$sumko$if8*pVHgxZF;v1d;8@79kYiyNaBkRRVI%|QK`U&vFk>80cF;Nt
z4{5e=a1N}2ofbwZ7u{=N=4x0En_(MpEYtH3T9`EihC>xl{?L(72djZ{L->724XlKX
zKwl0U1|0uR88pBW*Z>DDJiGv!pvS`O4hz3q3wta)g8Gl3+>yh9c5?E7b91OOXDiTF
z&OQr|;`;cm6dqLw)PGbp)I&2YhqcfO+aLk7lN$x<%^e5jPy^JRJ0DiSI@k=I&<!aI
zhYo>}Py~}<8Z<%+tc3N@23@cR4q7-Y8}gtSDxnsdU<s^-4bTBQV6TPWGsuAgD1|Dh
zgL$wF*1$&C3W@)6bgPBObXz!_HjkYQ^y^sqbu48@6av4G;M@^AEj(_Wg(La>`{aMW
z)57D+fclQ_v2av_g*=}v%v)(;{xH~V;R&U{xhHhNJ_}FeJV84ru7LHh1NK;0K-q%j
zKz|D8+vp;ozb6d=+8smPV<=z9&%(79j^+4R>O8p|YJoB*@BIJADfH)*CfI7>xZyC*
z!c%)JETY}hD`AC&6R3XzWhT(3b4K%jDIRHIaf^j#QtnLJEur5NH(FR)W8qoUd)7e<
z&t7TaIn+^BZ{Z~RcrNFh$FXwCoX^h-;6f*5A>SLriUJESZUD}^n7S@bSXjw9mDEw$
z0bK7Tl)r@f1npj03#(xVaQw1yu-C$>M(D9HHVrs-c{Q{G=_`t$66%1uuV@46x`Oi6
zLx8?imjdThH$V$)v+zoeT}i!HE`bfu1t|-s42LpU1N3uBw}n?_0M~O>B~Zsz9J^|t
zg*D|sn>8CDVc}HjoLUH!n@YK<%V0fhgS~Lj!mH<7cug75|7-YtS`HKfzfYsgwRN!5
z!s&U?0OVh1Fbu}QWT=ICK-<^(amv?Hrj~PRIbO?owabBi)$Rb=nL)W3ofiIp_I}W4
z;q}=-yVuu13#<mpU%w3!7S^q_@P;a=hxr!XNWXqK5{iK~epn0hU>U5nu%4ecQP)k>
zebW+H1Fg^ndw@RNOq(}%Sa=I{HIzb+g)>_$oRtCVEWDMvZ><FCzO@Oc=T`c4>jvPw
z#vQQN!r2BnPyp3Hnb|unye$vr!8Qx$3<3H-ryiPNEzqAiek=jB-P8ar!1+xn3vZ`?
zw^PUM#ZU?K<97OSJN>wwGPl!@+dE(f?6vR?`f&&SxPyM&Q3|woM;*+AWv~V|!dBP`
z`z)NB0mGmW%AgwP<J=Xn4mLw4bVJI*c|%|%6v1Se293}HD`7pfK^N?SgBISI4S7J>
zJE`~1Z5G}|yLZv%U7ULt?c9~H@JGX;2B_;tTP<v+t>$u=51WDd?j8s8pcQ&7yocZK
zq27DeK(~eW7C=3$h7LGr;rue7&iT}NA9dbGo%c1vM%ZiN{lkDd?x&9XcUZU}2daQF
z3)(Df$pFr2;rABKX-QbPFb^7l-xsDVTtq(>QOBYc&}HFb>g1knxR^Q@Z?kX-?Jl8?
zB};(cAIOHuFdtfBpM^_@LoKX@ZVMme_XlgB1?c-S>R3j<mMw=4;GBmFpdQu(zdu|A
z)ba32=(O<1IY1phUJcZ-JOj#L9&EPo5rblAgtf5K!bd6d=ww(1)bSW~JjU;jH398B
zw%5WH<AC2+v_iLqKN$(rU=8fC@TVOADZl@8C3IQ%vmsCgD}Z)?ma=eV5m3iU>f~>o
z@aF|k3!L-wPN3djWCL~oVjPr14K%=fSPpBU6}CYFdMsQOh2g+Ct2k%XYS;)n;Gl)8
zsdIH66hkG@=4$$}dI?Z=^#<qw>Ux~Ak5l$>%05on$0_?bWge%@<CJ-vIv?L_;V<d?
zFY929g-;BDX6UqVjlpoJ2I^n48TMKDBy~Nx4z>Zm|0)M)<5$yQKCFeU&~4#U)bSK`
zJjL;+s-PYy^VCY%0F-+w0VxaDW<vwC0C{W4<8Qq1*9A}pHP8slVI8!=4%lbmZz%U0
z%Kc_C)WdvO2^%bYx)ivEr>XmC>VA4PYy|rMG<|&fpoQzWhINHd4%46sRsiMJbwQ7X
zzs-RnsD>t325Vt6birN=e^&+6`wabfhQ2*R-_}QABoqV3`MWb*Pyc?O4V3u<zduWx
z&r;{J)cGuRK1-d?Qs=YOxgi5MwxJsiTKHTJ6hb+0-g6v#j`N=5yyvLzxgHCjFMu+r
zfks#YYoHZ6VULCXV=xkmfqwl@hlLxdcO&&~tb=A)Vd17ysD=h;fz_}Pwm~->wD5%-
z;M^BD_l0TD1j}G8Y=$n_YaxFlhcD9Jiw!_sFH+Zw)b-*vpsp9GtChN13xT>?sjHQ`
zT9*NJwNh6rb+zub@TDO@xtA)T0hYmf*amwod^rP#LlIO$9W=uVpxnz_Apt21U&(<&
zpv_lk^OYu82DJGKZN9P-dMw;L1oEI1s-Xc|U^Q%nZO{z|E&Ss!D1u6;gH{V)9S-EZ
zO8HkQ|0?BQrTnXu|5FYWLM_aLm9PQm=bz~3pHddKk>AG8KW9S$ltB$N!V*{mJr=$;
z1oEI1s-Xc|fOcP_-PdUMHQIfRcH3#Uop#&HVH(g@J8g6{!wOgr9k3I6EPQ<kQ2uqw
z|Al`1g?{{ne*C2t=EF*8g-+OK;g%>+W(#Gw9}#Y$uUqKrmNh`REtK1`$HJ`!!=MSs
z+e+RW<h{`VEkIpwRzW??hn27awn73@7XFp<|2hsPLoLjM<rZ!$2F~5ax!X8*+e&DK
zPS|7NTiHOFx7Jwrw!ttM2h{U6^}Ia~mcu$|gB`HX!oNjfByjHEs-Pa`!y2I6-x3yf
z8c<&+^>tETXDv`)C-rqwUnk`{sjrjz-l4vCMgsM{Lw)aTw(#8oD1#bkge9;BS}lB!
z*W$fAD1~YuR__t3_g2G3*aqEj(88`9D1>sD2E@5*D<mLgVLTfup$?j11+0e-*a<xr
zZXW`9Pzu%1VB!1p`F;BQK7D?lKEGcN^I;`ygl*6b2QA!@1LI&a)B@#pQ10)X^8x37
z!1*6|n*0yQ|6l`bg@lFNCkj8L4?F3@PWrI33-((0j|><NMX=Gre{%jm_gMIm!7!k`
zk0wK{g$d40EP*x93Y|dNU6kEL*<F<7UQ@V>vb*T>F8chh94Lfxm<CO-4A#PC*lFR%
z)Yn}H&9DO2Lx+W*w80M8XY8+skw70m-3Hwj?xw!o)VG`Zc2nPO>f2KY<-oDevY`OV
zpavQ({CqeRK_%2dGtlPe>!Aa7LXU-C41qi-1=`=c*1|8Bf&bhLU9i`}uQFgbQ0G_l
z_bdAQZ_@v+gw?PSwpqBZ3hH4#tb`4)6%vrLaDO(?*ZuT$KYiWb2+M&w_wR%r3zI{D
zJ|)*!_;n$y1CI9$gK;n!YGEF5ZZCPgWk7wsjlg-mt*`_3S=bi^&gtWvz67K!?9YY*
zpv_bZa1AN0A;mSMy5XRO2XcV+50t|+;M@b8`ybBz59j`;3~GQj|FZ<vK&yq{42L3E
z2^(N5aPBvpdysPva_+&&P;240T<f=7>$jyq8{am;GFS_np$qm}IFJF<J3zeyl~4!G
zumaXY2kf*kT@4Mu6Zvciv|1!6hiT9R%V3{HxL+3uM?x8Nz)t9~NQ84Dc~A<~aL^(d
zIZz0bp%$7gGN=X`VTnZ!DS}F<1CAZC!XkqUfVu}$ZZPErQ*Q7Ypg)5<VUI<k1|y*u
zD3_THoSV5G=o9z;BAGoF;l5uai#}zQLNzo%3#^9C&;^t`G-Z(?TOk3Y52L=r=*MAY
zK>df&kHhH4VQZij=*MC7<2we!U>sCIJ<NxdumQG00#X(^d>$-^b<hSoERs#1vguPc
zeafa!*&AUSbi+Z5e76=j@4K9LL?M*JG-!flK)E9*cVrH5{78-;$?+pOek8|_Tnn3_
z3-($hCj*8<5mZ7QaO^1heH8WNa$YXwhVuK+Jr)_p@nNkN`QA#498Eutrr*b8!xG^5
zaOxZ02-I<GF>HX8MMlu}2<kbm6k04Yau{&_NXmV`0JyI2ud~SUg|G%%Ei#I{QIr|Q
zwT|N0DB2pe1NK=YFA5`}7^<KimH_4Qw!$8Z<VT?ZCPO{Uhm}B|^0z_)QWiNO8z^@|
z8Pq@{EP*x93Z1aeA}3Pr#Bopsjj$XxKqu_8NI^D?gUL_}^I$owgErU!lp7s|kw6>V
zTa1jRjnSR3$08>g3<K&pX)@FT^_)aKC#{36K)EqdD1gaO4@+PjY=u1*DU1Sb6cz)o
zVPPBW0NNkRv9TN*%dxRlP!IEAC2WALkbsm$PR@n`D1(i#4Z4A`aY_#GdYw`Z(|~qP
zSq5uiGjzdTi;T;F;ZOvXPzTMh0@hpPRPs)xZ>Q3?@$_vxeH%~T#?!a)^ldzS8&BWH
z)3@>TZ9IJ&Pv1_XZ>Nm|%AM8-%V7g_!aj=>Wy3hAf=1|sJr+6LU>I=h^vO^Q^I$ow
zv&aPcIe|V+pq~@y=LGsWfqqWd2HkMbB4@O~YS;+m7dKes%wnj5dZ5o|(#Mi)D1b6(
zg}oM;m;u9qb|zNBdg!o7X%zB+dP=LI5thJOXoH<VooD61IN;o~XzQ$Xu*V{2cUk0|
zVK5DvU>R`kIh(<c?X^f*2GDj{5paH49W=uVSPvbr6M8H%X$a&&Dbzp{EC<R>+6vtk
zIhQi$QrEfDpar@ta^7%Q1_v!tUJj(o$v>a`^Qq(fPK$8QIdTEzFGyJALe9UCG8dAb
zoB;(e8R}sPtb=W^&mtF5$3?{FBJwYy&I-=0r~>M(SP4BAxtJJSOuR3quNQYf$|9At
zS6K_K7P({y%!6)=T*|qZt_148l=?5rfnuP(%QnDXi&RYmj>k%YI%4!Ywi!|uxx5G(
zVZBAJC<p4SrjOOtunf9j4;-|}mD!L7)PH3q)C2WQA%998P{)*=7P*T0YBGR+P0fMj
z7P)!|OasbXO<mW}k83(CGOYlbq0=JQQunp1Ei#>RrZ2O|bx~-sNUgzSpdRiiM`n<o
z(Q1(&aPALi>j$K-r_A-_U%%EOb)@TPt8NW+TjU1H-9SAzBrI}cDRfxmhn2v!)l;sX
zGB-8AMmT7Zn@2)9)B|<gO#Qb|cZ0!vi_GNbOn%PFgC)Q@w>AOwHV%i?u*V{^hXLu?
zT-)ru7P+kmRsikH;oLc#GpEfWO@&YeD=l(+0ZaqR+`i8ucW~^E<**JYd&dqSe{K{;
zLNRde+<Kr-bLqp}ozP>EdFz4S=kfcU)N^Mu@cUgkK>52iTjWRCK>A0do5^pcTyr_p
zK?|(4$lZ+=xu?U-0yF;o$Ka%OZDxm^v(Li8tAZ@NIv9a}861Y62=ehJ<-ef(mz4jq
z^4paEXXSS&|8?c>4ER1b_#gbo$>HEca2(zhoMB<K(D)t~9c#1|J;f4uob}@ef(P-^
zU;%#6+APdE)?UUV?9cf7N*{0Uk}gnswDJp;9!vgF{JX4|;Cy*Z`drcvrYrG7>C^GU
z=^{HSC{6QkUIk~#XUpfvmkoSQ{*?4-_*&&mm+R8w$+^Mv!>hf{uwGu_H4iG{Ux+zs
z(CJ=tw94C!#^h>wihPw^BTto^y@u%B@;&ms@&dU<UMMe;7rQgNy~WH=<WJ?@^5^mw
z@?QB%`78O~I9HL$Rb+C_Ba^Gh<SH_`icGE|ldH(&1|FH*z$23zcw}-FnOsFCH}J^h
z1|FGQMJ88~$yH=>Lyt_ZB9p7g<SH_`icD_QBa<8T$mB*nGPzNYOm5U8lN<HO<SH_`
zQIAY+)FYD{^~mH#Ju<mbk4$dVBa<8T$mA+Axr$6~rbi|>(<76c>5<9J^vL99dSr4l
zJu<nO9+})skIYcTVW{FTRB;%pI1E(;hU(gf>KcdYx`wK)p=xWW+8V01hN`WhYHO(4
z8mhL2s;!}FYeaBHy23^TCFycJQ7%hgNO}^^vq9;L@!0eze6oCsd}{h|a>mPNq>m(B
zET1V)RDP*^ZTbj~)~TMG7@2w2AkUO%$+xOxqdZ%_P5Di#?RKT_P`h*GMQMMo;bM82
zn}7X>{sf<SI-KL_Q0Ip8{M@ivzE4LNrt`^J<h=?P^ZMq6OT3kEsg5r9`oqVRvr0J|
z(qqZlq_bX3A8mPqc6t4Sc6*sYd%esdqrCn@4tW0HANZ9HzTO@Exz`q5<*h^?XJqC@
zf0;fHKcW0J@~`Bl<lpP)vr2D}pOc@LUyxsvTjiJJm*qBZJ^JT#34Seo7H(J07I~}p
zHu{GAru<j=ZTWA0b<s|he1};jFZ!-uQS?3LsJv*G^5gP$`2+bwd1v}q%KSrD_mP~C
zcd4F#sZ6*0iTtU&Th^-<{aooU+?nR*W(NN1WQKBvJV-A0US*yyUm#y3SI8I3mGUL>
zrSfHRl^m0=kgL<fsqIR&J0(4u^i@jNq)#F}Rq3ncYvk+XT6spgfHK$1b@C0W;l^|!
z`9D;ddif^#X89JmL7pkklIO{H%6G{cv6*+PpZCcN<Q93M?Eey2UgiVxQu#q237HSe
z8p)ZDDE+AXn7l%M)yHk-pX4_A&+=<>yWAnaE^m>y%5TVT%72x&$#2PT%YTzQ<#*(F
z<t{lce=YaQeR98?a%b)EE6VEeXk_)KkHLLP_sc2yfJ**H{zg71f9pQfM|i$wuzY5)
z3eqRbr^r4d<%d2S<ZB+t5B;5<uXlQW=<oD=y_fU#Ue4#eObvQ3=j*+kulI63?`6+l
zBmYW%O7{11e)L(TH^|S)&&w~!FUqa*OY+OIzl-zrF3ykodow@k@5+3=EA#cP%#Zr}
zE?@7v{HVY0@}vH~%a8i|E?@7X{7fI=`I$bp^D})^=V$u3&DXfi&-8JdpXuW^Khwu;
zzT!NFh!ykn#Ie*rhKRXOkxxyJAU$3_BYiySV);yYqVh}SYkBR)*sV%8%CqGrmAr#1
z8e?<a%-ht-jP2G@UXcRQKDNg&Gt)}A+)FYidwK(}>=<4nFY{u$)W$Fyb1t(nN11_1
z^QzH*UNy|CM*pL~kXI3zF}!vc<0q7}M*fxjRQhD{*DC!R`DuBb{H(k|eolT~enEaw
zZk1n>UzXdvKg`MQc6p1u)qBfq?0!@JtNgaysWR`#@98SKl=gScnCNz;Kaf9^cgp{e
zKavx&A`|_W(%teW@~84{S@CBE_8xvAr#<q_!0u4akO#?EdKpHP`zpD{<Hl_1Iam8D
zl6j5N*U7c=4EcJwPQF3@p<FNDB;PFGA~(o0<yrDP`A+#R`9U8WnalXzGKP82(;6+z
zd!Bw&eoS8BW<H^x%p~r9Ipt=qINna-8|iU4Umn8@a0=fc-Suw1F>;h|jP7cAihPw^
zBTto^RsL@I9{FB*f!rc5lo!d1@i<z~!TIu-^f((w>+X6tt#g#t-PQ6G`6{_ao+>x1
z{N3_B^1bo`xkX+mFOnDIQ)&G)oG*{z8_TJ*?yh&!I!9^UT`l`xC8zRj*<B+~m77)m
zZuuVhUU`AsA}^E|$^IRT&wS2h_L9Bz@oIg%S|6|0$E)@6YJEK4)hVym$E)@6d{_4z
zZ+$%9)!p9uc)qK<z4h^YS9g2s<N2=c_STDo3HB<!$lk#*`3mbIeWm>kU(545iusqu
z-F3FtiU$?hMtnM+s4+89V`d_M#T;!DHD)Gi%uLjnnW!-{QDbHzJwMJS(sQ?unThn=
z?PF#lJ$L(<nMlvwK4vD;bGMI~iS*p<W2RKCm#TH%d7h)zOVxU*S}#@WrE0xYt(U6x
zQng;H)=SlTsah{p>!oVFRIQh)^-{H7s@6-@`dOJ{?F%cDucasF@$7(nH|@G(a<x1~
zzDll<r{e24>u{VekKr@uI{NRfcT*2XsmEO{Pm%q5+I95b?cdX`qyJw1ZuuVhUU`As
zA}^E|$%}EVTCY{>wM35`wO*^%Yt?$KTCY{>wM6f5t0j7FZ@pHn*Q)hewO&i~sE6pe
zz4cn6=l0fXiJseApP|-gsP!3YeTG_}q1I=p^%-h?hFYJY)@P{o8ESooTA!iTXQ=fV
zYJG-UpP|-gsP!3YeTG_}q1JB+PUl~fzlD+iH+&X%Ep7?UkuT!z$1S`I+*jBq_)6P_
zr?9GZ3-5)$;OTOmeZ$l7i|loLx;yhB?vOO-x*Bv{4Z5xdT~~vyt3lV*pzCVTbv5X^
z8gyL^x~>LYSA(vrLD$uw>uS(-HR!q;bX^U)t_EFKgRX0)TA!)bXR7s?YJH|!pQ+Yo
zs`Z&_eWqHUsn%zz^_gmYrdpq=)@Q2qnQDEeTA!)bXR7s?YJH|!pQYAksr6ZEeU@6E
zrPgPu^;v3tmRg^s)@P~pS!#WjTA!uXXQ}mBYJHYkpQYAksr6ZEeU@6ErPgny_3zlN
zwC*0mH;`Lt-Cggdb@FN5T`f<MuaaxzsdBT*-!0!G-zzVWTjYiEB6%@xRO^juy-}?<
zs`W;--l*0a)q0~^Z{*s)V~t$9+goqs+TGrIBiHWs)*HEYx3}KNwY$CbMy}oMt<R?Q
z<FJ2r&!+XGZ8ojD{j+;Et&>mdZvX6_P3vx-hiB8e+vnlgwC?479-d9>Zl8x|)4JQ|
z;n}qA_IY?VtsiZ-(RvQ{&+gl3eVpA!>u&$-zKzz&r**e~cHc(pZvX7Qjn>`%*?k+W
zdwKutzKz!1{@HySt-JlR`!-s4`)BuUv_8(}sP#E&eU4h6qt@rB^*L&Nj#{6i*5|18
zIcj~5TA!oV=cx5LYJHAcpQG02sP#E&eU4h6qt@rB^(I;`wI*7}wB?S;)$$biD!E3U
zitpg80-P_8;ojXH^x0kSrXG$`kGoo)B3~uf$W!HJmA_lQN4{5HAh*a1<wf#hJXfvH
zRqJz!7&&Tvu3Dd~*5|7AxoUkb5i78{M9l52&n04RZ+$Kib9?J^iJ044pG(Bt-uhf3
z=JwWqlzF_pWQ!EHMT*-Z#ch$|wulx>Z4oWHJ#LF=(d}_ttg{yDti?KOvCdkovli>D
z#X4)T&RVRqmT^{vE#oZAS?-uzEl-iJl56Ctc#Cc2ZsZnwQ|WgGo+91F-_%=dJO9A#
z7Tb|7!yl%{;D7K}<QDrUcRsh+E+VtV{x$Ff{#a*q%bzI!Q~pZbV!M^|S^6B(pEHKH
z*cStRwncX%w*)2prL%>*k?u0@19v0c=kmA4mf$?Tvuz2=l|J9okzadlk>8{b!%wHr
z#J}^_BhSd|b@UJN^X@_Yaw;9MErW~v>IR=KSIC#hm&zWcErTzYuaG@rTLxb#d)&4R
z_PA{se6@UyJl!4ri?@<_rbi}on$p+Gx5|wJUF6Rm_!quSIdcZ$q?-o5z_%;s4tLfm
z@;Lca?{n68?uKp2I!!r6^6BXeawc$}WJ}f=$|;u5<lmv+l2zibQP#wCHZJx4WSym>
zXUpfP&N9_GNjc}r=c&$e)p@>hE|4!&os(7PMLrU;D&&jP-zQz^uW!~R%DGfIm+?33
zmaHn}#0GYgzT8JnR<(SkJVm}ru92t8SIgJP)8uRA>GE}Qtvo~ifqcDOC*L67DF0Bd
zmv549mgoC8$+}OzU;X!c`&+VFd<14KRL&xKvAjfnKwc_8C@+(LtaFzu{fPXi{FuB#
z{+W;Vtd;W5<zL9F<kj-y@-O8l<Tdh>@~;MVQNvS8ua$o-|3-dVUMK%n{+;}cyk7pj
z{0Fb+&_@^p?`O@kZu<zoY5Rlk@~OH%I6^*B&KX!l&QbJ#e~`;q+8+#6{xJD_0}IGG
zT0TZO!{uY;5d+U~^f;wQrYDmAzI?p$M=3u~&QG7f(G!$DQ7+&ey+0VO^hxrV^r7Sw
z>Ri81wLds{U=uFkeYc-^!+oy$S?-Sf-D`+^Ab;%TBi-^R@~84{mE5EBXY%Lr7v9gv
zUZua3zmos$tw;9h=zhk@{zy{(nst-?ksjsu`n5#*<bIu%N*_Yb0r@}5`Nks_IjHov
z@_@>xJ)L0#`*GlX%Lu*2jEM3x<U!t6#v$@x9nJFEG7i<zbD1;uXZT(5{TY?Yxn!V$
z^rcE)#y!UU8C6POu5+)DtJB{j|4L5}`qE$JL0@@#u-`4*AANG*Bm9co;rY?G<oD&j
zb1!9o^fP9R{h8A}Cvz^}YW8RT$Xm&rFaLPpL(&QFbLJk8Sf;Pq?9bdME0URtWY$kv
zeb}GX?q_9ncm%Rum)}s%oANgKE%|NvUH74zxy!fz&_8<XhrU4sk{ZuRjpt<G<2f1l
zcus0OCpDgv8qdkV$8$39@to9nP6j@nlYx)tWZ>gD8TfckYCI<cAJ0jR=VajHIT`qP
zP6j@nlYx)tq{eeH@bR1sd^{&Lo|A!(=VajHIjQlS417E%HJ+1v8eU4;M|D!8I;l~e
z<g;(QB{iy(8r8{&kLsjGbu!|kIvMd%os9UXPDXrGCnG+plMx@)$%v2Yq(*fz;-fkl
z@ll<O_^3{5R3{_;S|l~9lMx@)Nsa1c#7A{fqdFP!QJswVs7`8BCnG+plMx@)Nsa1c
z#7A{9;-fkl@ll=Bs7`8BCpD^*8r8`RAJxeWAJs{X>STtG>STtG>ZC?>GQ&r8QlmPl
zQJu{2QJvJNPG<P1PHI&1uXN~KAJxeWAJs{X>ZC?>QlmPlQJvJNPHI#qqduyW8r8|D
zkLqO9M|D!8I;l~e)TmBsR3|m6lbJrMlN!}Yjq0REbyA}`nW;!>R3|m6lN!}Yjq0RE
zbu!CGbu!CGbu!CGbu!CGbu!CGbu!CGbyA}`sZpKOsQ#8Q{FQynSp66uEsx+k)wjX%
za-n>3`fU3)@^4S`x==DB^mN8xIZHX03~VFka^+kh`}dr0Gp_XXps(D->SFsg`XsN;
zx6xPR4$qIiCBN^^oG#BzPbU3iUa4>C?PMFEpZ~<Ud|Ml!x1K&)9>HCp0eb5$luxFH
z0eVXgy`?0*B~5SLS<1Ow=_}+b-MpsMOg~A}!?Adyyh(mV?$FV<<oD&z-1ON!*PXT1
z>!Hu*@qA9AgiF(-@LB0Re74f(D1B{uEIHHNku6>_vQ_SMv(tdH*lCa(oZ)*{Fnd=p
zdsi@fS1@~5Fnd=pdsi@fS1@~5Fnd=pdsi@fS1@~5Fnd=pdsi@fSAsKq?+Rw`3O>c&
zz~hV~zIO$)cLhIae+tg<y(@TxZN=<e!R%eZ>|Md5mCxQ4((GNqulltdTAn^NC?34Z
zzQ(JA4E#%_pP-+`gEuMtg7RNd`eo&}Dg9^VcPRb3@^=P2$AGKI#fjh$yel|1DCR2u
zg2&qX_!Onb**{4?5Zs2B1~&)A^n4RO-d@F{l^#pFgjcE*`zuwVSE@v>R0(@U^2qU5
zszk3;39l3-d8OQ)ZoN_^yi!L7C3>Yw^h%ZJl`7FIRiam_M6XndUa1njQYCt&O7u#V
z=#?tbD^;Rbszk3;iC(D^y;3E5rAqWlm2i#Qf)ZY-kFmc}C3>Yw^h%ZJl`7FIRiam_
zM6XndUa1njQYBgbN|or9D&dvlT6m?#2Bmyzj0#G5w_X&KM(-p3rQD(I;2z(gbXmZ2
zXo<;Le5SZ3%4O-%q$jyqJEIJ1XYM-Q1!t?avsK&Ks_ksmc8+RebWp=Ns_h)rb`F29
zjV8xyJ4dyhquS0<ZDqVt=Lgiy(K22gx4$}NdUeWpbvVka<L-3x>QIJP=Y*h)Yb1wj
z93M<lJ(E<=B-JxX^-NMdlT^<n)iX);Oj13QRL>;UGfDMa5L_^Da&W=mi+OikFu2m*
z!<X3~ag}x98s$$_{xs!ZtNdTs2OM1${2i|jzQm7PC;nydK7Jzj3O{LY;f*S}NhM!U
z$ro)q`K>DdlFGlV@~<f8k1GEsxlL#NS!cbbv)WarLub9Nv;Lx-4{a}X?hL-b{|M6f
zpSA~oWdFj6;4{1{H2g2+bo<e0VXz*L4chQ2!Ef=n;LmuxZN~QnQM`nIPU3>-17S5@
z8dl;5m9va_>4NA(!Pwve#shK4IyPv=BZB4l`@x;~_}~#-p#0IwFI4_m&p-4JM6yEf
zxC*`FD)f%4&^xX|@3;!R<0|xytI#{HLhrZ=z2hqMj;qi+u0rp)3cceh^p300JFY_S
zxC*`FDtO0z5LEDv+mHPnSD|-Yh41SND)f%4&^xX|@3;!R<0|xytI#{HLhrZ=z2hp?
z^Gfx+Qa!I!&nwmQO7*-_J+D;HE7kK#^}JF&uT;+~)$>aAyiz@{RL?8b^Gfx+Qa!I!
z&nwmQO7*-_J+D;HE7kK#^}JF&uT;+~)$>aAyiz@{ir#0vK^3psJHh3=%7+A(lYT#_
zCLILTq~8su4DPfSgDK<`1lRH&AB#)miE^1d$*r@dtITwjna(^gHki&l;Px`pRc1Fk
z3Qh@jv!lR$ihL^X<=yNkaG#Mb#>MiP@<ipA%Gav=tx7k_v*jk0yn|MDv!ejBqk!7j
zQQ+25_7cz{dkLtYy#$nDF9B(G4p4@j1EkqGKsvh8OR{Ic{R?@Oyjp%-{-ykcyhi?&
z{FJ;_{<ZuY`DuBb{9E~V@-y;!`S<c4<Y(m#@^kX@@(c2da;yB3{IcAp{{LBiO>URB
z$Xopy*>B)}Q~s;`w){7h>6G7*-<98!yX3gMUH(A+P~IuC`-__YDYF-aG<#97BFqj1
zPj}0o$lL=Yhrdm*UN3eac=`)D?N`JO7Iz?razxIM2g%i5o*i87De_fvjXYJpTE0fU
zPOg<_$Ul&;m+Ryk<QwH5%JuS1^3C!sa)Ufmo+Zzd@09P7AN29Y{si|!^24&mA-fbj
z|55odd4-!@3S1Gpaol}!znpTjSD`p8XKn6He5Jh}mS;R-FXG4SUHlXKTX+TU#|q4@
zPRy=O%&tz%uFmjk{!2CX4f{SH%-@^%WSM<Fq}k_#+2@1V=Y!ejgW2bU+2@1V=Y!ej
zgW2bU+2@1V=Y!eFgW2bU+2<2p&AXC(-{*sM)c5(2W}gpcpATl|24<fRW}gpcpATlA
zPk6QO^TF)%39t5jKH=4TyP*GkyTHEB2meB5pATvF`QRs%!#*F<?DN6w^TBJC{*C;!
z%swCT+2@1V=Y!ejgW2bU+2@1V=Y!ejgW2bUUzXYDLz;a)n0-E&eLk3dKA3$zn0-E&
zeI}TFKA3$zn0-E&eLk3dKA3$zn0-E&eLk3dKA3$zn0-E&eLk3dK3I|QeLkew=Y!ej
zgW2bU+2?~5f8XarnteW)eLmsUzRw4<&j+*52eZ!yv(E>!&j+*52eZ!yPgR<IKBU>_
zgW2bU+2@1V=Y!ejgW2bU+2@1V=Y!ejgW2bU+2@1V=Y!ejgW2bU+2@1V=Y#K*+2=!=
zeLk3dKA3$zSfj=F`H*Ix4`!baW}i=ZHM<8d#q9RM?DoOz_QCA-39t6uK4HDae?6o9
z1k&T>Gty_0E|$-fCn~>GzEy6NXUk1qhOtczjBU4aG`8y*)f{C!yL~*@YdqI$Jl8Xx
zDbIN3DC3#5#&f;Kb3OYEPYdfchU+zA>!WR6hB4-Dm$%4Uy#~gZ`%U?;^4oH!%Df}{
z7^`QDc?~|s>KS96{y_dv-YNe>{zy*9>Mdi;%XiD4$e+r)WyOIp=4HNcGm6|(<f~*K
zMfHp#&-YPO&nWWrb#kpdL%v?FlW&lJDA&t3$v4Zl$PMyLd6qm+zEi$S_VH8CsGvng
zg}Yx)xfvB_hQ5lOgIUSNtmKBiitT14H}q9(@>x4`vyzKh$;GVXVpei7E4i4JT+B)?
zW+fN1l8af%#jNCFR&p^bxtNt)9{S|1`zp5ETlZCLx3})A*yO8qU&Z#cx9+RhZg1UJ
zvEAOfuVTBsbzjAHd+WZ6?e^Av72EBt`#SPzm|a+yU0C59c8P4p6RaIyq;$+)BYlOv
zfa~my(ASzNNe?l*L0-hCyXh_U&|5cq#xT3KFnh)@d&V%kwlKT4FuS%eyS6a9wlKT4
zFuS%eyS6a9wlKT4!e+&)S+QzXteO?8X2q&mv1(SVniZ>N#j07cYF4b86{}{&s#&pW
zR;-#8t7gTjS+QzXteO?8X2t40TCWK2qjgMMZq^Dh_suXXgP4^;%!(>zMKxT=S>M6z
z(7^1_2p7_4H#;=Kh15en^|;xgf!QO0*&~73BZ1i?f!QO0@0QskLHb^Kf!rdqM}quC
zGJ7OKUvWMUvqvlR6=yelv@m<LFnhExd$cfnv@m<L!lk;>rMl9ky3(b((xtl6rMl9k
zy3(b((xtl6<(yRzF6S&aE9~KNuGG!?ez=@^$fq7R>-(4$cFYPpW`!NI!j4&C$E>hp
zR@gBs?3fjH%nCbZg&niPj#*(3AEWhB%$|hsG1_voCjqmzj#*pBtgU0#)-h}A;m<ki
zaLjHr%zm)&=k(dlZnW^{)I&b?xY><{*$;-<4~E$fhS`mV*^P$TjfU9|hS?8>*$;-<
z4~E$fhS?8>*$)=3Qk+*Q&Z`vXRf_W}#d($Dyh?Fir8uuroHudScfw7a<@OP^Nh4~L
zM${(iA)k8OKB6{JkK0GoChBqfh}xtPwMipt6Md#0ji^oZ+0#CvHqmFdkEl)b`B?r%
zxpxM>z<j3Q?E?q#hv~ENKhmXmSNcr+uYphS#{-|?ZuygR1?f-I<#@MpK1*Lh`g5K8
zMf$MF<E-gZo^^cAWgXwWUO9h|pLY-Xr<Z3npERrOnALXLWwqVY*UGobjq+^yHhGTR
zB;PLI;byg+E6N%tpDK@+Pm_z})8z^B8FI0Frd%RVluPBa<g?{-<T81Ze6D<+TrQt4
zUm#y7PnIw82(#MmzF4l5FOe^mFO#d}n0$*zDXT%gRc@4L%eTpM<R<xc`3`xmJWsw;
zzDxd*+$`TM-y_fWSBjN%_x=9*W-X9g<c0Dgd9l1ien4I-KPdA_&AAWB56eH6m&=dH
zkIIk9E99T~$jMqM|6Klsyh>gzKQ8}LenMU&KPmr8eo9^||5|2m2{k`0uakc(|4x2J
zUN8S%{sV4h&2a)gLOxQ?8TcJJM=?rUSq=Ff9;*Cd^7jUwB<E=P808F?kCjIZ^l<bz
zrCB{Eef&T#=D$9}d2)XG0@5caeWE;CK1m*v9?H=|)iYK(ClB<K!wMs2-8|A7`PlO#
z-SVgMZtpE?h@StM{JH!^`V4aRD*dJWmHcn7Kf-_4gZb}zaKG|dB_z$-H~x=uzVRz%
zmC$ScRvu7!{x*rUW>`842kG%R^g1&l%IEJC(u0+g<u$M}=sBzmV%EDc{}mW!Wf1dU
zfnin#G5-}9zFg;CA+s__&Xt~K6^S$}gQU4%T@YzyWiX9jkvlw}l|lFWGArGYR@MZ`
zVKtDNSq*fv8W?Hyl|J0=IawVZ!>re3zNM4iCcmYlZ_E5Qcac_K<HM|6V^*#sZN74i
z*@=N!xyGzqV|HR-c4A<5VqjLTF)P=Yofw#vYs|_uX5|{Qa*dBunw4wPK9<^i<r=ec
zjq_wyu1TMuG%MGnS-Hlem1gCdG%MGbofw!q37DN2*hf^GMpT=xS(E0zeWcCTtT8(=
zFl*MhTV~Cg^rtfSg-EkzjajqCtXX5$tT8(=Fl*MBHEYb8HD)IUW~CLge*m*)joFET
zS+mA`=f|vBV;_xe8jWqfW=)zkYs^jz%$hZ3%^I_29clA5YwV-3&DX4PMEMyqYu4nj
z69cnmjajqC?8Lx6GTSsV+kDNMw2#a-U$e$OGTVI38nb4NS+mAIGTVI3I@0EA)|j0b
zkv5IYHea)jwE3DfX3ZM269cnmjajqCK0e!g%^I^41G5tYvl9dRC~fmKYs^jz%uWo<
zP7JI_`kHm5O(VIDk<3|)WFo*wcC%)US+mBhS!33$F>BVCHS0*5#&es-bDPF<yJp39
z&5G@e=LwPaASZnU&P|_+eLiewB)h+t&c#Q|J|DI-lHEQZwg)59hhv`)+Zn@^_;}^`
zeAuq}usz6EzR!p4?7ndOeAv#u3-=hVqMdbTugB-Z_TXe9)~-3QU2|YNyD7+LWV(G0
zY}Xvv&Y1MH&wlNUMz_y??W|l=8{>`sFy7og`?WLPPQ(XfpZ(e+-}rTD_G{Pd*UotJ
z@;>{uGyCP^fZ3ouBlJ2o`?Y8I?AOj}xaVYf4VwMh8C{o<_Ia;8;}YJL?V9)68C{<5
z^Ikja`+n9HGJlbg=D&W8v@^PhJgeuVSv}9gugD$Bc}sp@{yTG8JL9S#(w;fpa~M}A
zVW0ilHT$)*?msHh&X_5~KKr#ZPTX(G+hm{j+8HNqpZD4sA=JYNxg^rTcsK^<GWI$&
z20AnbI(WU#C+B2p?ojkP6oC%<Pf2>txzUaCCixXNYx*3`dXIDCnoHxFOXHeL<C;t3
znoHxFOXHeL<C;t3noHxFOXHeL<C;t3noHxFOXHeL<Gu@s`h6~qYc7pzE{$t0jWZ5U
zAm8WGxbFhOK9|Ndm&Sb;5NV%F<C;t3noHxFOXHeL<C;t3noHxFOXHeL<C;t3noHxF
zOXI%(Clc3O8jtu~8rNJJ*IXLcTpHJ08rNJJ*IXLcTpHJ08rNJJ*IXLcTpHJ08rNJJ
z*IXLcTpHJ08rNJJ*IXLcTpHJ08rNJJ*IXLcTpHJ08rNJJ*IXLcTpHJ08fR?NbKn1i
zeJ+h_E{$t0jcYEAYc7pzE{$t0jcYEAYc7pzE{$t0jcYEAYc7pzE{$t0jcYEAYc7os
z_D}h^=F+(4(zxc*xaQKh=F+(4(zxc*xaQKh=F+(4(zxc*xaQKh=F+(4(zxc*xaQKh
z=F+(4(zxc*xaQKh=F+(4(zxc*xaQKh=F+(4(zxc*xaQKh=F+(4(zxc*?TqKr$acoF
z`$#!w;P0f5;ytpR@q8Q}s{CQ{_Xc*5bF_Sna)!&t$|DB;!_niE_L01uk^BuFr5ygI
zCY_(Y2%n(ziSlUqB$>ZJIa;WC#wzFJfq}?&jn(ZMtJ@i?)WcYHe<FV>@Af`3Rz3eS
z`Ez-%{H6Sr{BN&c<8!;l=XS;<y<$wd`&Gt2-?wW_Zf8t-o!|IXGbTO#tvsOeX-{iR
zZr7OH&X}Zr#-!(G$b*%W<ux!4J>Ngmw`&}3XB>Ktf2MC|9D3S6)3-AYJ$<>(y+ZcS
z^zDp8>SrAC>M#yTYaDK820Jveow?WD;rWb1_xrMcnr~+WlA{s0oe@a=j6k=4ns3+W
z+Ro@AhtWkm8C~u-`Ri;u<I3~jlHZo!b!%L0*SOm5<0@l;@Akp$_QCA-!R+?I?DoOz
z_QCA-!R+?I?DoOz_QCA-!R+?I?DoOz_QCA-!R+?QSm3*TFze2k-9DJzKKOxPHeMRs
zl(E2f`(SqaV0QapcKc*3RNoe=ZwuA8h3eZv^=+a0worXrsJ<;!-xjKG3)Q!U>f1u~
zZK3+MP<>mdzAaSW7OHOx)whM}+d}niq58H^eOsu$EmYqYs&C6#TmL5GQT%nr3Y;8N
z#7f*KTp~}D*&#y?J7fl(&QYF6!_g!0M7b<|0_jQkBkt{7g7ambkVBeh2VtHagn4$*
zppX2?F!(I_Y?&wIki!#lFn3(>waS?;v&u;h&kh>&QOL7{FwYLcJRxV$N9>cCfO&S%
zppUqBMC;r;a`S{7%oB1jPsqVMAqVq>9Ly7PFwYLcJRt}3gdEH+ddw4YFi*(AJRt}3
zgq%Si`BQ5!&kn*oAqVq>9Ly7PFi*(AJRt{vDf5IJ(mWw&P(qPOC^8A|dYwy-M<$`j
zBovv1B9l;L68_|zK?#3$5cbF<6q$q~lVI17=X+!licCV0NhmT2MJA!hBovv1B9l;L
z5{gVhkx3{r2}LHM$Rre*gd&qrWD<%@LXk;CJu(SJCZWhA6q$q~lTc(5icCV0NhmT2
zMJA!hBovv1KhI}SLXp|!_X7v*^8109*?7<{uEotA=0Ussejw(4Am)A`=6)dNejw(4
zAm)A`<_<IF4m0L{Am$D;ULd!~+z%v&`+=DIfrIwadMW0<>!7`~<>tOC=DsWDzANUw
zE9Sl{=DzD8d7O1P=DsWDzUv`*^x4gQ*F*BChkWXBbKezn-xYJ;6?5MebKezn-xYJ;
z6?5MebKezn-xYJ;6?5MebKezn-}R6K9x+VBFcCZCfJY1yu|p1c#4r)VL<|!#OvEq|
z!$b@dF-*iT5yM0b6ERH0FcHH<3=^@zchY(VW*uShowVg<9RahBfLTYttRrC75isir
zgTLmiOE5D7X8dEuKW1jY%nXCS_VJII88G7?GyXB-A2TyxW(Lgo$Bci>%rN+CAODz{
z0W&iU{@TYsW@Z@tHT|Sr`srq7z|0JonE^91U}gr)%z&90Ff#*YX28r0nDLL9889;g
zW@Z@twU2+y%z&90Ff#*YX28r0n3(}HGhoI)W@Z@Nqsa6qGChh+k0R5f$n+>OJ&H_^
zBGaSD^e8eticF6p)1%1rC^9{YOphYdqsa6qGChh+k0R5f$n+>OJ&H_^BGaSD^e8et
zicF6p)1%1rC^9{YOphYdqsa6qGChh+k0R5f$n+>OJ&H_^BGaSD^e8eticF6p)1%1r
zC^9{YOs^u-tH|^!GQEmSuOic{$n+{Qy^2h)BGaqL^eQsFicGH})2qnzDl)x_Os^u-
ztH|^!GQEmSuOic{$n+{Qy^2h)BGaqL^eQsFicGH})2qnzDl)x_Os^u-tH|^!GQEmS
zuOic{$n+{Qy^2h)BGaqL^eQsFicGH})2qnzDl&bFOrIjtr^xgvGJT3npCZ$z$n+^P
zeTqz<BGaeH^eHlZicFs()2GPvDKdSEOrIjtr^xgvGJT3npCZ$z$n+^PeTqz<BGaeH
z^eHlZicFs()2GPvDKdSEOrIjtr^xgvGJT3npCZ$z$n+^PeTqz<BGaeH^eHlZicFs(
z)2GPvD>D6xOur)2ugLT(GX087zarDG$n+~R{fbP#BGa$P^eZy`icG&E)33<%D>D6x
zOur)2ugLT(GX087zarDG$n+~R{fbP#BGa$P^eZy`icG&E)33<%D>D6xOur)2ugLT(
zGX087zarDG$n+~R{fbP#BGa$P^eZy`icG&ElTu_-icCt8NhvZZMJA=lq!gKyB9l^N
zQi@DUkx3~sDMcow$fOjRlp>Q-WKxPuN|8w^GATtSrO2cdnUo@vQe;w!OiGbSDKaTV
zCZ))v6q%GFlTu_-icCt8NhvZZMJA=lq!gKyB9l^NQi@DUkx3~sDMcow$fOh*|2(~9
zuz#Mq{j=$SB6C2IIiScKP-G4$G6xiy1B%Q6MdpAab3l<fpvW9hWDY1Y{^?Aeip&8;
z=71t|K#}p!YuZ(0{PWt={@LW8*KYr8^3Q9xe>VB&wc9_N{PWuFpH2RG?e@<m|Gakl
zXVU>i=71t|K#@71$Q)2)4k$7Q6qy5x%mGE_fJY|k-}WmoyYeu*@-VydFuU@i6LfTf
zj!w|g2|7CAzel;JcYc)r+JhR-P?<AS<_wiNLuHC}v{*-rb+lMVi*@u&9X(S=&(zT~
zb@WUfEz!{u9WBw(5*;nk(TO@bQAa20=tLcz_}`=ITNV4ME{;~QpKuiBS&^7$MdDM_
zhhv@<iFsBe=2?-LXGLP36^VIPB<5L>nE%cQ-;|z!8|0btESYCTlHVxLmTyx&&wC`F
zXGLP36^VIPB<5L>m}f;|o)sCbV!swO__HFTRUyxc#5y<RS&^i9@*d_{k(j5$VV)I<
z*>i$<RwU+Gk(ej!VV)I<c~&Im338ZcMPi;H7p-EK7xlBti!%PK$Y_;6D-s{@e0F?s
zrGt4^WVDJMjMV1Om%}_O67#G`%(Egf&x*u6D-!dpNX+x)Fwcs_JS!6OtVqnWA~Da3
z#5^k!^Q=hxlFYLrN%O2o%v0tt&x*u6D-!dpNX)Y$G0%#`JS!6OBt6WtA~DaS!<{P0
zQ|U-^{}%JCNZh4-o)t-YyUep9N%O2oyfb|)X16eApD<>hFy@(cm}f=eZkcCAlIB^F
zm}f;|y=v?(^EA(jj8^$G?l8}a#5^k!^Q=hBvm$Z1_sX9Yi7${Zk}G6Z3CZVfIle@`
zROVTc<Z!nf^Q=hBvm!B1(!<;>$2?CD^VbLFsd|{dJ}}RU#5^k!^Q=hBvm!Ci+`~L8
z5_7*1^UOVbW4aLYtVqnWA~Da3#5^k!^Q=hBvm!Ciio`rC63>(GlzCPpIU2G4tVq&4
zD-th|TjYiEBKZM%sm!w?Dao@Uu|_g`DLu`zA~Da3#5^k!^Q=hBvm!Ciio`rC67#G`
z%(Egf&x*u6D-!dpNX%V#%(Egf&x*u6D-!dpNX)Y$G0%#`JS!4+%J0bU$~-HQe0C~g
zo)w8%Q^u?*W1ba>Q*M7&B<}HO_%jS~pVIwuO6FOS<nydZ%(Egf&x*u6D>7Qe-oGQG
zG0k8x&0sOjU@^^LG0k8x&0sOjU@^^LG0k8x&0sOjU@^^LG0k8x&0sOjU@`L<EM`7~
z#n>->IQAJV#(rtH&tNfjO?w}F28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1i)jXn
zX$FgF28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1i)jXnX$FgF
z28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1i)jXnX$FgF28(G1
zi)jXnX$Fh2<9bvyrWq`z87!t5ET$POrWq`z87!t5ET$POrWq`z87!t5ET$PO#_sFW
zsLf}vm}an;X0RChV|iUPgT>e%>uI0CVw%BXn!#e4!D5=hVw%BXn!#e4!D9c1y*Gi9
z>paghtI>d1bs5>hHnEt9DsyawvPclzL{dZ~lLR0EXe<R>+y$@<G`g!7pckmSK`h~|
zV(ohswlj_`S+Z>Hl35xjPGSHJ2>=;z6|u|478}AQz?N#^mWhWw-}iJkDO%DfIhk|j
zoH-*Ny}Z0#e?7PE_q}iZxc%c^S%a;w*8~fZU?CDLM1qA#un-9rBEdo=Scn7*kzgSb
zEJT8ZNU%^q6D$<a1PcW;!9pZhhy)7-G{HgvO|TFN79znyBv^<93z1+U5-dc5g-Eav
z2^J#3LL^v-1PhU1ArdS^f`v%15D69{!9pZhhy)9fU?CDLM1qA#un-9rBEdo=SSX+g
z77A#Bg-Eav2^J#3LL^uypa~WVXo7_TnqZ-TCRiw-2^Nwy;nE2tScn7*kzgSbEJT8Z
zNU#tI79znyBv^<93z1+U5-dc5g-Eav2^J#3LL^v-1PhU1ArdS^f`v%15D69{!9oE|
zuuwn~EELcL3z1+U5-dc5g-Eav2^J#3LL^v-1PhU1ArdSk>yzdD$f|W!O|TFN79zny
zBv^<93z1+eeaFW>;9u!GHTJOR8JU5sl=XO@5xp?>Dbc@^@A{R#OJlc+{z%?)rBA<Y
zSISDfPmAjJ>`GaKr?0#@_M85dtzXqWtzR2^MD$xas`cCGci8_7`WLFx^f*^edrRE3
z(*K`zTUO%9`viWE?a!i`dn*H)dn*H)dn*G&sLsJw21d{==##3(J^ERUx#+#}{ku}`
zd-FS@_p|2#^g;H2T)D<W?0Fb{1l5`LO5;)a&RuEDlb%^={A>1q68#iof0y@sj6IK|
zPq2SJ@40|I3(-%bpW!_h>A5u)qf5r_k?l4;x5iTTEMw1dJ*&nF_Jq()V~b?Z4w>Vv
zG@jNoX~fVtuS}pxG=-+o44OrAXdW$~MYMwMM0cUP(LLy1^bfSAvN}%n579qDKaYL^
z{bTft=$FtxLBEXtDf(yVSJ1DbUqio+egpj``YrU^=y%XRN1suZd(PbNUnRf6{J7{0
zR91t?wyXvbmDM1kvKmBGR)dJjY7kLb4I(P5K}2OWh^VXv5tY>-qOux9R91tC%4!f%
zoo}zw)gYp>8btIXY|Cm8+5RZ{JE*J%kv*~+MD%X<$Z8P(D*1h-yi$H&sVb{MM6aT<
z8br2#jNU;19{mUOC#b9jk=Mv-5K&nTA}XsvL}fLIsH_GNmDM1kvKmD6AK8|*aI!6{
zK}2OWh<}x?1`(CjAfmDwM6{LtQ_)-4BdbAVzpRB5mDM1kI=@||t3gEd+hLWi1`*Zy
z?J8XjA}XsvL}fLIsLpR!>1q&BSq<V}CBKpUEm2twA}XsvL}fLI=nqj@4I<mJ8pOXU
zAge({Wi^PXtOgO4wQ!=c8pOZKkkuffM|6*_1`&M`eHncP{Q;`q#jE6Zk@7ye8pLlh
zD>Ipunas*eW@RR`GLu=E$*jy|R%S9QGnti{%*sq=WhS#SlUbR`tjuIqW-==?nU$H$
z%1mZuCbKe=S((YK%w$$(GAlEgm6^=SOlD;!voe!enaQloWL9P}D>Ipunas*eW@RR`
zGLu=E$*jy|R%S9QGnti{%*sq=WhS#SlUbR`tjuIqW-==?nU$H$%1mZuCbKe=S((YK
z%w$$(GAlEgm6^=SOlD;!voe!enaQloWL9P}D>Ipunas*eW@RR`GLu=E$*jy|R%S9Q
zGnti{%*sq=WhS#SlUbR`tjuIqW-==?nU$H$%1mZuCbKe=S((YK%w$$(GAlEgm6^=S
zOlD;!voe!enaQloWL9P}D>Ipunas*eW@RR`GLu=E$*jy|R%S9QGnti{%*sq=WhS#S
zlUbR`tjuIqW-==?nU$H$%1mZuCbKe=S((YK%w$$(GAlEgm6^=SOlD;!voe!enaQlo
zWL9P}D>Ipunas*eW@RR`GLu=E$*jy|R%S9QGnti{%*sq=WhS#SlUbR`tjuIqW-==?
znU$H$%1mZuCbKe=S((YK%w$$(GAlEgm6^=SOlD;!voe!enaQloWL9P}D>Ipunas*e
zW@RR`GLu=E$*jy|R%S9QGnti{%*sq=WhS#SlUbR`tjuIqW-==?nU$H$%1mZuCbKe=
zS((YK%w$$(GAlEgm6^=SOlD;!voe!enaQloWL9P}D>Ipunas*eW@RR`GLu=E$*jy|
zR%S9QGnti{%*reh%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y
z%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej
z!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o
z63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKY
zBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imO
zEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y
z%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej
z!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o
z63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKY
zBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63imOEE3Ej!7LKYBEc*Y%p$=o63iyS
zY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH
z%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S
z!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX
z63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%D
zCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iyS
zY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH
z%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S
z!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX
z63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!E6%D
zCc$hH%qGEX63iySY!b{S!E6%DCc$hH%qGEX63iySY!b{S!5k9IA;BCH%pt)X63ijN
z91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH
z%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS
z!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X
z63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9I
zA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN
z91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH
z%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS
z!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X
z63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9IA;BCH%pt)X63ijN91_eS!5k9I
zA;BCH%pt)X63ijN91_eS!5k9IA;BCH%q78G63ivRToTMB!CVr|CBa-0%q78G63ivR
zToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0
z%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB
z!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G
z63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|
zCBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivR
zToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0
z%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB
z!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G
z63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|CBa-0%q78G63ivRToTMB!CVr|
zCBa-0%q78G63ivRo{|K6*#DFy*oQ>rj&q`N$2n2C<D976aZXh3I4AlrDtDZdZMox|
zsN8W*^t1BYfu|&+bX)E?Cn|TG6P0_)iOL=4MCFci{--2`WWVH(DnFI9xl^|F_sCC4
z&dBQ}VdRyPFuE;w=n|DX&WZlVF?k}IWQ&ZIY>}Tzp2)W3i5$P=iKyg>9J$_cPE_vJ
zB`SBE6a5l<<c@Q)Eq9y~l{?OfeueF?p<hS8fyy1{<fn4SIZ?UeoT%J!PE_tVCn|TG
z6O}v8iOL=4ME9X`$2r-SJI;y99p^;lj&q`N$2n2C<D976aZXh3btWozoD-Eh&WXw$
z=S1ahV4`xzIZ<6>^OWR?Zp$6#MCFciqH@PMQMu!ssN8W*RPHz@%9)Wo(QUcooT%J!
zPE_tVCn|TG6XpC%p6IsRaZXf!ll7G3iK^UjPE>z;^_1j^s@!o-RPHz@DtDX{m3xJW
z${puK<z8W;a>qGQx#OIu+;L7+?l>nZcbpTIJI;y99p^;lj&q`N$2n2C<D976aZXh3
zI43H1oD-Eh&WXw$=S1a>bE0y`IZ?UeoT%J!PE_tgA}V*B6Qx_k#kwtboD-Eh&WXw$
z=loBJJ7kpjLRIcHCo1=v^FJk>e}~_r^F2D>qw_sF-=p(AI^U!7Jv!f$?`|EXo$t~4
z9-Z&e`5v9`(fJ;o@6q`lo$t~49-Z&e`5v9`(fJ;o@6q`lo$t~49-Z&e`5v9`(fJ;o
z@6q`lo$t~49-Z&e`5v9`(fOWylYYqW(fJ;o@6q|5UpwFPYv+4@?R-zZTUE95Jv!f`
z^F2D>qw_sF-=p(AI^UD;RyikhzDMVKbiPODdvv}>=X-R%N9TKVzDMVKbiPODdvv}>
z=X-R%N9TKVzDMVKbiPODdvv}>=X-R%N9TKVzDMVKbiPODdvv}>=X-R%N9TKVzDMVK
z@=dzT@5wi*>Oyo8x&&=Qm!iwi<>(4Dgswu>K^_kBaFB<CJRIcVAP)z5ILO069uD$w
zkcWdj9OU634+nWT$iqP%4)So2hl4yE<l!I>2YEQilkZLaL>?ML6KE1mp=mUS=27*X
zhwnUm=ixgK-+B1X!*?FO^YERA?>v0x;X4oCMetn&-$n3U1m8vQT?F4n@LdGoMetn&
z-$n3U1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n
z@LdGoMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$n3U
z1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n@LdGo
zMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$n3U1m8vQT?F4n@LdGoMetn&-$nSwiQtzA
zeu?0h2!4s+mk54|;Fkz~iQtzAeu?0h2!4s+mk54|;Fkz~iQtzAeu?0h2!4s+mk54|
z;Fk#BI1xHOLgz>5{0N;Nq4OhjeuU1C$gFIcKSKXU=>G`)AEEyv^naB8kJA59`aeql
zN9q44{U4?Oqx652{*TiCQTjhh|3~Fdi_82``O~6mKRSTwOe~5oqWB_;FQWJ&iZ7!0
zB8o4f_#%ogqWB_;FQWJ&iZ7!0B8o4f_#%ogqWB_;FQWJ&iZ7!0B8o4f_#%ogqWB_;
zFQWJ&iZ7!0B8o4f_#%ogqWB_;FQWJ&iZ7!0B8o4f_#%ogqWB_;FQWJ&iZ7!0B8o4f
z_#%ogqWB_;FQWJ&iZ7!0B8o4f_#%ogqWB_;FQWJ&iZ7!0B8o4f_#%ogqWB_;FQWJ&
ziZ7!0B8o4f_#%ogqWB_;FQWJ&iZ7ykA4T~-it>FF#VJvo62&P|oD#(;QJfORDN&pf
z#VJvo62&P|oD#(;QJfORDN&pf#VJvo62&P|oD#(;QJfORDN&pfl|NxgAL5rNeu?6j
zD1M3JmneRT;+H6XiQ<<ieu?6jD1M3JmneRDTGmhA?tfZVPR<j(G&WoGN9@sA?$feD
zQuU^+^n1GXtGeC#Eq#rwid6j$d!9l6LRD5ps=g)bxSp0(k+Lo8Ayq$%s&}52^^mIi
zr<kW@J*2AsndNC&52?BZeNxr92c3)FJNCHjxu5L^&<DpJl|2u!{V@6nD);S|{rb0!
zo|e^*`aYjTKgByd#`fdr6THI$wilwGMnA(lEYfo#D;`ysqVo5<Wn2D!x9HP)28<Z`
z2YP;te~bPh`bX&J(J!EXjD8XQ68b0Tm(f2({|x;K`c?F6=-1J2px;Elg?=0T4*KWl
zGpe`llJg&<vN0+fqp~q78<Q2Vx64npvN0+fqp~q78>6x@DjRFn%Enr?vN0+fqp~q7
z8>6x@DjN%EWn)w}MrC7EHb!M*R5nIsV*#yfjLOCgt!&KD%EqW{%+Sil46SU8%Ek<>
zY|PNg#tf}&jLOESY>djr46SU;(8|UPt!&KD%Ek<>Y|PNg#tf}&%+Sil46SU8%EqW{
zOxCRG9<6MQ%EqW{%+SilsBBDDkm|NpHfCsLV}@2XW@u$&hE_IaXk}xDRyJm6Wn+d`
zHfCsLV}@2XW@u$&hE_IaXk}xDRyJm6Wn+d`HfCsLV}@2XW@u$&hE_I4W#d#fPG#d%
zHcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V_I
zW#d#fPG#d%Hcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;Z
zR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V_IW#d#f
zPG#d%Hcn;ZR5ng!<5V_IW#d#fPG#d%Hcn;ZR5ng!<5V`m>?OhMCBf_^!R#f$>?OhM
zCBf_^!R#f$>?OhMCBf_^!R#f$>^;FOCBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu
z!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@g
zEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#
zCBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu
z!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBZBu!7L@gEG5A#CBd8|!JH()
zoFu`VB*B~{!JH()oFu`VB*B~{!JH()oFu`VB*B~{!JH()oFu`VB*B~{!JH()oFu`V
zB*B~{!JH()oFu`VB*APX!E7YKY$U;KB*APX!E7YKY$U;KB*8o+!8|0vJS4$9B*8o+
zN#`f&{3M;9r1O(>ev-~l()md`KS}2&>HH*}pQQ7XbbgY~Pty5GIzLJ0C+Ykoou8!h
zlXQNP&QH?$Njg7C=O^j>B%Pn6^OJOblFm=k`AIrIN#`f&{3M;9r1O(>ev-~l()md`
zKS}2&>HH*}pQQ7XbbgY~Pty5GIzLJ0C+Ykoou8!hlXQNP&QH?$Njg7C=O^j>B%Pn6
z^OJOblFm=k`AIrIN#`f&{3M;9r1O(>ev-~l()md`KS}2&>HH*}pQQ7XbbgY~Pty5G
zIzLJ0C+Ykoou8!hlXQNP&QH?$Njg7C=O^j>B%Pn6^OJOblFm=k`AIrIN#`f&{3M;9
zr1O(>ev-~l()md`KS}2&>HH*}pQQ7XbbgY~Pty5GIzLJ0C+Ykoou8!hlXQNP&QH?$
zNjg7C=O^j>B%Pn6^OJOblFm=k`6)U-MdzpJ{1ly^qVrR9eu~ad(fKJlKSk%K==>C&
zpQ7_qbbgA?Pto})IzL6{r|A3?ou8ufQ*?fc&QH<#DLOwz=cnlW6rG=<^HX$wiq22b
z`6)U-MdzpJ{1ly^qVrR9eu~ad(fKJlKSk%K==>C&pQ7_qbbgA?Pto})IzL6{r|A3?
zou8ufQ*?fc&QH<#DLOwz=cnlW6rG=<^HX$wiq22b`6)U-MdzpJ{1ly^qVrR9eu~ad
z(fKJlKSk%K==>C&pQ7_qbbgA?Pto})IzL6{r|A3?ou8ufQ*?fc&QH<#DLOwz=co9S
zX^KCYrudU-N`B|K%%76qHmd5C(v<wRQB|*$rsTJcs(Pg~CBJP{)hneb9F)RADIAo-
zK`9)R!a*q<l)^zN9F)RADIAo-K`9)R!a*q<l)^zN9F)RADIAo-K`9)R!a*q<l)^zN
z9F)RADIAo-K`9)R!a*q<l)^zN9F)RADIAo-K`9)R#zAQul*U169F)dEX&jWsL1`S6
z#zAQul*U169F)dEX&jWsL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQul*U169F)dE
zX&jWsL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQu
zl*U169F)dEX&jWsL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQul*U169F)dEX&jWs
zL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQul*U169F)dEX&jWsL1`S6#zAQul&163
zbbgx7Pt*BnIzLV4r|JAOou8)j({z5C&QH_%X*xem=cnoXG@YNO^V4*Gn$Azt`Dr>o
zP3NcS{4|}Prt{Nuewxlt)A?ySKTYSS>HIXEpQiKEbbgx7Pt*BnIzL0_XXyM4ou8re
zGjx82&d<>K89F~h=V$2r44t2$^D|uS%y6|c!`04=tc_Xb&)|p*j>zDMjI52({rdam
zjI52(ZT%f|26tp|M+SFfa7Sj!Hhs+${mn=Qr(|$S2B&0jN(QH7a7qTJWN=Cbr(|$S
z2B&0jN(QH7a7qTJWN=Cbr(|$S2B&0jN(QH7a7qTJWN=Cbr(|$S2B&0jN(QH7a7qTJ
zWN=Cbr(|$S2B&0jN(QH7a7qTJWN=Cbr(|$S2B&0jN(QH7a7qTJWN=Cbr(|$S2B&0j
zN(QH7a7qTJWN=Cbr(|$S2B&0jN(QH7a7qTJWN=Cbr(|$S2B&0jN(QH7_^!$DU6bLv
zCc}44hVPmTKFZ*u3_i->qYOUE;G+ya%HX36KFZ*u3_i->qYOUE;G+ya%HX36KFZ*u
z3_i->qYOUE;G+ya%HX36KFZ*u3_i->qYOUE;G+ya%HX36*FrP6DTA9bxG961GPo(r
zb(JjFRkB=H$#PvK%XO73*HyAySIM^Owa_frRkB=H$#PvK%XO73*HyAySIKf+CChb{
zEZ0@CTvy3*T_wwPl`Pj)vRqfma$P0Mb(JjFRkB=H$#PvK%XO73*HyAySIKf+C2Qyv
zv#g=lLbHZmG0Pfy#Vl*+6|=0N*Fv*gSIKf+C2Qyvvn<zDvRqfma$P0Mb(JjFRkB=H
z$#PvK%XO73*HyAySIKf+CChb{tfALJvxZ&^&2n8O%XO73*HyBHUNOrWdc`bj=oPc9
zp;yeZTvy2&dc`bj=oPc9p;yeZhF&qta$O~B=oPc9p;yeZhF&qt8hXVnYv>iTEZ0@C
zhF&qt8hXVn%XO73*HyAySIKf+B}Zj*R5nLtb5u4*Wph+EM`d$VHb-T1R5nLtb5u4*
zWph+EM`d$VHb-T1R5nLtb5u4*Wph+EM`d$VHb-T1R5nLtb5u4*Wph+EM`d$VHb-T1
zR5nLtb5u4*Wph+EM`d$VHb-T1R5nLtb5u4*Wph+EM`d$VHb-T1R5nLtb5u4*Wph+E
zM`d$VHb-T1R5nLtb5u4*Wph+EM`d$VHb-T1R5nLtb5u4*Wph+EM`d$VHb-T1R5nLt
zb5u4*Wph+EM`iO=Hcw^qR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZW%E=vPi6B|
zHcw^qR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZ
zW%E=vPi6B|Hcw^qR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZW%E=vPi6B|Hcw^q
zR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZW%E=vPi6B|Hcw^qR5nj#^HerZW%E?F
zKxGS5wm@YIRJK563skm1WeZfcKxGS5wm@YIRJK563skm1WeZfcKxGS5wm@YIRJK56
z3skm1WeZfcKxGS5wm@YIRJK563skm1WeZfcKxGS5wm@YIRJK563skm1WeZfcKxGS5
zwm@YIRJK563skm1WeZfcKxGS5wm@YIRJK563skm1WeZfcKxGS5wm@YIRJK563skm1
zWeZfcKxGS5wm@YIRJK563skm1WeZfcKxGS5wm@YIRJK563skm1Ws6j{NM(yuwn$}*
zRJKTEi&VBqWs6j{NM(yuwn$}*RJKTEi&VBqWs6j{NM(yuwn$}*RJKTEi&VBqWs6j{
zNM(yuwn$}*RJKTEi&VBqWs6j{NM(yuwn$}*RJKTEi&VBqWs6j{NM(yuwn$}*RJKTE
zi&VBqWs6j{NM(yuwn$}*RJKTEi&VBqWs6j{NM(yuwn$}*RJKTEi&VBqWs6j{NM(yu
zwn$}*RJKTEi&VBqWs6j{NM(yuwn$}*RJKTEi&VBmWlL1HL}g1<wnSx1RJKHAOH{T*
zWlL1HL}g1<wnSx1RJKHAOH{T*WlL1HL}g1<wnSx1RJKHAOH{T*WlL1HL}g1<wnSx1
zRJKHAOH{T*WlL1HL}g1<wnSx1RJKHAOH{T*WlL1HL}g1<wnSx1RJKHAOH{T*WlL1H
zL}g1<wnSx1RJKHAOH{T*WlL1HL}g1<wnSx1RJKHAOH{T*WlL1HL}g1<wnSx1RJKHA
zOH{T*WlL1HL}g1<wnSx1RJKHA%T%^ZWy`*E@~62n^(|B1GW9J}-!k<rQ{OW6EmPkz
z^(|B1GW9J}-!k<rQ{OW6EmPkz^(|B1GW9J}-!k<rQ{OW6EmPkz^(|B1GW9J}-!k<r
zQ{OW6EmPkz^(|B1GW9J}-!k<rQ{OW6EmPkz^(|B1GW9J}-!k<rQ{OW6EmPkz^(|B1
zGW9J}-!k<rQ{OW6EmPkz^(|B1GW9J}-!k<rQ{OW6EmPkz^(|B1GW9J}-!k<rQ{OW6
zEmPkz^(|B1GW9J}-!k>BP~Qsmtx(wtm90?O3YD!;*$S1dP}vHVtx(wtm90?O3YD!;
z*$S1dP}vHVtx(wtm90?O3YD!;*$S1dP}vHVtx(wtm90?O3YD!;*$S1dP}vHVtx(wt
zm90?O3YD!;*$S1dP}vHVtx(wtm90?O3YD!;*$S1dP}vHVtx(wtm90?O3YD!;*$S1d
zP}vHVtx(wtm90?O3YD!;*$S1dP}vHVtx(wtm90?O3YD!;*$S1dP}vHVtx(wtm90?O
z3YD!;*`4ydr>1|WK3hukgKxhndK-HCSWvd_K;=18vV9lZbH?uS@06!{$xr18GV*%4
z7t_Z?r|6!kx1a|5SF*hdU9GCmr4s##Zu`HC{(JN<(f#PN=qu<C(Z7*Dz3%k?ShoYe
zk8V}f=U9o#bFBP3Z#|&LaO<e-|9A2%=6~n^E4l0PhedxI{g~Ws?60P*L3>pFD|Ej<
zgqo;@+NguN=u^DjLnCMuO`u6Mg{IMr=sxKCpzo7=KFc2H`{XXovJHJ7^nHG%@AE5t
zpWKsKRq6ZuO5f*K`aZwX_xY8+&#&}-a!+PerSFq_GOH?mpWKuAHva*k&k~iVW{b*G
zv;7Bzt}0K>_8$<s>=(MKJT+TXo|-KxPt6vUr)G=FQ?o_osoA3P)NE0CYPP66HCt4k
znk_0%%@&oXW{b*Gvqj~p+5S=JqtHj8k3t`XJ_>yl`Y7~K=%dg_p^rizg+2;>6#6Li
zQRt)4N1=~GABBDp`a$Rip&x{P5c)yr2caK?eh~UW=m()6gnkhELFfmeAB27o`a$Ri
zp&x{P5c>Cpe!u_wLRXb1hWo!SbX9p8xc~b?m;FLl)jN!RU+Ajx1aMJ#0=TF=0bEp`
z04^#|02h@ffQ!l#z(wT=;G*&ba8Y>zxTrh<TvYGId<gm>=!c*mf_@14A?SyoAA)`e
z`XT6tpdW&M2>K!DhoB#VehB&@=!c*mf_@14Vd#gUABKJy`eEpYp&y2R82Vx8hoK*a
zei-^;=!c;nhJG0OVd#gUABKJy`eEotpdW#L1o{!^N1z{pegygv=trO*fqn$~5$H#t
zAAx=Z`Vr_ypdW#L1o{!^N1z{teiZsq=trR+g?<$JQRqjZABBDt`cdddp&x~Q6#7x<
zN1-2ueiZsq=trR+h5iGfFZTaH=%T_>m1m}i$}>|$<(Vm>^2`)bd1i{JJTt}rs*L)u
zs3zpAa?H2+UzKB4)r@*o-beP!`>1M0y(;gcsu}gFypO78)T?sL`g+Z%SLK*hHKSgY
zV^-CSdR2~DRWs^UIp*8^$DkjBehm6C=*OTRgMJM9G3dvjAA^1j`Z4IopdW*N4EizX
z$DkjBehm6C=*OTRhkhLTap=dPABTP%`f=#Tp&y5S9QtwS$DtpGejNI7=*OWShkhLT
zap=dPABTPd`U&VKpr3$#0{RK)C!n8zeggUl=qI3`fPMn{3Fs%FpMZV>`U&VKpr3$#
z0{ThlC!wE&eiHgg=qI6{gnknGN$4k`pM-uA`bp>~p`V0)68cH#C!wE&eiHgg=%=8c
zf_@76Dd?x5pMri0`YGtApr3+%3i>JNr=XvLehT_2=%=8cf_@76Dd?x5pN4)K`f2E=
zp`V6+8v1GIr=g#Qej55|=%=BdhJG6QY3Qe+pN4)K`f2E=p`V6+2KpK3XP}>feg^s(
z=x3mxfqn-18R%!ApMib``WfhFpr3($2KpK3XP}>feg^tk=x3pyg?<+LS?Fh>pM`!F
z`dR2_p`V3*7W!G}XQ7{keir&!=x3pyg?<+LS?K4WpM!o5`Z?(5pr3<&4*EIh=b)d1
zeh&IM=;xrHgMJSBIq2u0pM!o5`Z?(5pr40+9{PFc=b@j6ejfUH=;xuIhkhRVdFbb%
zpND=P`g!Q*p`V9-9{PFc=b@j6egXOg=og@0fPMk`1?U%`Ux0oA`UU70pkIJ~0r~~#
z7ocB&egXOg=og@0fPMk`Md%lyUxa=U`bFp$p<jf45&A{w7olH-ei8ab=og`1gnkkF
zMd%lyUxa=U`bFsa%)Sr%^_hLD`YoeR*;CbT8GWXn?1!$;)YEPKmeFVGsp_|kK2uLs
zzh(59daC*@qtDb+)o&Snrk<*P%jh%pRP|d%pNsclQKjp1@njEleUhDQL)Yil$xor{
zbL(_l>H6F{Ri*25>-6<X*XP!$DqWvjr>b;)Zk?*q^|^Jo`Ssaz9~M=*K6_5~K-Xu_
z$u@L-_MH3_x;}eOx0SBXo>Nu2K6_4IuXKI(oT}3G*>kE&|2ydV>^a?5`X%U>pkIQ1
z3Hl}Im!MyQehK;|=$D{hf_@45CFqx+UxI!K`X%U>pkIQ13Hl}Im!V&Vei`~@=$D~i
zhJG3PW$2foUxt1e`eo>sp<jl68Tw`Dm!V&Vei`~@=$D~ifqn)073f!>Ux9uF`W5I`
zpkIN01^N}}SD;^keg*m!=vSa$fqn)073f!>Ux9uV`c>#xp<ji575Y`^SD{~peiiyv
z=vSd%g?<(KRp?itUxj`Z`c>#xp<ji575X*k*Pvg6ehvCH=+~fMgMJPAHR#u%UxR)P
z`Zeg+pkIT24f-|c*Pvg6ehvCH=+~iNhkhOUb?DcjUx$7j`gQ2np<jo79r|_X*P&mB
zejWOC=+~iNhkhOUb?Dcj-++Dt`VHtepx=Og1Nsf<H=y5uegpaq=r^F>fPMq|4d^$Z
z-++Dt`VHtepx=Og6Z%c)H=*BzeiQml=r^I?gnkqHP3SkF--Lb>`c3FJq2Gjl6Z%c)
zH=*BzeiQoN2k!RW^pD9gJR$nqszOu^p(bjfHtL}6*b@PtjuMqo0iTW%l~JNHN>oOP
z$|zA8C90!Z7}dh47Dlx&s)bQ4jA~(23!_>XHHA@A7&V1aQy4XcQBxQ-g;7%&HHA^F
zjA~_6E2CN&)yk+=Mzu1kl~JvXn#!oDjGD@*sf?P+sHu#a%BZP~n#!nYjGD%%X^fi2
zsA-Iv#;9qGn#QPUjQW6#`t`sEWR$8rwKMPmslKW_wKMPmc^}y?@1rVD?G%-#c8c1l
zJhfA{<+(Yc^3+aId1|MqJhf9)p4urYPwf<yr*?|UQ#(cFshy(o)Xu<k=+mK3hdv$p
zbm-HePlrAo`gG{ip--1j@#}%<(5FM64t+ZG>CmS`pALOG^y$#2L!SYC2J{)wXF#6;
zU7kK9?>__j4CphU&wxGy`V8nZpwECl1Nsc;Goa6aJ_Gs;=rf?tggz7cOz1PA&x9_|
zXcD?SNe0z3KNI>)=rf_uggz7cOz1PA&xAe``b_9Eq0fXq6Z$OZv!Ks{J`4IR=(C{D
zf<BASJ`4IR=(C{Df<6oSEa<bK&w@S+`Yh<PpwEIn3;Jy6v!Tz1J{$UM=(C~EhCUnm
zZ0NJ0&xSr5`fTX4q0fds8~SYMv!Tz1J{$UM=<}h^hdv+reCYF`&xbxA`h4i~q0fgt
zANqXga!(QI;rY<#L!S?QKJ@v}=R=<leLnOB&=){o0DS@U1<)5jUjTgp^aaotKwkiT
z0rUmX7eHSCeF5|Z&=){o0DS@U1<)5lUkH66^o7tDLYHSKNvFy4Nl@*&h0qs5UkH66
zbh*=veD;OV7eZeMeIfLP&=*2q2z?>+MbH;PUj%&-^hMAYL0<%Y5ube#^hMAYL0<%Y
z5%fjS7eQYHeG&9U&=)~p1bq?o#n2Z+UkrUQ^u^E@LthMiG4#dI7eikReKGXK&=*5r
z41F>5#n2Z+UkrUQ^u^GZKwkoV3G^k<mq3?i$I01V0(}YeCD4~ZUjlszbh$f`ocSft
zmq1?veF^j>(3e180(}YeHt228+n~2WZ-d?jy$yOB^fu^i(A%K5L2rZJ2E7e>8}v5l
zZP44Gw?S`%z7+aW=u4q5g}xNJJS$H=`%>ugqzJb4TV^TrrO=l`UkZIG^rg_3LSG7f
zDfFe#mqK3(eHrv+(3e4927MXyWzd&FUj}^{pM4qhWzd&FUj|+7h9c)*?%9Cqcib}Q
z%b?5OOJI+F$I0qo(dE#WLthSkIrQbwmqT9;eL3{y(3eAB4t+WF<<OTyUk-gapM5#>
z<<OTyU(RP=4t)jm70_2eUjcmu^cB!oKwklU1@slrS3q9@eFgLt&{sfT0euDZ70_2e
zUjcmu^bqtA^bqtA^bqtA^bqtA^bqtA^bqtA^bqtA^bqtA^bqtA^bqtA^bmAY=)V>)
zg{~^k1P_=(SCwai2TY;Mexa+%Gr>jWnc$-GOmI<oCb+0P6I@iD2`(zn1Q(TOf{V&C
z!A0en;G*(Oa8Y?CxTri6TvVP39#{>1HT2ccS3_S7eKqve&{soW4ShBA)zDW%Uk!aV
z^wrQ;LthPjHT2ccS3_S7-GXjGx1d|lE$9|>3%Ui}f^I>#pj*%_=oWMfx&_^WZb7%8
zThJ}&Hgp@h4c&%rL${&Z&~4~8bQ`)2-G**Mx1rn6ZRj?18@dhMhHgW5pgYhV=nixT
zx&z&T?m%~-JJ22I4s-{)1Kok{KzE=!&>iRwbO*W%-G%N#ccHt`UFa@!7rG1Gh3-Ok
zp}Wvs=q_{@x(nTf?m~B=yU^D_Ujuy&^fl1eKwkrW4fHk8*FawbeGT+A(APj;1APtj
zHPF{UUjuy&^fl1eKwk@eE%dd}*Fs+leJ%90(APp=3w<s0wb0i>UkiOL^tI5}LSGAg
zE%dd}*Fs+leI4|5(APm<2Yns%b<o#AUk801^mWkJL0<=b9rSh3*Fj$geI4|5(APm<
z2Yns%_0ZQtUk`mf^!3o!LthVlJ@oa^*F#?qeLeK`(APs>4}CrK_0ZQtUk`mf^!3o&
zp|?YChu#jo9eO+TcIfTU+o88ZZ-?Fvy&ZZx^mgd&(A%N6LvM%P4!s@v2Iw20Z-Bl5
z`UdD5pl^V_0s02$8=!B1z5)6M=o_GKfW86x2Iw20Z-Bl5`UdD7&^w@aK<|Lw0lfoy
z2lNi;9nd?VcR=re-T}P>dI$6l=pE2Ipm#v;fZhSU6M84~PUxM`JE3<%?}Xk7y%TyT
z^iJrV&^w`bLhpp$3B40~C-hF}ozOd>hoOg|hoOg|hoOg|hoOg|hoOg|hoOg|hoOg|
zhoOg|hoOg|hoOg|hoN^t?}FY1y$gC5^e*UK(7T{_LGOaz1-%P;7xXUZUC_IrcR}xh
z-UYo2dKdI==-tq}p?5>?hTaXm8+teNZs^_6yP<bO?}pwDy&HNr^ls?g(7T~`L+^&(
z1HA`&5A+`BJ<xlg_dxG~-UGb{dJps-=snPTp!Y!Uf!+hX2YL_m9_T&Ld!hG2?}gqA
zy%%~f^j_$_(0ifxLhps%3%wV5FZ5pMz0iB1_d@T5-V41K`bOv*p>Kq~5&A~x8=-H6
zz7hIH=o_JLguW5_M(7)%Z-l-P`bOv*p>Kq~5&A~xo1kxkz6ts!=$oK#g1!m*Cg_`>
zZ-TxF`X=a`pl^b{3Hm1Jo1kxkz6ts!=$oMTLGOd!2fYt^AM`%xebD=$_d)N2-Uq!8
zdLQ&Y=zY-pp!Y%VgWd<d4|*T;e(3$s`=R$k?}y$Gy&rl%^nU35(EFkHL+^*)54|6H
zKlFa+{m}cN_e1Z8J^+0H`T+C+=mXFPpbtPFfIa|y0Qvy*0q6tJ2cQo?AAmjpeE|9Z
z^a1Dt(6>R~27Md!ZP2$t-v)gf^li|$LEi>_8}x0^w?W?qeH-*`(6>R~27Md!ZP2$t
z-wu5{^zG2ML*EX4JM`_)w?p3!eLM8+(6>Y14t+cH?a;SF-wu5{^zG2ML*EX42lO4#
zcR=3(eFyX%(04%J0euJb9ng0`-vNCG^c~Q5K;Hp<2lO4#cR=3(eFyZXggz_ql+aaW
zZC>Chp{vT;yuedJm;FLlm9=@IvNlgt*5--I+B{KNn<px3^F(EBo~W$N6P2}jqOvwm
zRMzH+%Gx|pS(_&+Yx4pgbPu`*-GlBy_n>>wJ?I{E54s24gYH51pnK3g=pJ+rx(D5Z
z?m;gI{mwu^=&BzZdniy4x@wQA&}F~SRZY}FZPY<s^eJBNp%FBSCeS3BLepqQv<STj
zy$HPsy$HPsy$HPsy(pjk&OlK<yQ<QQ^4V3DUX;(Ss`R3Kc2%Vp<+H0Qy(phuRp}+@
zCFmvSCFmvSCFmvSCFmvSCFmvSCFmvSCFmvSCFmvSCFmvSCFmvSW$0z-W$0z-W$0z-
zW$0z-W$0z-W$0z-W$0z-W$0z-W$0z-W$0z-W#~Jh?}WY+`cCLOq3?vg6Z%f*JE8A{
zz7zUR=sThBguWB{PUt(K?}WY+`cCLOq3?pe3;HhTyP)raz6<&;=)0irg1!s-F6g_U
z?}EMy`Y!0Zpzngd3;HhTyP)raz8m^(=)0lshQ1s6Zs@zA?}ok``fljEq3?#i8~SeO
zyP@xfz8m^(=)0lshQ1s69_V|Z?}5Gt`X1<epzndc2l^i9d!X-uz6bgq=zE~=fxZX&
z9_V|Z?}5Gt`X1<eq3?yh7y4f4d!g@zz8Csl=zF2>g}xX1Ug&$F?}fe>`d;XJq3?yh
z7y4f4d!g$};CTUE2`nlsRk?$osEJyrjXJ0+`aMQ{k5S)a)b|+mJw|;`j!<4BN2sc!
zz9&aGFQDswRh6Zyd{vdDt9(^;l&<ns)ls_2cV0l(>#FJ~U7f3{qjYtys*cjtxvDx!
zSLe<P=sH_f9i^*kRdtlEs#Vodx~f)HN9n5Cc>!G?tE!`PHLR+R($%o4I!af=s_H0R
z4LdLJETf)f)U%9wmQl|#>RCoT%cy4=^(>>FW7KnudX7=gG3q%+J;$i$81)>Zo@11*
zp`91dHMF9P(iOA1tw*RUW>xhFb;Ycz9^vzhdY)0wGwOLpJ<q7;8TCA)o@dnajCz4l
zFEHu_M!mqO7Z~*dqh4Ut3ygY!Q7<y;MMk~Is23UaBBNep)QgOIkx?%)>Lo_K#Hg1T
z^%A3AV$@5FdWlglG3q5oz09bW8TB%wUS`zGjCz?-FEi?8M!n3aR~YpQqh4XuD~x)D
zQLixS6-K?ns8<-J>xbtBbp5a>qjdeSZtI!X^~0)q=5_tBs-AgWKdh>wbhWUmj?&e_
zsya$n3#;lVT`fE>pzD5Bb(F61Rn<|t%2!oK=_+4U9i^*$=LK}VuBwjG)w!xVN>}Hq
z>L^{EtE!`Pb?&@?uCrCuQM#&DRY&QnT2&pTt7=tsl&-3s7tj@|sya&7qpIpCU5~1&
zqjWv0s*ck2sPh84vQ$+^={izX9i{6?RdtlEBURN=x{h>Spedski^|IFKvPDk%F1m~
zS-CALE4M{u<+iA-+!mFU+kw{@^%|pIW7KPmdW})9G3qr&y~e2581*`%UT4(njC!3>
zuQTd(M!n9c*BSLXquyZD8;p8`QExEn4Mx4es5cn(2BY3!)SHZYlTmLn>P<$y$*4CO
z^(Ld<WYn9CdW%tSG3qTwy~U`v81)vT-eS~SjCxB)86Rx<;8>gJZL0Frc+shb=yzMD
zk9|mV209a+^>$kJ%pSW>^nV%qfapJG|8Jlld^;g~ZbSbCd;TT*A@ugQzb!xgFx$bg
zM`imr(L31xzq0?g(BB^Wi2U>;Z2v3t&ap>i&qvw*9rR;kx5}Qo7%R_zk?lEe|E1_d
zW6MN8A)o8JEsvs)bF}kSTmMGir}ZrQBOTRx8NGsDMX&M7>umoRy@B4;qiy|rw*LYB
z3Hnn#hSnNCt&c5~?FQN$`?PGo#{Sp!6Scm9zR9S!#@;7;{ww-_u;;(&d29Vgw*OD`
zZC*d7+f#jS*F{_O*rrZV;?!35PerFGYwG*ZTllG=?>6;Te)_mpbLx_@kBhdkXX)F0
zvb~J$<zt_a?G<dVWb7)`9Q&Z`U#;8n_s*o&(|)4cw{(u(X?)lJ<+uNf=zjEB-S2+|
z{UQ1{W4FtmACLVD<GX?1*FAx)W3xp6jZy+nqm{SM$@bssF$b>e84LUvt)ZOB0B6$p
z-^Ly^zH1!OQO2`+28`#>7ufS6`ZD?o`UCWYs{FmSC8DEBzx4$<1N-Ff>-|LZgKz&x
z^fvVNu}{hN9q3)?oUu<D`{eKF$$t4edh$y7+j+7re>+drV9(OGUzY8a>{*3M=E$Da
zx-EZ4PgKs;5@VnIO}$Tx?nj^1{r*?bAF2j^AKg0k8QHE#rS{3ue#Y3(aqj0h_j8>4
zTl6^hbDaC-?-J^^9_N0Jb3ezqpX1!maqj0h_fOU1+|P0DpQ^{Xf2tnmevWfL$GM;5
z+|P0D=Q#KK^*Hx)ocsNHoclS>{ZdCcHjZ;Y$9aI`Jiu`t;5ZL(oCi40103f8j`IM=
zd4S_Qz;PbnI1g}~2RP0H9OnU!^8m+rfa5&CaUS3}4{)3ZIL-qc=K+rM0LOWN<2=A|
z9^g0+aGawY=P1WH%5jczoTD7)D91U<agK7Fqa5cb$2rPzj&hu%9Oo#<Im&U4a-5?a
z=P1WH%5jczoTD7)D91U<agK7Fqa5cb$2rPzj&hub<Tx)Hha_E>ihhvo+tAy`o{&9v
zpm(8jq%Mc#Xl1_~t&EbRm2Ej%Rf9b%*<OXNRuwPHJIis(wjANzqW>QKOLRZ_EI)k(
z{UQ2eRXJwWt*Y|3N9BFwn4d8ITE2IFT~t=?iOR}7<FDn<DXOw^&-iQkCX)T~O{6Mo
zDnw;Xg{Z9D6P2}dqOx*NRMwM-%BluYS=Asas~SXQ<({al+!K{m4WhEDK~z>X7#D8&
ze2XFag_hezzu5AA(J!_9w&-87|39$*uh_qj{oiN*A@)DZ{^!_#zU5!as0%Iki2iNM
zheiLc<ssvO|1RHo(Yt*$(R+MnMd$kJqPdoWXuc&OTJU|}xL|z9w@>tT-}9os$@U$-
z6S93L+aG2BU2NYi`+q8Tmb*uE4tfuIuO!<~<<4@d4~;!6`Y`$k`Y8M7p`YdTgKTd`
zKZlO+$|t3cKb5=2iOOB$<lW@1ajN`O?hz+kxksG5zuY5EUL*I2lWn;poV-Tv2q)We
zM>yH`|66^f+zU?ikI>JfUqJsD{UZ7$^iR+~MgI)_3i?&_Yv|X}Z=l~qzlDAq{SNx)
z=rd>){Vw{yqkn<^2lPLp{|WsobRYVCj{gvP7(Id>MW5HtDEE<5eGz>L{Q>$auQ`Su
zM^B(9(NpMY^bC3yJ%^r0FQ6CE|APK4${F@wV*4_B1-**u+~cQy>gB(|_Dyt5Kao5?
zQMCn~g0`Yl(P^luuMez7E!0LG)J4~zYteP+dbAzgfOeprXc+B6yU`xB7u|?%Li^Bu
zbO7CkZbx^Z1?{&$5iOx*ls=UE%jr*dqkGW3s&Z#J`CRg>K-D+UH_^9L<^FOH8#UZi
z!%a20PvbqZN8MDzO*Pz9!%a20PoutG-BgqNG^(nbYH~kD-Bvf%<bI5*>X(|_gYj-r
zbyE#D)o@b{H`Q=c4L8+rQw=xOa8nI8)o@b{H`Q=c4L8-~&WghItD9<ae??VwQ%&x&
zsH$$N$z2vz)lD_I%c82fsV4VYR8=?C<X(%a>ZY1s-Bk0dn`(Y_Q%#;ds;X|P`PEG|
zxgVpdx~V4jV^mc))#QGRs_Lei+>cRJ-Bk0dn`(Y_Q%#;gs;X|P$z2&$)lD_rRKra*
zxhtdYQ8(4(38eZObyH35&8Vtws>vN1Rn<*3xkIC>x~b+@H`V;=rkY>fRP(EwYJPQ7
z&982%`PEG|zq+Z0n`(Y_Q_Zh#s`=GTHNU#4hMQ`*speNV)#N^n@`-R$4L8-~ZjHJ}
z-Bgo%Hma(dY5{dq4L8-~-i*4fZmI>;O|^i!sTNQ-)dK3KT0q@YlY29&s+(#7byH35
z(5R|zs>vN1Rn<*3xlg02x~V4jX;f7=)#N^ns_Lei+^11h-Bb&xn`!}dQ%&yEsH$$N
z;ig(Z-BgpiHL9wcYPhL}n`&~mM%|-ss^O*@ZmQv?n%u2X-c9b-D2kivxT%ht>bR+n
zo9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fK
zxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!
zj+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht
z>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZ
zsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+n
zo9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!j+^SZsg9fK
zxT%ht>bR+no9ei!j+^SZsg9fKxT%ht>bR+no9ei!ftwn*sezjsxT%4g8n~%}n;N*O
zftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g
z8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*
zsezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}
zn;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjs
zxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*O
zftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g8n~%}n;N*Oftwn*sezjsxT%4g
z8n~%}n;N*Oftwn*sezjsxT%4gnz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|Z
zsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tn
zo0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAK
zxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(
ziJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%So
znz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|Z
zsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tno0_<(iJO|ZsfnAKxT%Sonz*Tn
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
PZr+dgQO8;Dp|bx6Kf>?&

diff --git a/fonts/Lato/lato-bolditalic.eot b/fonts/Lato/lato-bolditalic.eot
deleted file mode 100755
index 3d4154936b42522fac84900c689a901ac12875c0..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 266158
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%0DWhOyY(!KK#H5mc
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%0D-S}JUv^5OB@2uO%|&+IC)(Z|
z-DZ&_L0g(e(w9@5S=S*2t3WZl4J%&3RymW3B9++Hcwk1D=@>kGm4{$bIs*z7`>^8$
zLky~L6Ym1xxqaopo5k++_pr)I+h#w3&dTpB^5Gy#Q};S~taI<SNz77NZ+Pjo`f~U`
zwVsC!#3%p|RC36~4$;j!)6T2+U`5*<)PuLOD_avm3LSDVlTQmPI!xg&w>VwrHG~>m
zsvVZz%dt<~o4X>9RIys@T<W88o42_E)lh=ot1#WuyIIifFqyr;v}uC_`z+avPG(ws
z_BcCI$THP%ciHr2lI+GT*3R}FJ)G^qNGH@@hrHO6-@-{5Qevd;zZ+UA2p-p+xi0Je
zal}-0SIgfPFIoERc~rf49hCfGG?3UZMj#bk<Gua(Tzm$lP5D%p!p72*fc4-;5?>QB
z_sLo!qivsZbfp3#xCXR8$)z6|43}*UjqMbten<J)YtzM=EQ`#%Fra^vlGhqmZ-gB%
zJPG{5igRFXXL?oJH86JCrb2}fKBZhb=amrwt($vq7s!MdpnG(;6IkGVWc0+R4+X{U
z*0f&w4X_!m>;)StmY6eGE()pOe9({ev7K1kP@Y&bJqOQZy0THzRr=$eP<Xz_1I)AW
z;{3R>*6WFz(c<;&U&)a9N0<vN^RhY4bEH3%P#|=;8tQb0rZGpXosbEm=v#;<og5w;
zVCbw%Qa*dLUNx)Vs9dKJI>q(~hmna}uEUc}f?+I(Y$BlIHH<=<kXJ7_7ej0@)ShwF
z^$DjrAQXN&4#+zTcpT!514<i;M;6^{&hppNkv7@TIK6as_lV&13>Z>e-A`0)Ksb0i
zk(kpG5k8f&TxC+ken33<TS)W~#7~41vRufj>`y>6v!=}zX+2a0OjsO%pa>yqTO5Yi
ztw;_KoZKu_UcgFNs^&~^WO2M`G|-b5G4TRZHBISM*j(^T3Uy3-5VTevCc=1Tl3e(H
zkC^yQ2NY1ih)+^XxXw@UlM%l{h`ex-ZE=m9=@YV-wKRE&U*y%w)FG3Q+Nnm41ra&m
zd>MCI;s2HUykaR!T>jZutTzGi=wxUL^u6m^zl7gG1wux0EMBLap!mS6poL~5r7|X3
znhnd}0{U&W&v_xkmi$I6aLzm0zQ5i`LtVd7qBp}fMes%-tTqsKgv`eL%y2C-zYVyV
zao7dc7{Az;5U9hc3k(cHbN2ib+fv?<w<I0F55q)fINxpHFA5a`C%#g5K3ZIse7(=e
z_Nl2_2`Hjs(1Bx8bMr$T??CWNdl)c}L&BBWaP~^GqhLoeOml%iAthd_oLM!JGrKGG
zPH+O2L&F1yUL9%^cYD^5b9xz!76YST0p28fo63LJzV}!W{WO2TY;t&1mtPXyKm%t_
zUpQNl3&tGXdL}=5{9ACE0N;psZ?DbS-xZRZBh^^{a)4k8@Uptz$l>oJB0uvlB;N~2
z4@b!ID-;0HNZUkAnvB3#?6Tqgh2(h1u6Nh0hNn(bX+VNr7PZk;TvdE3G964>y^%-k
z+^~XHU_0KaKoQkF3_5Ypw=QpZ;Mz=ZO=^lM4i-i4?+%w7XeS!i6d;BkzYSe<orCm-
z$Q??9rT7(m<Z|eAU_2f)wmwPunY*l1b{;XS_WgL^9b7P!Lp$-Q><~K<%jghs{4HD!
z97BC^KvDNM!xO;wTurnG>V=X-&`6t?!8@rzdBCo5V;{3wPIkz=Nlw=CfYQDPS+0B+
zV!E%uv8&`_ureVJ+cF)wl3-k@Olj=mI=@Jm^O0=W72`5cl?cKJ*riFa(+goGciaqc
z2(;DNxUSZ5FL<2j=J-kqOkgok6aavA@OfY$zY#1dSez3m$RG=Hqd<(Cnm3n2{GiT4
zFPn23l30JaKwD>QF{HO*jOugLls6(35*t*)dtk7XSE@tOH{?_WIv=eB14N>WjoxA3
zr`644LZ>ULpyB|b`G8fNmM0rCas{)Dp928B56eXnvJ)N8HvIsqmdF#Btc?0rrdATm
zntGJ?VMZowDwPPAk>wFmd=~YxPiVKpbTm22$Le^_H6Tm{O6Uy$oP>Db^h0d<Hr&#q
zf&I6^JjBh^e{cz^P<C=?+2wE>Fp?p%1_mHM?p%PKSxz_*59IGCFTH$<L>is_(KXUZ
zA;u{6YqoReE(4SpC-p8!w<rbh6EtC7d8E3T1Q<$)Xh1e8|H`(*RLYeL$)?kF7a3A3
zsI^k)S^s=KC?S^JBuu14D#PC+hJPulfbDeXgZ@%D0iftNK$jdSKs^ThBW6^-M+7@G
z-3tl<J|uN`iYAvb<Km!sME-QAX;wGD^STH@;6$-$Vi8&~&DX;wlj;y8Tue5&MK`sh
zj$CMm3ElA$BRE@>_G3ySjbmYb&Fs)L(X>$cR)RZr$n-K#zV=(z$;kAcY%M7hm3i%4
zj3j-;vc!KAWaFc|pFVkTw6^RhC^X(70%?@cabO3V@W5ozkB9oSaF{N3WY$$1L?@EK
zLHhnmk=19`aB$ltX;V~du<{s?PGn_5*!Yk4a+?sU)KG1Vs24d=OTF0GSfQ7!@FXf^
z8K96cKV^|dG*l~-WIuePa*Rk>9q`!D-$tK#FhD`JSN$6jcuRYT5isj`MA%tR#(8A>
z`r#X0Z=VW7*6%zH5_t&Ga!4TbX7ciM*gPsf+-?G@%>Nyk8dDklMJXrx5cjy4Xip-W
zQ6|?}KtodgGi#vVv;TX~wQOWAWZH?cTfjDSfO&Y-1sTEh&I>gEhc!vkK$gGs0}Y~S
z{UaRgs1d_;Adh8A`doN2#U^uH)^kl)EYOr7ebh(%d2FzCm0a9RTRe_hkTn1RbcPT1
zR!C@bbZflQO%18P;{-;NQHGlyf!|wU*(dlmc=@3CP~2lj8eo5!2YYgpvJhQ51({^n
z>oWmhtV4j`5}|X_GFc~SQy5at`91goQiZj@o~SmUY{#u6f)Dh|Bf+!i!ov}O!%hUS
zN*K{Y^VQ@(sA_GPwM4H#hdD`_b88m?^pqs=bPT71R!xmu$lVomy~7oqkxS6FqYt3~
zX1@@`HV2TOeh61&uyy6JVHZN)cu42hdOKuu#dmbJ9Y%$TzBz4uF;XQ-gO+Yrqi(R@
z74LSu2;GuluTT)uqWt<5W=66zriyx@DElmCiJ;bN#mBxrdL{}8(96NVpctQ+YF^v#
z1mb~7*!~J2fpL=ipl0yiSL~&1O7(uTs9e%8R%stud^C#5iTxW-B#jFKi}@!sHGMw>
zEQ2DFTNB9IY#}OgGQfGb^b*I#HU)>}j84f-M3<i76lvTKb47iCkCgGIBXTizFn`EU
zA`!NI?!w{Gcxp`~R$rIWLI#^c(_d3&pHkS!a^<tW8SS>@YI;5OKgdl%%9Q(2BQvf!
zH$*3tLWq8`+f)pIu0-i$@E&>G>|s!`6@bnRl7W9n9^3J_@&qg)*SN535Db<`%O0#1
z#Wo_RN_d5gBnZ<HTyYygZHdMXgvKZ79orWq3{Y<#)~2I#mnl+1ygZNe{auYVH*gA-
z7$jH1U{ldoZ2Z6<hKtZ!vfPkbm>>&87POO5DjyUq_<f2yn;p|`#*LdRNmUK5?RRm2
z;B9#M;2MZf^R1v#C+HuP!GjWdzOtKgS@JkXEQeN+&d)-#aE+_g=@y%YXc{|N5U@gv
zDEcfXI+zqah2OIw708di*<!{@bx8hQunZg6`DGp<ZV;DP$_&kvG4>vgCrEnaOI~xf
z>ThYBecHr(o8!=Y)X-EGXnr%e8{cRNfH()o!hnkQ1LXM_xX1nFNVr=PwAFx=#jy36
zfN~4bDuG+H?ZBH=K#*t-cpM8)+85DRVybA)`EPhZPs{C6z0OUFaFy88a9Wk01-$Ij
zrZ&0|*h~R~eq~IeFUra8>V9*AQqOV)U2&FV_WtZFGFWx;1j$i#yV}Y?7Rc>1S%Zl_
z%Tz|wQ_uQS$$8*+7mM}Ny;piAJ_$Sx3>C3D+t}G`&6Eq+_3%m;u2f>*uR3{U)rTRH
zX`)tmV4cobt>Gn*1*gqfGBDOwLIPCMXaqfjIJD}_d~2RT!}w2sh**V~6MTOF)WJJ6
z#SL~8K&1E|U(9f-aBJ#xNu8Sm>hcB^!j45O$oJ!QEE!zm#(Wjdslk<i9@K{twlLA&
z&Rr*IGQA|(kp$=V@TM4|ba|Tc$IIYI_auMCr?C)e^5aC_1LKY7Y?jQ*R$&_!v?u1y
zJB_4V2_Ok$Ogw$s9=7`|779o_6WM*X8D}+Hg-O}+ygM>+5{<_n_(&Gen|f3NyuQmP
zb+Ms7S#c|eT_vl~$O-xyq$TOP+oa+)K0+QV@9tRQBDT<-WtRNS>v}$SQ_<$UP+4Ha
zRjI{MepY%&b!{L+T(f`Fy8lK8sIws)r4|P=3GOmQFzz(ede+^*-=F^S{+xoxqjccU
zbL!kBH?#x(qS4k-o5_V%CN%k}pAI!|9GrWc_qnTLa&8wS`6)Ypo;FrTWd~t45j=_p
zV!Ao-TFO`Cv^A2HnG|9s)v(5>=UFUl)XqHVU$Le}ar-Z2Y}!s19uMq3x=FsA9L+R<
zeSsRtv6}e9{709vZ2kQiGzg@9@@62pTEa<KwL)h`)Yh!kPuCKa!%tuMU`-?hZYLdB
z-&xAg`Ptvtcr@peQ`uOxP-r;9#7Z&)=|Zt0L~hmM1T*b*)=2)a<=zt>B32dwUtOa>
z!bD<B5yEHTv~h5o(R=`f?U?AJCm37eg=W4Ro?aBrk)UN1&G^o{_Aw;IodD4qOEXa|
z*gRk^>_g{6>0C4k-E31VVpD6+hdO?fT6WkH5}--7D!^|?V-SiQLqHOLx=O4<Sw|$Q
zh;v68l))|M3Df^rT5IO9^(I=N1niGSj2@kl8&J*pqz1$0rO91kivaqq`N;i48+%u*
z*>~PauR`{~)dGIZl|VG;vkT3RFP2XsnLZ~~wADa8cj`iZz%ndT-@v(2dNI#N6z*T~
za`x`+#?fYp$}?;i`ZqOf8)d;@Tr<tVN`1h8IqNpbE}lMlOeHiSC)@?#;!qOooM*k=
z?1O~9G9Gl1o;Kcq2?l;x`wb)9Qh5x?xQ;nG##Vg*$44a~gse3h!L$`gWxUYN65fR!
zMZf%ghUHy0hAJ$_8bZd)@#ue5vEm5ziI7wOU{L!|1SKi3EF5rNdRQH(%=`v$5N~}j
z((I>Xqw$k?)r%U3MTA@YFm-?Ei$|A-W>{e1`Gd|t6@^r=a%vvRJOa)WWwAj9*jQA0
zeH<m)$hu$10~rXbb~qeSh)Sxom?PI@Bv-)FVD%E;#pHiO)^y->TiI7l2GD{a)3N%}
zn;H;RgC`;|MZ)==*HfIUgn%{xQFPP^<_dQL`0gM9z!L&gY<FJbhVUKpcS{mLLRv~U
zy<OZU>W=ukin1LJoWnURp4~vPhAx&kwD~byC&N%M5oesh7~XQNXP0_l%1{YIMlmP@
zx?L!vpx6OrE|a%IP<-Mj|8IBY*RYotPGiq#EuYwhQ|B}ChRSpPkXpJLWP~Ixu9SZ;
z!&rhqfTuz;fR5e6Sp~9KQ|nw#dLgEwkn9j~iT%PBFv?hZBP0*#2yzw%hSl2aLwRhR
zeFXwoKWl(eb2y$Gwl@+8xeXrrn)+h;LfNMbP%6ul^SWAAF2f#1G!!bm+q89|;zdR}
znblq&PQLkr{LVPP9|l*|k(JDbqm0&k{LS(iF%siLL~rFYe0|C5(C2$ZPjl8&ansnB
zq#L0;8BLxN7h1gevUoZa$Ro_?S($hDg;dWLDHb7xL}w}(&@^-hX2SuIu(qu3o)muH
zYE~8j0vWBHJ=Yrfb_EJ*-3Ld)Clk`eUPU1ATp7pO(lb8_+|VB;Vq4hP)su9BzPq8v
zp#2d*mnU~VA~~fs@v$5IC`f=2a8bB@Lw+*Cg~t%6rNhIm^nw_m(?TsNBoEmWX*%m1
zqCLCCh0V-^r^~+X!aDVaOkg03)ph=0)6F4cB?jeR^iK96TyFc}P*L6*i#GbRn}Ygh
z&plCSfAM~n0W`frdgT&Uxp#|_dpmT`mDU~+vqwVjf81~*mWh?qj<_w#^xQE-<lEHA
z^@@iGCa{8lpPAwPmm`hk0iV0(CU8yQkZ>&1>So|<O&S{t3^r5d9e<|SRb*yWx7t+l
zN>Y(<+Tw#Gz~hWg(OexxPhaaK{j@dLo8hvY04^Y8R+AIim8t!f!}e_m>YU)O|Muav
zM%1%yTu}{nBRN50+(5|0R3rn7Yt)ypPf2P8o1vlx!bWKOkTCetn4|(Ip!GsYV2b<O
zeDdqo&r&H;5R`>xKTEM%yhSRUBxZQoQN$kjAw{LNH7#sZUH*OnV5;kLz%<UhxVS+%
zRbSjfr$h%NSffP(TZ<(BH$aIS28%V_MgFYNg?Ltx$rQ_>^``g&_}l8?-d0E0fKm8*
zUmlevmJkvB!t9$2h?O(NN+kmOLNapV8>qYAk;Mv-n$;P4$!5F)f*|g5kTct2-T26!
z>d~m$CvA}wMWSpjWbaGKE9lpbWc&gr0}4eHeZnwkvOZl-eKP=f#A|Sd9?gx~7#HVe
zMg$?B78PIJ=jR7v{p|{Vh!B&A-W-<5I%pB$+CWA8$*KtfhLu~Kga&j7NY;82g*wST
zeFs$Jg!XoqJhg4S3jSF+iA@aB-&_Y^xTmfx1m%5jlEGmD;|B7RCejwCHZCJ&47&>L
zW~N4)%|HxxbobfQ9gB>_#q$%qK-T{vJ}zSX3nEE>E5SnjD=gdY`~tfDHM!Ft+x*Kh
zx%Pebl!SElAu2T~`ARe7UO6^5_Au5T0`0RdM9X7ktqjtno{pN`*pEmPQe>A0v5n;-
z5NDzO!iDerWts$<#0<r)4m`0Fxgb@oG`z6^(nASmz%~^v)!aNqWLaX3RW@UK|GMf}
z_vo30TCp|r4}_w_Od2p6;lg7a=eX+L0LHzVt>kd8Vuc_TP(*d>E75lsnVVGmuocmu
z^`J0T{A9GMHMjcba*wdc)6}O}ID-F9>jYUW34Ae%a2Z-<s2WlMk;-KF>|>k!{X&h&
zG+<d}a;##B_AnKCq6aG+CD{Q`B$um-OZL@X^-6o~^C~z4U_^rw8JYOSn9G$|f{Adv
z4GDF<Hq4~iO5QUjNcig+JB;RS?a)M$Qj>u&!1i3`bx=zq+iV)=zUA~7sDo4FU|t}5
zd<R0-_@dqAPF6?Fn(dEegr)!~&H+JBf$l|W!d3Y>eTE~m|MUfh;GFCCGY0PCIR566
zM=?&Dh}G(OoDEmCbHhHxG)*TMX{1-wYIfbeIoD6ZGv3bq=qz)>J+0!xrsiJxOu<*y
zIzo={X(1aPS}{v1H<xv-swt8(wE>kxGU?^)iB5!B`!rT{V>>D5Rp>C;tr)h2b-W^`
z0jy%H8R3aMO6OR$#?dLc2hn}H|3JjQHp^A*81a!3xgb^T60s2-W;y?g-os<lVb{Ea
zYvDv(sWdNh%L={8JQvd3;tg`kADKYXycK1bDDv)WXM|f`99;2~@J<#e_Z+x9g$p7>
z6%SEa%EgBoeEd236KZd$L>zct^%oPGsYXDaHdk#>#Pmd8Uc|%`7A>w$XeCrqQ@?em
z7pqY4@|h6BG_LnU1bt(DpWiUA*Y6^A1H^0vC(-~mf6(y3)%DPT@Z_={NabS*sl`l*
zPtbWxy~Mem!Y3(n<d0TYIArD6gJeXBF6rM!)(8;5Aq+>vBT4-R^<4MtebesB5iFsk
z_EH3#o(H4*3p3Rt7A>dxm2_UYmfN7*{Q*uaK#KzSV+u0sseLNIM12YXjAMWb#Nuk;
znHcnjQ2LyDr2US&#r_iTH(>V*$dSH?E~kzb6^p#7{~#tKlewG>5U{~Sv~>#VDTmdS
z)6I%eG2ACd&jHRLh_7)$kRN;V^aX3e7nYWuXv>!Vvj!z?JPmq^#czq??-ad}Hj)bf
z?@5IP4|CA5N3$}EBtM;wa())RLEqRElpq(_&f2b9K#p;putd_p{7cN|aZfiK=Mt8G
z>VSDf_EFFl8bEeXE}!MDgrYz~+6?s>&yp>^xU9_+c2(V@52Vr)&F5+Bqz`4Nk)$Yl
z`^j>KR|(Z&SBGkv8bi~-B0nK5p#^BZKr&R-!^mBblwt&Bi{3^9+}1`HFfkW8KyW7W
z1F$&zz4H7``c}gy;r;lWKH9r5W06_Oz57eqm@D?Uwqw(WRy>NB@X~_1?(XEVHF$Cc
z0}Nx~5@JocUo9D08~j9}Thv~#<VBF1o!S`i49e`PB7N+rttPQ@9lfJfJ`{hQyLD_x
zPPSJ>I`L3xrS}yT4OEhmrnFdfF?PzWI7Hw4us7>@vUs+Z0}_aAkXf9s8TjJh<#V=?
z_L6=)QY6!Xj6#7U?8ew<J)+<_Rkc#&3vC|XSUcE(`m&kE33J^BSdf(b;DMx(Qot5S
zcQn4d4JTcRet1a7GK_hTnE+RKyoNaRttscPdE|f)Ts$gdvQKiWbAhBls8>vh6IJHO
zYi@{!7hQoqxbqr3ULJ*z*2_W{sY38!f+BPmGwYn$L`o`i>lm&ZA%;s}y}_d0YqK$O
z620eE%vTuW=AdY)_g-}j`W8aTesR?=`=n7sWrEBOK^A;J$hE=X&X$7~7u;3qI79X}
zcxG#tE`P}hfkXdfT5s9rW0X(g-#|SjVjfke)=Mc>@PBbpn(H>~lwttI%c+o%=Ryz@
z$_;suZU!!JSX^A-zIyE)bW)7&-WANFB$r%+u+9zIIL~<_7a(9|_l<!uTOY?3$K~#O
z>UKuY2yN!f7gRa?(FmR*U%5E;=24(Z-#cyOswQCDlKq-Ue_-O-)%TFxLU`4!9uOYo
z;|^p;+}m~8<tUK*{GN|C&^u)7LBxB=nL=2zI!~K0xy$05Sce9dt61o$)XQLcC~C47
zlvX7WN-{DzwqM>)F6Mnh@@;r1k=I(uv9c$j(cc7U)OT^*d-r{r>1dTEyuT9YGL&}#
z*!cdi5!7^KeiOlG*)Mr9rXtZMW6RDumqeMI%uKFygqVE{L=d7e5nm8wBLeDKtu&~F
zWSRiU^qHGSz?2-LT<yju_!TfbsGlskY#W289}Ua_Ig+@9vuTpu#@jRWm<EI5bG$X&
z)MHy#N!KtZY5xQ}G(3A{eT;!zMN)zfeiVJosizc7#IhW^;njS$^T#Q2S+*d;$JR#)
zlNftz!5sxNs|@L4vgG>fq05bG-%!JWHo=~I3G>m{@!uF4KHlCO-w`JAeqQDGel?08
zX?kEXaxe~ctTiR<B*$lUH~%l*$Sp{v5Wdme$DhwfqEjf9pD$Aqv1t@kjUNJ2T}*Nm
z6aqm)twTlPiI-mi;XEjbj#|w~-HJK)6G0oB-I#ZlTcT#bD0gsV2}n;8^gH{^;E_{d
zoGoxI)(ZPvHFA&<R0=Vwwad!!SnBYKOLA<W5G6pCfpQ{}e5xKR8woLtXlQfV2{uyb
z#5%jnC8%jZFA#__NEMfV_n?~6S_Q^~)|H0RR0Z+1^Zv4xya^zlFuAxIc?ARKIEO4Y
zWQFP|Omj?{cYRY}UU0dnus8I=h_%&($1XSZfF;i|CS|r>$p*sXMb>6V)S;L0RPVN5
zJ^*xRjTb<gS~ORnZSIniThu3ifIT_7=$L(*$+?RRzN33WeQnoZ#V8~9vlXgV`-$rm
zYyg<xCh12eGjPWb40MIcWH%cWr5!=G*IG<k>#96F{ZdudC;pbyL=h68Ad*`lhnu)r
z)`PHX$Qrh^?R&JN9A0AYj!^}565M@P$sP*66jDO>SZ+pSYL5(yuo6wur67qJT-bjy
z!PZ?JsGbHqi0~B!ypKL&0c?e>Ra<krg`*dFtO?x3UwvSBgCm&OQMc?ZTGL&T!eP3Q
zA?$jdS~h*k+($lIu2@o`a0`{_<SR?K)xLy_)|-N1*a}hrK__&m@=l^7zKTZ@1RWMQ
zPY#%F_?_wfSQM*5EMvL?5qSzr8#aC$D2Gta6UE}{^drkjww@4PgpnQ{+#)z5<T(+1
zKd`rT;W6v)z*SSRrkVb#dRo6xZ%9X3Rrv=jX=t%ELBh(|LE0B2&kehKLP9Pq6&GT4
zs;?oq#hx=ximtFpm_X&hKv-C@XK6{inpTHZ&gL@>-d<}#O!3F<j`zC2MhHaAnkp5I
zShGoaA&g)UpI)g2JteY1#&o4#Fg+#f^5li%RW|^gL-MG|BSl{XHrd2xqIv^~K({19
z(u_5VdR>sUQy5L0M##uUmKZ>Qsh0LAu9r|GM9PUi*G#~d^C{Ifi1AP^F!h+g8fom=
zKl=3R8SsVHgZP)@3KdYmfCsgmb^?i#QfuWDE!H{0J`-MLG||^!Y0#GElkPO+_<8(9
zI~)HUFwE!tDE;lQ8orFxu+cw?cvX@H1F=<p#_Ga?y6r0yoN7wn7flSct}#<icc8|X
z{CO0?>>WeO;%1n5$5MeC<r;C=VMP?qfdmskIoafkHuTyMa33U~ol%$Wd;xaV%UheW
z+riTn#rN`xAH>p@bUIuLLO$0hlt);CsKetX!XRH7F@i%>VC-X=z!25H;cad3B9Stg
zk63B=Y<0d%F#{IM3o+?*?Z?UJ`EX>v$U;f0r?h5IVt1HC$5Fyf+GI*lrDD-O7N<w(
zm5<t3SJA*EFFEoJt0o=EqL)$<f>TY6R;FoPr18m{Db32Zgqd!<e}I(fs|!}_1UpwE
zlu=Pli_qB{*p!j?5#3h9a*onXpQ#|w^Q}1+ChUX(NYjg(ARAC+MU;HHVRyzr;DkI8
zWvm{k)ZyDO5@F^Ow{gl=E5JfHRy_Bs)QE)v`GNq1V4pi=j=^|LKF1(Ec0>~7Ow%SY
zF-?pwu#T}k9vU-@`@6A4WlPJQH0gxlQFXhiZE^FB6gny_K@;=fghg!|<mLR=f&OLq
zT^<lV9khh<PxR29zJmuqAXrA1dB%eOcZsOkc2F=(Wwk`=ogcE?ybn#4gNYixLJsAo
zQ6~-4m6=g?%=c5i+ee2MctG3$YPls@W?{&A!B1CCtr&j~plia`5NS#`-u5qY?5#aq
z6ranCS0v{*+#2rY=5?H9<02mlr4KQJTFPY+$wd_djTcPIMY^QAL!Ig@vboJb&{RBs
zk+7ELRdmMZRlo1uS)olOG<mn3&K5<G!HK98^fsT1mF!kkbg-0E(ofLEa*d{4)V}@C
z55Y$-@xF<rc}Q#$Vk@nWm;uTjer0~>lZ<nGe!>*mmfqtav9kDMRP9|mg*%1u@^|Ae
zwzQi5<5iC0lvBo$F&lD8fAX_isy%4hr^6!OEMfh4Ly{Xa#OTqHJ8qWMyzsE*Fsnqm
zXmH`;0F_mJ7B5<c>4kjIq25qG2UcvlJ7sh3c`(#IRLps08nGdFO1!dA)S-zILsh+3
z^F=;U$@#{{<&@4`?XYZfy}Bq%fV6NzJP}J`c26w=lpT&=5-CtXh>`G(>~j6?aFm)L
zx+XO@$!tdhxKPsWC)l9W?{HD-{k1r`VgUkX&pCE5=-M%9-FJ8;?I+qq)5{M*O3FQW
zPKbF)i&M^wGd;Qt^mBA>&wCZi(rU=KprtMuc3lqp(&|3vwhMbOGzb&KZ!EbP>}b?U
zpCcuyWmPc3;@*8Y8W;6AS+IK}rfHDaE?Q!Mx@toVee7bK7`(+2_pm`E`@Nr;g7H2S
zjyt*&taP56S{Nh%(3qkw^qoah<mps#@*19%jRh+5M@!uC?Dk>aL4uUu$5um+m2mjj
zfzjka2j-CRbNSleb(Q~pmZ+I22K~B!;qGl!E9aLXOMJ~;z?7EuUxX2X61dsTcMR5F
zVQ^cXUba4Q8#g$Qk{}X46$)!w;~Wh7O6d7!VFTW<a2k6}mRyl+zH?$jOmjiJ%hD8{
zuz%dMp8k7Tx#o)ezIRwrfW6Ux5PKA+H5p1)v6!LCI0;@-qOo{oeKiafP0G#70p85k
z6}+h7AtnP1Wnhxn1y3-=^phe25$=q`iR4jJGwc+kMI$VR`k&+CT=x?n0ur4&O4{ZJ
z824k=GD;0m0vo#}Puo)V28P=pddRM{6jsA6Wz3dG*CXri!Y2lO)HJrCaK$7g!OD4b
zcNvSr7&IRcvQ*tu{<(Umb#@qt838ip(fv0qt(k5aAbDPG0|4x|$t71H>J57l1v>0Z
zOiTB+YB7+IhTqQ$Xn#ugL1a;<V8)&IoQ_MpjU{HBT#4H}j_gL`bOAi`Q6EKzITC@c
zt|a%!@Ry-M=zCt#G#MC-VoNwM^getFZzr8e2p3gMl|OrcVewr-wYV!q7X$=Up-B9O
zLA1=W3E2{7=8*SlVsx`1@+22v`!(Zvnq4xz5?@Tpm%84Rb(3H<#P&mj{Ba+~=k17P
zr;zwUs9#_Q=BB0t#7Y(POp_hAx0zQ~k5%pyQMr-kz$RNq(J{zrs9G`rSX6Y!^A!Zg
z;X2QDndaHETuu+E9FDQ^iGc2;#@N5Ne8t@se19_T6*-+O8iUHH*Y{<iUmp9o^c)xt
zB@YV<6qto9Rw>O(F!#}V@YZHvKpK5V6jAy)AP^ULHqHrij?!`IiR?n+89m|~nsK;n
z+!;*>P7P9~k^X?w<(+hT;y-<i46swIkQIEis4#d!An;vNd*lJ-(k@vvp;ZTDGYXRT
zzS?lqRVbA3A(hG&Sm~PSTvx8{GFm~OMzY|ISp9kg*0dAef)#5iqF4Ushj`%Wnghf<
zGjCTfd&>ltW58aQ&bTBiP}#-1D#`Hw^gAkfn^F8(QBU2rRya*(M8k@>ORzNg+#w*#
z-+SNK_ZoEOCVN^IWf1Pm=eV9nupT2?+!5a06w3d9D&nxKnD1s*cFybFH6E@YoE#IZ
z4${&{!Io;q728y{FscMPv(T%CNzjNCHbnI@IYv}a2<F1<P23?Q_%{N=eiQRD-^|I3
zSnII2koChDGkXNTf~rEsM_R*@O%8L=ckx$^_G<5%5nf_9kANt;GcmKV=!H*EC5?u9
z((YnPvMU#3Luda$z|_+d4hv$LPhH`CoyHCG5f>U~@}3VzxEX|yh>(0x?KVA64RcXN
zFfqY2h2i>~$bH?!-Y|zSxa{)P6ftW*%bOAb`k?aq*odhS%AW<h5q)q#)5@P1b9Mxy
z8<;ks)bcV@;5vRY*|zf?7+x;7yZ2~8e-Yo8Ix%$600nT)OPj^K{QCS|+WlAdXC=`D
zTtsn*EZGC7ca&fqI(D?us6l0=Xf?Dj;|0)s!i>^g1Xv>hNI>%K@o)mzNEK(9I+{jN
zar4$lc8@Cx9UxWKsjeNqAp{FK(t~nkXx2toX@$Ks9dGW+47ZkyVVB;F*hNZ{TAmFF
zbPzQ2pwvtp8t&I<iFv9I+GL-Sg(y}B%w5ryg@p{Mv`7X|v-P6$XxB;kpRj<Qc*B<&
zYssiFF#0++XzvCmW1{A;$}VWI5{0F<>Wl3+ZaXOPn9;^xJtBiB&rYr4*}xKFWV%`7
zmAi<wh(SofZ)etRG#t|?M@}8$ZbC+Wu4wvRfX5*$*K>vtyG;pa&u!YFNVn=V>waj7
z6bo^8V|N4L!W4@gopxN<$dQIs#2E3QbrN4R7G?dKCcLac%~I<@wPQ10JR_={*>eXG
z6kh?Y4q7{6PKcn0mIdKO2}3Xe$wC#r1M=S45<XW<IBUWv`E_YWfNKO?8|_|r*%ELR
z7=ee|(4INup>UZ%<5O~mPTqsr5;_zt=;#^r19aJf)A>fh*t6=wcK`L&#>L+-KUBd)
zKpaT^71UYGiE=tz+zG5UXYUoke<~cVP1#sv&$&`@Y~TAqm2%l;ZNr%A?*{H!25<h{
z2JbRGmvF>G*<n!_@>uBW;aYSE(2lFLS@o2QMwyqsjj3G2AS-m@2~5+YrvuhjfIKjY
zmbK8xlYrkrvUO(`_yFGYHa~(4?QGxTADqmIv2p-QX8lYqV`hcv1R+ia<S{SyV~{*N
zHA&ZTlW)6#boBCZ^FcO(b^sDktJ`DU`DWtLri97DoYQ!LV_+foacE>%&7~lD1%TIH
z{^)2vM<kty0a#r1*?q(?R8Y2>OaDnzaWoOcEYpBEV$ufyQeyXztx!ikSot;3Vtsqk
zes>s(QYf@I(5it^(6Ua;$W(Ilmp1=uS-w(&h|lJiC&FpjoDVRgU5GsGBl2o`i(p`=
zH+Un^NEjNp2|V!#a4^xH-2NOrVeSsX6oh$$2emJ<zb{`1E&bcp6YO24ewXy_?>V4k
z*>+;B&F15Pj|ls<nv}97ncgyXJ0H6v85?5Wd`U$ztQOWmxVM*a916U<0@xg2BI5jq
zCWHmp+f_w9wdvu10Mk?5mgEK!)+?fFJxZo}igJsX2pCe)?dal5Ds|KmENO6#FOrE~
zsarRR<RX)fshyyDM&-Z@eW6SR)Q6G5Ih>b_BYjJ59SN35Dg2GFvnkw@Mcfj|Uw+em
zBYaw9n$KG(T5#XxFce^&u}OXg08RjRx2En)a!&Bq^&RBaIVf;&qaD&r=lX&YUfAY*
zLpWTL(CyNgA=-1>pWP^2W?B7YLZ)6F;3r4f;AJ6h1mrCi5dkI1T&Z`}Y0)Bh-;8;b
zZsPnUH%`hJ7Y{{2w#;Knmn}HIPMK50vWJMD4IZLj-=Ln$$t9lySO(7Xnf}RP`*haZ
zoS=*NfCU|3kOP;)bb}>8`f4OO23U4!?(!zo^>H5m<w)!L2a5tJRbTcSO7SKR12x#D
z!l+JnLt9G)K%3uUO)N8iPRhx#l2U{)!Oi3s<@<w@okdEAzNvOBXabwm(Jv>rVs$R#
zWOTNJupAm2+78a!Rr20JKs{|gBcwtL$BzfjUlEcw^s&Ic!72Pl7bq54U_E3}NZ-Fm
z09gaQjY~5cN34wK)YkWqKH*ycDmo$6Py}IP9h4k@$%?S^IS(KUwd4Ru^>J#=Q}=gx
zNuknM;>z-p*e&f_RZ+><;Wx~^+EZrOYFa%@DsBll6P-~-)gZ4E<6P9qIA<;pOcv#r
z)<kVsKx|OF%6xK7Cs)F1EWZobSVC2eX2+L|_q%3-sqmwGEKT3QNQ~^%aoFhH{>j~(
zXz*d3z}=DWL!lVwv$AHcU8p4f6GFhKnbmla;o1S0Dh!L|A`Rpg0G?~?c}q1?XjBe!
z|H+y~8Hj;dc|qwsdqt8{#u2t=@+)2sQwM<O;Ip<iD7gtV0X%*~oZJgD{o|fJaoBFQ
zkW0?_vLfn7nFD`3QTU-XoCbEMWVdcnY7BZ2F-O#BhUVCjy@|TS0RXmJ;1B7BTKMdn
z=4k>>xQesj0i2Sr3VcL{{C#7MX$cHXgT&O^;Un~WZR?l08)z7c`xSsv`eEy%xU;&b
zT}&*yku^Pe2(jY&rY?>!-u*SP&<QuN)4NZr5fLq4*)`p}1;SUicZlJP-eFC$>*b?=
z0(c_QUsJ+}jK;TdqS9*OnM2z#KycT}{>}42X*p_k8E4UbSkVJvBv%r{*?~y$Z)^0d
zN|`Wi5Gp?ljA;&}JVf(;6+&SRd%RtA*<9!&5bqdb5|GfC*bAWY<}}ncT^hzSoXM~v
z34+g@OMOU|_!G!P0m!3u+#Ivz=q5BGOSD$`iY#RF@FD97deEcoUIOA+F6_Qh^zB`>
zC{wjt=soj=(0dD?%D2>%d9x>=$S8O`Ye4_JA$miLP9i+cGq^ZEW&Ek!(Zk0be8s_4
z9t~tpP(@ev!{ms2w1PimY_)hFHxvJydwJ&<M{M*5&Oa(i&|n2n6XyM0B%a24wu%))
zwe?LnwsZ+~S!~J3Ty(e9oC-Gg)6P+PEOOd6L(03`g{v2|sS68^kiJC^ebta~TW+*4
z|8*b|;lpNp7E=fa(#Zv+c-MW;HTq5n*2S!G=ajI;0!MaT;gSG8q~-aLd_7-W7Y%71
z99e=_j3&&rH$9||x2}nw+O<+Od}U3FQ$qZGaP!uj93V9Fr?t^16{Djru}&DteTo56
z)@hS4O9&YP`eoUub6w2*UKmlXD^}SHrYS=)Z;LoCx`+<wOgzPqDNh@7tGjtHKu-OM
ze9rk|4wTgPmI!xQu4uq(3Fr_x0aiRQ@~aF0uzr4Wb6#=M+jb_**^<W-JTMOV&Sf^Z
zdFpsam378)pT<b|XL8kf*0H2V+C^fra%D2rcrbo&9&x!3H)OA&UkEF>+<tMQxRTcF
z;)N!Z-?Ss1?wz7f%qNOIh??)lFzqi%(5wb8!Z7TEZ~Q~X^Hlr1ktS~thXBbw@#$&8
zcd6h@#5^~lMo1l?23ZK)^$MmL)=Y`e9ek$C(D{-)avWE=K3CO`{Dk9tFriY$R1UCd
zP^BAy;wz`U&q>PZOzvA<B5PNqnsk$cw2MVLjGb^Xq7X5+r}F%Nijc&pE-h&BcUnNF
znN*x~Zqz6%po$-Xze>&@eCL%^6??7hz8yb&Sn)0w{#XukCuZ43bJjAIeY3*2y7ziX
z>T_6vB(wQ#|IlyPK6-MPf38#cXv-inh0eBB#p0OCaj{KZMy?VMx(u|j1Ss$s+nHkw
zS{S?wY-tLbQ3$N=BwZ5UeJnS0re^f7SiP7L@l^pW{1AEw%YTmJ^c<RqC_K9I*WB;@
z&YxD}jEAOqC-yzdy)hypJW#?fwGqbL>T(i0f3p82mr%U2uOb*STW^^plX}D8)_1>!
zK;F8?KJY3B)|<{K4t5Pte<=JdKnnII{(NTF7!*`rUa-;1L2P4lYVg#OcL4Q*0TnP{
zlLQQEu+a24FH_ztQn$%93l&k5_FDZqR0_V7k{_?LUMK5hz;T0Su!6459@DXP!HRY{
zn=TMHT9}}u0hJkOUG*Sq&0=7xc`iHRb^A12g?}um@Si3+lA&+#_WX^K1T2aUUtRKo
z^N9ipbh%L@AIfR~D0C8`aSB;MhoE7z60v+J9l~=@`Fv4_vt&pYQ=N9hk2kh0l}TL!
zH3no5T4e(2VW++yAwcQMM>_}_8`_X@5U~QcFf+~AF}3l$QbR5eecckyh$bbTKij1*
zB&=Mcgky8&8gcI#a0%^kl6Ikyupcl_g%Tvv6sie1M7s~?ivw<0dsK2e;fkB)J$hN9
zoSxCRil3BdxrjN?md@RrO>TqMg=i-$d=?73u~~M0Yl-8L%aK`Ry%4`qj=q$1-sQC-
z<@Yt(?3H3Ow{sp4ceDdb=#=9YOBgc|W)_n~6Ff8-yg>^+RJ-BKg*f0i<$E#Njf9MQ
zY4ng(Vsp>7xJ-{Eaddsmi6gCg9m=L7MwDXEEhsx_>RyuA@+;lwSqcpp;ZRi!WGQO6
zp1KbpM`m<qC8r(#_wkdLQH*S<5%BCtk*ZzjSVpw@bJ^58>FQhb^#hYInQI(lEU*Ys
z8Kxf18RnXEp(W}#G63*^?rp-Z$OBao_xV0}I0KTF@*2v!P{JwEJ-=6ek-E}p#*j2j
zQmH8BaItZm&Ufv>F)whEwnEiZ(SPJ@PzbhwEWi%lrm5~KqL@qF@B|LLZa+8GYpVDT
z=4PHvT{}#a;w|DKqSB(nq=!VAQ<i&bcFY8z6qI}8>F9f^9U?Xzbqt@__sBJL&<t!C
zrA}B)MD4(}_*@JZs&dh$ZIB=e(T#)RZ!;)6Wh+as;955rfwocDp&|;`$AXjVbVQ28
zZR+oo;csPO#(7Jx=&_RFQ*%C_5?)31gdv_qD<k2+3zX9zU|Or;#efvD?y$s0CQvdK
z*cc$x@&sux^<|V+4ST<2Jk`uL>p<ZCd*IT2)Z;8?+ltPHQ$^jV(io70+5!x+2A!%7
ztzqEdG*2{18V#z<)UvVlW~BNsxcT&R#)a#a#?nYWqRIyok%06Z7?A4S&<XmcOUZq<
zxlkZk#mXV%UNqZb+*w1kBG%e0%Yl+Wi=Y4#p-DqbSQZD=Qng+!O;V3kpubSD(vsiQ
zaD8PBF#NU%SV;DKMOQ;LOGVX~Eohrs^x#^BpcwKTxS=}kM>$Ibr?-p}mw3TqmbIiD
zU8@x4O~_;TO*f);o+dYT?;ia@*)IeSTG?K;`a8?HU%`EYWmPd3uzJWY<>P&BEU<W(
zapxY9Zw1{%pj%lk)^0?~ccf#Z=tkHK6%}HiQqzuIVJDs;sp}-24(@{r`m=i*T#Qbb
zcV^7g4N=?1McGPyzrz=q8y+LaRsa@qWg}+b#3L3wG&qH5mr>~<IZ^&<%a(xqg`->w
zXzWt~3w;QZh+h{y&d^3yMk7o2!x{iIK+C_rUV+4Z6R)&;E6-|a)_(Dg)$1$w*<%n0
zUB2NceNau;Vr@>D+;?WHL&To$BuUT{Ll(twKXqOtn((?S9Nrf=*O9Vl7g<DO6LDYT
zL@CwOz~*R@e?oQd(O^BZ^g<*LuHE*K6Brzpq=w8K4{88FFcnunA8-z--ca_F5^7gy
zv<uZ05TL4D*kw3RRoeN?|29;ECWCX%j&yV~e^W6XF|m4N@B5$Wd(L>6+HaT06ePyL
z)pX2gt_=i#bodu&p|D>eAhl7UGp0Ij*n`Sv!z*}dr^f8-(Q?f@D}!h}H0mk-`b1Xn
zcBwu`^azl)kxjAY!0Y+M!zVTc&~X(m2mv>Rxx#X?s)1AHSSe&Q;rpt9^@k#iaF8jw
zldRzo*xZs7LH0A0bY-3iu&(CSmfu}3tkq*jPXhOtvr9FujfjjzwU2f5K%#T&ska}?
zrq+x&PbZ`b_9D$3FRA6SXs5Qiq+XhCPwTN;9O!qNDX}V>KaD!HKH0u%fCx~VOD-Jq
z9g2gd4Zk!fz72S);6HrY1)G_Y6WzY?iSWztbcXqe&|^l$W-yg7%~5iIPzd^$=;}7P
zsCG;x6_-<ynAOzP@WB#)Qu#D?PDsk#O#EG1otvEH{0hM!nY(U`*E5LVw^vHAk`>c-
zd?xH!8!%_!NVcNR^Y=Vck3PAU214CEtS}3re2_B<Abp6$AL~L<_CO#0o~++6W{5t&
zfxxhDJBa9EcE3Vz?a7vHBAK6Iy7|vj4lK{z$e0WA*TY`Hx-jb7G-+*R2qciDx$~fB
za`}<`WeJwH<QiPsCo8?2e3R>1C9}>_bCe^8x*=u!U(~P7JYcXGrJi#bCE49LE%_+M
z92luDz^u8`F#PAD1#cj9F{X5A!@USQ&|yyFXsAO`bi}*MnP7G&asAp)Q!qjB#(tp)
zIN1L5oHbYaLe-COm}uWIdDa%9Lu)JxX<Cmq0g&(!B>G57$!Y}FLu#2#waZmd@?TpF
zE|+RY&~nlayVLg}HfPWV^9D<zi=YD5qg3`czO(7mrcE`t7t4aSd69G*c*{Ga-ub)s
ziWZ>VKWcRr0Oe{yo>_C&knz)SKciqg#W(}B=`%vJ&=)N0mhpyydY;KsB56N-t7%+E
z&|wYO>-P2db606Qe4dCBetsewo8J(T8~Zg+iXy1LvYTv(7)#79P$rfd;pb{<mFAx3
z2w+gxh1jI-{b(&4T1Hrg2v*T8*7A@ihIO@Q`kYtAAxG99otW(=fB1aFBukdwTOb$3
zC^<o9BAI6$c9+5%xFiWBuH4LQU4ikr5%wkk$|`JPKTSyBZrd7*7AVeU8*r;$8$F#B
zpqZX5=f6qmM1bf+8mJ#&T-8NQ0g<y)gElp#FcqamK_+1mhH9oWk<!LN9n{UrhSiGv
zbNV?uiRObBmFp%V(nX68&GZC7vmgA+?8^xdBz}g~F$|$SJl(BB84f>hYS@52u<91p
z`whu5_|YD5&|t!(0*2FCI>qn}PRraIxXf7;;I$eSsnZtF@WiuLP%`U8GF#$tVi#Ia
z5WliD!Nyem7Na3k;dPc#I+VvnY_!Fw&431xd&0KavK6I^^?Yf=^?LOLkmTT0FXZl(
z?b2`nqjYY+3JoW3IhqaqqxM=o+?$o&5^lO@Kgt4bnW3vm=w3+G?*1}po&6t2L=WKf
z-;nW|YU>1woihLLc1E@&c|%NB8JVQX3|$dzT78K~oubD$k#t}Xw<ucHJ@TRK3KoP^
z*W5tAut~EI55*Sz6|;Q1U_s%KJ^sEw-0TfO(yn7$9^Hiq!aNDlN162BirAqMcZ`gn
zZGTnsxB~1zntu_GuAw1CkAlbicx!0gu~>U~ucW?y@+x`~b_&rI=A2!jMd(otm8PBp
zSWb6wRw~fYdDmD{3-#Y6eL`!sCrCbi)L7oE!gXWA_Caedap$SEjg!$4KD+_9jl--z
zE%rO&pcR%EflGYmbaMr^c0OMNXa?~b`qd!!SSs#)N`G))c$|3T(Jm(Q+yY)HBC?X2
z)|hv5LJq>F6ej6kF_^6BfjwwIl-Th^E|3v}M{f$O02OZ91M}5iYOVGqVLc?V5cl`<
zo#jNu@8Sd3J^xe%rFa+Lyh)BQ{e626l71u+oxfgmq<Xfaq;2cXpF_|)6RX)eR|b0V
zot|}MsLUxgpJ75sHJ=4z)}Z=)QkVfUePBT2%Qs!k;nqrfNEEd)F<;<CQOKS4Cisj5
zmYHX`3~GX&gts@`A|{(3TZd+yPzJI&e#J7<`}T$l+3*O(GMD?n_ZD;2q(y`@TK36j
z8y}&s1mv~(_C^ASdI8!NeJDD{)0n1x>e=vIF+dAi2*KeZI?zE0Mo_5*ePXiJ%y8!%
z;40vz-9&_$;^i3RQf~Vf80h2+5SD!6#QnP5cxpN~{D9TNg>cSd!5tiQ3OocSJT~U`
z_ClQ?^%!h@6CXNiJrX^}76Sf~*7<}4gjEqSZh?(@N+=(L3oXh~J>w|pnl~JtERekk
zA&Htk(MoO00h*Gf5*&?X^Kiw&FtRYple&R+J1#ZFGb!VZ#m@}N_hy-Y{6WLqW5q;q
zrgwc$GI#sNj9L?ZK;dpfu}>Joj?%W3m=ayt*D}-;+e3lpOV|jz&+8dPLt$Ik8}+qk
zUKJ7_+0_1U6NxsV#PxLvAk{=*8poe1X&JYH+=%y^aT!3>q-mJz7}RP4QCpCba%^!m
zMc|jzWD6Ec`UgOeGCJCQp;FY-?^$8}-*#$LdreX-`7rU-SzpO9q41bA?b<*Sv#GX)
z#wN)dL6Kg5fu>HRR7D*(({+s4$4XW$1GL-L!9(}=>(5^3DSea}+<fX~@_Pw5B61r<
zk5NHi-seMdXF`~OMHI&bvU3omwYEv9$dZvFaBy`2-HFL8B9s@D89|BzV2~j$S{MV<
zT(t)oR*{(S@0N$>#Tu-=kxW*PpnQUI^x`6MZ(;FR0hrXX^AbU}VqqjqtelhHmWe>7
zks{34%Rf$|5Q=rDmYZMlpriA6lQrW!36vDi`*xc(pm|(b;)~@h7^QtO4H%Uv3+>zv
zHGA>^36+yr7Wg|pt8xA%Ak$2#`Z;kfik>xX33+A-YFhV4PC|rDRwnwuJpSxfVF?!x
zb#!p6<TYt{^Be~g#rrLD*;`LXC1qfwJwZh1vXA`Xgs2cSfi0BKaI)e<#34S~R{1zR
z&_I6)O~weo*5bT#7u7N{5=nR{otkwMu!26-mje>_8aE1nEOYuUanud+SaI5LO=JxN
zC}omLUbg5GT4r)IKS7}xH)0=e^;(Yf8^B-#*SJBw3)Q!&or#{^3hT*uco3k0I^`ZW
zmy&^`*_j!F8zL(J5kby{WI)gYJu%1`#6ToMhR^k6Hf<bI7lG72SA=IC`DS!5b9isJ
zyX+{yI?&iIOfsz(I!x;Z449$EHZs&MH;O`;FP}kO&odr<5MgIA7M!86$SK3s;xk`0
z$!iy}#)8P!G@z6n2wfOJ(APxnHQ+)WHgIub&$sK;N)uEPmcUr4dIFhe!e6yR)1e`R
za@J4~_Y$O1qekVdMbMxZ=>A%EVj5p!Ut~Kd;s#&5;~-3}ly^E2qM<#$(tiS1?@t6F
zS5_y8$aq%%zV<Qli@yV4g0wcjKQzI?9P!CQsBo)&JVI%~=S4q_o(oi1+M!Tb=E#}j
z&`)E!SlcPx1h*FgbLK?x%g9;`<J@KTVYultfDFI|nP*v{I>|<oMbmS+L5xDzDRLru
z+%<xR+J!@87)+|TQ2fG2ey*}QuvC@=(uZjJ`ChAkkVvo{YaXbkOmUk@P)OGW7ex>g
z-5{ZkDQV7BoZ6H)b4B*^vw~bu*d3J|t4GFqF^AIq8^*-OQRtUGxf+TX7iMk{ka8ZV
z2h54<>pNS`g4iioI(CYF|Fr<FtG!N;yIW?%QD1Sx_X+<!F*Ubsd&;IWaw{Y+eKfu$
zn8;mkcW98EnxpAObb)4cS?%<gNxt!c#q0MxKm?~FI>l8xhA^W`Z*uhKWr_tF7kCN1
zXu$V>y;Ha0o_Z~xclW$!*RfzZT!=)X!_E>!CJ~DBevUI7&cotYQ2US*P?c*04Ie@J
zR^mCEl-_12R?dD_DB`aHTx+-6G0#=rr^2T4T9IBOp~MPbohK)sg~rgDInlW7H?Dr9
z;sPgFATafQx)naKa*@sjrDp*`UzyYv=-<y+MRIrD9Y7)YX4cKBr@j;spVV^S8ZjWU
zPAr^Or1?<3902hla&#DA^^~@#LemCdp)nWjWj=h=Az2$<R;xATxeZQ}T6}6442}_i
zu?|tVS2|$O$MAp;0n}iPT}y4Au$yi?S|DGV8UmV~{nhiFVRF(oD1rmnPmey|nrDwo
zPy$yY<DD&5*Ps17uhVO;{<iMhI5*jd@*kj`=e^MQu9cwx&za5Oi#?EvoH6&&zMD!k
z@jmILHw>!1yx^jgUi8g_)~^xzPUR-jKEch0H#1f76|EwGvT)4|X+d-RJGd~I*1xJ4
z{`K8OlMwtnbKl_Q)SG=iPFa9iNQA)1$jCYE2tCIlaEXQxcufQm9%gGsK@d8|%|ab5
z!e1nGP7H=}5n0=yZTY!bpH1m>%#?Db?3nuNk?mCQvfTxOP%Wi}HIP&?{{6RdhS!|~
z6_$)-mUxX~^1NDFvh;y$_O2Kw;Vi7VZb%rFqfO{sSUV8IoFP#5r9;7FZ}>tO(jlGT
z@ZTYcl4KLm69BhT8RJK@R15@r!&V^O3Ac422`D{S3PloneIe*%)O$G@KQqxJ{<-yb
z2uldxCqW4qypRCP5Y~^OI>bDeGZ+)SsCp_T(`I#^^<{Fq_hw6yLEwexJJ^MNYQ|wB
ziO}2@<nl@qN_TGTg*U?B(L(ezf5s?+h~}AL@L=$%RFj0z$&y7UdRFk<;&7_E@}1A0
z!8^0E`bhHKN1G{5MH?L1cJm*5_QghZ)JE3iDik^NPALT9E#6=a!r4Da0uij>=ejn(
zKN50HozO(%-_a``JcONvh*C)VDS0UEb5i;8j@_M|sjxrBb$>*(F=JAJKPE3)&5V6T
zG7m-sIxT2wdAuEg##w1}gbAHf3=`F6Js~tHyWz}$Nt|bZypCx5Kw2XZ7ch>ibf?en
z)L=ST3y)Wg5z*{-JyUox61x(?6T*U_)h!I*qx!N9j_Mk#&cT+R6h9ooW!<pL2!@Gw
z8&z){0L$?WXT=+#T7%ku$N@JJ+=p{;hjUg&|6P;y#K~QrQkWCPOJEyWf4j`}5Y~3m
zn|PM-{Sgqt*T#T<opIp82!vV<w2{?(n5|_*H7Hg<&YQT`<aIm{*ZVwE5V5z0g3=#r
zg_+YsQ->nd6jnHNw9NgKqBt>;+!8~U14XirWmRDO*CEiw9U*$iNFXo!2*n_w$!AQN
zMURa{JUZd@`%|17H0YwqG7B6ThbKum=tj|Lvojqn7;FwUD1nIxUbAEy{fJ3rQy+`o
zf!NbmTLZ#^J38DoGKkUD)iN~1$wKimAlyrxad)8-(e|dZl37Lx72b)?TyS|6a)|Kr
z)bWC992#Ud8e8i6Kv?8!927e4(G4h3SaDKNjVo$x-bXXoO$>8Wr*xQ;1;6lu^c_~b
z5Py&f@tBK1P;ux^pK~E5E*fJY=CLJL_$^fgnF2PM@^H!l#O-z_Kmf&Q<eM=bn$Ph=
zkaGB_Sx-bCWSx%0nV6l4yO)})99#@Na>490fNq{e@o~-)y~z^t79;@esCJLj5Q)wO
zNDu2{Km<8WPMp_|=PGAXUb`EkBHYD(coACoj)UmSPq$`-2@m8*mos&Uz*x3l>wIox
zorzYo;ByBHFPSe|TxR;hspgL{&T)4(RuMs2G0w`)9#Y7sQ$~2sJ4eVNI+#akubVAf
znpH;x2vlR(NWHX@n&CNWw`=!mmO8Iku4jjyE;Dl*y)q+Bv0^4<)EclF0CjxG8dvh3
zMiLxR-pN6e&J1I~6E>G#m^=g4$i(D2;hV%zRcHv5uWmnjZQT;I)QdHOf<s9Z(xsYZ
zt?eiGdnOjP>=4BQpeR89(C#0`P1Jkt80#w>ZxNpJ1!)o4IiQ<8=ns7O=TSn4vbX+1
z(Av387R;ent9$s^3%2Nvo-$cgeLbPRn%Ky#$XBTRyxUv}qq%F}!oubRvPl5CDBRB-
z!U22aOis*kaWXE+Vg|^(EcBCPl0a6B)_-;8crK7#e6kxnC1+3c$Zdqe62sNWC6|fY
z8GN*HY`;Z+h*R-_k{lx|!6P($AVBYDFMW9^Xjn7r;E5XJ#NLTmI{J`qN>f(6Yznb=
zJW>xZ&SBXZ>Nql?nL`PZW;+Ni5w~~*91=^B`X_+S<dJ{49;qoIam-nBp0T*EbJ=&(
zKk89;VeWN7+dv?6$ANF$Ei=NLbWhV4TK+=Wl}xbGuq`vg@l}toP!M(32`JOOl)_lt
z&a9fpcT}hzW@H3SbUCYMaQQVw9K*MiY~c`l4H#`LSHHrT@i^;CdH^%*CQaE0(<)_n
zvI=xSrhiEMs&WFQWYsSGu5RY7i?H-z-IoRzghLjw`2a@QR>5OMem2?m=AzF3)G=sh
zNoF9_=Q!m^slZ$E4O!MtO8n|uVU9gf4ht}BA5E>H55k}lDGbn?zycyP^uviDaVp+a
zPV?R6lLu_sGMVSlbA&q>;Zy3zuwW#9sHp{9cm$Z7c^Ym7eM4J0YvmX~x?|i3!+98C
zO!tk*0#x~T8hk|y<(cxWI2q+CLdXI-+_PGX6yZE{T%8Xu`~buCMu3jPCFSw?Fp&&b
z>e1PZBOAsfBQWFHJnukCS$%fkhy2l5#~M>0aH$$d@Nve=rZ%&{JV386Q}O?-0@DaU
zDjU|*xY?63dffY`(Tht^|9gYrm7QydqU$pxvkaUj0GZU;q!v+`OFCU$Tzqg5O9{JH
zYRFOYdZzqh=&q!jHezow?rX*1C0&|`L7l)O4pJSMR!i@cuxouCU`SkQ;mDb_l2+sI
z1kyQ;`p$z{|FibrDDq^^O;OCAZAG;R@?{u{QD~i3-uN&Xk`T7?B&7kA%ye>68L<NM
zeb?mh7^R`A-nNzUOaih)v#nt8A)khsdt8KEn=zvc0i1=zp>UkwB{5Ez%3g5l3KFYQ
z6SG8Ou+$Uf<IXd9HIob0DR=HDZYfv`a(F8Vxds79$eo&{t=3bJ#@51h&o)7#+V2kN
zxTn$CMsfl1{PTyyfe{G`sL++a$A(?em%yWrXEPCrM3C#6D!L4@37%Oix<h|0ZZ|a~
zzAGV;9HE_**#sGoX3ls)pj}0xa9I@sCbU5ACTwl!u{J!ITt;ubyG8?{`nX)hm)eJ+
zYMf#$UdUhff?1DvwspiFN<+T#IBCqn9Q>nTBZr_cd37*@0W_4@!&Jbud+SqB=m}-m
zG$PgG+{#HO<t_F&Ct4`9_#jzVc;SvW$3%TaA|ISk)7$hkWC<KZK6%2Y!zz`zJ8_)R
z)4MqPHwjilxjS%x(b*vuansp^+!I$%8G?oD-O-UrwR=cm@Blb)ffk3+J~Wsq++xvA
z_<zq>4Dg<L2L6C3-}0Phd?GbTd!~Rwd3D~@cMbE9+f?Cv7jqU+FF6eMXGy3~rp&Pz
zHFdG&E4v$*m=jMe_zn+Sa)0#yEyBQ%6DUV$b!X?`PEIyNSHgYDOmC5@!bW|7+8z?T
zsCZ=EL{fS&Vv1DC3)ov%YA}Tn%E;f|g%Q+q0gg<I2$L>Tnx-^1MW?vE{W|2f@Ch*x
zawCb30VIfn|8WssQ&@xMEM^(oOp8c!+|=PIiJ}<8M`nC~3Dlt4+qj?D%%Eow;27A}
zkw7$XfCJP>kyscraw$cm?+4FZl71C0t8kJSL~HPAgH?>QK-r4*T0}saQJ2u(bAc6_
z3=&I777m;cf6KdI&B0e%l)0e%EG%{L6G1h~&0_w;EGQf_(7@ES)Z4T@l>v74L~wN9
zIvIbY0&c-gTa4GpEX-O$P{uOpXaQQHcoYpTB<^8o%MUEq&^{fVzSHQ{I;2sDg+Y@)
z?I=ncmfGC@B&A}Q0Q2D3?KWtiok>MhRz+B3@lhf)rd@ionXm#EMq7GdJtyTgTv$Mw
zT@RAeg7Q}|K#p5RWqM&ySH3=PVDYdN%~&*G)8vXUGW}ZBJ`r+{z#wKYKylCtjLI*n
z;81!~8QWQbFZX@$>s(!MuT?RX1+Gc7VpKrv-8~YRTW+2#U>Q*T@6bquM|T<Lz)DJ@
zD(E83@Su?5v~>nYMVmp}fR*zzn^dk*U<^fYk^CPw4TE$qjDU5mK5YzBNal{FN-p;<
zMlqsc;W0JLALC40>pBty%;MHar{v!j#4u6R&Oq)^-Cw}Ox1=CyWXw=lGitze)sH?(
zcQ2nXuuu1>F(Vc*FV;j3jnEG^twjE34ev(#50PCogm18uiWa+|ap5gYJ_1FXTfe@F
z_9en5l6ZZa1=vDo0>=$E@nLqY9XIhvTQK{mK<VXR=e*%L<n+~p;9L7hSWi+$=EB1A
zj6u9{imRV0HVXWp-!oIOUS$=$K<E9*ZPHHoH}4Txl7iQO6P8`~^e}TqqCn^=`W5TM
zSl9Y#;;;EF=aKg@KUG|j^DS5;)8;VHBN5!{kwsU&7anQo%*GxPJAY*>;J{9TSlb5m
zlc74deKJqn3~jo+p7gj_>LkFBL(&NZ;qG}lXq?+@`wLiwldBu#-+LhXE67@nTXkxn
zQMDkw)zOS{=L~3An15^(Wwmt>nm|4WN4Y3Ta(i%EzVN}E*=S=Ng&t|l)7oRipLRP}
zP052<bNNz^&XCB^j+l;$kuFe1BVGfTl3&7ojl_xZ1y>E)hA9}dT=W7|hYaP(RQkYo
zd2-eKXYNd@rQTgh_}YM0k2(NZV@kAD%lw;F+y`%H$9^tz%rdZwTsqX^6bf2V05o2-
zExs7u@%FJ+dN9BUP2e%M2ykpvc<sV_5$1X6Q81?&;ktiAWlB`?OrW;_Q#^#f;k-)C
zq^H!P_e+!<R?hCRPcy(l@ipFh0h1TFs$ikfe9$b9wF7TG?4GLql}x1IxHR&7i@;c`
zYW#9ExK+7`QzPD_E@*yFvIiun3-zab&|rPQujsH3O!8(EsX71`X;7UUx+WCHdUqZ1
zJxg&Pm@tsNL1`IJ8cD-hklA6;Gy#Jj%2NS(hh82w@AUW|Z_Jr{?bN0@#17Ju-Y9Q1
zyNF}kepBW5VR=2HaEWk8sPIVR_yTkug$sYzqkx(9^6;7{a9LC5;0^I;UTJ9<&7WeH
zqQ8(dL*hZ$zg0v(d9?Ba8<-DqK^>E%k2F%xb3;6RT)(jGVX*CE*R^PpSh8Cx<w)@4
zM&#7cNIe0c=o_MHX{QH;OrZqj7hp#ykW7Cvq@1m5@qVfOVNTaXG-v{J1A{?P%0XFn
zdjcR2L0It{USL-qX(ZBGsah9s>K@nFj7l2Rg+L<yEUVp%1Y@XTpV7aN1MP!qn~uyC
zO_Bft2j@jK^jwLFeZFW$({bOzFkLL#e6&)L&2GBCzC|s$N?znrASxAH_D%fr=Ztlv
z_-ps(@PFWl$C*&{li5e!j8ffQ($G`O03kis5+<;T)lnu<?$hrCtJO~c$B;l72*|ik
z3P7>nuy5(;Op!u%<8Hf*x$r8Zrf#TRt~tEEEK=pa(LlD(=O`P(Bt(B6((GN|Lyf!Y
z=j_uEMleI$NmIZ&jJ(&hNvr{Qv{UTqMuuW2LR^Q0ClK*~>O$i*2xJhLXEOSvON1Yp
zv_oF7$sA@o0i_0n1DSHAYj;d^7~qMvWiPh!hoQYKYxS058{7eNsB7r|SsCuw{QN9`
zUQ2h)b2W}uIp*bX<PyRoGFJ>ULesw5as}cVdTerxNHRS<EfvSXSou;_?9_*l+n<e^
z$5beMPhEAlkW~!1>?wE0dtIo5#F+Z2ckDg{yXV?&M?XMCPGP7>+oD`CAW3hN0iSbx
zFkV*N&~u6>Q)r9d>po#VZKnu&VU!ruX+YtSWik(lr;L+m_7^fWYuhr<epR(mH%3Bh
zQF#9n9+Wvnh!<C325E#@@VwOAU$0yd29leS?U#ZH%tb*}83NscadqPvQ}b#6Xw!?=
z{uWrXhe36~TvK$v4X7xlnJ`6U1U=WpI=?sRRCbnT61y+vay3P=cr@u!3<Xd&SCc6n
zfZN7J%e+#!2g)^gSA#TPgocg2NNpH=w9QSX6)88zmd88ZE}MA#;qVveJib@_z2aaX
zSY4tLNR)BL3&T4>0&_pc>5kJ%kdQfS#5Eqabu-RaKtHpZC|8Lt^Nbt75U(&poY;b(
zI*NSa^m*f8OI}5KSA1UMMJCKqmXtmj$v{;3g2xSjWOuanM^M?62Xvx8{q$8-(Z1SU
zJlF|1Qga+sX)x)CW=Ga4)Lp&nQ5%UgUAM<FC%e<PW^!C7t=>gmMZi~{xx^XK5)>~I
zvY^O`d*yDo=)xaBA0w`BVnBv+U;UoqB4eZJn>KtZXo*CK)O%*6JopyKB#>lG`4?x@
z?A>j-y&#)QHZHKmceb2HGg^Sr)SsFNBv4V#R9Mym;C`pfr83q76meA-W_wdNt&wyP
zV$zBx|9ir$^(C^?0$sXiAQGxpjKfmkCRS7D7CXLanXfb5R6x<hY!sPVpx9xU5P7w?
zOdLrS8H8bg!+X(|GC@#P*10TAd8KrBh@W~u(ouwsX%x3=GbF>PK@m^xuwKyD+VY`T
zhJTgCvR2gQ47a72pR3YCp17UEa#Nl<;FxgbO_!R>R3;_nV;c1VC9}u)CWKET%iRsi
z&W#|7NE$yr+MQDWV(@oZZxnLJ8qh!x+%o+@`Ukp*>1@$dt65i>*xC;nx>=?Iv^>!=
z9TUIsS*dJyt8*E!qB+Q6NDOEbr_-7C7un)me9ABa_KGo^zyj{cYnd7HLJw87dkyy%
zpSh3@=77PO|BjT@7^39pSV}}#M<HtmLjm+YDi1Q9UP$D<P!&jB=M@zE^UBvXJX9yH
zBT+nFkoUNC!N$A2#?eyD14D5H>RyWTI*K1|atrs`%Wj_anJ3L0=e173!k!7B(b2X=
z#j&kD8PN%ZXH+X-{=ZUC=Jb>1mfy$%E<LPp(v!5xvum7tN0gDf0c(kOPg!0(I(bhu
z0EvQ(lFeoK!w>|Yhr)HmYurIFcdM;ttaT6qqzQa0-LSM*k+bffW_oYGvP^Y6rP-S*
zQ9g(MTS)M#SVd)-a(46o3^dsuQL2%hwih24n&S5}EWQ1$msO#|#H5^tsrq!@(lNT^
z8@Bmjyp(7}#vkj`n?2EV4XX@P3#N-Z(BCKdM{L6q%m??CP!`jGOcN<3Q;+ccu+`kM
z>flK%<P;I~@qm0K70}!U57li`7iE0fvit*VJoU6hS5aZTgOF1NA@6)3KGa3>PHfr^
z6tfY4ID(yaYaU3Q{PE4sJ@C^AS(RAONo4J4=AbS?d;z(4=_!||3xqiEapq{`&a@Gm
zf8jtS(z{qIbcW=^#nFD~7j`Szf!v+_Z1T>bUsGVcU&r@T?psy$^;|}T5!CQWAU?&J
zBK@b9kreKhQZhzDK*{ViSB|-#GAjzcEVsRj#ilH|i^4;SShwEHBxpa>sZeI!3WbW2
zK=NzW=Oi>nUp12q$wu~z%hS*z(^@Y|ip9L$-BTvw1Bh;h8u5?I0<uv+T8W=f8@G7&
z=lIklrG1Y_cD9O<5CwjxQ#La28Q(O~@EV2HC^?k>wHRT8^IdNnk@hw(2T*Kf|0g=z
zjZ#AJ$+N>+o!dw?#0S7|<(j(^II~|U(%4bkzq%7L)M2_3`A>VbiYMok7O=wPkk<Tr
zU`S8O#yOpup>9dMH_IX;S}3E|iN(9;rYhTQgo|pSADKeb{-}E=g^f9sKAk|rU?n(;
zf(fb3<OuU6^3I1y<%tPs#xZQK^xtR_NQPKZIu=G7v6(M9wRR+?`9D-zp$QvQ<fY^G
z$qh;412auYapt`Sd5}ukB_z2xT&#ztP-ZzQ;ebvIj+@@b6PbvWkno4l!E>5jb`H|1
za$%$El&x?MbHGAli@m<C*hx`w8?Jyb&OcV_KB<I`aS%{pH;FWx_}+xi680n`(awo=
zJpqJ5H61z^GnqlHIY*+FnywQYH81;YRY|-E)a(aBUd0ec*I|i{ZTtJ$*%~Ck-aZsf
zbN$8Gw7G9ln8F=eR-RLF<Yrl@P=2`Hk&$Hzn_0f34_1@IbTQ`^1A@-2wcKU`Iaw28
zB-H9WN3p@^(6PPGq}DgkNs+(7swh$p|M)!{UPmaKv{T)pzf(+C6#8buNJ}~ioh!l|
zyn@jj)*H&=p3gI`W4D<Jf_|RPw927$E0rh>WE7q+J6VEwBX{NFAXeYl_7UNq=&N9H
zuDxH|Y4NosOlwuJ<8D|-GwnJMjev4}@+5M^6VX<&F(4pA$^g0<-ZJvI2_Zs|%8~JR
zNY*H}{Y@SrG2dx`5PocR;-_a&3Z_7d%OgMvd_Rnm;{@TtHbE`1fsgTo0(g)Px?o4}
zG!33G#a_L}%XWq|sLno6CKz>R{e&$sn-T^0>|~}`8f%qWrAk<4NKZQZ`83^jb!z_B
z<DCO**^q7I08Ix3&kg$i^}+)iyXU+yic$x*UBB~GH_w21DYvhOBa%#uP+}*^>ytgU
zZ<4=63{2|jiTKLId0!)cP#kyo{Ly}A7ji36@Id8HAZ&V|3ewQV!DG5lpj6*YZ0?G(
z<}Y7cDdY~IAWvM#@a<?aRyo(Q53)*RYBfo?oU~#VItp%CIGom6eCTDEIo%XGh<k=f
z(K9OjQAdbQc-b=_2Ru36ACdu_5UDfsiZRkR@-zS+;&f3|GL)}Cn$qljq+oc%X28e(
zWZ4j58VOK`-{Ov2i)2UN>=2P76J$s|;q8dYhConp=+@G*@Zc@`cch&SYu0a6<+fUN
zxL4_79?nn}Y=~ds7LdsOhhkm)s#tmGm6k_Enn+#{0X#`v%`u2#Kn*~45t#04?O^<T
zp#h)LGCh{T0o~f3ZKGhb+($K)Fkds`ytL+A^zE?3o3&1N?yv$^fa#8bjy8T#Uf;Wv
zT>Z*=g2^|@!WDoF=TA@`ti9cBuU*xZPc+#uz!PasCTH9XLI{j$oPSJ~nE;NYnttea
z=`Aa;m62K%u)vP080sbol-u+k4bBrd@6VyDd%k<bV_T4(NzOTMqLo_Ou&HoxjE_?V
zZUmPRX2>f-__79-iR)H~08Ji9dByT@__I8=z&Ng{eo#|jeQW8N5dn7K8Alh8lkSO!
zS`#4sl19;EdM)6Kv{1juI{gQtlnqX~J2RaL;haB<H%NmX5!v5wYn`T~YgLnoKEn;M
z89!o(dy{xocinnHdu3qIQdbkUTJ%na+^i+|SklWe_dyAlcAG6Y?~$w-V18f*cXBS-
z<aYV9{r-GRT&c3yWDgE1O5~|c(EJ~`w*um6L;m=ISq-viQ2at+b>zec8nDMFH#?OR
zKLK@J1gz9kEOW6Q6YtVS7Ddx)F%!R;(C`}TzpCH`;KIlA-Bx28!hx^^f=#A7&MH0H
ztfx0fw|aOP^_&p<ELlaFIh^_R^c)4raxL%sEYU))XGp*Tb|*-E`+AGm2;J>_dC}LR
zRCDdVyPV?*Fp!9&lDG~e+|ZK<l16y9Ki*@gNM}eBQSD{g<6=-W%u!n=rrMD5CRGrS
zK+^@{e^fYS!YEau;_|`HcS>7QEwl$!n6wgHo)F$!<WOpHNDKsc2*S%q@N=qb6jGXg
zDadu<uAnJ#?k;iaB#_P<DFzg5k?S030trM^;%7U<)II&vO9k0eGB}bb8_ts<ZJ-ic
zw3~V6d^Y`mAf7`Gn*U&S9yYywqdcFq7}VR`b4t(~DBVORApv!cS)N;P43>eOc9`SO
zABpY0CQ@`ArqQxr<kAjcQ-Jg?IjP1wd~qXIk_I9IVN@G1fZJyZTe*LSLU0wA>VQNx
zGO)C(szZ*u5iJzFUlT79=Z!dj^pOi7_08Qx)lu$bLdm6*re0aMz2FRSOiW-AshRa;
zK$P}eO<PAr6Z!*Lh*tM6K@Gmfl}u;DHFPQK_2sl#*i8;W#xSdk_2jQWi%~hqnq)gk
zhCdh#q(I>ythVTv<^QHg@o0erB@I7$5IJ}>RFFZLSODw`HT4N=-{!lRUuU~^St%rR
zBPx-VtQ+O(=DmJjB{uIELnj4eIHrasjZtUCkHd%L<?W9Nz$qLKf`+I6XkKtz>~Iq0
z`Gn^r{Kphfg+-xeB=P5Z4K|2y+8F@dB}-;e7QUVY7G{II;7Ex9rIUzSo6*i&n9ETK
z@Ucj4EY0%<bh10}Fe<lGgrsg%yrJDsyrIqhCx{3{`ueazW0bmFVc1tO{CXhl+hFzZ
zMREz@rNW#=fLU}>1BMXg6Nbu$IQ#hLb7I945<{H|dC^dNb2fV!)>rzdNi`I4Ak0UH
z33EHWxi154Lsg4lEPhSVy1X1iIGjH)VpgTJ7jBy+w_(uD0n-FuXh;yE_%^)LG^9Gy
z%KiVScK6Lug)%T9%(i?MpmQd3o;oIQN1|COlCsu%NJmpz@~+?EHgr;e1)tzxD#K9o
zL+e$<{nsi?@&sFo9n5l()Ro?O!59%g5~@H9TKza02GO`|$I^<+1@%Q{d7Bw^@yT<M
zP`wuST)*2lR>P9y^E8z`cM~I_(bfx40&R>jHQ<-3+Qoc(i$wicKq+f#l%-p^c4t{b
zF|eP&*l@`rr>q?5B=+x80MW>0apRIyR~K05btAh99dUbkzwv8o9KK#Na3XCapO8({
zK-ng1S^;`9%8<QbQ)K2Lr4<FrEXHHe?1_Sc5Jkiif`d038}Z_>Xch^AHeLL8`NX~C
zjfO+KH^r_QkjI^MeQM=T&0SGJ9)5)DpJBsP#3N>AAS)~2G1GnV5esWpN0)dM8(~q!
zbefn!Jb9KnsvH@*xxe==Lp-OV92vetF_0_%&KUO;60f)G=199OYtuoZaM5TFEe}4V
z`wL-N%Gn`>^hdzlupd#&<^qUjGUV|j*3dc_a*`Dl{idO2`!LdDIY7w07;_otu2)!c
zDJDuD@n*7E*!jTlUWC$h3u4ZZ-hTbVm}d9IYz^5QPzc_aG~|;qSXt2dCWpFnWkbtp
zT~^@O3=*OT@}bjI)CpQ{oZshy-ZFg{ZB0z0aEr?YF~Y!jxh!ewsG`-GdF}Z2OfO6c
z%Lo0)kmE76I}hkXSy@7Z(KNtQ230*gTXK-V3ROM;TQj;#zA}>Jx4j1DRoI1l@}nla
zTUUROnCd)RP7q^l3CYC=VbL^jO8uaG(DHLQny?(RJxRP-p+yFM{0wfLLf-><uS|zd
zbEEx7h(@?$(LId){%cZ{$KKPJiKJ^RTVaQ^<BVHM9+75M=m=~8Pw(oyPIzC2s78+I
zArW$q`?|1TeHNr>Mi7>#!3(em=CJsPZdKVzTlVOX<Z<%v5Rl-1h5JCuQgdZ~8b{}n
zIC_Tr*D#<uv4?HZG@DaOqRkl#+T+nbQ&JT9W&PlNo8sj$(J&+xBJWGlFm-U1N^n97
zpHh=K(W}yx(F`k6oNxI2Abr)Q8Td(erW8q#;_=l5)>Y=ma1=s%dk99D^=jehLMt3_
z81%0VuYNgJDL+ATkON?lD>26RXFgcdMY>`LEk$wc;_(R6QWP2N1++*;l9K>1eC4G&
zK2o0GYI6?b`=CY=HjZN`vgAuqH3~wSg{WI`9Gl=yTFF~5(TjCdP3u(R8bc8|#R%DX
zQ84^=*03v7Xf1I(SLCehB<bY{UuNZZQM{G`AWodbvEcwC@#0mX+5=HY96#V8P)bX#
z*?d=|wEP#Yd76G_vduB2VkgZlk^My#C!8Kqg+(&<UaNUNzYFZT)4JhGqR<MV`3_XR
zW@KVNiIwZ?#DelXbf5E@Pab&@dlECbj*5gh@x7V;KKAu$;qlxq<2KY-c4Uc;qoE^z
ze0J+}`#A_1Y*bTDz9?HwV;VysF&tCQF4#p%bL!v+3C=K=>%~A?VupXw<RvyfHaipM
zb9fz*$#7Fj!H-62io|xYX&dsGx&2;?T=8d7l26i1uz&hk9462oK|Vr&@bbvK9UM>~
zNd)qi{R$Si(oP402sV#k8!5;Yk=OsBMYIb);5wvd*xLt6ssi$V`!TpD(sX~j=+Us^
z)6yjmHlEn_^8NJ))Av&cTsCiJfO-W3fCPh$W4zw@H-@3^`<cT_4C)6jhYacqQ){yi
zsnmmQ&8K_je)tYK4<h#;_}k_q3&CE)9s@D*92f~?j1d0`TEq6|Mn`tZxu%lhMHsvl
zaVt^>PW)pLS{8Y?W`-(qP|h@j6j}BPAz377EhL*BvlAL_*2Qtg&Ep+jPeB?(p}3bG
z3llb<{yCRQ5aPX!yXE+3Q8bNV;fPvuF<Y6pp@>>Q+bt@Uh%kAlp|MwjM6W!D#jBJK
zVKp3cei?DUASrMHvo4v`6c5i=y7u<T^vd>4R<|S^#l#y`aMucCM4}_$bGM+Hu&?$<
zJw(zf?T1kzinDJuPZV>T#QjzrRc<k|9_W*xS*vWy3_X3%)!~r8z}&c+S&B-URl;Lh
z@iY?@T-h>L(BtIPy?*ixC=jvlqi<-Y?lxPR@oB2Bo#VO&LFDTCwNzNYC}?EfUqBsd
zMI-#wT<(BO-B!%}cQ<avGKdxhgcAL0L_yw3+FH=KOdx=%JOS~XTlN%DLD6yajav~1
zA<E&Q(Zm`<8m1@l{S3T9em?%%cRl0~+Ji?`xt^BO6o`}m$bE)>%>>$NUS5<c@SPZv
zLz;?KFl^&eDIL;sG&h;`7Q?xHg*i=P0V9fvG&{*C6_khYHVinqBJZ6TN&*-IXAjR>
z99lUP)SGcz8j7|29eJ4*6%yAz2~A}9oj?a(kRA0LdBO0D8Ud*`M3WsPlG!xa0A*AP
zYFNerCO1SzcrK8VO3g56>L`JDH1vcS#MNN;{a<29VPRJHeVcfbYo8byZ>G&o!0NQh
z<Qw(}R<}UaU_RBDPEkm|#nzGTa&cH%%hM!^=u!@ScB}{tOSiiR<1-@Sc-@we+X%pz
zf}i@p&rN*kcJxPooVi+1rwKY1#K{<Cod%uU-Ebxro$zbl^z(ZRk!<MF=wVJ#OhxhQ
zJmo04r*lgN=&AxxKl>6;M^q4JhakbE{4UkpDnU?JhnTN)U2hXyOfry98?#o4Vq_$$
z(HlG|NMi0`S_?Cnfy1B9V(t^GQ3A28kTRzGf5sZ$=4~t_Q<`1W92pv&NKQkSULT*#
z6;N#+?^>AD3q$&19hf9N+QHnzaik?V5MAklu|QlU0MVR&J4+Ksz9i~JgB})ugceu4
zUr##XB}!qiVO$MdqM#&Pwk?@-t<ULn{YQe$3{69zXzdV4JEUB(ZuG)BzktGDTndD6
zKl#?j^<_!63Ju$&lGN`I`WARBiZ_f@S|L=0>rn$4k1x8F`f8uibY12?l;ow=LB6?&
zCP$z*;GK0?;ri2-28DlyI9OCQ`VLz`=X(p)@^NChC&3{7sqKH1fb<bM#yFBnDVqT4
za5)qi%GM@2L1cA2bbzFMc&9P|1mB|{U#Z!w=pxB{MS$XJrF=yX-ymFIb8MwseAf@a
zbu{r`5(HQ|uh;S3%VdLo(<V~rCH>c2X%g`BPSaEL3S8YF_OQH9>`7eOT9C$gz!A9S
z8(vyb@?S~n!9hZw=GX%uhjG*s)SZ}Zt;F2dP}2^2O9n<f1XSqMiGJN)KwcS5<B^?N
zqR2W-M;OCcPA`}EvnUu5##P;r4n(1OnD);yZ#xN;u~Bj?OJ+Ga^f1X7lorks;W|p_
zGjx<)OA=u~)mTWfd}+TxvUeUUuo;Efk&8%33IzPZT6f-bIC3B+H$dUHD+(^m1z}(<
z6>lc7W8#o+i3$<n8SK%-!bLC0K9SO_ozaSIv+_m5?Cl^e!Bh#`Jo-=EBP$fj!nqsm
zyf#I2vWreZ{I%^g+9U(iAaPV8&qN!~blapB1Gdr7`m5XvMR$@!q+|i5Y&=lx3upfn
z=3G-ohwEvpES!U;tdZj!7j_zSiGH0=JMT%Pj$y*7(7&Vd7Y(%(<^;#I3Vs2w*%4Kd
zY)GM*7Mg7Z%e!7dnq+NAj|PP0Q{t<-PMe?Z)4yEom4iq9RsLM;i=LmFQq#w>j1VX*
z9ZelA7bjMnAQw1kC<4O&e^{H;LxEbJ3~dx$NTT|D;1xxTdYbd#6UL^JT~Wq5*7ZPZ
zS6^lAUibMkF_0yi<{Meu@Kv9STKJuHP)d=}JbE20FH(a9fP!v_CNiqAD`SiDy~aRz
z91L??Qt@$E#&*o3cAN{yl{qyC(V2|iOu<U$G#mQdR@^gTGDAvXe3jc+wpZXbaBolO
zo=DJG3Gp`w&{`IrKel^D$-&eK#7@QCG^l#_XwX|Dp5ahJ{8uhAP-*}Q@XrflaB9rP
zPSvk2-wD`O`f*62>2uQvY%xV;(WCFSdXZvO^y5@dDu`5x$q|SIKoPaZruj=xS22=H
zBghV{^v1V?F_;Qiv+uTeX5X&#<5p+rXP}6hUXt+AUp-O^E7K9hCuB=t>gwJSvX(-)
zN8Cy6%tkkbZiGQqyFGt{G@MP#rEhqZ!dUQ~3XqAEQ~{BA7Ns?LoLZaFUh1rgz<^}l
zk?>f53oiXP@I0`8gPS!1N9jz{1&gHt3~YxU0!y@u9uC<#k%?e#%N(3g9Vupnm7Wb^
zHb7sFB%Tr|tTVcZumX}It@aiIHmU6PWEQz};l6(zbK=YewfzbfFof-DS5Ipe#RdrN
z3R8Ex8=`zC>-X5D$L=xeFabfxc1t9Iq;ql^033x&Y0k*iX2>xdkw{_##M-QflPFn6
z>5f=ON3;iyb@ptfuBnbas-iXg3Nmow6O4+KPiGp`-k^qR(a|7Kc+?x<_B^War~(3L
z8Qp3x^d_Y?!gG9m{18vB*qpA0G5Op9Ig!KynMPo~GyJeFbue4jDSC)u9}M=$FY1g_
zqln8Xe`u!~;)TM21lWzFauE2ZBYei<OZ?OBa8G<<3Y>PaU}aN+yIr?d?v4~4w1rTU
zU9^?Wc+&_8xo-<h{@`A>;W;5n(_HmAb2)1ozGA5n`2Oe^GIzeW=R}`-H97QrG;|FR
zB$+XA>-!q&C7eu#U`#L^jT`^%be@9nS~NEqZ#hKt3LI6<APrz`#;LYkS85F(E3(AM
zIX+(=B)~Z~URwpxB+%^J8!<aA^@6d(me5`ivk4E5AcWG28?Vx^^Txm{6Y2CT8Cqi)
zV8nDinAuQiU*-ZLDf5U<8LN_E$JlStq|yx#DiL<Xr47JFz#5OIbv1i2f?h&dmcU4P
zZsNca3KG?oNI|aTilyJJY&0l)Y-dpm;{r`oBadL<dEOThRrmq$W(y{S4D{sGTXBoR
z?%OmR7I_5JLaP*9*0-ErEF>f3TnCZ+m6*6^%#-kQUxESiutw8gNZBZ2@!MTiM5C6i
zO%})oL9oU4_r$TD(Kf&I-}nvi6y=<A-BL!J#SG8i_c%bKL@(r7R4xk;O;v7}m!{Xk
zBX9Myobz2@I;xEwoqC#S609-ty-6~cigp*#orXPXb)JJDT!Ko^fmtMT1M{+Xjx$qX
zHJbts?Q`T(SYvH~j2>1)NIS;GNr0l%&j9SD+p0*2Qh=w2%$b}e|BYWPM{GDOf6+^+
zcBe!ZBw=o_0opSYghco8<JQ*^^xOgQG7Q|(6okr55K0Xu5ncYxUU+t3fU+6QN=yTV
zzqb?E`au}^0?kr`XIhICb4k5k40&D0+$Pi<`kp?x7i2>Z5^2q&eOTpQzSIQ9>PvgP
zF9NGgT+nhAMVE&dJ2SdjliL?h29<Vh+o;$n2)QKuFVmP}+F_t@_9Pc`Gm1(U6H##E
zaQKr|iT=m8PL><iY^<}0haWB>yf$GLikukvrPcYdOI6|9Go^Bp65yFLg-t-ZxN=-7
z3T<pJv{C3X2uOoUQ5JTW^pE<FdDO&~13Zj`f&Ncb($uR?N?J8Ws5Bw$HpOaB%sxbD
zuyLkEgB9JA@ohxy@$Wbx=q2x8Gc0}zOg>I=#g?$r$vNIpFG<%SHs`$THssJ}quhXb
z6iA&GQeWGQHsKfncwBUhHbB~_QFjccW=Q%;W@5Q~s(OAQ;z$$&Ph)BZS!pL2b^@|v
zRfw3+oEzLUkb6a3oHKTD9K?)c;nWSTs6Ka!*<6xYRpD>wS?JCm5m;#52EZSeLJ4L_
zl)*~Dz#lYndE!gid<><kvL1WHd5jr{J}_4vOW7w8XaVA!@k&o{l)#chy`>qqQ(d~B
zfHC0ib<A>ijLe~1{AWV!2(8v5LjNykUX=dg+IN`CUuc`0z($!_n$lv2<p>o>#eV{@
zVA`?}iB$WWLR(B*ei=(}@T5ci`yRv^1X5Uw;UbhtL}ZS1LwQLQ?5pNih{0@sYPzJR
zf5RCh*;S#`m`yX=ut39yW>Sk~P;6rWQ%vRd<9<_?P<$()B=zxe&6o1=YnaG4IXn&6
z0!=k07e<P2{e6$6=P=o@Mcc`hhz5TzXeOe?P@aD8C!4%`NAJ01+(=n^1wTDN4pzFe
zN7h;s{LL5PD!$UZ4nv(d7r1W)_&!b5_+<3TT0!XKd9l~Not4)G4Qd3~p-S~jQl6Vo
z#r<+@a>F@hD>Plkq?h4K>bPB4lTMUumPfWwI2XvRMQSYHU}S?ekDM;~5uIy@Ph_z?
z%UIUnKu53;YFrRQcV35`U8KwsWPfC5TKJWGypmvmjTG;NSX5Sgu)t(zUM$0Mu(@bh
zN_lQpVR15QC>d3`be&#t+!zSJmwaISse)Yb2mjTiOxcNqK#?BW5BPOmIWS=EhT;5?
zH8|)i_53LX!ou$H#JcMWmgF$j;iyqnJ5EJ~JXPJ*D3SR;W7vk}>@ZaZ@CwPaU&^1R
zK=@WloJ<T7@Y7X<&Do1cw4UMM{}6nJJQ|YO1(?1XN}SThO)U{?F=lr?03QU3?Ng<>
zUpPTLQ)jfX;E~Tjqc9O}f2rlsY-6eAGN7Adn<sS%wWJ6NDVbxc3$b$D=T@b>&g5|b
zgI<~#Z`8!4?l&2QOYSX5&lH=9nL~W>B8tBodSlDBM?~T?tLr<71!FC38O$TiA0;>8
z@+>+ts7w}mBX`P3zesmP=m3=iUm*u4v?@0p<4_2M;?pf4!GUw_TvZz!Q$|JK2=~cu
zi%*Ib*^}!kJKpOt{x`~Iz{cp6+6$3PuV3bC8If;3a|EDaDb^f0l5_(Y7xr*6p@(4r
z>9#nH;6{IZ-&vx}cK*<KM4-vrpX&(Xw*yAwVQ_1d%b0ae8*gts^;tso9h5+P**9h*
zXGy8kPxgE<Q)?*C9W*tuQOZtu<d!kY(40bJ_;qvY+>vT>Um-Xu@ymg)m6ZtVT#;P~
zsXQQx8r!zOp2J`bhiIHqS+4n+vsb<L<c!Og^UQbL;L|s_wgGlwEMk*#J(sWSdFgOO
z4oD8L!Q?eD6{&R5#g&@!Mk9kV$yKv(mr7u)$Wh!HIwMfjg?`(CE<wXCCo6K+9MmR~
zX&n|n3;P>M0D4>h94LK@b4tvf^$`4`OU8hBRuVpNm+9`S_KfI4Ta?URl?*$F_*I#7
zK1rMHBeeo>31b(e&H$T@Q$R3<M;h}W6A{!ZXHZLG&`$9aAr>`}vQ9HL2@59Q_=wzv
zT0D<X=yK~G(idg7JJdnbB5*YgGB6-dEa8}>h_{b(b2~F2{*+^qRW(e2#l2aS#ok0x
zM>xsIJQr(o>=+O>P%-fgBF`ARa<j)UOZd)Ogqy{zy=7FK%eJ<SySuv+NaG&dt#OCO
z-5YmzC(yVAO+tc)1b24{1h?P>56;_bt$o(n`<#8ow|{(NTu;?~&pE3`|LuONXYpZa
zZk~;aDd{TiLq2tydrm#|Uao1pY1COH%AoD`l=a8CJU3{DzCJMiQR3ExQPWo5x{r(U
z3IX;uXZo!10Ix|7@5iP>VBnstYJH>B`R+m6Rt9z*H8zE=Mp`}ND)rMwSs6JWt5~d~
z;mAi5wl871+1>4|h_mRa#l1i7ANUIR0+F2Ms#0b(g0kV_E6z$tR@nW&=2Ubmd@gtj
z-v(DBU|A9ESkn1?tksxy({52D<Kk**Xy^pvzUzCxzQia=oE=_klg?^ZW{LOB_hBW0
zQ|rT3+y<*4^5I;vJJ_IFwOMbJVX{vp**$TtAwDxjyujOyo8&}_3n$17Ro4LpkE=P_
zCov!))j)-^Scp4F+5p88Ztyc^G;VJuBwc)3LJ`G=w+#HL+x#{>yLb+*`J4*J-=loq
z?>i&eo;J!I0(kjYoPux*k@AtULZ5Ui%DdVuND$wQ_Sndg#}@HWcG~2VEAkQH<wZG7
zk)g)!(kY=l&Ag()6@o}tdXN?Asr(%Aj+=M0K8B9&KBi`;-xW*ezWFdlAACpSg$yxP
zxuHK;m*BMyzpgk>_+BXSLOq2kw=MSfH*D9Nk|WG~K-8;Zte{|}m+#6O^f+H7wzslA
zY4Y#C-U`KcLV(d<IwMeCqx+%8+U?w4#UrDeQZJ4#1a4d8ed9ROJ?mix-jIQ33R5Zc
zX$gAJF)?}wv5r;!5;%l!HMyW2*q*cWYbBg?q9jTIZ<0k?-}GpZ?>)8b>{r~&Uw!m5
z;$Ip3wbl#=HDz#Z37R9y<4Rape_Lj^TsR=NT&!!Ge|HGeP9mbY@0-v@u>Vexg9!63
ze5g@;;w(I>)mCAKMMRTX+V_5-yvn0^K*RR=B-7$tY-I5x>e^JPN2%vvekIpgii&D3
zd`41!a6L_Cfu&EaWv;Ae@GS0U4yDYhAjsiM>1(Tmo^G$;qJu-@kV9t4dlP!|S1K)!
z%0in59*S!WvkGye(p>s{7TpDl2`^&{v6(iumIEycuiRo4^3a5vKoWjpLqpC<(^UOM
zZ+&kTms89-HZ}8qhz$DIPR~ebHz%FAha6@({i3|;b*|*aQH2OPYK-%~?I7`;uOiEh
zN)>c{n-pE|qOC85xNH#R#M*m-dsCaOG5`61wZqH3;+-TH#Omp*__~vEv?=?owzB(#
z0{m<m<<W7Q`&W?6QCX~6ao-~geVnMRKMp>hY0gaN6ji%Bbtv}=nv?38viR19F`+GT
zj-9?339j2oT2EHA6eIJ%!G@lh-_zKGhCZjDrwC)2O7^0PbNHLImE*M38TV2vcOK*v
zHK9qpE=&@Yiq65sMH*9ftZ~Kq<W(;Sg3_B!pjuiA{c@HQivJep(uxtwi{OS)21atm
z6ohAj&<$uSG%b}!F!swY=%qjEm%{Zxn+iFtu#5tVW2m*EB~a<dR0Q3l@&mNVJwWLv
zx0@~vqusA!_!2vypra0wQ4UNDK$iTrHi24&9JeHJBsv2HNb@{n9lKf@_VdDWsfGZQ
z7OPq_{-ZeJ@*3UNViP&1?oCe-)yro5El4}trT?A6HH?TP*bRuGXxPmB>p;VCzqN=e
zm=6J@P?e;v!u!;|!97MjDg_SE%-3?TfzTi+el&OUtS#=;<CRG)r!#5o{-qq4=STE<
z!TUA=3<+M|)=5egMAhl6?=_Yw{AeB-2nT=!`)^z9%V2zx-P*tzdYilVPIBMe#N?f=
zhr_Q0uTN<noNS71p#u}Nzuur`nz@cuyxo0#-qEX@(p|cLkFVO|vEq;<Y5c=Srs9IT
zLteYZac7-lb>bD7_hNMw;kP=$zC?moS9@imRbBi)u#rFr656verZB-qjN#QKo~xF5
z3leiA=T`U%gfy5Tlk(wMf_;_tJGBeYSFGs-4JplbpkVy^<Jj~PiI!(izWgC1U(-zd
zyDDo?x34pVR(#6GpDXq1x2Cj7zk6&oubzSy-R{5)uo&Y;F4YMTaV<`qKw;(qk39dg
zPW|VQ0?GUoO4<~usVnUisB17DpfWW72_9I)<*t_rFkpjpO=tHia1uZd%P&+dA~|t=
z=$mlB0V{5f=Td>B?VY(mU)jqewA<wdOViZGukL*4vJvbWfK*+t6BG@jUV-)NK$@q4
zfIYX*6Bc=*iz$ihn4Rz7;9|tVIZu1o)P?G=i;PR~zhl8}$XT$m)VX2LiAE?DL>cuP
zoH6+s-;B!8q`nI<i2mK+9qM$VHsnR2iGJWWJV07c@kpwBRI-iQKa#5?yjr!--ecO4
z6^DhfZm05-!9V?FI1pC%$b1WNP?{XBu0{ECd!ZZdF>DXwkV$FjORX+RPuP13xsz?|
zkzQ{u-Oh#}oU~J~<@jO?;^6a;BwKu;_Sj+bHca}4;KB%!0Yuc2O8`5<OM#+9;xU<5
zjq=K<+4LK!gXuoFUfS0CM<<0i|BZJ<Z~;7zUb_B+wT_yx<DF>yI4W@LgEt8YAzJU-
z5Z<zSu;5dx4Eoq0roRQgh)snM7#-Va)RU;Qei97MG^$_HOYd@N0W-H6w&9#AbQhdQ
zh2o5!o$irRirW*ASOGWM{RfYhdoUqg>;VX)v3-JujUF(+>a?c%ZXo2?(vR9fG}8NG
zka-MUsasairlMC*J=e=`M_R+5#xAk$91LkcsiIr#+OW}m_)d^cLGT9oo=ksCg?DTL
z117_*EJFc}hRNOrWDkvo(OH^C=s^I0u;>EJEa-jrEEnI!kklx%i{QlaNJWos7(Mnf
z>zzL8KnA);H0ZMtO2#M6AE@G&+ga75;?g=oc4-05vX|?Z+evs&^}KSln$9N;qd43q
zEwf(d5&?M4Nu?%&@F4;cjKPHk3v$u8-P?<@qspQ-Ji&2uPoQ7Il>rK|jPl3oyUjOg
zn6Z6)-wuIWKw!b@cO$1`(fufn?gE?yi&5>!_wy>Zxdw`jLKd{&LzFccQGvNe9s=n;
z3Usg=89s>Jiq4a7x&nS1HS%~UZ}M*nmflHOa?h?{ue4%=?BQ;cvn+CJYvgv$h$kQ=
z(;Fo`!dVoTg9t2}Oim5nFzp?in;W7yv)@FV=tN(-93sB2P8s7IMe+3Vy_$|{QxVm1
zKCsZi3eXd^3*c+u4l{Kw-I5Oeq~zJO_ai~mXTZecJuau$<^UeZgYy{Aw!~E%uk(u~
z?506%g2rahgBC!LyVJRbRAPOw`U_`Q$39pA$zIXGdK^HK@}d)tf0){xATjDwqx3T*
zs%P>7(wA)QbyvEmheXiC<&5P62X<y$@+bIyCW8E}Bn0v((nWC@?Nqwq&2ohd4$$KB
z#280bMwdybELDSOQ|~ZlSt6xgB2exUk}|!S(fh5UB+%>sGfT+our59>)y}E_3tdH%
z|DJEe^u=#P<LLo|U+%sLAuFp=7!Vhc=P+c$wGmme`3^}x_l%5Pd*$a;KH@<4o@<+i
z5ZiXl>r2Ih8zEG2iYUm#h7svPG^EI@A6uDorI)L|XTIHUi2oXDao?hI1%Zv?c|fH8
zr#6m8N<IZtUH-q6anWTK`b6D`6a#5V%wTg-q~saekh38BhmkmQLab_=#FjuJTy`O|
zapwM4d~l00Cyc^fIt^MHfuMSFhg!b<coSGw@7y(zavsu^63G*$LJ$e4z%wr_?*3a;
z@{0dG2yoHNcIb4{4RS_|Qb-p${egRSzTygZvnzY|v)b892>}m!#j$Q!^DWru%;tmu
z&yXSYbWzn+L6gai!vcV?q%WWae5gQ8oqk-Jxg>#}s?vpYjU_?5h(k}#x~zU1eg}BB
z>Q$*qhA2Z}na|5jv$e5$O1q}Miq?~haq_#K+N!&=85LeQ(m{;PU^p=GBWZqRgzUt;
zk?QbId<%C!9>BZ%qKRJx-!JJ*VM3mE>88!9&<;uLAvZNl{IAX&Y@??A=O3;v+3!wv
zG2LI?e(6iOGqpq)$8dj@c!qR^98|z9Mk~ZlNdmYPIF;izL@?*)+_`ztvrA1cU$Ya$
zXWdjX=mPH)`Vurq(<V6{lEUiV%o4fj3g|J5Wu@kKN7}TU8Y$$3O~GmF-OhF6h8V!T
z_m)87)>2wH?Tpa%NU?_WdgeotTD`l&?PJlRN&8n87Kf^ho$MD4jmo|8tai`RcZjH$
zXXv<D)LC|7zz}s`<=m1qE;PItaH-aCdN&Z|Bi`y)ZB!|M=H`d*nO;_CIg~fUeocx6
z$!N{}c&YEnoUM!uG?*+xm8V`aV_^~Dqm)<KWM<i<XhBxNFHU|%52$6S5nfI*@zUAX
z^Shr^116!pAdX*WexIWUtgkUhJe>;~#&a)PMB+a0n6}JfdXY?{uv-8<hGk1fT3s~d
z=x1oOHOB+y-3+c<DelM8cC)W>LC;PzkDM4ip_2}IItUj!CsflV`tU@|zXZO|*8i0F
z>OZ@G2~kYT=-3y^whwKAA+SiLH^M~7C_{Oq(9V#*5Don8b6R*j=X)EZPj`e4fxK3x
z**3Y8^e>sqo;hK~XDTbQ!7<~k1R!A(liLyqPSJmLO8b-}uHtMfJqqjYkByrd?Dq3%
z%Z;1A#8lPj4J{<hL=Oh|UJ#*&SiV|rMs1R9s-_~c=D_OWtK7;Opx-J;sj)kr;@364
ztrai5_98yLI1Ku)uHMx`jyH1U`#ehEaUItMR=_@WI?Q(x?7TT)M6RcNRUUq!By~l?
z0}aFx(grx2yd)4`9&s6dN-WOx>y1uBgK>>HecKKSH(dJ_gSqw#15<T2j|f|v=9e)y
z7!FIfbe)Fp?!cgfMQ&DR)&c~IU<~iJ>zQ0MfF5+owPLK9a<L0vZe0z>uWQ)3VWNjU
z$)AJ@2^{FWzk(a-SP#xVdaEVc+a>7{&L6KJz(D_w3etjG<BHwLkN*C3kiyGttx7+N
zH=ZlauH=5qh##_y8kaLUmn3t%>E-R-Y{{td?aITUly-C9HeOP6zhy}y4z(rYouZ$j
zwmtHegni7KM3GpKN$BdjDde@Bk)c4KvgOibqd&{s!=mm|#L|n}+}XgXyQ?XOa-sPd
zeh#aNWA61bSE#{5Y<bqZYbOG)xgHnf_QoTMO)p4j@xC*!RBo+~M||UVrRyoYi#t2&
zK_BDkCL`;vA;`06&(twyA~9accO)S41KCFfgjc48j>8&wy(N_j(J-7yuh0$j$1t-i
zRvTGOYZMGVoz&n0-1X^!E=ZfD@`wlzH%IGLd{~G~Q^W=0#`Ye>iQFBs*&iV&2gzCx
zyxH-@BuqE26;IOs3m+3NH#z)8(c9c#P96h_q+AO)Ac=~dsp;$SIsc}O(So3$mbQ(D
zo_d|vMnPVroCKG#NG{UU*ilv2_I)=-9(XyvfnLn(KnmJj^PvH;niF3J<!=cDmJy$b
z?sK$58s(G8LE7N@Phd9xMnd75B-fu(5jwMLs`(kxX=ijBs2G3~cerywsp-f&?Ob+J
zs>Mf20h?lhgYOzz<aQg9hQjEJpWiOZ*G}(Ne~W^zx_PJe2wRX?T$wX0==VMrASVe4
z3JFuMmyo1x)L%qc{H5UAcDp}>gqFv<wOQp9jClLh+-48+scY`NXg$LK0X7alm)M6T
z#=TnaY>QUW<X9vDx`&2esnb?(vpijKaC+Dw<Z20CwX-kHB{3E2Wh~__nWjJXCDucO
z*WVPMc0XyGz&iElURKLo1X_zUD45mRW5(f%9iT;lh4k4eD7|?^1ir&o4Vcn>O_7q5
zFMH21E%A|rs%I0sKJHEZP05#7BJP2<amBq`He|5Ag!4m+2so0rS=)419>1}A&txsv
zXu#RC(br?ha#BlLWHo4)-_HEZjq#Y&urxEb0glMC{wqj>GiXLzo>7;ld}LKS2VF81
z@eD!($1se{Fzgr3NA6A$_b4(F#J#xSwks(5LO<5^Lea%X8R0te_!u1}L?^sUS+70}
zw<nDCF?4uKJ<55#N&Tz$%x=?p9bY|@haBXcGlpfoKLT55B6h1mP_nzmQf-o4>S5K!
zv71Q*q^dP|>19tk%|pM)@xW~|-^Do?yz%9CX~t1s4&2+=*dg4#tS^LR`9|c6x2Sb>
zpvUw0(x4qX<K?@J2>C)Gg4kDkVh}91lGi68{yC44KUh`Itv6lA3INLyjiLVbDXTfO
zjLuyvJ6n<Zsisn%u<5c7bMA+>g>D_MtJ{nBHqX@_J&Q&0snw-feUI}pcR3HVuh{a>
z5O%f$EV8&X@fk4psoYN)dWB*P>p8U$^L%KAm{x6b+oe~Db%YcYidr6p&MK|yA^I&D
zOA4NgnvWu>$`KWx#E@ivWg4!Ib{iK0InKMajfRSkU$L1ZdzWZToG<kozfqE2`1r(i
zIiye8pd!`}&k&DljY<tf&d$c|&y*v2V@xz1oQDIu6!MWqnkx?o8xoRPzW=yhc0E_<
zkFY3&Wg-=Hw1g|VU3@79Emx`(l+QwXk0^Nfir(~GA!5M9JGuQzyjfSaa#qGLy;UFh
zn7Q>VpPaJ3ni2BJPA_18d51YL%Lcr4enbnrwtVAQELF1U#A4e1(H4*Gh_P`zrcVC1
z#gbM9cXV03IF+NpH_<}MxKysE;ze@xZEx_vAtMn9=G!%}l&(-lN?Y;MX0%WiM&K*-
zclP$Gb_iWQR3z}YJmXZcm!03szL?lyl&%CjVECAP8Vs>eL5wBb**`WPLARJO1<@L5
z4O(8upVEZpZTx7V)xbmm@P|fH%mr?jt4M1EInwYo%(_()*9uTG9x-X8-!$0CeO*&>
zXStu_m)sj_j;0=oTNC6hT);1DAOGM8u(7W#V=AmseW`X7U`ZG(Wh(qQ{!(q<9NLUj
zjD9ML^{aMolqD#|+8)dDA7EP8|3L_pAdKK3^uGuSGC1^V=Ie^iZAS~>ev*aR=4Rdb
zFq|C^$WO>yofS?-R_s5YP_#d_{~20=tOPF{?&un4ms^{~5yFM;xvm&NlX)4U0#Uyo
zHC0q|yhE=fvHm%|Vyq(}_0G-CbPtDD^_bZm@sco$1QS#21BE6@&Az$3vWQNi55Tq_
zm&<5}ah*oPA4hwwME6B~pMk9&F1a$QcznFIznxF&g{wQwf3}e?Xns~@BCH(0eaicb
z(rA<g6Spi$Go0;pq&gB1=(z#>p>~B+<~K>G%4U#~i)^ZtRowq$aI4Je`CJ&&2t!bD
z-7->fA)S;7i*$R7^07zgu~#o_muBf6gA&`rKS>gKA8smLS}}8ZqR?<+^;YfUT!r*E
zhQLO1^NoxcXKLT$B-uj~q$Mll^Y=p?L_Kl5JYtHSxi$7qtC}~}-A$s)I&kb~OR*WH
z2y5tt+-Xl%qANRBAG)ua_KWAo_2cZbP-AtaMAuMbm+S&xPZP(2SeDrq%5V-B%7}>d
zSEz^a<D8r?*k&R{wAgNKUNXpdy?fJ?rX-)UZY!tzam?ta2KELtszo*z);gKYm_=OL
z^P=7ngcV8ua*6nY!MgdnThd@9@>oGKZNV{DmdMc)h|>5vs;~eP92ItgDI1AM87NhR
zRt=#XSXLBb9eB<pniBB~-VE<F@!p`1&<dgfjZ|9)72DXro_XwL1uz=@ENTsW^_*K@
z@>)0wjb)y@9e)0sq^yUAQ8qp@zEJj#0v<clNP1I)aPKZ0WkjX`=73@h-vVPC*Ek&^
z<$=dd;xhdk!h=0uzdb+ufv@&VclNN1uhxYhS3O2nFtHFHy8A;-A@AJ`2ySIA5DZ~G
zbbMDey%|`t8pXEeO6{uWvHi}Be;m~P=!vlCFSYw>oaBBff{~+s-^#1CrtcB-=4~*X
z!`jw$$%#c>>^Mv)BF|4Bve>v!e#G2;N5~vY=T21e;1FrHw$HE3&A3%bV<%cnHl2$|
zqYE9S-Q`TPWSxUne8;G|ZfCW=hp^F=u02;Let8aNH%)mEJF<)DH!(abe5OF1Yf(<Q
zlk(hj((EV<7Hvo06%nS}nY9)ZfQ@8GVxx$$dSWMov0_LgB%CB>#tZW;r7j+0`EEMm
zsG!}&nk_j0dvl6ZNA4c7ZHH>fm~R!!Lvf}QQnH|*Zw|&>D@{t1Ycbxn&yzC%e&hFq
zUm4bs1i+~%xh@|n3k#T#`hMe6CCyk|WW1{}F4)LziuO)f)zYwqm}Qo|&B#PlAfVMJ
z^u^y$aWu@>+n{sR^YP_hnQuvjTbaE_u`tvW+o15(e%nQ{r<EF;+l&V>(N7JVGr&uw
zkJVB8%m>JC)uhjgHeMj!YYX&qNb7n0Q6|awYp-#VWeeY?=GjtaIL%MBGuD9+dB?bH
zT8-(;ifYNzu?Gj4h)b0~irj~r5Z<G<J`T9f39@?O=W{WZ5n?CQJ8SpIKoS9MoycHT
zs&j5l<1f=H(O<x-jZgdBViqF73OpHdReTj~he^F3w!YAj)zbuXi4LLJL{c>hxMv39
z@Xx-@gsybwsyB|GIzsA*RE>YExInZJZXd$Dl-u!Y7TquC9p3t4L&`<N3lpw?ekFlV
zqPEcGY~seIWS3|~yD!*46P9&;X@XCrw6J1nqQI>L+OdK~5xm$4BdEJr${>(lSnx9O
zTzfpvmD2REGM7|RSX?#6AzE<r#5a>X|GpTSktv8<Z{=2^q|dUdZAUbt<cVu6IXS;r
zG(#Y8u4x%Mt=M9>Ql>)0V(Mu=o8hFpz+z-vET>o-Xqk#40N5x@;~JmAchp{BGB9p4
zRg6`!JhKzPfhoi}ADhOv*Ib~{GEUS~+=~^R<--s#S)ljN)}X3F1JUeH>zN?&8s|?{
zGj(97<~@S83~GyLb}(+oABa9C{xBS#>K13TyNSWoG|ru>wn?T?hCGy9So;gVLP1@Y
zGxur+Z>RMRmezkF=AwPgHBz%6QmXg@;h%ILVP6pHP@KHw=R6;Nzaa4K4~fM!%(}qW
ztoVJAU(J1pWr3?+@%19#C-+CkjF3*_Upp3`HuBzQgtQv(Jz6Ah<gsN0eKp>@vMB7z
zbHES$YWy;0aY~b0o#EeP{CmY>0+ef)0pBXg66we`S-eBudRIdX|4Bab)8*Y~t=}ip
z%w0;Q3CFYYh>Vf=SCo_@hC$rUj|V#gOcrQaXvj&_AI7-)Xcwrn6kQc~KXUcbE>NZ`
z+Eno-)b)xlke@0BSMeUz^>i+fo+^5`@Q$AMyjdVVR8(u>Wj~)rKkw>Tz<*ZM-RF5<
zx8Azo`mFG2h<hhPEy9?cz`R`|n*m=n%$S+LJij>GGDD@vnBM6xsWFNd53=%a8A=#5
zj+ZmB0EEZO+udwHuNOwbK|5l)Fo;ClDbeh<N(%J3UW7KxT|lPJv9HE<b>9HVvGA~-
zuQo5(jwmDx{w<>gxwr9^3XDap%pW(h=rR=Zj0FPC$No!#&BwYDe&*=E-NG{$?OH(x
zd&)u01)e!?*9t1wqk>fbqzBJG&0T(jgs@FYlC5zL>%d+9nS`(vYBJ}r?%ZYXNeG3d
zB#16^WN%9e{hhkW#KCZ*IWjk;gnq}}4%A?(<s7MtQi9v#ZU!}ye!U(q+{PssRu6<f
zjVEs7ViBu{<pjxGOwUWUF}{kqF-=BEhFP|;s|x5NO~xj^>04t*8BiNc#zuzxf&!BQ
zS1i{;?Se9=f>;&TUfn_pR4R`@hNv6i=nia6FI;eHQ>Ge>GNI{{BgUc@cDe6N(`05y
z+wotykq&5&R&sY@E}t+3x5pmsad#vw*Bl7qMWWjJ==0V?`-}AUZP5`?!IMG)&5+ta
z4;$&v_=X3@{*9oAuD_&rBWRQ+T@2q~*VsD}Gzyb0nqjbQ?41u9l}Hc7*WWbu$h7rj
z?J2q)R#L|W2m*V;@${{wU_8j)ckl7K&2b=4_uS4%5=cNVYJ=7GU~!k8)*sR**vIoq
z4<Og}fN__a*6-7II>T+!H1n2V1<mH@D8B3{{R|b3m)PBL7ZJpZ3Y~vAH$ujfdtPw%
zkU#~_WY5W2xpkjwuj+$wa6L2)BxIPTY%z>KnhI*AwrHh(nLYiYb=o|8{0CZfd-a+I
z#u6krGkDrkK)3a2?N|Dqp*YDiloWc-tdl^BROYci!ANDs*!YWAHmoWiH}{1;vZRbF
zet4>0^<%s;u@cB|sZhl*M={oI#brX+e{*Z=xZ+_=wa+CK=KM2zikot8Z2d@?jJ>$0
zyc?y&i=JyC<$EtId`gcS*HOuBH7+_GAns{Tp;h%vgtKRDp+efZ3Z#i2tICr$N_+R@
z3gUbMO`-y=^C{|BXtBIqIl5)mytOtBZ5w`bt^sMfttgzAjr{Q<i<v~q5o(xD63uAb
zJG7lrLTnoHrC1J<8h9S*8TLOdRuP8Arsz>Fy7;(%6z`?n0Vs7ujA(s|6VD!o!{S@f
zb&8{}TnhYT?5Xb7sGK3DZMMpnI@=mY|0bMX<ZPTg)wpaUQxyyoBPhHw-Pa!<8rZ~)
zWb}kNyzgK?v2%z28*Xmt5ZW$ko0f^u7YW@<B7=J)eAgEd98BWBpll`2)|tn}nR1Wr
z6>s3ZU29F8Q27C4dPV+to=zW}hWwn^y17Yb9~A$<EEQGt^x8j3ra`KY1m=fO_??5k
z55CMdkHJ^hB;dRFUP3s*QdxDp-f&q6_=oXiqmd@SjVK}^zf?iBVEfjaG1yeVAd{zS
z*zG)9v&ME^w{#~td^B^|;6i^zgsK3nF;-#uoW-D!3mHb*Hge&D&G(v~#{#`9NQ0j5
zWl`wvq?Vm1-{jog1%joJ=^P%~nAL1HDNu0Z1bTcp_^B?V^Hfq!qu(e8B$N_G+SJsY
z>33$}{Ajfp9}}w*O?v*>IPme?wuQ%Z>d#j5=8Iei7u%p1PyM~CX1nR`SKVy1hsQhS
zL{74Jsa>A1I&amkscytKmoxG9ZW<!@xqdLu;deP3Oi}#pjFdU;h!6IrD9sICze$ZV
zM%ALn6x;Aq*oK`QS1gTGE>nMa$_ezQYCYvT0ef?5fdHfBjgSD%(06xYLJ-jHkjK`9
zpGxBDlz?`oXCwZU{;utgXpxUzwWPgXjqvEq9Rd|y-ltiEbrm06(F4Y6E?4LoK+1Zh
z)tB^MRsz>N$ge79&%Lyd0;h)3b0~@QS?i&%1V3WSxi&_Fq>!xQQ7+z#)y?PMTqIpO
zF0H8A-EI0MAd(Z!ChRY{W@1&7CLA=HDY?F0!g2RaD?eSq`-GL~=Omsv?(@CM_9C>k
z)Q$zVI$vr=GQcNIluk{UCrCkKTkrgh_9VealM^I;B6a-R-A+AiO(34Eo%M+<i=Ink
zrgsCt?5_3|n{H+mCZ$oi>T(C}Oyj|Wg6gE?$={4ip8OZb<C4e2|H`1`F_ixQ=BQut
z-_t93^grm9Jo+E3N**o$FP0>a{^W2;^6>i~EYC|G{>`l9;q;%pmOO;Q@n5h@9{hVG
z4p{#cW{CqRj1mX*5(m&LWd256;^2QHCUGDnaUdYE%qOw`&+tg>{|%SK{@-9r?ElFg
zw!|LhKN#JHAsf9&I9<9Wz8NvejCzD*NmX)%FiBNn2OH(7M3EDbh>V2wplBE9a?5Lr
zV76o!b*x8w>~K$Q&<pD(f@))rV8$}{I=*rlQiOk}mDvA6(kv*si<=rkCK}At#IfVe
zkqP(tqCn2^Qo^-d9L>hcKVzPRW+<U3g@4~$_me?(6$KZ6>vR4hyL=FF^oso>TKury
zu7??sK58Hrw#U?P!N5cUrTx5x+YK(sY*=^Ee7BAzIvi@Hq=6~*xDpU-WN=oqwwDt=
zOaAVK<VXCH?5<RRFc@h?^x@!4e_EVpw~AdomBqRqRr5^H!nI#@#ZbT(+dY|GxY&u9
zwSBRb=Ph0ZYzU%eIZRNw(+PZDl-&tD`2un9lVyU>*p~xJ6oH>pH2Hd39OPq-PWt@H
zwx)+T?6S2eNm`U|99CPh)=?)SP%oqDQ9r7fsBMpQzAwKy`Z$}`F|j!kx20WT#a4)l
zOpQ{&KV*k%Fh7OX{SLJ^nqINZRF@jHC5sw0Uq7eSj^Zb8`55$>;9w|U`BP8mn*gR5
ziXCaOqN&kzy&{H1*B_|RT{N_6wL{R7`Hqrr=Js?bf<`p8Enqo85`o(4Q$P)?CUUM%
zD><TVpHyweMXQ&X4&lA()H3(g;O*t=Ce4FOa(P72Sxa9R3lGCJ)zRczHv8huz$ec!
zT+9m*8ixOny_N|e(??p7n3wteSi|LHq8;Eu6N+wgHZSCC7|tep)fhkuLF(;#@^MF_
z!rK{}7qT}D7nZ$>3?RKl>Xmr%c1NSY+ZmeY&wNxkj$6Tabwd-_Ycn)2WNsMFEqj$2
zU}Lv8KICp77F<E67kI>Tr8+2KbhCG!o5dN}w35!?+)F98Mm|{M$hr9r(9?8mFvNP(
zlJAtPeHYI^|5Px+r%Uf^IgC4&YvRYCn0Ho)sY`cj*^k>dVtf_K=RNBuqey&~jb%0I
zmj^u?d|iPtO-6e%Pp4zOdn?bC&e*>wlN5+^ZN2KZ5g=sPWUkifTgggvlxv*~`=)f6
zxexvLBB@EL(|3@S;3!u$w(RCz*Godho3!P8YM%%)I_zko9Mhv(npc`aTzAHc*pUm&
zA@ZuHM)=t*cyDPZBu<=D?g%%@6^UrTu~+=go{m|I4H8?t{FUwpDwF`C*DVYheGXc$
z4y};G<eGj&e;rPYom$!SeX`qSAeunUBqBY<<3-@cunEX9pR4z}Oc$vGE>a|Q=gXJP
zx(`G@#^u5@iQanqG>2||Kn;u=<WS)^l%2`Sg~jFNvreUH=O*1zu;kt;Y<MP?-b4fN
zai`|KW$pj*E<iR5DPZLhX&B|vViSdr`!V+|Y5$Mj09kJ&e~L$$VH97BjeQcen(odC
z7(T#RZW?a?%xr*;E|Q_~qpTt7z9hak^!tEB&c*`eoQJ5pG`99gm3B<3_er&NXU+>J
zC40R{iZoW$NM&ZssrSiOb86BTHcIwzk>p;i;*m<;7)NjR_;~59CQ_HTp}j(&yqnNU
z`m6Z1rU;?Y*oqApR-0(?+a6BB=Zhk#?jF05L@LT1nLa(sQpRfjS2qqTp*P<IF~Pgx
z2-pw(WHCu@Q-%%2$m*K=RkFX&o}6@qVgsnA(HIOP&XC46%~mFwR5c1;J=cT{e8r(n
z{uY9eG8|J7(#-b`LlkL?$2)wg<~T7K5Hh5~IQV(AH($nqS>%YQ(~aq;#)sN3-qbu4
zq0@y(I!@VQ&Ye;|u7YCW&1Qg|!iknZK=(B=k(p5bR9d@jM~N>d1)#DoeMPPGi_d5C
zkbHs?*pI}orCU#4bqcV@1Xt{xP`3vkA$CM-?S!`@9-&P9e0h3mr8|r$+?bC(ExUIP
zBqo;(&t*8n^j5dyPwW5`a)6V+Fdd{b+fjcJtWG+m!)VMHvwXL1YA&CJTSX*p1e-2x
zo0L>R|B9vK*XUUuqvo6M?O}U|-)v!m4+Ngyws;kVGN?M#*3e+>6JrP+BL$NwpLL6@
z>}EJL7tlo?)g)nzoK4&xA*S5h2(QII2O+P*P9l&-NbiuVO2891g%OtF1eWSKRTYuZ
zM^Kc-IAa&+(POfna|*5x!0`=kSrsfKZft|=b98xmq`o{K8fB<}vXwSrMG<U`Su;Y|
zOzKfgF)+%+eA<<bLl&wRlpDQ@2m;L{B6XJyIKMplG^MeQ`idu*LUxx2e~7rgSx+pR
zg7%5Dj8Cz3vJo3rI}mtGl5xqFe>?z7N2Bx@G>m0nas80Ob>gdoj*j#!K7ld^dBZfw
zdQ!UBX04T8A5NMG4cx|Ef~6UHl!Hm?Vo2S`txVpNvrV*gGV~}$c#~>>?FG*;<d7`}
z1oz<Eb7B2}mW*xL8vG<Ru6r9o{2|Pv%;f;4J$o5GI*NT)Pz*T$sXp@OCQ3joS&0RS
zciS*nntAm_L?oe?neG8TcY_uwHS&HpP?g*SE+63x(W~5!JHC^qM{&CyZgvEwcaNwJ
zY$=d%t;2Ao*~hHh=o-G;_uLeKOXm0$I~RmVq<))qVsv}%%HYNO!E!DRydYXmJu8q#
zU#D1d6CncbDj4poK76(7!lJZAY8)3!wbX-a&Hpu(qQ~H}ZcNRGh&4=;;b~mQ2Y)G4
zli}64iw_)X<UOO$IPw?VxIGLAx&@f5ujee2gPylX@lt_o74CLrM9<p^GKis@1GXeG
z_o((zj<X?ke>#U1K)Wd1bsiUHcZjTDylZQPM~%MOexejW8!6nh9_MzH{|5o`+yOM3
zo<hX&?J6UL>tTGxX|W4{R(ufS`H(|szN(<N>5jA>n!)Uoc3Lzipw$(`I6367p07&W
zY<l@l54L*twk$1@4e-qw#Ha>MP^c2$m|jNc!G8UxgzAvP8gvD}Y45fkY255pV_G;J
z;Hy1|VQk2OibB=L+qAbAdK=B3i8p|+wjhSlAqPqdRqq?qUU)syyV<MAv~XcSi#3Qr
zX~@BZLRFXFbk<T2cX;+JKP{9S&|(f^P#AJBh9<mCXSVflQD@H{(?XHNVBr28RAMlH
zK_&(Rh3KEa6NAAMqxuUMF{;0C5TkPN`v*3DR5pGZVyV9bLmRS`f6cJNgv2{w_6qBK
zAm&mdv#wNXT-C0R4&&xZ7be-b03$60aFe0Xxu`sS_fg#Ng!m<;QFRzH)4(6ij7Q3J
zoc*TPaa{Bp!=<P<<S&M|of$rsDX6^`(+NQFLrWuzHbmNh+nw3rG|kUBPhXKW;xkLb
zy<?)hh^?SHHP)HsNb8x^c8d<>_DdIv1zl((Ob57;A(y&;e0uGH>RNG&@C0**<_@=m
zcg;UfR$$maA{zkqC-OyDfw@yShcm~!0?d=78FtUedX)JSwjeBr-p07YKH^=X%wtZy
zDmdR}2B=#wcAj~*wwFWR>pMRVTexq8jhZNKgpI5!-u^KRg$<i1cIC#^e^s<{?sY=<
zaYC23`UiSe=z1V54B!?oz3xnfFE0`$FQlnskT=%CUgVh_h=olZOx$JN#M_~+a5Ktm
zs7f$sF`R!*@1a7*EafHQiW2x5E!2kW4&D18Q-hXm??4%cDT*!I7OiwuB-iW3cfjca
zsdNcG*NfV>-{}IO^fJ~3RRl*&#@2=skXZga2#9q#%tna^{yag)FgbHXJ9%_8r?d!{
zv07~RvLtmX#M|y`YsA}IM%0nI_5GRmz(~;<jr<TW-KWbVHuyVVUh`?Pb$BM~01Ee?
z;6>TvMILyR@-lP_-J^a`IA=#GpZS!l>V5Ex9fyC<!wEW($1pnc|MtXS7eMJ1dd@(E
z?h{Sg)T6_DgX-32p}EOG_BQlh9`6>@@SMS)F!W9y?+Vj!ngK<WeeQq2%Rcuv80>TZ
z#1sbme}llDy|+$~iMT<de@6oWBkW*klc5x7g)fMwDfG`txO#DoDfMi610&ZFw%Sg;
zyXVEjFL@0R7U&+=^}<VdW8*<L3Sm;Ce!La_-I%-_F&^HZ66A|ijrz2eGAo1QjA|Z$
zhR@K~_20gc9pc<?-EZdJ3*QYs@{BPZ{nEZ!hb8d6L!c(}&HRbbH9``l`c{QuO^_J<
zVqFs6_o2@gPvNZz&O$0a*7<N(cuSCstdhZ?@T=iQq|G>7j<fsq<lh~=m338yoV)F@
zr>d@$W|6aHf;GI(Jk$so5#TZvM`Nmt*)6*^FGn-e^o%V5!MGgK9V8AzIwUd8kn=S-
zt)AjWW_u2m1^zGQ`=B?x%45xS!~4%~?3FK?Z-wqOg)s*Yb?Tj-GD#;8uY|4}4Oly{
z_6IKs+p2|Y(PHHu=dbI8^U=~|N9RS%(N&OQ`hI!^lalq28Ra0?BX)aw#tbxh3Wr-a
z9gyVYF;%OK-A|F^q-%kB>omH54G*@&c9c#8zWIb8`kfsq@MbsLQ-I)XEQ5gJ>~R|o
zrv72i1Lu^?N8fm<(8XaXKDdiJISOHp$SR;uQ896)@8i8U)_wcct#m{K$=F(HtDHA$
zfi(0tG^ggJA|WY(;U<F29=TCR1JC@%Ig)pdWr6H&CbR}B>T0v~qOX?M*EqJMh$pt6
zCB!BkS*wklu><gGuMs62QF?sR_)~7xnVB}EeA44Ww|vq|xGgYo+}VCUgU#j}@iHpH
z++Kx{EXwSE7Aw)Jqw!T##2+BjHq41|dljU$;6u+DYoJxfy0=IzOXk2D>toiHOZmrR
zy3jZB$Z;BI_W?7~n6{$JJUbpIoVUl$l3Cd#$U{O<DLelRAX)1f$8A-0Wx83C9UsHR
zc~_Dhi@BL@RrL_jN#WxCQwE!QMu{Ww$2~_*#d0v?4s`x<g2UPgqsBvd%(`Mz(k$+&
z8wg6s9?B3`6Tq)qNOsC4HL_Nh@HwJUGirGHrj^gNx9&&~!<mg&aLjsPs)ZX)SMR=z
zyQYV`aVf6K_f=2{F48w48>=iX=ER2aaCPsd@F47u6gO(~U8RpYuc*A}`YlIJ_DyVY
zq)TIiVTF^m*@0br+Lo_{j99};nVk07fuy`DTEV?K9qp&`?gn3c(}-4@KWd@*)hBY8
z&krFmA9}^t<Z*dfnHd4l<rYnz@?R(E_&ODbx#HI%iw-O@bken{aHEKZE4|f9h8H&Q
z+z>}LAknHOeGurV8R#MP7VgL1O1|AOdxT44hHFVD#fP3YUH?zAWQ1R!TVZy}EuYkf
zG4;B4=iIMac96TqK2YC@S~z6<+N`_b$l>>l6oalPV!7Q$6Q)^N(_0|cRdEx7o@b{+
z-Bm~zQl~>5<34{x=-0a9C^WWkcM5h#W_I+VD|oT%U?P|wZHVYZu5<*a7ius(D#EtV
zy)-wC>Uy|!J7yE2J>)f^*53NiLjZ4ib;b-AiKp!hb?OjWBi}0Vmp@dcvKDB);Y^Wu
z(@7{V!?A+Gd@=UJ{38qq@3I9!z;I#Hyu#aZCq*2F8}qfa*$Cy{e(YewT+)+HO~+7q
z&4EY5^+{>4Z${>fsZ>JZ{#S?k))HcUup2>`mQeWO<c<`x_hocr7%dS;9VU%`a79qk
z&z$44WnT|c{pB{3O7HFU6uS;eL+RIPspJ>gbRu@cdn4l*y20MFV$!WRaXxq%3yBeP
z;C{?;@LEO@ZP~ZTL}9c;@IcR{5Lc}~DNjZmu+$Q~;sO-i@kI@C2pkxfBd1#S`c2pq
zagiew#=Fz9g~osyWEVIv22B`w{nqJ;n8^`J<K3yfK%;>Tvhy7nlOd-v^tyQ~6~Rp^
zv<cpc?Lia84YF|?7?mKWT=crhl#1YrzR7r^TtFK&-nCH_7BvsDQ5YCCCZ}BRy2*fM
zmxRtTcS5<*1kHo26b42N$tiWbZf1HSa7l&Eu69D<(0KiVEMx|T4aq6yy>9TNBHRsx
zy5@FL@z4P7&^zP?hV;oPG`(&#q#}SzLQ@1gsUBzm$smyaz>xO;NJyap41z$~1B066
z<kMc)sXgJfq(U^{oqZ`Z41=IxXaY!1J_Sukh1VJg(P;1NYd3CaqM>Ng{eebMAaGy+
zS^@OBo{|brm9|Lf3IE^x>IwgwNvZIE!Mn+YvY?1&=4b&GhfrLC0J(hyF_HAAUsARs
zx#Q3|4OufPK!*S}b}_^*^+$lRZ!H1dz*h(ks8O9;w!r2*PF8TBwS|>M^a@nVt466T
zEMe!Q*DL=fvQp1zcteaD-R#<V#gJVg7;sbGejz%06^bt=?J9|jHKQyz($R*)Qfeln
zQD5d{uD8BX(tnW+4Sr6#1lO#{+q~E(2oC+I0HNo-C;M*vq5VSSp(L#(P{1Wi^!4Vn
zD~~2;?fA)yIkw;s#t+%NpdAWa_8F#9T{K66B3`*LbM2oNZm4vXn={F?2gI>yA~@(N
ziPF?iVpAvgy(hxVyUN%TQsQ+dGUvd~VmMmSkwAOTAooh`h`*?qld9AXFP#gjqe88@
zb<fL{*c&*YONN<$G-@Ii!-Y3Rb1PZz7T-0@^^_2@q!yM{IzI0yU1<AewQUNYc2gW(
zE2M|fBto%<^}#vYuQq~4gvM&d;vuNW$Ryh@HA3)DdmAsIOYQ)}(;I9r8@BLJ_rPQx
z^iAc5%u@CmK53Rp*Eyc9jBf9Wy$ST7_`GpnqM=r58dmL@Ak3^LFr4<g`&EM}@dl0(
zmGu+J7)v8+kCRYSDt=cu?UOLLA^VRk1u!l8uz_MMxXZ-cf^?~eh@!`Wx4Rd-G7RR;
z@$@EDv>?g(JGeLuCV=*wC6%-wA??AV=#k>>>IKgYgTXoO-lPWBAffKT#)pP3wtl?B
z`d+2m(2Rb4`!>}p(+QQyiz~s%I)Uz`HdR^oAG>N%D&tx12M!8%LpN(w4HAjtMwEaI
z8U>S_&>dSJyillzcdI*akQ)URsEoh8r=iL3HF8*^k`yXdoqb$@3Q`MGX{{xk>svnx
zLvqc&+N+H#EO&eGRAY};kFP1onZ3uW#-(>XK7}Nc|5i@ed$2SvHT3wbk^C*GNXG3w
z7#f!%di1DZWR+40uDW1yQy+z`r<M?^_*VfQh$y~5!zvvb&1ry$o4GOV6-0qR*GpsI
zjL%KcUl(q=CmoiZ$dA^~M?dTb2HAra5SRjd0|W({@bP$W2@<z?fm22#KNuha#EWfH
zji$5>HINsPg(X}(q~ETft9HRk>^{%=6V^d|7tvzyq+x)GK&2Qwx!utDCkA(lDQMC=
zF9TY2mx>mHWP?lK@Ja*Q|2)h0J8751kT!`%0FX3Pin^NkW1s1S=~$N)9Zpz|7BSdF
z<sZ@qY&_OwL5Gu*qooHnR_OxK;iUbyJjl`f0yY}!3Z}z>%51QaN|!$!&Rve?Z*b`|
zi3}aiWsi<Zmv`f|t!K`G8YQIk4RJ4>(`a{N;<|SutB+@ny&55;G?=)X&S|;3QDxn&
zkyXz#`#{YZQqn<eMrX&~osoD;e4yeCsr$oQv3Fl4uBtT(R(cX2C^<vII*8W)C1|f?
z4+$$ITBEa~@4m!XRcaKB@g%ZWFo&eA5gF4>%QXV_Jaz09{2*ymM22)A`0kmp6`4lB
z?>~ZGkhEYT13D0S_YB60R3pluN9KW?7i2S-aFH$$znfcSS)vhz*(2jXPBjO`v70M#
z*|ZUc*<;pTMiFvWNT^HaYuSy9@x!nYhS+1qUPcmfwnnH;=j+*xtMWttpMzR-zRKM=
ziA%bTB(@$?ZwO}Tz{=fj|M0j6QYMftDuNk0uynWE*rIkLj*o|iy@UZ|ii$v!&P}=-
z_-9bw19%{z1DOgY(4ccO>IPz53B(ZKDFJZY9bXGc4&jYUTv+S-x*O=d57saY)-XtT
z@2#QF?u;|yy{jpb-b}E%vXOOdbfc;;9k!^VFrBujsMx|qVB|Z^ClPp|gDB^JJuicE
zu_yzpDU3o%VBkCLB>}#kLvYewb~BK};pEk8#$n>sX~wq&fKh=YTflB!4UaU-Vw6RE
z8dQCR&oQ4fpfkMspYAo)Bs`a};Ctm6h(k*B;pQ*S!_%o>xWLEHF8eOiX=I%mLeN`c
zd~XzKIYNZbCug#<6l&k=Gz=Bl6IkeQn7j1a)kPGeEWp>^g_~njrEx3DYTnrDbn#k3
zAIv*8CL;+5-kr3q&LZ#k%qb#)TmR9SO#f95AI|01gq`>6;qYH8%U@N5eZX|yo5&Xr
zQ16e)iE9!q&0`h&xOa*X;!oYR+r&}&la=RqOARf=*R|IZ(v^As$0m64vkx7i6dCI7
z_;P6cMiLLZjjF85pYTDbIz+crJk8sTugo#dZuyPe9$2Jcs+$r@<Dd;bu{+&|0%tDp
z(Gf-GSyY(mze!!MGtI{hLpMxH3`q<~v`(B~WFCZCP=`YYT?co^MS2K%8n-MrvuGt;
zrBx*cvv_4d5@OPaq=-bRjtY=uTB1?MM#sC<gMR2Da%NiQR~`7}@~MiT!?`5FweunP
znKK&0UT2u+yWa?(?-`>QzA2ZpFv{95eau-C=hg_&StJ-~hNTCyUXA5*a{snW7=jP7
z%T42!bg#a|2tDQ9v-D{D!^+TWypw&W`tJ4f%9xzHRFOF`NZlMWt#>B##~nPUq_DU)
z!pE4z_|Y_(B5M>RhF67S5z}OR&5_Ca8~Qz7CRNr61)uXJ4U66__b$rGyny7oRdjEP
ztqU>_?!HH)>dU9pM<(m`?D~)@7Yoh5y*oA`OGmUan1Gf*wG^HYbQBcVA{-gKg6^g2
zy0~gv8@*6$g}rZn^HFJq*1Kxii7?rJQi^=3@-16^Q3-0*&qNBB0D0M>rK7ie^*JSC
zReQ%6&;HaByKmX+w`qCoHa?<u_}WS<FXOW)g(mCn*iJte6Qp+pnbe9nzfGw(*<W>m
zYLZa>B77F9&}40BK~OC&{ulZ6Wz5Xk&eyho1Wam4H4^Q`z8t%gakRD4%ZaB2E2n=*
zKgvLlSBBn~R1D@iW;|{>etU9$ti#jEB`zus*J;&`DMlxz#nc~P6W<zd(9W*lv05c#
z7XK2TpRC!ftVu00D$*RTEV!ecGri*-AK1<>4#ah{_Nq8XhdU8U-pN2~dbEu$j`k9f
zD(_W_n{?BkeEc50(u!B!6Q94#^R<llcbM8F0UL+pzm=R%T#GlrGi^N}X@4tXF^ZF~
zw({F3j{9&h!?NU;0Iu&#u!8*k1fpE^w=f2~*Fb&Wq^p4)PZBxi6rx@gXtXb|#6N%j
zU4LBo$8SUo^bTR;1BG`27NU^t%zJ>Lkpr?rfWxGHtG{gk7OWhcDKf>?*v-d>#4C)u
z$495<$IHk2z{g{ekNn3%`C|FPqWq$EG$(M|PD7~$n)mS!66ng0^e{%BB@7z8H&4Ek
zbIF-ozwIdJ7Pccv^vRNKFm#-MNZ+Xw-*}SGSN_&iURb@&fq9ybE#A4mm-z6FvUrkX
z`g9XTlKn*9EXG?@Uq^d?5h-`MA1S>#4M@l(9TIl<G*3AL?0WfQT+zt2KMmB=tz$9A
zrhex9BU7V1d$*&Acaw$~&Y$|}Xcv?-s`VcHMyIqT{LrssG4JxUCGRbVhp5?CjzchL
zlmwb>dOoTmEA>u|3inR^w9hrEB3w&)$L18P9(uQded{>=>6@?YJ-fgdc<3EKxaA$-
zH8BTeL&5aJWx;d}zt}cX&M1%6B})Y0HI6gus*PTm#E!0lC=cayjk1*oS3R^yci-oa
z34nrwwW00$sA1L$#DAYE@##M@lK&`c0OD6c*MPKLS2WE2*_c{pi<+gGmrS{T1n9q3
z&{WO>E<nvOKwtbnGjC!wm45;k+Na!)0Q!HKd8lCr=wrod%KrrZtNA+R&IZj4Y0BRK
z=l=sEeFL0>mN@|QsfINFQ!@aZYnpPmhps`<G#dcUHch!z1N2?~|1%jaKlRX&(1Bt{
zPcux3S*HK@&I+1l3&7dBDYq)<2lx+6B|zUfR@00LIGgmHt0QBhk}H;dqs=*%Nv+M%
zh)H$+$TS_Ac$2ZQ#}$jd(H0cTB=>hB?mL%g#>P*sl;rGCbah-&4xP<1xqmNzhoVj5
z3Ulb(mC5}fiCZ{y&dcP!hoY(D3jS~DppMhbp*37)DiCTv`G3pqGE?GEdv%;f4z2%^
zyc`<cWxB+nit0E}xm2d>6RI$Y!~Gw~=`vltPz7}y0EfmuN!Bu*FQM|2I9MDS|65}3
zzpu%T>2Uc)TmE7FC6R-(p|w)|UxV=+oDr=Rlh`}&YktSHyZjO=|6ukK%fXq^TA_};
z@xJDJOq<IuuKy7fh-r2Cg<Af;=p~v%{U0;uc5C@0_T&4Se@^~u5VrjN`b#7S=VfcT
zI`-}R8seC5F2DW^HvfA0XPSP!KxzC}8h*X}O(e_9|IIVoZYSak+Y@_aYw~Zba)-*h
zm=mg#Z;YMrFKpxg93(pVX59(<!nVrt{;!!mQY85jt6Zt_Hs*xrnB%Yck0R<9HV*cP
z*5pa7viFt0V@_O7zLs}VzOae0M~EbkVwJ^L-avm*JNdf%&%wjW>zI?^ldp`O<S%TP
z?BT7+gIHz%9sKW?#APFuS1~8hH^<hU|5wnNJ*+i(9jlD3@-pT`?WCo=llX-#h&@as
zX&I{xt&%(DNbV$dx8v;#lPdd0YtnbDHit^Cm?P7ZSjLWw|Bs+jB_QTV_axT3<NuL&
z9zad4>$?Y~H$yK1g7l)&iy*z%6apcH-h1ewgMxra??_b;Y)BIjrHg=40)*a?CIW_{
zA|PDcRo%L`=YP(*|2uQ%dFRP*J>U1fYh}h6VY0$XI^s4Jn3aheq<E@Taw=-IY(1*D
z@$C`U1KyHfUj>e2;shw3Tq~i7TD`p<wb;0R#MK~h_#}>p;>l_WdDLp-dK6dVn<K8c
zKSHvo)tdDv+r|~%!+)t>Z<-y~@{enA6Sz;J@Z`JYr10dQ%C!f^^>uOb^gcPs3#TX0
z$-_8(S?L(3-^(E#^LMp@arl{9!Z;k);osJKjKjZEy%>idmt8OBKUU8%=BKH&|FP()
zw0|irdaD0eHQSft(uU!OlV660X^Y`zeDazhq1RiOc9quQzwA&f^*ijaKVhi4+LH0f
zV}^uUZ(-O~8o_^Aqj<;i34`d>=C9)L(&FvHC-hZUXEHwN&ycw5EpWR^J>?INF5aGd
zLN9uCI^&>chS*tep4(OIDSuXUaogMzKhdkK--&&zuCintyqqDn*PEAf6}!%#wNiZi
zcOd>Y?wTRC)|;1b70cnz>MU-veBvv5l{w?!FR`KMRYb;t<_wXw-mHYHP!4}mXYoMc
z6KK^{lZ*rP8KO|VSqfL7HU1>tpNRwYW(iz{4)~LfKe3y80u{Xq&p0^#+gyK%jWZ6E
zX9)fD4q08vy7^x_6rW|Uuda&B%GhuFGA`=>(aH}R{w7YXiX6+>SDqp8(>q{wCF<s%
zb0`*Jum3exoFVYiJD_tV8oWGb^iIT_DOIn1)HP6npVr};GmzSb1GvYwFgq+&1M(Q+
zw!(=lc2oXTR7&+iev!&oYYkWuSCUX(uQ|#I;v?%^^|URhquQz)MKi`eK37cjig%R^
zO>MIZ+@Xf=ZG@WGKB2u_4K}|RKk+WpK;*S0=WE~&VYYK+ZsGLZWx>`Bfdt8;6`tsq
zhl^MAvSY+s=H(m336rbgz$G<ufsi_?H3GbQ9^*Ic#RujiiDiRU>~OSwxmqZDC_*}r
z>Q^%z<`r($r5>N*F0qjv-KQ2I(=JExxWflgoPjg-<(?~Yhki0MFPgMoHyjc~v0dwY
zL53!OG9q)V{gzkSG^vij8JV8IuKfYSEonKB5aESJk%Q_Xq0rL+^>%;}-t?X&zGc9$
zEnNWi(FyK76a2uv%}5siInI=N`D~GPtD<c9@vmka$_mxspp#yYw~NC0#n!Fe!cwog
zfP>z{--j$%EY7T=CjzR82|cr4tKnzPAJVp;4cc!JC;Oj-qw@!}?ZQv@&BciX0#afK
z^s;Af<B!ZAxc)2Q!M>?DkxW1eF@aY0>{a~X`2*W_;U9!1;zXnY$uR_K*|SUdL-Pm0
z?ZUGAKMGF=Boh-TWzRmx$IKu2v<nCA8;cX24%i~bSIXXfj!!ec=hKcGv^OS>_tPQr
zA3LZEzn!=s<+V+zs|BkIqo*5ivQZ4jPEQ$d{t?>K^{?8PhGXTXAe>U#+kiMN!@97)
zgqp*3IrenItJbFBopO^YoD$mG7IFV_=wxji-pP7=d!mH$wndL7rY^^iPWbP_Bu)vF
zZ3}YEfw~-ZI-yl-Xn1GH<ey=tIvrru3L4%VGTF~5X0nYW*96!7H$(q{Z^lEmk-D0|
zx=bTFfRiOCeAH|bz$pURR?yWz*QFZKA%6)?Cjqh|5K#qf4Rmy>VLH;z5;QmZ?}cd7
zNuaC{L=>p40gO&GOb6OofaZQa9EsI9H}@A)e=v6;_J6^Y(3hp<;eyhJPZsFTH=|I@
zpJEq3`qeXiO42CYxyp>Yq;+HWhN(OP$3KJV*<yvK(;>qR1RDFsILiC<iKUNQ5zzsX
zst!&)?}BUEx7lc;S^1%!kEQ%2q~)ZA{UsjrUT!<Fed6vr=1qak@VE~0k9bfPvv=m}
z#t%%V%+}35nQ)nko70-6nGle!yfMC7bDPs^)r5P<52W&#R+<iux>+;vD)%DOYx~Nq
z!C;n3E-z<DPY!FCB(L&HSG-`OC)b3tU{4zBVlCUrRlfLzCK1UrYvC>(-?O*u!*JF#
z3|%Y`yh0k~iIzzK(E)S@6f_No=%^Svpb%_08s*sEVgt}L45Fi8=zv790W`|dmPtU-
z0bs@tVhCv35Tb)HbkIPsS!k3CStcfm_M<a?E(Ta8qD3iz=>woC1Be#P&_)3vh13WG
zSYpwl0CajkXbKF`GBC7(A*2*E!jP6&z`qb%%@o<lhlRhTrh8zj{hz}-rrOmu^3CBJ
z)O24UpQ&cGjbw9pFE!nN8_!eI-Z53LwmH=t{tK%1F7FqwpZZk)K%Vdk|69_?yYWX?
zi_ia8!oA{k!cX<<^7v2qk4Pi=<M*!?Q!M|xVZ%D%rTRDW__6$lv60;I`%A^-%X|MA
zKH_>C_~{P0eD;&`grqlD6WXudKV1ILhp(PS9Og0|8w*qQKN@3oL@&#~X+61&*CYO)
zwTOrw7RK+}6bnN{#NXS&KW+GHdrrh;F2i?>J|{vj_rGB*^r;bo|6P-1p-YYUw{7Wv
zGD9YpZY|=!XQa8bYZ3pdEkuyA(EeXEl3dz@h;QuRFUdC>{>{Uk2oe_B|CBMY(CkF~
zJI0tx(;e|Yw`UQIEHpp1$dgg*TQV!*wq#N-4sBQnwS4!dlwH%udaG#i*|#KD!mY1M
zbv4>BmuUG4jJG+bF?Ln%WEY+g=ly84hSx<Az<i|YOL+WsmNdqe%AL%@6Jo~;E_j{s
z0nGBMzV_p7+G&hal{@K$Cq#KaTCV-R;5Xi;oW?j*xszOYLYViX#qk0~fJ>;Vp8EI<
zB#r)D<@QD)ZUXOa(;6O6e1LPls&3Ty^piAtuFCC|Lfq@TyA5l2+{X*@s=CYL)3Isv
zmnydx3UOn2cb~f8aq9&*o2%;bj8DHwqbIN2J}kt&%Del-1&^yY!0AX;mvDS~KaC#0
za(k~3H<EX^{&+zzpaKjr1R5fM2o0cy1<*nWD3l0HLW9PDph4hwR>~kor3n3Uiwo$a
z{{kjjTmUBBhZq$g^#2oh3Ya7affgXt6D>{w)9gR{9{~kAi5~*3L#Sgd{tn9#>SzlJ
zU=l9``i~fmP#3ZwM<;PZpg)5E3vyr*Cj=UXQ2zpv7G&t8vk+(|Lj7w5Cb2=Fi3oL|
z1=-)C=GWU+5NhQXr066$2=wm|m?R5<&LY$jElB?fNzh3bA<$if8rFgYm?Q;(Vi9WS
zFAzln+>`<jVc}}%@1hWj7`-V09_oav{WLbi)c`1B;HDUO=r`PU`zH8e?JsBsKsf@j
z)!@NVxET`VfW}t-90E}eKx{d95Dho`E}E93?9teG@E|Yz8w6sng9q8*rim!~zeg;}
z4voDA9+ZNc{({lqK_R#)8f6E>{(=MF2EVRd1rHLzO@&alXzWiS0A&lrMt}!#;HF<7
z5@mzNUIq^`z)gR_Fz}!Q98r$4Mq~5-7Ol|O<A*1q;0QFz3W&`F4<i3W4LCvwWr@b7
zg9pDx0Ll`GO$84sz!6^{5@mtj;{5E`Wbhyij`$M&Q9v9a5G5LF2vpJd6V(%OPJt)|
zq0j=Ae-SA_l)O-Axr#a(=L;kUQF20|VJhkXoWH|F6?GsE8Hkb%3jJ4bRz)olhZIC9
z3w3_^*`a?1U!Zpw+ysCM24WY$1K+`U@IWRUf<z&JSPL*Z5e@-<gCSt_3LIRHGC^bi
z7QIc-%^_gGiZQtSM+j^V0t04^!HM1`|0DGEb%)ppad;agR>!<PnCjuzH1c0a-4Zi1
z$fPju<E9&7ptHXYbRj>}pVc%5E3ADXV4jrsZnls(K1QRW^Mwhd(W`3q!d%Fw;nIpO
z2lb5id&wsZ(bUi6%Bs3lb&Om{<nXOFMhld!gK7NBH*>~k6_Q661xFBf_{>h9!y8D|
zJzW@07j}Ad?4q?9A*wk^yX7;nAK|oaThxY(;?j6*-P=+Nm&DbeDI~;IuAAg!X7Y)c
z?<M97+BGAapae-FgAJfq^n!xg05}Xl0yFs{QXK%#0tjI6BoGlY&;TlgJ~+OYkd<=0
zdR|)s%V3;onYMNUd=_!`(U4NIru=JRu_f6#%o)|mIXj{>@8ni;Mt|>)RwkVEumgp^
zj#5w=05=0pz~Gc12Bg0M6p7yXGcvmPz4SX9e~-Eq#jb(tH4Yg)rm<n#0J*EdtCv7K
zucS=(R2X5R8=^zFF>~pPF8JZ8nN=!hZ~Jqp?2S{<2BavOIw1WF49d~n3d#duHUMjZ
z@|r;t$T{&BI06MGG8HJT8OVdQ6X^;RkHNbx9&C@ED)-`r{R0e@d+@?2;5cgrp&*k)
zsse>C0eCObt-yQ@()2A@>+>4LgG$in%6|Y+Xs&XdA|qE&K7b=kr>LYoIxOw%RmP`M
zq8&;;V+u6)X~wrWsFi)s>KSM9`gxRhj|_Z)(t5@_yuK~vFX#t;grd5<MiijWr}-Wj
z#)FOkGGSUphU>pUpKYBfKZF7uh5cv9z*^P=M8h<S3|&DpKL-)8<EA<UKSU4xeK6q%
z$D^0A!F9jFTdOaR{)m4F?P=>Ec>rmcS`qYDP$`1Cg3bU=hJ7F4+5F&M^aree9sEb&
zQ)kQ%ra*UKk3pdN%cDPHey|>T1nW@;`xfehsKXSB3|v9xfS-bJ7!OvrX}TmsplZD^
zzO+e@XTv$+he4pxPi^~k&_U-{(_9OCOY;RKH>?vhn<h)r1**OZir#)N{mZuBf*r_L
z&A+A;rALB<8-WR`P2(lU_YJNW{uYGE{x$o{rayvV+AmuFNPnO8O>hAEd=B~zuLQ-W
z(UMewO4mZY(wQFxQa@bzOK-g(i9|%H#v#pig4f3a%hZJzeGr|M7FpDmiaFeJD0j%l
zr1D@Wfa(R7a5hj%l^Nb>bg~@v^YcfGX8-o83*t-V1?@Mq6HJ?iOH%kreglDu^{-dH
z7leH785BrbFOM&f=e1wcjyG*G{82CqkLDe?=pHIgqq^@96Q3@gIF6-NKuRf2nh6b@
z2njWrNUkhcSqlm^F-cA?*j)<<fE`;Xd?I<P0K0|?g_|Uc6m)*{JhnC8P~(ZuN52A9
zudzuoRRMYp845E=1{V;msf9vKV7e4$M@EE$`$>`I^#xqKPHU=!3VQ|kya8*f6!0S`
z;lO?pe)-<q38ftG13)wB#_5~4lZA=s@@?MB-Z}+s_Uu#$f~6Z-8HDMM9~yLkrTZxo
z_sj7^_m?AyS|^p`jhhULEqV*i@cOO&a!@iLkmOqay+DZSM=Rgyod<n?$al7`DPI@*
z-ub?}HQu=KXRh`4-rKOR-WEkcD6jgONj$U(T+%O)xL*EsfcfFdU$!Q$-}=FjFSj-h
zlu!y_*TX1Ee}}qIPW4rjIOrcM-w6Qd<Bs2QP$RkoAb@oZ)2lP*G+KqkeH&a?_+zDB
z=*QcB?c;y?*8zW-czpl&FN%M=p74``pKE;ZbE?a4;>rJACvV05jjq3SP544*{%HHX
z{m)lAH-U|x6TjAzxS!N@IsuE;*}K&F*V|v_a=zW4?3HHDs@XHqCpl-hF{#g?&zuy!
z*T*RD%hO(!z4!>{<{LizF=XC){9knDi03<^(-m0%Lu&%RiN8;;=`X5bZ!G+t>IHvq
z`~8*Qzbfu06?y6}=lScIe@#BEl<<C64kcg8uEee=c=`2DYU`fB%byefZtV4+)Rm3+
zn%<w&d(PwUJp7D8ieK~mtlphozwys<y>Tp8;>Mp<a{k$$6#a97zp7o}JK|s6zy6bo
zVWD{Rwe%kSK-W<ve<$CPKSgW*`g`(weXQlL^xEI`^-pMJeP#VgTEkE3@%d1>pA-$Q
z0Q)au6Zi-5%MQl=q^=<JuK%Xk_^-87vh<bqI@XteD8{BsUx@jYc<Wd|fwzZJ!Dn(R
zwGx}hHJUac2BZ3+iIYe^B(q2K9+IIT*y%_Ye|m2O|K;8;rLAkj`gioY;cGcII6lUo
z$h4s(JV*V$Om!l+C~{+xLM|t*<}N&e)*SmGT&BtEG1^%b@>sJd_3qj^0=L~$1af=q
zhKQ1d&#L`r%}cs|_(|CxU(YwPZTPP0KORZ{lV+rUk^EBu=I<&<;9CiZ#{8rrU+UfX
zNv#px{z(<{hu0z~3D>4{;#mE{Pu6W#E8Gm`t5RUu9LN-!*9aOm@%R(^G!la3pWENi
zel&G6{f?;M+y+rX=C3bb=KPC)F8`hv8REA`eyzrkgTt?NXv-!3jZSKNbj@qNw32@1
z`=tpL1reL5QKdD{iTw#DV=moXx<e}XX@ejkP`-URJND6~!uezSCe8eH>8o`5#(v<}
z+N1gP`a%x=&`~j$@He8jjU4($mQe)iUkksNoak5K6aA)>x%k50h=mJ(=o{I#6R3VI
zyib3O_<a-}`Im!ig^zV+Cld3GU~L4-Ukh)Ih3FgM-1(*b^N8QY6!Fa<OeE~eAA=ML
zei5G1nr|KDsiO`|RGweU$;{vX6`h%#6AB_SQ3I!;e}^gIu6Hj|3{>wv-m{=g;8R%}
z*P}G|%;-@ZrW8rUnN<mbnt-T&1DJd;wV=m_LIO-4W1p;DVOlU;O3ionH~3;DI_#@0
z$1942wyMJ4h^FP&tNqjQRKM9GtSa%_Tl#YoVenrz$vmE`^EirP5_f_*=X-XvIA?lP
z6BH(TEDiaCm;fi5Rdx(M9zVN)saavi0L3;?N-2okP&fq(#i%EnR6q*`3U`j-_~-Yt
zC5{5!>v<Hlp&T8Xzr*Vr*B|}1B3q>Mjoh}u<G5yPCMP_WUX4*Aq)c>lH=TC5mkKJb
zQE!j19W*j<FDu|ZEpPDlwAH{^kJfq?&Ot-bx=&sW3N>X`T4s*c#+XHIJyB4Y?$u48
ze1g^1V{>M5;N$4W$)$p<J-lzx#C|hn6$X?UH4?CZHM(iOAfW80MM<C%O?xJwX)2q2
zw_fdqpxz<U<MVbGww_r_VoggS<c|lfPnh8Xd=+3(Qn<p$`>l$`2a?Bea(wF2R8>w4
zOWnvel)aM}%1<`1b)1IUv6eTDJ_!AMkpG~nG@S9cMfI|c%Ci&0668iSk5o3h*qk+1
z4U~_2FWx$5aD3tyLT;SQSA--v&9X<B5l>#08u?bp?v!mH3SMD8Z<8Ko8?ZW_%^z(q
zi}Q9_%k%gmD>-ni?>o|HzM{;L<ACXZzHEZTiQWYlbtlcKTSI0;dBb89Y@3(IadNF{
zC|?G?RB<|9nOuwi9Od7P&X+ha`+P~t!g|r?qB*xZrp%yM4JBgflK>8QQ`8P>GjeJ^
zlNSwTScU)w_V8h|Ts8xijraDCN#wgfZ?Gz{#;G`An?OCp5Mdo6E0W#*-pWEVVesYD
z{7mPw5WFd#u-7MS<48!Z@ZiioT(G{obnd0*rQr;VevzGvnv?A~LB~UEb|L6!-q-o+
zj+M18WVI9Bg&e&h9BFy~v&bTUnWN$QJs!8Xe+Sq(|J@0{TtJVucz`%B>|QJmfFZV*
zySAs{9Uy!Y;`Th8sfbjHXd5LlA~wz!f6cdg{MtF*3X#dpE{;>ZCE{;o_QD5Qz~Y+J
zHrp!HzrURr790udTySxav5Gh%y}{5)LlKp&+0~tF0JmDFR}E5-SPOd&>S<;_X>;*R
zcB?V9>+SxNfF3L?EKsUK$^u-oBjvfE`9kxONzG6oHE2^-a|DSl#mUvG$&`32lXpD^
zQFiD#e7;r*;xrn>KB7KobzjYrQ_WiU$N@|j{8~`6jWyr!B7{OcbP0#|xX-$?&Os0*
zk-~5KOvg>dnx0+OdPXKpWYkz6elTYWFG_K<o1vTPFdpK+q-(03t75A4Nhw%Alu5O@
zurpB8#^@T91u{#Y`UyzaPviytfZC9m>+=pY%Lgz-?#aAM<N?!t!U+@=kvX%DBFL%{
zGcYB=5`IXD7~$169_6qq%;c~L{BWD}usN*pX{wEL@8s=44l3L2=CHR?FBf>UK!(%%
z0EVmxvGMt{UCxuO+^lVWk<H#>#>9~4EN?tCvf{)Z&GUD;<)9~gR9h_)2{=R)YQ&0g
zh#={pbLdf_d$X_uql=)=*I*rOavN-mP7t#11k-^R(R4ya8cOLPVRWmI43WvO!4TTP
zf+Yy?-u!ViRBI7%V2NHtucKf0OTMT#I6nU5!%oW%J<E00mV={@yDv8JsDcgodgrz8
z>zWlEGVMe8LqrGU3FO^`p&XP*^?)tNgh1m4q8(kIn4F?1tTMZaHy)sjugLULoU(F|
zmg;b`6(<}euHrmys0w20Uk4;&4{)sYgrc!YI0U;^c<SStw8n7JU`u!xE^}Z-yI*OP
z7`#q;)H~fu!qlp?GlzLHkLiNE?Wu~xOw~kRkN2kUJ(%;u4>RvPAG5yZoiEkqy2X6^
z-$W7S;xX&1-uXmruK#(A+|H+)an*7ulDZZCkGPpnW#kIeDME6D_5VlEB~#}Xk|U=-
z-^%E}i<$lTo<=UCIyaFV{~;t{_>YhL%k?qz=Xx61jOtuQa{L`K=!7FVX!>)NjBNgM
z2sW~T>4YIU0R6fDKVd$S!=*pxrjd1~u2La>Z@{ZG0^YrRRpQEh7ktU_ga5xHw!J)6
z;^ch?d`b901%7wHt098_NkkT~KZMV=cc_Y=ytjf+2;Zx~Co9CySN&&GANt;|BUO?@
z{Qt7es1g<8|L@s}Li|wG|9v}2IsO8H7bfz4P}N4`BQ}l2FhI)kXTq#Xv-MaLdqSe1
zU2(%b3*x2h=|zz6c2HFyt#PhtztCW5gaJ6awRWgkRn){-b<ad=DA5>}wqy(~Mi?8t
z3pRFpx>^4MGw4)kaQvjD$@0?^_~Vfmw9se<!er&oy-c0jok2%gw{9OZ9mLrDJ=SCI
zo-GL2OqTCym7&SSyh=dUW{!&i3RlnONS=9xqhK6N#GxS{&D(jglTCy2`1f0iXc{7+
zPU+5b(LzLAo#&%zCPQ+ZC*2R+VXrb*>o#e~X^1!Yjkb?FA*0)P<kh&XsB<cK<4&}V
z91C}kPu1o!(MOx^S*!>!pkNA0Gsql}qqIOSE6~^Z+9->d7#jr)6xKd&x(EhV)%JPC
zM;L%|wh(F1+XK#&G}vebCX_Xe7C+nr+B$HPG8q}ye2T%cNYU6JVHiClfTLjKkQr*D
z1vh6m(inV5S&toJaHY|xH}^MM8MLLWL*AdFdWEwPVQ(AzVn$;93I&nlozu*C3u*rk
z8#ObYP1^sKIWwPJNc$<f0$3>TZ4h||%6NSl@J`aKaCbL?=_1Hh^+f@sdsY$803W0Z
zpvCzOpk#_J<`3`UBvJPdH-v&Nrf`p+;=-h!7Bg-R_94n+Wdtd)?1xn$wk*`?$2HR#
z7Hrr(Ff;;o^h}y)`d9bQf(DaqUy0V62%A6kJ(Z}27i@gQY-v$;rErz{+{~vAojlDV
zx5XWCQ!a~9w)y+fXI9b=Kn?rZWo6dpvZUHckPj^7HLnVhj&q#ij?d`8rT1@^8rcm`
zx1or2h~K;BoGq7;toumwc=&l3xZiCyFIhev*@d&<yXaq0o|me~t(~J8YZ0npzhJ%C
zP4qE-$s@D-e4rT%p9vG2->2@Y?_y#;8J-<KZ}bQpUIwfdzKe?STj6OeYcgYG81YDa
zpFZeH2qmW-U^}xs%jvA{Lu!CkarC1HJ-qmKgjysYOp@4JM3oUq#z<<I+)o_bQ77oh
z*ub{c^5KJ`PuiJ&k*OQAy2a3sOc9s6<$XeQa+OZnKx}BF8TCHqE@;08w4ECEe4X^l
zA;=U)8~B#FaBz?kFY3KKpBbZfO>dh*3Q;T0$-4_>kqMadF&Mt(m?SUKfpa!-tZdWG
zv=YIxc+%rTI+N3%1j<^KH;1TS;{$8S77y8^xOV-ny)bE<jKXk5(<lpf!f;Jx70YP+
zRULQX<|}WiIc)>@M;j-Z?G%sbT#ruHxzH%+ma0md`qnPLNNvG(TiKBM*$)pC+T0xI
z)4S-H&r9U6Yn`j-VQ{n-iy=YsT7~E<N`g64l&Ku36luhDZwb2SVS<J%$Kc3*-bqE6
z#JgIO3M^a4?EaZBXX1idH;tWP<pDkjle@7>nZhW3(N^Kj>J61hj{BRiJCr(sROe&v
zqEZJWGnv6r@+O;_ZZ4YyR1UQWNlrAtVgN^B*d>&;O9Qqj^!S4ft*ygkh2k)Vnx`4p
zaLQR<Q9#bz$O3X-4+&b7bb&V+o%PI8q-5?XX)fi-pwqut{Y-QNdZ(P&Ta!6Liv-3A
z<fLR=nYhPb5XI|%t4-?m#2xb_dMn7dhh4aL4!m0k8%Y+c2kRGq(Md);P5K6g5h=g_
z7HNWUc$PA&cY{iNlSj(v$bxMB0qxt=^wT<S`elmQw}s~)qe-&>`XTrVH>^((D%@7I
zksT+j+Bkk>9vM<!nPz^M`Roq&2uUi6GC764Qh{QOVQs2~Y4E}8ng_I76`apU-stqd
zf4~J^5W>lnHb5h8<ASc)a5_f~3G3gtfdE{@rp6n#mRwQ<7ZKrP1`Zg)zQ=aKYVed<
zW1~vSX)i?&8}Dr2h|rCc#EY8>?}j;D^JsL1aK$TPDqKC*d~;BIa>1c}Euv-jvXU&q
zieB!XYCsPpU!tpa^Hd=pWlHM2<lu4V5%%UN8M*s@<OA%^H6DKqQx~qvV8WO<4Lyri
zv!oij$IjW1z0)UEAFjXp7UKQZd2;Q8Rgj{)#|5Wyx#=FvAsdVD)#uNBxt^=c7?9_`
zTb3F{<D%+#Vht)|m2yQTL+wT+w)`T_wKdgw2e*W*#}{sj!34>4OpI>$YPS`iTg!L@
z8a37!4`DOgRE+P)Dq}A{L!6`>Z)rHc5`1a&4b6bLC0Iv?7WadrJ^hW?DmnVCyh($h
z%S+bN@uEw`ledW)8ZLU93%H1v<+%@eg@I08_A<nXy;7lKz~GvDD$+hw=_YT1dFqar
z`STu9HVjX-qxo`FAxxszLf>^i+AQEO%q+AaSA==y%-<Vr4Zjp4F6c#y@Gx?(Xqpu)
z?w~3;kTp|Csd-3<GO|M3OT&bXsUAvfw7k$eB0MU7@{r_w;`vXNHx#7C)s>XJsH#XR
z;AYR;SM~Pw{ntLF;hRUgr&XzorMfolb4>+u?rFWD_Jmvoh9IokL$jSiCflu_bd2E1
zKA_(Ka;JAiJYl((_cGS6?(SXD9#MY>cUo?sozh^klOaRcOWG^q`yWM2F;%Nn)}<2J
zI6Sn_@>@q#J8^kk_NJRlJ;CqrgXgGn?kv_dfOSt<N?yOFFtsURbL(zxE)BbmF9+8^
z+uhp2dA`;iy-M4dRhyQzahLl#S_VBJm7OC#&x{K+Hy*l3oDS=+8`a~w$`hyDAty~X
zcRz&u-2Od!p9jxH+?lv#UI?jVnqycjvsPs=95NB3aP4qA^KEA6xcMdhSvL?xc~EqR
zvR1j-=3%FBfE?ydkHsA^Tgg;c{w>z&JCgE=r^J#n<gchu7imTu<a*p*s61o)mga`l
zwsF@f8Gcqf?HQqAS_f8`=kWEr_nK0r5=tv`o6HZJ^Rw@~cg*(p#qvBza0k*F?(~7w
z^I8RFd&HauhHc+JxQ6){$s_cUQDAF^GOT{*K%Dq8%Iz%uRy(A`RdFm@s6X5IN;#<T
zr9Q`D?a8;r%RaDj5>x6r=Eoh%{;v0Vcv&;k0Y*V@V_)L>IvaTvQ8C)!ltkBC@ARIT
zU)pbqcau9gzwS-%H4Nl?7OmaTy)@x4r0kU!=j+{VDe!#j=v};=Z*NgcP3|7dnxph(
zyscd<v8lf!FXO{c_zS)X#tcj29uqG&EoU1BjGS*#_9Y-?x|qF$$%fs;+|H6;hcnvI
z(fG+$dRgB+BfNdR?-t#s50I2D_3rNK%`1!#jQrOds=S_>(+6JI>~k@UyI1;FN$Ukg
z1T#6qf%1amT>8jh&4}VGo9u;cb&iZauno<no+_Fe^J~6-ZOw1*Hwulsvep^g#q`?q
zDrUXqd-}Qn=i$9nrAvh`uVazA&S~8l51tA;wsmgUR62We3;CU`-rTb7Za5H54ykZ;
zTEP&X7lY{%N+{!SY78|^B%kkvlA7eyu3lg$qAMHIt$iwVCDl%DohGi9j$gfE%iJbA
zyoK2KrJJ|UN6Tn>Dz$+Dg=@t&p<M0?$#=(9?w6A%ymB_$@U}#{yl;OO;lUcE)7>Ib
z5##t^&p*}DdG8i?M!3hDDwf`Bmni*~8KyT%g;y}cv`UL^3YzN|gb{*o_c+s!^wMLw
zXJ-eAbL1nWV4hFq7HkHTjmr#&D3)xBPrrsu(s5l1L$CHwc+?+8^bpQC5}x#reotqP
z!`M}35Ly>T6uo^X@66!kg7hA_WY-ABXi+?|$}tu>%LG<5hi~_L-W1COKGOjv(7Rmw
zxo3@|f=_3MhaTJX4Y_lwTV&Ck+HNKteBa_!$3d)CW#6pRk0~2dPCRjq5;<!w0A!7S
z=ovd|lpr70H+3YQKj*9NSXikK_*D6%L1N458BQ}q6EVYxa^9aTA&O9AH*ZrpV5G56
z8aiOQ;jj?2o^9`SlBd0!f)2X$xR}WBt%90*opQ_R)?(FeF$AV-I+tTC32(7jQgdwJ
zem&Zl^(EWM*OIBee%;l>#iye$s?ol-=pdF%mGBkzm3%IcOuB1a`Kr$9&@{qcBtF9F
zhFsiB0lGr%Re9An+_z(aB#q!TM?#Ew@0-mR%X-x1)R9<FK=W!TrA(y^{w6@%khsK(
z-BbnLO@L;B4qXEY-OQh*PD3U~Ig=8cBUbBb6BC#8)rab8<_ufut(>oh-lmrwV}45I
zjd9e)Q@R9wFGiQmXsojZqf{8(+`%}*;cCx3cIgzRS4x?HB|}pt&ow!HG>F0qHa)2!
z!%b$ax;ajx0tFsOb$Uz9j)(Rh;T2G@L1=7N^L4HPWssUdgc=dN85es1=<3gcTt?_<
zp!8>1kSf?5O67h_h@P34`AWbAR-6XsG@!WAdE>SR^kwGZ2@USI1g(zceqrE_*2A>2
zqZ^rWcEB?a^+CPHdh@Qf{2Ik^4IIf=QaI8~lJDgzC*%6&Z>V}p;MXt9lQXYo@N_<9
ziAY)haIO)PR}#17OvKF+ReK_XSGSsznFnQ*+DKJz&hva960)!w#53AP<5rlUzs+F2
zY~P<v%V=+q%Q+U#My!)<8gp^-V5X<gU!%@|am710b{3~I8<JZG;`W`M77t=avMsP-
z+3neb*es8Ul}(gwQPxe?<C48Bh3t%+pX}_VZTU>Oc3F~(Dq(&pm&4LaY}9s6EcFUF
zg^;LshUq@{-OI9}L|s!R>F*EVU?C#ulNtM1#X!(zN_Dz6ruj^8D~D4J{nK|{RIg4y
zVP||kgw8i{d3yJiUY@fz21Gm|IoG#DFZ<NWN6aphuU{K%2+}3Px|He&gHy!OS0IK)
z2t>4&@XZvT5mKd%VH~{&YeItE!OjD`ska$xS2eMo7RqgY^JjQ_@!jf$tj-zKWNj)7
z`J!3MyPRk0U@!?!{+)`C>nC|X7_rp#vO9UQiDf*Vy>j>-k5xXSs##IV_|=svKVV!9
zfQF&5y4rxotVYFvrt`ht)h>`C>yjVR3!{v>g0g8tdIsl(H!EI08wsGnVI5>9VO44N
zu?h?Xw*^z_1V0DJfXl2P6#lMF?*M$@7JT1}q<ABl$+#<C7<#5@a(y_;n>K2*Sucrx
zY1CBO1ziM3;hoH!Q_S}=rLCVxE%k5mx-}AJKA`9Bin%0q`P9p)1FdA+Fq!Mu{g+<}
z4d<{Zv1E5CTcSlZ@+@ak{3Qe?b2=ei2^OB#OJXZ|W4+Y=beuUQor;|r8oFI67E__u
zPch6n%qqOix-gJ<B1z=QQ10pB4&G1_q6MO8VmG2CQX!&d;w`eL#5zQ&MAuH$%~{M_
zyaKGSz2e+v+sfJEeXp_2i%s3i*|gc5+%~}0Ve#JUZ1QgL?s9GwyieU{{+P4rvP%hQ
zyYOs23J{1s99U<X3Dh}Kdc`ymID53R#kZM7^2nIU?3o^l4hM~;r1JcDd?4*Vk0Z6&
zPt9>Y^KAXeXCM7(=Q|(Cj_a!$1>_I_5AG136~Me0Q&;x(6Jt&7W^~=UAa-l)rIL(~
z6JuvbzmEtD=7X__a<8w(>6{Ke3o8nm8sl!IJKp@%2IC*0m44oMqrwW;JsRl@Cb|^B
zK0C(V!lNV2i5}y0r6Wlytu8wf44}-$W<|wVPaJxi84nc^CozFcSSG^AG$X!$F*IdW
z<$O^2*$B31_DOCXHavD-!OojPZQJ*Z9-H}@0nLl`>m0!Hk)ZbD|1(Fzv;~n?nWtv#
z%^1xrr>$r1>M-jx>ul)h=p^V|)|u7W(;YdcV4XP~79A0tMIAdGRb4k7LY+1}U7bbU
zIlX*6d7U$Q2nX+sM?niM+Xd!f?%11<%9(06sX|e1)7zH7OSqU6BSUkIWsITROu9b8
z#kyR=kw?r>Y-&?u)J8={A*$llwisO_LP~?ohW8Tkn&oU2_wa+M94!gU1+mg}%bpZf
zI=jhM%~3lxDWQDDo+|frUeocA_td-nvh%vqL3rq-N-Hu6RBTf3Hg0<1RHufK_NoPq
zJ(;w^^_DdV&UgnvS}I8>X(cv%OmUr>b69y8Xn1$3NCTu{s<mKqU5e;x#R3FA#E7)%
z4n;&Gyb&T(7OIF5sg}18V`?RcT6GK3#oK}|h%SJRA>E!1eoRW~>ghql@L`A{!>}ry
zclrojV7esTTzUtca(X`kiVQy;>>?Fg#W7W5gO1+jGksx06eoIa5}?g2Y>|{Sm^_+h
zK5nQ&6^z=fV4h?CWSwRTcThQxD#fih1)fWjoA6Xw4MdTZ?sy1!UQOFD=}}h-Wjl%7
z78Xse+gcFWfW|!wy>>gaTMk2}m1!HHelrwF%=>=x1V#g=XvTWHS#>nTg$U<Jk$med
zEsqIC?P6fj35x?u>8%dh?g?hq;XpRR*=5{IA{%M#aGwc`nqB}N0qTt~MRHhL)5N5T
zq53Kc5Q;~Xxz-|(oDZ#^c&rkjVm_{X&G;I4aZzPjJuH*~*X30CTio;DvNUkoClf0*
zrQof=Fq8L~!q+uBVVY3gq2M9yAyKFj)B@Tv6kx=**@$ZOH}Jn0<lw*RKj2T~e<Fa+
ze+9+hAA)*@iuWf&*`ZVdXi&)>dfrYR6kb{c1I`wil_tsV7_eE5%M!05MWGXwNfYAJ
z`4Jo{@ma3XJYAOOVa&8doZiQeAMm7IL(rg=1zFi$Qk#`k&M106@$Q|2Psu7XQ1T8L
z+K&b*VEcrI46>e#QCAB|Q6>%+8YP><ZYxfE$ug7<C24{sQ$1i0l=ghWm}fh2od+}x
zw2d{C0lpY!V2`3Z6}!Q+RFhy$jQ<huknN;Go+k|*vNPNx**TRHR-(A!bDwc^W_JSF
zn&gp}O1FAV$e2Z8)w`TYXi`y|$_2AJCa!qf8_UV0fBH6+OKQ(pow9;oDQhO0?Hr)W
zqadZh$Z6Dvq<+ymfkCK1h*zkTKP(e_Pq+x8PVFy|c|P%>aKG@C!FD5r*&79t#dd@c
zg3IsWZlnSrdJWxd$>&~6JEXKgVWels)b>EwP(Ra>%nIh{kYZ4JcY1Q<8Xl%E7MbKe
zK0!Gp+@3V({h-l)?4HV)U#&37nUojR9j>%>BUO|`sWt`&q0g@)8D|;2<3$X#c0O!7
zUfQyFbjdX%c-1gH{GfAyarb1@4XJ)}K{uTHDKq8@?!a4+3G)N@uu%_bgAf>l!ZQ!?
zU@?akur($NMx#*fQA%Atk}P15VZ6jZn1$*9i$Pz&Fv>*%i3G`{Z5fznJA%FrC!~au
zpBkKkNvQ}0Ws(4o`Z=iXLlfb6iqE{8=`6_0+mo!pEznUj9Sw9yB5C3}rTid|A%RJ`
z64GBty1aw(C4?3lVj`v9Y&R>5+@O304jt?_^n^33IXDSXAoG%LLNG=T5CGd412dyt
zgqR-86)S-)N-7*s2OABj4}LHhhAbIbfMm@R^=4fG=KzN2_x=8011K4S7XpOrLa`8h
zMF#dnfFD375ec{h3`DyENzf00vS<o40h$&q-I_$K3t9rn8qzr6fJlG~z{|&e0%!x;
z0VadYAY~vIh^N6_gNwj5NF5NbP(3(&HoYsr^OVYCon;2blkyXXv~rF^a%QY&uk-e=
z8CmEF(f5xUjcOw4K+#6g1`0N4b+i|d2{;RK0G30MCxE_pI-d58x;fr~ROQb+cwDR>
zbz$oMt77+?`W_ET?v6B^$~^y|Z287Rt@EMxXNvUST<9n;x^JGnA#(S0jr+=Z!aHq`
z&3E4p-na73WGi1kzy2Wq=GzT7n!6{In6)Ht^mUyVC_0Kd#dSXaZb|&ZW<l}?wFL<~
zWgp63HoE6MEVvCx<XPP?TEAQ*6Z?>RJ+#C<K_A*{bYJz}=}P4UbN031*45gQrYQ6&
z(8kVP>e{9~w=`a%f+v+JDeCR|@UoCGq9D&Thf;x(d&wV0X4KryyGWJ3DYUN)O}{Yt
z5ULmG63i=FNL~IRae49~!p-BH67P$fSf-S<(-j=~`Cxj36F0caORL?q%hq+Dx(lw|
zF&|;g2i~W=-7!?AP|8>#k0~?a#jQVMye4_`LsFBOAfVt@N*OO7?xXzeb3w(p$3Ih?
zJI}ottIpoD#*=mVAszWxiT3s7OL3JY_u`_&$St^hu9%a#qKeWYM(}jkZ>vU`6ZQyl
z3B<~aofG7oi1;8C7jm08rs>2w0aseAzD%4Tw`(}ha&Iz!TmANn5QjU?wMQL?pzeYK
z#ae-u!%KJStCxGq1bJ22^velz^<k`nj+e_{C7Sp3o?8L3nLaXVDRbw;t??Q(GGbNJ
z(OBsyz^`D>x`ClL(lfhX#&)8-Avt535Fw|w=6jpwX~x-`I`WT>pXI^+VaVCQPVA|0
zjLAxy829Cd+<Rl(A(w8=GL(-KOZ943CvcZ7>#qghZwh38b1T|hEcmhPsoApBmugSX
z%yOq`??k_pAm8KGiLRwFHMep95b}(Kpx%1x>NEb7y0H&eKVCa}qPjo4rWINzzS}$J
zlyx!Yu=nk1<we?Uy;c&-$7x&Xll%<Q!TTH77wpn}AC@{+7wV}$9FD$bk~r5IFW%Mr
zD6pM?jCfXJu_IlyOPxbLN8R6L&wA#@gf-b+j<cDXeP)z8x2;w39=c85;E2j!_8_2~
z9O8>HLtr5xw1N+BmE^~|Kka|rSL56f?_Zkj*hPc(q+3sUIXiFD(oO!s+6v5a@%%kn
zv*WJ^XU5TIN#wnd@SLzUU$Q+hML$192j3^{?RxZHPMX|Nr<pv3yyJlGQ4>Ak*41@&
z|5cW8mQOT`kP5)HVfU3j-jE07Z*K87<vP~l#N*@uB`;K0NxpqF{ouCq?P&QJ;kV@6
z5Afd<)w8VKIuo&)_}1i+)8!-WfNt4^)U~Qa@aQe%1mIMoqwUSl&vzX?<4RyI`Do?t
z?6nDR*=T3ph%f`r(Y1Zt628;Ec}^dB3@a<??G2PI8-2IbM@<>~PBhWH5z&anOOP4k
z87G$X0+GeMlMGtee&>CQVNp*ig0JUHO}qWeC6{|kE^n5cePstOoBLMv+&vnp$KO<U
z!%#3O@}i(|ucQ3Z5_;9SZ;f!@BD+1q??rswdHF^4qm3&Z_blt6eTd|Sm`F=c<ddn`
zpy#jDZh>2hCrN^@oo&Li>>SSE_b;}4|3raF2Ol77Z91lt>`~vc`s_^ZozS4Zn!5?<
z*K*Z;Idk3h<LKHi22V$($9aakkNJQu7uohFl<(P0T*JsTvEy~D+#Ac%9)EJtrNdK5
zEX=)v?x^diZtjZ3?$aSc&POS1k9n`l-wPnW=bc2)c5t~(W?_5=OxAPyMrpvu)5_dA
zC&j%pqiC(hr5K7_NZ&JBruo^HG_7na383*&ANa(~B^?<ryj^vDsaP))AeC(*bZNu6
z&*S>d=||B#{wX_^2V6EHrA^^m_nlbpFpe=keMS#}Gqcm+_}j+&+s66(T=(~h@^_3P
z)Mez-eh2RFtY^$F@1{(Hk>6FSoi{w<bAm;MnfdxffWT*`<VxcOhB;ELTiNMmyIXSi
z`vO+-7*nSiEy-9#iCA|N+FBU<O?g>4xLG+`TyXq6ueY^a%3`@Rnso`5e+ibkBu0g#
zK`HLpiHV<uWxj6geMK=LFOsn5vlo)Be9HCHV^r7R-Lg<h#sv3DZ3EOvtAcLAK(n)6
z0n=!Co%@OdbR2J&Er|KR+H9ihD)lt;rMF{fmRo|>H%%8TE5^7FD?W~L3&+7E6+U6K
zc?_Q>xi$v^tV#(!Uf|Y`Gb%A};JC+jzh%=5f!HbYm@A>a*gx4@ZMUqEQ{ZvcvaNAA
zBhGYYRa>9a&aF=NTv&9@Rl^03<Y8y?eK%WkR^3=a9`U$(4qlyW8w#a@czO-@mE$~g
zIFhvoN8+2G!R+6OIG;O{lINocr>;D@1c<JD+47VyLaAVy|6JaJvt#ZloOEtF>qN^J
zuXEo{_uyT=$EM3k{G6LB{VczZo{{0MWo(M{i$gP!drYep?2AO)s#ghk@QIn7c`sSx
z;%DPavpC$N^+di2Kpk$8;`=Toc?b^UHIJ{)1WFwqh1QZ+Oh<*hNzpwd=NWb;i)i4$
zUCg!qpw0B6osbqk3tt+aB$5z5y(bXX+vsQ2$*E~87Uf~P!z_cV<LNYd#>!-6AX_-*
zYW^uw-E%U<#fMj}zBxnE;3~sWe2^bS){;WYI#7#U&NM;V?wTp+D)T%sD?TcGq7y78
zwTL?qNoRtq5lln0pJu|M5*(`dYDG3p_#%g7P|TXG6bp$py`fzHM5<6jrzH``#~htk
zhIL8UP^pRQ>IW2s>dw#{Rz2_Kmp6;0rg)#h*w4?g+$B2^>)_F8(W{7ggYeN2_N6wy
zpyA!8*w3zMxFsm;Eq)P}{m$)qq_AMe#LnbE!`Yy&*~2Ts<P53mnzM)AlDpNCs4K#_
zqnW#rB3Uot<5aY?U7VSiv{FpkZBdr>b&Er`z^*B~1<zSC&yNHujG3pemODS%Tf)5p
zu4kv&`WRBSlh5U9b@&*TK{iC&nXJxi0Hb%pc=afO!;l_EuUmU&Lp+Shj4}hS1RTsX
z6G*@y)hd=n^$K^nV1fe}w_>U;yfs{3uSmNNWtA8rGPtiSwKeL#L@ZGbOb8~aLTR)4
zm{(t1UpCBq>AcnOQE3*}d}0BPz8-dFWiKT?X<VlreZ9A?mc?yn$sr37TONUt?&xe)
zCtD1bxj{UCm2GZ6@GQXq@c=>ikb}*T)ZI%2Zq9f)Ffm(e;g9-f_UI!cy&f0S)k(;w
zSktKXjjwhY=z2BS`j6V$i`LqE)hv6}ELHtdDK$%jH6J#!>+X;$Rshb8$j!9gmot3J
zCYVtrF0(|RbKZaTjgVjlnP3Kkpa9m*HC<n?Vy1;{By$C_Lt1e;H0>q9w5Cb;G4v4#
z5*JG@yu}wdT}-%mxVNtBd6$vv%udJ2yQEz9?aL?l7+*|eGe_v1kmxCBv)j}a|FsHM
zrDH0te6H{-F-h~GL$R#6Q{B0ypKE`ry9AfBi8F&WaH@0v&)UHs&i$?Ea`DY#B*<Bq
z5N$Pv89Amioyun*zR%R{fbZ5IpTbnnL@Vph`nn4-pHJ+(SnEaTsP#HCGLP=?_+H7D
z{q8BU>Wj4yLI<taiII7RhitZITjTMW0eiLrcE6X6tw4Y+pRcXsae3Q1A}t;DELEm8
z#_1+$z34n!wiOwYMtAB`PjHI(J6Ni8YmBoZXnoT?+o%;8H%E77Q%^99e)P2bwa-z<
z^0#uabo{lPELD1rdnRf94848Qy?yA8%gf);Q-xYRt8f%kno1=o^4QH%p|A5MuSkW9
z1#D2=1T-;(UJ&P95?LehAPauhc(wH@iO5q@VRp;3)C{%C%W7MfmFJ^bCx}>00NrY{
zFP>KtkPcDG4q%rkbx4GDNRiXQ3v_DTbZX7VPNVjW`g7%ZOfVl84=oL)TDr~ztr;{B
z!p@lTM+q~g92YKQ3Z;LFC2F(z8BQjXe|%rvMsXkQ?GHAmE~Z_3W;e3hiW~H3Cj`8M
zJz6wYtxMeXQ3@QR8L!0kd`rA+va=A<8n$|xD#p|#5Fq7aLF9uJ^}tD|rZzT3c-vSg
zHCwcSJi?$(*+=3<T7~SmOq<~W1EM?9BD2sC0Ls&f&V_!J4#rYrJKZnFspp3_CiTx`
zouq;_(fenz<QG012-I#>lvOY_ac@0+N4IK@8RI*b#!%-BGfi9w8rAaj<k~(#`bp1+
zA9pkG@`(03sE=dV&a+AG?mDW|?S_oH^mvabr?SxuXR#Q*2rg<=BVyaZa<V+#dQc+|
zLF0=Mg;E+15j9o!J~*u((Q=R4d?D~|=Ma?(^=mzkri@i1W+MVEJSW`DG)DVz^PRD~
z3<=Nn@0{-AbSkDjg*SOK+xiBw(ae^Pu5i!bj21t2;Rj5p#s^Hx_+={8ZnbWbcwLLC
zL#!5}#`A+#FmfeU3s$N1z7z)?I{a}%1!+>Tr=E<LASDGZJ!78%g94g<sYb}H8E>=O
z`XdBT$}r>dHDAo&C};BVz4l?p#d|2P81Fx0FkirERutMm)f<7?_0U{lHZp#$Bf5t}
zqC!Z+_o1d<sl~%@++MwGjDIz9|CyT7kr4G&*9;N{PLGTLm7AM00mxXUoeQd@dU)g2
zfX9^#B6~)VY7n3>fZ^UNl~>qP@^?A|nEIq$BDy97l-?5@y{MfFa5R0N$JF8H&=yG%
z($y9mD7HI37*^V<$gB-_;CP^rE_V<u7Wib~;5}@=Ky13)fF6j1bKmJpW%DY#jQ{lA
zQnJp)%`$!s$@kW+@{U3Cm#H3@95rthLY5kCoqa3cZZDV+z#99AKK|mTP=(6J=5lSE
z#!rQ2=LV8DOiV1wm69L%9xAOydNn94g~Nlc$Wlj93KK(z#MIQD8-|6v3Rdw-2DDSd
z6|xnx%>$I-FtmCT&SSW4NAd`1g^f=uJ+W^Pt_D~tRH5{w>{BJXbx8jf5-=iL;1SKM
zkh@`Etsl17-_|aCvYqnev%-r^FEI4)u=H=nP72g`G-0u`y5Wa+_5?l{gDecVK8?k+
zhPHls=R+*@0eP7(gKuka@SPTMWcIq|0t3DM&}P*Mg-f28lF?yKvu=)}jk@%fYm)YA
z{N0gO7cd7hwD#vuj*ny$4jEINf9{-|r=}5M0Nm#mi+H;gBJHNHa9_>qVU7xNl;&3I
z%XAaPDjWsm$UyeJ#-a9_Q6JwnoS2~9d-|+C_VyU{>alaS8joTE?yqfWCa2Rq9uAK$
zlxMAX@#CVBx@^`qfGE~}5zTT5dD@T5nASk$qK|>Om9OWniUqc4(+vA`6SYaVNrfFw
zAFk8f!iPUXps079QA~Qcy*Rx@z2Hzrhb%u$@5;x=R^{C-Mz}ztd_y_aL{G{*aK?hq
zjJKZ8n~#RijgNx2Uo05(NV>+{E<edV^W<rn7Jw4Wp?zdndc6AVCq}J>tv$xO&jzfJ
zamk}M1#hkuC}wFvvQu*OsCuE06XO^Q1F<`g_{z0dBPBFAQRqx`*oO(pR=-h)%wx4k
zF)$TYnpu5TOm+Vw<Lbgk?3Et-Qf7f>7VI##C3Yk`6}t;N0o%B-X_v<<Z#(kOCN`YY
z9825lq8w*3SR3HGuS!I8@<YfdW6rwAb>C~eljEbY(v@rd=^|^Fwmf0ur#n}N7M1I)
z!(If;x9dJuW`4jqrPyji$1pcfH=3nFz!0t(XQU)&#q!cyYGOxflC_>Kt%qs~jtX1g
z;Amu6)m$><>MpO$eB=KbzhdhUJb4Ge`fz)0h+>hR(m43?H5*n1|6P+FW@HdkMz*XW
zTtNfnE`;+y2nU8!$|*RTRFJ8*Llo?H1>`liU7W2<LKHs#>^iOwzLI0OXQUETx&HW*
z_&%nOMaQ2Wob!>^dUUx&(~Im{%;iXjJRh5E8d4C%^HjDx@RcB3Jx3Tes|XE!PM;}4
z?A3cPNpzXD)keZMTkGJ(uy2G_))?Nqc7`z<yEdvUZ}(OzK9$fG7Q8(S*G*`~P1qT|
zq43?}tu%xPUYZw%i8A%Q&!<7h>S{GX%@P6;&tQ&jNJ05Z`*NkrjQ4AkZUsaLz~VJ9
zSqzf167EjS;wE;b=GfX6FSEvYH?)3f7Af96^NiOX3*5gtu-%F`uirF;;N&}ZAICt%
zKq*2qn6mZQsC@u~NXlkpgg)5!IYh3i!6Vr~#>P+U=$gV!GV_ZwH?83^S7AA*quIxb
zh~ef;Lik9*t}1YNzucui#W8h4W$QAPH;opOu?6=HYT>5V=DFc3@Fk64n4M5aQiqw)
z(fPqJp4D3Y8&~_NDR49ObkYzX-NUPK1d05@C)_3(IYoTEa8%zt@AkUz?uxZl-8n^U
z-%HeNQ=J5C%V2Db*n~ExvwdEKAnQ})71DzjaY7nR?}A8DFV#P`>K=?>Ka*vi>$rDG
zW@OB#K>|3qSb0%$#$UfVhm@_oa7O(T`}4bNH_rSY*4{f9&hPsJ*LzvLcM&abB?v;S
zzF2IxSghV-^&TY%BFXAKY7$9A^pZ%TM+<AU)dkU#=mbH2KHq<SGrzxoGq1Vl&THmA
zbMLv&JagtbXI|$Z$oWS>UYJd~xV>e^I>ASG=uQu{C{AJ7hvChf!)bukclC)GQQrY{
z1=(+J%t37h8TM^o^dF<<ownYpS07Z4hZ1)WT<mUHdNzxzDcfkUNj8rXZ}xndi&3Y~
zO}^g~lpUCz%ch=z``VPS8)fykd{`D|C+#Z}e)=>PiDvTM!?3+A+7y1TpE!M181EhM
zxXVW@#-OoV2kfQf(nh5ICB*D9C?0`80t`maO3z|1&YIX%vkUc!FXA1XY1xU8BFamP
z2^#UgZ+_}|IL{ms48DXj&LXHBXqfbZwL|*inKi<ax~dLmgmzZ6UtA?veWjM}JX&`W
zxE=EJVn}vH`$PW5d7Y`#@v>+*75fHAXN~ry-p;cZ`qAd0Hq56#ey8Gvvq=XT592Hk
z`s%J5xF&II9fU4qSrt|ebAqQ(2+sTLa87+!IucG>?OInX@8bbi-<_C`_vpX<$WcKt
zK2Ym(0Xr)eUU8%)lmrs&!4S1X@#3trq9kJUWk7rZTtjedZNJ`PBKL3j<UsE~X_~D%
zh86<)w^3sxKL9P+LqNY0j6y&}ObG#h$;22g?esD%{sz>>Uee<X$@a-@di5StM>N`e
zjWD<prLY50*qN|zSvTRio`;SdhtNg{j`ItSb3?e>jK;InGZeL&c}SD$g>0*~cl#C7
zj@(eMUqSS{yspHrZ2Nlk=%`-R+)(t8(-Ne9<o9P_TY)D{fvIxfYgp@tq%B~+kONhR
z>Gn8RrBvHh!C#5KN}0b1aAEZpod;*c26UDL2`59{kFecVP(L70+1ejsb%>9usCcQY
z3k--<Hc;=0CO}{GPuiI!qXcqQw&)D!YTx>&#{M-DYmDzf9YeOmN}@o$+mLP$qUr(N
z#r|e!17uVXb_;7=>CUwJ#^YiS7@$alhg}HRR{ukl#;-$&M<ss{8%eFm2bh=VDiYK=
z6Oe$54Th4^<J;8)5n6lxFkJAt!{dYy7qY>2@xaRe?z4|KM%)+BT!HG{IPW{tq4^Is
ze~SUZkX~xzc#U=&$5tE12E7}BujS8vxOt7eRrv$I;LsEuofzh%*A@gn+y)8rn+I(g
zzr#w7Hv30AZ_SJ!!Cn&{miF7!Zwq|$-!A|S2gK<nr`Xt$9VJFbZbt$3mG_-;E#ryr
z=RX&mpBpS^^h45WY2yn#qn@(;C)mJ45)QQ-y)*$D+5En*K6gUe2tBbLe6VVvijVA{
zk>!muoNNvuX(Im#m<F9s#c39yU`YhJ(?T32S8u+rim@u5bi=St_(h*USR&x)S)EMY
z#mNtPMRg<@yr(JV7J+q_!E5*(^D1k9J<tfDd@mHCfB1H0^6UVnr=jXcNy$k!27Wyl
zZ4&Uki+2EL>|NvjZkO|}(Xz6BWyTooPMuTsoPZJ3M6_mT0#DBCItRPR#Kf#jg=s2J
zaic#dPN=r2VQ0^i=+3K_xdOryg+uH#;?^i*KN-`F@*)f&-$(z{7Hd)So+1f<-zba8
zP%sDpFhA8GhWW4W7+2oDF^G%aL6QB&%*7`Bb`0JbgI-tDnisl2Xh%~HayZO=m<Yhb
z>TX0_c7CWu1l%Q5R^=!%TNx>`y1?%+r=cxroHJnTf2J8pAL(nc?XA8g^&4qSfu8z!
zbKUwmo)AjK4m|G*mi-z^Yuyf2=I;wUQ>LBo4||IhV!-i3I3wNPhlkKj1(P)C`WG#P
zd7KmtYhP%|>o`D@-k^L4x@{)NK$d5*b~r0rhNBdNcxN^!(iyP$wo$B*eT`3pg66Wu
zG)Xa<iedH!<1I)H_1%}y*h_Rl?9pY!bFxVWL`X32Wo{ND6@DtpXXdn4>gsN*_@%OF
z+KTj<5q~H77kStYw!+c<1Lh%wNF}uCd#ot<i)yLKI)Hbskwn2ep)x~Jj;LrPUDicx
zj2hqQeK7OqR_;IHw@ZS{%S1q$P1h2Y@$pcAi0D*R02&&mfA7WEP_kXnJ3_#0dxoka
z|ILu4A%m}Q>d3ElcVjDOgoN*wmw$7&rp@c<nL+1uz`bM{J8x4z*{vUvj^Vnog!JP@
zlC?o2e3%~kQT|9&lsJH5p%bhD>=cMV8~}Y$Ov!=8r1ztgzagm=T!h58_pJ6OwXhdx
zs6WBl=El%z=a~!<GRuA(nNxvo8cEZVYH9b<0FdWc#B^__SqND~jKo-k%``8Cx_Yrl
zCI@x;%=sYSa9DMR&JracTsQjd%$~5!eucYdLAK9Hp2p)uYifJrMW3tGW&l|MW$rN7
zFhuhdrCMR9hrmPiJjRUkfN<H@4AK9x{<Kr!w8PT}&Q!}cL%)%h#g?Dcw6XJ4b_V~I
z3DtKM;wkAjon>uvSKzz(`Zu+gLRepWqall;l`UsUFcxVeM3>L2D-Sd3zB{Y*FQS(B
z6!C+%mla6V7&VCQb~!0x|BVF@OciXqoCq%(wzrXiBV&K5s~BE|yA_)P2#|g_-OvHE
zOSH+6cP^KB^G#e16~q=2;R>++&^vJ}`CElm@^|2eIufBcU+z){A5su=gofslQJCHo
zaEj9`Ely*C(j27!&d<h?2h{nRHc}v9j{^6K0b;xeywSepN3x}tNaU|0g|$k=ce(wc
z&p%>=a9lWkqbGhgog9@1(``K2k>1ZGsTqv0=k6I$r+pZIM_?T+T-09To<5m2Gn;zE
z8BEuDM*VIV*|(Q+;+D$~_uDy4yh6T>(Vc&1d*3u`30uE<7gWu8TSn4)2CXYlT^o5f
zvn|q)jDToMFVo>WiyTaw{$!vdx9`*ukG*C5o=@%ZwCZP1|JV6pk84(PYJSSGy$qOt
zhud}QOxOxID6Q_iqdRTeSQ2gk<I|r9KLA?}`+~WzZ;%_zRrw(r%ZC#ipUfPum_D2U
zt9O$!Cv5eSxCQ7<qE*DARX#)u>v<1z5BvNRnu%R;%NtYm)Lk|V4YGBXkVsRB`RtM`
z*zi_(|B!T>rz`3P#){&uoXBt``*g=>gwk?6;>lMz)@fFR*DQ)%H=#e*vxja^yX!mP
zv8D~Ak8cA1qRTS)$zB*&N`Qc)h94b9SCY`6LU+Jml{KUIxL};(rIEPcQofc_wDQh8
zN`RR@*^;UGozWvz$CS!3lTMmCJ`To&Ktk3K*;58%`5EJ;7<o=l7nc;~&5Vg)nms$9
z-q-<;?kx^sfy5W^5Ci`LTVVmYdxD$_U6sNLA?obG4(2^R{O7+K&Q1Af@McJtcS}>F
z(TlrLo{k~qTEkTSRh%3jt^+vAPxt%8JBVV8FwvX;q7s=p8*Df>FdkDJBo>c}K+=xK
z1P6)NW0-PA<(EklmmfLoJ^5q{VY=T~c0T$Ai17n<BSGn&l@tw5;Swb*Y#%^M4Y4~?
zPvx;Y+)ItNJ3^<`ieL#ZfI)7jyxL0s%dx3P{%g43f^4$=V{T{g5AgSA(+x_L3F-bn
zM09Gn2x}h#m4?H>Pmh?)H1mHuvG{TyG8O6bDlI2-=07<4U^8c)Zarvu>Jmey&axN#
zo2B*s;hmbpJ5O;X@<!o5I#5qRLsX7#@tlkukBXO>%W&ITN2FE%yajR7y0x=fKyH?c
zTbT0uUulr|Plp_=kRGjaHoGGh?x`QO^4D1XKYXv1|3BOc*dlRq;{)8nEe=Tz4H`ZO
z^i;ewgrhdhwR+6?ct8aueWAsw-<~A~LEqy3QyEgKCyHS4kT$&r&pBC*C)4*2{r3Z0
zpt}3)G5YNtT7e_^wNM8F7?xQo{HxK56QB2Awb}O_yW|oW-7YlBPqF82O2)mM_89e2
zl9sp8S=&CxLoQo6w9!jobUThgeP2fj_A~=|()C9Pp2<EvH5nM^#H(W})$sISAH?I^
zkJmzTw}4iC9~L@UTki`!%>J~3bn+4ioK+{A&~oFcX&+RY$eGn*lW%uiUb>v;`8lnz
z<`RA-o%V_z(W|qZb+_ge-8>m!JoHN;7RLds%vqEKcrvznh^mZbIWfNpu~ZtMdSo_t
z(XrMs&&#n=^ULx&<?*1r#mS7y-JY}!&|?b|Iv)<9X_)_T#nvlsXTx~l5waiV8!IgJ
zHho1%#?f6_q`3bhwU`-Sz)YNA?BW`tE7)otl?kULdmHvA5K!%e5(Ex7CREt6Vfqnz
z1rEBHiHJ!v!)x)nBVB5$iF~4d2pZGxv4Ky+6&f8XT_+t?F%H4&a%du?u?&=_3?V!O
zr+qxgA1BaYM(#f=uM#`73M`tML&8Hpd{T)Jdd#U*NjDE0>u%U1n`+f?@^~;J%*Afj
zL&bo+6DWkHvjKPDM!4W#cN~Bi=&pYYu9@_N^v7pB6<%jg;kR%5DYDVQ)*v;!XM<BN
z4w(1Gf5Kln*waiGJqGVw)}&r-8x5YM*iYGVSnR5qRJ@Sn#G)c)qCP{0!pUDY@iFO-
zf;zVXY^aVbG-t|j89eqVRlUV#^e2W|d2)j>LhX@gogGCAL`jMp4Gx(dka!OpC#sgr
zOy9OWXSJyEAJ$Lu5w+ayzvMkMzE80=%DU+?>s+#wT_<6W_d-~~pWEE*DxJB|F1Qip
z{WtvD-kkV)aS8+aF^w6}$9QjhwY=LpRd4~`s?uj4BP(&odUO)uGtDiXS$H5WO&YJu
z%l<JQhh_J9@EZrW($Dz#P!ub`;TV;t*a!0TVS8W-#27Du1*Z5gM=Rkgyg1|g`A#Bm
zl)|)e{*6QD4`R}zmEOOE;>WsD_>Ezu-aQve!SPH#9yCdF(@v;LbCXM|O7l?prm*Pt
zaGG$W^mq@j=yunc+}G{$ObPTpD_xMBlL!Ryp-hM3fZ_d2iZu<@dH{UcqZjd<bk?Gd
zz|wjgNmO?XZ?aq`v=pwqH8f(r;A-^A<2XL}E~@NSL15;SHB-Qr(T=s$k<}<Q+2*$v
zYUm7T>wx!relNY4_bZy?jOW|P&|KQEpH^}Ou46MeyB<Yc8aE7KV?GbvX~yB~;hEWa
z!Wh&IYIy-xlb~jXMwx|itrxjHoV<Crq!?JjQ|jVsErDDEVU{?DHBYi;$ZNuV+$`&!
zJl+y0^d<JbqC<areL9EtkPqdd*@*cFcqFWISOmO;l}7xw6ZtRQ!p!2Dw1~0r81b}F
zEMw2o&0zzp{C|gB`hYAiO#UXvsS~)tzu3fHFi*678mQv-J;7bV|5M7|lHHR1lD&gI
z>3QfPPrncE_j>g@pFG)SK&*<D3G@&bq5_+rKK&5EEGr218#W!b1Y3X~40{ZFf)(pS
z4^L%{|CXhnrMIPTWz=QPWOil_;PoouMFg1+2PbGVz$edY08)Xo_|5cOFACt1XJrCu
zz=2iZ^8~RDdnahl|0whSzj!f%?ce?$bcGy}VK05SWdf2yAzZ(SmHhfREO^5u#zi4)
z?0A!Y>vQ5IbQR~Of+`}UbeOrW{8LMuB|J$$wG*Cnn61F20Qd6jQlLL^?kfMI9yMzV
z*}bWrsh)cUuunA?`h$O2G#~~r=Y023pl&BB&O>V2=eDE!hN;%hBVkKnJ9`IvyG3Jr
z<LBT-@N>x59mTrF+S=IC*w#3$IQh8NtISRUBgkrvnkQgWwkX3bShW!|#dq<b@V(Ye
z%b*t@4S1JsAn6&j`Ya6GJ$+{U1Y-1Gr1^&yhM{=C-wsZ_^<f`93SxZbf|87XY0m4@
z2?ah(FyBuoiYtm`Q0M5b<c@3Z4jFAGLVpGDm`fAL5}++jdSbPZpTrs0o&xr}dT&t>
zpxwtpz*c{6XjVj<YhPykf8s^m^g2)f(`w)?0MFSz&qlj>zvna>d1IiJTRO}je^92;
zN8<W}Gng$Y21a_ERny$VG0~_xtq7BWNsjD<!x@!Q7kYXyibA;#s1n+9<0&;>XoR6U
ztS$Ok*6Zkvco-v^nO!?!#GPH7;iyN@o@3pZ`7!N2iN${C49VxwJugauFTB5LKV@MJ
z7@%W>9w%hm1`pi4c>~L}=ZsI~<6oyWy+HNvdv0LMw)?@GU&LUW{R@h37G@Mj_mb+>
z?zM1OBqjuIE}-#3W2Y__g1lXWEw;k~8Z(N29pHIMs?ugE${m4lOKa@S!S#W3(2A$|
zxBREzOvMKn%T&?wjUkKrio476WHa}(suvkRi443qE+Domm$dg@j;NJ98Ys<}<x#zp
z^vr|u_LFJi`yqrNSKZ4KJu&MzIl1wZ{Ssk!Wr5*0P5yXRt1_L$7cS2y>lp&xzGdAu
z25UrKd`BITY;&&|-m<QY++cVkV<pu4A!F;Sm%@%^LEe$^@;ARnkAG%~Fp8nE&}HJx
zU7IgeeqVl0c!dwkS&PcO_tIyzpYDiTIWPzR=^GISE(8+;Cs?I<zs37!=Y77hn+!69
zLo@#SQIe$B?3+QncWQm*fH-d9yJRlLhWn_p-|x&foFzAw*%mt5Ieq(umALsXk#Vah
zxTai@AG0$%G0_X4w<TR2!S$H;e<D78OZmedSiXFmY9+T=?oEGlA@)Ubu7>dBlYnpG
z-d0k2d^F}cm@zL;Z!W8)+FXz`0TT@mz!iBo^R|Y3c^#i0SL$QoYnLQTW^ltv=)I(#
zBp!rBk#Fk;ND<vx=5HimMjvN1*5qt>J(n21FX+nuQ-t+-acG_AhQptrIF9G&D~s`H
zXg{HVprY<fXL5pRMrp#l(;;NsgutF_<zPvK01?e*ptt}8Q0elbUn9^^1b|aCFj@Bs
z{RW`|^BNW$emt}w{-2@@%ufw;>^{-LiPt3}A%rR%KiYr@ClJ~TC<Vwk!fYXv?T6OE
zVSYVG0Li<@-TZnS83QfJ0yRC-K29Fh$~|3oxSm!`&OCDKnz!%}9<O)hchK}oLxTfF
z1A7Wx&MDFYhPyl-NN5^Hj>VbwfD>dk*ZKQ3dmWoxoW`ey+-<@sLGl0bH_Nbfnr5MV
zKVR_+bX?tzDZ<E=LA7~O%e|`R799k6gQsG{p#l+QfU%~6rV`aN{LLNHsxiO|*%{?z
zlP`lY7y96@51CM|Ta$MyVF*P+6_5hq0EOfE6$7YcGa71x^+Y^yLIiy(#H%rADU4av
z5vhe?V}SC8{YcG2xAe8KQd#lffdm8)Y7b!tm{~Ir0-w#J9g#t&I0<I_kAtMi%_JYb
zNnWTT9g*QHbAd8{{bjj6+GsyY`JxWuNiY{h7(nSD@&MBp#9$&B2w82jd;eLFU&+mu
z-16_QUsa=aVY~RuQl9FT8pCIV+}zRHyH!>@&@Y6$wYVyDO~kIjzZv5kc*EUNPkDVy
zl;u9M6?owg)gx<IsQ1LB66<R`Dqt1QQ)%{hM<pfkVzjlhwYM$2ExXmbHN5R^TT0uj
zkOnwrb)oNq&MFKN7)_Bq`O)H%0*={Mitb-iPQ`~6ob>z|_xChW`h8cu^-+lQvX4HB
z29<*>gx{6Au+JBzLHA`aoUe-~(2MZ;Mt6}Tw!!q)^4;b_L4s)T`{FlbCp7)vu?zQ)
za_9>l9)w;9R*!u1<xO8v$+%}d!nY*6;LZ8LdaTJRK$Ts&4d1;aXey$F74xgi$}jnI
zE_Az>?bvZk<%w^X#N_MH1oOkv*ZQ$7W%VP)&dA_$zH_D50rA2v-xAt1z8|Udl=JM2
z4t%FDX|~n-SSj+x<L{=;uCUjaDIWe|uP?k3{1z`_UrF7u*Asa9xbnlC3XTH$=HBS7
z6(AopK3{<JmFqs&%sg)XJAYT_30sA%-RI;00gF5TSi2%00<zooeJYm|1U$?iyJ^rl
z2;}hWW87Qg{MWi>Jg9>c4!aEfX{O_Cd5v(Nr@Bz2`!Ipb^jwv$_X5ia<twZDdz!!O
zJ%2IgY|P1%mHTY{vh;oGFtTKo{%E|xJH6ssRveHa&3nfO+{*!Qt@y;pLItsW7MO#d
zc~;*LD*jZs-sM}-jQ3=@WOQRIN-EYzDmLiwx790cTVT>>FH;l@r}FbY#EfY2Agk_P
ze{yCQ<b(MsP&k>KdD)41`JeeR`kNYZvERhIxtq;tLoi*>K%;jXZ?KIAY^T%DKSZ^J
zT*TGP)fOGIP8+JV;B>e0Z~}V(C27;kXLLCqMzL5*rbe-Q^?&F^{Y1#hT%m?pHdGd>
zsbhL50|W$L)>-SaC+y*F!emOjXlEH&9O-Vb^JtJN&WWOe<(}X__Z7C&U|N<aSC%Lu
zOH?M{9wDRdKklK_I_aWK7U8beqo>r%$+zX#ubvrwJkKM;wwyiUu#=k|FkljP_|hAi
zr+pUbuY@JGYv>O+g+AEh=r36Cl-fLS%83gWi#=dwwfl$uV!ed=0%x`7+6AZ2%NU?0
zoJ1^3-j>=+3yx5YByaq2E_H8rYgcYpY1i<P_Wk=^VU_J!mYRx`UDA8xEdnT(^u<U@
zHyi$-%vkZgvX$x|)m>E{m1(sSHJv+_Y8!W!cy0nL58V%S_E`5v5AN>G9dv342`{r=
z3M9R2K`$|j;3|&#c5aDll`D)ej{4<y=B+0yIC#l*r$#~U9E@F*ue=mT*AxDB_~nH%
zLIm*UwGLdaKK$suB%^vb_)SMy3=}SUxGBUSda039{&2oHXT8Z%%x<$dt@*RDyT4rD
zlVYzD1x5*8&|@gHr}o7iX3oAae4ezRj67&{Z6#-od$sFOB2&4eZn)0=akrKw{WJac
zC>^kchqUJ+h{IZ`e`uXfULr<$$)T0yF_5jT?x80prM3tnU)T7#QfDTPB!^o!Dt$VE
z(&ygE;!)N=8%;R-z<t9ubzWP5`@l|7vv2Q#m9CNYqJw~`tJI$UgH_@;5t-~oT%-qZ
z$}*bm9~t<%($Wf>Nim3#u};xEseSZh>~wz}pDW?LpA?(ZO6~$1#>1Uv20j<PZl*4W
zm=<pr1|A0f3CIla3p5LK5B!2F!F|Df^q=$Z_CNIh>(5duB2y;wRod;B;ZulCz&~3Z
z^cT!Ow2s?9UA6J_i>Ir5lk=XmgLfBPbDL`|H+cpj28MpwnB9Y^YbYE{iKMgtOWxOs
z-Dg&F9rPL6*xXCQUYXo9e>?RqTejhqIw%#gKIZ$UJbp&w!`kaqYHh!DLerjxx@juf
z?HeQeK`e0XH3Pg4@`=EuM7?~F%xo7Sl#*;ugG@Q<OYF0`Bor$O(&?Wps!d42gU7-Z
zPw0$GYsr%hY0#I%zlu0IgO_k~MPIr}8avmCW0i0^x}*r#o??|q`j882I`Qv6#$9J`
zka|gpooxHRj_<fCeo{PEO}w+9_JZpcK=1JCpx{7nulc~{K<a?zAn8CWF({FN^k!yu
zDs>@Zes+AEM<0*~Wti}q(_EYt9uxq?`<wIi@(uC5=CwE)IC6G5arw|W+j-D=-pSG-
z!dJ%kmDlZP<_J^KJV1Hb_Mj~&+~v%z2U^GXgxBgQ{^-up;8DQQ=~42LT|8C1LOf98
zesN6klOqVlO$t#m5i*%rXqXL^c@NABN(~t#L`u5&0>FEJ_jJjO)IpLkepmtO1w3Nx
z(o<xZUD)}Khs0!l9#d0}gr{f1aKUrPDrqady#b|U>1fnX73Oi)KPl+i9H0+8Tky%g
zryPUL>0d3v37y+r2r{Xetm<kk_~eWzb2-xWAD%K{Lrf&hUr)7X58i$izR`mThJ*t~
zC|`#Q_LTF>H$`@hrT}QjTzYI(5hlXJ`)pxoei>EN89*4I+krfS(nE;sKmCO|zVb31
zxsi`gC{}=&x$PbMT^3xF<{vafkTO`X^YeiXFi;V<aoj=_yC;w}%fJ!o!fp&a=Cq1K
z`T(+l%$$faNabSLDHR)7J8n6MjUITMMOoT`!R0EIg%8zh{t5^Ra0$u^HNdswj)D_H
za9$ZI8tbCESSu`W*?<hrc3jn}@yN^(nhEiSghSoK8MKE~1e6L@B2}0d2DE-?jcQRZ
zXZ!3QDYj}MJ&d8kldBV(bl^o>K2q#j|Gq6B5xCaBXhRQE(h$-6uR<s<Pnc^=m1*!%
zA@Xr?4*t3`G&3#|ncD!Q2B?w+O=Q1cGJYe;TG&d5egIT=&I(_iL}mtMq`v1Tyq<EM
z=lq2PYy%*nUj_vGrw}JHRM<aI#jrb!&N=ePr{h58Hl?NhNaRzn<*8v9bMnPrIn`cy
zCS>623)s4`6pOaO5?MTqHx&@MUbBcmEkf!Sq5m06*v%IVG#iVW-v3q@W|+48M(EO{
zfz2`3)%<CHzU|>lOEy9WqZB6N@v^Cdsi?y*B)?s;OY%$1E3AhaqqNr3X7M5!Fp(pI
z5fV+<N|=UK4DOrl^sY`ARyaHAKe0Y*vVFtN%NkFoj7s-blv#F5p-W!EVr=~{yx7M2
z>Ft=CA3GP1uH#j|^BC#&Wx<vASCmt%weGHSoB1cEwvBtsh6X_JZcm#GB8I;rDaXab
z>Z0s6wyb7!2*VHFhV9=>%`m<-)!J9Z)9F`4D!e(V__JNf@5_M8ouJzyeagL1ndjus
zFl4*S=-Hx&TxwU(i)W|u<y5S{U!{Pw#vaMH@OB)M8KC(0*=+VtU`Dbx^miC$o@MEB
zCf@yBe{hHGfN{8&GmmD1HW<exj-XZ=R3{peh$c8}x4qmxw&kj>s2XJIM5An`+J<dw
z8}hQY+C9oBE#z=(JzJboouI9eWcY90YABR3__3dvyBWl;=W^iE?300zg*Jqn*v)er
zu&_rJi&M8-qj5nG+6vhO+Aj~B1)>GrPFE(a7jhH?Y1FN=>(KiNz*$=IzjTa-gpeiR
zw?D`L+D&4V;+DVua6w95vEryOME&V3GGrwX>N5CKY0cWy`jf%SxwinfI1_abm+-sG
z{Y`3mrvX0?$DG;SW@MV!e_d3sa_a*xa*H<fKuvc<<D}zQ;-cbq;!ffc@~l-Js?@6(
ztK3x?Q3+5vRY_8@ccNN>m>>ivjQFHPa)j1JUa}Vyb=>tsjMLMPCOB)1za#dJZ;js|
z&WslmP<V3Z*nf9hX;&*FQ+#b+usZ$L8DP0uB?nnf81*uT1uoYwtAU)OEc+nZV`OR<
zIRdcxOi{K;+9_lp;*1ExKUJJw2K1Y8YtCyeb0@n*>4n%7LQ-!{wGn&pc~olWH+%gH
z`cy^E_Y_Z|5y%e&y`$HZIcFcJmd_P>A=!XpGDj+hM6ZZR*q-TGJrybu`U9{}fj{G;
zS~=J3MZLKQCOdEJbxL&Z^-F{obbpw(nbw^DuyDRmFwak<7C9EoW;;I;-xuFsInFq)
zKU(4L;!fq6<&g!L2MYOL2He6;2J8ot<2*VkIv~8bAo(NhAcdowLHB~lj%0%%@iyV+
zGccDi3c!HBM@Kp@A;`T8cLp>NvI!p3V<#1HZUi8U+^ddsy_)9>U3gVEdU#d%IobC0
zkmwuJ<e(AUT85AR5mvN$MK6eG(iM28UvNUad;*kJ&aK~4J5%xIY5~Zv+kI0nY*-k`
z6l5866eRp!qk=a}vXqMNL-FaK;<n6e!eU&6b5`wGz3e4{lzU#HpD1rg{~3c8bOuQO
zvi4z7^5-L@gWlQTdIEo{WQZ{Ab-)gT3^V+K96B%e-udtvOq~7h{3v7aYRn>5V|J&b
zV>-W!-S*sBxqM>6-y|p?oV+93ZC@i+=f4d5ZK|XAx5Cd-gC-ig;hNnMbfnMzklkdD
zJ<jo2L(6K(aDSgSdh9aELDQIFZ-3er45od|GX-@+Xw#JrUOuz@AK41KTq>lH+rwnX
zGJnUmv6i}2G~m^y-YXB?SKjui#DWgzjs~bfc<Q`qLJU4>pM3Fvp>ODexcxZY7^nH3
z3a0;Gmlc}^PV&8XsB(~L!!pfpjLoC-e0V0UV6dfNFwm&IyDWqJ8qj+MOY@APxR!RH
zvaIbrr!no4JY2sO0{T?Mgi1x_L5+=dga-vXg<ybA0RMq-00+(jcgOg|Cg9Dy*O)!4
zlE2>zlXB<>xEGuPuAz`M@jgL|*R*_B{UQrs`c>O=cU@2aJ-G@Ha{%=+W0>z*_tf=!
zVakroK*l49h$DWT{k6J^Ex0y38;&ovmpPHaOFxi)WUJp&um6JlE$5cCu3u%+MJYtu
zKMKGp^49EIEBwKM4QFNYX(>QD#1kScZQ)~=jwLnjcT^X|Ocp*l$+w#1z_SZ;3O8NM
z{4K5z`9~?LUocY-Dm$0S@^KpBwttXo8i1z=xEcPlO*SB8Rg6u*lWOMD3v#@&9%Uq3
zxD;g(m2*$E``f}|)^U!&R&+npK7K+s7HqW~2CNx+w`hVxiz^cR-{ir-aJ2uPu$9h*
zy^k;=)M^ii2(2}tp#l{Cc9S_}<gD*w)_~tb8{AjkE0!bPO_6_~bZ`1$gyfn&^k2r~
zTwpf|niI9|3H5u~1yg8S^~{Wlk5!-cG2K*muug{Til-hY7dj1c+d>7ljWAzH?vi$o
zCg-Yf!nKU<Ka6UX(K5Cj&<8!qJV?UUUb2rqzvzxq?er@Pv?xZ}zpYkqBnuVsHW~D{
z&09j?Pyo*7EL0&BD4YpUIvMx_-P<~(KYG1ya!h{WxhEQb5erfGcfkz`4E{H$Z7Mft
zV#+iZVl~dkS8n$pr28RYITr3RGALu`%iX6h(q!ag${*A7a5+99p6sE)L-51u*s3^8
zIwE~I{WN_oeKUO?&#UxVX-d%*YXpK}0*mZ0)<yR7)`D(=sQ5BMcKrAW$WhQF$Gic}
zHc84%QUrl+VPKiIIdON?bo{6HGPaefu}}=$8IpwuU>o~ENWwl($DVl@dKN~Uv*yC?
zWycIgh-M@JLv7Fp@1}`Sd)Wa*-hD#YPl@nx6eO-F3l!p5fIJ`=>@|m(+625Vu_8td
zfkpRX*p?9VzVkhyJs}3627F&NP=D?jMiYH>RbDldXOXLr*^Ud>&pDCA$ID3vvraQz
zbIJ{xvh%@TycBMJ^HV+h^us1u6^(rBaQ&32Sv~#-{GR;YHqc)(ta&V5sDu1335WfM
z(g*#A$$Ka=rLZqyx;-{Fh-?TWEDH%;nXRAONFCrWIv5LQ`_3735V-Wi4L_lHP)q(_
zSe*eAKO|t{I~#hRL^c>U*ApxPR_<Z5c~DP1-aFI;>bgF60v8P*Lk`(wlpk;=L3-}G
z`=q9b?7@Nw=fuGZIal<G54B43^RQ2P?AB47BV9uDI7PnFAe$M86JJ@VN_Q+DLr_&0
zWMZrnr_5`iCzfy11>o(*^SX2)f(SD>FJ1>dB%-&TpDk#(D~)e2$SfbN$6?T+6~u2_
zv!tsqT%5rV=)ea>pskf5r-TulTb?Ne3PN~-i^#Jf!iUGka1Oi}WvDu#1cyOGD87tm
zR}JUaSKYogMan1$aRxWeiy}g{)X3aZJpX+CWf4OmA&3*k_2U|G<~T##Z(IfL^MfsN
zF+FZS+$`=8XH<Cb)weG{Ettz9)RW9dSf-?dAW5JiYW~BPdA4{c!|T!F*5|wF^%Bpe
z8VwpT&i!Sc?|6DBLfY9B?e;fW&*o9Fdt>usWM*OfN;7r7&=j`!t9@}}LBjwkltvq*
zN~7Iy0qe{jVe>Ky*^5_^?jh_pGH2cF2gf4EitPbTkozdW9<<Yj;CN*U$k{xDn$}99
zgo^OG6IErm4a$_F+EhRYf$4!K<`~$sbiC1fW=P?02*{!o1F*C}*Lc_pPeATbeACD#
zpqlsK5>^$W|0*PmD@0>A%W8+V)OLs3I%|hU|D&;12+ZGY6!NXQJ3jtX`LucOse}(z
zF6*!Y(aN&4V(E=@cbEQBWnAuS8gcO)v5O#K-?~NL?7$_N3pxv?ECO70COmgLtKq4a
z*ym>+l?@)1?!vw{-HUP+i&FWyo@|9gz~f;T?Gj<_=V{s{Yfm>b?}<^~6Epea>-fi`
z?T^2kM*d%yMi>MsZ@oLPEbNmW6Ie78JUu7&-F0x&Q#4&t+eN|3MH*w`<G9<eM;VZP
z81f1w;4j!cf$4%O_=NtO7?i%G(98&(%1wIy%-PM*xh(QkX~_MDbI!qy`2z(K&O`MT
zQyrwgR{te<KGQVq`s8uK{AchT&qy-(IStEdEX#@@%c>G-!94eqq|v(zx`9;IBb4o<
zfBz*EfBE4!`P#MVbqHVseJh8*6$CH=22F9yy|ycSZKt65(mgKdZ?yH;%Tf3HnoXWs
zb`B%-3vrbfeR!MJ{4QeXN>lU6=r`8LwY=a*s&RcKd`2JBk!#jnsiu0Vz<-Os*vitJ
z8}4mJSHDdAFjJ-#;@}-0LJ{@0-fA=pMyog*`$POzbm-!lPG2{)K3*m>wVLuz3s;R~
zbNVICvy~1RqLEHYpU#-Adv&3Ed!f7Ay8;fX?@DfrF!amGPZncWz7e8gz3H|1E(>#^
zX)5yNb%@Kl^#vWa%L0`Ot<_Te<T>iVr6A`TDD!f%vd-+qy=h$8n)P)|*x@&Tf6wU?
zW~?gm3n?;I|0gq?vR+HHKp!bHN&NMYMd8~O_LP^6teZ7MG#4w(-wUp?x4i#8@zt~6
zO?iP6U)DhIH;mSfnU92|c4qtrhPw`Hb;)0!$G~*DBauA$dWTH|Y_I19E9KV=(!X%@
z1l{Wi>VI2PRV$fMwI8f?qm%o<h^#Xv6FZfjJl4rp*!!B;WEB}~<pz7BX8;zkUKBaX
z1ucgFokD=c`23lM{|4+T5RU?G5<0!{(%%}v{lj8kI^d*l!ViT1^W52Y^i&fRX4Thk
z+0UpsQQE?mzPm$p(ZRl4)HA9m%`ev!d<!^Pa-bVZSnee(=U*C#wuoU`2rIul>u{aD
z?;b~wRy`MPjl#2pbQ|P5@@erqDHDEOBhTzl!=&PUth;=U#Ld7CA8UVkW#CgNT+Lj%
z@s%1|_2H`%x)z531&iw61MC23NWRr`F3)3J0`6(vkV~V^dTGAZK2if&QZj-E&+X_O
zR|GWhs)>Qdz4qst*^Bf*{?6q$)s#A?vXr}_&nz*#%?we$<Z~4)-SO!Xk%H%r2Z{#c
zjoEcQY77(l1<SZOXQMEjK2X8a5%eYc#4330V*tGTi|T%des`bd*L3qc!zt4B&~3)S
zO<XT78yAa%0nzAibZEq^02_`K_k;o8xj~mTp_74Ohki%MSn;=Lrnys#A8G%fmF&03
zvJ8UM+c}|DY$#v{HW?UYNEwnGVnFBvh}@&AGqW<(im__l?&B(7R4$P&r$-iUg?4dG
zxTn?N<i8E?4E-K^f4|?ZqV0HD2_XaBg3dtWpkq)z7#s2onSvZcoVI|P_gd7OTU$<B
z@@hRK1SJTfOkx+}J))=L%Mu__A5SU|IM~_V%$_mNjXb7N(|{+-L8UY;dFIRA@6h+I
z%5v>L%p5Lxo~1nc7_cBLAEjUw3?A2tJ{)QL{W?`I$*$qC8;?In2eb&=BropfApvHx
zr)%0N#D6^~7kIM)=@+#JH!orW3H`N}!Ifu{U!6QNJh(j~JY_x0J+nMDJ#4@g;1%!`
z_&#_Nd<-4|Z-MhsEasVG_fBMSVz>X)?s)WHC!GJ^Ri&QIY`X&fc}kgedE^D2_U4i2
zqQP5JET?;xiEbB_cfWYKwtO?Kd9Wb=iu;#gY)AhbW$Pi`@Yb5|zW{cQb|bZB%Xu~Z
zt=@&>FA{>$5`q}d6Pv9Q<E<0tVn^R%EKTECZFR5bX4D&*GlwTdtHDNt^~2x$;_7~%
zIs9yj%S!P+NMzwCOP5Xp`TfSZ?Sw=)`|dVGztXOIu7G6oF&EpOX-qBi7<SM6(}9N%
zdGd(1bQu(}z0qNNp*1zcUv&@v$S%cyh9_WrTEk(gCFXx9@vq}Sea0N;H7++}n+dgO
zQGh3}Cp^cGDJG4dMJnjCf!^0yYk|^Vf-37#-m9WX?N2$Xz^FwHd)GyBdqaEbMdd{+
zo``8k;6zzLnV8C%dkT!)PwLAc*#Fcm(`80eT`!?8_*7d@OjO>&EYT<xSB|BRS-REs
zeROO`=f@?=z2ejE*vlF##@AH?Msypj9tPXO)u3vv-B0IllKy6C(-KVoHSi1-hS~l2
z`#mVh<{5`B&Cbmq6>}MN{}yNhkM|FRRDZI*)fvkF)Zp%QJ4cK?s=HQ@ugr(9^cuW;
zWgrWt(9i9L{7$SEN9K+@^fP=8?z7d?r~LX0hv7$Io-D829Nc??Ty(SJa_Xysn8t&&
z5&wbv#C<+?`P4@r!;6n$$!(hVpZ)E&)M$?~%cAyO-k}J1E!h8IQQ6^e8PdG2b95t&
zcWtuDlJsg#c5nA{v0Fbr`w6Dp+MKtY(-R2x;!(L_8+c}3WxE%6#TIzAnDgXFHLvmX
z+TkAm=Wu|BoV$}_Rk5VlhN8l@w|1bVrtVTMDfjcy?Rs{{H!#QYw}*$#JkzOM2kTBG
zGZWsD1W_Z;6Kt9zCzisI#*v5xgU&#ZdHn|OZq0)RlJm55?aX@<cxfB_MLxV-2L2AK
z@hWtU<>zI|CzVr$LBr*Y^O}&kbg|oHgLCfn2}9;<<pQ+pA0I{4*~vaN8qLi9R|Y-E
zr<wDyO|tp$IoNNFEb>KGW6h?R4VunB@k(neF<yci@>{~Dpr<O~5!pu3K9ITn{OlJ`
z0R4oZT`?o-A05Msagy2yi_Of)$J6N%i(5-C)W_uNR!nW7im+$1=?f+4ZsWLawqlc-
zc`c0mILE8ozWa+lKP174+xAK!3=?-gI5Ifu6nwa~5?@YwJlXsB$qkOaL3h;?;_zDh
z+r>ft+b2^@lJQQ9+}T{2VikQT4|(>r?+>LzOz-t)T!!RQFj?BU&(;W7mp+sOK95hg
z0HQBA9qXbD$HNVUJ6SOM(oUVG(7RDFF5DcWcJA8vJ%9YZ?$V(Z3+!SueJsSW!?6zw
z13Ao-VT3+!zy{5jK~I$N3%v)ka;-XHisFs|j;ZILXs14=^*_Gx5f5+>TVf-S<)~*W
zW~0-2v*~ie@LI}8iZHAYD0B4lliGNEjj1$xSH$1xzxSc)Q<%C5QDs%o*C{KI@H-y_
z>z|H6^$gLh<y>4k7Jr(ZoV%Ib+wN;v?HI0L7dt0vD<|eEUIXO@ZW2TkAgJ9jr(J?L
zD_%0|@1v;IXC3ZYY*+$AY7P8P>0op<YOx0T@0Zist&Q_mV(|LTtEJDFPV2}|+dpq@
zc$N!V(l*O2JbVjz@KQfo7N7C9X#8eOkis*n&R5jZGMy*_H{0I*-)S$Hs_gvj8MgnM
z{3+8hv@!6|3d1{ZHV>M&z<@A@n1FePYpEYP4Bx!O{2iMcHaa$Pvof<VE@z}iHY(c;
z8OCM96_Jh2hAa2N2)b;h8{guGZ0_@t%um8T80^gkAkARkpd56EwG>6+_W~S7mE(qb
zF*le_wO+-iPB8C2XFh)1Ztd^V;7?`dpV>I+>krJr`7rX5mvXFTx<@~L=enMESWCVW
zK5MW%>xZ-_&N&J|4h&^`A4N^39s1uCuX$(|pnNCF-k@#Pj-8OVXWx`|I#AeW&}a~1
zU}CUq@Y0~!;D-UiMrM}Y#&_0y)_0cNMtGKGmNIQG+D6!heD?mVj*aRpMcz-|Q3H+H
z8(HScMve}rQ(Ayf;2Sg|1A?7M<2dmz1zwUM><}zL8E1mFf`Pxo2mpIv3(1Zhf+yJE
zfN0nO6ga8KPVj#KTqP-UTBXBy0r^017NkC~&0ZHKNopH}!adkPz}~E2f9M4uT727^
z6lHXSY2{9|3!4W!9Y+VC2cW`U%@LP*^KknVarKY=X=1qatHeCLZ7C1+09&Hnap4H%
z(D_G#>W%cu?b^57wI7+i(F;{LX@7Npf`5?z@U@nP9(x10xLQhFIBB<n;Zda=LzTc?
z>dz+R;!=N8GG9emY5pFL(bWT)*&;7BSHzS4g8jP6hLVMbb3SQ`zn|$tsoaQR@mk<I
zd_4@k4ZysP*3_upn*e<LK??n(4E4PL471io>=yCAAj!U11ZVF{@taDzif8(e9;p%?
zAw~>O%swfj5NtBlksmjnDM>SJDc%3cG4Wb@<*A1?&UfS8Z)+jR&nqc~)p0EKox~b|
zG|4wCsa3^sP<}%!Z_I8VW^&a`?U8Bp+T|kjvua~n&bg?*HoWrooM45=Oz7pxZEAv+
z6xbum0F`?i)rqy$i78pkBb?I5(%onEF*ffOA&u;gn)gOEnrgMSUx-GV(g)EK9(c!q
zX;z)QoeLI=rl~JG3j<n)Oue1zbJaFGQ~J66r_Fo$T-RKTh@a^^r_K9_4J(r}cM*X;
zr0$irar0j6?Ue@zDS<Kb&S$wQ?4eKPuZ@bxFVPd^EbpkyOU}0$sYA!a;Cg|UXFSTs
zjZ&&V7mM#Tta|si=S!IP-n+f>nACnT(>(4JI_RO}6x%4`@=w<%E~6qXLM(@|tKQpp
zW$}4o$Q+E+r}tIW{IrieB`L?-clnxZz||UL=zNDLjtyw+ATm0k9RzuR8V(CIKwD)+
z(!?@_xT0MUNC80_eFFhl5WL<1hGa+h_cP~B*~EU==R-?gV#;7!Z^&qK@BS!Dy;ccY
zyIPF9d${%^F4e2`lirFqx#r=IXhEsNv&95q9_%tV-7-hj#6Q7wXn8D{1W%giSK3tS
z%Cta%PzF;07pi$`Xw}(FKC5jG=S;8B10?57qXX}0a`OzzT=8h1o53fGjgp;dGkoU1
z)f+Za!#;hU@|Gpb)x1PVU5+j$O2nm}`I>LtxxGQ3{OP&4x42NQHvQ?RbxrTPUl&um
zzCSji@mB3wOl}HX59*Qn(Yg3Y<@S$_s!!_g%@1~SHCS)2>3mNOY?nIN;nAc${lxvk
z{B$ucB{9|8S8DP3liRC@M^X{nJj#ze+G$$MXBWv+dJDW=#TSdx4p#%^rKq(R3mI>(
ztmn0#J~HoQXjq}yY@grVmk&N+>9kFqjA?2e*RBqy3Wh52h6RSN&<a1YQ;n2AD#tT=
zR~syZf1sJYy8fhPhhxdYC_X*yIO(*O6<*!0ppr_^Tui<se;h6pzr&x^6Qi-1ni{x%
zP%V|sx|l+HxbB+#iL_;YNgMbhemGlb_U4q}tTxkP@|;*|;yrI>#>J$hh93t-QnRb(
z$MlPF7d+~7x~a3H=4X_LKTNfx4nlJ8Q02A1aPsyRTzpO{OFmyRpCfPh&fp>y5y+!P
zMc1CF=k3h7SVZbfp|<yq=2$F<JzUwR>mm?gKkw(cDV^Fb7J=5+_)6B^PpX9SUG=T;
zB6{o@x#4$(Xu<;5-uD@eRysYbVP#NAdn@w({Na1$YtHSPe8$6ngHQWn2OJRo<7}wc
z`Pi~O(61g>hFkfOBD-!6KeIB9+tDcIn)fh0Sed&Hp1%$`+@2Pv$;o`qM<<hp<yyQ*
zS=qD)YW_J3Q)atjp`NBMTK))Ixm5LhX(`7>OIC5=L|2zA_j=u;eAmfyLbTndX@*A7
z$U>NUs`Rg2!!$dH0W?qkP3hOYQkuzASzhOTb+suQ{wsf@lhW`5ie~m`!6%~W4X4Vb
zPCKA!hC+bSEfpr?Ogpxo<)T*AYG(`xIfa0J!xi4Wskl1kX6r5GgE5;jLH+MtHkx9X
zqVIHMOdm-f@h1?9N{c(v@j0;txQx;Qd=XhXNR?L+jimz#W4>abC~cJd6eUUrC5;lD
zqU?|gdV@htfimxNApMD@>0ydlSY@u$5X=?E7-h;~>QCIuXjMAJ7J;-tZ!wxE@60eI
zQb!K{4i;Mrs>E!el;EEGUjZfbTr+&jMainI|Jx`Eo_@ViMP<CBC};^IJ7o^nXPaBj
zF1<tNSjlMxQ3E+8gQ_uJQxC=?>qumU0M%CiBH#z~0OB6ejZLp(4gh!w+{cMYPz7!R
zzo6GAZe=*uK{t7lac*b`dl;L!;^HY6Q(!d^eqGE4jRkb*{zQjnK$aKjxWSjdr(!#n
zQz^c^zZhUU$X|D~q4cCwHN6-@E=>I{LEinYcKi95B-)s&Upw4N>B#lMW$ejRN6E^a
z$-fx3t4v_ra+d4ES8}$2Uztu^hYw#eG)n)x;u-plU&Jq3|9BKw{HPUY3cO9GLs;I!
zu>gb7AOwaT=?_z!Gc+(pF8JG&j!}#oGhV7btfuu^HK)7(-!29yfu=^#6Wy|nT(^%y
zCbyGI6B#Y;;h~@L5cF>PSovFMUCWom$OFFqSA$&ziPwViLeu|zC%;!p21Wj6Pg+-0
zjrdA!FPO+N{=>08=fo#v{#fF}?d)DbS@lGQueDt{v2%+@S6n`nm2z{Xt${rizfAiF
zdHu6Qyf4ExC^6K6*dp%F$b?M2L~Q<>ezk&Dbhq0LEdEl^S*`SJKI3|x`$Nz%niAto
zm1#(cNr^=mBYXvg_bg6A$xOzs|1wi!pEUMiqHrgpr>eua6^q#AHJ~Q?7;zi+U>^h^
z;I3ncXA=y(E#~}&AC!h1V*zQnyz87f9=92g5O{H@cVhDQCHfN@j<_?SHDQl%pCCsV
zPtYNhC(y)5c8C%TPZZ_c1YiQS0@DKeuS*4&1Em9okGQXwp(a2X-WiBGSm{_8AP=ZY
zv8)fHCEAYJ;bvpm$o$oT31~Hh8$yQYGG<Qb+2iC56xHuX-$O{ln4wtQu&BUZ=zo8p
zZr1aNEus<>f(7j9%Uf$8$Y2pr-P$D}M}L62E(7{6qJ`*l?%@H&68i8wwf=d!6xJ#T
zUm`tQ3}g|@0|>g%=e0gUbi){+R-#<ioY$VCeF~8xFaqw^f?^?Q@OFq91g5B8Yrkj3
z3Cn?2K@fNZ1kwr-gv3MiY9V>3UvL|;bV|DdslIsMzP9fuSs~9z0ey>}fpV5^zqq54
z+BWAg?GV4_Zm{c7mf@KrQdW?Iy)VSR%}G{#GT?|amo%LMc;{{UR!P@O3X=E%=Sv!y
zQ+E#>rB+|RT@Wq%-y93qK~eyj%s(oI0{&=73jfN`>6!yHl(M8#BXiq<i())hX|Ga@
zcdc>3ionQLo5=kFWpcU)?r{;4m!90$FZ;rxs}daMVTxe50hkk3?$pTF3wRYDGR`Rk
zS`(vIu?upq+MgEV6`ErJ4L9LfLVov;$OC>!?N0>rnmXRB*Q+DjlOOv{oYGUHyeEft
z7XD`|<3*?=w`R9$B)yqW2SJK`zjhr(V=DJffXf_cMOTsosQYUBR<{UKI}7lo|55)|
z!fU*o3!M@0W<JR~b|{k)cnbL$e0vZ2Ci{6-*I9DsxRinW^FKD<W=u4aJEE=)UvkI)
z=p)Djh{fYN%%RmpPc$GNXU@kF1{vwUy1{L+`cTS76LLtn4S9ew7IkQa0HBAE)n$p;
zskF*Kt5)b!hy&#L^(BEJcOWN_7|3@>HbfUf1A!5c1VpU0D1;8xZ*__!L+x29qE3-?
zuN7|*kN}LL`Fq5BlqF&m<%i-jagLogS4daLq|LsQ&YDq@DUunJsj%cXud`Uv>p)VN
z-yIg2Dp?%ud;j&zFzZ)`Z(FUBb6b*?fym7s^I=Kak%?jKc=LozUmrVRm8^T}yoSec
zYkIXOA<)njo&J~kU9;(Djj8RmKNHV&v&$NNGjpv9UlrcTZOQzaO<Ne6`K;he;YO}y
zu6sUfu|u&#?z6&}^k*3p=j{n%<DaB&RIOLRe3a!;I}j1*AA)z*t6ZL3j_hu{ZLLEo
zPTJlF{nV+(S^<)~pfi_l%}1j_VcWd_#X%F8IygOymC_9DsEU@i>sIZ5+&3K(d>~Gl
z+>Pi0hJF2%>?Q(F4S-D7*cAZ0oc=0w6%yDExIQ&zhV4!9^Pyz;{3+tf)*0@H3-IK7
z^70{eYABzPRiN*ZC!EM8a_YspoR(ASorP&cheDbLP_k{p3d=+a=TsV69~FMrrs#2>
zL$P;ZX*3x-nE$-1t*bFU);<_{sp=qkWgjMa79Z#c^dIQG;s3+bcLz1`eqV>CfPkSR
zy(&mCbP%Kl2%Qi}NPv(~6Kd$ah)Pl96MC;Af})0AM5QTR5_;&xf{GZ5G*Mr^GrvFH
zKX&KY-I?9HXZD%d=iYPfd9z@%pfpv1kI;%`nBZCEbK|`%8pKb5Y3TF!0W@lUN`I18
zkj6<fN&l<ytNA1SO<JNxN_wcKK)Og;p=Q0t`rd{#?F}7Tz6gCicLm@QTqs=F>KJXS
ze3N@ips*@pA+!g?RTc}+ddYp0|AtB*W>6qom@;ML0DWO19X6K?Dtz;U{ccL{3yufO
z9l=gAkEVSe>*@jGZaln%iCGWr32TvbyrP|ljQ8KV!7Pk^6$ks4r`OU`9=JMe1+Bdl
zCNYD4fil7wW&Kwy`?l%J$(=igC%p4-n?6BnkkZ%#pD*Hrv>aMLt$<c?&dZwkwIJv$
zzswE^aMX5Ty|BUB+;9!QAO7z*gP35DFu%~8PysNK?2%)ez5S=Kskzxx@K1yI6Ovow
zV2%(4fv^E*IM=a==aE7iFA>d&EX2`lDRS)Wk=q9oHqW~2y7$sAhP6Puow~8zwQ1pL
z329+z*!1=&-rg@uYRFu7fZ*qh5zJ-f=+Eh4$hKwv?WLHoTWxrI2^4Vr63DN)2z%5r
zbkE447HKb|tLVEr-8J5>{#&(zGly%F_ZsJayg|GL+;iN1JYV=c__%qdc;`4>cVB%x
zNnyGn8GhNK3i-6$HHan8>{W2)GYvSEo3$qw_w0c)qOCz!L248kg*m|f_5U+?z;`8d
zXekBx(Xir=LKZuJDPpZ5x~lx-{^94kcKE~ze}RezL(Qez>*IUCmknNs`)Rr{7hhs%
zFWb(7>Zx-t-G6=8v2u@fzbI+lyYa5){pe_;Y+N13i3mQL1(P0MpO9`hMphEm6UuC@
zwa(}$s_Orb5ESuVWNg~pN|He>u}Hn&jIbK62h`xy;L^KNN<JGM4wPhUxnI=Ue=QvF
z=!%`3J>CT$Ac>T8-axuLSIZTnFN>S_y%16oIs}Fi%=^vzzV~wXvh;$VGgZ4ZEAepf
z!TI2#@A;*=U>>2{dwG>Vgub?Hs`aS(sL{3jZt+v2k-mU5N$Q{hQaLCIBnMg}1+Rq{
zz%@bDAQ{qUlD)VV2EG-T26M6djBIm5qd%bDxc#-eWJe+6h_<98QUnIZ?6X>FGO-=D
z`fsQ6ugnd{$Q}g_llot>QEL9i4sH%kN3|n{VjL~Yo!$c+{pyM9abhzyN>@>$4VlwI
zL}DvRxu<3ovHv$9^Cq;Tq3~is9{b;aXvy#<gLe~LQQ}erart8sDdlV1w(ebjX{)d}
z1k!Fjn=AcQV0h+cYeIqDcj!MD!tNhb2YLh@gytjB@Cd|J6bI}D{Jfz#>?$JAdDgkj
z^@a0_{e_Ju{<-N>A6~3t-QO{lfu%Su@$LTv6-sA>jQcptbY+dn`OThU=nDAf2bFfg
z9sgjmE=$ObtKC=3(Yd{T>O`NYj@R6g8lf$N3A<S+UH5N#)_TL-f9^z$KQNqfgEjg|
zKLB_3bF{Nw)y@*kQq0oLk|e@F_G{{u7y7>lQ+hgkL|<U!NeIyGtUu%_*epudu`X^+
z6J$vGOLQT|5k<0m$R<<zh;r1JMV<ee9_Umi*>25293n19G9sChjM&UF<ouG%Lr-Q@
zcbqu?g9G1E{I6xj`H<8tE0tX9-1r*6{y9jAHi+6cq#Lb={--Y~PM_4}Q|V?C9Bkmv
z#WhjfV9f5&*1tzk^9@0cFK5Z*u;;sGiDWD0@aDwlEcRJ0#jXksjLtn<dNBHG_SMRz
zA?Klz(Pu-J)4TUIeR;E-za($Ju91076=Pz)JCv3k<hiB%_4z%qte;kv#y#H-Eul~M
z%ly0^A~iXN(kxO-FJ8Pl76_k1%+6K1qFuj>y2ErKsnu<=<42`8Q?0bbOTTnI+8W2*
zNC0|E^$ZW|wjptWtZOZDr>a8D51I|%kP6XcG#yVV<;{}Tnhk4{<wEx??+>eArGYW`
zc+VOz^{NbwL`9Ffudl>yrTE(ZWIL}6M*lU-*!Vgw&MWzi<WAaX^lo`bWGY*n@QF##
zVXOYSDfz2{8M<Y79(cRBkoYBWesN`S4F;4?mB;#4!j{g~zpdyku`P`)^(_fWZizXG
zX30hIXA;9w*Tf%4JdlD)nM)~3{wGx-5moDm7wV5+lRvIS=Fck{l3`K_wH}g#s%*dR
zz>lwAoha`4OW(~f@QwNS`@&$))WFt-)&${y<Sypc2;s_Waj9WuuBpafV!ogUqkQ5A
zZBGN2JO(|!*gT1S;&h36&2-AU{X%nQ>tB+I6sI`$YwZ?<4W=jhS0+Iw;o@J#ztB|J
z1Ij1ji#DZ3thme9o%N`9HMYDn>IH<vEumQ-r$U>Y`KczmLek~TbKOEKcC0n*S*SRb
zB?>QoY3hOtTXO5p7Wfx5ga4j{XQ6lYfc!KibR|jg*NV|2aj;O9!coo)J#+H<FDFe`
zypt!ua=io@qS2PyiC;JN*0H<YZX3dE^Ul|T<K57T>LY^AbroVL+@7aTnJs*ld!<3s
z^KB7(BLo{4VDy=)EZmnp98P5!$wTEw<Td4^3ceL&<_qS@4RSY59CWR}R!t@b<}WW_
zaxk@wV_;5Pmr?a4F67CO*(pqux2V7Eep}QAo-s0~tT(Hw<O#HG*_qm#x_JAaA>*8N
zow{A(0?Z}z-%)vP?Y=qg#m1k8iG&3GOBz-u!QoBjITA+s93Gg5RtTerdt8baE&f@1
z7NlGw0~!o^X7B2J6Ur8sd3VyaKioaOQ4}O(j9THuNZ+hC0WquVJ*6{xX0?W0p?piB
z&Aasy`;c5}y&LIup3E+;rp7R)YZ*8H3bfNflJlcQ8c)B8dtC$z?(^PNnl5=u8dj{H
z{Q{-@u=CeZfLQztyAVG6l+Q~k>ShBVuRhd+nZ}%(w$1#L`7!e|<|5`lVftysb#R4s
zzS2y4c{5YT6xZ`stB&5tT9*`;6m*<`E~eY(4A5<>i`CUVv()v81Dz?K>2`z8g1U=i
zOqUv|wt_h+dDTQih5!Ke<jJwoU09dMsr2csF4j}UQ<w>?nDPnu^iXLR3vfC4coKq!
zOc>pxPr^F1Jd1;=*6(qt*Zk!^=@}2jm|?&b75eG*Ez7608tFyxoBNRsLdGU)fhPU`
z@Du7+cj4iDPx*>c2P%f5`~L})eu^@|JWlwO=;ePeK*pUZt~6)D<>V!k*v${0ppQLo
z-ee>kr_zt?Dhizr-*aG!KZV7hPK|F0-*se6J$X!@efUSrV$=j?YkluDs#?MQZG^^{
z4a*S(z#TLrQL3eqC=;#rtY@BpV6+$xY(3?*#+E0Q0r#U@redU*sdU@DODDzV3<K^*
ze5Icv@0|xCo#^Qg4)Da@^>g|Z&>;h;-F*eL<>s3GWsh=|j*T({eA^ub@^Yn+-Oqc+
zdrz0yF}Ys1WsHlunN+pA&KdLQm4>zp%LtI$0}m=Kw_zT7>>Yvk%`L!1N8vMg1=?#&
zTII1=N7x6N5heoq)YOq!;AeoVcHctuS@W_|!*niG{Sir9NSanLCcgr7`}~4Km;9iO
zi?Vu{4tTdOe68d#!U8&#(DAOHb8^f54WQ&JcR~lt`{|Tfi<#`1ra93$j#=NCnI*(l
zxiw?J@pS+KkhJ>?I61|RI(598prsBl1bn0+X^}LM-B_R@H|t!UGs;5RKT0QQJxUfN
z8mx?hTiD!n7=U{^NW%w=_T7cFxh00P8|AVLwn+yZ5^RY$x5aXlWAi=df<&{`y*!BK
zIv+uP!Ohp~)b`YT1iI`tZufq!cKZDs*X(`u51PdwEXIGxQrPWKv&~4#?qoDrXVS5A
z0TiWWW1k{Mdbbr)Au*c^g~e%LPaALED6uf?V~sHIKTk%%^($kQTIY4I+$ZQz7u9`p
zu|ft9DUX4rn^Bt>k9es>V_y&7N7y^D9hPmrImW8f&?65`Y^(cYk4GN17|igaA;Z!a
zrG2FjO79DA2-gX}EJYu}@4z~S>!zi}YDA_53{_8R*KuxFE#EzU18Yys)DcsBTy=W&
z6Tp~->Dr6gA4QioQLnD5xt<ap-+T|>gZxn>ZaNR&Q+FyT;4&b@E0{R`BUc}OH(HqP
zvdyAID_)S3Xi7XV<CUH_4=|{j$2l}n;k!K3xIJD;5d#mScWkQ`_7z&(sA^?LIh2tt
z-&+S)c7~YL7Ie+Dsf48#<exIvj~P_0tp;;X-4Nvc@gQ#WcuZ@k@ZEm*#Whxw?!bmU
zxm-kU5_R7|DU?m{c;<G3iaL)0&&PRZawJ)VVrl0FV?~rYJ6QnmG#%oGm7rK1)Culn
z)8nuPH*n~Ii`(3MqcP?F_D|Y$J|lOd<F&PC^AYcgD(+4*Oc*anHQ|h6H^BzNGal@w
ziEtUN7!_sVvpdtpO<EU=$qr3qL=4$#)bjZ;v<d*TILzc{e2~+fYq*Xr1OPJtBFD73
zy9$TJ?-XuDU(B9hXE9Ke(HK-QdQpCq3eaz4tXQpHn(Guae)`J^jp?(T+%4mUfcUzy
zkY?;y)2H8-j)K8lF9l<Y1bmqQ$?zx+4MZkqjD}m={GyywrPF#<$R~ro8nvQKw9%)m
z!*W}NN`C^3qz$}74ubx56t?d$!?@F&2&_OyqA@XoxJ-7U{DHMOO1lbJC3%5ZB9DSd
z4g@orEYXMv0U7}zL^`yd{R{XGOvy15(FXUnV}U)i3#B}xm{2w;>l77AC#8XGK}3=e
z7>^{UEn5ML4#=$%(;@CfFJLRi$Lf7J1}!7d0FS((B*@Tx9fzO7xLnKm^`Bt~)c;hy
zA8t!m6DQgn;bI>uvULw^ce;g%5`Qg^eoh=8-J>D~zepKW=(R-wg#DK}*V4icovy&=
zp11Q=vCC<-^5DYgD%NiwxichC=I!Pooqbw`Y7P$$Sgzo?*UOovU2=ovpu1kHDZ5^!
zs4yRSZV4cth!kw^SB?YW2uAe@B+l+oHios3vyQ|vE5m_~i~750o`;yyKdMT3c&D*b
zllNrck*I+|(8+8w4;D@brt@>TO2m`QT5q5tcd2#o2G}jvtQsG|-{*;oNQ6yg1vjuU
z0Pq6nZ2;60rXuH^`|Lab!u{NVNoHWMd4Vmq;lmYJo^z~zcyI}=;?sS@cfgJlA@P!V
zR{+^R$*yCxdaXcn-G&?__~P9c*J`@bi&pOXpntGB1TdL$sQA~odF9Y&^^XkvXZBK$
zOQnq?L$qlz8%k7qMwOwIoNIT}fgXCo?Y>;+&|*h=bgWOwfyVt>+Oxj~@Nk{2_N+6n
z$P%dRR)|?OQT=SErZk7f7dK{C9>~=`3MMhN{_$$zVYoGQ{}yuqS|ai3cBB~Sg6#fy
zqkrXutiHcBkNvj>;guj5=81_BHTiC(%A9j|tXtvsIPGmcpqD*6tKuhF<@<!Xxv|4g
zhs5m|6*=iSjK&<s6@B@WNxOw!xuD%W05*!lWF;!N!0Q<M-;nGX9lpW=(o!la#uXV>
zj@+^5zqoqCSl^ubWgeCCSZCT;3!AYdBHke)r63Z#4N#M&TR6`xGwuE7j^dcHi02Ri
z-#2Q=N9t5(vsRz?onSOd9m$sbm&-hO?xOQ|=nXW|`#){PHZI;Ve_Z!yILGvNOQdOb
z{8u1u#IZqQUMh1fx8twxr!?*W*p(r|6mMcVm^1uL`*cCz{w=6I!mP<YX8PQQ#mQ>k
ziE3b|L=d1FgssmT8E1zVDBFvXX1B@=Qu&;Wl*Dcv8+1(AUHB|MUjWI)MP_5mC{Sb-
z)FpSu9tRXB0VQQZnsE8rkl^7SpP>80DmG5lYn_R^*FD*CkZp$U2)+}A3!t}=f>;6N
zr@c0Uk0(7^#HXGYU%#_%UaiZgkZou;oMo71B>`_IOi6Tbeyt4=c-g%S8`B(e7uYZh
z6`+CqJ?R<OxCmlTdwuF-PzF}%XsiEz5^{2^D2>ahfR6|yC)(iYeBXOJ!SV9yv|k|I
zlcvaR{kbFZ+|lQNI<kCi;dQZ&`vVL6m+9>m#O92bB7f>4l%bNPL*7Fc$*a2b^I@9y
zmqqsEUMz~;r4*S37x^?6C9Ze?0|YEW3>xO-ZRvgic?epF4=Bph8%fXcr@>gb?UDD?
zqK_)yAB&8yMj+hJFl#{E)Ca|>50Nf14dPW8>NBb#MttS&N#*0RE0-lH8#BZ%o22Sx
zQhUpmR5lx)bV_#`pMZ@;TOTmYX*&YTf^qZaU!bi09iO7iC!Sgw1h@kGTsea+HiTKq
zdUO@Z8aM7n-JPG+q(fD3QUCsM)RUUoWa9dg!|O1cP0q8ZnT>g9tg4kvH<WhaW@v|^
z<68dATD9Za{LEVYjDEVK{y~&$5QM{ZZ5s;Q#%FK#akAVQ5UJ!d>FJ0K-;1cT<lT_n
zOOF#IxGpTfXCHi~cbeJt{t(UQol&v(@p!bGaB-*J)D}eD`4*you$K=XOAKD4?pz4b
zpE-V<wC;Qs`jIj41-w}WbL@2S1>j=+P{JIEK5Gmu{CIhCpZX^@X{Fi-#%3#eP6iXY
z;Cy^9<mBSsarWC1zEOWJZ;{$jqLF*#W1cI!TF(t9(>HsLUwYr}4OUsAhOXopN0ytf
z^i?$j^KCDD@XE;-n0n$|p|t)z@8VEmVy0cDeWqq;aJofv8c8j+N7)+&)&p|#wV-a(
zgWlezSJg_%$c}+L!}1EqdR#~Hu+CRkU&=ux!ySrzkA^*26z5gjG8wX-@v@PUu@Yc^
zUAwGG!wPfL@4L|zKLrtEEI?1&p1@Y)s*jZ<S-S058%r_ss35Sz!fv3mLs%xR)JVeV
z%Gbx!ADoXkZUqMyR<ni%hqvGR0Zlt5XM`5%1tSx8V*V?(7Xbrxa=>8^52r`}!<u%T
z?;%{vNT0xC2`69SIqhTnyy{vq!Gz|d3<&MzacZo+5d5%Eu%{=j=N6KoS4(j0na4J{
zFBuqdfnW@FSiYiXY|VZT$tJWL+nZ-^0}~5LB<%Djr6ZPRW;v9%X>yK&s=Gq6@~O75
zy)#-%k&>m?H()$nMW{>|w{tS;V6~;!4dpZGmjhH2UJr|GQrMg?D8YYL*xc28tQ?HC
zjq70HsXUW4W>eS*rpFEY_m~lq$M+(?QLlHKMuk0g!e8_sz07pV<ACmUKwoe`6Fzvl
z9g|ATr$QrfItt9c!Xw}1afu(jtEILoy!Xph?guXht(Ey}Zp-BsEFbt!d%nKj@kLx<
z)pnx4ph>o|jw0|c?Z~a9gB7R{59j%vb!?vVP)Ym=ut7iQ=$hR<l0&5uKCgf=D>W*1
zTyoz0YW#naRz%r5I9p&BTD@UU(5`QQ);E{VCr~JJ7WRsn>h-=)8WhVFcq4V!G)K6r
zUID*itEBJF0ngN?&(|DpMKFAc<S>~NcRq@;;7s^0_~x2hrhwp>5|W{ji?Pz~9sWt1
zR12T4(<Kl5>ZgliVwew?w^Ds`iTofx_l(}@qtI-ITrP&c_6!sBv7Zx?6aF1unLcWo
zJ_-x>lMcr}DUf(>n$hDWZinkk!*!74#Vv4EIPR5rGiJ4Cn#@n2fz#8AmPcsy%E+(=
zP_J_B1)O1qdDDNR(-5P$z_Lh0&g6QQ6=_Qx>&`RCDOpifUcv)ft=oJTScX%UZ9Ir{
z`0TVrhpgk9Zb(2|y2UVWu6pfYwvbj!80|LWp(UJjlxX@4@&V>iNcnw7O1c)?*v~9n
zS5(L{vlwbE2zpLk_U{6$`VK(Ke<6C5toNc#RbKwS%{s2$?nYFcCk5tIjOPoHA5aRr
zqzcb<EacR=VP%N8C-HtgJhc~e|5=`U0p(LiADph#GUHJu{z)H+Kl{x!H{OglRI|iZ
z-1qT<ftBt+_$i!Cg?PO9wb6+Edybh@Rx82m($iAbe`Mez__@ex&XAJRmnUed86ZAf
z9kMCE>bv;;71`ZP4cjK!$7pjYblJVeO5j1H3%e)E&zA*8tq9aKcdaAsNfqO)%|zuV
zqer@NJA@s_9ez$dOS@}GxH|sKd&*;11@P_rGQS2a6*PR?w*6}8ca_CqbhzPNxAKD^
zkk<uyPq-uW+Dh&|jfny>t0OtSkQ?_TG4;+^<V_fyiL;C|_8>6Da|{C=u<l-e)MlR}
zv*_d*7`5#Oy|_$@$<DQ3)3Q7BuV+)kxo&lA&bHv{_SEd;$0e7dgNZhCAEJYq5y7r|
zK_Z`Px(qi;O-h6P$;cu*QC)JR+i3Sn7NU788|Mgb%)qvmg0%yhXZuIJEIq}QeN}AO
z8#%RI1Pwa-Y;LU}3M_#o3jlcAUl-90;hdu@TqMd*fzHTaqA<N(%nQ!su;7(t<#sU$
z!=QNe^w>?SlI5w=jxaaTN$ygl1X^5!pnO1@7B{ugWah3=B-SzcQzR~U<`38%_?LHW
zXW}2NzJ4uy&lls!Vp_atzdwr@y^^jbgu~M8v%7!L1BJXP09pI(qSWv1GL>P{Tu)uv
z%P$+Q5dCK7(TxPZF^pBS09vYa8s9QAbo9Cjbfj5n7q+0ugpxXR+dNcHjje{!4WVn2
z8cR)YtZCg?o4HZ+<7JQL%brKA5<Mhu5(qD-$7aodaBY3^JXe~jHB?ab<<|8Zg){9!
zPjV4@BAh&RqA#krpK<lC%$2XiPmBC5GqY6X<H^6R3Zx<^U#fa~qo#EY@sUnWoY~Mw
zNM!A9=1y_{>q0lnx<*35<XLw&MeB=yD<dzT)Vqb_L=^9vWWQCUH)$bHGZ!|yCd#>I
zthaa9!c@RB98Sr0g&VI|ksj)~T=#e>zxOlX%}dBa11O%e1t=J?tf3%Nmv-w_rsb>u
zOr>T`pWk<(6>RnEeu+G@w^@sDX;PJF&R_lL9OdyFAzaF1w}E3R{!qUVvxl&DTeNng
zDY`A<7hG$CHa=fnXHM0z`U&G6V|n+U?<MDJvE%+E34)(B_QH+ofc3$@($0rfV^6sJ
zXoUv&yRzc#yTb{y92B&8^X}XL14tS(-J<ywQmV>3gSh=cWjCYc@L%6_*2pcQ=9NMY
zMnq+BfY(>{e1(%f(cqC4;|AVzH`*^VXayGeJMk`ajWcd2l1fpfF1>W-D!g!RjJ4#B
zlX6<dx+1E7^p{5IsHE&T_7|r9ftz4@v}g+>Q8w4dcs=9Y=RddGeK;wYt&#;~-bnqZ
zGx|CB2Zz1XjgMdM^|jR>Hv8WZe>W_9&W2{`TNt^uY7^Pc?x|d<4<=>23N`ChF4U$O
zk7!vdlw&jCW1M^v(rm_HYRH$LGt+l)t>W6-CPPwxKi08r?Tf!}9vHZy4}SF%{9k@Q
z8T6;XK4g6tAi8xbU%bxvWL)_g_^&~R4NgE@g;ch;D9krphPe;;_(Hq%&hw*7qHW`4
z_P0Fm>v$5hx|2_K<%JH1%N)w$?!#EESP38J7v@yG4qSh+?8Wcn4`1&=_ty`RhgKJA
zCRRcaFeYiVY>%yLg>ABK9vA5`Sh#p=@4l}7yc9}*ZpIjBV-$-5^||xuwrj;A>$U}7
zafZs*3CCD+0Y2L5-fk=PT<nct5<I-cUPruj+5GTc<*VlZ{woZ7G!hlTGfaQ?%DdPu
zz0fZqB6FO75E`jjyWiQ^JP8t>Hbjf-s?>Sohn_Cto>|tOQL%a$$uOMpqn@V7Ll9$R
zJN_P>@yQF-G3N2NRWon2i~~#dWO8fnF8P^`YG#){9ZjXGe@sssG!>ffjnfRzPbS>H
ze+Qi0ksOs&dz(2q<u+JRa6Kim6Gt4;4&B96B6+rQ)aawodim<c#(}piuL}3pZwbf%
z?XNFqbD!ajOdI;ePAXB$6C}3hd35{COw?sNfEJUnk&oLe*PM3dTzwG~-@IX^!N~Tk
z#AZ0>p(;;w`0$a#zNn#Et;jX;UfPFt<l8T|EZju=%AkCc)V<DZExK_PrIRdsr4KB~
zrvftkuBpx41)i-Re}3%t#CfiK6z{_ZmwsPMJn*pP%jT|xj_};qvQWE!(L!<rfv9zK
zXlN)?Of1=X=SJaD?EaFh@V(QZ&hY3i_<48~=;H0lQv0VtnUS3#<PV`xLw`PNWz&)P
z7z^o-ty)%E?%HbSe=SnHrqp<=5pK_UZSd`MS{04%$dAj9^AYg7;Dz~RH;XU~7NkaG
zs5K}zw%JXcY`@Mu`bS0eE)2Mn^`b0gEnm=bq1iXz8U7pYjCh66fiEV$M^8UL2#C9I
zW)+tZhl|6Vaj_UN|6_r&FfcDNXR_ollbJhMlvtKnidb&2+_ta3+F<k%_7@ka+h(qQ
zqW)0RQBzrkd0fK(hP9R#Rc7Jw@)!Rs%wKC(!9w~1`$EYA!BU0=E`-8ox9NuOkEt`6
zo-*o#`)8s)tx-$*<v;UgemkXT$2rEeu&k`PuZ3&|t6k4k@70M<VL3};xnz(b5xBmy
z3D~gP=w5@eEE}xjO#WTH0R3&J-s?5|YuL+V#xl<~586k*4b<8XqaDyar27c)Ier}l
z13R9tW1%4nd-GlMf{WElF%)G^0~!qwb$oxG5iNNf#be(v6&1%w=n4*ZGNSOjGSraB
z4k>L+`MkT%+qV!7E)E<pJr1Qipc(Be^7)dB=T!B#zqtH<n^iaEj=t-1_i~hVR6rER
zv1L?3l*chHii^$&utNu>qX#SkGU>JeWIzX<9Ni+_ce)#NGhvQC-$OK>D5vlo8#9_6
zJQ_{+P(LhI(H>BUiU;uR3-l0se3x4xU9gxqq|1C)cgXo>+A9CsUt?{?-uFAwgl9cj
zU`lz~hm*;*@O9Z}Vxz>yi#W@~4w#A(eDvu`{|!1N{Vr=|Zt1m!y~0ckSZ3teJnV9C
z#3!*YUahb0a4^fXRE$c?h!9=dNJy`|UX86a2c1Rq@jVuAQBHKU4EF+CnMBU1Lmw=d
zH~#SRn%YdrTY$>@JC|4>YS<^!cS!8E$Up?XGT4orE1)$6{ydU7>*SvB7#@Ag>wCfB
zm+M7;JVj_l$sVkiS2+6*4nHb77VZ1yox;1|C`2*hCj4gNKtvfHjS8J!gfG^o-lUVD
z+oVeYybr4d{T$a~LNYnexO}ltb!_NLX5<>cfjN`$^eR^DOJ<Lx9G|OY-8g|HR^~f5
zuuQ(R@EsA#$_FL>q!ndq*yk(?3mk*uPB5lArH;L$Wrq3Bk(Dn3pKv~z77+za;|jr(
z+64uD4+{DRS0jF}5++u|d~CQ=ZMXvcS02=RKB!0g)en{i4NDq&BmkS61R$R>v}46)
z?hC3dXb0=aN4tE5Eg1=XEa_o2m$U=Ea{o7_JV=lr(lZ)`BzqX?_7VE<^c?h;9WKGf
zG<tlUj!!0^x4>`PW?!ZLc5gvEO5ld57n)*zD-ndh+Vzz5q_%$O!R3VjVF|#d@qE3t
zUl|TzFTJaCHOzk$VmZM3`fS9jU#98@gC()Tb|KZDG_(f;fIWVHx)$6?KZeDxmTviq
zd=2QRK+|n$(hXYFs^?ROB^EfXq~n4wT7)~Y2^%+N^z4fhXW6uJ)~@6##O=pM%5z<$
zCaTTOvZ(=N-hFXyV^aa8LOV*9(eBN+PWGk&I#bc`EypCCNkYkz#LR5s1B?Fm3YHRX
z8T9kVe>qb_9tdxxh9+S1<K`2wT)p;z_VkhwY`VLHkmeGBq6k{ZMQrf>X8t*yC5wRT
zEw=e=wSbZjiUBuUZePkdART-QYtB1Wudrfn;)h1+r2G{z#ULa5)acddndrrh9FJ<z
zUYFz^!)~ztsaCJBR0fY|$I#0hv<O%UxL*PFjg3hR`ro=hA9Wxt(9jngc9WlRs)oWd
z*6DPD=!8W_8-*PB3($JfgNuQgTh~LalYQAMcvopIJewBm6@f4@)?ESi3JaZ&Q;f4b
za}KjL^V+tZX3;jts1w6zbEG%Y0BLoScm>mmi;nNab(%OV3Vm(X!wDvR|KR-^86WLI
z^}Pa~G`*AC7fc^bA5Ra~yXDwoIHKRO#JJkB!ZTwz>S!i)*Z#3M@5)|ZjrNc3KbW2K
z=jk~N=dL=uzdLa-%tP4_9RUVMz78#lh>r*eXNt&+EF!S>#0i*&6&ys-U!~WicRlgx
zv>PCQ1G*C8`cC`2d)xYI`t5oc1UL@}Mo6Sj*uV3rglS>13GK@s&=7cUjQ}MK?CSnT
z&ftG9rwyTJ4m-Fa+}|3!z~woDv^()hRts|pa}7!fy*4QI(EW|<o&Vj(WlzQV>nqSa
z&TsJ>y7~>}sJbUF*h08kVDfyt-5*R~50?lA-qE?5>m-+9mVjnEu$gBrH>y<Q-Gy?+
zJ9#AF4fdK9VX$9Z34*kRD@{u!hU#gYmXqi=K4y-sI4QrCjYhdQR_cQWEu?8QavCVE
z&oYgb+V%;oBKOdH=Ct&<sgtd>On~jWim+GMNt+wurT#CP#UvuTM5+Z09z9!*iY90W
zC)NLCm^p!WIu;?2h)#sIe_!2m#Fc`B#e*sCHqS`EoQdwdu*0wj37qkIL{jg$?p%=T
z25fCOLqvWx#Pq^#T3*_2iWC+4WJ%^wIWD&a_8*;A;Hg>g6N;AgoL|mc*b}ecyAIY|
zmda1cug<Z52!VB8^F_<sZGQ6%FzA{T&zU%IuF~HU2tap|d#+b~<*pWBpo%oGC(+b@
zT+6%7o0ojw<;!D4Gi=Krq|RM6!x#k7%l3-i+ObgSl>)IfKg@giCyzsZt}!=Mz7g!>
z=(Kb@RWRZ84WFw!Pp<C#{?5Wa(v*;_D1L9&M8ZT8W*Vr?eU!-?ag~baR=t(QML>QO
z?ffWO@KMzHwejj_YId?x@b3)+=<iE2;z{|4XC~6}@<`a0aL!+|+BdJ9f{iWx%e~Bd
zni`Ki%Ft07K?}Z48!!t9gDW$qoMt(UbAo)VMfiEf(x<2JpDS=gEv+Ogfe73rP_GGn
z?uxwl=}9xy-1}c1UMDTorR3>}*UY`(L6hSrTM!x$aNz!!1MK_HWg9$T$ME;nY*{I%
zbckcf>+mzK5M!H^icg7~`~R4qDpz`IlJQE(<9|^$zgD*kzt<WSTAuEu?U2Rl_$De#
z*bhFLYo-t;9#>sxf?a$Y%6;*z<Kr>H<HgCOBp3UIqxabyS6_c%ij)5QEUIO53mW5k
zo%nZFVpRFgfhM!g`<#%3wTy?#)HwWB(&d#T4j)&J|I*Nz6DrV<hv6p#^|t%APq1|`
z*~}xOt-hE&h~CDvU;^zvA5&OM;<M>!cyx^CgVO^RfrH-Lp-%-SQ}GtP_XssxZ%{Ux
zf}C6WaEKVjAF?!=JEb<+GBuTCdtiM4vB9*Tb1GZYb>_VUv;=Nmp(N|?0FPbOxiI7i
z=hUFp+eyZe5+h#^?`!<tk>}d6qG-q2cxyf5BZ&F?&1_`EYBBhdFQwh%(Hgxa6w<2`
zoZVLkR%pC5dMW#hw|fQY^ogte0=$yJOwDmM(-NgZA^aIAb(Z}FC5fV<v`D|cu{kO$
zzF+7E^&ZownCoR-(Ovh~$pshug@s;&Vrh?18P^kZI<Np`S~^OXNROd|)3{#8tlqjS
zZ#DC2Qn+&iUBXdE3?6<vY0-g?ztK)y#ts5oe7tSg^Wv{Rw<R`!o~r&3kBaQ++mrqY
zt7Q8g5w9dEq7?<KCAGkJ{-gMp^pgG<mm(Uc$wAJ0tM>)e93>C7Vfo)8m`5&Iosjka
zi#d*OANmfg;-relz#poQ^?*184#_<Juw$R}88!1H$$w4r?rM|iZ|B2Qt)Xe;IUpC!
z&%pY=o$bDX!x-;3!CjsITuM0V-w)U*3kxJ!$~4DR5sb5p{yEfOLg%(8^|sCJ^|tFA
z6hv0$XD=b!=<`aAW!@4Z77PDer~3|&{Xo=4pzLH5gTH23sDeM$>I~i{c-hgPyB-*s
z_0!AxQW8%pS1f@?o=cO}^j*$H0>c6#%V~3mer}N0!1&4YvZ*|2dz679=j~pVq(RH#
zw3)hx5OkBap7%G9?R)3g()cculSrn*icxnFQHg+C=he1PKsTTdP??j595Xd+7mYwB
z&?}B5_Gx<3w_PV>wGUaVS|60_&Xm@0E&^Q1Uy{s1(EtMjbOjs6|EMAg=a0xKy<`K>
zlH)ccd3CgT5rq5=jnv*HBe+nHENfF71qY~kcgLE|pdk{H2ciiF^^mXBBBQ*7KlfUy
z&`Az4N*LV{b0uQ~0ne*lau4>y{w!9$Ezk?Y_2O^$acSATx!P#(Iv@LBc5}@eHBe+c
z4*nUb<nA(|MlENkFZZY~4^|TWoLH3B{%DM$vz)$R{3Trwr<B!)aGc>$-WN>;x32Bt
zl(qRQ{`RM&kBrrd_*ao}PAqGJf834&)Sglt>rg+x#<&Y2eF=1gMS>uWfxt#n>C^4c
z<U1fJ&{PTY1PNNM3C33R_GagO&%klo(VdUcHLu}<pq7~9xMLJBI45Oti^5FFox)Kv
zCX1&Er^3jAoTZ#yoVWZgN_rc@tsR-*4-vg~qU3NOgpf}QPLk=-O%ey#%|oTF59~Hj
zzE0VQY-on_BGeGNMAiZ75NwmsT8=6gND42_RV1P8&@+j-J*@B&CoLFYaqOmM9|D8g
z9h~c*AhafePm;5flQfd6PT1`j&iDjaMF{G_COMUU<85&iurdgwu><pApIhtPf~=F6
zY2P`8$>^!C_PdJyV1g|H#91yia!kyHIv4_NW?je^qL8;Q?z@#_LX%Lu&-^<Xh*AOX
z1&#&a!gkW5A7SM=iSN$8kW(~|X(6-&Ht*UI(Blkn?LjA*IT`r@F`NoyNpb^4m#jk0
zC8v>7DDe)w_KmP17~5l{xjSWgicE>16i&8H*-hzAlBO0YeB{hY_bJrm+4&J}YGle{
zGMgewnWg~k#X|~<*a^`F2>?2SKmgW&#{ie4+{13bXAldxXtqthPAP@fNhN%vlu|e*
z=cm}Fu2M*oUF7^)+bMULwLO3=2gK39Ntys;p(CS%1&j{*k$ec`B>aB}(#S{W2&z0|
z5)O5L{s>coq!n{=QSc6u&I5)!ug`3aixvHEPl$PPy<FoEXc)g;^N2U_gSOC%C(QzQ
zo@!NxbMd^^F`N%yvhjTXKc|)`6gl!v*~yK6N*Ks0(`(AoPq2*uOu(l{pB4eEp8N{E
z?|j#y(6J*f36_L5FiE02XLz&%QJkPDDk2-rXqq{QLj$dVdYm<6R<bUc<Ge>p?;8+0
z$;IF@!HO0{xJZD|umo>{7fp!M5V!?w<+K3~1AlUU0`>!2I3+mAoF6&$IdeiVmv4m0
zi|$}Yic{}C6a7(FuZ7)dl}{~Xt{s=JS~J^M{A}M}%8?*<e(BUUj=0Hzl=D^^E!u3H
zh#QlYQ)?VFsOI6!pMp<zOkyZulnaw<6wD-Ta^wGy_CH5D<s9h);AvGAzj^6!0ZVax
zg?VW&v9dj?o!DO4e9-1XLc~P+@CWeQb5o*;#J0G`I4PPGhdARS_i9E`rZ^AI$E<$F
zI?Uq;8RUBBy}!{dE5eGwobw^lSZr>k#g3Ij_3b^b_W!15*^#-;y#>y{SDrJv{Ky$X
zSeN6AEPF?(W*cdiYLjmw#^2}2r0ZhU=mh6}yk94Exls@Rg|Cmh8acLgJ2nUCpWy8Q
zL+K{ZFSLAX-}(JlzEHLX0N+`NUN0Co+fy>X%A2`uqrUa{QacZaxt#tzr>YQtptc={
zVP8B);lI2SYT5j!i`P6HG6%Pzl20gulkBIjDn8#^Q{l2?3!(G%A1W~$3mdZ@gIMk0
z!l(0?han#CR0m<hIb)j(M)!)0aqrF@19)-uxGcN@uE{;igsyaFFt3J3XEG+&@wsG~
z3fHV&j@;jVf0kY9tkRsZx!O-)|9(44bw0g7yvbi&#Jz-tICnHL@KC5sKx(?Rw<Kra
z$OL`WV7g{6)z`Bss^v~joO#iSJ=>4Fr}0cu|Bc0)@|z!p78pmG6?n88X`0U^M8>n#
zsmc}3w7uXi^K~)*x=@p8YHXi(rl#=B2zjJIe2i3Sn25N%I;?RN(gjwpf9gG@Ci`ht
zMJhJwcYko|*T3BSD=sYGNqMuE6CvH*oUTi(yL~plrrX%(T=j^}Q}*|WKg}wY1K-X@
zqx2vLUn}!M0L+QP;(6hPYn8>V@q6NG91TiyFag)Az|E<UC(Y{_Sx*fd_gp^?8m!?;
zS-FOLy{|6ba9paB%$M|WH!5dcwU{|pxg-_r^<dbk;Zl8V*z(mjF7wM+w_Byt?l}&|
zDxwkwc5#!__0|v5C;pzdkA2V33w${I{Ay{%u*z*EoX{A554<GKTSKX6)1%FXZua5Z
zH1}*@ij_#7eu0GBtGhq>tE$jOZ8pEEA=e&_8oy^4h0S~P_J5F?fUWcoHV-kpGalo1
zqkrv!Q6^H$Vek0;(K1#BRu*F$ct#1fru00ImG+Qw-mzs|rMQB)yA-j}pVUB-ZRO0p
zLq&kmp;kQjVf93B^Y`?RlryBd+o`$cmi86OvvD{tTmtS2&KHNlUzZYT@JvX`VYY&d
zd03rKd@CW`6WkwM8QumrjN8Gl<N9$$czyg0`~+SZ{{eT9v^^i%+n1oe9z5rb*TKKX
zSK!8zP6dW@PjVacsQED!95eTwos|pY=LnyzCetLHl}r5-R_c@aO^zbkjh)OB@i<J0
z>JV32<7_Fu7uSjR#XrE$CnYrAegbYEXy0n4wN|#-wQRLJwQG@p;<h+rtDK>5;j1pX
zOD_37vjK-tRqIXLe#1wG9&X&mn|2Tr7o#>fgMIL__I1EBjF5qmX#v`ODBEB8E@olK
zSTw*{?XlLS;QVdnrMz{jl+kR!lFd*QHWx%tUCO^g?wsUX7C^hWxNr<v4e<{#L(Cz5
z5dWb-h%n{}<~ODcYlRua>|jqY{g^_m7FH2Ef%V5uCnrJ~1fr=@FmrNCRtEP2t}-wF
zU*8<A4Ao+;gJ=b&<5pQPD-CyH#Em}{H$7vkrGs}rFKO{f-Qn_Bdg=gFNeZ!iH_WH|
z*yt^XtSw^sw%&DE-B|q3?x(Q2!K9^;$p_3UT49@)_V>(<9<03$#a+5?JMX%vKI2Ux
z{45vaeue3`nfQ-!Ca7M^`0F%nh^0X|?uD&$&~&HbW%H7*`hs#*(&XCDd4a^HKnRd1
z16_UP5#GR`V=`nhWCpPwvKg|1n9+VUIl?=jHp;BzoG_I2>Qo$=E}HA*LnXY5Z<^VB
z-sn7dGuU8>f0{C%h+C?Pdn)?!G&*SI5qH_M&Gd{{l_|HKkM?q~pTgiC9uK%feUfHZ
zKI?Y<p0hAbvjrNmJ^P5TGbYn(iVpQv5X`d;mgx-1e4~9HPYjN@R9x>k*q@YU0P&SZ
z?~uI~c_fg;Fq7=f<0V29U(;%xomxLXje{s;H~qVBL%27^uFg)}+Kv}EP6>dORC)T#
zS865)K6zU3D1&NiaGxmX7iEXEU%&jA8>mUVGr*p)s{ZUDpZtrTnYQ5RFL`u*PaYP(
z2)f=NglDdUV}qVO<ufnl4UC~OHYrX|0{6aLuC9ApqWI!kb`KgiG5SL8xn_Cy$IAt$
zJ3%`-K7`&%{mKcW7gzo@DD6M1cs`MP=d_~N_^v{*!`o>gm6PaPA(+zs)60+apF)y@
ze!NV~ueJZUoY;_TDAHwB=kwyS&5fT86PC{(^P0OQb~aR0MK>m9(^Wg|fG~FhezxdK
z$(py=F1+|I7u~9PbW;Md%u27zd8tV#JF&NYa&BGWcc&>PZSg<n=ius}<rSja-L){H
zRI8fx3x9=KkBdJ}-u#Svs+!}5Di5ywE_bK1;?s`ZcDR)o2E+Q|nxLS7Lw#tLo7PqB
zfGd}c#*J2jJ(~tTzd)}(dz&e`d_BAS;#uZ2yTRUX>*iM(2g68f2N^{2H+sN3#5dmJ
z))Pb|OPlY(xLJ*0>gB`NDozG}!_7Bz6?8jfC42{ObkAU!U+!lDZ&+*3y;$Xj*2v_;
zUe^`R|C*@QQu3|Y)ogHQd0D6Q+WE(RjS_o%liV!9L86VXF?QH;&ce@M!Q|1(-%qA%
z&fl`Zh_uPFm;ORN&n8PteD2~}ZH2{#_^`67Jw#$&FBw0zo?jYmw$Z5YW6(+=BHraP
z<Q?WrwZv=2fe)S^QF5=f-&w=N#UHYWHUD7PduSt!-iYTg53HC%sJ6MNznx`oQhy6u
z@?}<t!FXX3F@8auos_Q><wvgGQ7hhnA;?hd5D=nZ${kaR5$1OZFHKm|6b^U6EHMkS
zE|!$mPgbqVXGj28ZUN7iSU&{V>EttnOaUF+e^1t>Wq;Jh3jL=RY1!?QD1%|Wxs^N1
ztlamUU~~DZpcm<;l#X=z>vJ|SEb~~8X)~d=#QXQ+f0N$4vbOHAS^35#ANu%G<+y*w
z=*Gs=P4|-uRSVRAT0H<4py|lx2{cG%JY9cerBC7BWa%z#u5e>+Y*llOf{U_zf3mj2
zSLU)1C1iTCwsra1xHDr`UN7@z;*V};M!Jsb&)U5#KmRwX%`ZH=zu{dp4>WLUxsbE?
z892i--FwqrVO^q^%_gtkR(=dv%u1!In6$qUoH$6zz5A@3Vz+wc@6=*DoWg&wxc;0v
zz5q>opD^ZRx5_V2JV7sWUc+*El-4H8pH`Fj!1qc8d{f1ybtW5{0}9g6#ao9glU4Jd
z^jzqvFSxrS%>!IAgibpCSu)dfiWN%;_cpkv+m`sqU{d8#<CXPEz$2vM;_5r93aV_#
zNgiXnyubjpDe&GJq;n+P2zI#$H|U12e*j!r0-LPIe>YciYLHKNgnO4dxLHnF;xw9l
zA^3$eHsjDYT$FCr%NdJ%sS#WG45BWg$A0fWn`$0A=O6s&hdj4$pBi{TtSv0~yB#m-
z@?!zC{zvz_jl*zjL`3mEx*y%21eI7=ZCtvs>iAL_vjox%SQ}7PyY3kA%dj~u)(yyw
zq3_Ccs)}j8>A;j6#`?Br@3qeDzpMUXj1O~vbCwwWL1kzVr{7lpu<-WSOn{_eL*&Sz
zXU;>F7^ghFshx!Q>aFs!2L7=bNjrB(HGYX0N?=I9>qREwK9%Vmm1$}={6avPeb#A2
zxD%J0fxhGYaZ0VOkR{UTX+}(RrU7G^;k-sxnF8I$ZF{`qGFNI6UA!XNzn+@D+&gVJ
zPg$j`_Rd{dtY18#MlbJ@sRC6LHv5@>L>g;@m2#-%VT7<Eq#6@~@y2TWdVhY7so(j~
zWGUc$!Z@jbbJ8hA<dfAYhdU1Y&}L&kW8p9e9cEq`lHF$cO#_lr`Kb=K5n)%rO(I$q
zq|b)*lu?*nwoE7mILsQR82b*>g~emruvCm0q-CfUQahvx`7!i$sBh>#q!xm3ap1Ev
zhUCB~D{{*xiuUtosM5+C9(K@G?bX}!+VjY{B1$5{haxxmkw^knV*((MB_zL662!37
zSp#X0-!fTm(Y&1$?K-#V@O7#s+aJV*xd1T`c8jq0uwX!>Q+TpMRN*S13poq3kZUfX
z`DSp3Ijg<i$$gi6!csg$l^{dhd;QnZ%t~$FW!7IbM<LA!6sFuMSYSWKOFVKHk0!P`
z;wtGyp-whghd(?QT~Jby_G1=n3sP}Z*jk-8#CofDy1eqx6!~Mxeu;I+Zm0z-39<qC
zD!YK-AV!cLhy!#Lv<0GMQIr>}r?}=Nsnt^<vy$`nbJf%tTSpT|2r9A8WT@#^ae|;G
zDr^C>AckT^X$p!KYY9d!5Eg<^s)AQgVuD(NlEvzRtf*KNW+8Iz@wCC$pfg7*e-U3W
z{}n!MVNM~6Ks2wm5FDBzI4HCrB<L#`BPg(-B`AUN6=XvhhexEv6vv^kg6b&W1(9O8
z0p_v>IQ)ehA}jjbP$jB7`g*i}ba?b$^!+F_*s)ltSQX{cis$vrgS(GNPJ~P}jc-g$
z_9U-vth)E_4Q@<gxtMA10r629Jwl*MQ%luRs{_`8F1!wV!%dUXoVv6+Kz)?l00xCt
zM@r6R@mSHwfb1ySf$WbW6ukm)aI~y9hsUEOI$u~P&)P1T4j%Oi%#T7IS-)vQKlwf{
z@dvCLEl#g{uq&24AMPS}YrttBBYFgYqc;KSZ+^SbFnc)%0g>K=&|GL^v^3f_t!|gF
zWZiv$%bUS0xT1oKBT+63R>igpw#5-(1uz2`1fCrb8n`r24!!~g4SWDk43rOy4|s1u
zV;KwW+fxd#zmkpmlSk~w`iAM>b1m#GHc^{;xTsvz>V@jX>IwIe(U~9rYOA+no$4;<
z%yIzsj}LN>fQJ|wGsAU;4-98?WAxqh_vr;0co+@=;3(uk!$9tUd9nC{Rx!JPk$!v{
zUQREcx$hh?JoI88M9so)-oMy59N|8F!tJaBY}i636&npwJHj|3cL$%+IqXt_zut1`
zfCr-X=y`UxoJ*A4>rko#a?$(SUtZCjP8f$F3kOGzxBC1lIN0sZcGrXDZoajAsnIhX
z4_5W@>W}ES;yyZK|Kv+{!>`_?+~^oO&~Dr-bCmsG8NJc(?r$C}el{Gi92oz)_A1;=
zFm~X2G@Rbx;pLgAIy#qIpPa2Vi@3AyIOK}lPbq!a;GXjxY&>8wU<S6a-X+jTw6)IJ
zQ83qFq-%+6;cn?}-F{kT0|S`j|1d5E3xGNPhw;c>L(!F@@BMswm+mx$c#(%VKlScx
zzFl|0r?^}LM{1CE8@>;`WH_6(POp_&)!Duj)1h}+bm+4CX@>}-)bFeI{!5xE4T;0o
zXZRX=pXedN-jl>jjJ%{x%ZW0+h_bbL=LW_t9Z*`W7rp#<w%t3pe*2B_Cpv4s5vO8d
zgbY3X2TK~K%#}AIl|!UcYm+3qJH#!247FO7k1|mpGvT5c=!BP1v3G&*ue!|mmj5kH
zD2&e0QzGw?dPVK~`5B-2mEWP^yu|V@q?^y_Hq9k0)TexLdT*fQ#oqqt(7R@~3Kom=
z%|BTd)^WKx;@|E6xrEc{<rE`Z%cpXO+wl8q_kw~(j@~-<0>Ukhnz<RDlZZf(JGVyW
z-iY)|S2no{aAC@6W4<|^cWf6wwFL{)o8I($U88VU&17V0HAcPsp|@|L-0=aax7f>a
zQrY=6P|RB8bJ{AE;aFrrWM!QuT`WbP*k{en!!L06s!RU<hSg0!Px$_(r;4BJS2^A*
z^I<CEqfs(#@BetFy~gK;&xSsH!#Vf7F?VG2Q2L>@09)Y;Lo}`oS||Zd5at^{*Y2K(
z?dD<%0?nPb5D9C`co_6rWoAaxTg!u}ecnI?74D8D0j1=)_oXWQer;h=o+|wK1D9|4
zHms}XhE<j#YicQ&E2$p5XQYq7C`#&ua#4F5jWl6PTI(66mNz$d^kEO>)n_-)C~fA~
zbpgrSz8$67TBR!SZDC^h*bu2@dmkwxomCQXL`CY)l3?9HuBMm{U~1oBedxfDchj)0
zKwZW;$3PO4eo)F?@xa22Hq`rwJ^>y+ew-a~=T`chOEpDG%F#tg<My^7%hN2L|B~UM
z;q@~2R*du^LvJH8KYQzP8}%{f%1^mIf1z6fPcj*W)=Nc@Wkx|#TyOdftzJc~=%$(C
z1&Wirt$r17Q;n|)Ee^C=sGDmvYKv-YnogcuOW{giHB#sAZTd!Hv1sffFdHv&f$WrD
z83(p1w)y2|G@bQjwyCjuw~G#z1d?SFNhiWKrhdJ@YQgH{0DqGL27Z(^MxlQhj@w0i
zoUm;z3l{N=`zO_*5*+8{tJgU{JqMW=#m`T_=}}FEUPw~)F7t@X<D5|IMtfzC@`j1r
zA$_l*89ao|_!isGm!;cax>UkDPE3D=3-hqNNbxZA#O3jT&hTDka}g#6s&80|M9t?%
zyq1`6F6D~&z(ce%Hb@z&hCVklH{UPsiZ`)^hi<4uG~|cqB|@k_fw>}$d?9)gZ_~z9
zf?+JqGhV1$;Ns{IfB^%E7IoAK3<mx`rrrZ8=`VgC$5D=~5OJg8DlN;ID>G13+<=JS
z-r@!)j&fF7R){<IsI;tb+j8d~h^V+nR@%qPRciC^_xC;j-}#-x;cyT4eYy9!gM06J
zUeAL@-B{Esi58dMnVPhnJ%JF7VQ_72<$o^#`hz%x3dC2(J;&_PlYtUwM|s3I3XEby
zVNvWU6pAm!of1e1r36soV^{$Fqeu}VKpW5oc)Z(R%i*3D1Zm453)hJ^cfEWGSrM0&
z;sX;zlSF*_YHD&aD&|-F!@4Uv>IayNbGo#=R|SQ(zX)26U@Y76&0vQf=_0UPE47v2
zgf+e?R_y|h6<PUxCd3?NMHz&9<;*t(@yfDhul5YaJmOm4>e$BbSa(0x5Lo3<+Q}4M
z?U*D>2q9D`q7>7Z3cxU+7ZAcpWh!I49JS#2VX(CS7A;-o*6X&~Nd$5=Fj`yLjftX}
zX$6X**mAIMB-oKe{<c)<N{RdeC?umzepnAgNOq(-m6z6Jv=F;E-Bz77+%V3o1Wu!R
zBbt5c+e@K)k&Px;<en$i0vrYQ2YY}qt5%*?oK|b8#=(j8YHU8XVE!ex62k`QOuj`{
zCV9XzI!1!+f|HAMKKs~IP4iB@nNDRPCsHSf3|5d;sRFUE!p__-dmIEjO$sk9XofPF
zKu(gcg?cNn%-cTGJsEgFI@bXda{xQlqth`AhPMze@DV8rW+6t_`!aQYJ3Bbv8w=ZU
z0%5r3kBTc{dv!2LAA#BNUUxmC&Tr@PkRAxFrFuyPcM0_*je{}Zz;1QOLw~VSE{5~N
z(Dc#$&t9nw&$?&66pZc*nRtI`3PW~1Q%G7aRngBFACtKUG0+<^&h#_40M#prnL0~G
zWVB%k9n~Z!av*1A2syifta5a>6eNfTIs*YfL!baq38=bvq*|-)9A>A1-yzWKKn`*a
z6%NS+mQ4hLWhTCgQxRhKkv@}$NgbsB$R6ZN<X&<d`4?%6G){VQ<i_Mi)*=5UXOsKM
zx}@KvucYm<!#&tQ%pUfoy}11oedjjilJLd}*aUSVV#;|kn}ua^f$jNxzI(gsBwvO+
z5n2QY(gh_zVnVz^vx0O`J@7L*VJt~l5JxG3=CTVICE!*KjWrQ_?Fok0Ij=>JF3&R0
zY)_n*jThA2;YbJn<@|s1q^T>p+Bio|pItwp03pBdAWxh}t4F_Qkr&Ec6e&3m!`TZt
z)zBZ2a&5wmGFiNtP&Kxfr@J3AYCderX2K0UNu^QL<J~Kf3}<JY*#xGXHPz#k`7&?Q
z>!rPMNJoRQi~H<I1~^__!Tm9^*cmiM$TH>EW96!Vlct5tTLkM-8fm$LLr$MJ1jlw^
zB9`-wNH@vL|BZ7QN8dKT?g7?f7nb*Fx<83EE|Mbh>g3a^Y5AF`LiDVikx0zED3a}=
zpnXs*JD?eX!-$-n$C~H7m_TWw?Cin=auw%&k+q(54Pp^|xB)M89fuY%#o0{B%oFCT
zkxu4HUdw8D9b{qp3egp5fn*`END5L6c^wHsN)PRJ^tkhS;nk5E6b-04Or5S?re39?
zo133Q%IVLCX0PW^i|E;mocx0PLS)fa0Wr&{%q2Y=UrA3|(M&Awl^rM_CJ%V@j?Zq-
z)y<SI)y=?Xl4d*S%EvMn!b8H3B$F;JYu0K2G=5*&)8N*kYxQeFG<vi;w3oGOHPtTt
zR+sa7>YHa`0Z^OIb=Gx$H(&3Z<LoGM6=#?W6>-l!iQ}CDPHBo<nL27Lc{phl88?4t
zzQ~yhc|)4^17if#4BRP5;o>R56CxP+fwl;)nK6Y_KjZb()swF7>b`_j9^63%X@i|#
zocS=>%vc<HA{eXx#eW3h^{gbcjveljYcDZw{=CI%JqO+;<orrAG^3&3yu)K%`<#y6
zTfP1$)y=BX$0ae4D9{77q8z9Y<+Ild^C{J4Kxr+ps2iu+?7bbL(QCF7SXG-9THELK
zq9nL(i17Vm?gUJ0Jx7++0MSM|RuINs)aty*D0)#j-{Ym(aBkYlJuhjAW!Rx6t^Ft3
z_Ur$A;p5R^Z%44R&$7(FOWuXAQD$wV%_~5pENT`#w_pUnhkS4DitIzKn-3y8ke|%`
z&6gK$bQdXqT-AgIs=mx~?`c+jA&B5S<?@12Fjmv;^}^z@omT}cwDW9)Q)kRygNRN$
z%~0u6twjzu%yiMF`px&?;5e<YFCWuc$BQ`}hvt?yg>@y(pPX;dhx0!0s(L!gjQ=l!
zQ;9IP|K9uwG_5q{ZP7FT+zkER+y%C$zzu2=9iJ(_6>X8_UXs3UNj&eahGb^aJ4!ry
zqy9eiDS3-Gk^*w;rg3o+MZ9X@{D=@YTkXAw#&c)dA0<Fu$ej=%<Bau(c$Eg8H!6?4
zOnQ~b)_LM<#Z>byt%^2(zA%OEzsJz9uy9aikX=grKO@Z8S~gcKcGz0P(g-p0d)+-n
zLZM&&$Z3jrOnW`Ot_C99nmQQq&ha1p+U;#T-gU*%d%pbK5HS6HfK@@4dF`Wy(2;*a
zU~s50)%m&nf`|apzB$)yLP$_tWZFYG(NXd}Q%AB{VSH>oRq2b}6=QhOvn;*m{gPAp
z;b!`$%?T_6<D#d}0mYf;E)*tJdrWu<%jI*_mS$9YJ$Ca7mAC#2&$#6k1uf0^YW{R+
zB2@Mu=L!jL9C+_R%XOnBI0dAmq}+lkqX2Ia5O*%KX0ecG+40{paFWk*ckFAH!z&Lg
z2HxA552tA-22a^k%=qf!Y=3YOa-LUjirp#umhqwQDPu!*{R(ydL_${IWYhDej&B+I
z5d{})pC!CZglx(MKhRNAzNkm>nS5UN(W3V<k^5W0x{mSGDNfIV7_jy?uMhV$h9jSd
zyea%MKjg|0Gj|#DLiUfEbKbl8t(b(j1z)g#2mExYN&Sj$ip?I#2T1=RFXwH_lef@!
z?W-pU5D`>CL}TH#dx>6+S~qJ>xs&Ei-iNs4>UjFc)T?Wla4S_H6`j33-9bx6S#BP~
z*<UAjbGLginbR^4Y7;6y7S=YI)nt0U@JF0(@lAa1XTc|J(@>1cs&bH6Q90dmwXded
zho*bIu(onNupF{_>8IxlqQU7FvQusIy~F}L?{;+lUd%OC8U+jKO4F*l5dESD(vO7<
zqaV^dRJ)zO<pa%XqWQNyH4V9kq_}&E-vWl12g_1vWrN4T1zov4feHI>nluV)d+T3B
zG=9rR8vVO9<8S|5=!&+dHsHtUM&HVb2u<$>w+71w|B~dkyiXJ6b_o;l6Slh^;r88`
zn5O5V$uFYyR69IRHzN9KEDLM<FFhCWd=aIm+Aa32K=}D4N5aGAG@uT$pnOayaEdTx
zlzX!8$$5{a%y~OgT!=Hv+|koYvz4YqT`ygkTA6|~;k`l#T%<EMa?t~!y?16aUtjcc
z(X<j(tTgG!6!i4#;$^kM%#mHx1Tp(G-U08z<}fQStvAlOX!fM?N*FnSEKR-$;62K>
z*C<pbgclMMat1-bso;LW-8gv^X(n+JIaxNZHpQ4BE~4gvj4hEekyeqnp1R*|4M`@>
zp{9?H5epp*glLs$geVJ!@zwBHeU)J){E_CT;kV<n69TeiS~5*{e9i>T-^pVmu`XeF
zp&(R{82OsY*+gVob(x#oi&Iw|Km;Z-`wTw0SIoRVz?tC=1d1vgq_ohEYzw{)3f})Y
zA^GfLo$9~$2@jt|KHoGt{W=R9P$6>q_3c}v(~lp|S()pItF8;ZvvHcy?QxfgB2>oX
z+0`&dxH6>&#mvx1VA-*7EHW6)as?Y<Va^#+rjn;^z_(LhSeGrJf@Q-zW8W@(AkK75
z)2Col9aG48vAIMxp7rsB<H}`){iTSxmTnItbr-UutP$A)ZZ+;QZd!+%Q8iMetiAGZ
z%0y;5*BQxLzLcp(o%ip!hrh$Vi`T$^Vvn#dva|5%cr;iQEC=QVyMc}X+HpWzs#~sD
zCRrrel3i9@GMzY#$)=q)Fe2Uwj0y9(_)ZQoc=0=5{($h)SCLM?9~_)xTR1Pzzk7}s
zn-CLxMIMG-U|X_`F7IfK?UvYIdfKf3rcaWMKndBW7`AZMx9$eX8vl<tm>tX#o)*3=
zNM)nV!r&}5_Dh%$97-}e5<7eprUC?uQW=1`OzRyKlL$U-R)?n9g~4`EI}Tw43?4(+
zAtZn8h{W6AvtgnzHf$Is3{!$#fL(+QlGn%~WVJ9P`8ruQ97r}Ip9#|rqlOd1AYr`x
zCKZYmU!|{DZdm0xiLv;>m$9;7UGNETEGq#U%?f2jfTO`NtOT$sR?jf<q-t`8-uD+a
zT2_uVL3O92eQB8}HgjzIlF{23Pm;TY%GM*&>j&ehq#eM&?jewvARmMeynU2!YH#%m
zGb^6d^q7%2(8}Z)zOE~}#ezG8d9Q}33URJ$LufY#(s&9gb5zEL|8=2rE_{3NR26>O
z@J^Dg+MQlW^?O18K8=|?YQE#4=66AS;~HOk&VPI2w-#84Y`*;S_DRlRrq~etB%Ba_
zucO|UWztAg+vrthyNjL4O7A6ic;X_Ksf~gpV6~ukF@biZ9604Hn!iKh^G|k6JKBi0
zE?M=Tl97Yno1f&mI06S;Jv+p4N~V_4I_9fC=PGBjY2JtnI@-6tE*RgATyCgg`KNV?
z(UL1T65{_^WtcSdac)A{ae3tLN(~%`#(7OM&3%{Nv#M2;L#*yxjV^s#WQhmAoV62X
zfE+lXTpgpTK=sinmvAnl$k#2B`5>V_n^nH7j?G;{L%)Vn14732O1_)Mx#v@(0uaLM
zy4^?*w=lryPYGkzDp&mD9LVyWg?`UrAvF=B1pQ}9=?SK^hQyv|=`L1t8d5E-p7W*I
zCpkbzawNfJ`zGl%ER;=Q*)ZMS+u}fZ2jhd+#b8WWH%bTG2~nO?5xhR!bJ`8b0vz_9
zX%w&&|FJ?4PMVE06}p-Rbk4HV2w;IzNX5O|f%^yDpU>=uOPbHzKeHPwwR$!XCfzb>
zyixq6(^A7bTjWTiq8)~ZzahDjaQulQC07En74bwkD(nE{K2NsB;5A~8jxXj|n`{|2
z9$$Vm+i#QbVF`CwZSuOVFeGf!UCn)&E(kp8BY+^UpcwFt2zeHs(}^)=;(s_Rn}%pL
zhvKE&UAn0FGajpF{XfzmgVEtFU2+Mb!h)nXBi$c0wmNPf|6vDvqpejJT0oOGR3L-M
z&~Q_7PncS`N;rxX4*vpQhkt<Oz#;G;*i$$M{2#m>UI(YagJHq=Tlk!#xu3zlcl4<Y
ze+6rZ<;TvDYlvc32DkBv(`*o%)C}XAO{}I*pah4>iR#m0vOQLzSTe|F+-;fJArwTK
zhq3VXtQ)LgkTcn#j13ebl5fK!@fTQpEK5tR26=<BaG)4$ZrmKBO_Rzk>#1{RN*}Fs
zC>GD;3&AwdvIuY#=bvolj3*OBJgwXCYdq3mkXnjXL#2TR-|u0i^GPRRR>lj-p0fTQ
z-3awC1PpJ?h=c;6f<Q3kh+jnoF+f|OzaV?k#8$sLz7CEy9>;IH*12uFWg3HgLD950
zj4&pW76;N{hJmipq(IUjZHy>WpGE=M()>W0G!Z5z=rRUM)1h&JVwnk;Xl5ugVwEw1
z|3UD^Kf%+E5XvHq6FBfM@V^LB`0l9J&D-JXmSn_s*tXX=QQZ<9Bj{JqS@w>B8ZzZ9
zSW*AzKxl(;8~=_52r)X)vCJ@5CgA~W%4m-iK^7ptiKqrD$-o$lcjJK=GzQB08^wpt
z#MZ&oQJD^CN3=tx<G4@c9yVFILbqmZ9=nIViKSzUSwFDHuqUxHSXHbzR{BWu^)&Vo
zRt3cCv~1>`d*~y5rJm-=gkY{Rd6;;zU#1`0myFzw5sV(UCC8$D>Vnk+)rsinZ3o6+
zV*gghl)u-$XTga7#~|A2tdwwukM9ioY7f7xN04tbErzv(_cA@x4QtW!aDzmVUl$Cq
zik|=>_bgP}!_L%w!JP9%^tx*0cRCwAU5OIfHx7Fu=<yt7Z2qJ%_q~Sa>gVv@uTvFg
zGQuC2!xn4Db*GgICqEAxvJ}y1=b~ANQH1+kx`?FE9zj=LW|;(wCg=zz#CtOmnNYSJ
z4m0hFL15fKCKwYCg6Yas@87oahrzvJY_&XSle(H*fqB8%i<~F#eJ`os@S4XJ2Vi|H
zjI)bZmDWMxx0a0*-!_)r&Mub@Q`!L#Qhmi6?o1A3KWsur$&a-D^o%&)fRfVPPWWN*
z85Zg#6q}*9`s|ZDv^Js5B33LcV?)$6J0-dL>ym4Z7qt73!|f?uAtKqW>;bf}#Db`p
z`EL@38^-mI<E#=R?bLwdKVk{YbaRzu!4f=visw?DyB3;pqPOQ-?CJMWqvJLooDa`w
z>;i9*XvSJmiBiDMZS-~!2*Y$_o?*4(p+>Ms02t7ZCemOuZWfjm#|mbR;oS)LU@$l_
z+y=#y(mWFT^1`Kh77*C^)gB*=KZfVP2M}0rLHm(xl*k**QUgc?!->%YU8Tj6ItBQ#
zGQe58>M(GaK}3EyHLNil7*-oD?78&;DMpn>iclrg_x(n?PTeyajzWqjj^VL{Q;cW6
z2R#L)fC;hC_9$!&I6X_*y92`cbzr(rezFgmg6mam%HJq3u6#8BXbkzK(pga<Twfx#
zx%smMcTD}q|6eDjk>l8#pR|hJYo5Ipda#-0ZrBoPPHmn#mm=j3j6U`tOi@5@Rj`NC
zEv`}TQR_m8_k*n%&&y_1cN9OW0z<)q5oL3zD%1lMKz&rru}q6}-d&@A?Y*I1571cc
z3{cs7VG1?Bb_L#x6E|1W^H&sB?-m0tJ%%ghahM5|hPCv71<LnV?R0Tl_(U|-24x4d
z2L=KaP((BybAX{ZqpZ{jYOz2Z(1c+_m0`Fs+EHexVf5ljJyQcdQz@o!NBo@mr?6ZL
zd4{9ABOSTytOifCT*jbW=q~Fn3>?YP{YX@Y?Fe&$x=~yYTv`dOXgY2kM{%GUpcELs
zR4*#tKdKID2SpQ6a%g*%MxHFlaZ~~$fMFg*3SmS5ZH|5vL$nJ*&D#M`?Wj10Es6wm
zq&pC?V(1FAAxc-T^HlBt9k=DQWscGjJle=2=<W<@h8xNe#XCOju;t7!XDFgv8L*9f
z#g4}AJsxQ}D|zl&dWF!mjFZ$zqa&766QW>;MSEjN7=xpCD2|A&wpYV<VAt)T&S_YN
z{W_t8KzGi^x4HoBQCO6{687=Z)tLI*v%g9>N&P8<<udt|5Vm@6e?IucY<*aU-VSLf
zXozt4Oxh2rOlqmMnTS~E{pW|*T*sRA9(CHc>=>)0N}5|aWEXKEtvfi88yFAS{X00A
zbBJcK*-BuRr9!07eSL?`a1|H9w{+0uI!1H8+-|s9-bjZxN=~id_k>&WpG#U64b~gp
zzVrT;blu#ti$ncTo`P)zNM1PeWy3AD<{`jq>v5#Q&mgVGZjFyIa}u8}IMi@h@k_ej
zDmeV;L3{(7NqiMv!r4Wea>+6^)c`|!QU3nLaWfsj60mn^9czgE_8(pEu!(1~2H^c9
zXjER(x}1JR?3a{Qklq)iC5Qf@2-*BnOrp|-9VQ(f7L+LV7H~XA`Gkw_&4C=Pd}U|F
zz+S<%e@fm~CX?gF=$?%OA6Gd+Y8G^PmK`U#HHYSUH>m@7M{g!nweq!#J{J2GvbIsX
z9awwi7W=0{I`>P~XU@ZN`v!>@#%E#0Uq%}Rzj}#!NE8IeMI`ZgJLc<1O2-texMChn
zM}h{`X$727Wyca`?)|Qc2wcY=PCZAe{EY{b@0T*IYg5$9FX!2YZO&FC<R#djLe)m(
zima_dv@WYeoXHh_#rs1`qdMNxy)3tNw`H?mrZEK{)K=!vbawbFw1$U%HZzp%W@qCX
zL{SPV`@z%THfie+DK%c_6^mag*a^#*Dl4z6a>3!XMGo{<?n-ln*8j@anHe*=r@bkr
z^r=FxG4-!kh^VBswcz^HrMGifzHs$VlNt>Z8)#1~5TZAbf6e|L*ztFK+h$fBe_-|I
zocA5LR`aNgeNSyc2H4O-Z)Z!Y>{&A;XTNsJWa0xhTXcJGp~fZ5yB1Rbx<+h0(f`*d
zB<ewCM0LJC^7FZIEwPU3ggA$b4Cz4Q>M$eCaDHwA(i6`fg0LjXKiVrFgPkW)vlCG@
zz2MsTnd*tCM_UD7v`18D9TZV78lbalxiu~o6U{><4ztto=+pH|Y{Rzl@cOF-(+lmU
zUp;G2RcmXZ#2X*y*v@|Q2=UllRQ_BRRC%`fe(}}$1j?w4%GDad$`f=#i%fA#_f?0}
zJ|V|dZY!@<es4ID%hPS}{YHX)I~G*Rj8sYS3yM^+4l-5At&UepsFqjKR|=^PRXS7c
z#yoP^8ZRA`aV@o9a!_>}bG+|b3QvF~nBH@7@jQAkxcpbnee<9Qo!q<Jzr*y3K3{d;
z94!l_%jEo?ciZ$<DsIskFU6j^RDIHoaT*okQtPgKy8gx7sel@j#?y;O|H&pwc4haQ
z5@s*P)qH9$?Hok~;gu}P!s)+C+Q~sb%gu^xiM3HR9CV$mQl?v=ildTg<@AGZc3%l9
zKqa#>*}72Lw<)XbSu0niKlCA5IO`VntMR&e*;pM{b{y-LV~LkQ1d&(PqyAE^Ci}km
zSA>;q_3<)?*sHXw;j=cDoAFAQ$~GI|IWlY>$9plg5&5e%_u=;}HbtsSW$WsG<se*e
z)SO#PbN#>WwI1t>vg`FL)GN6y3;!%mA+0!w!_a&66S+eS<E16bk|-6|O}*;hWr5{u
z4Ht6%TR3g=*CNAn{Y1HU{dejY>J927RXy`3P)(KISZ7Qhp)1h&8Z4>*Q6FX&XBK82
zQY)#?GVf%TQ>UpxxLV6i?53VIeY}+V=JgG7Wu|0iIxUiBPkos+^2N%%zff0xn!J9p
zu6yPlDuZ06nAeU8v3He=sms3aC;%y+qjt53mh+nZZ?a5~vFRGJURsw}81}eyBGvqI
zm00*qb9GwS*Rc4z;VCE<*nbu*G@$Jo$DaG1aOpWxiNEd^`!6};?On61PnfPB=<?lK
zdQYw}UZr4AHL71QuLUg~SN*UdZ??p4lb{5In$l%6L&w|ggBb2*0J<FajZI?-X85Ys
zEUYi{{zSWlpSO-4-1X8=rL$#&bv(JDEFCA;C>02s-5kiy>J9d~v;_tSq;<vY9r2o)
z$;J_nVz{y4-<&rG*aPIgZcG590$gA*-<SDxp5-J{)_ytNS~nDab3sGIkrh8P^IzOY
zgRQ_>4ojNBmd}0J9qR~*j#Yob#!a0)N!4#wd4e{-6F_xeV7uNPG%cBN#ZpI1<Mp6H
zZSY~Dwl=r<034?cneYl19OwjG(iDoH%?B40ZR+3${QI2hXL7q2?h{%963;>x>in_`
zr`nxt%vG)veXJfT;Ex8tPTjFw+o@=HiJuiN!%!)${Ck~zj>F79mo`d}-a49CRsOkN
zhk8GEZ1$VQqEC?W`ekTNz25xb5Ossf0%V@W{j+PgJB``U%(NcwjVQZ*M3U4%OqK;h
zWueMYa+x92qI`tjN*AG@p;yv>((CGs=+Eo)sELb$2^04${$~g*IM>UxDQgzkxEJm>
zxXrZL)!GwJ#4Cp9nrknbuh-K3sdMw^uu>bn4s<)}>j?*wjD)feS^r?QBG9*)zs5sR
zA+AB3(0$t1kwJx*mRokf-tjLOe#ffk$;J|2;0l>3DImjl7C40vT~bOraCH1akizf8
zz^y(oZv3PJzj0Mut9l-qOYr8q&&J+h-FJz7J7?yljGx3RoNXOU;`wnJtUc!vep|Gv
zP|q~QXJ-QJI$LafJ8(^^URG#VUU+f-kC}zK!r@EDq!Zu$zyq+0@_VWxy`2}lKA)}9
z(-TUD@=?K`2K4{954tNX>fKB}+|t|UkzO1=X%--}HrRSMS#{qMXe<*l@+T_5<+E(n
z&(@%q#VKF*!=<H1rOa=8C<y3zCU<Uq*t)Sbxy85r1Kem+Mf3(&MJrfTA-o^xUTY23
zRcM9k9&7b$4br`;tE5Y6HPp3eHEeYq$TQap@U|R&$uk;Y!fzE|`^0YR{*iT~SZ_u0
zNeemiixyI?-}i0~1mJTPTD1^PWyx2CuSKn0MuLuNtjZ77ZN1catwG;y1t*F=EAoky
z^>}tCL|yjktRK7*wi=@8z8p8Y$1v(z^mf-1;7n?{8s{fglM;XWd(`Z?DBYEvkQocl
zm+AY*M=V5I$tf>@x#QM$=df#tm(TWdrvpHGJUiF>1J3D6CGP@Drh+t5N{feBDlhvg
zw`3%q1uK*%zX!H4c|r|IzLN@8J(!CVZyo095!dt}#vW7_g}?(7Gg=GMy^#1~Ci^Xt
zxAE|qNkCwgl<u#TgdH#8Go5$C{w=;(^y#cL<w%$f?yPkFbj8IGOZp}@ojdcDTeGkA
z6m)rUG!l(oQ{hPd+UZw3y>|h(WBaH+jbBx$v>3K>x6-vMWPDRJkq=&FaeN`MvQkK4
zY3tI;8sE$D<o&%k@Q>NMlqV78=Kh}br-Ka5K=Lku{f2#9o~#QKkR@Hi&bQ7R<-j__
z|LM`flrLMa&m{&!nU$1+{Zk|S@<&5;TIQLZg`@Yglm?*@viGkfONez)Rn$w4Egd17
z>0*jE>}C6wCAjihR(f%Zo0j1Gq+lNhWaZJ6wd0^`)t_XW*0c;!F>~k_3O}^!ZR?>t
z(ByNpKzir5odoc`E-8yA@oSp8?~?`_ZpbZ(eI0pbaT`$P?W2!cmvHA$`<W%ke2Q<j
zj>lvKD9M%GSKFYSWcA^ijcWa>QM}5~H|iwn)vWWAJgy>E!$JKXW$Jb0n}2uJuBj1q
z?loWT<f)7|X4*I?sj5Y0J$9|NPjiHp(PZr7BbL*$B;9@!oj~kgHGLdYqef|XsDrxO
zCy}Wc6ID;@`VoU$O^x=SeXZ&8Sz0u{$a>jFjY4%8PjQ4G%J{PWxz2|}Ur>!1S5eX!
zgOD;7?H|^_8(K*nnhZe?yY=Ip+{Av>^kS)A(~Bnk4p1XC2GyML8gtR!fc&`q-SqV!
zbnlH!^$9!sMU&cCUeNM!b>Wq$dW){12wyLQ*>u|b|1<+0Sa(fF`El_6T>YX^k>51@
z+J2fX>Hksg&3)catH-n!bDO&U^LvCcRW^9TXS00uz2YU#%;u7lBZb6XS%V7RoRtZU
zd->0LB<+9UUfT_!3d#Sq@A7o=JbS)4k3F_rcscA(x#{(^Lai^1^RPF8@1JB|>$ra*
zk!U6N6qG-f1)iz(EHX6~=O4KI$Rq8O=9kVh;B;%vKg{!}GuBpe%js%gA4nqJKvuM~
z&l|;Sz5iJ<7ZAU=EU5Erd<boddxK4jdf!%h+0}rx`ZxQscYNh?_oZu$r_ODT=*r_R
zH^FSuh?NSH!x0^l`EXKW$}^37`3xYNcKpY<adoO5X9z}kdd}^m?FZtRrhPHuWueLO
zz&Db-zusTf@XVR)d>Wwz7`hy`h$zqEf`>M9VCuFro?g_tR^&AYx`R-Y&nTv@U3=9x
z$-MWq0&?wmiNwj@K<WkN%nuPp=W%N4>_^-}e{WX&Sq<*hgC5D=M}O;6dIK{StC!<B
z!VYiWLQr6<p{^T<v2#tz!=2Z1D5Y}$2`kRsG4<tn^MlWEB~D}Y!L^xdBH~4>vBN%3
zB>O$C6*diG6(H)B{KthkO~oT`KJ?A3F9{wgU4~4$UrY0XA5-1dsxeyE?u?tV8q6`7
zor~*Dh@a;xUbcNdpyOG5cTO_$xR`+fU)+0TAX>C{@jHAF7wd=MZ>1+??`8@aP1(B)
zi@uz~0WJfA6B7W@Nvm6strJJ&w_jV@TgqFvx5~EMw~Dr6{S>Sb_#;sg8*k$^D{qpw
zZE9SrIZ{iaPW!yjNvG5!|G4SKqlCk@>%`|!U8AI@q8Bi)?7fwbqAA`PaT{=a7rkp0
zh2N8?(~%V!F-pbjIwWo!jz7Z<T2fE|n=MhHWB1`4;u?|A_ZWc1?t{4pc54J(Ai#A?
zSulk8!9IC77T~}0gsF&^FzPYVmD!#E$xQ~k-Zn~&ZB0*{-#!7pIAda|ABMO}0RYCg
z)j?;b?h-CYQx0?z|8AcJ<<8wT9V8>-D65HdX?Wb^@a)tj_$;wUiK3l!X-7n@3jEhp
zUq6BS`T;wsc;_K7M$~5UlI5UjkHkR-AaRFB<kiwc8;byL;a0QO+ezA63cCZMatjYF
zp9HSCADjk!*bx-&9oHWpWHc|m#jPMJDMVe+LF|Fqfw68nATBXDQ6ce4;;}>zKtSRZ
zfFi)eJ_o&k`-1vz`6-r8JdpjfZ5zbbRb_>+Rj}oD?eUL>&YX?EE%2=?cJh_EZr_#@
z$l5_c6%et-sn!qvuUD=oh9gp>7(-@l8?_<f*PDjFJ93KyZn{&C9(&$ezn%8p<|MT;
zNkRE6(xFeTXhZlZ6R`d}Q^?v$Au!1t40xg8JFRbT?`*f#TKC$e$60r6o0IjxR9AF6
zY)T^F;N|WQ_A4wxHPK=V4m4y)Va|mdJlbkz^IvZj*##{H5EM=TkXs!hvwUf<Qt*_T
zErQ5`O{y}-dEl9GAG{-40oEFwD6;kEH|DLq1U}N`f}r~rInEoonAD+s)?+udA<0ed
zabBNlenlJ3?fTR0ri^hfg`oShMeOR|f1-`1-$g4~#|hZ|R``?J66vbyp-DmAMlH&5
zfvp-R?4C#cn|MkqJ>IXX1YByjnC}K*7A2yFcd3ot9L`%-T^d7I?;Nu0V^}8%aveH;
zu$|A7#ZDFp-h8brz`Jc8;i*M#ut4ahIpii?`KlnXY0m9h)0oS~Ffo;L*6VUWG1)HK
zMp}i<rPby5mLu%cmV?{1`qqkje2I;K{N1kCVfA7L!|AA(L{I46U9q*U&WMX5Dm@#1
zMi(O97L;@)kTRokCB28z{gTh_sf&H>8b5s4E65L|Z-1$<NQQGdt>Sl|7JD<fnZKtp
zCi%qdNd@E&<Qt@5@=20ORND~=$4IbO=r8EF5L2j4=#}t13sa<gHNI3!uk)M;pPyw>
zQxHQL))?5`CKx}KtR&{%aV)y0rz=KWII3t+?t*yXij$;g(A0oc1WL@NLp16jvuX3a
zy%@S<hAbypgN!)Qc~9&xyzxxOEz%CqYC7gx1b3&l^kKl>QulKpc>L%%O=x`5g_GQX
z?<IDZfCPGz?e;>%NZqf1@#6zQT3<Q>NrOUFjF)&hgjSrGe~~(;;P1X<L<C5zr=vSe
zWj@BZE2i;`SZ^m!)J-t=Y&yjVaO9|h?Y<Dk1Ut`}8?O@gBwxu2hX)92%?+4ToYHz<
zfa*LJIVCcuVN`LB^JRjO+>7Lk^?@@Lj~sd{iZl(A)Ju;DPnqP$<cFkEQuXFV;CnqU
zgHRIRKe56{@BfPhbJxDS22;`{97EYV+5|*rRbc3~<2s^YJw2S@D>;HHPbET0ShswW
zO9ce5HM_;MOS8iM#P5!?mMcs7CYt{T2T$Pvc%xWnuk=iS)~l`%LF`xsZVxMF*<nl?
zl^F<b4ETR>S;aIae0pV7`O8b_i2WBzI#yfI5c!6YZPVRFDj=-F_bmTfZI82q0I=?^
ziF`Tm^Z?Ar_91bMbpNryi{tN{JZfB#wG$lc5A4qUYq&hW;+F4VS78sRkF(Rrj$Ep`
z+EBk$%QCnKq8$}IE&+0^tHH*pT7~B|<YZDNR|PX*`?gDZ4h`ARTIGX!y9X}>M(;c-
zPcMLN2Y6ZTkMM;x3oG>b$5#YsN#yT$<wRI#;@h)h?O+pVMp>=WuPZ*A7lV!^JEKJ#
zayT<d#nFz^D${>`g)`S_^ov0lx4hZU&a>tSxf6{7;_&VPl6ADBE5h=?w1Y!!gj&k%
z!`*fRTkHBSOVQ2fNtx0U%D6|aRZeMU9bSNk5v%pI_@mNi0FKL6Fmcs_q?m^C`rj@X
zD+lNWYUIRoHzW?`s8+#TJR(ePrA<h?t@{tP@1J2dyY$DC;6UWKib6*uP;Z=u!lGNT
zP`NijsrI%@CWd8@%wW6UM?yjX6rGr<huL#-R}f6WzOha8mYL>!rwT=roHOg}-=Nd5
ziMCq~KtIMVTAvVH6AbD(s?IX~81TdR3H#4Z-md+KqwsriH}xa(JxM3idt%z*431^0
z<YKEZc#-=hDf`awbP!erm*KGKux1xzCs<8b_Wnc^UpL#*VveG`@lfl`N>nde@*=0Q
zpeUvX0WbiP-C}V6J~xKVng95_#aC;a>4fHy5GX#oS$(6g*>OJLh%MJ(PAYkQ;Xfxa
zA8)qK#>{oU7gMGU+#F`VXMRRl44#|dl1}S)KHi^)dWooSkxVcR;NiTI{`alSyiKxI
z)@{)54RmBdA2@g~HjOSYeveRXK2retfu_pdxM#q)WWVRw5e0mY0prU&Gm{)3)&OZL
zY2pbg6~(rL9(mejwmYmj0K_sCG2Rw1WvV3eCW_nsQSEb2Yk#wl#0LKai(lMHZhDTM
z!)|Nn;eP+UoB!<c)>!GySggY{>1Zm=@DU;31Q4Jm3H&{A1><S2fWTX7i3RTo`kfXo
ze;dvL3x7ci6zFKaLM!plzXcYP3wUbgT5;L*T9GvH{wh=_Jj&u(z}wNRi+6fzMM-!5
z(yx|D{ZTtEXu!;~+rj>J)Qty3d_aGuxTkbV<7w$MhI#&;zLwpZRdj$MS>%*bNob*-
z&-vk9RgfXGelo|a_m*i1M4*xA;QvjY(R?>&w?{PE&}(>aV@*D>g|9@io5#M-+mOrZ
zp8ps5wfcuS4f8>DrmcQeQN=p=KKoC^Rj4|zCiBiz%5*rxa?*J8DB|C05ijj3ZPf;E
zvoy46vnh$UvRME{t*bOh&XsuhZ{D3xZ9@wPLEo0@U>7fL)YF?Xg+`@0*7us6hFtYF
zs#@YM)(dSYG^g~s;)k7y-yTWr;O1ge*Ik|wRx0~S5W^s1545ZP{M=*X#aJuWdao>J
zvsAX`Y)kYahd`mfyF9CYGTUj+%wFT?S9;|Kjq(3!Yez$HLHDp<;B{}S)s0}oVqv>k
zo$IdGhWj`2<?hju&FV#k17}SaIjn|>1#(@@;-x|(I{w!o8Kzd>HYA~E<e4qOMJWTH
z0$s0X2oQ~XMB}9$7hT)z+E9kRudGyCrH22Kr4iSir16IQ872bZR{q08D?+AT=9MhH
ztVt??HeM<@^&dlW;fHf*RaBm{#1T4w{|`EguB@~dS&5-#QMZOQ<VL7*Y(wjfH}r+9
zyH~CV9k25fsqgN&uI@{R_=Q+C$yp6Or~iKcL@j|~ctud_6U0LM^Ehs&{)$xzEcN6~
zAG4U;oyO%A)_L@|Vi>Pjt*vP#o}TJcmg)!4w=nW?23SmadWR|gz4Cqlr?e|LO4+;X
zk?S?vXZkmeu%hYsxF$mA<c5ET+^3EqmmhWY(asvtQx@}jHWf|*mxrE5{`;{Ge4pan
z|NZObz-Y&I)m$~%T(#V$Zl7!3hcTDLr0QdC_Z&a>Z^r5PQi$86$nV+e_jx~woW1Q!
zQTLmYBt2)Qyd_jr4P_r)mS5^txN-;Y5Z5v{-h4N+;_j)-;|z2Y5PwSt|JTea(=z0g
zPpQ1!{9=N?Ym;%e6fV-Zqr`ExA77_pfNnkf{on^|;}PAws4pa=U9Oz^n)xwcpv)(G
zRP*!T1Ts5aFY|;o<oM(~uOmc}(&Kw_=6x31fjE8)5oNi6tz{#PWO6O6&{N}41|ERa
z9qgdsaESK}r7rHB&I!L3`a5?EG4W=v^W($q6o<#zva1It<c%jTfwFl#ZWSj5TC?C=
zd&d@3qnm8{5d=ow(DE&hE#WBP^*&wO1so}z+fSmw_Y$>Wk$KC-<>q*`__i>LOP5Sw
zyp6qmW}qi!EqhFI<htTU2>n87i=DJ%Mzwr;)_#P*XIb+ihoFpDe*?M)?dkM>d<JZz
zif)o!A+@i!|0fVK;TtSCEDMXaIxt@JCgho5WY<E64ZHMBzfmV-wX{zToFI6=94;SO
z?>?%ET>sIHuH>AbiM00vgTHcGEthiRdU?zxU{{dhCBuOAUAc_<^n$rzGt|D9tF}NP
zaYgP-qjGL{PoJmjIjfe90y$s$a#Ia;xY&P4{%3tt&VSvRADrx%6O7ixT03a;(cJID
zdd2MO(jX#G8R%W;&lvRoj&@lpnx<DOIqcvnYS-sL5TijBpc&AI&?;FCdR4cjh>=c-
z@A~Hk%i&#Jn4!Q%PtzPT+RoK|)k1D}YM*3<TDO5pw4_{zu0w6;1X|o=p1XjWtaAR@
z@QfWf^Q;rheUzbP#s^uxoc#c+mvToCqFr$r*!39sy8OQD!y@wNQa?i538EvkqK-R#
z;oP8*HnzW}$ic~#Y$ZXIkqypyI+KTJ17=99AIQho$K;$az8U`eQW|?@SRF`nnVcis
zBtascdd%*)r;kUAsn=)oElOJVTK(oj*0-TN>ZV?ADT&V(*-niU0(=o^JDTK)NBD#G
zkLuh0(IT`VM7*p4=8yN&YMpk0`Dcxz4zK=v3{9)G7k&ODlE*C4r8j5JHQr+CX+93;
zf}34_HuOg|-GteIyk6QjcsHidmxc@B#RNQ)k7REAeD3_TJx__sy%%a&3H)fk{LN2!
zss9^=mKzT1dOj|8KTU1%&PiU0<$X;GEoSnB@yGDLEbU{Hc7KG%7KBfod+YmIm0r%8
zmPB1wxZdLRl@{d^9gs$Ff2|hS?jM2i1-gr#y)Adgc2&RN?f9xbf+owh{3`|){P*`d
zPGzY<c)9OMW9nXvK}7Q&daPsKys}Ha+m+{xmLpDOC^s!ELnmLn$|E`Ngz+0Z?=!Us
z>h{u^;Qj!O$hjZz{;!(F%=4y2nEnKJC5_^7J6i~<Uq;iS@^cL#=oj3S^jn*^VELa$
zNcM&42}Bn}r?$%Z1*;#sW#4bKQk|29dW4#X^Fq~|CY#A=yBe~yrsRH~<ybX*X2HZ|
zyWDHM$JIS1KN=zJ-Cw&nKUTx$a-n?#`~Opmr5;Xp6vy)}w<s)|6bbjgS#H#zW&VEs
z1gJc7$I%pFz@NsyVsd2Dg~+`$pM^YQ@<x<*$-P;lE7y84%j%}Tvna1A@|%a0rg!d@
z#Vqvly2cq_sTc@>HT0b!erMTL4VMW&>a2KTKr&pBea12OZy3#8UyYLrpXfH7l;;t=
z@=3@#UdH25+YnV6h~>3+kJh})?!DeGqEWLHMR;?<9j{hKdwyg8wC4@#r#$`d4TaME
zmd9|>BKCF{YNB>DZqjbBcg=4m6rmy7ym=lh^;6j=*$uA8W1Q7_U#}Et&SxtgMTX8H
zave;GMe@AG9z&YTw4})_r{-t_&VFO0HLpV&rvGds>HbCW;UY4`#K0-u{tbVcF>g51
zpVyB!D$TUtG|ji)j~9iE>aSY9ylg*VQyVa!M1%0QjRzz5)Wv6U9!N*)H)T3MJVzK_
zcmwO@=kAoN!x1ldn>1kB)jTEre>Gp%{ihlbEVeXsx5eYb_#M;Vaqj)JJNP#d?p1k5
z04S~mQ74zCFc5Sae%Vn?I`6%$v$cm&P9eVNlt;>qL!S@tQBzL2#wSBGv=nd3a?JTF
zZqBBy9^L*|;zf*pkZ||pAQd#i;;2c`53}tt+_1WIwhL?5QQQ4ZSpTsVe+_TH!?HK{
zw|{iS4{!|ppFc|;)@`ZoH~+I!GrSi;6;iIr4=S>lTaAS9E|{@KA-U1W@xXk?2|`!9
z(l~IoKg`GWP>#`jcKSiD>F?P7bq_5KN7~8B6Q(#LJ~Tw_YtSe6Cw?+StxcJ$S8OU5
zZDh-8emjY1;HFLO?w^uw&S`TK6CdvvQhU49i!DMSE7TOID@!7jG)|52`QsjGEj9mQ
zSOqFgDF!$FpZAEQg;5_a^|Em_XWt(=z|G6o_P$*{HZF<Bq2IuG<Cjlpcv+i%pB02;
zZ7dqTJO1Y#<V63fM`4o5@!M3IST^cbn%3uw?N>}Sd-E<$b0Hpux7jI!Xfty{j*r6T
zkD{a9?L8(n-E&PQFT>A-&j+OKc#LZv<oVA(h2ON-zV?PQ&5W1sQF@dkc=4B$h?#Q&
za@a#cP2woh*jn>>UXt`4xvz6LtsB%In`)8@N30!09E2XoA=c9cqz<l8t{oUq3}c=F
z2DwVMm$zKEPwC*qM`vL_Eq~hlw0h<A%FT*O_!*HxJZt~c<g1QJ1A1~5@K=NL0^}G*
z(|i%T>Q%)*>-FEs+_M@o52Y2!xPVEa=7Z1AuzJ!BiC0U<+U-P+zwp_|Yh*nwe|jP;
z{Vy!$%@&pqyX&EP|6K-}Tj!?<1&o$NzfwcE@@nN>|K}$&3c(^XG^_Ku%nk8#$&0Sl
zSy1pPaaX4<XRY~q-53Fdv-~3RY%kY&VRM70hev!192ca>-Mjzh9f34=6fK$6MA8q-
z|5#q$d(}oFp#K3>nRflU+JRi$wSq2#n5+>c0Jo9n;kTakqw6#i5N1l)z2`#O-p3{~
z_Xy{L*fAFgN4I)KS4aMXl3o6hSj8Cc{m+bf2A)CyaPF^mMyB`4?RfV6RH6uRrUL_}
zneos5yyR5%S$p9CHqF3*uA4~vNb5LoV$sbqIoJY?%U;vZ+4U1ksx)>xg^*(&3+$1g
zWN{&PVnjH*O~PEQ?lM~LutUe+_23IxZ(<3mYZK5OO|uSti{UTJwHZI{1+EHQ5eVe4
zl8~YoKlrzG>6Aj#sb**JGqVK$YPrfWiy3H^ai!FYD2<d^;1tC9dpcowVSLql-E?RK
z?0q4*-(|Rb(1WWl6C6TM6}sq>T1Z^??t`Dz*FMzPS^&;=en7^$_pBZiafbbnmE2*3
z^&RtwJ>8>yXv*onyDh%j_b?z<j=MC*1i;OC@B1}DMaYxk8}1J@xmzhI9Lu|x#FD!e
zu|D=q=*f@=vQ|IrCIuU2s-q5`)4%uV`yG^hXEGFFsexSOf}V?kk1fIY&nC#!EiQz*
z+Hqg~#anHryaqKvDcrgd1GaG?Cb5Vy*70GTh-c;nE}H(NMG%A=DUxlp-}-`n?P|6(
zoocAp3Xd&6?A_Q!%?-N8OQhZ!b_Gtu^I>5{vrt7ILr#Q*;9=&m`+4mr)K*?)<jwc{
zJMaFmt9+5VXWW<@Vqw3@Yk{5O$*TChwqRsh@K)~M4<5to-OSTACp7%x_Db*a|Dt`X
zWT*RNpPrG{dwR0T=HtzqZ{0=<r9qeWuLs=l{s7rp-#gDe9G5cMBDTj1*}Ed*I3F4R
z(=(NQI0(RU*8dQcte?*bn-xJQ#CUR6><dfB4hx6rJI<cy`F<1}8M`kiGP@v5^c+*-
zG?~QQuorfDM+|-4B%8jF*Pdz<yef=;&)?yQN`)OzxTcl4UN7a>(cC-ECy2;{T#7{}
zV-a=-Q`@)4W(hq(g{JEsMz79x$q)SdzUNHCPpKREe{QryM5`Z6Monqu4ut;rQOhem
zD;#54`us}#BJW$Fiq7TPt0lsH8>YfXh(FtnNpP#=<5Buz&2tGC*13A7DzhPNF+jGb
z;925>=&-!MW4wCv&+)`a$I{%*ok5X;C;DSL<d0Bi-*po0)w!|!#yQr4yz&_wh2VV4
zb9^dA&iP=^1uTy99qK)L`E<eLeK4HPmm^4RJq`z0!0dJ>Br>Y-jf=)(0e&j+X2MI0
zoR^&9KVA4m(^=fugBY$lvG3P=L^vPH*yCUEP#gedyWaZgk_qirldm-rAG+iZ3|6Z;
zOQt`#8zIi~l6Y$h!M>fsMNG<{S}fM<J<j)z(n*o=k%s<F;HPAsw=?Ry_PNUG6UTqA
z%zd2tX6k0{qBR{UGk?x!<YW&+G<$?Y5&YHD3sn<Nhpzy2$3A|&Mm72oboD^#zL@7u
zhYvi$#xJ@2Yu{wm#K3`3htg@Wz)7?|8WDD&$z?8i8a;As%D^LF>Gs~Nek^xT!X7eG
z&~waDI7Z=UfzUro5#`)CS|BD}j)C7A;GEg5J=~tvYVPVs7SyN^BwBl?yo-a>B_w?o
zdR%j{ZM`>Tt#2+FShd5d?};Qe#$}g}JX#%Ww@`4Y+XqfqAM)=8%*^^6bnSqa^c4<M
z_xZc^@u@X{sI5q#9AgsuKqaPnJGnFVBxU~l?UA4G)V~17y^eSK=N6~x@WUL7yAQ$V
z=6yUJ!w{N>UYw+~mRgZIu@OTnw&`<!her<rMfju7QTh2#iniE_G|s+;650z)F0ZV#
zdU5Mh3OT=i=MeLp$uXbh;+8->>L*?HFRt5{5WLZ|OSvAC&D9~e5Qz_%L_HuMDD5XR
z6;ZLu2f+Z|{n;J~&qLr3&Vip74{blZob2qB7F_Q6Maer_Y)(r498<hLdpdRVC`s8n
zDGKVgPl%OItv}4>jNR(}E+t;UtRJ}H?|8Z=|FDE(Ygbs*vGYSzEcU0<Pt1d}sRh0e
zp$me_pBRBXVcdQ_fvJH#W~nxP9_FSrm)7MTy)UGUR3*-BpeI}3CZ=j@MDT<hqMTDv
z<XAM~0jbGJBCX1F{Zedd=N=WI=RPlI&15wpqWFnoT?nSY!nlH_9uj%ml%smn<H5Ph
z=<N4r8k}K@98IE;WW;xl?Dq;30MQ4IdrMs_+3pl6f3w6BBip*EzaS%XM~TyAlj~`&
zC@uH?y$zl=A8z|Gr3*yW_=I&ur}hKA1L32P=aF73M<5@-$N7Ux4(dB$GUSyO!Y|c6
z)vSk@N=E!|Yh)?GNVJd84VxZ$jyg!Ky1x1)%X2U-;e^z<gDH;KZ4U55EB(kG4N5JC
z&8`cC$(}_1g!GKXbaIk@Tmipgn^^pGM=<hPi&s}1#C8Xl9Jwht4uVil2)A*E=GB8A
zzE3*je|pAv2R|9h?l^t7WOC5%%c<~?NpY9zOd@x&mN33SP9k$7TCcE0mKc3L%AX#i
z9Bo;y@beYX_nPQkw*0y`*9m8G_z`JVb5dOj3>xgc(DtSx{w#WO77D}D$uO!Q97*Z?
zlUhE2-`n==VmM0jCFq$&&V(m8%F#o<xXuHqv>&ySpz#Mv3S3m6yHxagVBUHpy7MIA
ze*K+Kp2G7*|AZS`^P&aYoD#p)<zE)F&>lf1y^k;I${)OnaJdYT!^Y#JR>o$AEd8HN
zr^y9{84-jAB5tNP&G6N1i+KIntfM#C(0hu*vTGP(Z-)JoQ=X`Nm%Z?5!y-XZ`J1}P
zv9iB~b&?T&;)b-ctHFWy&b`~LDp1b^c6cpa31<(=wh<ty#&<wpX71smFQ!gxjaq4y
z1%I6t+$8)*E&D}3kScE@0HNcPA9aq`c#jml8Xdi7X0t|o$RJ8xQI5GM-80y_M`<b%
zEAjVK4>#LMjSHf?IPYMSd|hqlCnvcIB7nslw}`BPtjA`@49$g9hF5-e83&$lRcyGA
z=UAwf_6PITQ6suEIkYAzynJn)Mj`(Kdn{5T#Rg(MX1K<zGD?I(XHq#{Q<z|49mpt$
zwd`y>^?Ibs=2$+6Tm1gJQ4Z5Dg@<^E+DMmlL^qb`lM~fn7mXf^5L;7A&$otevJj(2
z1u+Q-@>R;U<6aL;{iJGlf@{BbkKeKn>K$I?cT-LmXRg}(0Y*Hlp?S67v;&{dc0R_7
zCf5xo^yucl^bFs6+_lj~ogC;r==l}pW5LofiIupP8=))OjR`8aQE1_*?37^fecp0T
zo5!@5W3c>H%KMp)H!1V3EeJ}n(tp=%F7!1ABb&h8CmQ2E1bY^fMqHz8ymuBfL*_U)
zpVi3jJrXxf*f(Bd(_e+tgCJ%8zaIE^JFW=M(^q9N(Fy-u)5P4FEIU8hls&6Vko@TB
zLGCl=(52j{X2Qz5MYRltEPR7AW1_`RZ9X048j6vQhx$Wr>eT`Gp>MegOtQ;z6n}c0
z{KS33l{GBgabLR*_tek3H^%QysPzgf+gIfxS-1NMDEz_<z22@^Ez0lzqwC${nf(9w
z;W;M64i0mUoQn|UlxEIzXy?t?974!pbDUF+$f1&BIj2%d6jDj2kr1kljX6|ErK8Q6
z4(@%vzx(%i-2dEvZP)&}cD>%O)Ac$$pV_X}&*+>;#;mmn!o_Md;1T}plb=HN`j0^^
zRJ#u~J1zB+Bo<o{o_CNp@9=j5#nqM=TO;Ktk&{y@w(jC78x}&NpM+)O6uxDE=`R6)
zCiWcrl6AY`)T-vEWTgu)p4Reg0kV0Yk$Myb;5h-2Cqri}*}xb6=l9EYX0409wp5Fp
zhpwMLf5s)h$n;5v?987d4`UOP$lr@f!-7k%ZQEY@-sNUHDQIMLD*Sz1t-rrV>a6C@
z8f9_%NmWDpF9kq2UAYwfaI;gYk@Z*qe1ma5a`kZFn|;5^FJKB(w0n4sRD7;cR%S(`
zbhf70y|(Y0?fqgO_E+JuucTl2Hf)S@cBQl803%tGV=g3H_ugal1AwtLnwQHNfwL-I
zB2KKcp?2SN&#5=^A)oii*7&}5^HUYq-2t5&Se6r%9Lf@#{Tvr@<yxbH-Cy0k_zfaJ
zeZA!Er1vIb^(t@6Z1bEzQB4A=>XCgS#hTC762=nklxF@eEf>d{&<)<1Puz9!j?G}v
zbL-}sSBJ|3yTY9hZ@dv{UW!ooHhuqS6>%%%oOG`ABP;Ti=ggH1&Z<C3ntA`&mRxqz
zrlA;p4W$&vydF=Abp9aB#(LI_)U%jY==&*E<b992S=TTpO3!@yR}^AkiZ#zKaUXi~
z;dGF6@IrwtHvS&GNc})nT7QuHhqD*sr$O&Ih87V=-QOch9ZMO#Dy*{IdtrlN{1y2S
zi<riPSM~%A{!O@;FhVS2&JO;)+Km&sp{|V7%v4;~F}2In8u3ExEcY_T-q+pu_V>k4
zD<@?u=7BeY(!Wfr#am5X{{7Gn|7uM!C>ttrYYF&BY=fuwcNhRwh{=w2(JLV(xoE5Q
zI4hXfmAdbFuMo!+hDrSDs%FXS`w^<<%0c7NA?9^brNgu15eF#Rm)o?;DZTH-Pzn-(
z;!gp6t6Qu@|1R&|j{xxc9LpuVw*`>8KJrR&hU;~2AX5R&#`*rgs#<dfT!I*wbjb$M
zdjVU5>k0^-qPzI+jXsg-<$Q&uX^9}!|C3MXu7yHHhm-iflEphx97U_vcWQncUJaZ)
zp8en9bp7ve%8ypzQX{3W!#_G7>92Nv``&<?J_*X!px22GE=j0bywLOBI_~_6j(C0F
zdvd3ENVZuYd{XPu3HUUZMmi||WAmD5-dcuQ*0e-is)G2Ql%t|I)>G8m2g<2cSX;5)
zfs~`R#*iQLTV^6oZMUlcca9E)oJe_8D-#3gEu;@lvAVAoh<Klk!EQXz1x36G;hyBb
zdQ=ml6}6l3;+lkdfeQF}ab4Lm4GMl0dMb6V_~(=f(S~Ig=t#GVSE_RF&&?{a@U<Xl
zFdNZ(KMC_nE%VF_K_{@`Ch552m1+1v=37y$n~F`sUb-R;rSR|YY1M(3R@U#V&X>ga
z3gU0fD>~AsdfN!28@-ReYr{N#>Jg5K)Jai<h!O=r4z{9=)XB=0b1LI$cB7DxPkz;x
zt=E5m^T6tHPZ(>9A^Vc!`Z%FZe@S$U1!;R4G!$)syCqZ4_ZnSNTuwwD#}!do&~fBV
zKP`m|8%u1X9DH(qU)-i$x`o~KADaZ?UKPc)tg*TAC5ftI86LeM&SB-byM1j^<@xT3
z;;j?rn?_vnSym*^jOQBVIi>lDvIL70#^n)_hT<bL%`;EF^i+Z`cwH^q96zq(KjStS
z@~%@FBIRu=wyHAc9tEE@t%!8Lc5Co-ahk0!&Duz71lH{J&J^nU=@zx4CUoK<aSxu@
z|Ed~7k~=DytJ2nSO(N=z{rHR8*^X-m4Wjau1A%+&1pEh1fWmD2&JB(aImfZI<PCpb
zPD=80n^#GvrnX*^4l6XeH$Ejey}+)c9;_a}H^6-BhT!1RC}}jf-%c$Bv69R;g#R@s
zW{HW`mEUOBvQIpG#7yAy%YhUej(cze{n9+iG0F&}<Y6(5UtvzvKRmI1o${#VlK7pE
zTl>Yk-gZQ;-}V-3uG_pLwzVJD^|nS&>t5vg6-7k;=`B-QPHf<^G$3-l-COM1u7ne>
z#ja2`Z@sr^th2sb^3FQ)(Z2R1r>z~=G}HjN&wYJ18>|j(>E4|zv1gZ@Z?|*3<J;el
z4tzL}?g)7Bwgy4h)@mOXyD{$E(jH;6C0G)O$^nz!4qF0h0qt);G|#W3FUbp;fJ|xS
zvBw+cq?TJBXltE~yu@gK%d^ioA%22T)c$s${q1zC7EV3gmfmPcZ=`%%_d0*6ulOlQ
zxkxHOD+Fq5{-H`YB`j8q9i`C_LqHqlN)G!zEE04QdK=Tj=`CK<qU~`V4SNps-8y+t
zDn>TnAzX)~3>kMeZG%3s`X^HYE?m;@8x<igQ$JEyR-nY>LaV=i8@rQ#|E+Cz?)L4v
zSX3YRrop-Iy`}NntUTa|aid0OCC!o2oC3p5D&Uv8{liy4t&h5nPpvrfgz!A5l5Qkx
z1#~h6_G(fguw8gT(%nC%_zIV}{Ho}+zpbl;bKe*@@v}wG>5^yjNZ%~e&iVxGqu!^d
z2zQb-E=s-~7GCXOrImS3h3k$??hLqGaK5`n?nNHy+W1m;z$fJ4qmXQ|z{!>N>5?JY
z8}r%iGKi>!Y9r@QJ{X)pBDOB#Qac$qFspY<<{97pbElxO!(#(|R2|jCIWu_omEz`&
zSEr7z#2H0Pv_9~v-i(f`{~NyL<|{+W;K@eYDcx|Z6r-F9!i#xD1uxfox$2XGDdwO9
zhRbphJ*pmE9#w=cLY0TAXB@A;VSYG0$Jvf>jP;!=xYbKHl@i>pDH*99xp<#a+_vSt
z<sIL)oHY@D;ia=3x$GjO7f`Pg@>-Lg;K{{~z6HO4oNw|el4c36j`!ZdJDh5UJu1We
z@RU18JjLbR7#-NDWM(USzW*!*glnz_bc@}H;AM;sC_<*fIlo2lQJz)t<J@TA@W)=z
zq5Hh_djn)G38F1JE;#cYFjNaXvY$Ru7{<%E_o^=%69jAl-dFpGb*+WT`1nuwAmm^m
zT~Fe@X+O*QKc9+DJ?(}Kv;|_!eu7_5dcGFf@?rBba{|JB;Bk<x&;wB$GW%wHbsxU$
z%ab`ORuM(6+n9tTxp&jM`b48(UqYiNB9wPGTo`tiue1(@LEh;5J~TK`B0|d@_<XPG
zF6HMPl3CFY(txscMP_at@^9XKnVC_U!lf?@4;=JzX&+-$6}<IMPxsWnrhNPDabETO
zu-^C7G<^!R{SB?vL2r%fl+;asyyNnB_!qN>Pig?jN5i2%FNF{v%3PS9@OF6Du5shb
zV&Rt`xou|(>qIh+XxH42KmYh&`{REXJSL|@Uxm%i`zVPA%eky`M1BMIAk>b&SK{A#
zv@mzDTFcPtM_e<!=Uzs;Xom^j54`0Lxln4@45GtQntj3}qO&mpsJP5Q7P3s96^&%x
zksJTDS*0u4S4T1LGv2wQzA`4mK72X-cx%Mmo#9~Sp6`S)OkL)f*fgm39<u^a15gDh
z0WJY@=^p;;UYtw~Se5qWCt{7kOuKO9nJ0iOz*9hnPw|;qYf;;+V&*kzD!x&6^wPhJ
zz6Jw^_vul)?K(y6_bwjD^9N93Myz6c54acx6p-z8{+Z8bb6k~*cUKt$tRjRrliCSB
z<ok-fyV&{+Fr@)ens!eL1bJt(Ze~`sX2oLrNEYyl+e83>MsHjQBz;uMS1Xj5O1u!~
zFt6snf~e)XeuSB>S&XEzjb93pvlmBGx-OuY>o!uc1~9oQ8AHR4j<G;#U)aY>jy8Uu
zPvpzv-o_4%YJWV!<>JX)l+y2{;;zu0RKlo4Pvx`n6LV(G_SHWi^s3a*w{j03=yXI)
z4!qm-GR^fAW=|E!k8&t8JV{tv7iSy(Jnt6+SNhl7doJyLvvX7Wo9W5hh;N!<gZhJ(
zboEdJ`XAcfPp!+qoI{}`!SDI8)0&6->A+Ns#>LZ`zrU<{C|=5LXO6u6L|q}~6qed7
znan9h;|?6jgtE<zVX0n1G>HQ1m(LtE+I}x^qZO^6Yinvd7+a^V1?h1LY#ee;%pq>l
ziSoGK$G=AT0{toyg6r3il=keDfo-`LdZ_74=-}bcy&{)SlF#IW+hRY5i_$r@-lYBh
zyQr!g)4L*6?TCZf^p%a?46Lf&%%GX`Gxu)?UE<)Yt3~4v{1?Hywy`br8wUL$5hjHq
zuWAuv-IMWwzfp9@$z<ub*j1liT1C*et>edqTps9gEh8tT)QL8~SCHM~ZJrr4T9D4B
z$mF9<r8hQwt!;{wFEUw59dN6xOWmm%XlTI;5YFIt^IKVY7h^{bn3Wwf{04DRXHH!4
z_E!_$=O{x;)|jQ6a}~DR0DsZH#$E7g*%en2@=#?`Wz2b$h0f#O8O6#EblYT$RJkoA
zlBWoRC)yL7&p*|?62Lj2YFn8wYCYByK=oop0nB)Z=w?uh4U?kc*)20`v#Up*xnIi)
zf{b4pouwx4xef^2;VcQ1dFD9~D0XewV!Q$ygU_TidqpMtQMxp2{0H1!E!@WZ$#IWh
z8#9KxE9+ZO!`vFi`OyeM4IG)ke%~Bq_R`DwSi8UMKIs!G-VgZ_UQ|Gw$-T~>^s!S%
zI<V(W7)q<b6W=a_j!TK(6oJ3r0Ntlu5_b&ez26XF20i||@UJ-7Yaj_S1(_?HZH!8*
zSAQ?z+g-w`csTHil2O+C^QDdx4fnlux(~bBYzP|{H_T64NdO$@OrrDXNy--$(LUHC
zpiZB0afWhL3h|Z(XTe}Cr!FW=z60bf`VJJbTL!iHL_h`~aZ8f^icuEVEu_BR9C@5v
ze{5&{J%PjZdPG{CN=015JYYL!*LI8uHY7U%J162GqF#Q|IdJZ_=*gDdr`=4y*K~-W
z8W-Zu8yV@U{0Oisb7kh7EYY}2Q-Zc^!(<jUcNkl!HtuoUkFkQ7t$7<=S^IHIf!GzJ
z9e}TBI_BKk+sk~bA}6l0t=Y65+ykk?0W8-$KPMt(4yFNBQD6XWrfDp0YDwjxx=NI5
zV``Xlcz#&%J^^ukMN1`}AE7{cw~D=C{Pb$-)Al@HEi0lea!F~}7~m{cB$yK)E|lvX
zq#t~Eo!_Ifq(X&Kt53tMXhv64kLY|GHi!L=xHr}LFR$=l{>h3jjxW!`^v?U{oSw!$
zRi%+;(L5hTo0!e>x)@(?<n?=nL<wF{^spCAQi3Sa-xlAR4gRy=NJ3T2qFO9VGEuvX
z@sR$&<Hh^O@4ZX9InqlF?xKOu9ABL4+Pe-8)~`^~#NeOoEle2~JNIm0Wb=6vT_j~*
zq-I$*V;<rc&w>kbP8>tKx)fW6Zx@;VsZ8M|41+y)EJLIl4AaLkIOa1>n`o=)vZ5fz
zKM^^SF%5DpKJrw{imcTwZZ>bfMr<Mw7+!8*#3Y$+3+wltGRux|-en0JIe#TQ@Y^X{
z+zV~%j!&s;a-XG22Qtp}h(&KzXCzxnRv1dJAf2CnK*{#OMnxQ+slpP9GMHO#lWtok
zF4z5C$0t2h5h$<M*Vkc?wwn1fKVG;$))Y=@Z@<$4g8b7)Di=0rFFCZAjK|&w-9FRM
z?vYMy))7GZ6aU^8kukTzIC1M25Wj>DPLyOz-%=xbibylI6O~IL8onbM{-5JKuMexw
z_>gKeaX6<^TKIK%<kR^$8rnPTU+dbWa4{BXvD@5IE`w-ghYemtdq|-@6eE`f{!7e<
ze)6?hQW7Re7n8J||IRwaee%I}gVp5C_L!h-lcyc~M@4P+W6kC06~8Za2h*3?J^$h?
zMfPD^as^6?^2D&Y)Xh_7)3YK868+&5E)a#`{N=g$xicJcX4B&Vf3LAo%**Rh2_W{R
zqN4TzTpxi{cZw=P|H3M|^GQ&cyTq6~J$L5dRT#}oa9^SXwY~A?_%2lQ(%Yh?lD_j3
zY3$~u*N?zIdqPMSGD57`UZBw>@$8-Axzldc7{b&2C<i7>hQEdq%K;<awws%M0jU$j
zJ_}ZAFOpQsWp?7fpZL(SIz69#Pr-fg#a;GP%4>-Rd3>6G+v(Oznmb1Jf&;Z2(wz!y
zjjm1}94|bnAy$~W+0L$VuQn84@J1~$y2cy}hm|dSfg6FjPmj#8VY1X>>wKUKc%Neh
zUU_#?0PNsreK1qZEp^ym{Gg*@oV46X|89;W%$eIhLMI3jFAvZUQO3E}S5I7k1&(<@
z2DH^BD0<}CavEwJv2v3=!ZM3XEE>hFYU2?vC<lULL8JbyX2n{sRA^bZ-<yd5>5r6B
zO*h`+;0n++Yh#jcHi|vAwmUGJX}+;`6p+g}(&QhQ@*&lrJkXr2o*<}v!T2kJ4);`z
z8^^ham~gfEM_$W%>+N<fA{lQ$0MeG(ZF_?OA2+Ox_sK~V{S<5D?_QNkt$%?wQ57X#
z|5)Z9E<a*yfQpXgja%RS)wem!!O|(Bm(NZRZxtZ{Vm|NFm(K8mP`ls75%5lK6w0SK
zme&u*NlNZW5U5Do8=9E>Rq{675mn;v`mPrjT;(4Bi5z5YzuxlnV8ZWx{xXM<873Qf
zUa)cuGh#z--RKS=@Y1j20CPBYT5k8D>EwSXz6kHeRT#?}`*7N*`|`A&H|o|4<pSN_
zI8^h*2y-O%GPj80Qf2>S@;82NhP2&$Y)3-q1wDZxYScPNtU-**3#A~bL;wu=6z%<R
z?i_8`;4g-qUpYbVL|YyP`6NNOf-S<&7YnqYCRDc}_S|_{k4If-5_Y|_T`!-PCt}c0
zT8Fd?GLUkYMC6<EG<gW0^IRt0y`IXR$HEeW-fBT*F#+|+(vHD7zn~YuMc=N$U2!Sb
z38O#{BU!wB7v|JERR0~sjvT?Ni5$kWmHqBc(Z!Ad-^bD^fD$b!_ref=2XBrF9yNto
zA7rCu-2QsgNeRdMlGhoOJ(CIV>jF#mCY~wY&_TI!Br+!4*&H4$kQo_~Vg3UUWDN9|
zYr=TeBg@+IS4|F(vO~6iLsXl79Fmv3bbZy9+r`a#n~3`4cOB!Kl@a_m7J`a4D@{Fp
zeb7eJd?EO6<S~#<onS5uFR{K&*P6YRY=+AUMCrOCPjc>0bRyUv?j*g;r_J~$58FU|
zAIiL(4WDlHqUzI97{_)qQTzL|3_t$9y;TfEVdl{sZJ2(r+*J#`1E5;oYuL`9$c3Jy
z>nmFJ-I0Y1)LkIzs*b{Aiy~iKD|WOM4Se3BsoM@ab8X!|G~o$Sa|bdx*-O&{h`nNl
zZOaQ=4OQ0;S6qnG+ZGMh9Pd4$e6=VGIupVi(EsoYB7K5hw3ql@d9EmH4-cW`ihnT<
z9eLf&H_38X4$G|LhYSzs_eh~u+6s^-?z|X=e*SPBGXEmENmE_O&OQI-@*@Yrq2RFt
z1k;dTFB1=)+Z~`50kMXdxA#n1&NS}D{b<rZf`F-F^7alBzf=OpugRT~jub;W%$L9Q
z{w)8Vec||(=J5h*-R+R>I}Zb^_of*<|K_|Q;(2P|5Mb$eVbbaPhM@}2G}Q!!&%WpO
z-hN^v-Sc>{mU^gWWqhwRjnjxcq<*c{{S=F^i1g2&CYJ!b6141_vv6+*!TUql1G8!#
zfs3DaUrt)y1>uevyQEUO3^1`%MKxXmt8N$uG{dKA$z1dKe(SvlJ3G)bJL!7XfW6;K
zWFl&n6nr?=<+bN|O?~WeXeH;475iv;#%q>Rq#ZPTf3B@fy!aEd3I5m7iP)yQUGk^8
zM3o8+f#-exu24E}{z<tL+c#kS;+2f~*R@Hm<*J?f?+22H9?$Ey=yM@+nNqGwdzxLH
zda76=cfPB%SYcy#f<NxKesBBM>|p>R@zbr)<m<(wv85j!ZoYYbmrsdhpl5=GW>llX
z*aIJli;3Ke>u}8U0{^n196f{DH8SRr(|kdJpfJ%M?!c(d6!fN9-`*>Fn<EYQ<I4XE
zL7h%n0D4ERf5Gf#MQS%1V|{$sa?wh2V>5ZqTa>QD1Fi5aOmECaE~&H0^NrPwMeKtm
zDbw)?cVMU(ZAu~-rXl{7y|-HV!B(`vv%i!_sD|^F$B#>IW?WdlCgB6o5D&Vz=h-Jw
zz}Pr-2Ulc+fBT)ddt;8$jfsejZ#XlFSZ5mjVuT;1WMJJozthIk{DngAyCqde?gZqv
zU?lwaW!|?yOo*x@=Cs6|Mcoxm2=M*tN0_&!NLp=E)T@58JOh?R_s(9u73IY%0gp0L
zHd;ZMMe*x8iCzMjG~Ye`8ddXAlytPypo3Fyu+q#5Kv&G(@fOQ*v^R#HL+s?aIjcd#
zG8WJPS@P2Elt;hxZ-zMfPb{RBsU}^4b0ABZz7t*D&JpNi7jfJ#4QKJ_SPPyOoB=7D
z?+vlilAWH0j*>$)=8K1l*LI6N1;gJ&&wD!hE2;rJj5+2S#fjxHtg)XcbRe|bn&>!q
zddpoEH@&IIc6ZeJL{xPQK97Ou&#CF3Rnrf>{~c>sl$84S)Bukfy0mfpVxFO$qS=jv
z0Ut!B81l%!LIq+D#V4C+IxM)quDG0E*YzZEfMhj5yzKrd<coz>?@7lGNuPj44TF>F
zsgi@aY3hz6>27%;bUT0at(T&gA0u<m+1>PUtw2t6OHPPm@HN>chVJBnlgi|+yhDu~
z{KcHm)(bqKy{q7n($X{{qpad&d3bIkN6n-4?B9q=QV=+CZBKyN?f$jE4X^quQfl8z
zMZd|9J+p}k+fd)>v|Sb3rLf9EdSlL}9!hCmFX7Mz?VOFfhk*Kn+eWA_9k;hEwe)5@
zb;YjQH`Jb?x13Q>IHdtT?*&*s<Jcc_ao5JnF!<95HOz0#DFdmX&a1ZDyZYmXQpMG^
zHYWoHcgbE;n_$r-lB#P>eJpdUV6CBuKkc<!F6zPM#Wa@3C)jQ6{6Ff>jeofKiG3lh
zjy3n;<c*yh^MQ$dNTdC8s)p*bHnr)}Vz(we)S(p~q2kW=*R%1R&fCL_h&x_Ij8@Ou
z`s3f9luAnvhW`{<Y*i0w^uZT86F1@kelw4aN3OoW9Q5mM^tUtgC$|gx^9TIRq5LhI
z;#d?r&~|(kVOr~u`)N;*R!)pirT6sgF>3U^w|!cy@hL_BX~Rd+2Rk>C<=A6hIp<KU
z*1Zcm_u}GecT<ce(WVwXchz3)=MR8Ta3mlgt<gc)^v;z3Ed1#W4ZnmByy#fryRkPU
z>n<qJmau}L4lkYt%XcO>jhA2(i2IJm;V*qpNcKIC86nR)C#nPivqA}1FC;Lxfu#@0
ztbVkN&Q(N(QgzEoc3(Q$<uKvHGjVY&jo;(mQ>kWiV5wh0rxI#o$$#UE@4-_mg!h8l
z?0fG_$H1bgb$1T#F5d5ViU{bR9{mW%zPqVqAVmOYzcZB8-+8#&H}F75ks9$E{?yx7
z7ga1)gm0B&?($m$t43P}W438hmj`u7K4T`UrR2UB9o8WU8O?WW7NqW9UZX#1mOp)Y
z==NcLwdPLW^e3*!1QPXOpuXzbi?e)dLnJ(Oy3MBHxkE&-$vFOp#O(WnS__wz@mkDM
zDgo8Y2D%3^g5~GY!IXFK_Y6O5gC#~u>nj;t(ID~m6tTjBg2!>jR}ZbS`2LLr*a|7|
zS@^49k?u+HN^y|~TEC9$>iKKd`H^v~J0JX3i|4KXb6`)f@z>eP?agC8r||~-8y5=9
z#;@!%+X77o+nsNFF5h5w3AhQd##{t|S^iF?F;hB)nd5HrW=Y1_ybSY;MT;d{P6}#M
z4Pn^Qh6F3&M^UFou%3p#%0|&aeps-2-dT;Ou6I)#f|`v$u^ln6qXIkgRewZ4YrYgZ
z7!@aj#;s?rT`mARAz^ri@6ParZ5u+oS@82Pe>*Fe>4lX^mMMEu)32oGqQ=BTrFt6|
z4}&+S9<V}(n0Z;dR~Jh<c3hMJJtaANsa#5IJDKJ2s~A%$5tVkSj2-32j=oD``aNa_
z8of0|OlP?y<TT2qY*=O4Agn_ev($?>8pji>X;u(ZsQ+NQ4BB;`I!bCyif`K|9N_0V
zGW(oVlB9ZfgBhbX_(=b@m_@+ZiQZbc$i8xt=%FEoF3?!*Kuy5VuY~@Nf!eP@>|<Ge
zPxTVB$5O~muJe8hu?L1*2rD5Bg20u{XOh}lc>l~$Gxz_gT^|_ovN3b(mId@_C))Eb
zfqF-;BklXn8JW2vXrF;&@bc#}lKIPEm!PF~#EBUb?>xVt7CV7Q3Uiqos`uex_|Zlc
z?M6Op%}_=5Lwrrx+c)$Bg-;ha>Uv>jJ&$N+$(dOqlejqxpR=xuhey;hQs)<;*aKSl
z31w@$xk?2-&53pMGk!la{pB9_kE?mBNRuq!VN!nheqwQHNsxN|G@2udk2{)x>h)6~
zy}Ug2L)EPb-i|P-?M{r#jc&Z8dW5>u=Gp;6CBhxYf&Ij4WsZ5b-9A49c-5iMMkTV^
zH?yT(r;&1VaI_%`UQ~c=i-J?p=;nk4d8MKhj{NmdlUnVEep1(1J0JNk_CTUhy;(^%
zjjAYpaSx*FzdiN6=#qv&pgf0<_X9qF=CsjKZ#bAl9DudVhdCXp?~S{68YbhYnKzj-
z<OtS}dyiLi_<Ip9{J#qEkF_<Ty!_MTo`e4MOz9Z=oI1$gySG#1vz=rHk<+&zE-{OH
zz;C@%j14@lfN|tBy!~ibUcq?3wtdOo>A>2yvO4O{jY~h~jsR{Q0U+-%ZURkFb>E>i
z9LuWD&bkE;odCS4mMFXT=_>_D_q^y%ON&oK*%z{d5y?B}_0-?7!j=ZMpI;gph~IN^
z{_ne9%x%bdRFhvxg!gU?^~Qst>v3)NM;-jEnEpx;og9aUtE`bbw!W<XJzr;l6ka_&
zFYsdCvAZ(>%v$#Ch9w1LkxzNs2^a9X#Re)LW=WOcnZsD>+!;*X7Se1!02&Mo??y{j
zaa+g-MUs2ZMiAzyFnzEhsVoJs4E9E+q8cbXF9uz}8a4K(M^fiUvI07d1%Jj%;KTp`
zni>oYX1zx0pcRlCC}tEm+P~L@c@ffro^yxd8PQZ*U;+CtCXyiT!3-v6Zmzj|z6m9H
zoINT1TIJ93o@zL^Hp%miRDaRpkq4u?`&)P;E%PjIRKTFmseCzwzbjrFVX#t~71({$
z5x?bJPp%0K!MNO90PbM)2$F!d;EP-?j)r<{vvIt6zGBNs&<d;t?gvtU0pJZ*6sv)4
z&lVm36wr<n#esdwhzU`2amF#Bi*N#j0pb8bfaA<SrVBb8zqrTDzlG52#V~+Wk}NU2
zRO&vK1e$adx|bgV<ghY)EfI_r2#p+qA;$2{fUTT3lr!F%!U*Hr0q4i0@w(0x>3|?=
z)#xl9O;+&Xr7{lEx<Q(wAQBqh5zJEpRPh-g)zNM|I6xfV3bNoazQ?VIVn>*LpuZ#q
zw_6n^a5F(lo~WblpNsPEB8zqZ)S{JRFgM=kzLvPq;Qs>oO?S4a*bMQga7_Ngu~V1&
zZyW|@v3L2;dp!Ojy#iL5*S$vbfndj91q}ML5kFxP)G{!WwGqbD;peq%UkhTP2aW`m
zXEmMNBkq0kg;wID(ooZVVpLBUX{uSsarED#f@#ls_br+eRX{`!%=b^LOAs%}Hya4i
zn1&d$1lrInSe+mxVhj(178`-l(JEewHD{7d4ku7qwfeQnC${P>lKpg4@9mCS{dnZ(
z?NGsrWd$kB?1_%@myVWFzP22-ct+ol`WY<@I7Ge|q!>Af;kKxv%WLGaF6U)~pw@JN
z2VV-vV86q`PS|1HGB8o<Tb94wx&BZ(OpMwkKY0&@p9@fMu?}WdP}f1joWH)|lUA^4
z!AlsR`^;bBYyHVZ%-PqY7w;B9b(Sz3*3iJJ<O9Hl|BRIV6PQyN(K8?se%NkhhiAgK
z#Qi2$B(qr(S?P6Hxv%d=-&C*25Bo#oJg_f?djs#<{mkM}#i&+wbCbK5&yOfOKK#e)
zd#4Zy0ea#`@otRqC!XQFp3nwr>p^GAhGJqOYm|Y}t@=zn3sKgSPHT!>gvw7VMk#cs
zb!wN}uDFB4XB<^^(1`kT<df#Q@)8ZsEu9{uUOOYszseDrsa#Bvnw3elSD3_@WCOes
zpY?%~3Kw6!-s69ZvR|<Q2~XUsGO-_$PqvH!FoFA6j;P81nH%Fjb6as?Rse-?KmG|A
zs3#+uCdqn=oJ5s*F!kUdcoC>qt$x^2Low37BT;RI^Fr_r9L$*raOWulJ_{Z|+Q%pG
zfawUB`8Z*TwBk+=VHopiG$n8a#{~~3>!x(3!`5lapvKX|B+^k`AEGqlI0MGm6zrJb
ze!`Ey#HpRfg$H04aH$I|?Kq#%Nrs|$Xs84e2SWg;j5t^Z^E&l}pdFY1`~g10h1?th
zvkDxyYlTRhF0dFOy$&j1#m$u+pS_ZRqN`HRup|N$;+ZuNke@Sw7sHno8X5^XkE#%k
zC=f%0^P=W{y4VULGlP1AgQird&_ubB&O8WJ8#u}8#w-yMNOUu5;V7KK%b+5F%8sm5
z&u11AJ@<sTN&m)#xCP`2ALehMK1&f<;6tRq@H9Rv2aO=Xl|A=9&o{x?;(JLI2dRgW
zid0|XjB(ik6)DU}e$D8n(59Vz=&1}#!MM<-GlV24mO&d3W+lHaxozRQX@|n+n{G$W
z+4x!bSjG@fLT7cKKR@f=^SSl=jV;g!*O4GiUh#&8!Q7&p;-rt?dHYqGESyN$39uC4
zAxY!qq)8X?jE!TA5di_Tz{&6vMTm#+{70{&GKd9m9lf)6wN4Ycukcm=Lc)+6@+Mk&
zsceWB!0kO<$)M|bUL0$SZO>Y~v<rN~TTj7R(OZ|lnHxuKQa@mN_;xrA%>tpMF}-1J
zJ2ZlBJ5harbL>rWf)7I<tg%lx2C)Km!AxSsu{>|#)Z<TrLNxOXSka#QE3tZ4NGW@g
zNu(YH5;?{m)@ii&EMN4m+xM#g-v}!NYb=1w4+pxBji7~CA4eIk!kIA!`!8z0W=b}&
zeSz&Rk}FN({ZK%*x$y}91`j-V44N0pQOG!x&I1ALX&N9|DE*twhu1EIDre_t9*P$Q
zn-`?*YFgI7FS&}lcY>Ie0$Um4Dd_V`5%88!*=%77|0x?sU=0zX?f8KM%CIXmq6)x?
zIYYAqKjUWl1(SO{h`|6;S|Shz)CVR)#Mwiht#{axBLi#%%bgX+)j&m~$!Hon6a6y4
z_Gkx5*xZlmq;wiGPr*J5M1VCwwdvLhN4ndFXN4OtpwsW6ea*!AN534bqi6t@9!?>E
zNumOQvJYN3%T4`TPIc%_5+K`2yra~6Cr}C4SY|WOnDy1db{ZqU@AAO^RJlH3?$=O$
zT+<O#yQ_`+5@`wN0p8Dg0{ib&Tgczec(wn@7sb1Cr>FVUT+00jBi7W(Cl;FqxxilB
z^~**^iiL9UMM1iqvC{(=;BHpNzFSAY`$o!y^3J_4*^peZ6C!@r93zd-CevM*H8A$;
z)NY~LW)giw=T%0h-r}8dM@E>_{*j`^V8E9f1tO;;uBHCFplfAYQU1X3{?3dM<%H7{
zFHm>xEZradcS4t=-`aP=phk0-*T!1Ff$;f~^zc`KMii6ZOGdbkj|lbSz}b<TE44xY
zV&lFakNYgS^x1gnvt`^6s^ek5Cbp@PJ&{*4Q3;&**)EeU`sT~VdhHhX*h9xa=)B%T
z&w?cl^-QT+F^}$~RbU~yd$0yn<}nMm{crphJQY`{gbI75F!4o1i<1}7s__O@W7Ekv
z6HPNs@sE}239@r+G<C1PI#hp^$+-I0bgUt{@O3~(Ff$YUm5_~MmSC7J8CQ*V&w8*P
zlAosDKW4LI-}{OEJ(G+8p5IN!u-EbI$300;V@nQZHpV)1T!=_@<HQq{nVU2_VbXky
z&_te(i;d1bR3py1kDPPu^koF_r9n@L3Es>X;J+kJGHe3a&UQhi5)>#<XTUemPke$m
zOb!@6GI2Nv*Xbrq1FV66#w`4^cAmI>WXQiedB4Ur32HIedh{<oiz1G=5DK;BT;_X%
zL@*tp)4~ZO``1PtCjibkyLuMmzh}rG`ugo6$~;ucB|n7Xb=!XFUcWhfqNg%Lo7I*K
zJ>1=5G07}^>5x#u<S{KD6DQ(ompLCq{}`kktJcA*7Pg*tR90}s+3epcA)SFerjeRz
zPsac<u8ODkaR+eU8K|8fuwUhzzURV`rTw}u8nAV5Ju@>F_PkDb=U3v$38vE-?`doM
z95XhB2};M&&M*c~FuaTSLM$OhYhO=hoK4hFTEWWA%7+On35F^MHARlKAGncP@vMC3
zX)nGL_&h2S)!_$4Fi-EQB;Pao{}tR<q2NNi7;+#J6!1|v6^B`AWntyNX8ZH6$sTn*
zv94nO=#K#y;xwhsGrfP()@cI|69?WxF@A?ixmo>oqCP|TP5vuCuJseuYMmnKW=}oF
z_y@X<Qh<Ix%Y%e-4IxK;6*749KeK{O9J*kW_Fz_0j^n$uL8(M;`U4s0F1@1nWn3|f
zbEv#8x@_kV4Q7RBDJz<uf%~){9y31wVRoOa^q-}X+N(cl!E7ey?z=+^2giN0<UM@{
z%C-oHVv6-JgJ@V0zVz`}Y3Eq!!#Aa!;VYv1auXY({Dyqrr<j!%_~$iC2G9e_?L&@M
zyL|QV?>FldADuht$wE8M<Q%$<c=l#d3#eFUH~QKPYEY}ZbU4k%8uE8_UF#KD`~;&1
zXv(6YbWj~QYpm;~8KqtlD+QCC0ILD*^vg!lT^QehVeGG%5|;`J1J9=cQ(0|DRRrA+
zM&mC5rP<~fRa^tv+7l2$m4swqB1sA^oo;|A{u;N+5HuVf+2<UO!n4d4oof5)Ugr~q
z#M>8gO}=@D<q>D4Wx)O+M=N3hhiNE~g7l}o8O*&I{RzyyH+nM!d7@6?PzANmRZL@z
zKg^3&uNI>e!Pq_n*njpi_@BKvQl)>jbpO+_|EBwaCq$6v47ym0)518a1T1mG7Z6F+
z0rI(3<jx@KgOTf3#6?5Ii}e&|m(~^~T>Y42s%ePg;_O6l<9Kl6XmI05LqSD!Kl0_K
zaPj0_f3wo+T^RT-Pv<T#=Jk0zf^3<*aT2ykivq?;0s8*EsWm?l$^`9?JnU9G_~>7)
zfqL-B5}_ib^!xn5{1+M$T_Vd;B5%sXbB2ypD#qn}&Tz4gb)Ee5!DaHNg2Se4)^)h3
zkTS_p>aS&7rj!P`R7bQ~3v?Zcozu;=zYH5XcJ6Dhw}DH62czx8NB3Zj?Sn?!AEOUD
zb3Szas=0!3o%(zEpz$Z@cZEkE!(;91Jcfi274VBlkB`tlN12_$F38J)Z@`f!laeZ?
z<`|E|G$IahNa6h@T{r=}<N?9^na?i=pGVJpCXNSyzK?GYjsH6vr;$<8eVa=e>6V#a
z688hk5G$u5X6Iy8?zpV>0Q1eW?`X@UBf{hYc7?^hk8)g`Z9Z5`Lp+#>&x!BZr|uY?
zantz}1ADcs5&m7Oc-4q1OhGuA1XXgc7cVp{`pvfg&wc|;AxSrRN22gdgi9wu{0Adf
z{W`&d?6G$5PADG;q_Dms+tKr=PG1<BPXb=|#U6u6f^Q*7INg&%*Qf`2O#tU}%%}{|
zgOR^@QMV4~&R|9_wKjo>ig2{Id7pMhZiPAUsX7v`XnkoxO(_aG4F6V+1WQh6f(8H}
zBm2XVd)~Sn?m7?5dxk&q@HlfSnbn+>{<SL!I|Fl)d!B6d>}Ig5V@kCHKMUN&H6oVy
zhaf7n0J8XUXa?PEVN2qRoQI#okNYLC9x9c#13X(TrCcZ5g|hrFs|;u3C=HPeAF2Y-
zowG&W&=T~FHK95Z(@dGR)J$;pXd<!1tsw)7B#Og+)8s*8!U#}B=FsTUj2zk<@Z4xQ
z3P)&yD`2sybV=A(fj!t_bQd1%FMgD##C%GPq*4T1LPGTqin^z~PUSmXy?2YDbi>}U
zU>Ej4WO~659Y`248}!qEBVI(f7{lN~1Z0I1%x)ly<$<z5>Ef(03^)}BbY^$Ki3h2F
z#>5>r#?&1*Sg)~R@lhZgwv(o>0Goddt1E*I*W{nk$*+iFNbsw`%_Fbz(r^y83^sBm
zHyFS1mHq-7AN2w&dpVLwI%wYqH!@>grLy(xZ2I2lIvQl#59yrU2w{Gs$$=50zW70>
zUN=Wn6!03z?LaMd*Rk&rzHo-(xj-dG0CPhi0sKZxi$5_So&SKVaMsrT+2By0^MBC_
z!-D~yL;j-Lu?i@jD!+i!<N-ax_W`PH$On;RX-YmuT-!6;7h1Qf4+(5QJsfktF4vV4
z)>^``YZ;+rpZ+IVDpZ<rjyCY0WRbOmCdU<YM=D*Mxj?fAn~h5RPqNVeE7^V^v<AF|
zJ>#0(`{GAv^zU@d^^6<>CmG<&-(X)wSrX~qEnF9@D%angP0YCsI(xWzWd3Jj^fx(Q
zWuPc}+N+B7pob6!tzV~Jlo&ha9JF8;Gt*9=f12+4^0(i+(WH_+<|etr4{Lp}gA3cz
zuLuka6n6a6ry-NWhceD}<8Iy5NS)VuCc48rOzn`MI*j(M{rX47{gVH=G+x9WarnQF
zAC$=x%tgeEf2kSZzsP?XhK<Y76}@#xz(t!^M_x}nRB~3*FfISkNcYs9tj`}yy(p$F
zbtj~yqcvrB8*~BOH9wcHtsHZm)-Ebb3rEcKA2vFEG6>Uy)jcVx0$P-J5r!;@oPV+o
z3c-pP{U3Qxg`^q>7soiRc4uzjw{lKtY&G6M*raTHF=ReH9P&j*qq>?)n(>!<^Q46F
z<IEYIit_Kfea;-c{$~#8az;s(k9hPYC9-WPJN-U(0}Vjgwa@h#N^iEE|9RU5H&~Cd
zJC5>-OTR@JEcrd;!rc+Rufl<Ljx&O3Kvwv{2rm+(B$A0ZAm#t+D;OC<>XheGf#=xy
zehP&D)S17^!)%dhAO>_l^m^MzLpx7E<zMwGse(e-y=1eQ!Qlv1vbaaZ4w$8I+~@{Z
zk5b^oNv)7%nDcLgo{gFl(XK0aNIF-7FoK#4=!l1k3*Gx+a2974zvSQR&coQgqP-B-
zb@Wg#j{|+dUJ4gJfTR#f(EcqJlC920jGLoT6j5Y>Yj!HsZ3AuX+lk=8Hr%2AW$~d*
z`tFC43;^hn?}|6T0I1B$7R68h!E;NygUf&KIElW-D(_lwg=&6yl*ADNrc)1qR7dV(
z&;)S=K!;xh8W^p_4f?N~f~E*7I&?6A`;>_A2=S<(GY;`PL6f8TzFGOKXEt-|l5~NQ
zf_;``1s=YD`Xob@%sEMzTrDnr3Hs#Q5Dc0vzYK$~N(ajozB*2B9m-QYy@NHXzV=1S
z+^d9m`E5mlJK%u&VApEhqZe?ShTLbj*2HA~!8Fa&8O9b*2NDC%{|t6G8te%*5csfe
zA%lg^xvJ&N1e^`P@Qpbm9=r@%4-1F>=C(m#9H;7oi%|v02H|3A9I|T^2+(<9w5CyN
zRo~h_y!XU6%X3j3VSrhoL;6YdabG=s*qdte!U=Qd_=g9tYVBXrdva-*3sFBGKl~(l
zUp%35A+Z!-ldRxY8UFj)m7bRVs>Lnm4vm7j>lmJ|W>b2%&r!*aN>1DBGEoHSUK>*c
zn6oWQ{q%S^$U@LFuB&`9^wt-bXZ4-GT}mf~3eGqJ>L!G^0p!3Q6w5H?b8rOeD$)`M
zB`{q06d;u4f{Y|=C<_KgvOI*qk*NY*)?xJ3p$v|O^;4uV+B<~YfTg1W=YX=V*yzB?
zgryEY5HOoPfnM?uNUf>@?|tdsUQTcO8af#Wv*KR`9UM*Z%OdG|@SqHMY58@o9I!7n
z^bm15d0vi;-;6EuIR4Ix)qDD<f+PptDY19YNa5|t;k{!PM0{CD+T=U)5^vEmTQw9}
zD=|~O!y`retk!Ju%*GkYiJjC^;w6;~lhC2D3!oM5D^eA#!(G@87^W`pd@qwlHjTI5
zsg(|eAJN#?_Dh2O`%1bEGSj!+DLbM}DaCF34fWHtb20y40SH4al>od>YzTr$Lr}s{
zD}IvcM?DOD!ZpSSBQX(X-L~by2nE#D=Qo*q6N4nKfS!z0;^FWPZ+aL&7$`xl+dbA<
z!i-}2-VUWbV+fG>|GYO7Nh@GoLB}Dp69I?8CjJV?nF0LxN|kW^__G`w)EAIJwTB!g
z<k;H_O9G_%RM@oeRmTGrObGe!tZFIZVSx8Q63dt>3|ve&6)UVbCAcz+fM~Xe-wK-N
z&Gdf6!BeTis!Afc47UMeh)_@dS7g9Q`#XCQBLVjObN^R92x~RQiN5f&f3^_AVIwXb
z9#9DLCruvmhm%QKauIij#=!Pbvq4Q<w!e-$2M=mz$&FqiN~7RToMie==8TYaW@|JB
zpGpzB2m_`!3=b=&#vPil{-hB(G?tu7gD48$?$2Y4(D}m8kze;+8OD;E3GI}PC|V@T
z9LEV@Qm9~{LVe_qDaj%MY=U+`=HImqGs!|t_ckP;j?LY4;3CzgzWa18uuWwCoc)Ln
z2yvD9BD(gp)$@Cv0Sy7!{{EUGRLM<LDsF|$J1hWfdByu~!nG5t;uZ6)7mPD?4!VvA
z>s3Og5Sq^z+z)C-MFH2iStu-}LcQ|h!qi+_;U>4@oV8AST~l3M`m@$l&3?1eL}pKK
zPeh`~am#M)Xd>MBki6_cwK+IclCEF&?B&F{RE1}zWzR5i2J%Y=E|%xHt*j|M0k|%s
zLb!7pO@#sZ-+oJS5X5%cN9QIvx5;0>p<*FZAIpb#g8vz`P?A4#X`)eH8z+BN5#RWl
zFCqntWO8Hl0j!E=Slr9dLM5UR`<~g==B&e|i;r9mQjVdQ8ONG>@+mC>tB1Sk)CT&t
zmk?S7I0!_J2|dtG{vB30OFVFB#&k=_ExWnhH2}DfBkM-1EXhdvsBaHBqM}mr&oy8}
zf&YZl<Fesh90g2KsPM`ugtfDy{pLLxmY`Z;X2hI?yd?LYV15u5G|4DY)Vxr^0FHe0
zf04$q!kjwKy((;KTJNI5AWSW%iGn518C7&bxG>uILf9x<A=Eb1kC`s)FO;$8JTN-K
z+8tYMlD*_ODZVbH8Nxrmqq_X6|GW=0onc8c5|-_Pd`WPwMuaKYZ)@-V9a`lGxo=<L
zQu%JLz1x371mh!$brVf%ZitI#1+}MA=l|rBo){ChuF!P;UMj|>>%C@iu)_Is*-{i6
zC??*F=b)a0_V|3<b&mB{$VQwxcuZHDVVYyOI|e&bsVDb+!7>8dQqM92c5#9@r<lE1
zgCE>9MuICe5}N)=?)c#{kByze<P#%IkraJx{aAyw2IksPd76y=U~uja`}C-ZXWdDe
zVMf+N4i6~Da+v3TKKeGaVuL*FyX7SAauOo*F9qCgdUL;|F}5+Ev$^{H`&F2*mo3hC
zLoES48EwNa1!NL(hGumz^BCwZDjf)A+Yqwj0RQ!MveRH2;84s6wgcPg#R%tXf$!rR
z+!=d7ddMn5yWiGRpC@I)mrPZhLJ%ORt6@vQjqVPM<*x#}Mpen#ZWX}{1O7)4liP-i
z^e;=GtHOTKkl?$jQ;QN911j}`c<#_wv|Cw3g+9{)=9>d`I0HQe7@$4^&5UZ}ZShTf
zpeR^Mm{98o9ROVcwn$@uWjQUr?fwZqyl8+mwHaJC=ItNsBJKmlS;xYrh0ULfoY%;2
z2Hsg|O9#7moo@i(Tzc={!jMsI$WUYtb{$<hKW>6zCNVnsP(dYli_Kw$u?E;n>^Sy8
z_7ArGs5yG<sn`SiY}j5<K7r%%WH0o7{un?Ccnev8T|pA{`LVzOR;aJICtwreND0AO
zV{atxDv6HoKlnevVWd4fW2jx6Nf#b~hF}+?b<nyLYgvBb=%Ckz1I>p;MwXygP}W2y
zQt&^km#3nIR=<UErgTzZSpHF=bEHwQI3Ao4OU(ez3!S3{!UQd>+QG_!7e~5r-*6oW
zp$q>3>Kpwj%r-1DI{(WyXkc}28==ds0l`aw=}^l+og+7#$i3e5P^JU57F@xl5#i*7
z#0@o~SV+%Mn2vLqdnb_bQ(y^s!};pl<Yeg%jS`mgFN1DyL;WM&E$O@{rW4GR1``f}
zT5@XrQeCkL8=(LzVdwZ9N0Bmu=|L{Jb@+!$A?w*v!kQ_R1s}H}siFrlS(q%G1y0o4
z5)WJj4ndY!LOvOcub+jpXv8-ajRElX12WbZOUfp%_*oKKUO`KuQ6qkw$KmVS_Uv@K
z_uU~v{7Rws)n*t;YLEv|lx#w$lZ(O(UXVI!>kPF>dw2+e4vA#Gm~opgMqZWnx$k@I
zwO*Fh=$F+eff6FS^;&jnd8(wm7Ea`O4U_LnDRR!mRfTIcGm?@-=MczHnYDn=LUPtK
z;cBD><=zVA$pyl=<DwC^0A&VuGZ#qzMon(=rGe=<zN?#2T$<#|^^be%ce>CaWmAbF
zPIo86NB>&n18(*|#xu*)EFz#4lYR{!NV|MsK81X8zVD!A-W*G32xWH?)#?c?T9$-!
zduDp`Z_>O!`Xbi_^v|aHTw{V+M&B>ZJm<n`d9;JuGc$SK2|zuI>;CebB<^@%%4)Gj
zU`}=7jJ&<{*8@bV-?<-;#J3V=oi-JydatGSe?4QY_{WSVqk4(h7LetoC;9*up|v(w
z%73-6eL)hwXaXe!HXSi~AHU<-+GYJF%f~+{AKp>8g}l(h?;j6J{g(m#&ja!-_#u5J
z^d;n;%d0K&3&vz@VukmPtlT=uD}g^)&fMpRmURmBuC33tF)uerr{@1&XvK&crDy-p
z-x|)iD_ZYbESsKkEphr>HQwjx{d<(Jw33wM9j{E#S8sV(iedJACm9Xb4%b0<D0IE*
zT|TH`9iKG+E=RTVpY?j|u^uaA5AdJ0pyI2a=k=23F;k6Y;Xm&^ss7O!Yej7jPs`=`
zKKUg<-JENg^)u-|NBow*uMl$7>e^S5_Vc5byB_LAsVm1?)q}h;`fpa~*#AnWS<T%F
zYW0joWGs~CH_o$J4~_=889A;GLLDgy&7v3LQjPN7yI<Syz`W-1_Su|Isd~&A#ZIfV
zr{%vuJ36odL#N6sBs;!8x0J?*EP4TN7d(GFM;Mjc8^XOZdVxq)5BgrXOb3J>N_<mI
zDF0QR`UfQ!vG<hq0qqM`?&xE?BmI%FVLKJwi}J19HbjF&;{B{Zs9R;`V68VY34e&O
z#!m$L2n72O(^OFkmWutDxppFbaz@?#Ng(u4XGxRDiUc7~wBk2X%386(Pi5DY$pgO2
zE>7i2j7R84{x7JK1sIFY5wXhv*>Y>e(%pC=S8zfPN85Yq(xpFUA6!02+*;^@zzHdt
z4zgI<e3=N|#A3GUmve$oxq^j@7jbz)$q4bg!iAm<V0W_G1N$f2pZ!#q%-GS5GJ2Ng
zyu90OCeTo0vQXun4$*YP^M?DM$ZZ^;44^VJD_Zyc_qfdX*&lD9v6IuL<>qJJfF|2>
zhkt%5FLw!VY_+*HC;{$&Z2{0}OBX*~vlp1^r~P$AO|r7}3-aR!MU3>1zL#{@4R=y&
z+%~T6n>%9%V)D@~<+{yrkDMTRTtc~Uji{v6HY#mEw(AA)&v5U)4%w^KcYH~iuew~A
z*)DHSpL(*xs%2Q&j3kGZ-5!mAydD-5_3z85*fcViO23apwkp5WSNk&6m(JMu4OZ=d
z;&7)lQ3a|<nCK+R#ASqaqt7;l?<&``Wa{?x=&PyBn#C($`|sd&?$+V&>^Qz0KzFhK
z7cB%kp-J5bU7xD*_n8|FGMFpUy+(b=*97PmRZ-eULA!{&u<tr&IV2$fbTrT(VlI!d
z7|HhK9UbYF?fuV5!|`S03Ir@gFyl7XyCv@0>5g^*zRcbhos^<P!m9!H)XU(aQ5Qm!
z+k86I956r&1ov@Md?U%u9`qolo`4LQX8jx2_A|ycVXAOo!c`m^r;3E*+L5Xl>H%RP
zNs@n<x`P_a&jl_|os$J?lbs1fM2@2TC#D%VlwuhQK+=5JG-N88-y02_2magM!mOEx
zd<-0TTa#3tZX;zK0_&&F6D#MCh@a|C`SD2>9qkgqj=KL3QSTkr)bqT7(xpocEi@@o
z1d{-v2uLTPNewMP3cc6RQL2K4-UEoBA~pm>KtwtTy%!0+2#88=QZAqG?>_hbk$p~1
zo^x_`cjkR(&&<wvadT_@4k%_{o7k|?hEL}Cf?q}Tf%>wD)7o|j2EsGB@VSZmgfw|@
zUycg#nY`rKsOe$EhdMbCy$DnUs3lEvNJJahiZ#k!zK=JD(O{mWZA@Ee)zQJcQ818b
zF}vlV6VL+I8LbaJ_~gJzLH5<S1ulW@Q=}>q?)jW;bO5!fWxPfGc;WfvqA`&-*Ze+E
zb&Su(Gk{PxgxHu(8^U996vA>#Nmv5}ABi6Bj1iR|%0;*DnQEKGo77zg0`P?Zg(#G`
z1?<odzeNON>E##lPukgG0B^h$>;d|f0tv57hz~pTCOILch;|q~Hphk6g@Pd}IYZYX
zCU%cc7TBDUd8tKKsCA>vO1bZFDzLoOJB6FFW=@4r+k%a0q**Ob9X4L+AV7KY5>fAm
zHPSTl&82iq{+cyd&K)58bj7&kcSi@<L&8TXF6`@7ze$REnsEp9Q>mCvZEo)#^9=il
zDM|#Zn9tc7jPD@;r^A~dOTdvaSNK={nvR!;_szbXOBgF}hWij*g`e(W+ot3TlQQ0Q
zKR_G2gZC@EH27e5efMavPiGLxn>3+(js*PF?%^Vm1zBLvkS1tewhHc>6ROdcEb|-t
zQpuUvKV3em0GF4M9QGy^I!?N>rlu>MV2MkEksDhokhmO-O?BjaeV_%acQma0DLvWv
z2<l-mpRL|`9$okO&a*P}*um><g~Q89A7g(7g(0Q~>mx`%^~|tm>7{K=?~zaJ_O7C}
zlT1(H;`i4T&N5~KFfu*w?>9%xo$jG$wDFsC@CRDIg0wp5`jwp>ybE+|b>FnJ+-;=#
z%M>(SD7vosRHPD8iIfd~oOP1LoV6q7P)E=kx(}zQ&T}!FKTeeFSex5EDpyexnpcaR
zZ<()LxN!St2cQOXw})Dvep6w57<9@x4A=h*=Fd3`pJG4F9>YblbSsZ-PE=phzL7>T
zVBQ+W;~z4#3oxImunT1&`(bFC;NnKhe;9hhMiBD6y)SG*=x$8)0ifC1lF{+Xs`U(r
zn(=CR{woc(XR2)Jt4U*#?rlxdFu|m|c8#dAY1{fX=GI$Vh4I(hfJAwGqe6V60&G>f
z8F5Kwt|J5d=|jDC=4u>v#f#*Tt6KXZ{|f4~U*C&H{&TIW(lh)4Ix1zT)-0I<|M9=7
zCasud!wY6Rr#kMq2<ig`gK0j97j<2dnGH*TkRbk!C#)o6vtfolA-O%XZ>gRX*~b^K
z-3w=b$5=ws1<KpF2}_p$u*T91+7~K9!=*WeB>ZR^=II>Me|0*^aN{}I-@~|)hr**E
zNvf>hIlO;Y;t|Z+(PouAp6+P#3aS=QE*Pu`r)6vpvmR&m@btwnGQC6$?VDJBx}Lw$
zI6X7df)475*8#5etX-sh=9kZ2K_0=f3X@oip8}7F=Ougx*3d(KB-je)?+2a8UQWb#
zn0v`xa{_`14{kY-r0VW~L)rFl{+}>j0vKK=2ko<V*bXi`JDD{WfuNTACqifQQ*CBO
zTjcr(I5r_;yI69_Y^-5O`LV3%ZR<<_G#wZn_7Z_wva}+OBx@t%ftpsRGb^(<RKM%i
zlrhhgOK+=U?l|+0c)=J24e(fwV#MXbz8j$)Dr_EvOu{(pZVOR45Wci$4K-1hVmUG|
zlzJ2Snj&=%TCIv)Lq+%(l;!kPN^GYrb3Q!|=vfZMX-{awP<?+i5Z;knuSwryM9n0J
zg;)bY?Y{0m{3VK{EF>>kiweL#^er@Izsd%qiXXQp5YK~#i-9!Rzg+f1mgxnC+#&8E
zGy!c8t=>wSx)p*aw|^Tf7TqSNldIgvNnsjEe1a)}oM_waGBE<k;k(kJpG{O<kuKCO
znDrSfc;QyN*P&lmT_zb8+=sNH?)y=obop@nqJ8PuHX>*H8clcckCi_fpB<0dk~>?L
z8fDus?&*kI^x;Jkg${S$dBtc%yeR8S4<M>pF>R&0195fF^njeOQPdfvrBE`JDDZC;
zXy~5{p25O#^ms}_35Hj`MK=Zq!RFJmdfsT?_{hu6w}{z%Z8WoVB5Z`OA8M4yzF>M2
zCHL8e86Kkk;%lQ_^3FK*zIfT?4qvyVYT1P^z~<k@SmRc9{Xab8J&&H8n?!@FDoGwA
zHI@KVye+Ipewt7h1OEXs%Gl_}A%NV3ZVW#C%`nzt!Ugv9WwO-9g>Ky^y|<a?{^e=Y
z!^<8d1A+r~EM0gk-as<;PDde^KZ6p<k9oxZ;MzMzBVtD#IXuyqYB+9qWK;{v1Sj%d
zR;-6!{V#xEiGrSuo8u6819+vP*+`A;L?{VHphN3GP}#||?M8Jjcy$;alcx}thbEPU
z<UpOXT!Bh(KJ*WHqr%~ico!%yvWJL8kI5zEo{-}G0d&Y5_$)?UE-&p-?sUtj`CdpJ
zkaP&=#<0n8<am(SjiGF$YFH#Z{%TGw-<ut$;{{2f$oKGA%p9l(qz?K6_674QB8#uy
za*nn3Ya^CD5V{CD<onb5E0Jy(=b5q{4<9KV2kvjEmKbbEuT9^2`aZ)Q?*vbgzhHFw
zk`h3jtQ&Z1=-*w?>4_FlBa9~64sxkNzVw{y17h01W2LB*dqV7siUaSo@h3%hS8QK&
zyi+`f6$JxALG-V_=i={=6O+psr~cq@I*^iqv5_Imi>!|!Rb#cU7Iae(f|ON1^8Ya+
zja$al!Q0$ffsZ=rO;4wuuaI$(3^}GhX;HgKwDqr7wL86}rH>_->b36(t=J?RY|_Mw
zQ^?Wg40p7{4q5T*aDJ?o{8oNz$7m>&3#bUoL668C=aKi+Sh0Ho=zuYJePk#}kQ9s$
zBYlO@!fUWEz~Z2FumGq|2Wmgzii`jygjT-xhPIAsYs%Z5YQL8TW88-gy~3pvD!hub
zVB8fxNIe;jOj`_k`Qg!IW%HenmCe@^g5K)v+<UkP9u~0#ND?&AsQe%_o)HTx$+W9u
zB*4*u5XM3*;?NT4Kr8@_rJoGc37xo`*Vsa@gaY=TP$09wQ=eUPBH_D`;B4>=r3Nm7
zbPd*pKFcYc*@GiI@pOcIOci7+N3ty_7|MVjA%3{^;DIkR;oM${jQQyK8`969erWF1
znWQ*45OCD!cPr*rN!RCHu`<UaI-?z2yn?Ok?|A$n+yXr%$B_@7VaHAI<7Z&?7*R!1
z+J5dvkA>#4fxMlHmYVcFAsb_(uwOveQxlxS4<r))pzG!EIg(cyQ~(fQHry5c1f(Rl
zmB-rBZZBe|W!`(ceAEv%5W#ReVS0*kU7WE4GhP@-InUAY!b88FnX}TORaT|;`VZBa
zm*4d``;A|eoh@H0TXQicg?6Ah8d&V7=BZhg!@AX5Kk<9Wyot-(ACjkF&O$f<-xr5x
zh%$o1vc6=)jH3uY&<F@BOL%I}E=TEo7Hi^v1LdbnEyXoXE7&UVzmAa)__ylb)MMm7
z=#Ek=9JIO-nP=qj+Qg`bll7HOffsNwO7~n375Sjgu8h)rD=Y018@KV*i;R-Xb6lZO
zm!f{W%Ze^K?VtUm5d?3yFi56oQB;i1)BAhz;5H+f--Yg<?u;l5<?K{aU{I6YSn0#v
zw=yU?y}`zjT*j9>Hllni5$}u-EvI;B%^SmM(tdT@8!E~pk-i;T{q}?qibzym{iAfP
z$(+uS{1Fz)q&fCKO-DI#VS&}JdC~`>?K&9~H+7A4%sF}WS?McPM$9}=D-i-QG#UHX
z2?u%uN_=82tP}!*J$6a0bz?v6b^`YUk>}&To^Bt2BcIZ4SQ5t0I_{MO7mvNB9{->%
z2EIL@#JhQVziHi}<?A&gr{HX<kHR{-c7(gfROz~qU1lCD+nzE{s2=Cw+zzGw(cHs@
zb@ISTS?-S<Vw&WXTIpx2kG^-PZH$m^e1@rwF_FQ#+wgo>1-VKmwVto-u@+it!Vv+~
z)5;zhF(<bIzcSUSA9lO53O?~voC{&W(9h~ruqsX3ME|b%AnNk=K~0rDFpOIO;_qI<
zFpnH#?ifQSOtQUdA^$)@?B)ohy8Og6<{{<T&%)YpT(xQPx=svl2V)y<;>dK=SdF2d
zMHG^6KeP!Edc2+c`@2m@>nF>fYr+Ow{#{mMTF*M)#@mEwKOZ4$P;vIkfHm-%f1TKV
zT&d?qJB@n$7V+n{>wAUSq(E-h59wpQ>K8Pvbz<X~cMVGtsF`s6FZ?Y{=z(ke8#tDm
zHW$x6={}BSl&38TXqAfuh~U4%kFk`}<bA1Pa6H$n_jNostW7)n)7&A7kOtuv)Sn0*
zE0tiCwviUmgXy7s74wIKw2^ICmh4O{={@Q~p<%dP3m1aFK&gPp(vtfQtx0fVg`%0(
zBlgF{u&hs3-T~k87|~iBG#amJ0kF9M>M@^<dcqW%7Lt(hW|VM&j*_FBEz<{}Nuq>h
zbc;eowj^me7|M;jgd?yRwot8#mJE}$g~=^KSAkK$*Ws5o9XWX%6-I?hxA^wtv>JNH
zd@eFfeh}E7g}~JvpHH4}!qwqnh2jny<?vb|CVR4nY!5Alu2Qpa%kO9Jw6ljIIHnGn
z?1e-IN7q0gxhMG2spQ!}J2$o`M(=XMTeKr{D1b@uaEyvPKD%^Y+XR8ZOA*PiC@3g@
zao)nb%y@zoKm7EAK5wS_UWBUb2MZ>O{6J?n<<yz_AJcG|hBw&aQuTi7St`kA(S=@*
z)lW;+V?GBd^&qxwSFdrdQw<;1g?nuPD4C;Y3lqo)TMUN}XXGeKRpXhX34RenPizW}
zbgw<o=k9wJ-D#M;Xt>3I`}w10sg!>-VN+}&Zhlv_`8TikcU^JjQX1dyx^e=gG<saX
zIZIL4_w-`~!9}vaHIej-JOtBf_;haYR3O&VKtMM7tM<-jd?`41pPQqwS%EcCxmDY1
zf|GO(FTyTB2}LxH%@_SliI329!*UjNw_yK)Jk}Y>hz%==x2uD|{s-~}HHbqiqyrHT
zl1L{GLhl?mr>$g=PiI=y=_A<)BWM_;d;RJjKH3_G5kPvvbu<}dC2MgO>V{{!qN+Fu
zK8KaCr(1_1wGg#2OL7(2+5=3932tKIwi=XgAQS7q{`EN>LfgLYCu)}5yykA$swyah
zlVwWGytBEHHuE{S>Ir#8Q#8QGvP4WYj1G}L+h#%|Chj<;fXYpuDT5#KBI)6-7<GA;
z-0=2MuR|+<7pV|7ONbA=qj(MUr49|eMP$bOfHLOuj9%Fu;&NHJlB9MM1Qjxy*n&}#
zTTeU7CBMqbNBQ#lbel<-0C{~6l-uX^3A?V{iuAK}ztpM)sry-$iFspLjgzG>{cu6=
zkD{fDr0JIIimebyYVQVJ4*DF&`>gr<tU6Sc!cRx{HC2bGs1%1z_ij$djs4WJv_4C*
z`|2jp>&CU(yA9TyrzncwQEApo-V~u*UDk07IVM`E;L;~aaKirEu3c3P`v1t`K)*i*
zHii<>oCqSZ!>F-b&jJKa{~O=(Q<By(-y0gfx>W{@-an`VpJg-+-hlD}7lEQ2jTc1^
z#{Gh2$eFb=FZUI(d;g9?$MFmv>gI9NO|!j%kSh?z`UxW{MQp~<of+tM{4&}7<YSxD
z1S6+;iiy^{Ip^$k=d5W@1~v-=>1cM|((FwABXj&X6PS2RmUw(4A>~{}jUmzbg1(2*
z!1c;U97*<47-&wxYsAJ8ah<Nl)+^6*n?d!?J?=msC0dUNy(Dy|#A3Rgtr_pscH6pT
zuqBBzbnB|7sZ$q1m(fcBNKa<n7ycJSosKh~wwg97*=2K=kgyX@q{|$}u4Mfx{9xxU
zf|9j5Zl<)Jp)Rk__B6vGfeXEH_qRKK(cXVseUsoqQq>Wseb=Oq7zi+m@^ZhWF&yYE
zMrZ~XAoW6cHsuz6_zAp`^kEVE+D=L9x5^pFEAstX-LWB$3aJ(rdGD;7NbtMa-ZS$M
z8Jq)Lh3HDclFry>qnO!75>fdB+Gq=JgxOe`XwlZN8p=7h2EuWkd25!l6uC|s6N-B;
z8!+$w&J5i4gwKn{7^swX3++q=rc$JRhEBCf^?h@LH<Oz>roh|!>Sy>h%6`}z71D?f
zQk#$7!Q?n8ri#4sX5lpN@zn;Nc$VM$FLEk`62`*f-Wb@^T<zq9%FJrRrLGLQ^s~iZ
zT()1S_^`z4)d|t8jGZ5uxZK-8rH`)i_X?$KEvgnSm&8Qh9@#`~1Dt8|u37s-o~s$n
ze*(iv&R-9lLkBd61ihz*6sx0|!VF&Qsya(^VU$%!@wYTm77Es<N=K58i|D&_0n7<|
z&fP8tNQj&jFI0Zvuvr-Ady@ExS}0;SFokEYk(QdljySa@VxO?^V@)R)RTz&Lqh2^6
zOcSo$5@Yg54>H*I*diWL?E)1zFvb?fVR{LdjcdACO(hJI{{l+jK$d#@gfPSDhURxY
zfUn*PI=S8fsw%t*pyqw|TVfAoOtYpd)Cw>pN1hAn9n{5k_9qRzy8Uf0Oik7PAA{*q
zQhLK3P(;cjYnnMHJ_gh8=RQs0)~C{$L3b1s#P)&rQe2eB_t?s=F0$`hqaQf!h?+V`
zNxn@pYhOaoQQ$4r@6!{PScmQK$m@@Z^NbKX+WI@g5U#sMf8CaZW6)ZY(#tv@m`v_E
z`L5x~Bj(c)`c-vhQTfUOhTbA*p`HH&M`mpB6*%TF6SV(l0q<EKT9O=zc_7vF<UvGu
zS=?G7UkHqdVg{>bg--=()&<?UYj>zb7(@F)9%a0luF*XVA>Bc*L7H;H=l1lVX#6VS
z5>1eo$ZPFxzc-=KVYG3&u6cH*>lv4q&ZHnWTuLfPVpis!JUbJ*V*Ab(PJ^Yzfu#km
zv$KP>ZVQ*ro|m1&wVggy`DaUU^$2pH1mQ2bOMW|hqh0Qb^MH5ZZrCLdt=w7Ro2k-%
zr}CG3?`V=G<#Nd}{7R}(nw`nBn2aEcSC#@TLDC)Tls|UMp2B=k!HSu)2}?^IK*D`2
zpzEI@<Gj!D?diL$j$B$(e^kgQ#KOeqf(=3Bk3lNG-{)N3=6DU4+T&cofkY=ok3~)(
z*mFM3j-@yA@p@FNQ2>pDsRG7u^F-qmvc}mPUBSOqXxkpV)NzU8QIdq(;dNllXcI--
z5v<jO6<!nmLVmgjaUb5H*f1`4A81SH-f2!dvV4HGjGORA`736030fUd;_UIUJG&58
z4$VLTTQP@m4yL(P4H|p%ff=T%Zk<+4-f_y|2qSqIyb5Y7hWsN}p55taD<o(v>Q3SA
z->qr6fVNzkJpOm)1n&Z!rF)FmXx7~!_@ih+jOn(6I4<Hgq?8DdB~W9o*38pV2A(rp
zgJ#7tEH(lx3;R!gTkaa}k_VP!51H<>qhQ^{ccGW`Wk2@A(VVnK`2@%zO@p|XAJ9nT
z&~Ps`@DRoc2=Tx=eBh7*mw=Y8VZx_%D47I&3gsDg1@AVu%X1is%X2q`n>p}?C%#GG
z^vL+rwwvlGkffZb1<1)(0n#tjdiwqQO&3+{#Mi#J>_^fg5Kzp}={8|%4$tMdtbd&E
z5<4PuXgdPQzS=s`FU7v6yR%BCEPJ+UJCgBIc=K#+!qDG)c4Tvek?>EWzZ*X<MXQ<E
z(R{|sN!xYPj_c`FOYw~c!hDwXo%f@JH<WH<*>XZ32!Nk~Zl(XX{zKd%8bOC=4&{lJ
z@_Y@qu<x?AnpvD(Ti!i9pbK=}BRisHxe^Jn@i(vO%%kI}*S1r;)B+VB+%F6TFS*oe
z+*w_;j01q;Ldpx8p6c~I={y%OXxN6kiC{Jhs_9ylUe2an<r?*;eu8ph*Ns<(k?%Y>
z4G~n1nY#Yhh1a)2U-l00T>{fD8$f}@stO~$@$G`m`@@K|!Y_q}U>kD7FR3RQ0o|fh
zXZ>@?4=8%YK=#dW2TjLDq56{yab}Duq(J-~FMDaYE-q9^&UyZ`#e~9Di3)D8Xco99
zhe^{#rsc+4+-TFZTe4<8J=NQhW%C>xWH|;^WT6kt$3D;N`VoEA<8|r>c^S9@o|&4U
z4;~UWjw*hgYES;WOqrGG<~Bw*Cvn5cwRQbLH!e~X_+$Ajn`r2EpNFe-awah#8iH=2
zZ5gBWx42@}pY5tN1xtCTrWR_scver7bj4ViAWHX+bpr2Gy0}EM-;=rbx=^iky!GGA
zXB^dEfn3CGLNpo$S})Qs4e8K$<@)=d4`77r+mUF+OO<rmcTO~Zq2OIDCDEekPSy6M
z(s`^N<>ne&L~^LmK4StYaF?6!xJ{tEeRDeadssT%2)q465Hb-Ru|>wFRUZ%vzOwsn
z!u9?)x$tr@Sz){%iI4DzLg@wn8))x~{6|$KWmbncq&|FCp2Fl}UeZs?roLaqzSOxs
z+_T-&+)8vv!Y}4RmJ#5uR*S;&d%9{bHT>@xTrJ5L0yH|q+67)$tGQJxKWh^&=l9A-
zQGlj0K22r10C^kk9_apWZ6VwWRk})M$2thmMQ&j$vX*1VMO{Y3G<yUxCnV!6Q@oy$
z=g{uO=DrAi_Qc_LRJRn}Mfs8_Pd_-o@zp_QO3S4R&+ikX@&|q8aW|Vm${eYH5B#a@
zzlmNlCtXV#xn&{1b<BD`R`bxG)ykRza2-}J?_Jc<boKdORy=Io)_)liDmUtfM_!e=
zC>_r9rsASo5v42FM%a^LF<X@v)iNC;zi{P3`{m9}xNCmY9-!lC<JL}LFMesSn`M9M
z5MgZItd85pm!SS`pbTuO|M$@3g60Bu<or*YXXz=gY@abhU)c`ujEGp`^ziKPV|jxK
zB|l<>LV72Z2d1Mk>80Zg?#}Uq{rJYEbdm7=(}@0%4onl}srY{*qwr=RM;Ez?eUi2O
z%%Ma@-RHRDCgti=fl29hS34Sk9ybNK)v4u+W?;N*IqGqKlzP2m{{#Ou`2IH+v$C~V
z!@WYsdH<&-x|`m<+fiDcJec6QN@M-~$!{GToIfwxRfM{sQ&VUA{QDz{f>XTJ3@#M;
zj2X9IC{qXCY`r+lkn==+P8OKce*QWCqL=ZPMT#Qp1Si50pl{7U`XRLPk8fZ|v+0Pm
z^U|?O;X$0hM5w1h@`HGv*KD>=jU4-JU_G2=J4?n$_MHJEB$p{M)X3&cC?q+peV7*J
zF*`Uv^7xC9=Gw{Tc&OFzkySft!yv1W-GR3=e&+bb<Bup8wh-bZa#Dioh%9^a_ovk-
z@%Ll5Zm$p5>rPj@PU)t93C3}>CRVzRtUA_#<INGc*g|ziLK!NC<;El#4SmC3t~qgF
zYB1us#%~5-xa2s9lf_UK%0=Mkv&jPJ#T2jP0gimvlAd&xzli4M^Q^Eh#w*dPOL05_
z<wnN^+F<nbO2@F2c{KpA*NC*yYuNA6Wo658C1*AQI`#p9SNaLwz$uSf<tP!K9rk4A
zFz&ktZ>t1u-+|VU1)ddP*9(C5mkqR}>kf%jKb@@x09IkHcQc2hSVXJ&uraU-v;tN*
zBp|Cx5z%05r;Q;D8%~=QPTLMJlfpy`%Pg;;C>l0_C0i!F?H=vEj{|F4K>tr+C*<Lc
zR|+fQjpXxikM455_OWCC@S6Zxd6<%t*k=2<u$_PTA;}K%GU&Dr!g`pgX(85$BcJO*
zL;=?cHtFbW8Vm8xJ_~<KvC_EeU~|py4Su%9M8w5*B{Jr`WzR3(MY)yI3&4*51%HSY
zg|=j@wIe0=NR~KTybZwsyMD!shnz$L<P#AgMWDhYlvrp%LrA|+LW-rsL2h^i%p04R
zlkE2DhqwPu08Xq1Ho*eiA~It=<@fU?+cWhid`L2cVsy1aTHy&XC=}p}H^bi|I->0;
zs_gKF<ufKRKi5dZ${wcVDd?13sCEM+PA!TaP;gg9Gp9dxb1~)KaXajL%DkCJ%zDTz
z&We=zO*N1c|5@N+sH3%Ly2$d6-Y%^$_SJirr2VHRy?G0t@(zDF?Hc2f1K&|4m<HIH
z8oQX<wg!sHh)U4N-o7e(R4kt%3#32xH9?Sv<ZX6ej5fsB@HR|muzCkGMui#q5-(%7
z@5W|l@LHHTI_jc2HMwfyC*x6C!zP@GN&*|k0TFaQCb>-r6W+X6@Fk9^Xuv&Rf4FvI
z>(5hrJ<BAOzZ@2_{n6Pbo@Sor8B#%G54$=hWWvp(kJrWRLqgYMl7$$9W@SpF({HYh
zP(nhc7PgP+@7&#}%yB_BUHH<>AsQF1zh$0Jc_))VJTW|e5AiZQU6)-vnYIam_3Y|8
zD20N#?^pJoO~sLU7;VKgP-}WPlv`OY?p?IP#KJ_!#%)#*J8`_z+Q-u_6gE~A^7t{<
z(-Yh8+1!E(w<p92h~cE7w5JB-O-B}z;ar;x4iUkqkz9$yc;=tSZQ0#!-ohFGa1_1y
z1}A2zJj^y-d2D2p*O9uTv;hjd^ki{y1?dwKq;x*M2=NX)zr!9=P{UqHmgG<Go4YKX
z9SmKz#e2n<aStiq_U%7;alTP2re(@7pz7w`IW!eXX~#Uel5k%{q=6w;kUnFg1q)4B
z*4k)~RwAY3l6zxJ+|<w}3Z-*(KEy5PNh?CO;Emn^Y)E%RVB~(B;24mXZsOdkD$^VA
zPaQ%v6h0%)Jhl0+LxMlW@bjM)iB$T~yXV?&XQy}1zY9KuC%hLPT8(G038Op}xeAwf
z>MAFd&mc~(f^1-spDd2~d<WTp%^NAaW%=!S<j;(2D20<w02j>4pb?SoF;#Y-bQ9fF
z6z>9@!j>2GijAiaVdhiG_N>|M;_b_9+btVtca6C_?c4p4BbfDc))_<uEC|&Z`K8)R
zZ0vI#e|8UEtoFwoisN&wvC_BBig>D|lBbSqAo_@>fYcM{`#Ao$ooml!t7=wM+;wpL
zz7#U1AU&n@y1${9tr;)7uFVL4`Sa`Y+LX2W-=-{U*{^;b`G}gKx|+7d^uayx8Ewjl
zHNy4dm+gOd@*AEc(>CUt6_p$)WSZ1P9jKK|smny}T&UAJsMAFj@;>h3{f^g$1)?q>
zup)MQ`0?NKq7d$C7=IB=tte2f$hfFTJ9e3}=Ek1(+d&7q&ATlIslg;mkbiMaARdnv
z!jF36!--0YlGC7|y%QFVr5Kl(*P}suy&a(%RJK~>wy+gjZzV0AIJMl#l;G95-!Jkn
zM>KuHzR*#s@!^h^+-h*hrNDaz!l;zy-xURko39@>d%^QRJri_H@O)hnF*=gT2F?nl
z_Y6{6fH|tK$!F>*thl!*37J2r`iA?(dTx&?sC;%yGgV5n0ajHar7>WKO#4|?x8AJu
zRhT|c+NGtn8!1UxYF%v!I2(4jBQGR}x#7CH<W*)lVMB@_jAOkE%?+2Ios<m6JifzP
zVrYB)i8jm>rJ*?7dSxQ6Ls<s^I`|cATGry6oePEJJgO_*7`JNFI_KV^z*$07&F10D
z^<gs9u`Vx{#+zS7GANqx0)0J5MS`6&-`GGUp`s_DlB;cR-I6E^YDqU6r_`8Gtmd<~
zkEJB{#Mjc!NgN~P!M`Ar`*ka)KOTN+SdJFaN~vr8NU*_f<+Wo-3|Rk?AUgmpu?j-3
zeah#zLF&1lK_uUU()>H7{I;h$F*|KFH72P0lIK>yQn<<Wk{h`RBdVMcvu{Gbr?J&@
zR`7fuJA!FNB`ezp=@XxWR`8ZbBFggC5edmE)c|^QHRKN<G2MYtlck5t92>&pZ;SO$
zw;d|8JM_nwVAdyHPqttERgSB)zog+bbCL+bR-~c(4>^b(kl5}+Nf<e1tGGrh$8BnK
zoB#Q>MEwiLR$Sl_wdMznQ!*Z#xX2<}w^gRQY0XxLbQEH#OYQ@=j=>JL>z=Ik<oQO;
zK9v8~r+?xF`{De)qOzIo@f%BM$u=AMLGD6;7yepa%AiI<CE$6$n-kFRiTr#BkEtV+
zbwt||p^IcC4#*pBHoOZGLD0k|1lA<z^x(m(#Kb#jW5KHTf>msy^~F^Ujvrm#X|9-d
zlw_J7iW4=U<TC(fVl|kfpvH^D2S|ylZ4Ai122XJ{a#lT8N{)$LdkaVocRkRT>RIcc
zES?NQv_MOzF6QgP1(j@MB_5Zy)lnaFNVh5J{phyu!HKK@hvbPk{1<8LSl~YUR=e^0
z108kYM`Tqa4-UB(H>YF%^_0pobJ^GbHYt(kMq0Ywy+@x)zmerXzWBJhXXwRDV7%I3
zNzUz%uDrto%?{_#@RylbzMrG#!B~^o8Ir(<IM!ZsP1*{9amQbeZb;p9`7?3Z9{Uzs
zpDdrt`lI48wi-SNcxK6sjk>oSHJf_eY=)DE1)x~KWLdVv99GJ+%R^owO~H-h#+$GD
zyP!oA(4sYHp)19sHHtV*9=c~CleeinC4%J50tT=A$loyj_;x+gFKkxEaA(d<Sl8@F
z3!t$I?Z$d8j=#6{?jzF74K0PKUS}C#Ko%40=T+Tcu9N$w-)>j7)8BgMb9b_Nb`zqN
zCe*wvBl2x<9Pu<d!BBMU?o((|CVA-la+TXDjnz^`w9%!`@xO!S+f--lpus?=q;NE#
zpi31+wG5iMHm~;V*pWg-$@<<|4{twn5v$rrqSYFpE{`ptxuS_b9`pWFaD9EY_q2;G
zh4N`9&IPkCXle~~GLNHx9t<Seb&2f<DN{)Chd&iM`;$F8Q>TM-RBXwR$XMw9ou3ev
zKI@@re%2rk>SNPBwK(R}EtvH^c3h$AZ++TldHn9JXCT_p?9sJ|ywtQ_FSW}4xko9?
zuKi<|&P^e+iAXsZjfTec1oOyy=?&M@544mMJ~9)!OUyI={kB)0-q!SeJGS@kUxH=%
zapWW2g5iQ;d|7EPmif@^0AI|!P~7{xxTp3<e80{s#k0YjG6J!xm<j07@)`J#_fdVN
zaaQYi5C$oRKF-~P0k30di<VvR?=dVH;6Z=`P!kq}txbdXPneR(|NmK%?7U*^Zgg6%
zk3aPr5~WE_6kd)ff|kGXgOax(z{|+I$h1~}bFZI6yBfgq3v|suXO1_yt)_!RxoMvu
zm>9<Pu82acYwN`7e9s8#ia&=lqbuYrbBOKi`o52S&2KSS1JmV1obz7w6W(D=Kv4=T
z1$z}IOtX(*;b>4cyXAxyz7o5YzA<iLHX%T$RhaI{5ha9R?(n5=%7F?RNbLS~^7u>Q
zKMaL@ZT_2?cw?L&{tm1R^90I`Pj9cemt%J53!Eg_!O1YY3ZexK?O4MJXObN3ImTS!
zN&2nglP-~nlf3uQK!Go((mX+O@NvoUtAP3uc{QK?!H!pLfGXe^CM})kKY|TLb@%1j
zKkMD?yT1dPvRFQRB!C2h$NeLChSuNV=m+me$GeZ+z5C$)nu|vKTdV1oWD}ypaDL09
zF_wCwljV?yp?gxm;UXU-WLI@%MA>!P6|wK<W%(0Nu%|FAbu|!_d5(+-Rb6K*V&tv_
zrh*%&)vgvk+E{H_xSQaCMP<5;RT4#_?^H?iMubjd55E6Nuc_TJgEfTm-#C5rZBUPR
zM!xg6)&-h*)AAjbdCkD>@v>cgIKE)Y<$<F3nP0`9DUN{lAxGf?|BDuGN2dwku*BU}
zR|NuuDk|9ZPL?hHuf1~1k2sTtBQK8oIVb%^tH5!5Ybk$}QcK_=r?F)i$s8EKB^RXa
zT@6&zfbJv1n4I2Cfmb?dx&FZ@oQA#!><kai`@%gW^{L6?b88~OI*JLruAix)SfKK8
zwh^Cw44M|~o=oUan>ctbAMpudY+j2oRq#(!4XoQb(#kyP)r|5aicEt$a&`FZ4zEj3
zmBzH_pl`<SqlV;_9$WYa(o!?>vtn6q3TqV>(}lo79z7$UcE->u2*nd>CCYxzylivU
zj5RR$WLen%CQqN=)(QGn8tu`P@uf1R(a+czd+>zH2~sU<D>5uEEOPCXp!o5C75HZU
zZfV$Y2g|uChh8fEqqPTO-;^rvz9sOEbdio_p=IBU`5!Cq13k653Dfv5%4Gli?zdtu
zI_5a}XIVT|<?{uq%vOHmt8Y{K`W(G?vkFMK11i}gU6K+6&y{gDn{|Z1dLr&^D9-=*
zja6{jF=IR*|J5#URKw#T6aL_?XFWVNgWcQPI|1nF`dXd?S&r0;$NZ6{n?2WR7L!lv
znSfGG>L#k<f2gikzqKa&oc7%8p~X|+ve&G0!y;vTP91+xt)Nm7)(_Z<A}FShv0DOc
zfo~$DWGAKYW`tdNFcA?A7grn}D~kj+p~E0lh4EH(G6eH05J#2-m;F#T)`jt-SsS>m
z`Er7gEQEG64&t4WO#Dy^6QhOHW;{HgFs51h%t!cC?;l>Mq8xf`z?NvP9AYPOz}CUg
zJKarUCk+3;*VMVhvnpL;BfP}C8z1%F%59z1EFf2A<Y$yK&4stg$NAb>s~vjc)d<z-
z6~#XLS|9m}g5fqhtfNQ-KpbyPl7(+iZ!7itDC0W#9r?q0LK84}u+RXU*WWsVOlp*{
zv0Z0u&S-LHtg$UrvXm-Iv%le`@hFD-zqc=cFlWLNFQMEpn(|!{?CmdQ9L$cL3LU+y
zNM^Jn#4@Wr##UQ1NAG<EnrH=1T>oZP2na{g5PSU&Im{N<#2S_5Vm*ebAwL=p+H~^f
zFx`R02~fgmaa7;#9#27p^DIXB9wn|Vw9NzU^&n5QL2UY-z(R-3!;j`1S$pC5JWi6)
zVX*Ebb0+42(VF{)^KUU3=ifs0c9;Vd$6RA6@4Y;hTQ(9+!mny74;@C<o1E;fdw&@5
z1q8J)jm~Hver^<fGQD`x*SaayMRqe>3wk|1Ms6@ZZmf_&57+%<i~s)SZ<bi;2cvW3
zyBDP%C$pJ`02(9&?udB>P0QzL7YVJqj}(KwM<2@J3&XqFF*yPxDdKx{y*#quO=mj}
z=LS@U|1sLZyjr{p+@ea0Dn8CwJgd76v<8NgBDW^eN+ie4#-@AaY_XmbG{`9AE0`s0
z6vhg>MqniHz*11Zv@e;^RCyx)q;V|T<hJL-lSKYNX`DK-4~)vtY^$-$VTW~L<gX&W
zC~XmrF8t05u_(<ktPk)BiWcmgZ8m0MpA&%RfwMoC7am`>zH;a;WN(Zw8zDtuztJSQ
z`fTECQ1nC;2|_f)a6`%RY>6TUhmm+mSR6V}&aB-LYkb8Y!mvk}bp=9h@+>><Fggcv
zM6siN3^%|WDypV|azFK0U`<8>-TO)S)Jj{xZ~o{PI5NTxj0<K)OvDs}Vn7j~T`&;L
z2)*j<RWO%wueL4L?NH~C4p=nz;{&DU5q%GXe1r2^UZ2<Ep(kyhX3OC<LgfF52&#<?
zC&dd8>-*l!LFtJ5ic4+oj3nNDT&SM$D>8y^))%}82A?Z)Ny$4M2$Az6^-rI&B6Q+K
z7><^0v~3P?@D!=~@aDhkS!w}bFgKlcJNjKd<$cl_W+C6guFek0brc)SL!ib6=e8T*
zWzb{UWjJIC7F1Fbgb#r~2kTr_c&GFQTEJ648rj-G$UL-C;j%X=l*p_|H_i2cs}x)}
zXrmA;(zo;cBYU^6rjKR#l(rUgV;kBCd?&8(p5tSxIew>GzD^;@sA{<#>^J>GG)Wq^
zjNVn)&Tb{K2SF9mW{u}s^U3#b@G2X1MsNjjSd-(=5;10J9^{IfodskzvS`^`TAeE+
zN<GOw#lC+GjOEh`mrX8(siScX4tA&PfH`>Saq_<N38-ZDdY>4nasN)Bx`iQvhO`KK
zdlh3umVYuM4iJEd&VqT#Dqj5l;}sH9v#;e4WmI3Bj<mq{!YR;fH<|nisv7=jaWDV&
zFt3HKK+^|vxCp%1s*La<IWM3&><ZBcfd3F}aXcsz|Mh=}mT85PftjLnLT`CP-P;S(
ztK@i`bLZG~b5O_?LIZkD?pDrX_s5_0Cxu^Ym<8i*2P#aDYz)EsgQ6y6NLKhzd;~t1
z*o^8z&0-;79JIV(XY}f;1sZ`GK`o%xQSIn6uy`oXyXjM+j=XIv!Yuwbnh|uIJ*tb;
zBml7$#bvfQ9lSN%SB}^PRfZ>k2qm@8EgO0P>O>OQ`AR*SI@kzZ7^QUOEA7BBH&v8v
zam=5+&%Az*Q6^B?-W0};%`3{Zn$RYZ!B|jR5RI(q4oC_|oE{yPB@6r`Q!hskFN7|D
zROO)Owe_IR$Q9TUdPH6|KY%dmkAvXvTzU7Z<hXMKNC=?El}4qYx8$e_PP(-3;areJ
z*!7UoBjPM{pFcotIRb|!&A??bX;-ijegzvjF~I+Wjf8akCj19RNUpYIW1iA~!VJn!
zI)Q^RTk?514I~i*fH!gkE{3{>l~UL)%#nz2Oy}-l`&dJztj$el2?l|Mz$PF9Sj_9L
zK56<8t|G750=)){`2UnA-j?-HkWi;U>;dQqCjbBxfe@)yZMOfZjkR83wpAeuyS|yv
zfaUbtKho;AO`dS)EhN{cEA|e<^*V@pIX-I;f#_+veY*7{jNmgh>7uwdMJF!R7$iq6
zOH{LrOY_&=4Cas4cf`I&?q+u}$EwdHQo<OSq8`fjr>ozan+f=f5|3wmyZgpI*Epk_
zdrEqfp^rR;m#L<-S!lz=ld+MqLG``&{g|>?X};09?-8OP*HnNy9a)d_&#cWP=|MVU
zfqP_>fz@0mW>Jf3+x_p-RKFV5MtxFpZGAY*`Jg@`iV~DvJx}yh-XBk^72^1398^4Z
zQw&VjIU(Wn*bce-aSzEIkA56*8)k2G>7eZMq1G|(2rm@vu><iGH-qh6l-`W>r5HKa
zR$so<pj}b6XxSQ&0+%)nS8b8|_O(S0L%n402rf!Z0UQ||sT_NAj=(qDQ_IGLKHu99
ziq#6^o8xt2qq}HcKA21+>5?L>O&gSA2Hs$TBbytgS-0@h>gycbdr_kw$G<t^szwwV
zy>#EE%RxF9>vn&NjeuSce_;O&3_|E8-zY}xlgdZxmK|-|{Eb_nU%gs+?y}1rsI$F(
zt@!Y$=D=99S|<q7=`_`6`YX_-T^cRbsKsT!D0i)%zvc6_U5Uc(mi&0%6_Hu#rJ&%b
zhOWnUx<MhxYYrO*DQ*w)!V>iqaTc@=qqT+|p0z9n<2Cy?A`_oGS7wBg?@waB^6HUw
zwJ$~t%!>RizMZV1*;E-A0vq>JFzw*jP3aPI7h)oY*L6A5hHh027ViZI2mZnBrYJY!
zcthWCOt`NPI=L*0q)lP6@)~IHLwzM~X?9^FLV$Ob=Gb!RtDiL-91mVKv^QuR$Qd1z
z>J69BniQ!v6sW`tT!?T)O)&AqOn4Z2cb!=uh&6(&KO2=MT^MkqX1knr268AQgBGJ%
zSbu69S0?5u9kM@4x@j;oTTzQjiZNS{|3aIj(6T=Jx}>e-jq|hRe2;A)uY{l%HtDlr
zg+S|je=kk}C5a_heifb`Bq;=-0gFJs*`Bix${Z%cOl7G*VU2luQZ31v$IoRIw_*Jv
z*!T$isuVGH4<{CPvj}m#&$-#~n_{)^RfEa0EM1sDYF@&g@0>V+jIH{Pf~cO&DE`(6
zq@SpE-oePR{7^%)0M1$iX+_JQIB&MR(Ii|T5w(J7)m^r!w7smBSP|S+2y+X}4(%Ji
z$~;c0hm*vR#o|#jmJ!62Lee&)ZP)Yf9NtY!t+}G2x{nx(x}(o~L+A!FSO?V<JPcTb
z+z(!f8*}meFo<ROnvkP!5oC%J$lE(<(eU=K0&^%+Mo+Vz@iYu4KN-bAGEb`bj79Ft
zXJHA!#{RU<s{Lp1$SMUUbnrb>g0xyQ6Y?=B0ltMvp0$1`FE+c$Ki{%jzO)vkSFou(
ztFu>+F4FA!gE%`H3V7M*7J0__jC;E(-Xy%MwZ<!bE;E6QGVw)^a$xvrRE447Sl6&>
z4X04uNUw&)HL|sD9qAD$JL|M=F>X@zPQyL(*LkK`HZhEw0{TG%OX%ZZ;O}PjCwUsT
zItLt4m4xY>d9y$S>yZs%R|?X9J|L+uZB-Jr7+@rMOzqbila|_C{W!dfPFfX{wcr%B
z82qa+iibh_x81nE54I&7Go!8(0{)<JeBHG6nA)|b7~Bn(HQsl&i5e|HWQ~!$hVG!K
zxR!C#cAZ9AurXWrt017EZEI<g+1R>Y9z;GSwm#=<yo3BMU&dwV&x228j^XeJ?&Mi}
zI_zO4Ac*Om(V2<JadmGpe7ekB;5b{nks}IupDNb7pEYZa9X6sTQEx-#LKW-x*uRtg
zXU=u2Qy)?2(h96}=QLes&embprWO3&ZZfIwIjD{Hh0J2@IH(~GeBcN5eH1S6>`sQ%
zeCp!^15ulv+xrpCp{GhYqM_nh5#L{PU;C>X&swm+PoC~|Qw_B)m{EUiWgHQm0f^2N
zm-miH+oki`xgAdcn+=1!!8h*GYks0iq1W1>u{P6rp(6TWWt{PmU;u+}=ns78o)ww+
zBPz7TU(^({a10e#1BMRzurNLJgkyI?6O~?XB#@zUlJx+Pp@L$}eI*yQTt|k?p>+c%
z<e2lp5CY}7XOXFHU}k*OxHQ_=3KTdz`*PClx6!jx5vj$ZZ(sg9%tZfDu%eZ;FnBcK
zvS;*lcIi6->Kggzk%YK|`}Lv~H`krIq<aD5>{>oB#Z%>7zGy4l2Ts#kGROa#h3$P<
z-MehiE@Xj4XxGJ4xOR?Gj{!Lov`&T$cE3;fLo3f5A<t|b_}oK(#CE1mOMF2WPk$Ro
zuU#C5i+)Dbd*sQjW-*n%kRII5AWhb3-HzAM0P0BK;ztEQ8+oR7lQ{d)>mTe|ZdXw`
zzOIS@QZHJ>45%FAZw=cJt+wC&Xz|cXQJ#tM1EXngK-y1a$KmXOBNv?ZcsmnX9m{nc
zTbPdVOC4Zgz<`RPyO}c)e=@@JWGwqZ&jIa4PK$sdsNeVXgP2O0vxRVSUyRJl=e8cd
z&7`M(9a**92ZW@Z*>;#Rs(0tGh}vql{#IoemU6JsztCpXXCs{rOJN>Si{{x1Gt!2L
z9BJ-P^9O$GBF0RxoN?TL9@WUYY`zG)9EM8nKZv;5MrV)f)3h8x#Ohh`BQ1g*b|v(;
zd5$>!TW;m)dS&{uoYd&9S=Ha$W*&uD39iVK>~0i!(W*N&4^uAdXb(dNhIH%(b4NJr
zbV(+(B;zV|$8ujs7IoVNA^x4`{L?U822vXYwOtssOulBB9%PwuVXNfvxff>Y>1rh)
z|6tX8>=@{IKGAZc);@k8pCZLIp%%>jouKPirvE(Lxm|2nqSCSQIRvUkwe6e#66qgV
z99+;^Jm}G1_eVye^-;9BLaRzNH`>YKPjzqF_g~5hH!J*&<tzKH|Jk`=!cuwUB0v1H
z3NwEkl@xYAY%Ec)P80QAKhdwza_=`4-*E6vgR#n^gbHmLHp+XRmE$0!jSM@tm;XNK
z%bcx_rEvC3kMh79ILj6IaI~W(trmHbP&{bO+KLQ5a%`l_Qq^#0L3AfQuKj=Qq&4rq
z(Sxn@xQeO<jz^vp0LKn@Pcm`G&JQCqw~_vp0pQ7q>g8fj%GZ+>4dX9;{|<5`d<mxU
zcO?6BWVds3%V4RGQt>U#n(+rdl~6^~l2b7Y8atdvWw?WHY}CSvdSj?=0npw4{nN*#
zf~T@WgVB>w#)|q^k*cW3MiF%>@{d6wEs-JRcZWG8#0Oj~Qg7M+d0yncC}tBydn_DS
z*~eqY0E$hcmdtIr5SjVJ_)hpilw}Qt^rsK2dZ@vci0SO<!E#}h>9KTyXf<aqZ9Pw+
zL%p~g3xhn-5+BJa;|usy94w;xt_QQQWF{WPZhs8FDy-`3LNOtArsG$Z2-#Jp+AifW
zqc%E>`m|k1nfOqh{T^LfK($S(*X~e*`4!Et(QYJAli{N)1;wI8cFsgf<r`!4*uBZW
zdsWTqfITn#+qX<anoPrwLVM?1*ot>oeImWREW>G{Sqf=<5ohn@<;gpwdakm8P+XU6
zLcS>Rlx`0AP4VWQt&NP@-ZW3pzMcC+b6zPBA>7Ox*vsChL@hiC{JI)olK0g+?WSQ(
z<00TYLpX|A6elA>Rq9z|t6XHMO|7-;BWq3jIfho6wkGeN${ElTrp0>`ZMNZomr~^1
z#a&+t>QkUWvz#|^5wB-3@d=EHV|pZ?8r>PYzF(jdCl@9vhw=JLrbb$g6sj+!Oh~;o
z*El=L1>x-{p*O5OwO3i0t7oZx75BZ2YPbV0hzpv1Bu+aXEb!O>o7A0uSb2_C4}P@S
z9(web##BlWMs^tUq&dgpnmyCE0rd_ao&koZ=7b#%o#_p`RmY4Suhp9m<REWepd)Cr
zAG<pF#p|M0p9aTcB}G;BDmi%;n4YS5oCe~~dT2cByFE8Sl+YhskCb~dhFc9A3J8o;
z>h0NT4)6g|;8dj5fq?bl?A(zCRgZh^{7!egzG|KAUg8w}le~@f`;CEHpQ{Z(^=70C
zYM}Zy=lno{;QjsA64Zp5fc9_}U5Bwo0s2WYX`JO_-+b<P|EFsecoN*CM19pZ$0I7%
zFznkv&iQvxE)N?8VOvv1iXIly0oq)6Ip2O$ttKB$w*|XX;?bh2mNAu)Jg8%{paOld
zs5e4xbZt2QIV6^ERcQBHN%_*`jN|u|u7cYgM85(-La)|SVpM2N@W>KG9vg~btGO(7
zJ7DDh)`fc=uPxOXa?&bsW6?QPq6eh?OGJA>g!_-Jo`@IF=D`ikmv&ff_p>ZPz4htp
zE@2;?h-&)5HJv|!5=~ix`tH*;UYg$0^BFR1%bzY}t_azvaw3V39DkCX^QOO|IrN5;
z$5YV(PLHBx$4u=D5r|mQbg?PwJk+y<qjBtAU(drYxL;-~&p1}4^SYKLwSL|YWOk_K
zrDEpTGp^;`VdmKHtmXT()qVSZNLpg;hO3kSU!+^x*nNEGY5Skxv*5dQkv5ncbox$T
z&IZROJ$z0qIll(892fKa@F%^K|DowdYGq@6-WEpo<OQdlTMze6^ox9*$TkM@2rEJc
zZ55xWZ0=e0S<|aXao&Zi3P4_8z4$o2w6!lGjFFGJw8U{T5FH(*X9WwXwx9IO{A%Y;
zSwox3##sTgZ|V6&+@6L;mkxcuWvc(j+%VPAFx9#u4zjfNx`XYzD0fnb^!!=S?+1W?
z(uE(T3r-^O^zA9(@-bt{%uu@AUyW&<P+kS5?A1TNi1L-q3hyp|s=Q8qFWvO=_bbgy
zneoU}5ax9<xlk-kIh$TNyIl>%S`9f(4Oy@733<So9u2N$7v<2P;L`x|Enj|7z5ov(
zK7FsvI~{qKBmBZ$jZuhp{nKmVOqH4;b$3L~uxrgob}lk<?%p*c-57U@CqgOfRfcmK
z-A20V?rf>MW`8+Qm$7yX<!o9t<!<+O{&HCV<p>P+Qnpy(eX7~48)xEj8BgX=dFQ2U
z&%}Ed4aON4b<W`pJwz?7p(aR`b9hk?k#%*bKs~iglSS*lsOR@N-mrJ(ka|YLLVbEv
zeY#UE7IUzPbJ)aLKi*Y*_ulVwR%|&%!&?95oig>FiKi|On|D5|_q3kJQ*>^s*#6{a
zSMP~^e7Nfvcr$v#E*g`3OLN$c-hb`7u0T7mi^0t@+xtn_>%GgTpF6`mlPNZv_M+S!
z*O+u!#*y}GI;MI}n-L6l7T?ALzKutyjib)T^`ghazjX^1>IyLE3KlBFrsQ@P<aW0u
z)2aTu`Ew@X#4&$ObV+TciDi4yd^5|`XUZhWUo)!L$`F^+*$&amUp$b1G`^%NMd#|S
zO7vIldGZ#w;>xegn}1HdbcZ^sC-oPu`dDMpl&M|#nw}o>4W5f9DGjI3lHCgR_+Rw?
zQ|dN9>q(r!t&+iL=S6rhOds0he-V_Y^{7*OKIgxNe9eXI96`1@7FA1^uH2i)8ckF-
zoe?@OBTN$S??)WA=A7)upUBjhJF#%`$qjwG_E4xTkUtIP+Xza3{UqfxS2<Fb`BPwx
z=s0_0J!pr+<6^pni;DmH3yw$CkOa4zOxl6{{|^AFKvlm1WiP2iTcB`6e-qi&sIoCG
zXvpV-!X19B91Fg%$OP9zTEMV)1Th?X5gt4CoC@}kAyGg6S3_Ijl#;w73wt^xnvjQk
zPr22LK6ZW4ojl=hyT$;QYk5U`#sDoMn_Udzh=+XV#hZ9L#s%87#ATa(Wg?nNwZvsN
zZMvRT{I^{RkcG^r`)Eqz(feph<K9J@pgNZ<dY34AmlFp1D~1zR{RCYdAwu@(WfbEc
z_A1i$DvI_fMFVZU18hpkvRwg8pZas!B@`h7_}(f}QtVe$RoWu~LT*tp21IJu!TJfU
z1|ocT+c)mpU*B6U!stocEF5(841+YajKX!{%Qx;U=mh<-^(?J%Y1%<<A{G4ZH0To7
zn4U0H0o=k01X_bfmGd~l9w7Dvr+s6%cHaKQ_0TvpRgqWF4tX+F1fG0B+iJ;}Xxacq
z#0()2JcJCKQA{*lQYd{r5==Kv3oBD=HekXWq?E$^ZrQb(O^RHJb^`{<+ZKbxa1wU$
zVZMEww0a2xFSYd3R*Wli;eEDCbA*^m{hsOz-sfDX;7i9X)8_a)tzokIMzhe6aiHZD
z3|?Bi71F^tvMtK!Jkvdt@N;===+Ug+rfL8p2~2Vj8|_u}WRpIbW0NG~H@X>#0K+n<
z9wM_yN;Ez?1%Ao>9gFmE9$}<($W7&kA1O;3d4hG)vX3_!WDM#I@Ztm9DM+I+Zs$$#
zNgfvMb1U;s*ykJ4X{bf=Bgi-9YT;r|FVJ>&3r<QjCJ^<K5%FJe8yj<A+?FW|<5t_A
zLPcRU$DtezUI8<!En+a!8Df{#RGa=a;D&28$bRt?Fag*e8hmo~MR=H+a*I02z2+56
zf$t;t?`Nm@M3l^!TJId4T-O$G%MGgyjz+dw6`}9kn3Tx}kC2T~e)nTH)YIlD#W74I
zCOLp1D*PZs0j=EVV@v_cd)UY$e85s+kBbol3LO%E`1nJ|w!&T$5ETMqf8auNRZP4Z
z*eWZZ0^>w+W=|EGgFB|P{YK4k);iqo#ao7AL`qub7FFsuDCR^{S|#@D#7Y2ep<=-(
z8(PIxA`;Fqbb<A?o^d)y#~Ny1Rgqgx3VCG%iR4fW*e<30E^xszR1l83GHy|G9TAcQ
z0`1YsfI*@OKElW!5yBy!$Z<yMu66SeWf5Q=eRM%rs%tt5be5U9Wg7~?1zU4tw$qJ-
zbW9YAfZ{*xHez@CYDH8Rtr>r2DOu4|bn_*a<Vr)6_(1?zDL{a2JR)3p=lj!Hi}~bm
zTm@qr9srDR&fyLBunPq`UPDxjVK{EKT$_boZ1PIdH&=9?l7ggB-;ymg(?ppnPr;yh
zrN%=v4+$}i0P`f`oC#WS8%9UOufu)Dm8BnLvXkS}2plZ~oOv0g!g0)1u);EK<XN#G
z#ze}_&^PY+^axx}1gCry?(x{|&f1AxL3(=rG4D=*ePDQ@j<Syu!%ez<z;x>IYh+~e
zl1~7;-<?L7KuLOf_>xmh%tvxTXth}6fYVn?RaX-78776-ydvYeOOdwE0IQS4pLhb(
zppF3b7v=2nnXdC}@kzoB1psff$1Q|zQ>$$8b9cM2`S7Me?D>m=uWb47aKb4A=ncZ6
z)e>*nwOL$V!zmKbOz3+!c+srV+0ozLjzv{l6eft^K!Zc2{6E#CZbT6zZ_$Fc#AYF>
zG6_>OPn>aRMmVWaSg?^9emaC~aha#b<n^A8c_yM=SvsBrN0$Zc@A3-H2|XG+n|$1N
zjtM-s#kIy3EKUv3<1tzsF<N$z6l~&&AZC&fPH`!<AH%sgdLW(-?CVoc=LHwnDJEm{
z+2C^WclQB!Px!<h@(*@FV8WOiC&miP9knwfiM1bUQs>7orYSYSJ!s4eS6fTY{60Yg
z`eH5JrRuA(L#&lx)LryMZ0k^swTsmE#{)wR4HFmzvg+F4K>-FSm<94wTx&grSzspY
z)ii9?Fwu!leQ^#5!2dR$98CbO-xt8{6POQus@0+rfLn1mcJWaqC0~pC_yElf5}9xV
zqVm060VYxyL_lgYqKyTc{6bQx7+P=`bEx!Q0GLd79y4@6gTNAiBExXVL2$?&5cee|
zQt5?+R_6x*R<v2<`dKV`SuJ{56$Mn_B~<l#(hGXh0Cf>~I$09{8cNat6%lwkSqyqv
z5T#W9MO5%Q(gk@^I2oKY(+FzT(fBzl0D?{t_|esL>SQsAPLjITm?_xZV9-}Tm_Ga%
zK8g?x{#z=`93j)RX;dGar+yQ$Ruiz<(8yiDu2PsUARa+tP2^=w&<ft0IbKRpe7^kF
zOfh+aPh^*aFdi%WN=-!iY4ZAM_cUi(q>w1{B{XHqGeF}3#X|J-viI#`qjD-V>TuX!
zO#l}yBbRXK;#*`9L40jf+xR$ExSH0?WnD$ON@^Horo(O_6dtk60#u%gx9IA!W>gXc
z(+UkeMd<Osgupuga2y?IUm*iJZEzj^@`pzZMobA@Q4kdbQBtuuSVt4kQ6S(@Tk+6P
z>WipH2`@Sev8+_)Z;HmKFH;y`0B2}gR-or6S43xXi%bL5-apIC!JVUB7(o-Zv=!--
z;7kD1*DUDj)J2t8Y$o&CKvdX~Wo7OZHi2?`r_==kYJB-oiwk4gLC~W|M+{_?Kf63w
z6rDofIUyytP82fj7&PFlr$m0mbNHD-vTpz$@|YmhAu<{`j13Uj9`~_CE(6*@5psL_
zlNcD<y5QZHdkhUB@EXQJb(J>pLIVk8Sp>>!O_f+(y5UN|a*^1|B!*sefehV6kCJ#!
zL6wDzM@5b^&<qDD-oYUQne;V6$!7jc{(kZ5vbs<gL~2ECO}14%C8!RH%v0E1hcF8|
zAVK^t&_VnxuyY8n_qO4Zz;g($@K}a!0r@tJOxZmHj}vU|cNg;J@mF3S=J~<=q2}Rw
z5NkS3a%2U|%$8>P(C|^^XdOKsa!UlI0-_55>n?<f_RUE-Jp&gK)OEnKZRKblX8Gd~
z!aW01h}kCbm^~f|%Lc98n>r$P0Jb5;ESJnZ7`03pmtRHYgizi2m1)ZP)CShD-r}GB
zc5)&mR|`A%d`k^<?&jk2bO%k|iuTYCk!EsnZB%efcG;}S<YQdf;RAI7`ToNB{>%C7
zd=!q@P4StQgknWyL1bk@gk?d*WoEcKdw_&pT^DG|kwZG~Jn}S6<&Ng@aDbT^4-uVI
z%Z7ncQBPQk)G%oJiquSP&E*~V64~WhQD^>CS!5y=<s8*;!?@(w<JU_3cpTiC0`0du
z4n==$PY3cp8xNV;ZH3P1*yC)ls<}`nc|;+PvT{9iLK)bIydEMxkgxW=3;~xqBYv3I
z&6NjD|40CX1<TP`l&w!{utmXw8)=>Nb%?TQIa!Wb7KA~|kyQ$d+Uq7F)q*T2-r3C(
zU;}4Yf-rqYI2`0847NjMXADj6tQ?vKhK0rdxGg&xh5SR3@qWJ|GQS4ytC2=~hs2v6
zCSiWIBYyT0cBd}=k<d#*^(4Xu#?z1^0pHY$XGxoMimIIUI@C#ahI|x$xt-Yg))-gb
z>Jk3S0t69=cYv#WLu87c$SPG?wl_{yv~P#()T^~^ZQ~kK3wY8X9sdZI6>kY7@O?zN
z;+W))=IzHi5|K%(9Auu>b%qxB&TsO!SU=D_6ZV{4{iu)_5%*<;yOLhG+md}Kg#?Ml
zYv}tEZLdxR`y`5$R$+hqkKKBb;bv|&@V0vS$!I|VZqe7U<ggI!P=YUK`thL21}<(D
z%8@hz*wHp&uIz%zvs7mD?qARtSd@JE=fqHlQG+uo_#w<To^kp=dujsr@okJf5g0T2
z=mHbFQPIu|ij#XbY=@h|di9KJbt5aVH$zfSB@(Yj0K($PG=Y$)P6)T$+B~dBB=QUK
zKuff$Us?m+$>0Xm<4`?W<WLLFIW3g|H(%s!^hO$d^=p^tPze(1nq7th2Y%XJ34AHO
zJ(}WTp4IWtTfQf_Cioj08KuCuaas`(Hr!)I0zEZM#sU(zXbw>&7gjU64b(*8ks15N
zT*C+uGChtF9Kx#SZ`?0ff)lZi_t5v01L=paa@$pP)}ek;ZeQ0%eToGu!TFKMUfSP0
z|C|}t=|xqZNBVZ9?X!dc2)sj^R@i;4X~L*10alqk@ZF3hkP##@#-p~^(N4_L-W6g2
z`!d=}ljnHU=4288T|mVNxuiQ0{~v_pJroW^7w%@^pAur5YsG2_{f;j`0wbr)nag=o
zO)eEw0rC>o*;`Q*)#~yRlL2u)_`u+feAJ;ZED5KKgzHV68#9cA@ItE}!<PE)Wmc$!
z$+G~YhF^>IOE5mghbkoSQ0%z}{F?j9w<;<MT%x4r^ZSC0?*AJLqpC*#`+|-B-x~|L
zJz8P7q~(M2f`~5P8!0MneVewV<oTVsIETxEiJm_jK56Z4zwOS=xKKYD`i#lawCtq0
znYcWz9}qwGq;||5xE)Yk`<{!#L0qmK4uy=$?ZxQjD?@1EOiQ6MX>XO-vKQMynSOj1
zNhe`U(?a@+{<*>Ge(2n`hIU{`27+tS;LYfJS`s8n2)@ft0eboQFnRep`S}>+gz#!Q
z0o7%EePw!L%ESpB2Xndlux(`w-1htbx%$02I_U<={)YDZ*kpwu`pW*c_WRWK`|tVs
zzREi5{>uJ__WSC&`pkrd8%jF&ePsY-g&mQ`Iiw{C_lT<dM}q}?`TEd`RdIRx(27-n
z#9Q{bM?HXkdw_n6@C*m=4fzo0WLx97M?C<3*YFLG5a>VZL5W>}){2c-IbEG0CeZMr
z%pPA#NLpWbha^fm9f8WeQ4zI(Q1GIYz0(jm=3Q7l;4XqaKlZ&PpLdDyeXRF?HmYcC
z{iJ=rH^c2*QjePn;r;@PGYs>1TQ03lQ7LN%h@v3H6PjL4{EC+jP}={5LGZfZ_`F3i
zZ{P*fEnx-|&{2BPCR*U{h<cGj`~}sn;RZ#Dl?Xq(MKLY>1=4QS6Tbiy!0=IexIeP|
zHQ%!QDluUO9eu2NmQ}2Jm-la4;i9@(I{xtnO$yR<aIHl%fI~$zX`}_;Gr0Rs(WC|6
zTLAl1HX#N@sg(#UEk!efPZQ6pxcg4f$R&yyplbIXF$PqelKf?&+TaD6dXvX+`&2iP
z25n8KdY7%h1=j`<1(Y9=1QXfU9ru~q@$>oG@F8IYWaVK5f1I!Zn0mwqpanp;Ap{U!
z5d`n8l>uX3viQ%SDkg+*%-pAYCO7=IHY%rLQb^6+&dr`Ge8@lCL(=>b{_3dFZb&jk
zB@{A6CC!w2x*kumiqryW28#DR!{fpJ#&!o$DAi3Oyqiui$n@#bJnWon7jw^)n`VY_
z8v#@NivZdyVvot{;@C_arv@@N>F&d9V`5+(hb^&1?AW@Wt~ND2BW9~QAoy@dvJ&KD
z!FDYp!~8t6Onj$js+OL))ClUM^gZm6c#GF+7K_%COE+#vi)3KiZI6<l@dHzC(_xMs
z`UbR;i#j280Gyj4d<oYPD7zqH>1Tn(qs)m9<&b~DZJow!k#R4{QXK4<LPvvewzh93
zQ7!6-Ri>V!H5b9)6%wOIx5MX@1ZE!eeGS3FM*e8S%ADPuod_UX3HzPcY}3m?I*iEE
zX_?q-D})50air-ZR0QIvu2rX(p@_m;@YS(B4AaB>4Ne$Z*FxJRX_48_J+T29i<0un
z%Z!(pnOf1o!bMYabey&p7zAM^dKH^lTHdr-Y3-OoBPt^+%c|>~hi9kba>D-U^-B#(
zah2_zt`Nh^gUgJMpN%6Z$m)J#cDu^L2TX)D=zhWCv&yy&vc95Sz5E~tRgXO1jB+_~
z_h-zVV>~N1?xK46W{I83zadOHQu*japhl4x73NwHb>ISASJLG9QoHCy;Wh9EbG=gF
zT{uMA#?crN<XRC0@B$$|RcW1&_q*g;8m*A`n2Qk}U*%CI)ppkHcGk6a)Ma+pJ$BHB
zfPd7nx?Ok?lsM<|Op03C2;y5JUYLE9>u~2e4=@A<1qeQ9xLUE=eZzQhKgH}Kla{n2
zfk1xIr@~di<iuJh-Ut4vUgVv57oBuG5+mO(x`#q$T|_e%2TVbl_g_B*IWzory`9ww
zzRA7XbtHFARon#d`zX0r9qQ`U>hZz*tvuDmV7|#c=o+}N@6{aGkNMD5s0hKZ$Uy9i
z>;c^X#{z9)b1n!nxtwvp&z|INT=*x*3MEGBBBn~AQPF#}Cvkp}!@HK@1%4soYVVOH
z*#kV>IU%uh<a`*Ib(3tkda+DS3y0P!Jc9IW96}6i#zz&wBMY0`XE$`E@Xs{d;`N;L
z=oL~B>_nW>abu7Pg`l3a?tAOqBTA_V-^Yu{?7P6eM{1|c;s`qyfXMZ7K-U}JQq8o|
z@<*fmAvVQ#-7Q(%iy^6#=>ysn7n7#rVm2gy9KuHW-tow+Af(rv6AnX}7P{O8bhCie
z?TN)Lx!h*JK3anHs1~XMEO6x(#y7%ER1xkP|B_o7Uk!)s!|wr-kOHKxA(ZcM4&~_6
zl80602R6R(cZ@S@o5F=2k0OxtM!VXNpIBwZlS9M`#{LSzE{Gm}t$2DUB8N#6(?97G
zCjZnz2*FqVLBv`_*&&YHhMW2*`@_5FHY2p_Yd8fop%UvD9}69!U;*ndgb_!|i2!$G
z1*vd5_RWf3(5k%|Ifz|@4h18Ois8Vg0VsXj*(t89J;vFA+vNQJtqt|he^o^0CqeV{
zt16MKR4$ij2A5`bBUCaAhQZ8<#4;`n-a@rlpZkJkBL-Bwm1c6vu}Og)dYeqv%CMot
z*42>N_Nz2w>=(C-anGo<W6176ogpq0Wr}h^dle5ATEU;WelHkgn1KT0fg=yF?0+EN
zhQ@1)$^8{X2!OVOa`UQu%xC!Ga53gdU%}={MR3720Iu?ylk02vnwmSOwPmPehqXF8
zqV;8|3d*eb+m$B<%ZM8GqbCC*`lkdt<H`iW=i_9I#T{h66|dLnFQCb5(>Wdm6zDWP
zYa76SxWWjf5p?6-BG4XTk_RE#{_K#~SlxRKF7Uw{Hktgf@-bJb_CV4(LRRZAliGIN
zacVp+5>$cQN<816z;&7&5qPZV){((g%Cn=gSzM=1bx+4Y7&XY!0jVKfEbZi#H~e<o
z=+|I1m3h;C6dXw;q>;y3HeBe*U}e?W(fozTN|zbY{2ZHIG<@KO5}RE!eBg#=8(lIp
z2s@!&G5_MmN}X9T{6!jFHw^HGI2v6rMgwl;V$*S#bYevU6LIl$Vn*T<apy#0N9xma
zlx0>H{X}9<;S+EHAe_0xGS(BKzBilRezq+2oe|=*KER15B-WeQbW2xc)|-p)W(+;+
z$)en{)*W3$Vm`R^ZB)2j$3Pg>=+&GP_Xg0Io;O`CRv?GWo=T-?@%&0RT`mdn4ic1I
zV4r9{=+-Yy5>_ycVPX%&ltQ75A#j;tViCeKoRPuWGFA}D$YN|D#5v|{7-nH+Fo_r`
zGaSgtaEmjd5$2Sc7Rxd`>>ZgQQF-G)Le<#N#5~wp798-!vRP6HA#fXBHB|o=aCLn$
zQUeosbtu*V8kNCOc_+X^>>a>D?r6}&7nD@@4iFlkW)K>vVp0dzLR8~hA<_qJ+(PVW
z+(P2q5E>3>b~Q!Ikd%Wx?_+uQKtj~W(8P_{SseDHobuhAoc~#2(g&$PLcjr0dF4Pt
z$H7r}0oYj*9ZL3!*jW`uw4C$=U>oFkg=7X`6dY4aVDL;Z%d^(GGC$+gLnFzYOf^VR
z^HP%B2uLCs7(kJJM=`<_lwi^ZV%Aw0JYpEg$$4~Mb#x%MKpL+xQUfwTbyWm5W3f^J
z;y`t1xQc?5a2i|jE&$O~Lek1+r;b1xp;>2UaKLrQ)=(Om=ybocrdeyVdS@mrOX&a5
zK}SP%ceY}6yK$85G-${C*Fvq)l+#O2b*o$ve~3&QrdNNim0hWC1ILpNd+ti3*)E;Y
z!lkGoe-GC}rKlpWw!Le!1+_SR>EpkdzmS<-2Cy{N`yO;<3L$a&jC338c0zS^3)VtD
z{bwxOMQc>rHtnK(3aE1f3J=2HP#PLzC(HD3kv`EHTO>fhSoZ7C6=b|pdDTEz_Iwa>
z$^OG7j9kG+NL8|Y0W?y1**}=}JC1VR{-ZAA*;a_PfQco~)*OjEWvEgS=pu+d@#aaR
z*=M|IJ?{vet1i$Mw2z=yJ?{ydF~yVS_N_~O(g)T;RHslFLyS@C3$MfvRlvZgdDuph
z+_m8QrH@qzxTt!Ro$&jf3R><;fCaaGRSuY_dX$r}`+ZMU3G%3Vkpr;%TA$MVQtevf
z)wl)49}D35Dnx(I)m1m~6Q!^Kc!^qL$73a}n{gM>{MAo0mb_cvQr2UT@L?!KSbtNy
zl%Q_wW>d6j4kbv9um#LslKh<}MKnv``(-(5!350^TkjA`^+Ln)zUkOH;dzg%!K|0E
z`_i`B8FVlO1M}QDIo{mobt?OW^Txi2%@g#{*p9*ko=FQ34_OI>kG@hK0nvgVW3F#h
zL=e-EU3QO%m6;iW_{c{k2b%ZO+^}q;3q1{*1^1(b%>UJC+RHw;flvj9iO@b6TJ>Su
zo@zA%5kF8=OqVQjOsGYS+Cen|P#HAKigg8e{^+IzGZAJ&BJ(*h4DR};lzLbZ8hVh)
zVJ<|-ksAF;V(reQ5~uWv)Vd1{+#3jD!U5_-o+;qs3|NJdo_o+PyeIXJ@jxbmpZo-#
zRw`PA>lAKIkV&J#&=mYdvmj<VK{5NI4^-36Gsz1#jpZp@<v0WDSp_(dmX;YQh+Q%^
z044BmcZx*W#2tIP#9_EGCJ~(tmQI`MFgh>C!jv~cs6%C}Hx6A=mWyA>OOBsNR2k<;
zj_)q>$!ba&G?&zV9n}=aFgBvKl}dj!S+rNU(2Q3|FP6P{5O|CAsVu`i<{zn{>3z(|
z$bt^hBkh8*fv4z<)xZM`Qp~U~DPe#;w$$Ow6de6tB*5CMeDJP`T&kfAuQgNi3AA*o
zd)~HXVOu2RVGoY-dQYCf#Uqw@kvX65K12%1jr}qSB;=H@cGtnqit3Fj>B>A^{Hr3#
zb#g3ml08R+8~>0Gcay@d4|UX#?g@+PAGirY(nHh?bws`$+G1HhuR{lvRS!nlTm4pE
zJpev0Il{61g}5(N0UO4?Oyag58+fmD$rMb%OGXZpW0<lcQO*~7J1oGoz$O^{!g<s(
z8oIS3KRC2}`e%Cv!m=iHAK9NdU|JF%n*A+oq7)m>f^sZ#1yOVqHM3{Gb*EVwES;dn
zNi6BTb%!^3brd^kBx6~<bv^BL{E5!#f4+{J<_<NshLL+_S^pi7LmZ`DW2F|!mXEAG
z9ksb}MJGtYm4cECQ-4KL>nIfTeRRn)(eiQI9XgoWbshO+`SA9|+G84!oqKTh&OV9v
z(#(PLa-B+GollMXqS(U%i)MxxxLY|OQ5?cB+hl92%0qjdS<z$pRY{B1=$ZA$<W=PP
zAe|ZYka>y>Q+|rUL*#%PfJTC|W@-npW9??jSbr%VCx@eJy9dp#`JS&6Ypq<n8d%La
z7~}nTawYX~p5*N#{dry`jf4q1`)Za~&CCJKdvPAY(ZN2sAo6{f5)DLx>B1v@oWsB#
zG|Yn|bhR7VcSXz@X;ZYmrsTt%K>Ku}=b0f@l*7+{bj<W2bg*fZ!_>buir#e0j39gw
zhl*j_*>`138EKZX8InWUcUWaK&M-w4C%EEyU;GSasCyubw>#F4fBI&tkb*_LV8H&2
zQt<w+_dtf&vPy{hz=dE`)h5iDMQsfjI>-xgB$GsyC*-*(C#tiP(+kK4gHY+!Ekukc
zAPA01irN5$U{uVauwC+t%}kBT9QM3|KuhBoj!Q?>*Kw4|^=TQ(Dh8m4vp-$k8Qora
z-CUX7TL$2WeOm2vO5<uC$wo6A+hukY#{CK0ema~oI|efd<Thbd^I_FJN!{{+$dcyV
zmOp_uIubaXF$)$mC7in$y-D3gW5Gg!$ddNlmb^HeF#~2Z6=ODLLvq%r)SbwaCOnqm
z$%4VS+}SJS3CgBpHemV4pJ)l=YxNW~8<BQ7KU#Bdtn!_Ws2R(ft{Kad#0l$g0XDp~
zMmd!nmJCbD$@S<3q~x7V^J$|++X4o|LJ{kBa!|GtIyoF4*h53LMiVuf&X{nw<<ZWb
zI3G7+cmGpkLlP>P!EH2LrNCok>O*3VdB0l;z6dG40G}n1$=S(cKnG($V_{QcKsjST
z(QRZ&oSa;oker-cq<~|C5|dutELY%&hv~WWT%>?cZDdNH9abZQ5%i>hH*I8ApB+<e
zWdF`7!S~KNiMPl%&L9JyZE3g71f!f|pJh3>$T!X>BcE!Sx6hoTp2jJ*Ud}1BA8e<0
zQ(Sk-2MM;sJ#2!w;J1frxwgb(op@p?_1exkJ2!HQ>9)u8<xw=W(%hrVN-3SnlgwIS
z&LbcnX~J|6OjJQWkHZQ%0!!)Jw<<ACHxQCYlF*X;nRopPOqDZMmN?1iG9;2=)gyA;
z7fJp#$<QNjoQPp;Fr1ZH+2cqSZk(IRMPkG=h?nW#GfXybToD{ONg!fEH;|jj-Y7U=
zwIOm87g_vuz|bLYl!!rWaF`WX+2KeMZj_tZMMA`L>=(%2QA{~>J@E2m)aY4PE5W|M
zBoF<tex;3B4?xZW8}&pGNYF7=GDOr?Sa?G$9D!DnYuT1?m=$4LQb5#FSkgf1a`+a=
z-EmFQFH|5@P1W96JV&H@xC#&ku(QIfO;AhtbRcbzB+$K4yiya;@X`EN{6`Qy5%g4g
zSRhD{B2gF8hFuVGa3@hv(neH1T5v=ldQb-Ngi-iY_*FJrv`8>$ATsdj(S}o9R+e29
zMmTGb7@#Upz%ay6#W3L3!0`K0WmgnU-~-UX(R<TGQe<5)e9%_Wu2$$-uvTz*5FOBv
zQJ_`~SinSZP4H|GC{VLes8Uu_5L;kCAZw5e5F^k4QIJr^Q#w^FQXzXOuMkvFUQlLH
z7*NPj&}WdHP&`xUOfX!~15n^mSWpO9a9i+t&^gebQG{2ZR`^kmp)U(8U9BUkPyMgn
zq+^6%4J;I^<-K?1F1V=IxzVLJ>a4rF9|9<Qu($H9!L%>Rtsk(*=WJP^3zIK$Y~G^N
zn-2o59H#S|Z*DDErb~fuY3=%?XNF$`ES;vilrQQ|aI7Av_oGxhTeUx3EziC0cWf1*
z3xN(6s|$v1Rw!S+FL&%uqSu-KU~H(SAAw&0?75?to}Xx}tfE)8C;V>GtLM8v%&vHC
z?YVi4&pR!28hKCIfEN+%U8MDZ&l0VVzBd+)C%;b?O#`_z^nTLn(z!qS{^aVLyYujW
z3hiF2*}9AHH#*IpB|nS@F>T$ZyMlA>&bF)jzt{9&VXx&4qPzb*s~Ldz6V2Pc7eTB$
zwQo{vjIejnK3%BTvTNF2eJK;Qd&&-cXsNVw$UYP(wzki}jtA)-vv<q>L5!dv(XnTe
z&)iDr4tpRsoUT0~X_9|hjM}ni%8cQ#W6&-;p=*$@L~I=)(U+HE4A&ylmmf}SCLxuV
zhd@qZ=?$~L&i)E0x3LkOk6B(ksROZcy2PcfQfOPSH`RVr=ts7%V`yfx?`r5^vd3FY
zaG*z&Ut25$J@w`ejZ0Bxg@`5WZib6dCjgE+J1w$jS&TO(z22*%KWFU*tZPl+&!+|N
zed@lOB+FVnY3S{<y-()tgS>O@ZPF%1h>tkk^XBl1ha_!+=k<z{Kh2Tn(u{9D4Y}uB
zjWZ;T;wPAhqwe09UBU}_=8>P(isqIppN~d^%TB!g=*{yb?fYF*WLJi+!|Go-6ZD42
zN+~;Y_$Kq}B)PNqHq1&bIZ=aq1ubr+vxUnZJwht9xGjfM1x-Ru+zL{-LGT9CYI!(y
z@b2lQ$?^8hrGxOU#N-Enw-D`cBnyJ`9bICixQFi@4Oa^7xjp~(`bwHPKl~Q(s@%Gb
z@sADsxg+DBH*@eYt#XL%i6x!JIO0Q?BVj3*ns0q6_m~rGDO9w3!R`Pl7c~*Z{xgZ+
zw=u=m4k^$!y~r*M$%!^e%Jw*^G&j@1vu#Y?Np#`^HPfkE#XQ_2{mxAHVr`iVVQCh(
zBW6ifH?M1{9<*)6UIS?`HMPxNG3nklgU3D%$sjeQ!moTRgrcjTKW2RCA{n>C!J}+k
zgd%Q<VK={U+|uGmnHO<P)#IJbY~5nN&dk@M_0sNFXjQRM(vC$)I5EZ7Zf&S_$wsU0
zMu@61$=yyysGKrW*p__=O(BYw!%J)>;AW-ovinVlC6&f_;6sojK`5S*Z(S(&=n||4
zRE&8c<$xy_4G|^%vxnc04JFl%C(sU$C?$-?hmJui#ki+457QyCty|p(Prd^U)00~z
zJKR72E=%`*ZRrA`M;4DFrKeU8rmN>3jBO=dgGVq8wJfc%=iUv0Cq0d4APuD=ro1bJ
zzNzm%rhDl=84KMpwu_4cJZ?O6DMpanQv68a7LiL;{hd8)T>QU2%U8VhGVRx9Rfz90
zjm1VZiNQBz?WQ^iWadtrJ1l(|=GvPpHhiz-GKVW(#=Q#{J;mzANt%DA`sXFhJs~=4
zRQgN&4I}#B`wcldU;jlBWm*J11Wf^j00lb;y)%V|1u+NB55@0>O$T))<<SO_3UvsD
zummXoYV&0my2OPr-SIm80o5hDlLWOF<$4Bk_?o^3hVYuM2P*lB*ZT4LGW=R>dCT;6
z!TM>qz4P+kT5fm_f!iBhPh`D<i5GoWsv-DngC!cBSCsi=toNl+1Y3ad5Y<xTw)VwV
z1Sj_$Q=|g%4$~@9xDW9@+S+0`nDffcnq)Xi16dX2ZRGlc6&3AZ<Sw3JYYdker8o1=
znY;uU&$l&hx$2&dC1Y6}XK3lS9ZzQYh#XCBd9R#zVf26l7M&4w{PQB;8y|Jl&SEYa
zr+75XB7~Y%dW8ByG8-pxmJGRE0#7snnbOSF!u-}kg~wdO!cQ3ac-eCG>w6hfb*Fu~
zcQj7I)*0D;bfCsI0BII9x5MTh*yXaK*(*i7J0U8U;Y(x;!B6w=*uPEmJ3&tN-~Y5P
zGFaFSby(A~Mc-s3@?zWUDl$*n#2VpCltV(S8({+#FGZvbfu)u6K$>V+{qwxt7HU}i
zv(ek8V%UkYXczlUTqZ%elpt4co{=l^yGuBPlyg9YHFL{EEDG~6KqM&htw78c!4VZ-
zMN|gC#g+|CWClSfm8naVFu@>~0Z3FkVaJsxP5c(9qw--CE7=!Cn5JHO;Yb$-Y(X9r
zEkg7(a@O9AJ#t##j3@HV*eZHR_HyXkl4;10Gk4q0ewgZVhBN^Tk#LrlhM@GyFBGp4
zccA*V+OK!_oP0EqnYOv-gfJO$dzx~|4i8t-?D?%ko?As6&w^EL)gL}X(wq@+Z}4nt
z;-XwAqYgE;cpH#z{0{fltC1<N2%su^Y|5Y$C|uBKo)H$`u8&ok;S7#mP*5~busez8
zh;F=9rbUp`S<oSZP*V!yTCh<pyp$$Gt4dALC{TLD9{TmTP<yw(cg@AlkYIR|z<e8)
zyisj0Uh8|1Q)lc|PJ5%^I8bM@_TaTCD^so0#VIRNEz_?uli@#p|1V9eo8G3c?JE#&
z1fMYy&<!cBmfG<vs*vKNLc~S2P*q<Sa8OZruJ5=idPe1e1W-`%A{&mAEn80AU{E2^
zp!lPYLdg;BI>8}*wIm})cz_P@QLmuy?vzxU@nPd>?i;U_DFgu@uek&SPiR>E)xuaM
zh6SiFM-ZRzBF=$DPYk3Gq*rcLAtF9lSPR!s*AWA@Pw!Jraxe4N1tcriq$p}yZCJ8|
zD6YZytQMwFE&xrV+2XaCRE35TELNuxC-ZI#;v^XicawdpaqUn(-R~8zlU^G>k!_e4
zcG3k8*j9X)vUC6`w6jJGh&y*Pyewi_MsW&kpAM|Qu#pu>V~o!=0l6c^DOsf<!ZR0+
z3DRv<E=XUa+wLN0<xNtg;N)&q2zIE5?z2UglTm3!?owC7rGYoE(H>|0P8I)hlecg}
zf_{}^uL^iI4RpF~&KeiySR2g)eE}0qaKnmm`A4r{rL^KKP$4>I?B8!ik#X(;`7zTw
zs7*Ea`j>3Z8WjwpUB$JueD)NStW;)1NPG_P!_2}@Tu-UsGs4jhTt|?IqH?;}qx%!c
zRZbv7&Ca(joh}Nqa_B*<QOA%g1(MGEER%21dwc~#RvX=kdws(GQhG2W((^_aBK(y`
z#`bg@xF<+2u)Z%;N05TW36Gux^a=$Nd2!t)^mcdv?!kPL>)?Es062Vu^?t>&itYK>
z6nK%BkS2tI83KR!Qu^8%Mfic#Xk@Nc%dPJIW0$Z|Xifu*_<P`50ql^#w>;_>6&L2m
zX1agTT%XaR56s6Dq-!4}3{~PJ<jf#Vg5`Tng`>w69HZK^FH(#r!x9i8E?*BJ%YPec
z+Ls}V>9>0V@I$Osrl{-g>3bI{>;wac9PMq|X6xITC>H-_DJa{70D^Lluns;{=Se4j
z3*GrB7Se@`wXagkK8(jF)Tj8xnh7YfaRH0$Ht=-5Mjg6Zt=S-IpRYA0=Y_R-^xztz
zuOKL>Q8u-wBK_d-2gPghgE6$tgE9oae8uCI>eZTAY4Sf3X{L-dIVMvYg1kn_u2i0&
z>c!N-1?aB8<O35~&9TikdN|KV=VNX41H77{c9TrJI3{?V#Wfwc%B96B(s!^VLwYC$
zH5~B+eOfBX0szSZ1!EawO4$h>2@()BCqsLe6EcY{vtKqbrFzerK?B8KF;0_}uQK)F
zy@&(e1*nFZ#Z<@=tXeI)#Pa`tY<5KIqr6sn0=#|1^#Yw)wAFG_PXf4F8VLi6yn4EP
z9BSDoutj(o)poIVv35}Km{<aQc=d=D)%}9Og552}W%YSv`rYv&+5!Q&1t|mULqzo!
z(F7fIkgn@gq%g|D_G5u1yxdZmc$@g10mlGFgh~en-9&Wy^NPav&exKYq(mHfD4_au
zkF0o`K5uxN5d0wOhVqF9{Dj4GB^D2LNhNW$v3i^PL>hH@Byjq6#XT0~NgMJJ<x4yN
zJ%vdd&;>(U3~fX%0ubgZa0E4kdYuCr@6=BM!1Vg@5p@}4NE;y);`)g5f1r6rnqtLz
zYs5qz+I_6n^19e-F}#w(8+IBzb#kPvmB#Yw-1QkmH5C5rR75p;5iV0{C9rMyVY*&r
zdEW$eMe@6l#99SY5TeoW69TsbD*~AG=0vddVPOz{CjiF)Zs?!`Qvan#io`tRfegzP
zm<|pEcPQquEg-cL0?0)WlEXh0p7jwBt(sQCIot&v+T(=1!qh={9UK62>fVXl-&(ZU
zo84BP(!L*X!4Q)8Wj62vv8{Z_sj|^FL2woC*>+T@8dZ64bk<Y10J@^nAakuJL>S2N
z_SZStI!Uk=Z_@ZmeJiW@8g5efNCCCD<mp@V=lB|G()dbvWd}&&c$#%m#3VokQfe6D
zd%sNBall1vlH6ZgqftbuByI}Nc#vAoF%!q~DQ84({3sv9XjLCz@#B)#pAfd!|Fne^
zsV-E;(3;P9FkA8D1Ek~jz(2PLtX=J9Zxf%aMi0yi_nP(q#ur!<ml1~%168xe(2<~-
zkI@v6&v*h9p|pdwT3A8A>KJk?@UVV(EL2@mtd{v1z+O0bBt;}zb$0!JE&}JEek4%!
z3SiMJU=tijxPLBEw-Er(f3<6*iLGRQ$)^xMquVT}s6bMj>-pd06TuOn8rYR8n2nTm
zLA)xngv86$NYnC6RUuhz02Iu`$-A5j;p~(%-L7ne<6H7M#{M)p^dx%433_#X!^ULV
z_?t>fHCbmyQDZbAHOgd_=Nl5x)WKy@6sPsrgFE6;_J>nu%MZc*dXmQS?;!#>93I6%
zbCf@Umvn$mNtGJ<jO-x-`+z;@;a3))K<;sfv5W}T@?{l88id^UAp(J>8hI$doPrC<
zE%fK*6Bx$jLuoH?*dOTfCPDT+6z&?*RF2mIga#4{!*XJgI!U-^2XQKj+Y}twmeQ8N
z?>!Yaa`1}U<QL)PMm^4hTk=xIgdgH%efZ5(_}v59rW)9Wkq($IG-L%rY2EnJGH@OE
z`jq(H9(*xgSd-P(brj2R$JF@4a#@rS9*WwW5Ri)4d~nFvsC}tL7K9T)P1x1)6+Ot~
z*k*Et<v_j=S>-_<5MFT6I#^YgFbg7m^O}31S*C;y(o%i+&{9fE0YubQiveDg_`>dS
zh}4rhaop9zI&l2hc7z)=_=zY&RM&Gl^`ABj5eLDyJrq-O=8D-3baiZU2jin?{ul;5
z6xnqY(Uj0~q2)q2#X?s?WY9A@eWGVG2ze4gA(KM^dUOWzRCR>6Ak&#^yKoUAP(Ap>
zMo#CRfK}%5OToB`^d+|}7ZO^W!ITgZN=pG<JS?<9IemIx@pyu%#BV}a!W%=_=ny$g
z5W(4SBKX14&_Q`ZdMf5U6ueN;ivfQ;YNSG~fAvGs#dUj&3VZq<o$=Bu!Lhd|CI1`w
zQK;5AEHiL$5k@GJlwoyb-%xS}me{cW**!31So9k@ZOGEX6!@g%PC%@+;O!U-6;gfL
zyr)1imW^=Qc{wc|ST4nbi4hD4p5}4F35QUU9d+kWfX~?_MNrYS*#Jn>89w$>S*X?c
z_?43nB`g*6^8VpKaMv6$@<<1{FG7UDeTUm{6`AEisMm`+dvXgS43&QyK0!j1(5h|W
z1Xy)T0V7x<X7Z!K-#rvi2aA?{IZTMA)Vy>X0SL^wJ*fdj>3qCfF=&`sivbF|zJEo=
z?y{jeJ29GmnNWD^*ynRrVlw}9zo6i7$j}r6a*_1a^Y9B|N1-HG=KR0Srjd8~8zEL$
z`xPW{nP1rQ@)U*__eWhcDj>ZE7x!Axd8b#9+PglBS!sEp&5~Lh_b_01k`W^wMG;;6
z6611N<yzR+TRKOw|H}aB*tll#4nVg(67O@Kiq-@d;pJL{!GGJ5ulF*35dE1#rf?_O
zF$_Xd;r&OpNhLn%KyEsNyOaEM8%+?aNkrgQAwXw>+YtQ6L`hfBgK6AUNOfR3GFX%`
z+HhML#1uEmin65HKSjJbfh(7hN-PWkPP3BOzfJ6TU`^B+4@HncPz+T-c#siMWNPvM
zQN&JhjZq{;FbB|$cz4yfM{xMku3M;S@wC%^QXG8%3=^AL1Yv*;5~W!5bs*yq3)ePD
z7(DTY(3WQ<)zob8zgsv1kQGrhb+P$WJW8=OP&{a`R?x;%2ypP*(%M@X8!-^p`de6R
zu&LGdK?rGa`_r;S7y<C?)}~WLXrM(fZ4k-Qge<F7I9##gUO0C!ZqW)t02C80Mxav=
zS6)bXaA4BjS;&6yw$>6sI2&-dE9t%`<d0M-KBc?3ztZoJsymDyPLGf%zOC!Fe@X(c
zHc==|u=m<dA1H0IH>B?kvv-hh>9V)_?EazSksp6-=%o{fpAYStuS1DHLJv49v94#F
zkJ&1<r`MFvdo9Vbi>m*cZ!oU&mSJQ2yic^JH;Zm9vPaubV67MP4u-3D(+`xOdzAl5
z?Np=-gdYlS3aKNd9|&$%s2jb1*zK0B3$b6xZak&4r+-M#ktq71xwPws?ZE#AD4nZ+
zwkjpFx5dwNq;sc_KA>ZeKd~y&vsd_z$tt<NH?ogLEaAS_>JGOn9iSJ+KMw9XsC%oQ
z&h3(+y{uQ>Uy5!Hq4j(GuvgKJStt#(x6{r>FB_$fVk}du&Q2=(+P+I@M6#pX-UMkZ
zwX4qFzv;%X#fB$+jk6@3h}V7%CL|Gp#|Vr~Yx=y~=3cnyZ%pp$k&YfNCFA#uKp-K5
zUYjCioj&3qWsDwDXm+vtz#bCm6t&Cs{>N*2wbSq()arn^+s+<^>Rh?Q_TCNaAh4;7
zM^-*dj2r1X2Gt_t);@_ROT#`-X!^NVaZT#GCs7PiCtJi`NNE<do5vn1>qNNY_1-LL
zqPOeHKGJC6BBA33kqe7Fq5nqTeT?KjK9%C8-FSuu&`MS~aq%X@3SKw~?R|$hnc!W%
zI4S!5d*nWV8ylT|WgLaO2c0SB?uHu?riseuKi%VIuuAAXf#Ft|i!wMQj`Jd2hG+7C
zul1$oU7|aqJqvDt(-Sn=OU?L}>1LVmmZ4-;fXf#Bf8|<*Lk1nj<_wI>23;@aUW;oo
zeJN)Kh+{S#%3&s*`%}h02ua{QF?^Nq21VMON#ixlJRRUHlJj&((>A+($W$;@%zPeT
zFqKO~d<@~ZoO^Pd#$lkBn@*fR;#QKC+m;;(R5v-pmTAar<2;e!%7z<=WE^JWjnD>C
zNJlYc(6&`b7{#*O$xxoQSIGL3>sGu};OvsKM4S%cESJk`oIGGoHQn1bD9K|rq1)CB
zNmw-9#&%a+x?^6QGie-O{tp7r`l(^5#{A7N5z*!xV}00`X=0hs<{@BIklR-Lf8kn{
zTSgql;tZU_MqDrAUYlca{3GK4m}7Pv%3&s*^HT;tNJ-#5F?^NG)O$t9WHy^<h|4gg
z)fN}wR-J|mU{;V@XNb%&k=kZ+i0Lzd$EFp@d^3&T#%&0XG+EW#N8HNdR-WT`Tq9s4
zJpvlu3)}5CU4VcBz_>yUIQgQ}Q1UGhLo-L(n<TTt98{buwjp|HLufIdbrR9;R0zte
zYWmf4VH3&iY1uPzdc#8RQ5|B$V_`qZF3cvhkJb;iP;M-xpDFo~NvK0~sV*Q|t8!<s
zZX-lAkyS^ZC+<)eV}Gz)w?@xgXq=#_(c@rrn2s!G^L(zDKQtArCzr;UA3fOi?M{!w
z6D~dE%qFj_Mf{83qnLgyRBawjPhBpU@2pg*B1xfhZgd|y^L@bdwW;5^NM<w=FIw93
z(lmYVkwr`0FV`=8AE`Pl=5N+3ELk7W2rlD~w}xNO8!S+^5f7m0L8<@I)|j2FUFV)6
z+Bv23d{B9l5iMGNOwd9s^><T-b<0D!GQyWlN8XMz^hnJ-7oK(BkSMH+gV|N7ly-HG
zw1Q&Q>on}}_0Dgg#j)$)m3Bx&)~hhb2sP$PU87OY%qp*`70_9zzVor>_%KY*Qjh<j
zbQHQ;aqdwArO<p>k!ji5Pf<D6-jFY_39bs$s5OGhOFUWsi9n2HnQA)n<g8ndo(ZgA
zouGO-{e_@~Rhkn%Rr63ss0FS_Z>T;?qsa<lM^YsP4>bqSDQNq&l>$3X>I)XER*`0@
z+2^Iai3(@vi;@8x@hNB>gzUd(bg^ElPIeNZ8^I9oO;nCOnLm_vqhl$W-xBVvsGnIx
z{;iN88xF(CX_Th(d!TEO6+exK+{4T`tI41}FHyWVg6zzSX=Bx<CWWE6(7Ui@C%8}0
zD0#%;pg>EZV|Q!888Im|pih+MI{*@gCy*YfvQnc1ka~ZbUm)O*|Gu4vSQTQHj76-7
z_<ENeRKwTG^p`^}u_<$FEZLx6nLLLG_609dT6F%=y2%75TJBKyCi_k;eyCc*mOQA6
zjcN~24Cw4Az&Q6=^_QELce**jj#GUms47P}yh}A=#z#nBR)>0@DKzU-tXCSn+aTni
zQw5a5u>T<kEk!WF0;(s6-_S@!HvkGk51~G@d9Y0N3V#1v)om4-=n)nV8CggL0Y83|
zYvk}R9Ma4U%ZD|W$y=vA=iqt}r$TuA3aC`M1e<b0-z(bAT=^i)du7wA&DvYk1{Toh
zxe9m0txSZmvsr@T;yUyPp_FglFpKI2!Ydb_+$*30v8|Ss-|;pCuw>@}x5*K_`PTtA
zU%7#%4M-cmqgQ`O5Q-pqlGGa@Z1Et|=SFT}zQG^;u{KtKetH+zNU2@Upjm>c^#s|=
zyiS6;79-(*y?6B(1>`QabFHYWz+OUmhi+ZhpTIFsNu?Y2-(>=Nf<-tOmyq6UCK7#T
z=FO`gRs^4g9yw2C9;p~o#sY&h`4l2PY!C=Vd5w6zPR7l~z~PP7cgqkR@UDZlfN3z^
zpf<hI_0zHAC}cVZ1hznuk*6?g9mM%fAEXPZN-RiK3D(A2k5&kXDuKqETwHG5(cQ`z
z0@QN$U#WI7TaYk_ZU}pbe(X|s?$Vm|kr3c(r6}%dDwJ6oJ~8dc$j@F__U#<&Vd0fF
zfF$M-S7*%|s3Nb+L&7k8-_T6o`I>6e>VZbvVrp_L$YIen6qWK8C|RRLW*IeTY}f9p
zfyg<K>R`<xb)gw*XzC_AcSf_;^;vg#BA#;hxXBi2T0kneXE)#<2yYggp#yo9KWOaq
z+<hO~`YxoaRvGjBs|#*?caU!i1B(rXWmNYG#OH2k&CgdOvb3o$X&M}Nch;e!!md*<
zmw70@d(K=>%=9Se2F$;q&^M9zcPCoN1s14am9T9B+g%=IoU`I0%rown(5xO^>>-9A
zS7=&Foi!_@w(rw=DeX}D&KQuFob?rEMK@QPJX4+`>?4Fen15FB$qg5gibY6EIEOab
z_s|2TWTiV|EtQiZ_K&k$yWJP~_!|VX!Q)RP(<rMdEu5fLsgj%wgY(~ZA(Lq0p_g0@
zcM(MLxXM|jXo$?t-3Fr9kbG<~M`l)bhodz_lqP;2&UGKtS>3Nl3LW-Dlj-HGiQ!=R
zJfvYdxr%{$BcNHZg=yw2l0tUa7e=&`zIHgU*@0x^l=@)huz)GrB4r;K#VEPt%JLI>
z2(>}})(9#B->n3{cb9x>Jk58XN*!Sk9R-)OO|IEDPO(-4GV|EPr?z}{gx&@z?D%H9
zOSWR8RoQN%ITzDZ1g#LLVP+gzoqTeI7{<!_PCygyAQdFSKS)b#R*e|tV>($N(z$}r
zI%2f-{X_c$O!jl`Q?p^-+1E19g2QumMOC=5X4R;be5I6PV<$!IXKbgikB|c|32~=l
zzjP_uJO(IMDkhMUGln)@!$ld`VP@2mcgX<SC1k(oesVuY`e@iu<wClYkthW1W%%jR
zu$o8l6;x2toGjGHx2(Xd#a}biP8~0j6nN4+@4y6u6o&dNRF)W}L=ZzYom7Y~U{uIG
z$WWSI>{2}JS}|<I$1V!It{IcFK<Om(8*p};d0ibQN9SV^tsTZmVhU2!+PVyH5n=Et
z6%XNYu|mcw)bTPj?=S~&-+t+(Vu4LK8AQaGA35E(9C-(5MFCZQas#a2eDHUX?w51r
zEqL+7%&pl37sdh~xNp&z0n{d$C>O;{lBJl|RkZV)g?3=eZPn%E8kOSS7`C_Nw$hX2
znyF}LoWK}TbINg~dTS7vqVceI7sZ%S%5q6g26;iwTa0e?nZzkEnKg14>5;XPwZlv<
z0>OEvA=DfAia8RX;+YdIF;<XaCz=s5b3+03#Mbp!0U7Hd^TZa!>_sm@|3KKCB$_fP
z6nn9r<@gK!utptO3FvZ961^1I_x?phxPeo!Mis>z`<>BoQT&>G;?XZN9P-L?8+h{;
zD8uX&!c_N5^*u1k3X(R{@!<kAA`IDo0(QGJUmV$d^9*;4bz>8e^=eh|@^%PJWAY|q
z@0JC@dOaZ#-pg%x4QP6X?Lf8&vs6ztL3Mrc8+oJ6RSKy76MLRzoYL`1aZc}I%eVsk
z#G6g^2yq#_SYm>)@S5UP5n%XzST$<@vJMfcVGGkZcDJhBMGw^_JMe7Lc_gS9#so9L
zV*5HS0P26D1AHwCltq)5ok*)Z6!j3qVVlzw&w(gdQdIjwHh^7qav0!t7d8k&-<OCb
z=Q4Vn2fx@U@*EXSsrKG{EY(5&F(gl_bXf*;#D2yO;X8z<WvtTQPnddE-<Sm#B9z(z
zwA!wksON?@XtbC@vh<}2(R!3b?2^aj{Qq{b53++CVJ~sL))K9d?f|olTeU7z-XEGK
zIrKz1jLv(Q4|?oH79-SjdoHnzi6pHtEd3;uGI<l9v{6Bh@Fyg6TZ;0}oqWryj8&rh
zQ5&6cl_>~YLM+3+N%W!}=~bIrh2IjQKVlH_*L5G&OQ8r7&n93^QrS3?<{SehlCd$~
zB>@N<_vDRW<8GU^z*m?dBxIZQdch#WS?OQi(BH#FbW?is^jox<LyUr2>)?)<N6JHC
z3NwWcer`{4uDG7E1pvUfJyX2(W6A#0(JcD%N9S|_hTJlOFxGke`0xZ61p#6f3P;P^
z-9-hsI*iQ&M`u(lz)r^+w0ubrdwHKC6cb#HVRn~XS8yTD^#OuMib7&cj?9z8Zj(Fw
zLx6-*v(`QEz`s@=YmpjkApKaZ)2|b1G1P0<6SYR|VU{VWbW_P#O8C+RQpU<g#QXlU
z0wKnl`c-{k@=hdDi3Je#_C+3a1k5K<Jo+F4gA#*<@qk-(1JcGyMr3=wtJDe2q&gr1
zlUnyGc?^nMW@tF;MMiK?*VW>yV#Gw?lKBqZ6)wwf8+E|B;WYXX0+U+TszyT_p#`i2
z3YsPHH25e2;}Y)c3-Cpn*42Ap^)|@za%XjO&)G$rgU}gOi46D(7!$w(_i<c`!_#V3
zTqxy9X1S#{VI=mRLg@sWy-B5sR{?bP`{+To-9=56PxeR`%AvygQ3fH(UeHq#xcIS7
z5TxapzvHBF+O-mr<ugQyr1k>&0OUG?Cfs{Ydc|88cR}(o+Vv5V+cMWRdJEU&1Rf4=
zBV2XxJCBmAD#FC-VJh%~W1Sr0F3??<&mg0e*DS{$fRN((Gf@tntGxj{EJWK8&TQ1b
zR~IM{s#Rn35Iaa7zg|=@FZO#1!1U-Rl`D^C4Q~AP&+vtJhLQpGZiK{LIv<4h`|ks|
zHY5af=-F?!DFFTt=t~(w<8w4B<asU?M=uS6E{yIo(@$S}P~7Qst?0)R6e$qAq-^<a
z-IUG-M}jRxnf2*QrFXhp)Z~a<h`TT}#>>J&T-iD4LosHe;Wo9Z-aNt{@@N1@e}=Ik
z9-+{K0KK)r=~%bK15$O#;CH$TAd7UXhWBrF1e$W9ncEtXOSXKJWOJmV+eFtBns=nn
z#E)AQcePtVL)greUzAS%sl)?B&q3YQopsm_^1_EKy2qc{ZXf_se#qY&h5$>N#XATh
znOTaZk4zfU*=}aV2J2psk#{OE$<fLL{j&%dTJ{hyP*K^I8{d>hw8u@ZalqFqk5Mzb
z=j7Oe!m=NgY5uDE+5ZWp1xIe<y83W9#24~fD+#3pMlpAVAY>nu%ZayDqWp>^#L{qg
zQnOVc5g3ukP)c=do?D9hFOe<<KkjsG2CK3Pg+IU>+Wn$gS`_)ULiu*AO0o>XwV8k$
zqH!F}+AzZ|Q)uSp3$#Y9F$SXBq!=mUb=30m_wn9)S5Q6hLQ>0|Tr9|{VS+OZm{HZ)
z+v9h35Zt%P0b!6ZoHn?SsGVuU!&W!d6SObLQD8!dj%C~SqG)4weY8@ES`+PaY207M
zN&*(Xs2NMfxqQ4Zq`}Icb<d?qGSuq*pw$A~VM$2UR7D#JMkV!S+o7Wvak8m{k2nQ;
zRxZ(_dd6dP^+`5u<KHqD$No$6Y1%(3_M%l{@YvZ}OHkOs)w4Z(u5^-t0utPI`h%qU
z)B1SSz{oJhSd3vja9S80+f?VedS}qUD&?;mUJvx==$jw2Z`L_FaZ(!sN7f#~hWJUC
zGx9V#84OPx`q3b?a-UU*m@WYa^vq;JAECqCSI9+Ul%3O7_7O?CFr1Y$TNYkiRLIa^
z>N5D1q1&TRHYyxANLtAXVLUhRnfb`WM-~m-(@9}s{xAYJWSk+%qiB{_A0H;edz_|X
zP@D66oL5LrVkn(cLDp_bATWHMb5Pb)+)K#OVO%oUmHEP>b`~|<1<6ukU#wM{*xRHX
zLH}46xC44vMDT-v^wb2~c*Rr~2^9E11$Eb0tpovjPy`^;k9Ji;{|sjq5ZZMWkbyV3
zc*Rg!05Jex6jOtGt^uJG2)l=M33q@YxD++CF)Cmz_MFRi2=LWr9u`owCaR(G_YZq5
zT(w@Oy!<KicMHlUsw3La3~j^x57lSWL9m=C#krA$Df4$*ZdtfKNRX^DDq$UiK_R`M
zj0HKa7w`ekIGuMWWHg|X*`!`%C=E4PyLY~bJ)+XHS<Prc-&3<<s!0FXIGKz{9i(Oz
znkj?qh%`gfxaaQ{nl8^Krh?76m8Tm94Q9(EV3+n{#M@`MU+&Na*jj6ntuP~l#{o(;
za>UJ+kpT|9z45O1L2ql}oW4-p5_$yvc@`RZMPN$p0X?he3D^}Z%32&D)>FH<x2<Ya
z>=6s_0R6-og7Im%Eg7{$w;lv?TMc0I73T78AyE$9j3?5;A+XPRT}`=!=N%5A!7$-|
zYPDn%;5m;kq>(4|?O=eVZmj@!xJYY~B)vn4)2MeD${_2~srja@mN<C?6dHX3GWJjC
zL|`pNL%;b)<T9?52C{n%Y3W}<r4@%JN16hAr|<x{Wbm?sUa<4TL#yx{vQoIxJMb;C
zRxMqGgackoj&*@h{@C<7iW|XDeoz3_(kY>?!;^#wnA(_0{KM*QQEfoy)%R+3w^rLZ
zc{=RE@5%tQ>MXmdkp9>$!m^+xK+M>!API2;)?vb^%K=F&Xb-VDZ1CP7Rq~%W9FhR~
zw;91P&PHzwf-fWq0sBGD*qxLi;0=yYP}T8vKthB;XVRg<w)xhv_BR*;CH!E!FA|z@
z_gae)88Uw~`Sf^xBF>8OQ}RAr`6LF!Dty?nA4Xkgl%m&6VSTaLe^8$wlD-@3G{1F+
zAREmvV~~+J*j{3ws2ZU`!BoynAQT|P8JN}QQz8)p(x%mRvXM*+OOS1_xZAe|%&^pS
z4k4q^Eb@@J9xQq`8APdp<b(hCAe1Xw$KL^A6PDn}7;rA~H;7J~fY>+~{7j`4Xz^_9
zQ!IG(G{DP7po%|^O&2x;N|X1Dz`4>*Dq4Z8=xB*b2LQ-`(@qQY;1O3=S2oj8bjP&L
z0xZ83IAk~xkm95cF`7a(kVh`^Z@3@Cmu^-Z`A7J0<yz3C_(PywSRhO(E1sluv~V&(
zr&v@@9E!fK!CrU`*y{m&1#QGpfcVe-Y^qay0@QLYLf_{0W!FPEQZ*oEEL>xd*q9>B
zu2yCd53n-AIrGuiup(#U718n-gkTS3+EiFxw|-6&?qFdL6xeQ{#c!ROO92EZAahoO
zs6@m`@pQQ1BER$;)R`zqsTi<8C?%A2vas3xH~{NJL`|M+O4OQO`Fr>5aPd%YTY@kk
zcrArqU*7i(@_7_s*M5YP0EAryExBO2*2)|)Zera6DJI89!rmhg0CIYMgpztg!Hbsm
zN)W?r>vdp<hurW86^zJ*A3>Z&-XIN`@DRzqw@|d{tl4BxNhg%KRT+iKI2B9KaZk5r
z8m;{td=ge@Ng;MVj@3M&qx%cN!89WAGNwjZB&r>4tDv?KM=)qS=ffq30rtB;!)kBm
zoXBbA2IYBY4JK-mq;SdgFLs4Fb@l67F*q@2d#io%#ZT=ClI15Gw4XlyR(Hh{SmS>K
zX!)KX>KAsuWPBi7!^Dk6m<h%LJEe#$pS*SHQae3}FR+!ElyPeStX%TI9WLud5l|PV
zC<!6?>h_{iTm^ElF<9aQcHgu)K0O5b^igbBQVnHh1koU8ibHq@=@psd9ZygTlm7s{
z6mzisBynp8%u`^m!;T&}Xj11Vy!!G|Rq6Z9RgBSoi3L@w=)rBD;{Wrr0Wc8nG3}TN
zYPU52|5h+@ZvGav2UTpaK-yf?2`8E2iaiZ4sb-y+0f%zp`2+N{BnfF9dy+7G5(jT0
z`W3suf`_h21>(8f<(s_m+we6BDH-BLvl|2f#$xO_r~1Q00mdr^WQi3?H9K%Q+H6vq
z`9}Xnnkm<rTK6^C)nv5G22A4OmRVZ$OcFw(X!SJ%;+OiB0|mXtWtO*+n5GGI9g2Y}
zzc+%LK!zK9<zFU&D!!-tDt`@#ZsQp3C%i~uN|2Lb$wH89CZi@&-i|j5I*NY_;4Roz
z6bVE&A<0O+w+#Tq2mDi8DR^0P*0uM|=`5o@19Y5VvYXQ{QH0{){*5lF>m}~my@#gW
zpq}GHos00$K8;oTCb$>pKGKQfBx`-k`i<So`nr9~`m9-J2ADg2b%poR`E-p7Zi(vu
zeRi&uq~el*n8IRQ_H1(umyqQc3+(a}!4Wjn1aV5~z#zv|M~P^7fkXVKLZH&int72^
zrh8jp7Xw=ofxuHK6|iw^qS^=%DcC^~m=bLA@j%Ea6~c3&wM6XIlbU#0TK0I9f*Iu8
z`b5UdI3(P&^on{`3ufC3i)PycbW}fhz%*8$eb(l~IdU=MIaOJH@}EBBp5h?H!ntd5
zSrdaml|gZr!X5kPj)FaO-R3=UdpwE}qKV{80N0jxl!f%mWJKn|Jb)2hM2YmD^+bvA
z)AU|~9K;jmJ$cj+Wp;w#OE!YfT?-m6Wj%Q4I*I{Wh2--2`#BZ627=zIef8O9*i^6(
zNZ~{SFSQbRcCOsAoASx1d#QP`u+|EB%d&xiJxbfX5oEY<hSNE4#ytxd6@VRT+osYv
zgbrqNnQ7|z{(glRu*i#1v%?h(iQXMWB;%UMo)=B7d;w$+r!jU6U~<N7c6@q4eCy!r
zBxCw$9@{ho1$3<?4calVTpg9ty~4dAdNE3vkLlGU;X9h(b6lS!RAmHUc*bs;OILNs
zPA<I5A<bNLmv%u+iXXQZxijigFuH4Wtw#AWn%UbX@p<;lV#6{}h`hxt9`)Oa9egbl
z!RdAt9CWU!Jdyn0P;;`)kipuJQlpJh*~*;bmpRcK?cGY&b(xXf0whoB2p0>yY?*Hi
zdQy|tPgA1HSvh8iQ!x?QmR^W#JM!$@;k8wWruXwAAF@uDrH9d~eRPYD2036ZoaE$M
z-66Z#GJsn$qgi({VjRIkcZllY9O_uyfOt8`Xdbu_G;oqaGC(^}sHd!ZSY1)CQSVUB
z&|Z*wFhfy<StLqzlvDmwUr|j$S#HTh_EC*cztAKQW-xI8Rd{hwV^~=!P>s;cgBaih
zSM*SxQBts|m>#%XEK}}M&U8YBVs(^PCQ>0$Ezk{+4sdbzTe8ED0kBdiUX)g5Qx#E$
zAJ0HJ9d!q=e$Q<WagTowepC!zaMVC7U+y37H}+aSb5C$jeveT<&418$koU9LQcG-b
z&PKmmht|WB<+GA<vRFWN%aDAb9w-cKCk}R>M}aOWRn+S!>}(Sbbe}{g5Y2=BJ}d~A
z5y5~o_Rssi+P=`o8-pm49coq$ca1>4!G6ac&$hNy2_#KwQH?+z)#p_M(xe*@_pr(y
zUq@eC(;bjTAopl}kGa>cF_Jp5EFcW%4UBO<LNsIL((~w4-c2W51J>1({ID1*ZtpR1
ziXKKTRd=@e&UeK75+fVZIU3X;{3Ame1aV<x#+jsjSm^{iIb0p0pI#hSiRGw~o4H~{
z9Rqg8fm$7T6x5c<RD#428Qo;r^?1_5N+d%XA5}b2!x|n{bz~Qz$iZ9}u$4h*)3ef7
zwRIBT%68YaPLkioJEl5Nk+9<+c&A@U!baa!%UErl0^`o#8fx&N@PGE~c58UHL?nP<
zYk0CmB+3WneNc+d@cgd*Rvp5+`_Xn4LMuCDHX(Q7XbK9dT={I-5rod4RXPDYQNl+Q
zyjFCg4dj$FP@D!ZQPJjb2-Y*5-BumQq&Ka>YNqJLeW8Q|-f~zX+pdOtPlEfW3k4cr
z_3r+}_GNhjc(QTUf<|W_k8$KEU4xtCJ#up->z_&*aD`CaQ~|Q+i&PaN+&bGwD0xO#
z(;0S3@Lo_kOw$Azwz!>fb7Z3&T=u)rhnBO}9lw`-cEp=TSWYx(aglA5ZL5$%-tU~M
zK9)f?VISxPsh{rPEo%@_xY^N&+1Mr*6N64p-C(4gh<2ki1cqTc%e_nm)-->@Skt5z
zSY7|ti95l-M=hoN+NGJwHe5WQYsWZA8#Xz~))}o`BdZhsDI~n!^VaF1KAB=^nL?=f
zIbw4B!HaYow!zym=~nBc#DVD-P|*VHoAxT1H0^;rdTxRYj+^;Lr8_Ab+QlQen6)1U
z7j{~V-b~_@qGXKSI+cBhg2Y=ckWoNYCASNoJaLIdvB}s{#~x!1Te6T(_YG{?k8>94
zJ3^m{PB<l>p9bnXJn3{5{NNmjI-`iCm@?y0bV*ATGWL^7FndW%KQBqa*cS4lf8I)e
za>4AlG~)yqZqX}69;(P;8Mu!!c+KJ(03}BoURv2h9P3(E<@#(Ud<iqgud7rXXKPlb
zb7j2M_}I6qc)=-xU}lrA6cn0L$-OC;uwa^%O34HdUgJhzC&ooe+q57M0jOmZ71MMg
zSis<hd{Nlg<ffl&eYEj8L(LRc>bEbvpAko!<oF(PRlTNcB9%-ECFh*uK*}Pfgx3TL
z4t^CCt3qqHqqrV=DDH<WFFA{#g>4<>u4S}#$ao6s3otr-TutbU9<RnFS&ns;`XlJl
zc0yW~(hi%(9Q6;c4iY56Wi)L7TnEc`hRQ%&Bqt_`bBq!uph-omBKThJYMdSUR+Z|V
zDLlz-)7_?cHJ23j6du}ha~5B;CacSMsqEcPH_^#tIGOOi9D^$2Z2nJk7KHeG)dg!u
z+wSr$3Cq)Sd!SahTqF}CIxoUCdWd-^iTapn<E3#HM{j1`h`4wHa|wpQLkvT0qMb*y
zQf1W_!NbMHc#*?CudWQsFUpy+^2Qa*;3K?;(h7xqPmctBkKzw<15#}?x_{ObTVce}
z>CDD@`F0ucUe&95+bXOuy*kxPV<4${$w-)+cHBJ^wBVDed^^gUG~;#s^16jY4fA}(
z_zIb{{Q-j7zLsKyaI@)QykIc$4a_s<8=FoNt>6PteI&TB<9uK+*sQ!*Lwzu<oSN-7
z<G>h_*iW0ntiobKr%gx^3}zcWB>&DdV~v21-jjL_)=!AdG^RZ)e@;oIpq%g>S=$Q@
zo-Py?Nsba!-sp~?7;%&^h|cRrDPiDAU0GehMpzf4&*Xn7LU8;?+xYz~d-ouY5>z9i
zr^C~Z9!06BNwlak)~zhSh^SJH`}sbZ0NxikBgu-4zFK<sV3F*s0%01oWwpZ*d%e3<
zSF%fSncZ{G;nkduHjaSEWKWp-`0`+1v;{;6(D8>n!Vq#Y`eX7kG{sY?MKaqcA1`&`
zRO8jFiZ>z4TY>hOJ<SHD<KHjW=E5cx!um#GH#3ZhoA74KJzGZnnUgdaITJ@9i9vAO
zB6Ju`7;3%K0FgBT+cKDq-G+h2#XJJte3vw(vU**)Y<)#n0vl=C)42(_LBNV>(T(IO
zFo1a?=-!b`L1ysiWQ#!^q%J`0iF;4Y!sQr*VZCR_rr(o-M|Zm{>2C#<sgvQJzC)n(
z6Vl#Mcw*(RSlqv;;sMT4x*S!L&<wvu8G@*ZcNHN2nZGb)an&^X%VNb7(%#tLEjdJJ
zdIdN9^Z>B-437#GUJ$W(AN_LH)f)T7#M(;J!gU3#niXAIF<2<?PSq0<>1~_t<XTG6
z_*E+{H^g9k?n#ym*KJ64vJ?Ct=^FGh_!I|iNPTDngr`04qf`KP#F=o|G}l~T%lwe;
z@>`Nl_vC$~JVIp1NE7I|pua#yifvgX9SOrgJ?j0^PeR;3x2_ypbSO{;PU#HMfrQJn
zP<#)Yt~^Kmdb`^#-gyZfNJ8XstkF0q1maj+j#3&ADDj4=CK$$U@~PBML`aa$Nf}Jm
z7ZA;MD*$&H&KyyKHd(Y%8D}5(>u_G(5L8it`1sIILw2c4P3>J(S4_-)!-A^W0uoiF
zK@8k$x^!EZfg>EFw%>Cgs@VmZ)q^8xN_h@mv@sJSY6bqvTmbbnfnKWRFUc^kQ5{~1
z%a((4)2&-fK^xIerr7MZEhzGttUwa@B6bLFGJlwsxL)ib<}plK*q07Yd=Vn~c&zHZ
zrS<8Eb?gMDnK)*6>BX384UDEr;-z^06_)6u=USpX7fs(d_=>};7-^ya8`ebswsmFs
zB*a3|H2<@9V}grc{c)?&9FH)*gnCwty#+o=Ejx9i33|_)buxi*lN>!U2YmJ7Mwxqe
zd|1NPCsLfNXFOR4$H^j}1{30?#~fGSGKu;mBY}8(gO9Oz=_J2c^iS!IOy&U1u*qrb
z{7S@CcW8}p8#ioGD<f%yFIgFICUEH>R?DI<CsQfzdFDn9DcKd7HtvIAjVYNzCu5=l
z(y}-5y@@rdUfmP%ftCCI5ANW;?&Y}i{wd2|=;gel{?X8P3{zx{DEplU2z@G6yQbni
ze*wbUJ#55vPp?@M{x8%5!pW{o8h+`nS;LUaR`pUhsEKmJZ<@Iis;?^<HJ#)K^IxWm
z@u#aj<u|K6-MPynP@T44HFdq{hF!OHUg@vi#8m&J3IJNK5#M4FOE61j&M-ue0;D*M
zqir3P{~z6eU{*d+)PpG7;bSo2Y~8CF939d~MQ7hmLCd*CaEy^OTF|5Sp*~g~kINYO
zU_z3*02ug?wbhF`)70Mrs|!K<@+*xI5x)ndJXDR8d4@(j-V4-0+)V#mezbKe-?2i4
z_X{f$wJ73<LF%Rn7$vu3e7lu2$(F-4b(YgM4VGv$WtPh`9hYpE!`^+uH%(O2S}60l
zq@A1GM4U_CiAh{$%8WMpEeA{-uq+&)){UF{6tp=V60#lg9vMl|vJxUcX~{z<{NBqL
zVIn<NnK9w(b4(Z%sMGb!+c($PX`etY12Fa+9jgV^;J7D2LWwOsD<s&NTVlEq3}~iD
zuQ1*`h>1yR0ePo)tuTy5-%*VE`=~K3=1wJ?!W5q3S;Lr^%GVqKNJJD+bWKHT6*KL5
z;&+b8V4RkA$tBf@Bj!mLG&<BXjP(QZJI4o(TTRVTi!+-Q;&0_l{W1N!B27F95+H{*
zV&f71;}SI;OfIU`lo0}PSV3qKO4n6cf^<Phtx*aq`*fc84G&R-4)K({TnPQsH1uUE
zt4wS(6EY)~nAOi2_CiR;Fb&Ckn>L$Zh|@AX)uta~v$d@Dls$fWdnI*1^7@s4$@Veh
zKul2;KpX;LI+c4$d<<bKnd@Y{%VX-C3v|3IW2l&#0a_$C?KAA019BWE;$oQlXCbv}
z04H)Qaon!r9+^8}Sf0w3$?*PlTL{2Y7*vU;qElB^jfTkR3IN6!<-Vch)$0bk-yKCj
zb(#ao{L~f$v^8xB0^A(oew4&2PTIv{>coppBE%cfFlLh5mx*VmsF%u$8_#om3x5mY
N{rpf+P*6}%P*5Cfs#O30

diff --git a/fonts/Lato/lato-bolditalic.ttf b/fonts/Lato/lato-bolditalic.ttf
deleted file mode 100755
index f402040b3e5360b90f3a12ca2afab2cd7244e16f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 622572
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%0ABnyWgH#@^BX2UBxb|>pq|!5
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

diff --git a/fonts/Lato/lato-italic.eot b/fonts/Lato/lato-italic.eot
deleted file mode 100755
index 3f826421a1d97b09797fad3d781a666a39eb45c9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 268604
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
IP*6}%P;pKc_y7O^

diff --git a/fonts/Lato/lato-italic.ttf b/fonts/Lato/lato-italic.ttf
deleted file mode 100755
index b4bfc9b24aa993977662352c881c6e42f99f77e0..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 639388
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
DY$A+R

diff --git a/fonts/Lato/lato-regular.eot b/fonts/Lato/lato-regular.eot
deleted file mode 100755
index 11e3f2a5f0f9b8c7ef6affae8c543d20f7c112be..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 253461
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
B^&kKM

diff --git a/fonts/Lato/lato-regular.ttf b/fonts/Lato/lato-regular.ttf
deleted file mode 100755
index 74decd9ebb8d805201934266b3bda6a9d5831024..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 607720
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
z<P1s9kmL+W&XC{Hgyd&Peum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2J
zhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRo
zXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~R
zeum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA
z<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{
zNPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2J
zhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRo
zXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~Reum^{NPdRoXGngA<Y!2JhU8~R
zeum^{NPdRoXGngA<Y!2JhU8~ReukuCNGgV;Vn`~6q+&=ahNNOhDu$$DNGgV;Vn`~6
zq+&=ahNNOhDu$$DNGgV;VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JY
zL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!W
zMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4
zVnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gy
zDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixN
zq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JY
zL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!W
zMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4
zVnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gy
zDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixN
zq+&!WMx<gyDn_JYL@Gw4VnixNq+&!WMx<gyDn_JYL@Gw4VnixFr&RoO%X3P_d!^bZ
zR;qnsrP?P}s(oUm+9y`3ePX5BCswL`Vx`(AR;qnsrP?P}s(oUm+9y`3onWQfCswL`
zVq2b5n(4f9%#=r!S`X`3yCF%nPpnkCeM+@YtW>*YO0`d{RQtrXJg1COtujiFDwlMu
zT+;O`m!wK0UAYp;RJ&zLwNI>6`@~AMPpnk?#7ci_bgESQ#7ebKtW^8NO0`d{RQtqA
zwNI>6`@~AMPpnk?#7ebKtn|O3-$1obtj=hkSgH1jm1>_@srHGLYM)rC_KB5hpIE7O
zC6#KQSgCf)lxm+?srHGLYPU?O_KB5hw@j(_iIr-fSgH1jm1>_@srHGLYM)rC_KB4;
zKFS<B);_UP?Gr22KCx2m6Dy?)${ah^KCx0;ZTOth##H;nO0`d{RQtqAwOgiC`@~AM
zPpnk?#7ebWrd0dHO0`?2RQtqAwNI>6`@~AMPpnk?#7ebKtW^8NO0`d{RQtqAwNI>6
z`@~AMPpnk?#7ebKtW^8NO0`d{RQtqAwNI>6`@~AMXQov9#7g<($lZ3VePX5BCswL`
zVq2b*Q&c6V=)K4(cC3A3rP?R9<vDrbzLo@DNZ^G8UP$1D1YStsg#=zm;DrQUNZ^G8
zUP$1D1YStsg#=zm;DrQUNZ^G8UP$1D1YStsg#=zm;DrQUNZ^G8UP$1D1YStsg#=zm
z;DrQUNZ^G8UP$1D1YStsg#=zm;DrQUNZ^G8UP$1D1YStsg#=zm;DrQUNZ^G8UP$1D
z1YSt!XYsu)3H>ZKH7_LaLIN)&@InGFB=AB4FC_3n0xu-+LIN)&@InGFB=AB4FC_3n
z0xu-+LIN)&@InGFB=AB4FC_3n0xu-+LIN)&@InGFB=AB4FC_3n0xu-+LIN)&@InGF
zB=AB4FC_3n0xu-+LIN)&@InGFB=AB4FC_3n0xu-+LIN)&@InGFB=AB4FC_3n0xu-+
zLIN)&@InGFB=AB4FC_3n0xu-+LIN)&@InGFB=AB4FC_3n0xu-+LIN)&@j?<WB=JHL
zFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|
z@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o
z5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<W
zB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2
zLJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHL
zFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|@j?<WB=JHLFC_6o5-%k2LJ}_|
z@j?<Wr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo87
z3NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneN
zr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJa
zLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xt
zFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW
z@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo873NNJaLJBXW@IneNr0_xtFQo87
z3NNJaLJBXW@IneNr0_xtFFdc6u0P%Kyw<orB|WdTdC$lGQa|gTkJ)VVd97tNy{1{&
z^JBkc$78=@&(Zo-)30&n>*ybvYW=F|i0+d=ul1`s*2-1WUqtP{DW2ELRa5(Kis!X*
z)ztnA;(4uHHQj<fW9mF;*XBHgKCCsL&uiuCFGwHZ%rtbm)}B4@Jj(eQoOuj=9DPEo
zl%IE=)VjOpwPw{`?dQ=?^J<@=>a(2r9QqWmHk0%AH#pBb_BS}sJD*2?fmfSjW2GHy
zP4&H~(#5F07gfj4+sHU+^b0m_&KJ=a&==8{(3jCy&|gJ=4gGcWH_+cie+&I>^h@ZM
z(ceLT7yUi-E9h6zuc5z>e%<u0o$5=Pj;HB(nvSRGc$$u<>3Eusr|Ec_j;HB(nvSQ(
zTF294t>bAro~GkzI-aKEX*!;cTgTIMJWa>bbUaPR({wyd$J24^c$$u<>3G_)j;HB(
znvSO(>v-C+j;HB(+OdwO9qV}7v5u!5>v)=ur|Ec_j;9^#c-pa!ryc8f+OdwO9qV}7
zv5u#;O4-g>$J2B??O4atj&(du$J2B?O~=!Ybv#YS({w!TSjW?JJgv3Cc5EF_JJ#{E
zV;xUB*73As9Zx&f@w8(dPdnD}v|}AlJJ#{EV;xUB*73As9Zx&f@w8(dPdnD}v|}Al
zJJ#{EV;xUB*73As9q*^t{q(w@UiZ`MetO+culwnBKfUg!*ZuUmpI-OV>wbFOPp|vw
zaz9<}r_23xxt}ig)8&4;+)tPL>2g0^?x)NBbh)1{_tWKmy4+8f`{{B&UGAsL{dBpX
zF89;re!ARGm;32*KV9yp%l&k@pDy>)<$k){PnY}Yaz9<}r_23xxt}ig)8&4;+)tPL
z>2g0^?x)NBbh)1{_tWKmy4+8f`{{B&UGAsL{dBpXF89;re!ARGm;32*KV9yp%l&k@
zpDy>)<$k){PnY}Yaz9<}r^^}UGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?
z<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@Q
zGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH
z8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?
z<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@Q
zGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH
z8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?
z<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SH8Rjz?<}(@QGa2SHS-g<N3t7C7
z#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8U
zS-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-y
zki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N
z3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pG
zypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7
z#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8US-g<N3t7C7#S2-yki`pGypY8U
zS-g<N3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQ
zki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=
z3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(
zypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y
z!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2S
zIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQki!c(ypY2SIlPd=3pu=y!wWgQ
zki!c(ypY2SIlPd=3pu=y!wY%5kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv
z3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#o
zypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd
z#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEW
zdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9
zkjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD#oypYEWdAyLv
z3wgYd#|wG9kjD#oypYEWdAyLv3wgYd#|wG9kjD!JyimXk1-wwe3kAGTzzYSuP{0cX
zyimXk1-wwe3kAGTzzYSuP{0cXyimXk1-wwe3kAGTzzYSuP{0cXyimXk1-wwe3kAGT
zzzYSuP{0cXyimXk1-wwe3kAGTzzYSuP{0cXyimXk1-wwe3kAGTzzYSuP{0cXyimXk
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
Z*f;DS4h)Bc!^4r`m3SX@eDofw`CpG;dWHZ1

diff --git a/fonts/RobotoSlab/roboto-slab-v7-bold.eot b/fonts/RobotoSlab/roboto-slab-v7-bold.eot
deleted file mode 100755
index 79dc8efed3447d6588baa2bb74122d56f3500038..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 79520
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%0D%`eC1@mXMW;ge~^6hxs}F-Bmr
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
H*%}!Tj)Yss

diff --git a/fonts/RobotoSlab/roboto-slab-v7-bold.ttf b/fonts/RobotoSlab/roboto-slab-v7-bold.ttf
deleted file mode 100755
index df5d1df2730433013f41bf2698cbe249b075aa02..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 170616
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

diff --git a/fonts/RobotoSlab/roboto-slab-v7-regular.eot b/fonts/RobotoSlab/roboto-slab-v7-regular.eot
deleted file mode 100755
index 2f7ca78a1eb34f0f98feb07ab1231d077b248940..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 78331
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
b&xQ}h!>H5&=O>tNF^qKYgI$h4G<lf7(vDA$

diff --git a/fonts/RobotoSlab/roboto-slab-v7-regular.ttf b/fonts/RobotoSlab/roboto-slab-v7-regular.ttf
deleted file mode 100755
index eb52a7907362cc3392eb74892883f5d9e260b638..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 169064
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

diff --git a/fonts/RobotoSlab/roboto-slab.eot b/fonts/RobotoSlab/roboto-slab.eot
deleted file mode 100755
index 2f7ca78a1eb34f0f98feb07ab1231d077b248940..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 78331
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
b&xQ}h!>H5&=O>tNF^qKYgI$h4G<lf7(vDA$

diff --git a/glossary/index.html b/glossary/index.html
index 13011b1..7192895 100755
--- a/glossary/index.html
+++ b/glossary/index.html
@@ -1,208 +1,189 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="../img/favicon.ico">
-  <title>术语表 - Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="../css/theme.css" />
-  <link rel="stylesheet" href="../css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u672f\u8bed\u8868";
-    var mkdocs_page_input_path = "glossary.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="../js/jquery-2.1.1.min.js" defer></script>
-  <script src="../js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="../img/favicon.ico" />
+    <title>术语表 - Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="../css/theme.css" />
+    <link rel="stylesheet" href="../css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u672f\u8bed\u8868";
+        var mkdocs_page_input_path = "glossary.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href=".." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href=".." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="../search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul class="current">
-                    <li class="toctree-l1 current"><a class="reference internal current" href="./">术语表</a>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="../a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul class="current">
+                <li class="toctree-l1 current"><a class="reference internal current" href="#">术语表</a>
     <ul class="current">
     </ul>
-                    </li>
-                </ul>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="..">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="..">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="..">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>术语表</li>
+    <li><a href=".." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">术语表</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/glossary.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/glossary.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="_1">术语表</h1>
 <blockquote>
@@ -279,29 +260,21 @@
 <p><strong>面剔除（Face Culling）：</strong> 剔除无用或看不到的面，以提升性能的OpenGL功能。</p>
               
             </div>
-          </div>
-          <footer>
-  
-    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
-      
-      
-        <a href="../a01-opengl-debugging/" class="btn btn-neutral" title="附录 A - OpenGL调试"><span class="icon icon-circle-arrow-left"></span> Previous</a>
-      
+          </div><footer>
+    <div class="rst-footer-buttons" role="navigation" aria-label="Footer Navigation">
+        <a href="../a01-opengl-debugging/" class="btn btn-neutral float-left" title="附录 A - OpenGL调试"><span class="icon icon-circle-arrow-left"></span> Previous</a>
     </div>
-  
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -309,11 +282,11 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
@@ -322,15 +295,16 @@
     
   </span>
 </div>
-    <script>var base_url = '..';</script>
-    <script src="../js/theme_extra.js" defer></script>
-    <script src="../js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="../search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="../js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = "..";</script>
+    <script src="../js/theme_extra.js"></script>
+    <script src="../js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="../search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/index.html b/index.html
index 1cd12a1..e9dd7bb 100755
--- a/index.html
+++ b/index.html
@@ -1,206 +1,187 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <meta name="description" content="None">
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="img/favicon.ico">
-  <title>Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="css/theme.css" />
-  <link rel="stylesheet" href="css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script>
-    // Current page data
-    var mkdocs_page_name = "\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1";
-    var mkdocs_page_input_path = "index.md";
-    var mkdocs_page_url = null;
-  </script>
-  
-  <script src="js/jquery-2.1.1.min.js" defer></script>
-  <script src="js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="description" content="None" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="img/favicon.ico" />
+    <title>Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="css/theme.css" />
+    <link rel="stylesheet" href="css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+      <script>
+        // Current page data
+        var mkdocs_page_name = "\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1";
+        var mkdocs_page_input_path = "index.md";
+        var mkdocs_page_url = null;
+      </script>
+    
+    <!--[if lt IE 9]>
+      <script src="js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href="." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href="." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="./search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="glossary/">术语表</a>
-                    </li>
-                </ul>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href=".">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href=".">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href=".">Docs</a> &raquo;</li>
-    
-      
-    
-    <li>《用LWJGL 3开发3D游戏(3D Game Development with LWJGL 3)》中文翻译</li>
+    <li><a href="." class="icon icon-home" aria-label="Docs"></a></li>
+      <li class="breadcrumb-item active">《用LWJGL 3开发3D游戏(3D Game Development with LWJGL 3)》中文翻译</li>
     <li class="wy-breadcrumbs-aside">
-      
-        <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/index.md"
-          class="icon icon-github"> Edit on GitHub</a>
-      
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/edit/master/docs/index.md" class="icon icon-github"> Edit on GitHub</a>
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
                 <h1 id="lwjgl-33d3d-game-development-with-lwjgl-3">《用LWJGL 3开发3D游戏(3D Game Development with LWJGL 3)》中文翻译</h1>
 <h2 id="_1">本书原介绍</h2>
@@ -226,22 +207,18 @@
 <p>如果你喜欢本译本，请Star并分享它。如果你想捐助译者，请通过下面的链接捐助：<a href="https://afdian.net/@mouse">爱发电</a>。</p>
               
             </div>
-          </div>
-          <footer>
-  
+          </div><footer>
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -249,32 +226,33 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
     
   </span>
 </div>
-    <script>var base_url = '.';</script>
-    <script src="js/theme_extra.js" defer></script>
-    <script src="js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = ".";</script>
+    <script src="js/theme_extra.js"></script>
+    <script src="js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
 </html>
 
 <!--
-MkDocs version : 1.2.2
-Build Date UTC : 2021-09-27 05:57:46.929473+00:00
+MkDocs version : 1.6.0
+Build Date UTC : 2024-07-17 13:58:59.435995+00:00
 -->
diff --git a/js/html5shiv.min.js b/js/html5shiv.min.js
new file mode 100755
index 0000000..1a01c94
--- /dev/null
+++ b/js/html5shiv.min.js
@@ -0,0 +1,4 @@
+/**
+* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
+*/
+!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x<style>"+b+"</style>",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="<xyz></xyz>",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document);
diff --git a/js/jquery-2.1.1.min.js b/js/jquery-2.1.1.min.js
deleted file mode 100755
index e5ace11..0000000
--- a/js/jquery-2.1.1.min.js
+++ /dev/null
@@ -1,4 +0,0 @@
-/*! jQuery v2.1.1 | (c) 2005, 2014 jQuery Foundation, Inc. | jquery.org/license */
-!function(a,b){"object"==typeof module&&"object"==typeof module.exports?module.exports=a.document?b(a,!0):function(a){if(!a.document)throw new Error("jQuery requires a window with a document");return b(a)}:b(a)}("undefined"!=typeof window?window:this,function(a,b){var c=[],d=c.slice,e=c.concat,f=c.push,g=c.indexOf,h={},i=h.toString,j=h.hasOwnProperty,k={},l=a.document,m="2.1.1",n=function(a,b){return new n.fn.init(a,b)},o=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,p=/^-ms-/,q=/-([\da-z])/gi,r=function(a,b){return b.toUpperCase()};n.fn=n.prototype={jquery:m,constructor:n,selector:"",length:0,toArray:function(){return d.call(this)},get:function(a){return null!=a?0>a?this[a+this.length]:this[a]:d.call(this)},pushStack:function(a){var b=n.merge(this.constructor(),a);return b.prevObject=this,b.context=this.context,b},each:function(a,b){return n.each(this,a,b)},map:function(a){return this.pushStack(n.map(this,function(b,c){return a.call(b,c,b)}))},slice:function(){return this.pushStack(d.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(a){var b=this.length,c=+a+(0>a?b:0);return this.pushStack(c>=0&&b>c?[this[c]]:[])},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:c.sort,splice:c.splice},n.extend=n.fn.extend=function(){var a,b,c,d,e,f,g=arguments[0]||{},h=1,i=arguments.length,j=!1;for("boolean"==typeof g&&(j=g,g=arguments[h]||{},h++),"object"==typeof g||n.isFunction(g)||(g={}),h===i&&(g=this,h--);i>h;h++)if(null!=(a=arguments[h]))for(b in a)c=g[b],d=a[b],g!==d&&(j&&d&&(n.isPlainObject(d)||(e=n.isArray(d)))?(e?(e=!1,f=c&&n.isArray(c)?c:[]):f=c&&n.isPlainObject(c)?c:{},g[b]=n.extend(j,f,d)):void 0!==d&&(g[b]=d));return g},n.extend({expando:"jQuery"+(m+Math.random()).replace(/\D/g,""),isReady:!0,error:function(a){throw new Error(a)},noop:function(){},isFunction:function(a){return"function"===n.type(a)},isArray:Array.isArray,isWindow:function(a){return null!=a&&a===a.window},isNumeric:function(a){return!n.isArray(a)&&a-parseFloat(a)>=0},isPlainObject:function(a){return"object"!==n.type(a)||a.nodeType||n.isWindow(a)?!1:a.constructor&&!j.call(a.constructor.prototype,"isPrototypeOf")?!1:!0},isEmptyObject:function(a){var b;for(b in a)return!1;return!0},type:function(a){return null==a?a+"":"object"==typeof a||"function"==typeof a?h[i.call(a)]||"object":typeof a},globalEval:function(a){var b,c=eval;a=n.trim(a),a&&(1===a.indexOf("use strict")?(b=l.createElement("script"),b.text=a,l.head.appendChild(b).parentNode.removeChild(b)):c(a))},camelCase:function(a){return a.replace(p,"ms-").replace(q,r)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toLowerCase()===b.toLowerCase()},each:function(a,b,c){var d,e=0,f=a.length,g=s(a);if(c){if(g){for(;f>e;e++)if(d=b.apply(a[e],c),d===!1)break}else for(e in a)if(d=b.apply(a[e],c),d===!1)break}else if(g){for(;f>e;e++)if(d=b.call(a[e],e,a[e]),d===!1)break}else for(e in a)if(d=b.call(a[e],e,a[e]),d===!1)break;return a},trim:function(a){return null==a?"":(a+"").replace(o,"")},makeArray:function(a,b){var c=b||[];return null!=a&&(s(Object(a))?n.merge(c,"string"==typeof a?[a]:a):f.call(c,a)),c},inArray:function(a,b,c){return null==b?-1:g.call(b,a,c)},merge:function(a,b){for(var c=+b.length,d=0,e=a.length;c>d;d++)a[e++]=b[d];return a.length=e,a},grep:function(a,b,c){for(var d,e=[],f=0,g=a.length,h=!c;g>f;f++)d=!b(a[f],f),d!==h&&e.push(a[f]);return e},map:function(a,b,c){var d,f=0,g=a.length,h=s(a),i=[];if(h)for(;g>f;f++)d=b(a[f],f,c),null!=d&&i.push(d);else for(f in a)d=b(a[f],f,c),null!=d&&i.push(d);return e.apply([],i)},guid:1,proxy:function(a,b){var c,e,f;return"string"==typeof b&&(c=a[b],b=a,a=c),n.isFunction(a)?(e=d.call(arguments,2),f=function(){return a.apply(b||this,e.concat(d.call(arguments)))},f.guid=a.guid=a.guid||n.guid++,f):void 0},now:Date.now,support:k}),n.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(a,b){h["[object "+b+"]"]=b.toLowerCase()});function s(a){var b=a.length,c=n.type(a);return"function"===c||n.isWindow(a)?!1:1===a.nodeType&&b?!0:"array"===c||0===b||"number"==typeof b&&b>0&&b-1 in a}var t=function(a){var b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u="sizzle"+-new Date,v=a.document,w=0,x=0,y=gb(),z=gb(),A=gb(),B=function(a,b){return a===b&&(l=!0),0},C="undefined",D=1<<31,E={}.hasOwnProperty,F=[],G=F.pop,H=F.push,I=F.push,J=F.slice,K=F.indexOf||function(a){for(var b=0,c=this.length;c>b;b++)if(this[b]===a)return b;return-1},L="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",N="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",O=N.replace("w","w#"),P="\\["+M+"*("+N+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+O+"))|)"+M+"*\\]",Q=":("+N+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+P+")*)|.*)\\)|)",R=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),S=new RegExp("^"+M+"*,"+M+"*"),T=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=new RegExp("="+M+"*([^\\]'\"]*?)"+M+"*\\]","g"),V=new RegExp(Q),W=new RegExp("^"+O+"$"),X={ID:new RegExp("^#("+N+")"),CLASS:new RegExp("^\\.("+N+")"),TAG:new RegExp("^("+N.replace("w","w*")+")"),ATTR:new RegExp("^"+P),PSEUDO:new RegExp("^"+Q),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+L+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/^(?:input|select|textarea|button)$/i,Z=/^h\d$/i,$=/^[^{]+\{\s*\[native \w/,_=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ab=/[+~]/,bb=/'|\\/g,cb=new RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),db=function(a,b,c){var d="0x"+b-65536;return d!==d||c?b:0>d?String.fromCharCode(d+65536):String.fromCharCode(d>>10|55296,1023&d|56320)};try{I.apply(F=J.call(v.childNodes),v.childNodes),F[v.childNodes.length].nodeType}catch(eb){I={apply:F.length?function(a,b){H.apply(a,J.call(b))}:function(a,b){var c=a.length,d=0;while(a[c++]=b[d++]);a.length=c-1}}}function fb(a,b,d,e){var f,h,j,k,l,o,r,s,w,x;if((b?b.ownerDocument||b:v)!==n&&m(b),b=b||n,d=d||[],!a||"string"!=typeof a)return d;if(1!==(k=b.nodeType)&&9!==k)return[];if(p&&!e){if(f=_.exec(a))if(j=f[1]){if(9===k){if(h=b.getElementById(j),!h||!h.parentNode)return d;if(h.id===j)return d.push(h),d}else if(b.ownerDocument&&(h=b.ownerDocument.getElementById(j))&&t(b,h)&&h.id===j)return d.push(h),d}else{if(f[2])return I.apply(d,b.getElementsByTagName(a)),d;if((j=f[3])&&c.getElementsByClassName&&b.getElementsByClassName)return I.apply(d,b.getElementsByClassName(j)),d}if(c.qsa&&(!q||!q.test(a))){if(s=r=u,w=b,x=9===k&&a,1===k&&"object"!==b.nodeName.toLowerCase()){o=g(a),(r=b.getAttribute("id"))?s=r.replace(bb,"\\$&"):b.setAttribute("id",s),s="[id='"+s+"'] ",l=o.length;while(l--)o[l]=s+qb(o[l]);w=ab.test(a)&&ob(b.parentNode)||b,x=o.join(",")}if(x)try{return I.apply(d,w.querySelectorAll(x)),d}catch(y){}finally{r||b.removeAttribute("id")}}}return i(a.replace(R,"$1"),b,d,e)}function gb(){var a=[];function b(c,e){return a.push(c+" ")>d.cacheLength&&delete b[a.shift()],b[c+" "]=e}return b}function hb(a){return a[u]=!0,a}function ib(a){var b=n.createElement("div");try{return!!a(b)}catch(c){return!1}finally{b.parentNode&&b.parentNode.removeChild(b),b=null}}function jb(a,b){var c=a.split("|"),e=a.length;while(e--)d.attrHandle[c[e]]=b}function kb(a,b){var c=b&&a,d=c&&1===a.nodeType&&1===b.nodeType&&(~b.sourceIndex||D)-(~a.sourceIndex||D);if(d)return d;if(c)while(c=c.nextSibling)if(c===b)return-1;return a?1:-1}function lb(a){return function(b){var c=b.nodeName.toLowerCase();return"input"===c&&b.type===a}}function mb(a){return function(b){var c=b.nodeName.toLowerCase();return("input"===c||"button"===c)&&b.type===a}}function nb(a){return hb(function(b){return b=+b,hb(function(c,d){var e,f=a([],c.length,b),g=f.length;while(g--)c[e=f[g]]&&(c[e]=!(d[e]=c[e]))})})}function ob(a){return a&&typeof a.getElementsByTagName!==C&&a}c=fb.support={},f=fb.isXML=function(a){var b=a&&(a.ownerDocument||a).documentElement;return b?"HTML"!==b.nodeName:!1},m=fb.setDocument=function(a){var b,e=a?a.ownerDocument||a:v,g=e.defaultView;return e!==n&&9===e.nodeType&&e.documentElement?(n=e,o=e.documentElement,p=!f(e),g&&g!==g.top&&(g.addEventListener?g.addEventListener("unload",function(){m()},!1):g.attachEvent&&g.attachEvent("onunload",function(){m()})),c.attributes=ib(function(a){return a.className="i",!a.getAttribute("className")}),c.getElementsByTagName=ib(function(a){return a.appendChild(e.createComment("")),!a.getElementsByTagName("*").length}),c.getElementsByClassName=$.test(e.getElementsByClassName)&&ib(function(a){return a.innerHTML="<div class='a'></div><div class='a i'></div>",a.firstChild.className="i",2===a.getElementsByClassName("i").length}),c.getById=ib(function(a){return o.appendChild(a).id=u,!e.getElementsByName||!e.getElementsByName(u).length}),c.getById?(d.find.ID=function(a,b){if(typeof b.getElementById!==C&&p){var c=b.getElementById(a);return c&&c.parentNode?[c]:[]}},d.filter.ID=function(a){var b=a.replace(cb,db);return function(a){return a.getAttribute("id")===b}}):(delete d.find.ID,d.filter.ID=function(a){var b=a.replace(cb,db);return function(a){var c=typeof a.getAttributeNode!==C&&a.getAttributeNode("id");return c&&c.value===b}}),d.find.TAG=c.getElementsByTagName?function(a,b){return typeof b.getElementsByTagName!==C?b.getElementsByTagName(a):void 0}:function(a,b){var c,d=[],e=0,f=b.getElementsByTagName(a);if("*"===a){while(c=f[e++])1===c.nodeType&&d.push(c);return d}return f},d.find.CLASS=c.getElementsByClassName&&function(a,b){return typeof b.getElementsByClassName!==C&&p?b.getElementsByClassName(a):void 0},r=[],q=[],(c.qsa=$.test(e.querySelectorAll))&&(ib(function(a){a.innerHTML="<select msallowclip=''><option selected=''></option></select>",a.querySelectorAll("[msallowclip^='']").length&&q.push("[*^$]="+M+"*(?:''|\"\")"),a.querySelectorAll("[selected]").length||q.push("\\["+M+"*(?:value|"+L+")"),a.querySelectorAll(":checked").length||q.push(":checked")}),ib(function(a){var b=e.createElement("input");b.setAttribute("type","hidden"),a.appendChild(b).setAttribute("name","D"),a.querySelectorAll("[name=d]").length&&q.push("name"+M+"*[*^$|!~]?="),a.querySelectorAll(":enabled").length||q.push(":enabled",":disabled"),a.querySelectorAll("*,:x"),q.push(",.*:")})),(c.matchesSelector=$.test(s=o.matches||o.webkitMatchesSelector||o.mozMatchesSelector||o.oMatchesSelector||o.msMatchesSelector))&&ib(function(a){c.disconnectedMatch=s.call(a,"div"),s.call(a,"[s!='']:x"),r.push("!=",Q)}),q=q.length&&new RegExp(q.join("|")),r=r.length&&new RegExp(r.join("|")),b=$.test(o.compareDocumentPosition),t=b||$.test(o.contains)?function(a,b){var c=9===a.nodeType?a.documentElement:a,d=b&&b.parentNode;return a===d||!(!d||1!==d.nodeType||!(c.contains?c.contains(d):a.compareDocumentPosition&&16&a.compareDocumentPosition(d)))}:function(a,b){if(b)while(b=b.parentNode)if(b===a)return!0;return!1},B=b?function(a,b){if(a===b)return l=!0,0;var d=!a.compareDocumentPosition-!b.compareDocumentPosition;return d?d:(d=(a.ownerDocument||a)===(b.ownerDocument||b)?a.compareDocumentPosition(b):1,1&d||!c.sortDetached&&b.compareDocumentPosition(a)===d?a===e||a.ownerDocument===v&&t(v,a)?-1:b===e||b.ownerDocument===v&&t(v,b)?1:k?K.call(k,a)-K.call(k,b):0:4&d?-1:1)}:function(a,b){if(a===b)return l=!0,0;var c,d=0,f=a.parentNode,g=b.parentNode,h=[a],i=[b];if(!f||!g)return a===e?-1:b===e?1:f?-1:g?1:k?K.call(k,a)-K.call(k,b):0;if(f===g)return kb(a,b);c=a;while(c=c.parentNode)h.unshift(c);c=b;while(c=c.parentNode)i.unshift(c);while(h[d]===i[d])d++;return d?kb(h[d],i[d]):h[d]===v?-1:i[d]===v?1:0},e):n},fb.matches=function(a,b){return fb(a,null,null,b)},fb.matchesSelector=function(a,b){if((a.ownerDocument||a)!==n&&m(a),b=b.replace(U,"='$1']"),!(!c.matchesSelector||!p||r&&r.test(b)||q&&q.test(b)))try{var d=s.call(a,b);if(d||c.disconnectedMatch||a.document&&11!==a.document.nodeType)return d}catch(e){}return fb(b,n,null,[a]).length>0},fb.contains=function(a,b){return(a.ownerDocument||a)!==n&&m(a),t(a,b)},fb.attr=function(a,b){(a.ownerDocument||a)!==n&&m(a);var e=d.attrHandle[b.toLowerCase()],f=e&&E.call(d.attrHandle,b.toLowerCase())?e(a,b,!p):void 0;return void 0!==f?f:c.attributes||!p?a.getAttribute(b):(f=a.getAttributeNode(b))&&f.specified?f.value:null},fb.error=function(a){throw new Error("Syntax error, unrecognized expression: "+a)},fb.uniqueSort=function(a){var b,d=[],e=0,f=0;if(l=!c.detectDuplicates,k=!c.sortStable&&a.slice(0),a.sort(B),l){while(b=a[f++])b===a[f]&&(e=d.push(f));while(e--)a.splice(d[e],1)}return k=null,a},e=fb.getText=function(a){var b,c="",d=0,f=a.nodeType;if(f){if(1===f||9===f||11===f){if("string"==typeof a.textContent)return a.textContent;for(a=a.firstChild;a;a=a.nextSibling)c+=e(a)}else if(3===f||4===f)return a.nodeValue}else while(b=a[d++])c+=e(b);return c},d=fb.selectors={cacheLength:50,createPseudo:hb,match:X,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(a){return a[1]=a[1].replace(cb,db),a[3]=(a[3]||a[4]||a[5]||"").replace(cb,db),"~="===a[2]&&(a[3]=" "+a[3]+" "),a.slice(0,4)},CHILD:function(a){return a[1]=a[1].toLowerCase(),"nth"===a[1].slice(0,3)?(a[3]||fb.error(a[0]),a[4]=+(a[4]?a[5]+(a[6]||1):2*("even"===a[3]||"odd"===a[3])),a[5]=+(a[7]+a[8]||"odd"===a[3])):a[3]&&fb.error(a[0]),a},PSEUDO:function(a){var b,c=!a[6]&&a[2];return X.CHILD.test(a[0])?null:(a[3]?a[2]=a[4]||a[5]||"":c&&V.test(c)&&(b=g(c,!0))&&(b=c.indexOf(")",c.length-b)-c.length)&&(a[0]=a[0].slice(0,b),a[2]=c.slice(0,b)),a.slice(0,3))}},filter:{TAG:function(a){var b=a.replace(cb,db).toLowerCase();return"*"===a?function(){return!0}:function(a){return a.nodeName&&a.nodeName.toLowerCase()===b}},CLASS:function(a){var b=y[a+" "];return b||(b=new RegExp("(^|"+M+")"+a+"("+M+"|$)"))&&y(a,function(a){return b.test("string"==typeof a.className&&a.className||typeof a.getAttribute!==C&&a.getAttribute("class")||"")})},ATTR:function(a,b,c){return function(d){var e=fb.attr(d,a);return null==e?"!="===b:b?(e+="","="===b?e===c:"!="===b?e!==c:"^="===b?c&&0===e.indexOf(c):"*="===b?c&&e.indexOf(c)>-1:"$="===b?c&&e.slice(-c.length)===c:"~="===b?(" "+e+" ").indexOf(c)>-1:"|="===b?e===c||e.slice(0,c.length+1)===c+"-":!1):!0}},CHILD:function(a,b,c,d,e){var f="nth"!==a.slice(0,3),g="last"!==a.slice(-4),h="of-type"===b;return 1===d&&0===e?function(a){return!!a.parentNode}:function(b,c,i){var j,k,l,m,n,o,p=f!==g?"nextSibling":"previousSibling",q=b.parentNode,r=h&&b.nodeName.toLowerCase(),s=!i&&!h;if(q){if(f){while(p){l=b;while(l=l[p])if(h?l.nodeName.toLowerCase()===r:1===l.nodeType)return!1;o=p="only"===a&&!o&&"nextSibling"}return!0}if(o=[g?q.firstChild:q.lastChild],g&&s){k=q[u]||(q[u]={}),j=k[a]||[],n=j[0]===w&&j[1],m=j[0]===w&&j[2],l=n&&q.childNodes[n];while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if(1===l.nodeType&&++m&&l===b){k[a]=[w,n,m];break}}else if(s&&(j=(b[u]||(b[u]={}))[a])&&j[0]===w)m=j[1];else while(l=++n&&l&&l[p]||(m=n=0)||o.pop())if((h?l.nodeName.toLowerCase()===r:1===l.nodeType)&&++m&&(s&&((l[u]||(l[u]={}))[a]=[w,m]),l===b))break;return m-=e,m===d||m%d===0&&m/d>=0}}},PSEUDO:function(a,b){var c,e=d.pseudos[a]||d.setFilters[a.toLowerCase()]||fb.error("unsupported pseudo: "+a);return e[u]?e(b):e.length>1?(c=[a,a,"",b],d.setFilters.hasOwnProperty(a.toLowerCase())?hb(function(a,c){var d,f=e(a,b),g=f.length;while(g--)d=K.call(a,f[g]),a[d]=!(c[d]=f[g])}):function(a){return e(a,0,c)}):e}},pseudos:{not:hb(function(a){var b=[],c=[],d=h(a.replace(R,"$1"));return d[u]?hb(function(a,b,c,e){var f,g=d(a,null,e,[]),h=a.length;while(h--)(f=g[h])&&(a[h]=!(b[h]=f))}):function(a,e,f){return b[0]=a,d(b,null,f,c),!c.pop()}}),has:hb(function(a){return function(b){return fb(a,b).length>0}}),contains:hb(function(a){return function(b){return(b.textContent||b.innerText||e(b)).indexOf(a)>-1}}),lang:hb(function(a){return W.test(a||"")||fb.error("unsupported lang: "+a),a=a.replace(cb,db).toLowerCase(),function(b){var c;do if(c=p?b.lang:b.getAttribute("xml:lang")||b.getAttribute("lang"))return c=c.toLowerCase(),c===a||0===c.indexOf(a+"-");while((b=b.parentNode)&&1===b.nodeType);return!1}}),target:function(b){var c=a.location&&a.location.hash;return c&&c.slice(1)===b.id},root:function(a){return a===o},focus:function(a){return a===n.activeElement&&(!n.hasFocus||n.hasFocus())&&!!(a.type||a.href||~a.tabIndex)},enabled:function(a){return a.disabled===!1},disabled:function(a){return a.disabled===!0},checked:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&!!a.checked||"option"===b&&!!a.selected},selected:function(a){return a.parentNode&&a.parentNode.selectedIndex,a.selected===!0},empty:function(a){for(a=a.firstChild;a;a=a.nextSibling)if(a.nodeType<6)return!1;return!0},parent:function(a){return!d.pseudos.empty(a)},header:function(a){return Z.test(a.nodeName)},input:function(a){return Y.test(a.nodeName)},button:function(a){var b=a.nodeName.toLowerCase();return"input"===b&&"button"===a.type||"button"===b},text:function(a){var b;return"input"===a.nodeName.toLowerCase()&&"text"===a.type&&(null==(b=a.getAttribute("type"))||"text"===b.toLowerCase())},first:nb(function(){return[0]}),last:nb(function(a,b){return[b-1]}),eq:nb(function(a,b,c){return[0>c?c+b:c]}),even:nb(function(a,b){for(var c=0;b>c;c+=2)a.push(c);return a}),odd:nb(function(a,b){for(var c=1;b>c;c+=2)a.push(c);return a}),lt:nb(function(a,b,c){for(var d=0>c?c+b:c;--d>=0;)a.push(d);return a}),gt:nb(function(a,b,c){for(var d=0>c?c+b:c;++d<b;)a.push(d);return a})}},d.pseudos.nth=d.pseudos.eq;for(b in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})d.pseudos[b]=lb(b);for(b in{submit:!0,reset:!0})d.pseudos[b]=mb(b);function pb(){}pb.prototype=d.filters=d.pseudos,d.setFilters=new pb,g=fb.tokenize=function(a,b){var c,e,f,g,h,i,j,k=z[a+" "];if(k)return b?0:k.slice(0);h=a,i=[],j=d.preFilter;while(h){(!c||(e=S.exec(h)))&&(e&&(h=h.slice(e[0].length)||h),i.push(f=[])),c=!1,(e=T.exec(h))&&(c=e.shift(),f.push({value:c,type:e[0].replace(R," ")}),h=h.slice(c.length));for(g in d.filter)!(e=X[g].exec(h))||j[g]&&!(e=j[g](e))||(c=e.shift(),f.push({value:c,type:g,matches:e}),h=h.slice(c.length));if(!c)break}return b?h.length:h?fb.error(a):z(a,i).slice(0)};function qb(a){for(var b=0,c=a.length,d="";c>b;b++)d+=a[b].value;return d}function rb(a,b,c){var d=b.dir,e=c&&"parentNode"===d,f=x++;return b.first?function(b,c,f){while(b=b[d])if(1===b.nodeType||e)return a(b,c,f)}:function(b,c,g){var h,i,j=[w,f];if(g){while(b=b[d])if((1===b.nodeType||e)&&a(b,c,g))return!0}else while(b=b[d])if(1===b.nodeType||e){if(i=b[u]||(b[u]={}),(h=i[d])&&h[0]===w&&h[1]===f)return j[2]=h[2];if(i[d]=j,j[2]=a(b,c,g))return!0}}}function sb(a){return a.length>1?function(b,c,d){var e=a.length;while(e--)if(!a[e](b,c,d))return!1;return!0}:a[0]}function tb(a,b,c){for(var d=0,e=b.length;e>d;d++)fb(a,b[d],c);return c}function ub(a,b,c,d,e){for(var f,g=[],h=0,i=a.length,j=null!=b;i>h;h++)(f=a[h])&&(!c||c(f,d,e))&&(g.push(f),j&&b.push(h));return g}function vb(a,b,c,d,e,f){return d&&!d[u]&&(d=vb(d)),e&&!e[u]&&(e=vb(e,f)),hb(function(f,g,h,i){var j,k,l,m=[],n=[],o=g.length,p=f||tb(b||"*",h.nodeType?[h]:h,[]),q=!a||!f&&b?p:ub(p,m,a,h,i),r=c?e||(f?a:o||d)?[]:g:q;if(c&&c(q,r,h,i),d){j=ub(r,n),d(j,[],h,i),k=j.length;while(k--)(l=j[k])&&(r[n[k]]=!(q[n[k]]=l))}if(f){if(e||a){if(e){j=[],k=r.length;while(k--)(l=r[k])&&j.push(q[k]=l);e(null,r=[],j,i)}k=r.length;while(k--)(l=r[k])&&(j=e?K.call(f,l):m[k])>-1&&(f[j]=!(g[j]=l))}}else r=ub(r===g?r.splice(o,r.length):r),e?e(null,g,r,i):I.apply(g,r)})}function wb(a){for(var b,c,e,f=a.length,g=d.relative[a[0].type],h=g||d.relative[" "],i=g?1:0,k=rb(function(a){return a===b},h,!0),l=rb(function(a){return K.call(b,a)>-1},h,!0),m=[function(a,c,d){return!g&&(d||c!==j)||((b=c).nodeType?k(a,c,d):l(a,c,d))}];f>i;i++)if(c=d.relative[a[i].type])m=[rb(sb(m),c)];else{if(c=d.filter[a[i].type].apply(null,a[i].matches),c[u]){for(e=++i;f>e;e++)if(d.relative[a[e].type])break;return vb(i>1&&sb(m),i>1&&qb(a.slice(0,i-1).concat({value:" "===a[i-2].type?"*":""})).replace(R,"$1"),c,e>i&&wb(a.slice(i,e)),f>e&&wb(a=a.slice(e)),f>e&&qb(a))}m.push(c)}return sb(m)}function xb(a,b){var c=b.length>0,e=a.length>0,f=function(f,g,h,i,k){var l,m,o,p=0,q="0",r=f&&[],s=[],t=j,u=f||e&&d.find.TAG("*",k),v=w+=null==t?1:Math.random()||.1,x=u.length;for(k&&(j=g!==n&&g);q!==x&&null!=(l=u[q]);q++){if(e&&l){m=0;while(o=a[m++])if(o(l,g,h)){i.push(l);break}k&&(w=v)}c&&((l=!o&&l)&&p--,f&&r.push(l))}if(p+=q,c&&q!==p){m=0;while(o=b[m++])o(r,s,g,h);if(f){if(p>0)while(q--)r[q]||s[q]||(s[q]=G.call(i));s=ub(s)}I.apply(i,s),k&&!f&&s.length>0&&p+b.length>1&&fb.uniqueSort(i)}return k&&(w=v,j=t),r};return c?hb(f):f}return h=fb.compile=function(a,b){var c,d=[],e=[],f=A[a+" "];if(!f){b||(b=g(a)),c=b.length;while(c--)f=wb(b[c]),f[u]?d.push(f):e.push(f);f=A(a,xb(e,d)),f.selector=a}return f},i=fb.select=function(a,b,e,f){var i,j,k,l,m,n="function"==typeof a&&a,o=!f&&g(a=n.selector||a);if(e=e||[],1===o.length){if(j=o[0]=o[0].slice(0),j.length>2&&"ID"===(k=j[0]).type&&c.getById&&9===b.nodeType&&p&&d.relative[j[1].type]){if(b=(d.find.ID(k.matches[0].replace(cb,db),b)||[])[0],!b)return e;n&&(b=b.parentNode),a=a.slice(j.shift().value.length)}i=X.needsContext.test(a)?0:j.length;while(i--){if(k=j[i],d.relative[l=k.type])break;if((m=d.find[l])&&(f=m(k.matches[0].replace(cb,db),ab.test(j[0].type)&&ob(b.parentNode)||b))){if(j.splice(i,1),a=f.length&&qb(j),!a)return I.apply(e,f),e;break}}}return(n||h(a,o))(f,b,!p,e,ab.test(a)&&ob(b.parentNode)||b),e},c.sortStable=u.split("").sort(B).join("")===u,c.detectDuplicates=!!l,m(),c.sortDetached=ib(function(a){return 1&a.compareDocumentPosition(n.createElement("div"))}),ib(function(a){return a.innerHTML="<a href='#'></a>","#"===a.firstChild.getAttribute("href")})||jb("type|href|height|width",function(a,b,c){return c?void 0:a.getAttribute(b,"type"===b.toLowerCase()?1:2)}),c.attributes&&ib(function(a){return a.innerHTML="<input/>",a.firstChild.setAttribute("value",""),""===a.firstChild.getAttribute("value")})||jb("value",function(a,b,c){return c||"input"!==a.nodeName.toLowerCase()?void 0:a.defaultValue}),ib(function(a){return null==a.getAttribute("disabled")})||jb(L,function(a,b,c){var d;return c?void 0:a[b]===!0?b.toLowerCase():(d=a.getAttributeNode(b))&&d.specified?d.value:null}),fb}(a);n.find=t,n.expr=t.selectors,n.expr[":"]=n.expr.pseudos,n.unique=t.uniqueSort,n.text=t.getText,n.isXMLDoc=t.isXML,n.contains=t.contains;var u=n.expr.match.needsContext,v=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,w=/^.[^:#\[\.,]*$/;function x(a,b,c){if(n.isFunction(b))return n.grep(a,function(a,d){return!!b.call(a,d,a)!==c});if(b.nodeType)return n.grep(a,function(a){return a===b!==c});if("string"==typeof b){if(w.test(b))return n.filter(b,a,c);b=n.filter(b,a)}return n.grep(a,function(a){return g.call(b,a)>=0!==c})}n.filter=function(a,b,c){var d=b[0];return c&&(a=":not("+a+")"),1===b.length&&1===d.nodeType?n.find.matchesSelector(d,a)?[d]:[]:n.find.matches(a,n.grep(b,function(a){return 1===a.nodeType}))},n.fn.extend({find:function(a){var b,c=this.length,d=[],e=this;if("string"!=typeof a)return this.pushStack(n(a).filter(function(){for(b=0;c>b;b++)if(n.contains(e[b],this))return!0}));for(b=0;c>b;b++)n.find(a,e[b],d);return d=this.pushStack(c>1?n.unique(d):d),d.selector=this.selector?this.selector+" "+a:a,d},filter:function(a){return this.pushStack(x(this,a||[],!1))},not:function(a){return this.pushStack(x(this,a||[],!0))},is:function(a){return!!x(this,"string"==typeof a&&u.test(a)?n(a):a||[],!1).length}});var y,z=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,A=n.fn.init=function(a,b){var c,d;if(!a)return this;if("string"==typeof a){if(c="<"===a[0]&&">"===a[a.length-1]&&a.length>=3?[null,a,null]:z.exec(a),!c||!c[1]&&b)return!b||b.jquery?(b||y).find(a):this.constructor(b).find(a);if(c[1]){if(b=b instanceof n?b[0]:b,n.merge(this,n.parseHTML(c[1],b&&b.nodeType?b.ownerDocument||b:l,!0)),v.test(c[1])&&n.isPlainObject(b))for(c in b)n.isFunction(this[c])?this[c](b[c]):this.attr(c,b[c]);return this}return d=l.getElementById(c[2]),d&&d.parentNode&&(this.length=1,this[0]=d),this.context=l,this.selector=a,this}return a.nodeType?(this.context=this[0]=a,this.length=1,this):n.isFunction(a)?"undefined"!=typeof y.ready?y.ready(a):a(n):(void 0!==a.selector&&(this.selector=a.selector,this.context=a.context),n.makeArray(a,this))};A.prototype=n.fn,y=n(l);var B=/^(?:parents|prev(?:Until|All))/,C={children:!0,contents:!0,next:!0,prev:!0};n.extend({dir:function(a,b,c){var d=[],e=void 0!==c;while((a=a[b])&&9!==a.nodeType)if(1===a.nodeType){if(e&&n(a).is(c))break;d.push(a)}return d},sibling:function(a,b){for(var c=[];a;a=a.nextSibling)1===a.nodeType&&a!==b&&c.push(a);return c}}),n.fn.extend({has:function(a){var b=n(a,this),c=b.length;return this.filter(function(){for(var a=0;c>a;a++)if(n.contains(this,b[a]))return!0})},closest:function(a,b){for(var c,d=0,e=this.length,f=[],g=u.test(a)||"string"!=typeof a?n(a,b||this.context):0;e>d;d++)for(c=this[d];c&&c!==b;c=c.parentNode)if(c.nodeType<11&&(g?g.index(c)>-1:1===c.nodeType&&n.find.matchesSelector(c,a))){f.push(c);break}return this.pushStack(f.length>1?n.unique(f):f)},index:function(a){return a?"string"==typeof a?g.call(n(a),this[0]):g.call(this,a.jquery?a[0]:a):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(a,b){return this.pushStack(n.unique(n.merge(this.get(),n(a,b))))},addBack:function(a){return this.add(null==a?this.prevObject:this.prevObject.filter(a))}});function D(a,b){while((a=a[b])&&1!==a.nodeType);return a}n.each({parent:function(a){var b=a.parentNode;return b&&11!==b.nodeType?b:null},parents:function(a){return n.dir(a,"parentNode")},parentsUntil:function(a,b,c){return n.dir(a,"parentNode",c)},next:function(a){return D(a,"nextSibling")},prev:function(a){return D(a,"previousSibling")},nextAll:function(a){return n.dir(a,"nextSibling")},prevAll:function(a){return n.dir(a,"previousSibling")},nextUntil:function(a,b,c){return n.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return n.dir(a,"previousSibling",c)},siblings:function(a){return n.sibling((a.parentNode||{}).firstChild,a)},children:function(a){return n.sibling(a.firstChild)},contents:function(a){return a.contentDocument||n.merge([],a.childNodes)}},function(a,b){n.fn[a]=function(c,d){var e=n.map(this,b,c);return"Until"!==a.slice(-5)&&(d=c),d&&"string"==typeof d&&(e=n.filter(d,e)),this.length>1&&(C[a]||n.unique(e),B.test(a)&&e.reverse()),this.pushStack(e)}});var E=/\S+/g,F={};function G(a){var b=F[a]={};return n.each(a.match(E)||[],function(a,c){b[c]=!0}),b}n.Callbacks=function(a){a="string"==typeof a?F[a]||G(a):n.extend({},a);var b,c,d,e,f,g,h=[],i=!a.once&&[],j=function(l){for(b=a.memory&&l,c=!0,g=e||0,e=0,f=h.length,d=!0;h&&f>g;g++)if(h[g].apply(l[0],l[1])===!1&&a.stopOnFalse){b=!1;break}d=!1,h&&(i?i.length&&j(i.shift()):b?h=[]:k.disable())},k={add:function(){if(h){var c=h.length;!function g(b){n.each(b,function(b,c){var d=n.type(c);"function"===d?a.unique&&k.has(c)||h.push(c):c&&c.length&&"string"!==d&&g(c)})}(arguments),d?f=h.length:b&&(e=c,j(b))}return this},remove:function(){return h&&n.each(arguments,function(a,b){var c;while((c=n.inArray(b,h,c))>-1)h.splice(c,1),d&&(f>=c&&f--,g>=c&&g--)}),this},has:function(a){return a?n.inArray(a,h)>-1:!(!h||!h.length)},empty:function(){return h=[],f=0,this},disable:function(){return h=i=b=void 0,this},disabled:function(){return!h},lock:function(){return i=void 0,b||k.disable(),this},locked:function(){return!i},fireWith:function(a,b){return!h||c&&!i||(b=b||[],b=[a,b.slice?b.slice():b],d?i.push(b):j(b)),this},fire:function(){return k.fireWith(this,arguments),this},fired:function(){return!!c}};return k},n.extend({Deferred:function(a){var b=[["resolve","done",n.Callbacks("once memory"),"resolved"],["reject","fail",n.Callbacks("once memory"),"rejected"],["notify","progress",n.Callbacks("memory")]],c="pending",d={state:function(){return c},always:function(){return e.done(arguments).fail(arguments),this},then:function(){var a=arguments;return n.Deferred(function(c){n.each(b,function(b,f){var g=n.isFunction(a[b])&&a[b];e[f[1]](function(){var a=g&&g.apply(this,arguments);a&&n.isFunction(a.promise)?a.promise().done(c.resolve).fail(c.reject).progress(c.notify):c[f[0]+"With"](this===d?c.promise():this,g?[a]:arguments)})}),a=null}).promise()},promise:function(a){return null!=a?n.extend(a,d):d}},e={};return d.pipe=d.then,n.each(b,function(a,f){var g=f[2],h=f[3];d[f[1]]=g.add,h&&g.add(function(){c=h},b[1^a][2].disable,b[2][2].lock),e[f[0]]=function(){return e[f[0]+"With"](this===e?d:this,arguments),this},e[f[0]+"With"]=g.fireWith}),d.promise(e),a&&a.call(e,e),e},when:function(a){var b=0,c=d.call(arguments),e=c.length,f=1!==e||a&&n.isFunction(a.promise)?e:0,g=1===f?a:n.Deferred(),h=function(a,b,c){return function(e){b[a]=this,c[a]=arguments.length>1?d.call(arguments):e,c===i?g.notifyWith(b,c):--f||g.resolveWith(b,c)}},i,j,k;if(e>1)for(i=new Array(e),j=new Array(e),k=new Array(e);e>b;b++)c[b]&&n.isFunction(c[b].promise)?c[b].promise().done(h(b,k,c)).fail(g.reject).progress(h(b,j,i)):--f;return f||g.resolveWith(k,c),g.promise()}});var H;n.fn.ready=function(a){return n.ready.promise().done(a),this},n.extend({isReady:!1,readyWait:1,holdReady:function(a){a?n.readyWait++:n.ready(!0)},ready:function(a){(a===!0?--n.readyWait:n.isReady)||(n.isReady=!0,a!==!0&&--n.readyWait>0||(H.resolveWith(l,[n]),n.fn.triggerHandler&&(n(l).triggerHandler("ready"),n(l).off("ready"))))}});function I(){l.removeEventListener("DOMContentLoaded",I,!1),a.removeEventListener("load",I,!1),n.ready()}n.ready.promise=function(b){return H||(H=n.Deferred(),"complete"===l.readyState?setTimeout(n.ready):(l.addEventListener("DOMContentLoaded",I,!1),a.addEventListener("load",I,!1))),H.promise(b)},n.ready.promise();var J=n.access=function(a,b,c,d,e,f,g){var h=0,i=a.length,j=null==c;if("object"===n.type(c)){e=!0;for(h in c)n.access(a,b,h,c[h],!0,f,g)}else if(void 0!==d&&(e=!0,n.isFunction(d)||(g=!0),j&&(g?(b.call(a,d),b=null):(j=b,b=function(a,b,c){return j.call(n(a),c)})),b))for(;i>h;h++)b(a[h],c,g?d:d.call(a[h],h,b(a[h],c)));return e?a:j?b.call(a):i?b(a[0],c):f};n.acceptData=function(a){return 1===a.nodeType||9===a.nodeType||!+a.nodeType};function K(){Object.defineProperty(this.cache={},0,{get:function(){return{}}}),this.expando=n.expando+Math.random()}K.uid=1,K.accepts=n.acceptData,K.prototype={key:function(a){if(!K.accepts(a))return 0;var b={},c=a[this.expando];if(!c){c=K.uid++;try{b[this.expando]={value:c},Object.defineProperties(a,b)}catch(d){b[this.expando]=c,n.extend(a,b)}}return this.cache[c]||(this.cache[c]={}),c},set:function(a,b,c){var d,e=this.key(a),f=this.cache[e];if("string"==typeof b)f[b]=c;else if(n.isEmptyObject(f))n.extend(this.cache[e],b);else for(d in b)f[d]=b[d];return f},get:function(a,b){var c=this.cache[this.key(a)];return void 0===b?c:c[b]},access:function(a,b,c){var d;return void 0===b||b&&"string"==typeof b&&void 0===c?(d=this.get(a,b),void 0!==d?d:this.get(a,n.camelCase(b))):(this.set(a,b,c),void 0!==c?c:b)},remove:function(a,b){var c,d,e,f=this.key(a),g=this.cache[f];if(void 0===b)this.cache[f]={};else{n.isArray(b)?d=b.concat(b.map(n.camelCase)):(e=n.camelCase(b),b in g?d=[b,e]:(d=e,d=d in g?[d]:d.match(E)||[])),c=d.length;while(c--)delete g[d[c]]}},hasData:function(a){return!n.isEmptyObject(this.cache[a[this.expando]]||{})},discard:function(a){a[this.expando]&&delete this.cache[a[this.expando]]}};var L=new K,M=new K,N=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,O=/([A-Z])/g;function P(a,b,c){var d;if(void 0===c&&1===a.nodeType)if(d="data-"+b.replace(O,"-$1").toLowerCase(),c=a.getAttribute(d),"string"==typeof c){try{c="true"===c?!0:"false"===c?!1:"null"===c?null:+c+""===c?+c:N.test(c)?n.parseJSON(c):c}catch(e){}M.set(a,b,c)}else c=void 0;return c}n.extend({hasData:function(a){return M.hasData(a)||L.hasData(a)},data:function(a,b,c){return M.access(a,b,c)},removeData:function(a,b){M.remove(a,b)
-},_data:function(a,b,c){return L.access(a,b,c)},_removeData:function(a,b){L.remove(a,b)}}),n.fn.extend({data:function(a,b){var c,d,e,f=this[0],g=f&&f.attributes;if(void 0===a){if(this.length&&(e=M.get(f),1===f.nodeType&&!L.get(f,"hasDataAttrs"))){c=g.length;while(c--)g[c]&&(d=g[c].name,0===d.indexOf("data-")&&(d=n.camelCase(d.slice(5)),P(f,d,e[d])));L.set(f,"hasDataAttrs",!0)}return e}return"object"==typeof a?this.each(function(){M.set(this,a)}):J(this,function(b){var c,d=n.camelCase(a);if(f&&void 0===b){if(c=M.get(f,a),void 0!==c)return c;if(c=M.get(f,d),void 0!==c)return c;if(c=P(f,d,void 0),void 0!==c)return c}else this.each(function(){var c=M.get(this,d);M.set(this,d,b),-1!==a.indexOf("-")&&void 0!==c&&M.set(this,a,b)})},null,b,arguments.length>1,null,!0)},removeData:function(a){return this.each(function(){M.remove(this,a)})}}),n.extend({queue:function(a,b,c){var d;return a?(b=(b||"fx")+"queue",d=L.get(a,b),c&&(!d||n.isArray(c)?d=L.access(a,b,n.makeArray(c)):d.push(c)),d||[]):void 0},dequeue:function(a,b){b=b||"fx";var c=n.queue(a,b),d=c.length,e=c.shift(),f=n._queueHooks(a,b),g=function(){n.dequeue(a,b)};"inprogress"===e&&(e=c.shift(),d--),e&&("fx"===b&&c.unshift("inprogress"),delete f.stop,e.call(a,g,f)),!d&&f&&f.empty.fire()},_queueHooks:function(a,b){var c=b+"queueHooks";return L.get(a,c)||L.access(a,c,{empty:n.Callbacks("once memory").add(function(){L.remove(a,[b+"queue",c])})})}}),n.fn.extend({queue:function(a,b){var c=2;return"string"!=typeof a&&(b=a,a="fx",c--),arguments.length<c?n.queue(this[0],a):void 0===b?this:this.each(function(){var c=n.queue(this,a,b);n._queueHooks(this,a),"fx"===a&&"inprogress"!==c[0]&&n.dequeue(this,a)})},dequeue:function(a){return this.each(function(){n.dequeue(this,a)})},clearQueue:function(a){return this.queue(a||"fx",[])},promise:function(a,b){var c,d=1,e=n.Deferred(),f=this,g=this.length,h=function(){--d||e.resolveWith(f,[f])};"string"!=typeof a&&(b=a,a=void 0),a=a||"fx";while(g--)c=L.get(f[g],a+"queueHooks"),c&&c.empty&&(d++,c.empty.add(h));return h(),e.promise(b)}});var Q=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,R=["Top","Right","Bottom","Left"],S=function(a,b){return a=b||a,"none"===n.css(a,"display")||!n.contains(a.ownerDocument,a)},T=/^(?:checkbox|radio)$/i;!function(){var a=l.createDocumentFragment(),b=a.appendChild(l.createElement("div")),c=l.createElement("input");c.setAttribute("type","radio"),c.setAttribute("checked","checked"),c.setAttribute("name","t"),b.appendChild(c),k.checkClone=b.cloneNode(!0).cloneNode(!0).lastChild.checked,b.innerHTML="<textarea>x</textarea>",k.noCloneChecked=!!b.cloneNode(!0).lastChild.defaultValue}();var U="undefined";k.focusinBubbles="onfocusin"in a;var V=/^key/,W=/^(?:mouse|pointer|contextmenu)|click/,X=/^(?:focusinfocus|focusoutblur)$/,Y=/^([^.]*)(?:\.(.+)|)$/;function Z(){return!0}function $(){return!1}function _(){try{return l.activeElement}catch(a){}}n.event={global:{},add:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,o,p,q,r=L.get(a);if(r){c.handler&&(f=c,c=f.handler,e=f.selector),c.guid||(c.guid=n.guid++),(i=r.events)||(i=r.events={}),(g=r.handle)||(g=r.handle=function(b){return typeof n!==U&&n.event.triggered!==b.type?n.event.dispatch.apply(a,arguments):void 0}),b=(b||"").match(E)||[""],j=b.length;while(j--)h=Y.exec(b[j])||[],o=q=h[1],p=(h[2]||"").split(".").sort(),o&&(l=n.event.special[o]||{},o=(e?l.delegateType:l.bindType)||o,l=n.event.special[o]||{},k=n.extend({type:o,origType:q,data:d,handler:c,guid:c.guid,selector:e,needsContext:e&&n.expr.match.needsContext.test(e),namespace:p.join(".")},f),(m=i[o])||(m=i[o]=[],m.delegateCount=0,l.setup&&l.setup.call(a,d,p,g)!==!1||a.addEventListener&&a.addEventListener(o,g,!1)),l.add&&(l.add.call(a,k),k.handler.guid||(k.handler.guid=c.guid)),e?m.splice(m.delegateCount++,0,k):m.push(k),n.event.global[o]=!0)}},remove:function(a,b,c,d,e){var f,g,h,i,j,k,l,m,o,p,q,r=L.hasData(a)&&L.get(a);if(r&&(i=r.events)){b=(b||"").match(E)||[""],j=b.length;while(j--)if(h=Y.exec(b[j])||[],o=q=h[1],p=(h[2]||"").split(".").sort(),o){l=n.event.special[o]||{},o=(d?l.delegateType:l.bindType)||o,m=i[o]||[],h=h[2]&&new RegExp("(^|\\.)"+p.join("\\.(?:.*\\.|)")+"(\\.|$)"),g=f=m.length;while(f--)k=m[f],!e&&q!==k.origType||c&&c.guid!==k.guid||h&&!h.test(k.namespace)||d&&d!==k.selector&&("**"!==d||!k.selector)||(m.splice(f,1),k.selector&&m.delegateCount--,l.remove&&l.remove.call(a,k));g&&!m.length&&(l.teardown&&l.teardown.call(a,p,r.handle)!==!1||n.removeEvent(a,o,r.handle),delete i[o])}else for(o in i)n.event.remove(a,o+b[j],c,d,!0);n.isEmptyObject(i)&&(delete r.handle,L.remove(a,"events"))}},trigger:function(b,c,d,e){var f,g,h,i,k,m,o,p=[d||l],q=j.call(b,"type")?b.type:b,r=j.call(b,"namespace")?b.namespace.split("."):[];if(g=h=d=d||l,3!==d.nodeType&&8!==d.nodeType&&!X.test(q+n.event.triggered)&&(q.indexOf(".")>=0&&(r=q.split("."),q=r.shift(),r.sort()),k=q.indexOf(":")<0&&"on"+q,b=b[n.expando]?b:new n.Event(q,"object"==typeof b&&b),b.isTrigger=e?2:3,b.namespace=r.join("."),b.namespace_re=b.namespace?new RegExp("(^|\\.)"+r.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,b.result=void 0,b.target||(b.target=d),c=null==c?[b]:n.makeArray(c,[b]),o=n.event.special[q]||{},e||!o.trigger||o.trigger.apply(d,c)!==!1)){if(!e&&!o.noBubble&&!n.isWindow(d)){for(i=o.delegateType||q,X.test(i+q)||(g=g.parentNode);g;g=g.parentNode)p.push(g),h=g;h===(d.ownerDocument||l)&&p.push(h.defaultView||h.parentWindow||a)}f=0;while((g=p[f++])&&!b.isPropagationStopped())b.type=f>1?i:o.bindType||q,m=(L.get(g,"events")||{})[b.type]&&L.get(g,"handle"),m&&m.apply(g,c),m=k&&g[k],m&&m.apply&&n.acceptData(g)&&(b.result=m.apply(g,c),b.result===!1&&b.preventDefault());return b.type=q,e||b.isDefaultPrevented()||o._default&&o._default.apply(p.pop(),c)!==!1||!n.acceptData(d)||k&&n.isFunction(d[q])&&!n.isWindow(d)&&(h=d[k],h&&(d[k]=null),n.event.triggered=q,d[q](),n.event.triggered=void 0,h&&(d[k]=h)),b.result}},dispatch:function(a){a=n.event.fix(a);var b,c,e,f,g,h=[],i=d.call(arguments),j=(L.get(this,"events")||{})[a.type]||[],k=n.event.special[a.type]||{};if(i[0]=a,a.delegateTarget=this,!k.preDispatch||k.preDispatch.call(this,a)!==!1){h=n.event.handlers.call(this,a,j),b=0;while((f=h[b++])&&!a.isPropagationStopped()){a.currentTarget=f.elem,c=0;while((g=f.handlers[c++])&&!a.isImmediatePropagationStopped())(!a.namespace_re||a.namespace_re.test(g.namespace))&&(a.handleObj=g,a.data=g.data,e=((n.event.special[g.origType]||{}).handle||g.handler).apply(f.elem,i),void 0!==e&&(a.result=e)===!1&&(a.preventDefault(),a.stopPropagation()))}return k.postDispatch&&k.postDispatch.call(this,a),a.result}},handlers:function(a,b){var c,d,e,f,g=[],h=b.delegateCount,i=a.target;if(h&&i.nodeType&&(!a.button||"click"!==a.type))for(;i!==this;i=i.parentNode||this)if(i.disabled!==!0||"click"!==a.type){for(d=[],c=0;h>c;c++)f=b[c],e=f.selector+" ",void 0===d[e]&&(d[e]=f.needsContext?n(e,this).index(i)>=0:n.find(e,this,null,[i]).length),d[e]&&d.push(f);d.length&&g.push({elem:i,handlers:d})}return h<b.length&&g.push({elem:this,handlers:b.slice(h)}),g},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(a,b){return null==a.which&&(a.which=null!=b.charCode?b.charCode:b.keyCode),a}},mouseHooks:{props:"button buttons clientX clientY offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(a,b){var c,d,e,f=b.button;return null==a.pageX&&null!=b.clientX&&(c=a.target.ownerDocument||l,d=c.documentElement,e=c.body,a.pageX=b.clientX+(d&&d.scrollLeft||e&&e.scrollLeft||0)-(d&&d.clientLeft||e&&e.clientLeft||0),a.pageY=b.clientY+(d&&d.scrollTop||e&&e.scrollTop||0)-(d&&d.clientTop||e&&e.clientTop||0)),a.which||void 0===f||(a.which=1&f?1:2&f?3:4&f?2:0),a}},fix:function(a){if(a[n.expando])return a;var b,c,d,e=a.type,f=a,g=this.fixHooks[e];g||(this.fixHooks[e]=g=W.test(e)?this.mouseHooks:V.test(e)?this.keyHooks:{}),d=g.props?this.props.concat(g.props):this.props,a=new n.Event(f),b=d.length;while(b--)c=d[b],a[c]=f[c];return a.target||(a.target=l),3===a.target.nodeType&&(a.target=a.target.parentNode),g.filter?g.filter(a,f):a},special:{load:{noBubble:!0},focus:{trigger:function(){return this!==_()&&this.focus?(this.focus(),!1):void 0},delegateType:"focusin"},blur:{trigger:function(){return this===_()&&this.blur?(this.blur(),!1):void 0},delegateType:"focusout"},click:{trigger:function(){return"checkbox"===this.type&&this.click&&n.nodeName(this,"input")?(this.click(),!1):void 0},_default:function(a){return n.nodeName(a.target,"a")}},beforeunload:{postDispatch:function(a){void 0!==a.result&&a.originalEvent&&(a.originalEvent.returnValue=a.result)}}},simulate:function(a,b,c,d){var e=n.extend(new n.Event,c,{type:a,isSimulated:!0,originalEvent:{}});d?n.event.trigger(e,null,b):n.event.dispatch.call(b,e),e.isDefaultPrevented()&&c.preventDefault()}},n.removeEvent=function(a,b,c){a.removeEventListener&&a.removeEventListener(b,c,!1)},n.Event=function(a,b){return this instanceof n.Event?(a&&a.type?(this.originalEvent=a,this.type=a.type,this.isDefaultPrevented=a.defaultPrevented||void 0===a.defaultPrevented&&a.returnValue===!1?Z:$):this.type=a,b&&n.extend(this,b),this.timeStamp=a&&a.timeStamp||n.now(),void(this[n.expando]=!0)):new n.Event(a,b)},n.Event.prototype={isDefaultPrevented:$,isPropagationStopped:$,isImmediatePropagationStopped:$,preventDefault:function(){var a=this.originalEvent;this.isDefaultPrevented=Z,a&&a.preventDefault&&a.preventDefault()},stopPropagation:function(){var a=this.originalEvent;this.isPropagationStopped=Z,a&&a.stopPropagation&&a.stopPropagation()},stopImmediatePropagation:function(){var a=this.originalEvent;this.isImmediatePropagationStopped=Z,a&&a.stopImmediatePropagation&&a.stopImmediatePropagation(),this.stopPropagation()}},n.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(a,b){n.event.special[a]={delegateType:b,bindType:b,handle:function(a){var c,d=this,e=a.relatedTarget,f=a.handleObj;return(!e||e!==d&&!n.contains(d,e))&&(a.type=f.origType,c=f.handler.apply(this,arguments),a.type=b),c}}}),k.focusinBubbles||n.each({focus:"focusin",blur:"focusout"},function(a,b){var c=function(a){n.event.simulate(b,a.target,n.event.fix(a),!0)};n.event.special[b]={setup:function(){var d=this.ownerDocument||this,e=L.access(d,b);e||d.addEventListener(a,c,!0),L.access(d,b,(e||0)+1)},teardown:function(){var d=this.ownerDocument||this,e=L.access(d,b)-1;e?L.access(d,b,e):(d.removeEventListener(a,c,!0),L.remove(d,b))}}}),n.fn.extend({on:function(a,b,c,d,e){var f,g;if("object"==typeof a){"string"!=typeof b&&(c=c||b,b=void 0);for(g in a)this.on(g,b,c,a[g],e);return this}if(null==c&&null==d?(d=b,c=b=void 0):null==d&&("string"==typeof b?(d=c,c=void 0):(d=c,c=b,b=void 0)),d===!1)d=$;else if(!d)return this;return 1===e&&(f=d,d=function(a){return n().off(a),f.apply(this,arguments)},d.guid=f.guid||(f.guid=n.guid++)),this.each(function(){n.event.add(this,a,d,c,b)})},one:function(a,b,c,d){return this.on(a,b,c,d,1)},off:function(a,b,c){var d,e;if(a&&a.preventDefault&&a.handleObj)return d=a.handleObj,n(a.delegateTarget).off(d.namespace?d.origType+"."+d.namespace:d.origType,d.selector,d.handler),this;if("object"==typeof a){for(e in a)this.off(e,b,a[e]);return this}return(b===!1||"function"==typeof b)&&(c=b,b=void 0),c===!1&&(c=$),this.each(function(){n.event.remove(this,a,c,b)})},trigger:function(a,b){return this.each(function(){n.event.trigger(a,b,this)})},triggerHandler:function(a,b){var c=this[0];return c?n.event.trigger(a,b,c,!0):void 0}});var ab=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,bb=/<([\w:]+)/,cb=/<|&#?\w+;/,db=/<(?:script|style|link)/i,eb=/checked\s*(?:[^=]|=\s*.checked.)/i,fb=/^$|\/(?:java|ecma)script/i,gb=/^true\/(.*)/,hb=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,ib={option:[1,"<select multiple='multiple'>","</select>"],thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};ib.optgroup=ib.option,ib.tbody=ib.tfoot=ib.colgroup=ib.caption=ib.thead,ib.th=ib.td;function jb(a,b){return n.nodeName(a,"table")&&n.nodeName(11!==b.nodeType?b:b.firstChild,"tr")?a.getElementsByTagName("tbody")[0]||a.appendChild(a.ownerDocument.createElement("tbody")):a}function kb(a){return a.type=(null!==a.getAttribute("type"))+"/"+a.type,a}function lb(a){var b=gb.exec(a.type);return b?a.type=b[1]:a.removeAttribute("type"),a}function mb(a,b){for(var c=0,d=a.length;d>c;c++)L.set(a[c],"globalEval",!b||L.get(b[c],"globalEval"))}function nb(a,b){var c,d,e,f,g,h,i,j;if(1===b.nodeType){if(L.hasData(a)&&(f=L.access(a),g=L.set(b,f),j=f.events)){delete g.handle,g.events={};for(e in j)for(c=0,d=j[e].length;d>c;c++)n.event.add(b,e,j[e][c])}M.hasData(a)&&(h=M.access(a),i=n.extend({},h),M.set(b,i))}}function ob(a,b){var c=a.getElementsByTagName?a.getElementsByTagName(b||"*"):a.querySelectorAll?a.querySelectorAll(b||"*"):[];return void 0===b||b&&n.nodeName(a,b)?n.merge([a],c):c}function pb(a,b){var c=b.nodeName.toLowerCase();"input"===c&&T.test(a.type)?b.checked=a.checked:("input"===c||"textarea"===c)&&(b.defaultValue=a.defaultValue)}n.extend({clone:function(a,b,c){var d,e,f,g,h=a.cloneNode(!0),i=n.contains(a.ownerDocument,a);if(!(k.noCloneChecked||1!==a.nodeType&&11!==a.nodeType||n.isXMLDoc(a)))for(g=ob(h),f=ob(a),d=0,e=f.length;e>d;d++)pb(f[d],g[d]);if(b)if(c)for(f=f||ob(a),g=g||ob(h),d=0,e=f.length;e>d;d++)nb(f[d],g[d]);else nb(a,h);return g=ob(h,"script"),g.length>0&&mb(g,!i&&ob(a,"script")),h},buildFragment:function(a,b,c,d){for(var e,f,g,h,i,j,k=b.createDocumentFragment(),l=[],m=0,o=a.length;o>m;m++)if(e=a[m],e||0===e)if("object"===n.type(e))n.merge(l,e.nodeType?[e]:e);else if(cb.test(e)){f=f||k.appendChild(b.createElement("div")),g=(bb.exec(e)||["",""])[1].toLowerCase(),h=ib[g]||ib._default,f.innerHTML=h[1]+e.replace(ab,"<$1></$2>")+h[2],j=h[0];while(j--)f=f.lastChild;n.merge(l,f.childNodes),f=k.firstChild,f.textContent=""}else l.push(b.createTextNode(e));k.textContent="",m=0;while(e=l[m++])if((!d||-1===n.inArray(e,d))&&(i=n.contains(e.ownerDocument,e),f=ob(k.appendChild(e),"script"),i&&mb(f),c)){j=0;while(e=f[j++])fb.test(e.type||"")&&c.push(e)}return k},cleanData:function(a){for(var b,c,d,e,f=n.event.special,g=0;void 0!==(c=a[g]);g++){if(n.acceptData(c)&&(e=c[L.expando],e&&(b=L.cache[e]))){if(b.events)for(d in b.events)f[d]?n.event.remove(c,d):n.removeEvent(c,d,b.handle);L.cache[e]&&delete L.cache[e]}delete M.cache[c[M.expando]]}}}),n.fn.extend({text:function(a){return J(this,function(a){return void 0===a?n.text(this):this.empty().each(function(){(1===this.nodeType||11===this.nodeType||9===this.nodeType)&&(this.textContent=a)})},null,a,arguments.length)},append:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=jb(this,a);b.appendChild(a)}})},prepend:function(){return this.domManip(arguments,function(a){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var b=jb(this,a);b.insertBefore(a,b.firstChild)}})},before:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this)})},after:function(){return this.domManip(arguments,function(a){this.parentNode&&this.parentNode.insertBefore(a,this.nextSibling)})},remove:function(a,b){for(var c,d=a?n.filter(a,this):this,e=0;null!=(c=d[e]);e++)b||1!==c.nodeType||n.cleanData(ob(c)),c.parentNode&&(b&&n.contains(c.ownerDocument,c)&&mb(ob(c,"script")),c.parentNode.removeChild(c));return this},empty:function(){for(var a,b=0;null!=(a=this[b]);b++)1===a.nodeType&&(n.cleanData(ob(a,!1)),a.textContent="");return this},clone:function(a,b){return a=null==a?!1:a,b=null==b?a:b,this.map(function(){return n.clone(this,a,b)})},html:function(a){return J(this,function(a){var b=this[0]||{},c=0,d=this.length;if(void 0===a&&1===b.nodeType)return b.innerHTML;if("string"==typeof a&&!db.test(a)&&!ib[(bb.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(ab,"<$1></$2>");try{for(;d>c;c++)b=this[c]||{},1===b.nodeType&&(n.cleanData(ob(b,!1)),b.innerHTML=a);b=0}catch(e){}}b&&this.empty().append(a)},null,a,arguments.length)},replaceWith:function(){var a=arguments[0];return this.domManip(arguments,function(b){a=this.parentNode,n.cleanData(ob(this)),a&&a.replaceChild(b,this)}),a&&(a.length||a.nodeType)?this:this.remove()},detach:function(a){return this.remove(a,!0)},domManip:function(a,b){a=e.apply([],a);var c,d,f,g,h,i,j=0,l=this.length,m=this,o=l-1,p=a[0],q=n.isFunction(p);if(q||l>1&&"string"==typeof p&&!k.checkClone&&eb.test(p))return this.each(function(c){var d=m.eq(c);q&&(a[0]=p.call(this,c,d.html())),d.domManip(a,b)});if(l&&(c=n.buildFragment(a,this[0].ownerDocument,!1,this),d=c.firstChild,1===c.childNodes.length&&(c=d),d)){for(f=n.map(ob(c,"script"),kb),g=f.length;l>j;j++)h=c,j!==o&&(h=n.clone(h,!0,!0),g&&n.merge(f,ob(h,"script"))),b.call(this[j],h,j);if(g)for(i=f[f.length-1].ownerDocument,n.map(f,lb),j=0;g>j;j++)h=f[j],fb.test(h.type||"")&&!L.access(h,"globalEval")&&n.contains(i,h)&&(h.src?n._evalUrl&&n._evalUrl(h.src):n.globalEval(h.textContent.replace(hb,"")))}return this}}),n.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){n.fn[a]=function(a){for(var c,d=[],e=n(a),g=e.length-1,h=0;g>=h;h++)c=h===g?this:this.clone(!0),n(e[h])[b](c),f.apply(d,c.get());return this.pushStack(d)}});var qb,rb={};function sb(b,c){var d,e=n(c.createElement(b)).appendTo(c.body),f=a.getDefaultComputedStyle&&(d=a.getDefaultComputedStyle(e[0]))?d.display:n.css(e[0],"display");return e.detach(),f}function tb(a){var b=l,c=rb[a];return c||(c=sb(a,b),"none"!==c&&c||(qb=(qb||n("<iframe frameborder='0' width='0' height='0'/>")).appendTo(b.documentElement),b=qb[0].contentDocument,b.write(),b.close(),c=sb(a,b),qb.detach()),rb[a]=c),c}var ub=/^margin/,vb=new RegExp("^("+Q+")(?!px)[a-z%]+$","i"),wb=function(a){return a.ownerDocument.defaultView.getComputedStyle(a,null)};function xb(a,b,c){var d,e,f,g,h=a.style;return c=c||wb(a),c&&(g=c.getPropertyValue(b)||c[b]),c&&(""!==g||n.contains(a.ownerDocument,a)||(g=n.style(a,b)),vb.test(g)&&ub.test(b)&&(d=h.width,e=h.minWidth,f=h.maxWidth,h.minWidth=h.maxWidth=h.width=g,g=c.width,h.width=d,h.minWidth=e,h.maxWidth=f)),void 0!==g?g+"":g}function yb(a,b){return{get:function(){return a()?void delete this.get:(this.get=b).apply(this,arguments)}}}!function(){var b,c,d=l.documentElement,e=l.createElement("div"),f=l.createElement("div");if(f.style){f.style.backgroundClip="content-box",f.cloneNode(!0).style.backgroundClip="",k.clearCloneStyle="content-box"===f.style.backgroundClip,e.style.cssText="border:0;width:0;height:0;top:0;left:-9999px;margin-top:1px;position:absolute",e.appendChild(f);function g(){f.style.cssText="-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;display:block;margin-top:1%;top:1%;border:1px;padding:1px;width:4px;position:absolute",f.innerHTML="",d.appendChild(e);var g=a.getComputedStyle(f,null);b="1%"!==g.top,c="4px"===g.width,d.removeChild(e)}a.getComputedStyle&&n.extend(k,{pixelPosition:function(){return g(),b},boxSizingReliable:function(){return null==c&&g(),c},reliableMarginRight:function(){var b,c=f.appendChild(l.createElement("div"));return c.style.cssText=f.style.cssText="-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;display:block;margin:0;border:0;padding:0",c.style.marginRight=c.style.width="0",f.style.width="1px",d.appendChild(e),b=!parseFloat(a.getComputedStyle(c,null).marginRight),d.removeChild(e),b}})}}(),n.swap=function(a,b,c,d){var e,f,g={};for(f in b)g[f]=a.style[f],a.style[f]=b[f];e=c.apply(a,d||[]);for(f in b)a.style[f]=g[f];return e};var zb=/^(none|table(?!-c[ea]).+)/,Ab=new RegExp("^("+Q+")(.*)$","i"),Bb=new RegExp("^([+-])=("+Q+")","i"),Cb={position:"absolute",visibility:"hidden",display:"block"},Db={letterSpacing:"0",fontWeight:"400"},Eb=["Webkit","O","Moz","ms"];function Fb(a,b){if(b in a)return b;var c=b[0].toUpperCase()+b.slice(1),d=b,e=Eb.length;while(e--)if(b=Eb[e]+c,b in a)return b;return d}function Gb(a,b,c){var d=Ab.exec(b);return d?Math.max(0,d[1]-(c||0))+(d[2]||"px"):b}function Hb(a,b,c,d,e){for(var f=c===(d?"border":"content")?4:"width"===b?1:0,g=0;4>f;f+=2)"margin"===c&&(g+=n.css(a,c+R[f],!0,e)),d?("content"===c&&(g-=n.css(a,"padding"+R[f],!0,e)),"margin"!==c&&(g-=n.css(a,"border"+R[f]+"Width",!0,e))):(g+=n.css(a,"padding"+R[f],!0,e),"padding"!==c&&(g+=n.css(a,"border"+R[f]+"Width",!0,e)));return g}function Ib(a,b,c){var d=!0,e="width"===b?a.offsetWidth:a.offsetHeight,f=wb(a),g="border-box"===n.css(a,"boxSizing",!1,f);if(0>=e||null==e){if(e=xb(a,b,f),(0>e||null==e)&&(e=a.style[b]),vb.test(e))return e;d=g&&(k.boxSizingReliable()||e===a.style[b]),e=parseFloat(e)||0}return e+Hb(a,b,c||(g?"border":"content"),d,f)+"px"}function Jb(a,b){for(var c,d,e,f=[],g=0,h=a.length;h>g;g++)d=a[g],d.style&&(f[g]=L.get(d,"olddisplay"),c=d.style.display,b?(f[g]||"none"!==c||(d.style.display=""),""===d.style.display&&S(d)&&(f[g]=L.access(d,"olddisplay",tb(d.nodeName)))):(e=S(d),"none"===c&&e||L.set(d,"olddisplay",e?c:n.css(d,"display"))));for(g=0;h>g;g++)d=a[g],d.style&&(b&&"none"!==d.style.display&&""!==d.style.display||(d.style.display=b?f[g]||"":"none"));return a}n.extend({cssHooks:{opacity:{get:function(a,b){if(b){var c=xb(a,"opacity");return""===c?"1":c}}}},cssNumber:{columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":"cssFloat"},style:function(a,b,c,d){if(a&&3!==a.nodeType&&8!==a.nodeType&&a.style){var e,f,g,h=n.camelCase(b),i=a.style;return b=n.cssProps[h]||(n.cssProps[h]=Fb(i,h)),g=n.cssHooks[b]||n.cssHooks[h],void 0===c?g&&"get"in g&&void 0!==(e=g.get(a,!1,d))?e:i[b]:(f=typeof c,"string"===f&&(e=Bb.exec(c))&&(c=(e[1]+1)*e[2]+parseFloat(n.css(a,b)),f="number"),null!=c&&c===c&&("number"!==f||n.cssNumber[h]||(c+="px"),k.clearCloneStyle||""!==c||0!==b.indexOf("background")||(i[b]="inherit"),g&&"set"in g&&void 0===(c=g.set(a,c,d))||(i[b]=c)),void 0)}},css:function(a,b,c,d){var e,f,g,h=n.camelCase(b);return b=n.cssProps[h]||(n.cssProps[h]=Fb(a.style,h)),g=n.cssHooks[b]||n.cssHooks[h],g&&"get"in g&&(e=g.get(a,!0,c)),void 0===e&&(e=xb(a,b,d)),"normal"===e&&b in Db&&(e=Db[b]),""===c||c?(f=parseFloat(e),c===!0||n.isNumeric(f)?f||0:e):e}}),n.each(["height","width"],function(a,b){n.cssHooks[b]={get:function(a,c,d){return c?zb.test(n.css(a,"display"))&&0===a.offsetWidth?n.swap(a,Cb,function(){return Ib(a,b,d)}):Ib(a,b,d):void 0},set:function(a,c,d){var e=d&&wb(a);return Gb(a,c,d?Hb(a,b,d,"border-box"===n.css(a,"boxSizing",!1,e),e):0)}}}),n.cssHooks.marginRight=yb(k.reliableMarginRight,function(a,b){return b?n.swap(a,{display:"inline-block"},xb,[a,"marginRight"]):void 0}),n.each({margin:"",padding:"",border:"Width"},function(a,b){n.cssHooks[a+b]={expand:function(c){for(var d=0,e={},f="string"==typeof c?c.split(" "):[c];4>d;d++)e[a+R[d]+b]=f[d]||f[d-2]||f[0];return e}},ub.test(a)||(n.cssHooks[a+b].set=Gb)}),n.fn.extend({css:function(a,b){return J(this,function(a,b,c){var d,e,f={},g=0;if(n.isArray(b)){for(d=wb(a),e=b.length;e>g;g++)f[b[g]]=n.css(a,b[g],!1,d);return f}return void 0!==c?n.style(a,b,c):n.css(a,b)},a,b,arguments.length>1)},show:function(){return Jb(this,!0)},hide:function(){return Jb(this)},toggle:function(a){return"boolean"==typeof a?a?this.show():this.hide():this.each(function(){S(this)?n(this).show():n(this).hide()})}});function Kb(a,b,c,d,e){return new Kb.prototype.init(a,b,c,d,e)}n.Tween=Kb,Kb.prototype={constructor:Kb,init:function(a,b,c,d,e,f){this.elem=a,this.prop=c,this.easing=e||"swing",this.options=b,this.start=this.now=this.cur(),this.end=d,this.unit=f||(n.cssNumber[c]?"":"px")},cur:function(){var a=Kb.propHooks[this.prop];return a&&a.get?a.get(this):Kb.propHooks._default.get(this)},run:function(a){var b,c=Kb.propHooks[this.prop];return this.pos=b=this.options.duration?n.easing[this.easing](a,this.options.duration*a,0,1,this.options.duration):a,this.now=(this.end-this.start)*b+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),c&&c.set?c.set(this):Kb.propHooks._default.set(this),this}},Kb.prototype.init.prototype=Kb.prototype,Kb.propHooks={_default:{get:function(a){var b;return null==a.elem[a.prop]||a.elem.style&&null!=a.elem.style[a.prop]?(b=n.css(a.elem,a.prop,""),b&&"auto"!==b?b:0):a.elem[a.prop]},set:function(a){n.fx.step[a.prop]?n.fx.step[a.prop](a):a.elem.style&&(null!=a.elem.style[n.cssProps[a.prop]]||n.cssHooks[a.prop])?n.style(a.elem,a.prop,a.now+a.unit):a.elem[a.prop]=a.now}}},Kb.propHooks.scrollTop=Kb.propHooks.scrollLeft={set:function(a){a.elem.nodeType&&a.elem.parentNode&&(a.elem[a.prop]=a.now)}},n.easing={linear:function(a){return a},swing:function(a){return.5-Math.cos(a*Math.PI)/2}},n.fx=Kb.prototype.init,n.fx.step={};var Lb,Mb,Nb=/^(?:toggle|show|hide)$/,Ob=new RegExp("^(?:([+-])=|)("+Q+")([a-z%]*)$","i"),Pb=/queueHooks$/,Qb=[Vb],Rb={"*":[function(a,b){var c=this.createTween(a,b),d=c.cur(),e=Ob.exec(b),f=e&&e[3]||(n.cssNumber[a]?"":"px"),g=(n.cssNumber[a]||"px"!==f&&+d)&&Ob.exec(n.css(c.elem,a)),h=1,i=20;if(g&&g[3]!==f){f=f||g[3],e=e||[],g=+d||1;do h=h||".5",g/=h,n.style(c.elem,a,g+f);while(h!==(h=c.cur()/d)&&1!==h&&--i)}return e&&(g=c.start=+g||+d||0,c.unit=f,c.end=e[1]?g+(e[1]+1)*e[2]:+e[2]),c}]};function Sb(){return setTimeout(function(){Lb=void 0}),Lb=n.now()}function Tb(a,b){var c,d=0,e={height:a};for(b=b?1:0;4>d;d+=2-b)c=R[d],e["margin"+c]=e["padding"+c]=a;return b&&(e.opacity=e.width=a),e}function Ub(a,b,c){for(var d,e=(Rb[b]||[]).concat(Rb["*"]),f=0,g=e.length;g>f;f++)if(d=e[f].call(c,b,a))return d}function Vb(a,b,c){var d,e,f,g,h,i,j,k,l=this,m={},o=a.style,p=a.nodeType&&S(a),q=L.get(a,"fxshow");c.queue||(h=n._queueHooks(a,"fx"),null==h.unqueued&&(h.unqueued=0,i=h.empty.fire,h.empty.fire=function(){h.unqueued||i()}),h.unqueued++,l.always(function(){l.always(function(){h.unqueued--,n.queue(a,"fx").length||h.empty.fire()})})),1===a.nodeType&&("height"in b||"width"in b)&&(c.overflow=[o.overflow,o.overflowX,o.overflowY],j=n.css(a,"display"),k="none"===j?L.get(a,"olddisplay")||tb(a.nodeName):j,"inline"===k&&"none"===n.css(a,"float")&&(o.display="inline-block")),c.overflow&&(o.overflow="hidden",l.always(function(){o.overflow=c.overflow[0],o.overflowX=c.overflow[1],o.overflowY=c.overflow[2]}));for(d in b)if(e=b[d],Nb.exec(e)){if(delete b[d],f=f||"toggle"===e,e===(p?"hide":"show")){if("show"!==e||!q||void 0===q[d])continue;p=!0}m[d]=q&&q[d]||n.style(a,d)}else j=void 0;if(n.isEmptyObject(m))"inline"===("none"===j?tb(a.nodeName):j)&&(o.display=j);else{q?"hidden"in q&&(p=q.hidden):q=L.access(a,"fxshow",{}),f&&(q.hidden=!p),p?n(a).show():l.done(function(){n(a).hide()}),l.done(function(){var b;L.remove(a,"fxshow");for(b in m)n.style(a,b,m[b])});for(d in m)g=Ub(p?q[d]:0,d,l),d in q||(q[d]=g.start,p&&(g.end=g.start,g.start="width"===d||"height"===d?1:0))}}function Wb(a,b){var c,d,e,f,g;for(c in a)if(d=n.camelCase(c),e=b[d],f=a[c],n.isArray(f)&&(e=f[1],f=a[c]=f[0]),c!==d&&(a[d]=f,delete a[c]),g=n.cssHooks[d],g&&"expand"in g){f=g.expand(f),delete a[d];for(c in f)c in a||(a[c]=f[c],b[c]=e)}else b[d]=e}function Xb(a,b,c){var d,e,f=0,g=Qb.length,h=n.Deferred().always(function(){delete i.elem}),i=function(){if(e)return!1;for(var b=Lb||Sb(),c=Math.max(0,j.startTime+j.duration-b),d=c/j.duration||0,f=1-d,g=0,i=j.tweens.length;i>g;g++)j.tweens[g].run(f);return h.notifyWith(a,[j,f,c]),1>f&&i?c:(h.resolveWith(a,[j]),!1)},j=h.promise({elem:a,props:n.extend({},b),opts:n.extend(!0,{specialEasing:{}},c),originalProperties:b,originalOptions:c,startTime:Lb||Sb(),duration:c.duration,tweens:[],createTween:function(b,c){var d=n.Tween(a,j.opts,b,c,j.opts.specialEasing[b]||j.opts.easing);return j.tweens.push(d),d},stop:function(b){var c=0,d=b?j.tweens.length:0;if(e)return this;for(e=!0;d>c;c++)j.tweens[c].run(1);return b?h.resolveWith(a,[j,b]):h.rejectWith(a,[j,b]),this}}),k=j.props;for(Wb(k,j.opts.specialEasing);g>f;f++)if(d=Qb[f].call(j,a,k,j.opts))return d;return n.map(k,Ub,j),n.isFunction(j.opts.start)&&j.opts.start.call(a,j),n.fx.timer(n.extend(i,{elem:a,anim:j,queue:j.opts.queue})),j.progress(j.opts.progress).done(j.opts.done,j.opts.complete).fail(j.opts.fail).always(j.opts.always)}n.Animation=n.extend(Xb,{tweener:function(a,b){n.isFunction(a)?(b=a,a=["*"]):a=a.split(" ");for(var c,d=0,e=a.length;e>d;d++)c=a[d],Rb[c]=Rb[c]||[],Rb[c].unshift(b)},prefilter:function(a,b){b?Qb.unshift(a):Qb.push(a)}}),n.speed=function(a,b,c){var d=a&&"object"==typeof a?n.extend({},a):{complete:c||!c&&b||n.isFunction(a)&&a,duration:a,easing:c&&b||b&&!n.isFunction(b)&&b};return d.duration=n.fx.off?0:"number"==typeof d.duration?d.duration:d.duration in n.fx.speeds?n.fx.speeds[d.duration]:n.fx.speeds._default,(null==d.queue||d.queue===!0)&&(d.queue="fx"),d.old=d.complete,d.complete=function(){n.isFunction(d.old)&&d.old.call(this),d.queue&&n.dequeue(this,d.queue)},d},n.fn.extend({fadeTo:function(a,b,c,d){return this.filter(S).css("opacity",0).show().end().animate({opacity:b},a,c,d)},animate:function(a,b,c,d){var e=n.isEmptyObject(a),f=n.speed(b,c,d),g=function(){var b=Xb(this,n.extend({},a),f);(e||L.get(this,"finish"))&&b.stop(!0)};return g.finish=g,e||f.queue===!1?this.each(g):this.queue(f.queue,g)},stop:function(a,b,c){var d=function(a){var b=a.stop;delete a.stop,b(c)};return"string"!=typeof a&&(c=b,b=a,a=void 0),b&&a!==!1&&this.queue(a||"fx",[]),this.each(function(){var b=!0,e=null!=a&&a+"queueHooks",f=n.timers,g=L.get(this);if(e)g[e]&&g[e].stop&&d(g[e]);else for(e in g)g[e]&&g[e].stop&&Pb.test(e)&&d(g[e]);for(e=f.length;e--;)f[e].elem!==this||null!=a&&f[e].queue!==a||(f[e].anim.stop(c),b=!1,f.splice(e,1));(b||!c)&&n.dequeue(this,a)})},finish:function(a){return a!==!1&&(a=a||"fx"),this.each(function(){var b,c=L.get(this),d=c[a+"queue"],e=c[a+"queueHooks"],f=n.timers,g=d?d.length:0;for(c.finish=!0,n.queue(this,a,[]),e&&e.stop&&e.stop.call(this,!0),b=f.length;b--;)f[b].elem===this&&f[b].queue===a&&(f[b].anim.stop(!0),f.splice(b,1));for(b=0;g>b;b++)d[b]&&d[b].finish&&d[b].finish.call(this);delete c.finish})}}),n.each(["toggle","show","hide"],function(a,b){var c=n.fn[b];n.fn[b]=function(a,d,e){return null==a||"boolean"==typeof a?c.apply(this,arguments):this.animate(Tb(b,!0),a,d,e)}}),n.each({slideDown:Tb("show"),slideUp:Tb("hide"),slideToggle:Tb("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(a,b){n.fn[a]=function(a,c,d){return this.animate(b,a,c,d)}}),n.timers=[],n.fx.tick=function(){var a,b=0,c=n.timers;for(Lb=n.now();b<c.length;b++)a=c[b],a()||c[b]!==a||c.splice(b--,1);c.length||n.fx.stop(),Lb=void 0},n.fx.timer=function(a){n.timers.push(a),a()?n.fx.start():n.timers.pop()},n.fx.interval=13,n.fx.start=function(){Mb||(Mb=setInterval(n.fx.tick,n.fx.interval))},n.fx.stop=function(){clearInterval(Mb),Mb=null},n.fx.speeds={slow:600,fast:200,_default:400},n.fn.delay=function(a,b){return a=n.fx?n.fx.speeds[a]||a:a,b=b||"fx",this.queue(b,function(b,c){var d=setTimeout(b,a);c.stop=function(){clearTimeout(d)}})},function(){var a=l.createElement("input"),b=l.createElement("select"),c=b.appendChild(l.createElement("option"));a.type="checkbox",k.checkOn=""!==a.value,k.optSelected=c.selected,b.disabled=!0,k.optDisabled=!c.disabled,a=l.createElement("input"),a.value="t",a.type="radio",k.radioValue="t"===a.value}();var Yb,Zb,$b=n.expr.attrHandle;n.fn.extend({attr:function(a,b){return J(this,n.attr,a,b,arguments.length>1)},removeAttr:function(a){return this.each(function(){n.removeAttr(this,a)})}}),n.extend({attr:function(a,b,c){var d,e,f=a.nodeType;if(a&&3!==f&&8!==f&&2!==f)return typeof a.getAttribute===U?n.prop(a,b,c):(1===f&&n.isXMLDoc(a)||(b=b.toLowerCase(),d=n.attrHooks[b]||(n.expr.match.bool.test(b)?Zb:Yb)),void 0===c?d&&"get"in d&&null!==(e=d.get(a,b))?e:(e=n.find.attr(a,b),null==e?void 0:e):null!==c?d&&"set"in d&&void 0!==(e=d.set(a,c,b))?e:(a.setAttribute(b,c+""),c):void n.removeAttr(a,b))
-},removeAttr:function(a,b){var c,d,e=0,f=b&&b.match(E);if(f&&1===a.nodeType)while(c=f[e++])d=n.propFix[c]||c,n.expr.match.bool.test(c)&&(a[d]=!1),a.removeAttribute(c)},attrHooks:{type:{set:function(a,b){if(!k.radioValue&&"radio"===b&&n.nodeName(a,"input")){var c=a.value;return a.setAttribute("type",b),c&&(a.value=c),b}}}}}),Zb={set:function(a,b,c){return b===!1?n.removeAttr(a,c):a.setAttribute(c,c),c}},n.each(n.expr.match.bool.source.match(/\w+/g),function(a,b){var c=$b[b]||n.find.attr;$b[b]=function(a,b,d){var e,f;return d||(f=$b[b],$b[b]=e,e=null!=c(a,b,d)?b.toLowerCase():null,$b[b]=f),e}});var _b=/^(?:input|select|textarea|button)$/i;n.fn.extend({prop:function(a,b){return J(this,n.prop,a,b,arguments.length>1)},removeProp:function(a){return this.each(function(){delete this[n.propFix[a]||a]})}}),n.extend({propFix:{"for":"htmlFor","class":"className"},prop:function(a,b,c){var d,e,f,g=a.nodeType;if(a&&3!==g&&8!==g&&2!==g)return f=1!==g||!n.isXMLDoc(a),f&&(b=n.propFix[b]||b,e=n.propHooks[b]),void 0!==c?e&&"set"in e&&void 0!==(d=e.set(a,c,b))?d:a[b]=c:e&&"get"in e&&null!==(d=e.get(a,b))?d:a[b]},propHooks:{tabIndex:{get:function(a){return a.hasAttribute("tabindex")||_b.test(a.nodeName)||a.href?a.tabIndex:-1}}}}),k.optSelected||(n.propHooks.selected={get:function(a){var b=a.parentNode;return b&&b.parentNode&&b.parentNode.selectedIndex,null}}),n.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){n.propFix[this.toLowerCase()]=this});var ac=/[\t\r\n\f]/g;n.fn.extend({addClass:function(a){var b,c,d,e,f,g,h="string"==typeof a&&a,i=0,j=this.length;if(n.isFunction(a))return this.each(function(b){n(this).addClass(a.call(this,b,this.className))});if(h)for(b=(a||"").match(E)||[];j>i;i++)if(c=this[i],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(ac," "):" ")){f=0;while(e=b[f++])d.indexOf(" "+e+" ")<0&&(d+=e+" ");g=n.trim(d),c.className!==g&&(c.className=g)}return this},removeClass:function(a){var b,c,d,e,f,g,h=0===arguments.length||"string"==typeof a&&a,i=0,j=this.length;if(n.isFunction(a))return this.each(function(b){n(this).removeClass(a.call(this,b,this.className))});if(h)for(b=(a||"").match(E)||[];j>i;i++)if(c=this[i],d=1===c.nodeType&&(c.className?(" "+c.className+" ").replace(ac," "):"")){f=0;while(e=b[f++])while(d.indexOf(" "+e+" ")>=0)d=d.replace(" "+e+" "," ");g=a?n.trim(d):"",c.className!==g&&(c.className=g)}return this},toggleClass:function(a,b){var c=typeof a;return"boolean"==typeof b&&"string"===c?b?this.addClass(a):this.removeClass(a):this.each(n.isFunction(a)?function(c){n(this).toggleClass(a.call(this,c,this.className,b),b)}:function(){if("string"===c){var b,d=0,e=n(this),f=a.match(E)||[];while(b=f[d++])e.hasClass(b)?e.removeClass(b):e.addClass(b)}else(c===U||"boolean"===c)&&(this.className&&L.set(this,"__className__",this.className),this.className=this.className||a===!1?"":L.get(this,"__className__")||"")})},hasClass:function(a){for(var b=" "+a+" ",c=0,d=this.length;d>c;c++)if(1===this[c].nodeType&&(" "+this[c].className+" ").replace(ac," ").indexOf(b)>=0)return!0;return!1}});var bc=/\r/g;n.fn.extend({val:function(a){var b,c,d,e=this[0];{if(arguments.length)return d=n.isFunction(a),this.each(function(c){var e;1===this.nodeType&&(e=d?a.call(this,c,n(this).val()):a,null==e?e="":"number"==typeof e?e+="":n.isArray(e)&&(e=n.map(e,function(a){return null==a?"":a+""})),b=n.valHooks[this.type]||n.valHooks[this.nodeName.toLowerCase()],b&&"set"in b&&void 0!==b.set(this,e,"value")||(this.value=e))});if(e)return b=n.valHooks[e.type]||n.valHooks[e.nodeName.toLowerCase()],b&&"get"in b&&void 0!==(c=b.get(e,"value"))?c:(c=e.value,"string"==typeof c?c.replace(bc,""):null==c?"":c)}}}),n.extend({valHooks:{option:{get:function(a){var b=n.find.attr(a,"value");return null!=b?b:n.trim(n.text(a))}},select:{get:function(a){for(var b,c,d=a.options,e=a.selectedIndex,f="select-one"===a.type||0>e,g=f?null:[],h=f?e+1:d.length,i=0>e?h:f?e:0;h>i;i++)if(c=d[i],!(!c.selected&&i!==e||(k.optDisabled?c.disabled:null!==c.getAttribute("disabled"))||c.parentNode.disabled&&n.nodeName(c.parentNode,"optgroup"))){if(b=n(c).val(),f)return b;g.push(b)}return g},set:function(a,b){var c,d,e=a.options,f=n.makeArray(b),g=e.length;while(g--)d=e[g],(d.selected=n.inArray(d.value,f)>=0)&&(c=!0);return c||(a.selectedIndex=-1),f}}}}),n.each(["radio","checkbox"],function(){n.valHooks[this]={set:function(a,b){return n.isArray(b)?a.checked=n.inArray(n(a).val(),b)>=0:void 0}},k.checkOn||(n.valHooks[this].get=function(a){return null===a.getAttribute("value")?"on":a.value})}),n.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(a,b){n.fn[b]=function(a,c){return arguments.length>0?this.on(b,null,a,c):this.trigger(b)}}),n.fn.extend({hover:function(a,b){return this.mouseenter(a).mouseleave(b||a)},bind:function(a,b,c){return this.on(a,null,b,c)},unbind:function(a,b){return this.off(a,null,b)},delegate:function(a,b,c,d){return this.on(b,a,c,d)},undelegate:function(a,b,c){return 1===arguments.length?this.off(a,"**"):this.off(b,a||"**",c)}});var cc=n.now(),dc=/\?/;n.parseJSON=function(a){return JSON.parse(a+"")},n.parseXML=function(a){var b,c;if(!a||"string"!=typeof a)return null;try{c=new DOMParser,b=c.parseFromString(a,"text/xml")}catch(d){b=void 0}return(!b||b.getElementsByTagName("parsererror").length)&&n.error("Invalid XML: "+a),b};var ec,fc,gc=/#.*$/,hc=/([?&])_=[^&]*/,ic=/^(.*?):[ \t]*([^\r\n]*)$/gm,jc=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,kc=/^(?:GET|HEAD)$/,lc=/^\/\//,mc=/^([\w.+-]+:)(?:\/\/(?:[^\/?#]*@|)([^\/?#:]*)(?::(\d+)|)|)/,nc={},oc={},pc="*/".concat("*");try{fc=location.href}catch(qc){fc=l.createElement("a"),fc.href="",fc=fc.href}ec=mc.exec(fc.toLowerCase())||[];function rc(a){return function(b,c){"string"!=typeof b&&(c=b,b="*");var d,e=0,f=b.toLowerCase().match(E)||[];if(n.isFunction(c))while(d=f[e++])"+"===d[0]?(d=d.slice(1)||"*",(a[d]=a[d]||[]).unshift(c)):(a[d]=a[d]||[]).push(c)}}function sc(a,b,c,d){var e={},f=a===oc;function g(h){var i;return e[h]=!0,n.each(a[h]||[],function(a,h){var j=h(b,c,d);return"string"!=typeof j||f||e[j]?f?!(i=j):void 0:(b.dataTypes.unshift(j),g(j),!1)}),i}return g(b.dataTypes[0])||!e["*"]&&g("*")}function tc(a,b){var c,d,e=n.ajaxSettings.flatOptions||{};for(c in b)void 0!==b[c]&&((e[c]?a:d||(d={}))[c]=b[c]);return d&&n.extend(!0,a,d),a}function uc(a,b,c){var d,e,f,g,h=a.contents,i=a.dataTypes;while("*"===i[0])i.shift(),void 0===d&&(d=a.mimeType||b.getResponseHeader("Content-Type"));if(d)for(e in h)if(h[e]&&h[e].test(d)){i.unshift(e);break}if(i[0]in c)f=i[0];else{for(e in c){if(!i[0]||a.converters[e+" "+i[0]]){f=e;break}g||(g=e)}f=f||g}return f?(f!==i[0]&&i.unshift(f),c[f]):void 0}function vc(a,b,c,d){var e,f,g,h,i,j={},k=a.dataTypes.slice();if(k[1])for(g in a.converters)j[g.toLowerCase()]=a.converters[g];f=k.shift();while(f)if(a.responseFields[f]&&(c[a.responseFields[f]]=b),!i&&d&&a.dataFilter&&(b=a.dataFilter(b,a.dataType)),i=f,f=k.shift())if("*"===f)f=i;else if("*"!==i&&i!==f){if(g=j[i+" "+f]||j["* "+f],!g)for(e in j)if(h=e.split(" "),h[1]===f&&(g=j[i+" "+h[0]]||j["* "+h[0]])){g===!0?g=j[e]:j[e]!==!0&&(f=h[0],k.unshift(h[1]));break}if(g!==!0)if(g&&a["throws"])b=g(b);else try{b=g(b)}catch(l){return{state:"parsererror",error:g?l:"No conversion from "+i+" to "+f}}}return{state:"success",data:b}}n.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:fc,type:"GET",isLocal:jc.test(ec[1]),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":pc,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":n.parseJSON,"text xml":n.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(a,b){return b?tc(tc(a,n.ajaxSettings),b):tc(n.ajaxSettings,a)},ajaxPrefilter:rc(nc),ajaxTransport:rc(oc),ajax:function(a,b){"object"==typeof a&&(b=a,a=void 0),b=b||{};var c,d,e,f,g,h,i,j,k=n.ajaxSetup({},b),l=k.context||k,m=k.context&&(l.nodeType||l.jquery)?n(l):n.event,o=n.Deferred(),p=n.Callbacks("once memory"),q=k.statusCode||{},r={},s={},t=0,u="canceled",v={readyState:0,getResponseHeader:function(a){var b;if(2===t){if(!f){f={};while(b=ic.exec(e))f[b[1].toLowerCase()]=b[2]}b=f[a.toLowerCase()]}return null==b?null:b},getAllResponseHeaders:function(){return 2===t?e:null},setRequestHeader:function(a,b){var c=a.toLowerCase();return t||(a=s[c]=s[c]||a,r[a]=b),this},overrideMimeType:function(a){return t||(k.mimeType=a),this},statusCode:function(a){var b;if(a)if(2>t)for(b in a)q[b]=[q[b],a[b]];else v.always(a[v.status]);return this},abort:function(a){var b=a||u;return c&&c.abort(b),x(0,b),this}};if(o.promise(v).complete=p.add,v.success=v.done,v.error=v.fail,k.url=((a||k.url||fc)+"").replace(gc,"").replace(lc,ec[1]+"//"),k.type=b.method||b.type||k.method||k.type,k.dataTypes=n.trim(k.dataType||"*").toLowerCase().match(E)||[""],null==k.crossDomain&&(h=mc.exec(k.url.toLowerCase()),k.crossDomain=!(!h||h[1]===ec[1]&&h[2]===ec[2]&&(h[3]||("http:"===h[1]?"80":"443"))===(ec[3]||("http:"===ec[1]?"80":"443")))),k.data&&k.processData&&"string"!=typeof k.data&&(k.data=n.param(k.data,k.traditional)),sc(nc,k,b,v),2===t)return v;i=k.global,i&&0===n.active++&&n.event.trigger("ajaxStart"),k.type=k.type.toUpperCase(),k.hasContent=!kc.test(k.type),d=k.url,k.hasContent||(k.data&&(d=k.url+=(dc.test(d)?"&":"?")+k.data,delete k.data),k.cache===!1&&(k.url=hc.test(d)?d.replace(hc,"$1_="+cc++):d+(dc.test(d)?"&":"?")+"_="+cc++)),k.ifModified&&(n.lastModified[d]&&v.setRequestHeader("If-Modified-Since",n.lastModified[d]),n.etag[d]&&v.setRequestHeader("If-None-Match",n.etag[d])),(k.data&&k.hasContent&&k.contentType!==!1||b.contentType)&&v.setRequestHeader("Content-Type",k.contentType),v.setRequestHeader("Accept",k.dataTypes[0]&&k.accepts[k.dataTypes[0]]?k.accepts[k.dataTypes[0]]+("*"!==k.dataTypes[0]?", "+pc+"; q=0.01":""):k.accepts["*"]);for(j in k.headers)v.setRequestHeader(j,k.headers[j]);if(k.beforeSend&&(k.beforeSend.call(l,v,k)===!1||2===t))return v.abort();u="abort";for(j in{success:1,error:1,complete:1})v[j](k[j]);if(c=sc(oc,k,b,v)){v.readyState=1,i&&m.trigger("ajaxSend",[v,k]),k.async&&k.timeout>0&&(g=setTimeout(function(){v.abort("timeout")},k.timeout));try{t=1,c.send(r,x)}catch(w){if(!(2>t))throw w;x(-1,w)}}else x(-1,"No Transport");function x(a,b,f,h){var j,r,s,u,w,x=b;2!==t&&(t=2,g&&clearTimeout(g),c=void 0,e=h||"",v.readyState=a>0?4:0,j=a>=200&&300>a||304===a,f&&(u=uc(k,v,f)),u=vc(k,u,v,j),j?(k.ifModified&&(w=v.getResponseHeader("Last-Modified"),w&&(n.lastModified[d]=w),w=v.getResponseHeader("etag"),w&&(n.etag[d]=w)),204===a||"HEAD"===k.type?x="nocontent":304===a?x="notmodified":(x=u.state,r=u.data,s=u.error,j=!s)):(s=x,(a||!x)&&(x="error",0>a&&(a=0))),v.status=a,v.statusText=(b||x)+"",j?o.resolveWith(l,[r,x,v]):o.rejectWith(l,[v,x,s]),v.statusCode(q),q=void 0,i&&m.trigger(j?"ajaxSuccess":"ajaxError",[v,k,j?r:s]),p.fireWith(l,[v,x]),i&&(m.trigger("ajaxComplete",[v,k]),--n.active||n.event.trigger("ajaxStop")))}return v},getJSON:function(a,b,c){return n.get(a,b,c,"json")},getScript:function(a,b){return n.get(a,void 0,b,"script")}}),n.each(["get","post"],function(a,b){n[b]=function(a,c,d,e){return n.isFunction(c)&&(e=e||d,d=c,c=void 0),n.ajax({url:a,type:b,dataType:e,data:c,success:d})}}),n.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(a,b){n.fn[b]=function(a){return this.on(b,a)}}),n._evalUrl=function(a){return n.ajax({url:a,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})},n.fn.extend({wrapAll:function(a){var b;return n.isFunction(a)?this.each(function(b){n(this).wrapAll(a.call(this,b))}):(this[0]&&(b=n(a,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstElementChild)a=a.firstElementChild;return a}).append(this)),this)},wrapInner:function(a){return this.each(n.isFunction(a)?function(b){n(this).wrapInner(a.call(this,b))}:function(){var b=n(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=n.isFunction(a);return this.each(function(c){n(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){n.nodeName(this,"body")||n(this).replaceWith(this.childNodes)}).end()}}),n.expr.filters.hidden=function(a){return a.offsetWidth<=0&&a.offsetHeight<=0},n.expr.filters.visible=function(a){return!n.expr.filters.hidden(a)};var wc=/%20/g,xc=/\[\]$/,yc=/\r?\n/g,zc=/^(?:submit|button|image|reset|file)$/i,Ac=/^(?:input|select|textarea|keygen)/i;function Bc(a,b,c,d){var e;if(n.isArray(b))n.each(b,function(b,e){c||xc.test(a)?d(a,e):Bc(a+"["+("object"==typeof e?b:"")+"]",e,c,d)});else if(c||"object"!==n.type(b))d(a,b);else for(e in b)Bc(a+"["+e+"]",b[e],c,d)}n.param=function(a,b){var c,d=[],e=function(a,b){b=n.isFunction(b)?b():null==b?"":b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};if(void 0===b&&(b=n.ajaxSettings&&n.ajaxSettings.traditional),n.isArray(a)||a.jquery&&!n.isPlainObject(a))n.each(a,function(){e(this.name,this.value)});else for(c in a)Bc(c,a[c],b,e);return d.join("&").replace(wc,"+")},n.fn.extend({serialize:function(){return n.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var a=n.prop(this,"elements");return a?n.makeArray(a):this}).filter(function(){var a=this.type;return this.name&&!n(this).is(":disabled")&&Ac.test(this.nodeName)&&!zc.test(a)&&(this.checked||!T.test(a))}).map(function(a,b){var c=n(this).val();return null==c?null:n.isArray(c)?n.map(c,function(a){return{name:b.name,value:a.replace(yc,"\r\n")}}):{name:b.name,value:c.replace(yc,"\r\n")}}).get()}}),n.ajaxSettings.xhr=function(){try{return new XMLHttpRequest}catch(a){}};var Cc=0,Dc={},Ec={0:200,1223:204},Fc=n.ajaxSettings.xhr();a.ActiveXObject&&n(a).on("unload",function(){for(var a in Dc)Dc[a]()}),k.cors=!!Fc&&"withCredentials"in Fc,k.ajax=Fc=!!Fc,n.ajaxTransport(function(a){var b;return k.cors||Fc&&!a.crossDomain?{send:function(c,d){var e,f=a.xhr(),g=++Cc;if(f.open(a.type,a.url,a.async,a.username,a.password),a.xhrFields)for(e in a.xhrFields)f[e]=a.xhrFields[e];a.mimeType&&f.overrideMimeType&&f.overrideMimeType(a.mimeType),a.crossDomain||c["X-Requested-With"]||(c["X-Requested-With"]="XMLHttpRequest");for(e in c)f.setRequestHeader(e,c[e]);b=function(a){return function(){b&&(delete Dc[g],b=f.onload=f.onerror=null,"abort"===a?f.abort():"error"===a?d(f.status,f.statusText):d(Ec[f.status]||f.status,f.statusText,"string"==typeof f.responseText?{text:f.responseText}:void 0,f.getAllResponseHeaders()))}},f.onload=b(),f.onerror=b("error"),b=Dc[g]=b("abort");try{f.send(a.hasContent&&a.data||null)}catch(h){if(b)throw h}},abort:function(){b&&b()}}:void 0}),n.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/(?:java|ecma)script/},converters:{"text script":function(a){return n.globalEval(a),a}}}),n.ajaxPrefilter("script",function(a){void 0===a.cache&&(a.cache=!1),a.crossDomain&&(a.type="GET")}),n.ajaxTransport("script",function(a){if(a.crossDomain){var b,c;return{send:function(d,e){b=n("<script>").prop({async:!0,charset:a.scriptCharset,src:a.url}).on("load error",c=function(a){b.remove(),c=null,a&&e("error"===a.type?404:200,a.type)}),l.head.appendChild(b[0])},abort:function(){c&&c()}}}});var Gc=[],Hc=/(=)\?(?=&|$)|\?\?/;n.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var a=Gc.pop()||n.expando+"_"+cc++;return this[a]=!0,a}}),n.ajaxPrefilter("json jsonp",function(b,c,d){var e,f,g,h=b.jsonp!==!1&&(Hc.test(b.url)?"url":"string"==typeof b.data&&!(b.contentType||"").indexOf("application/x-www-form-urlencoded")&&Hc.test(b.data)&&"data");return h||"jsonp"===b.dataTypes[0]?(e=b.jsonpCallback=n.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,h?b[h]=b[h].replace(Hc,"$1"+e):b.jsonp!==!1&&(b.url+=(dc.test(b.url)?"&":"?")+b.jsonp+"="+e),b.converters["script json"]=function(){return g||n.error(e+" was not called"),g[0]},b.dataTypes[0]="json",f=a[e],a[e]=function(){g=arguments},d.always(function(){a[e]=f,b[e]&&(b.jsonpCallback=c.jsonpCallback,Gc.push(e)),g&&n.isFunction(f)&&f(g[0]),g=f=void 0}),"script"):void 0}),n.parseHTML=function(a,b,c){if(!a||"string"!=typeof a)return null;"boolean"==typeof b&&(c=b,b=!1),b=b||l;var d=v.exec(a),e=!c&&[];return d?[b.createElement(d[1])]:(d=n.buildFragment([a],b,e),e&&e.length&&n(e).remove(),n.merge([],d.childNodes))};var Ic=n.fn.load;n.fn.load=function(a,b,c){if("string"!=typeof a&&Ic)return Ic.apply(this,arguments);var d,e,f,g=this,h=a.indexOf(" ");return h>=0&&(d=n.trim(a.slice(h)),a=a.slice(0,h)),n.isFunction(b)?(c=b,b=void 0):b&&"object"==typeof b&&(e="POST"),g.length>0&&n.ajax({url:a,type:e,dataType:"html",data:b}).done(function(a){f=arguments,g.html(d?n("<div>").append(n.parseHTML(a)).find(d):a)}).complete(c&&function(a,b){g.each(c,f||[a.responseText,b,a])}),this},n.expr.filters.animated=function(a){return n.grep(n.timers,function(b){return a===b.elem}).length};var Jc=a.document.documentElement;function Kc(a){return n.isWindow(a)?a:9===a.nodeType&&a.defaultView}n.offset={setOffset:function(a,b,c){var d,e,f,g,h,i,j,k=n.css(a,"position"),l=n(a),m={};"static"===k&&(a.style.position="relative"),h=l.offset(),f=n.css(a,"top"),i=n.css(a,"left"),j=("absolute"===k||"fixed"===k)&&(f+i).indexOf("auto")>-1,j?(d=l.position(),g=d.top,e=d.left):(g=parseFloat(f)||0,e=parseFloat(i)||0),n.isFunction(b)&&(b=b.call(a,c,h)),null!=b.top&&(m.top=b.top-h.top+g),null!=b.left&&(m.left=b.left-h.left+e),"using"in b?b.using.call(a,m):l.css(m)}},n.fn.extend({offset:function(a){if(arguments.length)return void 0===a?this:this.each(function(b){n.offset.setOffset(this,a,b)});var b,c,d=this[0],e={top:0,left:0},f=d&&d.ownerDocument;if(f)return b=f.documentElement,n.contains(b,d)?(typeof d.getBoundingClientRect!==U&&(e=d.getBoundingClientRect()),c=Kc(f),{top:e.top+c.pageYOffset-b.clientTop,left:e.left+c.pageXOffset-b.clientLeft}):e},position:function(){if(this[0]){var a,b,c=this[0],d={top:0,left:0};return"fixed"===n.css(c,"position")?b=c.getBoundingClientRect():(a=this.offsetParent(),b=this.offset(),n.nodeName(a[0],"html")||(d=a.offset()),d.top+=n.css(a[0],"borderTopWidth",!0),d.left+=n.css(a[0],"borderLeftWidth",!0)),{top:b.top-d.top-n.css(c,"marginTop",!0),left:b.left-d.left-n.css(c,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||Jc;while(a&&!n.nodeName(a,"html")&&"static"===n.css(a,"position"))a=a.offsetParent;return a||Jc})}}),n.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(b,c){var d="pageYOffset"===c;n.fn[b]=function(e){return J(this,function(b,e,f){var g=Kc(b);return void 0===f?g?g[c]:b[e]:void(g?g.scrollTo(d?a.pageXOffset:f,d?f:a.pageYOffset):b[e]=f)},b,e,arguments.length,null)}}),n.each(["top","left"],function(a,b){n.cssHooks[b]=yb(k.pixelPosition,function(a,c){return c?(c=xb(a,b),vb.test(c)?n(a).position()[b]+"px":c):void 0})}),n.each({Height:"height",Width:"width"},function(a,b){n.each({padding:"inner"+a,content:b,"":"outer"+a},function(c,d){n.fn[d]=function(d,e){var f=arguments.length&&(c||"boolean"!=typeof d),g=c||(d===!0||e===!0?"margin":"border");return J(this,function(b,c,d){var e;return n.isWindow(b)?b.document.documentElement["client"+a]:9===b.nodeType?(e=b.documentElement,Math.max(b.body["scroll"+a],e["scroll"+a],b.body["offset"+a],e["offset"+a],e["client"+a])):void 0===d?n.css(b,c,g):n.style(b,c,d,g)},b,f?d:void 0,f,null)}})}),n.fn.size=function(){return this.length},n.fn.andSelf=n.fn.addBack,"function"==typeof define&&define.amd&&define("jquery",[],function(){return n});var Lc=a.jQuery,Mc=a.$;return n.noConflict=function(b){return a.$===n&&(a.$=Mc),b&&a.jQuery===n&&(a.jQuery=Lc),n},typeof b===U&&(a.jQuery=a.$=n),n});
diff --git a/js/jquery-3.6.0.min.js b/js/jquery-3.6.0.min.js
new file mode 100755
index 0000000..c4c6022
--- /dev/null
+++ b/js/jquery-3.6.0.min.js
@@ -0,0 +1,2 @@
+/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */
+!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0<t&&t-1 in e)}S.fn=S.prototype={jquery:f,constructor:S,length:0,toArray:function(){return s.call(this)},get:function(e){return null==e?s.call(this):e<0?this[e+this.length]:this[e]},pushStack:function(e){var t=S.merge(this.constructor(),e);return t.prevObject=this,t},each:function(e){return S.each(this,e)},map:function(n){return this.pushStack(S.map(this,function(e,t){return n.call(e,t,e)}))},slice:function(){return this.pushStack(s.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},even:function(){return this.pushStack(S.grep(this,function(e,t){return(t+1)%2}))},odd:function(){return this.pushStack(S.grep(this,function(e,t){return t%2}))},eq:function(e){var t=this.length,n=+e+(e<0?t:0);return this.pushStack(0<=n&&n<t?[this[n]]:[])},end:function(){return this.prevObject||this.constructor()},push:u,sort:t.sort,splice:t.splice},S.extend=S.fn.extend=function(){var e,t,n,r,i,o,a=arguments[0]||{},s=1,u=arguments.length,l=!1;for("boolean"==typeof a&&(l=a,a=arguments[s]||{},s++),"object"==typeof a||m(a)||(a={}),s===u&&(a=this,s--);s<u;s++)if(null!=(e=arguments[s]))for(t in e)r=e[t],"__proto__"!==t&&a!==r&&(l&&r&&(S.isPlainObject(r)||(i=Array.isArray(r)))?(n=a[t],o=i&&!Array.isArray(n)?[]:i||S.isPlainObject(n)?n:{},i=!1,a[t]=S.extend(l,o,r)):void 0!==r&&(a[t]=r));return a},S.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),isReady:!0,error:function(e){throw new Error(e)},noop:function(){},isPlainObject:function(e){var t,n;return!(!e||"[object Object]"!==o.call(e))&&(!(t=r(e))||"function"==typeof(n=v.call(t,"constructor")&&t.constructor)&&a.call(n)===l)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},globalEval:function(e,t,n){b(e,{nonce:t&&t.nonce},n)},each:function(e,t){var n,r=0;if(p(e)){for(n=e.length;r<n;r++)if(!1===t.call(e[r],r,e[r]))break}else for(r in e)if(!1===t.call(e[r],r,e[r]))break;return e},makeArray:function(e,t){var n=t||[];return null!=e&&(p(Object(e))?S.merge(n,"string"==typeof e?[e]:e):u.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:i.call(t,e,n)},merge:function(e,t){for(var n=+t.length,r=0,i=e.length;r<n;r++)e[i++]=t[r];return e.length=i,e},grep:function(e,t,n){for(var r=[],i=0,o=e.length,a=!n;i<o;i++)!t(e[i],i)!==a&&r.push(e[i]);return r},map:function(e,t,n){var r,i,o=0,a=[];if(p(e))for(r=e.length;o<r;o++)null!=(i=t(e[o],o,n))&&a.push(i);else for(o in e)null!=(i=t(e[o],o,n))&&a.push(i);return g(a)},guid:1,support:y}),"function"==typeof Symbol&&(S.fn[Symbol.iterator]=t[Symbol.iterator]),S.each("Boolean Number String Function Array Date RegExp Object Error Symbol".split(" "),function(e,t){n["[object "+t+"]"]=t.toLowerCase()});var d=function(n){var e,d,b,o,i,h,f,g,w,u,l,T,C,a,E,v,s,c,y,S="sizzle"+1*new Date,p=n.document,k=0,r=0,m=ue(),x=ue(),A=ue(),N=ue(),j=function(e,t){return e===t&&(l=!0),0},D={}.hasOwnProperty,t=[],q=t.pop,L=t.push,H=t.push,O=t.slice,P=function(e,t){for(var n=0,r=e.length;n<r;n++)if(e[n]===t)return n;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",I="(?:\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+",W="\\["+M+"*("+I+")(?:"+M+"*([*^$|!~]?=)"+M+"*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|("+I+"))|)"+M+"*\\]",F=":("+I+")(?:\\((('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|((?:\\\\.|[^\\\\()[\\]]|"+W+")*)|.*)\\)|)",B=new RegExp(M+"+","g"),$=new RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),_=new RegExp("^"+M+"*,"+M+"*"),z=new RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],v=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="<a id='"+S+"'></a><select id='"+S+"-\r\\' msallowcapture=''><option selected=''></option></select>",e.querySelectorAll("[msallowcapture^='']").length&&v.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||v.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||v.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.+[+~]"),e.querySelectorAll("\\\f"),v.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="<a href='' disabled='disabled'></a><select disabled='disabled'><option/></select>";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&v.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0<se(t,C,null,[e]).length},se.contains=function(e,t){return(e.ownerDocument||e)!=C&&T(e),y(e,t)},se.attr=function(e,t){(e.ownerDocument||e)!=C&&T(e);var n=b.attrHandle[t.toLowerCase()],r=n&&D.call(b.attrHandle,t.toLowerCase())?n(e,t,!E):void 0;return void 0!==r?r:d.attributes||!E?e.getAttribute(t):(r=e.getAttributeNode(t))&&r.specified?r.value:null},se.escape=function(e){return(e+"").replace(re,ie)},se.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},se.uniqueSort=function(e){var t,n=[],r=0,i=0;if(l=!d.detectDuplicates,u=!d.sortStable&&e.slice(0),e.sort(j),l){while(t=e[i++])t===e[i]&&(r=n.push(i));while(r--)e.splice(n[r],1)}return u=null,e},o=se.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else while(t=e[r++])n+=o(t);return n},(b=se.selectors={cacheLength:50,createPseudo:le,match:G,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1<t.indexOf(i):"$="===r?i&&t.slice(-i.length)===i:"~="===r?-1<(" "+t.replace(B," ")+" ").indexOf(i):"|="===r&&(t===i||t.slice(0,i.length+1)===i+"-"))}},CHILD:function(h,e,t,g,v){var y="nth"!==h.slice(0,3),m="last"!==h.slice(-4),x="of-type"===e;return 1===g&&0===v?function(e){return!!e.parentNode}:function(e,t,n){var r,i,o,a,s,u,l=y!==m?"nextSibling":"previousSibling",c=e.parentNode,f=x&&e.nodeName.toLowerCase(),p=!n&&!x,d=!1;if(c){if(y){while(l){a=e;while(a=a[l])if(x?a.nodeName.toLowerCase()===f:1===a.nodeType)return!1;u=l="only"===h&&!u&&"nextSibling"}return!0}if(u=[m?c.firstChild:c.lastChild],m&&p){d=(s=(r=(i=(o=(a=c)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1])&&r[2],a=s&&c.childNodes[s];while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if(1===a.nodeType&&++d&&a===e){i[h]=[k,s,d];break}}else if(p&&(d=s=(r=(i=(o=(a=e)[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]||[])[0]===k&&r[1]),!1===d)while(a=++s&&a&&a[l]||(d=s=0)||u.pop())if((x?a.nodeName.toLowerCase()===f:1===a.nodeType)&&++d&&(p&&((i=(o=a[S]||(a[S]={}))[a.uniqueID]||(o[a.uniqueID]={}))[h]=[k,d]),a===e))break;return(d-=v)===g||d%g==0&&0<=d/g}}},PSEUDO:function(e,o){var t,a=b.pseudos[e]||b.setFilters[e.toLowerCase()]||se.error("unsupported pseudo: "+e);return a[S]?a(o):1<a.length?(t=[e,e,"",o],b.setFilters.hasOwnProperty(e.toLowerCase())?le(function(e,t){var n,r=a(e,o),i=r.length;while(i--)e[n=P(e,r[i])]=!(t[n]=r[i])}):function(e){return a(e,0,t)}):a}},pseudos:{not:le(function(e){var r=[],i=[],s=f(e.replace($,"$1"));return s[S]?le(function(e,t,n,r){var i,o=s(e,null,r,[]),a=e.length;while(a--)(i=o[a])&&(e[a]=!(t[a]=i))}):function(e,t,n){return r[0]=e,s(r,null,n,i),r[0]=null,!i.pop()}}),has:le(function(t){return function(e){return 0<se(t,e).length}}),contains:le(function(t){return t=t.replace(te,ne),function(e){return-1<(e.textContent||o(e)).indexOf(t)}}),lang:le(function(n){return V.test(n||"")||se.error("unsupported lang: "+n),n=n.replace(te,ne).toLowerCase(),function(e){var t;do{if(t=E?e.lang:e.getAttribute("xml:lang")||e.getAttribute("lang"))return(t=t.toLowerCase())===n||0===t.indexOf(n+"-")}while((e=e.parentNode)&&1===e.nodeType);return!1}}),target:function(e){var t=n.location&&n.location.hash;return t&&t.slice(1)===e.id},root:function(e){return e===a},focus:function(e){return e===C.activeElement&&(!C.hasFocus||C.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:ge(!1),disabled:ge(!0),checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,!0===e.selected},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeType<6)return!1;return!0},parent:function(e){return!b.pseudos.empty(e)},header:function(e){return J.test(e.nodeName)},input:function(e){return Q.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||"text"===t.toLowerCase())},first:ve(function(){return[0]}),last:ve(function(e,t){return[t-1]}),eq:ve(function(e,t,n){return[n<0?n+t:n]}),even:ve(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:ve(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:ve(function(e,t,n){for(var r=n<0?n+t:t<n?t:n;0<=--r;)e.push(r);return e}),gt:ve(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}}).pseudos.nth=b.pseudos.eq,{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})b.pseudos[e]=de(e);for(e in{submit:!0,reset:!0})b.pseudos[e]=he(e);function me(){}function xe(e){for(var t=0,n=e.length,r="";t<n;t++)r+=e[t].value;return r}function be(s,e,t){var u=e.dir,l=e.next,c=l||u,f=t&&"parentNode"===c,p=r++;return e.first?function(e,t,n){while(e=e[u])if(1===e.nodeType||f)return s(e,t,n);return!1}:function(e,t,n){var r,i,o,a=[k,p];if(n){while(e=e[u])if((1===e.nodeType||f)&&s(e,t,n))return!0}else while(e=e[u])if(1===e.nodeType||f)if(i=(o=e[S]||(e[S]={}))[e.uniqueID]||(o[e.uniqueID]={}),l&&l===e.nodeName.toLowerCase())e=e[u]||e;else{if((r=i[c])&&r[0]===k&&r[1]===p)return a[2]=r[2];if((i[c]=a)[2]=s(e,t,n))return!0}return!1}}function we(i){return 1<i.length?function(e,t,n){var r=i.length;while(r--)if(!i[r](e,t,n))return!1;return!0}:i[0]}function Te(e,t,n,r,i){for(var o,a=[],s=0,u=e.length,l=null!=t;s<u;s++)(o=e[s])&&(n&&!n(o,r,i)||(a.push(o),l&&t.push(s)));return a}function Ce(d,h,g,v,y,e){return v&&!v[S]&&(v=Ce(v)),y&&!y[S]&&(y=Ce(y,e)),le(function(e,t,n,r){var i,o,a,s=[],u=[],l=t.length,c=e||function(e,t,n){for(var r=0,i=t.length;r<i;r++)se(e,t[r],n);return n}(h||"*",n.nodeType?[n]:n,[]),f=!d||!e&&h?c:Te(c,s,d,n,r),p=g?y||(e?d:l||v)?[]:t:f;if(g&&g(f,p,n,r),v){i=Te(p,u),v(i,[],n,r),o=i.length;while(o--)(a=i[o])&&(p[u[o]]=!(f[u[o]]=a))}if(e){if(y||d){if(y){i=[],o=p.length;while(o--)(a=p[o])&&i.push(f[o]=a);y(null,p=[],i,r)}o=p.length;while(o--)(a=p[o])&&-1<(i=y?P(e,a):s[o])&&(e[i]=!(t[i]=a))}}else p=Te(p===t?p.splice(l,p.length):p),y?y(null,t,p,r):H.apply(t,p)})}function Ee(e){for(var i,t,n,r=e.length,o=b.relative[e[0].type],a=o||b.relative[" "],s=o?1:0,u=be(function(e){return e===i},a,!0),l=be(function(e){return-1<P(i,e)},a,!0),c=[function(e,t,n){var r=!o&&(n||t!==w)||((i=t).nodeType?u(e,t,n):l(e,t,n));return i=null,r}];s<r;s++)if(t=b.relative[e[s].type])c=[be(we(c),t)];else{if((t=b.filter[e[s].type].apply(null,e[s].matches))[S]){for(n=++s;n<r;n++)if(b.relative[e[n].type])break;return Ce(1<s&&we(c),1<s&&xe(e.slice(0,s-1).concat({value:" "===e[s-2].type?"*":""})).replace($,"$1"),t,s<n&&Ee(e.slice(s,n)),n<r&&Ee(e=e.slice(n)),n<r&&xe(e))}c.push(t)}return we(c)}return me.prototype=b.filters=b.pseudos,b.setFilters=new me,h=se.tokenize=function(e,t){var n,r,i,o,a,s,u,l=x[e+" "];if(l)return t?0:l.slice(0);a=e,s=[],u=b.preFilter;while(a){for(o in n&&!(r=_.exec(a))||(r&&(a=a.slice(r[0].length)||a),s.push(i=[])),n=!1,(r=z.exec(a))&&(n=r.shift(),i.push({value:n,type:r[0].replace($," ")}),a=a.slice(n.length)),b.filter)!(r=G[o].exec(a))||u[o]&&!(r=u[o](r))||(n=r.shift(),i.push({value:n,type:o,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?se.error(e):x(e,s).slice(0)},f=se.compile=function(e,t){var n,v,y,m,x,r,i=[],o=[],a=A[e+" "];if(!a){t||(t=h(e)),n=t.length;while(n--)(a=Ee(t[n]))[S]?i.push(a):o.push(a);(a=A(e,(v=o,m=0<(y=i).length,x=0<v.length,r=function(e,t,n,r,i){var o,a,s,u=0,l="0",c=e&&[],f=[],p=w,d=e||x&&b.find.TAG("*",i),h=k+=null==p?1:Math.random()||.1,g=d.length;for(i&&(w=t==C||t||i);l!==g&&null!=(o=d[l]);l++){if(x&&o){a=0,t||o.ownerDocument==C||(T(o),n=!E);while(s=v[a++])if(s(o,t||C,n)){r.push(o);break}i&&(k=h)}m&&((o=!s&&o)&&u--,e&&c.push(o))}if(u+=l,m&&l!==u){a=0;while(s=y[a++])s(c,f,t,n);if(e){if(0<u)while(l--)c[l]||f[l]||(f[l]=q.call(r));f=Te(f)}H.apply(r,f),i&&!e&&0<f.length&&1<u+y.length&&se.uniqueSort(r)}return i&&(k=h,w=p),c},m?le(r):r))).selector=e}return a},g=se.select=function(e,t,n,r){var i,o,a,s,u,l="function"==typeof e&&e,c=!r&&h(e=l.selector||e);if(n=n||[],1===c.length){if(2<(o=c[0]=c[0].slice(0)).length&&"ID"===(a=o[0]).type&&9===t.nodeType&&E&&b.relative[o[1].type]){if(!(t=(b.find.ID(a.matches[0].replace(te,ne),t)||[])[0]))return n;l&&(t=t.parentNode),e=e.slice(o.shift().value.length)}i=G.needsContext.test(e)?0:o.length;while(i--){if(a=o[i],b.relative[s=a.type])break;if((u=b.find[s])&&(r=u(a.matches[0].replace(te,ne),ee.test(o[0].type)&&ye(t.parentNode)||t))){if(o.splice(i,1),!(e=r.length&&xe(o)))return H.apply(n,r),n;break}}}return(l||f(e,c))(r,t,!E,n,!t||ee.test(e)&&ye(t.parentNode)||t),n},d.sortStable=S.split("").sort(j).join("")===S,d.detectDuplicates=!!l,T(),d.sortDetached=ce(function(e){return 1&e.compareDocumentPosition(C.createElement("fieldset"))}),ce(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||fe("type|href|height|width",function(e,t,n){if(!n)return e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),d.attributes&&ce(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||fe("value",function(e,t,n){if(!n&&"input"===e.nodeName.toLowerCase())return e.defaultValue}),ce(function(e){return null==e.getAttribute("disabled")})||fe(R,function(e,t,n){var r;if(!n)return!0===e[t]?t.toLowerCase():(r=e.getAttributeNode(t))&&r.specified?r.value:null}),se}(C);S.find=d,S.expr=d.selectors,S.expr[":"]=S.expr.pseudos,S.uniqueSort=S.unique=d.uniqueSort,S.text=d.getText,S.isXMLDoc=d.isXML,S.contains=d.contains,S.escapeSelector=d.escape;var h=function(e,t,n){var r=[],i=void 0!==n;while((e=e[t])&&9!==e.nodeType)if(1===e.nodeType){if(i&&S(e).is(n))break;r.push(e)}return r},T=function(e,t){for(var n=[];e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n},k=S.expr.match.needsContext;function A(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()}var N=/^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1<i.call(n,e)!==r}):S.filter(n,e,r)}S.filter=function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?S.find.matchesSelector(r,e)?[r]:[]:S.find.matches(e,S.grep(t,function(e){return 1===e.nodeType}))},S.fn.extend({find:function(e){var t,n,r=this.length,i=this;if("string"!=typeof e)return this.pushStack(S(e).filter(function(){for(t=0;t<r;t++)if(S.contains(i[t],this))return!0}));for(n=this.pushStack([]),t=0;t<r;t++)S.find(e,i[t],n);return 1<r?S.uniqueSort(n):n},filter:function(e){return this.pushStack(j(this,e||[],!1))},not:function(e){return this.pushStack(j(this,e||[],!0))},is:function(e){return!!j(this,"string"==typeof e&&k.test(e)?S(e):e||[],!1).length}});var D,q=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e<n;e++)if(S.contains(this,t[e]))return!0})},closest:function(e,t){var n,r=0,i=this.length,o=[],a="string"!=typeof e&&S(e);if(!k.test(e))for(;r<i;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(n.nodeType<11&&(a?-1<a.index(n):1===n.nodeType&&S.find.matchesSelector(n,e))){o.push(n);break}return this.pushStack(1<o.length?S.uniqueSort(o):o)},index:function(e){return e?"string"==typeof e?i.call(S(e),this[0]):i.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){return this.pushStack(S.uniqueSort(S.merge(this.get(),S(e,t))))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}}),S.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return h(e,"parentNode")},parentsUntil:function(e,t,n){return h(e,"parentNode",n)},next:function(e){return O(e,"nextSibling")},prev:function(e){return O(e,"previousSibling")},nextAll:function(e){return h(e,"nextSibling")},prevAll:function(e){return h(e,"previousSibling")},nextUntil:function(e,t,n){return h(e,"nextSibling",n)},prevUntil:function(e,t,n){return h(e,"previousSibling",n)},siblings:function(e){return T((e.parentNode||{}).firstChild,e)},children:function(e){return T(e.firstChild)},contents:function(e){return null!=e.contentDocument&&r(e.contentDocument)?e.contentDocument:(A(e,"template")&&(e=e.content||e),S.merge([],e.childNodes))}},function(r,i){S.fn[r]=function(e,t){var n=S.map(this,i,e);return"Until"!==r.slice(-5)&&(t=e),t&&"string"==typeof t&&(n=S.filter(t,n)),1<this.length&&(H[r]||S.uniqueSort(n),L.test(r)&&n.reverse()),this.pushStack(n)}});var P=/[^\x20\t\r\n\f]+/g;function R(e){return e}function M(e){throw e}function I(e,t,n,r){var i;try{e&&m(i=e.promise)?i.call(e).done(t).fail(n):e&&m(i=e.then)?i.call(e,t,n):t.apply(void 0,[e].slice(r))}catch(e){n.apply(void 0,[e])}}S.Callbacks=function(r){var e,n;r="string"==typeof r?(e=r,n={},S.each(e.match(P)||[],function(e,t){n[t]=!0}),n):S.extend({},r);var i,t,o,a,s=[],u=[],l=-1,c=function(){for(a=a||r.once,o=i=!0;u.length;l=-1){t=u.shift();while(++l<s.length)!1===s[l].apply(t[0],t[1])&&r.stopOnFalse&&(l=s.length,t=!1)}r.memory||(t=!1),i=!1,a&&(s=t?[]:"")},f={add:function(){return s&&(t&&!i&&(l=s.length-1,u.push(t)),function n(e){S.each(e,function(e,t){m(t)?r.unique&&f.has(t)||s.push(t):t&&t.length&&"string"!==w(t)&&n(t)})}(arguments),t&&!i&&c()),this},remove:function(){return S.each(arguments,function(e,t){var n;while(-1<(n=S.inArray(t,s,n)))s.splice(n,1),n<=l&&l--}),this},has:function(e){return e?-1<S.inArray(e,s):0<s.length},empty:function(){return s&&(s=[]),this},disable:function(){return a=u=[],s=t="",this},disabled:function(){return!s},lock:function(){return a=u=[],t||i||(s=t=""),this},locked:function(){return!!a},fireWith:function(e,t){return a||(t=[e,(t=t||[]).slice?t.slice():t],u.push(t),i||c()),this},fire:function(){return f.fireWith(this,arguments),this},fired:function(){return!!o}};return f},S.extend({Deferred:function(e){var o=[["notify","progress",S.Callbacks("memory"),S.Callbacks("memory"),2],["resolve","done",S.Callbacks("once memory"),S.Callbacks("once memory"),0,"resolved"],["reject","fail",S.Callbacks("once memory"),S.Callbacks("once memory"),1,"rejected"]],i="pending",a={state:function(){return i},always:function(){return s.done(arguments).fail(arguments),this},"catch":function(e){return a.then(null,e)},pipe:function(){var i=arguments;return S.Deferred(function(r){S.each(o,function(e,t){var n=m(i[t[4]])&&i[t[4]];s[t[1]](function(){var e=n&&n.apply(this,arguments);e&&m(e.promise)?e.promise().progress(r.notify).done(r.resolve).fail(r.reject):r[t[0]+"With"](this,n?[e]:arguments)})}),i=null}).promise()},then:function(t,n,r){var u=0;function l(i,o,a,s){return function(){var n=this,r=arguments,e=function(){var e,t;if(!(i<u)){if((e=a.apply(n,r))===o.promise())throw new TypeError("Thenable self-resolution");t=e&&("object"==typeof e||"function"==typeof e)&&e.then,m(t)?s?t.call(e,l(u,o,R,s),l(u,o,M,s)):(u++,t.call(e,l(u,o,R,s),l(u,o,M,s),l(u,o,R,o.notifyWith))):(a!==R&&(n=void 0,r=[e]),(s||o.resolveWith)(n,r))}},t=s?e:function(){try{e()}catch(e){S.Deferred.exceptionHook&&S.Deferred.exceptionHook(e,t.stackTrace),u<=i+1&&(a!==M&&(n=void 0,r=[e]),o.rejectWith(n,r))}};i?t():(S.Deferred.getStackHook&&(t.stackTrace=S.Deferred.getStackHook()),C.setTimeout(t))}}return S.Deferred(function(e){o[0][3].add(l(0,e,m(r)?r:R,e.notifyWith)),o[1][3].add(l(0,e,m(t)?t:R)),o[2][3].add(l(0,e,m(n)?n:M))}).promise()},promise:function(e){return null!=e?S.extend(e,a):a}},s={};return S.each(o,function(e,t){var n=t[2],r=t[5];a[t[1]]=n.add,r&&n.add(function(){i=r},o[3-e][2].disable,o[3-e][3].disable,o[0][2].lock,o[0][3].lock),n.add(t[3].fire),s[t[0]]=function(){return s[t[0]+"With"](this===s?void 0:this,arguments),this},s[t[0]+"With"]=n.fireWith}),a.promise(s),e&&e.call(s,s),s},when:function(e){var n=arguments.length,t=n,r=Array(t),i=s.call(arguments),o=S.Deferred(),a=function(t){return function(e){r[t]=this,i[t]=1<arguments.length?s.call(arguments):e,--n||o.resolveWith(r,i)}};if(n<=1&&(I(e,o.done(a(t)).resolve,o.reject,!n),"pending"===o.state()||m(i[t]&&i[t].then)))return o.then();while(t--)I(i[t],a(t),o.reject);return o.promise()}});var W=/^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/;S.Deferred.exceptionHook=function(e,t){C.console&&C.console.warn&&e&&W.test(e.name)&&C.console.warn("jQuery.Deferred exception: "+e.message,e.stack,t)},S.readyException=function(e){C.setTimeout(function(){throw e})};var F=S.Deferred();function B(){E.removeEventListener("DOMContentLoaded",B),C.removeEventListener("load",B),S.ready()}S.fn.ready=function(e){return F.then(e)["catch"](function(e){S.readyException(e)}),this},S.extend({isReady:!1,readyWait:1,ready:function(e){(!0===e?--S.readyWait:S.isReady)||(S.isReady=!0)!==e&&0<--S.readyWait||F.resolveWith(E,[S])}}),S.ready.then=F.then,"complete"===E.readyState||"loading"!==E.readyState&&!E.documentElement.doScroll?C.setTimeout(S.ready):(E.addEventListener("DOMContentLoaded",B),C.addEventListener("load",B));var $=function(e,t,n,r,i,o,a){var s=0,u=e.length,l=null==n;if("object"===w(n))for(s in i=!0,n)$(e,t,s,n[s],!0,o,a);else if(void 0!==r&&(i=!0,m(r)||(a=!0),l&&(a?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(S(e),n)})),t))for(;s<u;s++)t(e[s],n,a?r:r.call(e[s],s,t(e[s],n)));return i?e:l?t.call(e):u?t(e[0],n):o},_=/^-ms-/,z=/-([a-z])/g;function U(e,t){return t.toUpperCase()}function X(e){return e.replace(_,"ms-").replace(z,U)}var V=function(e){return 1===e.nodeType||9===e.nodeType||!+e.nodeType};function G(){this.expando=S.expando+G.uid++}G.uid=1,G.prototype={cache:function(e){var t=e[this.expando];return t||(t={},V(e)&&(e.nodeType?e[this.expando]=t:Object.defineProperty(e,this.expando,{value:t,configurable:!0}))),t},set:function(e,t,n){var r,i=this.cache(e);if("string"==typeof t)i[X(t)]=n;else for(r in t)i[X(r)]=t[r];return i},get:function(e,t){return void 0===t?this.cache(e):e[this.expando]&&e[this.expando][X(t)]},access:function(e,t,n){return void 0===t||t&&"string"==typeof t&&void 0===n?this.get(e,t):(this.set(e,t,n),void 0!==n?n:t)},remove:function(e,t){var n,r=e[this.expando];if(void 0!==r){if(void 0!==t){n=(t=Array.isArray(t)?t.map(X):(t=X(t))in r?[t]:t.match(P)||[]).length;while(n--)delete r[t[n]]}(void 0===t||S.isEmptyObject(r))&&(e.nodeType?e[this.expando]=void 0:delete e[this.expando])}},hasData:function(e){var t=e[this.expando];return void 0!==t&&!S.isEmptyObject(t)}};var Y=new G,Q=new G,J=/^(?:\{[\w\W]*\}|\[[\w\W]*\])$/,K=/[A-Z]/g;function Z(e,t,n){var r,i;if(void 0===n&&1===e.nodeType)if(r="data-"+t.replace(K,"-$&").toLowerCase(),"string"==typeof(n=e.getAttribute(r))){try{n="true"===(i=n)||"false"!==i&&("null"===i?null:i===+i+""?+i:J.test(i)?JSON.parse(i):i)}catch(e){}Q.set(e,t,n)}else n=void 0;return n}S.extend({hasData:function(e){return Q.hasData(e)||Y.hasData(e)},data:function(e,t,n){return Q.access(e,t,n)},removeData:function(e,t){Q.remove(e,t)},_data:function(e,t,n){return Y.access(e,t,n)},_removeData:function(e,t){Y.remove(e,t)}}),S.fn.extend({data:function(n,e){var t,r,i,o=this[0],a=o&&o.attributes;if(void 0===n){if(this.length&&(i=Q.get(o),1===o.nodeType&&!Y.get(o,"hasDataAttrs"))){t=a.length;while(t--)a[t]&&0===(r=a[t].name).indexOf("data-")&&(r=X(r.slice(5)),Z(o,r,i[r]));Y.set(o,"hasDataAttrs",!0)}return i}return"object"==typeof n?this.each(function(){Q.set(this,n)}):$(this,function(e){var t;if(o&&void 0===e)return void 0!==(t=Q.get(o,n))?t:void 0!==(t=Z(o,n))?t:void 0;this.each(function(){Q.set(this,n,e)})},null,e,1<arguments.length,null,!0)},removeData:function(e){return this.each(function(){Q.remove(this,e)})}}),S.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=Y.get(e,t),n&&(!r||Array.isArray(n)?r=Y.access(e,t,S.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=S.queue(e,t),r=n.length,i=n.shift(),o=S._queueHooks(e,t);"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,function(){S.dequeue(e,t)},o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return Y.get(e,n)||Y.access(e,n,{empty:S.Callbacks("once memory").add(function(){Y.remove(e,[t+"queue",n])})})}}),S.fn.extend({queue:function(t,n){var e=2;return"string"!=typeof t&&(n=t,t="fx",e--),arguments.length<e?S.queue(this[0],t):void 0===n?this:this.each(function(){var e=S.queue(this,t,n);S._queueHooks(this,t),"fx"===t&&"inprogress"!==e[0]&&S.dequeue(this,t)})},dequeue:function(e){return this.each(function(){S.dequeue(this,e)})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=S.Deferred(),o=this,a=this.length,s=function(){--r||i.resolveWith(o,[o])};"string"!=typeof e&&(t=e,e=void 0),e=e||"fx";while(a--)(n=Y.get(o[a],e+"queueHooks"))&&n.empty&&(r++,n.empty.add(s));return s(),i.promise(t)}});var ee=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,te=new RegExp("^(?:([+-])=|)("+ee+")([a-z%]*)$","i"),ne=["Top","Right","Bottom","Left"],re=E.documentElement,ie=function(e){return S.contains(e.ownerDocument,e)},oe={composed:!0};re.getRootNode&&(ie=function(e){return S.contains(e.ownerDocument,e)||e.getRootNode(oe)===e.ownerDocument});var ae=function(e,t){return"none"===(e=t||e).style.display||""===e.style.display&&ie(e)&&"none"===S.css(e,"display")};function se(e,t,n,r){var i,o,a=20,s=r?function(){return r.cur()}:function(){return S.css(e,t,"")},u=s(),l=n&&n[3]||(S.cssNumber[t]?"":"px"),c=e.nodeType&&(S.cssNumber[t]||"px"!==l&&+u)&&te.exec(S.css(e,t));if(c&&c[3]!==l){u/=2,l=l||c[3],c=+u||1;while(a--)S.style(e,t,c+l),(1-o)*(1-(o=s()/u||.5))<=0&&(a=0),c/=o;c*=2,S.style(e,t,c+l),n=n||[]}return n&&(c=+c||+u||0,i=n[1]?c+(n[1]+1)*n[2]:+n[2],r&&(r.unit=l,r.start=c,r.end=i)),i}var ue={};function le(e,t){for(var n,r,i,o,a,s,u,l=[],c=0,f=e.length;c<f;c++)(r=e[c]).style&&(n=r.style.display,t?("none"===n&&(l[c]=Y.get(r,"display")||null,l[c]||(r.style.display="")),""===r.style.display&&ae(r)&&(l[c]=(u=a=o=void 0,a=(i=r).ownerDocument,s=i.nodeName,(u=ue[s])||(o=a.body.appendChild(a.createElement(s)),u=S.css(o,"display"),o.parentNode.removeChild(o),"none"===u&&(u="block"),ue[s]=u)))):"none"!==n&&(l[c]="none",Y.set(r,"display",n)));for(c=0;c<f;c++)null!=l[c]&&(e[c].style.display=l[c]);return e}S.fn.extend({show:function(){return le(this,!0)},hide:function(){return le(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){ae(this)?S(this).show():S(this).hide()})}});var ce,fe,pe=/^(?:checkbox|radio)$/i,de=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="<textarea>x</textarea>",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="<option></option>",y.option=!!ce.lastChild;var ge={thead:[1,"<table>","</table>"],col:[2,"<table><colgroup>","</colgroup></table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:[0,"",""]};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ye(e,t){for(var n=0,r=e.length;n<r;n++)Y.set(e[n],"globalEval",!t||Y.get(t[n],"globalEval"))}ge.tbody=ge.tfoot=ge.colgroup=ge.caption=ge.thead,ge.th=ge.td,y.option||(ge.optgroup=ge.option=[1,"<select multiple='multiple'>","</select>"]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d<h;d++)if((o=e[d])||0===o)if("object"===w(o))S.merge(p,o.nodeType?[o]:o);else if(me.test(o)){a=a||f.appendChild(t.createElement("div")),s=(de.exec(o)||["",""])[1].toLowerCase(),u=ge[s]||ge._default,a.innerHTML=u[1]+S.htmlPrefilter(o)+u[2],c=u[0];while(c--)a=a.lastChild;S.merge(p,a.childNodes),(a=f.firstChild).textContent=""}else p.push(t.createTextNode(o));f.textContent="",d=0;while(o=p[d++])if(r&&-1<S.inArray(o,r))i&&i.push(o);else if(l=ie(o),a=ve(f.appendChild(o),"script"),l&&ye(a),n){c=0;while(o=a[c++])he.test(o.type||"")&&n.push(o)}return f}var be=/^([^.]*)(?:\.(.+)|)/;function we(){return!0}function Te(){return!1}function Ce(e,t){return e===function(){try{return E.activeElement}catch(e){}}()==("focus"===t)}function Ee(e,t,n,r,i,o){var a,s;if("object"==typeof t){for(s in"string"!=typeof n&&(r=r||n,n=void 0),t)Ee(e,s,n,r,t[s],o);return e}if(null==r&&null==i?(i=n,r=n=void 0):null==i&&("string"==typeof n?(i=r,r=void 0):(i=r,r=n,n=void 0)),!1===i)i=Te;else if(!i)return e;return 1===o&&(a=i,(i=function(e){return S().off(e),a.apply(this,arguments)}).guid=a.guid||(a.guid=S.guid++)),e.each(function(){S.event.add(this,t,i,r,n)})}function Se(e,i,o){o?(Y.set(e,i,!1),S.event.add(e,i,{namespace:!1,handler:function(e){var t,n,r=Y.get(this,i);if(1&e.isTrigger&&this[i]){if(r.length)(S.event.special[i]||{}).delegateType&&e.stopPropagation();else if(r=s.call(arguments),Y.set(this,i,r),t=o(this,i),this[i](),r!==(n=Y.get(this,i))||t?Y.set(this,i,!1):n={},r!==n)return e.stopImmediatePropagation(),e.preventDefault(),n&&n.value}else r.length&&(Y.set(this,i,{value:S.event.trigger(S.extend(r[0],S.Event.prototype),r.slice(1),this)}),e.stopImmediatePropagation())}})):void 0===Y.get(e,i)&&S.event.add(e,i,we)}S.event={global:{},add:function(t,e,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.get(t);if(V(t)){n.handler&&(n=(o=n).handler,i=o.selector),i&&S.find.matchesSelector(re,i),n.guid||(n.guid=S.guid++),(u=v.events)||(u=v.events=Object.create(null)),(a=v.handle)||(a=v.handle=function(e){return"undefined"!=typeof S&&S.event.triggered!==e.type?S.event.dispatch.apply(t,arguments):void 0}),l=(e=(e||"").match(P)||[""]).length;while(l--)d=g=(s=be.exec(e[l])||[])[1],h=(s[2]||"").split(".").sort(),d&&(f=S.event.special[d]||{},d=(i?f.delegateType:f.bindType)||d,f=S.event.special[d]||{},c=S.extend({type:d,origType:g,data:r,handler:n,guid:n.guid,selector:i,needsContext:i&&S.expr.match.needsContext.test(i),namespace:h.join(".")},o),(p=u[d])||((p=u[d]=[]).delegateCount=0,f.setup&&!1!==f.setup.call(t,r,h,a)||t.addEventListener&&t.addEventListener(d,a)),f.add&&(f.add.call(t,c),c.handler.guid||(c.handler.guid=n.guid)),i?p.splice(p.delegateCount++,0,c):p.push(c),S.event.global[d]=!0)}},remove:function(e,t,n,r,i){var o,a,s,u,l,c,f,p,d,h,g,v=Y.hasData(e)&&Y.get(e);if(v&&(u=v.events)){l=(t=(t||"").match(P)||[""]).length;while(l--)if(d=g=(s=be.exec(t[l])||[])[1],h=(s[2]||"").split(".").sort(),d){f=S.event.special[d]||{},p=u[d=(r?f.delegateType:f.bindType)||d]||[],s=s[2]&&new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),a=o=p.length;while(o--)c=p[o],!i&&g!==c.origType||n&&n.guid!==c.guid||s&&!s.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(p.splice(o,1),c.selector&&p.delegateCount--,f.remove&&f.remove.call(e,c));a&&!p.length&&(f.teardown&&!1!==f.teardown.call(e,h,v.handle)||S.removeEvent(e,d,v.handle),delete u[d])}else for(d in u)S.event.remove(e,d+t[l],n,r,!0);S.isEmptyObject(u)&&Y.remove(e,"handle events")}},dispatch:function(e){var t,n,r,i,o,a,s=new Array(arguments.length),u=S.event.fix(e),l=(Y.get(this,"events")||Object.create(null))[u.type]||[],c=S.event.special[u.type]||{};for(s[0]=u,t=1;t<arguments.length;t++)s[t]=arguments[t];if(u.delegateTarget=this,!c.preDispatch||!1!==c.preDispatch.call(this,u)){a=S.event.handlers.call(this,u,l),t=0;while((i=a[t++])&&!u.isPropagationStopped()){u.currentTarget=i.elem,n=0;while((o=i.handlers[n++])&&!u.isImmediatePropagationStopped())u.rnamespace&&!1!==o.namespace&&!u.rnamespace.test(o.namespace)||(u.handleObj=o,u.data=o.data,void 0!==(r=((S.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,s))&&!1===(u.result=r)&&(u.preventDefault(),u.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,u),u.result}},handlers:function(e,t){var n,r,i,o,a,s=[],u=t.delegateCount,l=e.target;if(u&&l.nodeType&&!("click"===e.type&&1<=e.button))for(;l!==this;l=l.parentNode||this)if(1===l.nodeType&&("click"!==e.type||!0!==l.disabled)){for(o=[],a={},n=0;n<u;n++)void 0===a[i=(r=t[n]).selector+" "]&&(a[i]=r.needsContext?-1<S(i,this).index(l):S.find(i,this,null,[l]).length),a[i]&&o.push(r);o.length&&s.push({elem:l,handlers:o})}return l=this,u<t.length&&s.push({elem:l,handlers:t.slice(u)}),s},addProp:function(t,e){Object.defineProperty(S.Event.prototype,t,{enumerable:!0,configurable:!0,get:m(e)?function(){if(this.originalEvent)return e(this.originalEvent)}:function(){if(this.originalEvent)return this.originalEvent[t]},set:function(e){Object.defineProperty(this,t,{enumerable:!0,configurable:!0,writable:!0,value:e})}})},fix:function(e){return e[S.expando]?e:new S.Event(e)},special:{load:{noBubble:!0},click:{setup:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click",we),!1},trigger:function(e){var t=this||e;return pe.test(t.type)&&t.click&&A(t,"input")&&Se(t,"click"),!0},_default:function(e){var t=e.target;return pe.test(t.type)&&t.click&&A(t,"input")&&Y.get(t,"click")||A(t,"a")}},beforeunload:{postDispatch:function(e){void 0!==e.result&&e.originalEvent&&(e.originalEvent.returnValue=e.result)}}}},S.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n)},S.Event=function(e,t){if(!(this instanceof S.Event))return new S.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||void 0===e.defaultPrevented&&!1===e.returnValue?we:Te,this.target=e.target&&3===e.target.nodeType?e.target.parentNode:e.target,this.currentTarget=e.currentTarget,this.relatedTarget=e.relatedTarget):this.type=e,t&&S.extend(this,t),this.timeStamp=e&&e.timeStamp||Date.now(),this[S.expando]=!0},S.Event.prototype={constructor:S.Event,isDefaultPrevented:Te,isPropagationStopped:Te,isImmediatePropagationStopped:Te,isSimulated:!1,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=we,e&&!this.isSimulated&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=we,e&&!this.isSimulated&&e.stopPropagation()},stopImmediatePropagation:function(){var e=this.originalEvent;this.isImmediatePropagationStopped=we,e&&!this.isSimulated&&e.stopImmediatePropagation(),this.stopPropagation()}},S.each({altKey:!0,bubbles:!0,cancelable:!0,changedTouches:!0,ctrlKey:!0,detail:!0,eventPhase:!0,metaKey:!0,pageX:!0,pageY:!0,shiftKey:!0,view:!0,"char":!0,code:!0,charCode:!0,key:!0,keyCode:!0,button:!0,buttons:!0,clientX:!0,clientY:!0,offsetX:!0,offsetY:!0,pointerId:!0,pointerType:!0,screenX:!0,screenY:!0,targetTouches:!0,toElement:!0,touches:!0,which:!0},S.event.addProp),S.each({focus:"focusin",blur:"focusout"},function(e,t){S.event.special[e]={setup:function(){return Se(this,e,Ce),!1},trigger:function(){return Se(this,e),!0},_default:function(){return!0},delegateType:t}}),S.each({mouseenter:"mouseover",mouseleave:"mouseout",pointerenter:"pointerover",pointerleave:"pointerout"},function(e,i){S.event.special[e]={delegateType:i,bindType:i,handle:function(e){var t,n=e.relatedTarget,r=e.handleObj;return n&&(n===this||S.contains(this,n))||(e.type=r.origType,t=r.handler.apply(this,arguments),e.type=i),t}}}),S.fn.extend({on:function(e,t,n,r){return Ee(this,e,t,n,r)},one:function(e,t,n,r){return Ee(this,e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,S(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return!1!==t&&"function"!=typeof t||(n=t,t=void 0),!1===n&&(n=Te),this.each(function(){S.event.remove(this,e,n,t)})}});var ke=/<script|<style|<link/i,Ae=/checked\s*(?:[^=]|=\s*.checked.)/i,Ne=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n<r;n++)S.event.add(t,i,s[i][n]);Q.hasData(e)&&(o=Q.access(e),a=S.extend({},o),Q.set(t,a))}}function He(n,r,i,o){r=g(r);var e,t,a,s,u,l,c=0,f=n.length,p=f-1,d=r[0],h=m(d);if(h||1<f&&"string"==typeof d&&!y.checkClone&&Ae.test(d))return n.each(function(e){var t=n.eq(e);h&&(r[0]=d.call(this,e,t.html())),He(t,r,i,o)});if(f&&(t=(e=xe(r,n[0].ownerDocument,!1,n,o)).firstChild,1===e.childNodes.length&&(e=t),t||o)){for(s=(a=S.map(ve(e,"script"),De)).length;c<f;c++)u=e,c!==p&&(u=S.clone(u,!0,!0),s&&S.merge(a,ve(u,"script"))),i.call(n[c],u,c);if(s)for(l=a[a.length-1].ownerDocument,S.map(a,qe),c=0;c<s;c++)u=a[c],he.test(u.type||"")&&!Y.access(u,"globalEval")&&S.contains(l,u)&&(u.src&&"module"!==(u.type||"").toLowerCase()?S._evalUrl&&!u.noModule&&S._evalUrl(u.src,{nonce:u.nonce||u.getAttribute("nonce")},l):b(u.textContent.replace(Ne,""),u,l))}return n}function Oe(e,t,n){for(var r,i=t?S.filter(t,e):e,o=0;null!=(r=i[o]);o++)n||1!==r.nodeType||S.cleanData(ve(r)),r.parentNode&&(n&&ie(r)&&ye(ve(r,"script")),r.parentNode.removeChild(r));return e}S.extend({htmlPrefilter:function(e){return e},clone:function(e,t,n){var r,i,o,a,s,u,l,c=e.cloneNode(!0),f=ie(e);if(!(y.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||S.isXMLDoc(e)))for(a=ve(c),r=0,i=(o=ve(e)).length;r<i;r++)s=o[r],u=a[r],void 0,"input"===(l=u.nodeName.toLowerCase())&&pe.test(s.type)?u.checked=s.checked:"input"!==l&&"textarea"!==l||(u.defaultValue=s.defaultValue);if(t)if(n)for(o=o||ve(e),a=a||ve(c),r=0,i=o.length;r<i;r++)Le(o[r],a[r]);else Le(e,c);return 0<(a=ve(c,"script")).length&&ye(a,!f&&ve(e,"script")),c},cleanData:function(e){for(var t,n,r,i=S.event.special,o=0;void 0!==(n=e[o]);o++)if(V(n)){if(t=n[Y.expando]){if(t.events)for(r in t.events)i[r]?S.event.remove(n,r):S.removeEvent(n,r,t.handle);n[Y.expando]=void 0}n[Q.expando]&&(n[Q.expando]=void 0)}}}),S.fn.extend({detach:function(e){return Oe(this,e,!0)},remove:function(e){return Oe(this,e)},text:function(e){return $(this,function(e){return void 0===e?S.text(this):this.empty().each(function(){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||(this.textContent=e)})},null,e,arguments.length)},append:function(){return He(this,arguments,function(e){1!==this.nodeType&&11!==this.nodeType&&9!==this.nodeType||je(this,e).appendChild(e)})},prepend:function(){return He(this,arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=je(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return He(this,arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},empty:function(){for(var e,t=0;null!=(e=this[t]);t++)1===e.nodeType&&(S.cleanData(ve(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null!=e&&e,t=null==t?e:t,this.map(function(){return S.clone(this,e,t)})},html:function(e){return $(this,function(e){var t=this[0]||{},n=0,r=this.length;if(void 0===e&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!ke.test(e)&&!ge[(de.exec(e)||["",""])[1].toLowerCase()]){e=S.htmlPrefilter(e);try{for(;n<r;n++)1===(t=this[n]||{}).nodeType&&(S.cleanData(ve(t,!1)),t.innerHTML=e);t=0}catch(e){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var n=[];return He(this,arguments,function(e){var t=this.parentNode;S.inArray(this,n)<0&&(S.cleanData(ve(this)),t&&t.replaceChild(e,this))},n)}}),S.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,a){S.fn[e]=function(e){for(var t,n=[],r=S(e),i=r.length-1,o=0;o<=i;o++)t=o===i?this:this.clone(!0),S(r[o])[a](t),u.apply(n,t.get());return this.pushStack(n)}});var Pe=new RegExp("^("+ee+")(?!px)[a-z%]+$","i"),Re=function(e){var t=e.ownerDocument.defaultView;return t&&t.opener||(t=C),t.getComputedStyle(e)},Me=function(e,t,n){var r,i,o={};for(i in t)o[i]=e.style[i],e.style[i]=t[i];for(i in r=n.call(e),t)e.style[i]=o[i];return r},Ie=new RegExp(ne.join("|"),"i");function We(e,t,n){var r,i,o,a,s=e.style;return(n=n||Re(e))&&(""!==(a=n.getPropertyValue(t)||n[t])||ie(e)||(a=S.style(e,t)),!y.pixelBoxStyles()&&Pe.test(a)&&Ie.test(t)&&(r=s.width,i=s.minWidth,o=s.maxWidth,s.minWidth=s.maxWidth=s.width=a,a=n.width,s.width=r,s.minWidth=i,s.maxWidth=o)),void 0!==a?a+"":a}function Fe(e,t){return{get:function(){if(!e())return(this.get=t).apply(this,arguments);delete this.get}}}!function(){function e(){if(l){u.style.cssText="position:absolute;left:-11111px;width:60px;margin-top:1px;padding:0;border:0",l.style.cssText="position:relative;display:block;box-sizing:border-box;overflow:scroll;margin:auto;border:1px;padding:1px;width:60%;top:1%",re.appendChild(u).appendChild(l);var e=C.getComputedStyle(l);n="1%"!==e.top,s=12===t(e.marginLeft),l.style.right="60%",o=36===t(e.right),r=36===t(e.width),l.style.position="absolute",i=12===t(l.offsetWidth/3),re.removeChild(u),l=null}}function t(e){return Math.round(parseFloat(e))}var n,r,i,o,a,s,u=E.createElement("div"),l=E.createElement("div");l.style&&(l.style.backgroundClip="content-box",l.cloneNode(!0).style.backgroundClip="",y.clearCloneStyle="content-box"===l.style.backgroundClip,S.extend(y,{boxSizingReliable:function(){return e(),r},pixelBoxStyles:function(){return e(),o},pixelPosition:function(){return e(),n},reliableMarginLeft:function(){return e(),s},scrollboxSize:function(){return e(),i},reliableTrDimensions:function(){var e,t,n,r;return null==a&&(e=E.createElement("table"),t=E.createElement("tr"),n=E.createElement("div"),e.style.cssText="position:absolute;left:-11111px;border-collapse:separate",t.style.cssText="border:1px solid",t.style.height="1px",n.style.height="9px",n.style.display="block",re.appendChild(e).appendChild(t).appendChild(n),r=C.getComputedStyle(t),a=parseInt(r.height,10)+parseInt(r.borderTopWidth,10)+parseInt(r.borderBottomWidth,10)===t.offsetHeight,re.removeChild(e)),a}}))}();var Be=["Webkit","Moz","ms"],$e=E.createElement("div").style,_e={};function ze(e){var t=S.cssProps[e]||_e[e];return t||(e in $e?e:_e[e]=function(e){var t=e[0].toUpperCase()+e.slice(1),n=Be.length;while(n--)if((e=Be[n]+t)in $e)return e}(e)||e)}var Ue=/^(none|table(?!-c[ea]).+)/,Xe=/^--/,Ve={position:"absolute",visibility:"hidden",display:"block"},Ge={letterSpacing:"0",fontWeight:"400"};function Ye(e,t,n){var r=te.exec(t);return r?Math.max(0,r[2]-(n||0))+(r[3]||"px"):t}function Qe(e,t,n,r,i,o){var a="width"===t?1:0,s=0,u=0;if(n===(r?"border":"content"))return 0;for(;a<4;a+=2)"margin"===n&&(u+=S.css(e,n+ne[a],!0,i)),r?("content"===n&&(u-=S.css(e,"padding"+ne[a],!0,i)),"margin"!==n&&(u-=S.css(e,"border"+ne[a]+"Width",!0,i))):(u+=S.css(e,"padding"+ne[a],!0,i),"padding"!==n?u+=S.css(e,"border"+ne[a]+"Width",!0,i):s+=S.css(e,"border"+ne[a]+"Width",!0,i));return!r&&0<=o&&(u+=Math.max(0,Math.ceil(e["offset"+t[0].toUpperCase()+t.slice(1)]-o-u-s-.5))||0),u}function Je(e,t,n){var r=Re(e),i=(!y.boxSizingReliable()||n)&&"border-box"===S.css(e,"boxSizing",!1,r),o=i,a=We(e,t,r),s="offset"+t[0].toUpperCase()+t.slice(1);if(Pe.test(a)){if(!n)return a;a="auto"}return(!y.boxSizingReliable()&&i||!y.reliableTrDimensions()&&A(e,"tr")||"auto"===a||!parseFloat(a)&&"inline"===S.css(e,"display",!1,r))&&e.getClientRects().length&&(i="border-box"===S.css(e,"boxSizing",!1,r),(o=s in e)&&(a=e[s])),(a=parseFloat(a)||0)+Qe(e,t,n||(i?"border":"content"),o,r,a)+"px"}function Ke(e,t,n,r,i){return new Ke.prototype.init(e,t,n,r,i)}S.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=We(e,"opacity");return""===n?"1":n}}}},cssNumber:{animationIterationCount:!0,columnCount:!0,fillOpacity:!0,flexGrow:!0,flexShrink:!0,fontWeight:!0,gridArea:!0,gridColumn:!0,gridColumnEnd:!0,gridColumnStart:!0,gridRow:!0,gridRowEnd:!0,gridRowStart:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,a,s=X(t),u=Xe.test(t),l=e.style;if(u||(t=ze(s)),a=S.cssHooks[t]||S.cssHooks[s],void 0===n)return a&&"get"in a&&void 0!==(i=a.get(e,!1,r))?i:l[t];"string"===(o=typeof n)&&(i=te.exec(n))&&i[1]&&(n=se(e,t,i),o="number"),null!=n&&n==n&&("number"!==o||u||(n+=i&&i[3]||(S.cssNumber[s]?"":"px")),y.clearCloneStyle||""!==n||0!==t.indexOf("background")||(l[t]="inherit"),a&&"set"in a&&void 0===(n=a.set(e,n,r))||(u?l.setProperty(t,n):l[t]=n))}},css:function(e,t,n,r){var i,o,a,s=X(t);return Xe.test(t)||(t=ze(s)),(a=S.cssHooks[t]||S.cssHooks[s])&&"get"in a&&(i=a.get(e,!0,n)),void 0===i&&(i=We(e,t,r)),"normal"===i&&t in Ge&&(i=Ge[t]),""===n||n?(o=parseFloat(i),!0===n||isFinite(o)?o||0:i):i}}),S.each(["height","width"],function(e,u){S.cssHooks[u]={get:function(e,t,n){if(t)return!Ue.test(S.css(e,"display"))||e.getClientRects().length&&e.getBoundingClientRect().width?Je(e,u,n):Me(e,Ve,function(){return Je(e,u,n)})},set:function(e,t,n){var r,i=Re(e),o=!y.scrollboxSize()&&"absolute"===i.position,a=(o||n)&&"border-box"===S.css(e,"boxSizing",!1,i),s=n?Qe(e,u,n,a,i):0;return a&&o&&(s-=Math.ceil(e["offset"+u[0].toUpperCase()+u.slice(1)]-parseFloat(i[u])-Qe(e,u,"border",!1,i)-.5)),s&&(r=te.exec(t))&&"px"!==(r[3]||"px")&&(e.style[u]=t,t=S.css(e,u)),Ye(0,t,s)}}}),S.cssHooks.marginLeft=Fe(y.reliableMarginLeft,function(e,t){if(t)return(parseFloat(We(e,"marginLeft"))||e.getBoundingClientRect().left-Me(e,{marginLeft:0},function(){return e.getBoundingClientRect().left}))+"px"}),S.each({margin:"",padding:"",border:"Width"},function(i,o){S.cssHooks[i+o]={expand:function(e){for(var t=0,n={},r="string"==typeof e?e.split(" "):[e];t<4;t++)n[i+ne[t]+o]=r[t]||r[t-2]||r[0];return n}},"margin"!==i&&(S.cssHooks[i+o].set=Ye)}),S.fn.extend({css:function(e,t){return $(this,function(e,t,n){var r,i,o={},a=0;if(Array.isArray(t)){for(r=Re(e),i=t.length;a<i;a++)o[t[a]]=S.css(e,t[a],!1,r);return o}return void 0!==n?S.style(e,t,n):S.css(e,t)},e,t,1<arguments.length)}}),((S.Tween=Ke).prototype={constructor:Ke,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||S.easing._default,this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(S.cssNumber[n]?"":"px")},cur:function(){var e=Ke.propHooks[this.prop];return e&&e.get?e.get(this):Ke.propHooks._default.get(this)},run:function(e){var t,n=Ke.propHooks[this.prop];return this.options.duration?this.pos=t=S.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):Ke.propHooks._default.set(this),this}}).init.prototype=Ke.prototype,(Ke.propHooks={_default:{get:function(e){var t;return 1!==e.elem.nodeType||null!=e.elem[e.prop]&&null==e.elem.style[e.prop]?e.elem[e.prop]:(t=S.css(e.elem,e.prop,""))&&"auto"!==t?t:0},set:function(e){S.fx.step[e.prop]?S.fx.step[e.prop](e):1!==e.elem.nodeType||!S.cssHooks[e.prop]&&null==e.elem.style[ze(e.prop)]?e.elem[e.prop]=e.now:S.style(e.elem,e.prop,e.now+e.unit)}}}).scrollTop=Ke.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},S.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2},_default:"swing"},S.fx=Ke.prototype.init,S.fx.step={};var Ze,et,tt,nt,rt=/^(?:toggle|show|hide)$/,it=/queueHooks$/;function ot(){et&&(!1===E.hidden&&C.requestAnimationFrame?C.requestAnimationFrame(ot):C.setTimeout(ot,S.fx.interval),S.fx.tick())}function at(){return C.setTimeout(function(){Ze=void 0}),Ze=Date.now()}function st(e,t){var n,r=0,i={height:e};for(t=t?1:0;r<4;r+=2-t)i["margin"+(n=ne[r])]=i["padding"+n]=e;return t&&(i.opacity=i.width=e),i}function ut(e,t,n){for(var r,i=(lt.tweeners[t]||[]).concat(lt.tweeners["*"]),o=0,a=i.length;o<a;o++)if(r=i[o].call(n,t,e))return r}function lt(o,e,t){var n,a,r=0,i=lt.prefilters.length,s=S.Deferred().always(function(){delete u.elem}),u=function(){if(a)return!1;for(var e=Ze||at(),t=Math.max(0,l.startTime+l.duration-e),n=1-(t/l.duration||0),r=0,i=l.tweens.length;r<i;r++)l.tweens[r].run(n);return s.notifyWith(o,[l,n,t]),n<1&&i?t:(i||s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l]),!1)},l=s.promise({elem:o,props:S.extend({},e),opts:S.extend(!0,{specialEasing:{},easing:S.easing._default},t),originalProperties:e,originalOptions:t,startTime:Ze||at(),duration:t.duration,tweens:[],createTween:function(e,t){var n=S.Tween(o,l.opts,e,t,l.opts.specialEasing[e]||l.opts.easing);return l.tweens.push(n),n},stop:function(e){var t=0,n=e?l.tweens.length:0;if(a)return this;for(a=!0;t<n;t++)l.tweens[t].run(1);return e?(s.notifyWith(o,[l,1,0]),s.resolveWith(o,[l,e])):s.rejectWith(o,[l,e]),this}}),c=l.props;for(!function(e,t){var n,r,i,o,a;for(n in e)if(i=t[r=X(n)],o=e[n],Array.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),(a=S.cssHooks[r])&&"expand"in a)for(n in o=a.expand(o),delete e[r],o)n in e||(e[n]=o[n],t[n]=i);else t[r]=i}(c,l.opts.specialEasing);r<i;r++)if(n=lt.prefilters[r].call(l,o,c,l.opts))return m(n.stop)&&(S._queueHooks(l.elem,l.opts.queue).stop=n.stop.bind(n)),n;return S.map(c,ut,l),m(l.opts.start)&&l.opts.start.call(o,l),l.progress(l.opts.progress).done(l.opts.done,l.opts.complete).fail(l.opts.fail).always(l.opts.always),S.fx.timer(S.extend(u,{elem:o,anim:l,queue:l.opts.queue})),l}S.Animation=S.extend(lt,{tweeners:{"*":[function(e,t){var n=this.createTween(e,t);return se(n.elem,e,te.exec(t),n),n}]},tweener:function(e,t){m(e)?(t=e,e=["*"]):e=e.match(P);for(var n,r=0,i=e.length;r<i;r++)n=e[r],lt.tweeners[n]=lt.tweeners[n]||[],lt.tweeners[n].unshift(t)},prefilters:[function(e,t,n){var r,i,o,a,s,u,l,c,f="width"in t||"height"in t,p=this,d={},h=e.style,g=e.nodeType&&ae(e),v=Y.get(e,"fxshow");for(r in n.queue||(null==(a=S._queueHooks(e,"fx")).unqueued&&(a.unqueued=0,s=a.empty.fire,a.empty.fire=function(){a.unqueued||s()}),a.unqueued++,p.always(function(){p.always(function(){a.unqueued--,S.queue(e,"fx").length||a.empty.fire()})})),t)if(i=t[r],rt.test(i)){if(delete t[r],o=o||"toggle"===i,i===(g?"hide":"show")){if("show"!==i||!v||void 0===v[r])continue;g=!0}d[r]=v&&v[r]||S.style(e,r)}if((u=!S.isEmptyObject(t))||!S.isEmptyObject(d))for(r in f&&1===e.nodeType&&(n.overflow=[h.overflow,h.overflowX,h.overflowY],null==(l=v&&v.display)&&(l=Y.get(e,"display")),"none"===(c=S.css(e,"display"))&&(l?c=l:(le([e],!0),l=e.style.display||l,c=S.css(e,"display"),le([e]))),("inline"===c||"inline-block"===c&&null!=l)&&"none"===S.css(e,"float")&&(u||(p.done(function(){h.display=l}),null==l&&(c=h.display,l="none"===c?"":c)),h.display="inline-block")),n.overflow&&(h.overflow="hidden",p.always(function(){h.overflow=n.overflow[0],h.overflowX=n.overflow[1],h.overflowY=n.overflow[2]})),u=!1,d)u||(v?"hidden"in v&&(g=v.hidden):v=Y.access(e,"fxshow",{display:l}),o&&(v.hidden=!g),g&&le([e],!0),p.done(function(){for(r in g||le([e]),Y.remove(e,"fxshow"),d)S.style(e,r,d[r])})),u=ut(g?v[r]:0,r,p),r in v||(v[r]=u.start,g&&(u.end=u.start,u.start=0))}],prefilter:function(e,t){t?lt.prefilters.unshift(e):lt.prefilters.push(e)}}),S.speed=function(e,t,n){var r=e&&"object"==typeof e?S.extend({},e):{complete:n||!n&&t||m(e)&&e,duration:e,easing:n&&t||t&&!m(t)&&t};return S.fx.off?r.duration=0:"number"!=typeof r.duration&&(r.duration in S.fx.speeds?r.duration=S.fx.speeds[r.duration]:r.duration=S.fx.speeds._default),null!=r.queue&&!0!==r.queue||(r.queue="fx"),r.old=r.complete,r.complete=function(){m(r.old)&&r.old.call(this),r.queue&&S.dequeue(this,r.queue)},r},S.fn.extend({fadeTo:function(e,t,n,r){return this.filter(ae).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(t,e,n,r){var i=S.isEmptyObject(t),o=S.speed(e,n,r),a=function(){var e=lt(this,S.extend({},t),o);(i||Y.get(this,"finish"))&&e.stop(!0)};return a.finish=a,i||!1===o.queue?this.each(a):this.queue(o.queue,a)},stop:function(i,e,o){var a=function(e){var t=e.stop;delete e.stop,t(o)};return"string"!=typeof i&&(o=e,e=i,i=void 0),e&&this.queue(i||"fx",[]),this.each(function(){var e=!0,t=null!=i&&i+"queueHooks",n=S.timers,r=Y.get(this);if(t)r[t]&&r[t].stop&&a(r[t]);else for(t in r)r[t]&&r[t].stop&&it.test(t)&&a(r[t]);for(t=n.length;t--;)n[t].elem!==this||null!=i&&n[t].queue!==i||(n[t].anim.stop(o),e=!1,n.splice(t,1));!e&&o||S.dequeue(this,i)})},finish:function(a){return!1!==a&&(a=a||"fx"),this.each(function(){var e,t=Y.get(this),n=t[a+"queue"],r=t[a+"queueHooks"],i=S.timers,o=n?n.length:0;for(t.finish=!0,S.queue(this,a,[]),r&&r.stop&&r.stop.call(this,!0),e=i.length;e--;)i[e].elem===this&&i[e].queue===a&&(i[e].anim.stop(!0),i.splice(e,1));for(e=0;e<o;e++)n[e]&&n[e].finish&&n[e].finish.call(this);delete t.finish})}}),S.each(["toggle","show","hide"],function(e,r){var i=S.fn[r];S.fn[r]=function(e,t,n){return null==e||"boolean"==typeof e?i.apply(this,arguments):this.animate(st(r,!0),e,t,n)}}),S.each({slideDown:st("show"),slideUp:st("hide"),slideToggle:st("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,r){S.fn[e]=function(e,t,n){return this.animate(r,e,t,n)}}),S.timers=[],S.fx.tick=function(){var e,t=0,n=S.timers;for(Ze=Date.now();t<n.length;t++)(e=n[t])()||n[t]!==e||n.splice(t--,1);n.length||S.fx.stop(),Ze=void 0},S.fx.timer=function(e){S.timers.push(e),S.fx.start()},S.fx.interval=13,S.fx.start=function(){et||(et=!0,ot())},S.fx.stop=function(){et=null},S.fx.speeds={slow:600,fast:200,_default:400},S.fn.delay=function(r,e){return r=S.fx&&S.fx.speeds[r]||r,e=e||"fx",this.queue(e,function(e,t){var n=C.setTimeout(e,r);t.stop=function(){C.clearTimeout(n)}})},tt=E.createElement("input"),nt=E.createElement("select").appendChild(E.createElement("option")),tt.type="checkbox",y.checkOn=""!==tt.value,y.optSelected=nt.selected,(tt=E.createElement("input")).value="t",tt.type="radio",y.radioValue="t"===tt.value;var ct,ft=S.expr.attrHandle;S.fn.extend({attr:function(e,t){return $(this,S.attr,e,t,1<arguments.length)},removeAttr:function(e){return this.each(function(){S.removeAttr(this,e)})}}),S.extend({attr:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return"undefined"==typeof e.getAttribute?S.prop(e,t,n):(1===o&&S.isXMLDoc(e)||(i=S.attrHooks[t.toLowerCase()]||(S.expr.match.bool.test(t)?ct:void 0)),void 0!==n?null===n?void S.removeAttr(e,t):i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:(e.setAttribute(t,n+""),n):i&&"get"in i&&null!==(r=i.get(e,t))?r:null==(r=S.find.attr(e,t))?void 0:r)},attrHooks:{type:{set:function(e,t){if(!y.radioValue&&"radio"===t&&A(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},removeAttr:function(e,t){var n,r=0,i=t&&t.match(P);if(i&&1===e.nodeType)while(n=i[r++])e.removeAttribute(n)}}),ct={set:function(e,t,n){return!1===t?S.removeAttr(e,n):e.setAttribute(n,n),n}},S.each(S.expr.match.bool.source.match(/\w+/g),function(e,t){var a=ft[t]||S.find.attr;ft[t]=function(e,t,n){var r,i,o=t.toLowerCase();return n||(i=ft[o],ft[o]=r,r=null!=a(e,t,n)?o:null,ft[o]=i),r}});var pt=/^(?:input|select|textarea|button)$/i,dt=/^(?:a|area)$/i;function ht(e){return(e.match(P)||[]).join(" ")}function gt(e){return e.getAttribute&&e.getAttribute("class")||""}function vt(e){return Array.isArray(e)?e:"string"==typeof e&&e.match(P)||[]}S.fn.extend({prop:function(e,t){return $(this,S.prop,e,t,1<arguments.length)},removeProp:function(e){return this.each(function(){delete this[S.propFix[e]||e]})}}),S.extend({prop:function(e,t,n){var r,i,o=e.nodeType;if(3!==o&&8!==o&&2!==o)return 1===o&&S.isXMLDoc(e)||(t=S.propFix[t]||t,i=S.propHooks[t]),void 0!==n?i&&"set"in i&&void 0!==(r=i.set(e,n,t))?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){var t=S.find.attr(e,"tabindex");return t?parseInt(t,10):pt.test(e.nodeName)||dt.test(e.nodeName)&&e.href?0:-1}}},propFix:{"for":"htmlFor","class":"className"}}),y.optSelected||(S.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null},set:function(e){var t=e.parentNode;t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex)}}),S.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){S.propFix[this.toLowerCase()]=this}),S.fn.extend({addClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).addClass(t.call(this,e,gt(this)))});if((e=vt(t)).length)while(n=this[u++])if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=e[a++])r.indexOf(" "+o+" ")<0&&(r+=o+" ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},removeClass:function(t){var e,n,r,i,o,a,s,u=0;if(m(t))return this.each(function(e){S(this).removeClass(t.call(this,e,gt(this)))});if(!arguments.length)return this.attr("class","");if((e=vt(t)).length)while(n=this[u++])if(i=gt(n),r=1===n.nodeType&&" "+ht(i)+" "){a=0;while(o=e[a++])while(-1<r.indexOf(" "+o+" "))r=r.replace(" "+o+" "," ");i!==(s=ht(r))&&n.setAttribute("class",s)}return this},toggleClass:function(i,t){var o=typeof i,a="string"===o||Array.isArray(i);return"boolean"==typeof t&&a?t?this.addClass(i):this.removeClass(i):m(i)?this.each(function(e){S(this).toggleClass(i.call(this,e,gt(this),t),t)}):this.each(function(){var e,t,n,r;if(a){t=0,n=S(this),r=vt(i);while(e=r[t++])n.hasClass(e)?n.removeClass(e):n.addClass(e)}else void 0!==i&&"boolean"!==o||((e=gt(this))&&Y.set(this,"__className__",e),this.setAttribute&&this.setAttribute("class",e||!1===i?"":Y.get(this,"__className__")||""))})},hasClass:function(e){var t,n,r=0;t=" "+e+" ";while(n=this[r++])if(1===n.nodeType&&-1<(" "+ht(gt(n))+" ").indexOf(t))return!0;return!1}});var yt=/\r/g;S.fn.extend({val:function(n){var r,e,i,t=this[0];return arguments.length?(i=m(n),this.each(function(e){var t;1===this.nodeType&&(null==(t=i?n.call(this,e,S(this).val()):n)?t="":"number"==typeof t?t+="":Array.isArray(t)&&(t=S.map(t,function(e){return null==e?"":e+""})),(r=S.valHooks[this.type]||S.valHooks[this.nodeName.toLowerCase()])&&"set"in r&&void 0!==r.set(this,t,"value")||(this.value=t))})):t?(r=S.valHooks[t.type]||S.valHooks[t.nodeName.toLowerCase()])&&"get"in r&&void 0!==(e=r.get(t,"value"))?e:"string"==typeof(e=t.value)?e.replace(yt,""):null==e?"":e:void 0}}),S.extend({valHooks:{option:{get:function(e){var t=S.find.attr(e,"value");return null!=t?t:ht(S.text(e))}},select:{get:function(e){var t,n,r,i=e.options,o=e.selectedIndex,a="select-one"===e.type,s=a?null:[],u=a?o+1:i.length;for(r=o<0?u:a?o:0;r<u;r++)if(((n=i[r]).selected||r===o)&&!n.disabled&&(!n.parentNode.disabled||!A(n.parentNode,"optgroup"))){if(t=S(n).val(),a)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=S.makeArray(t),a=i.length;while(a--)((r=i[a]).selected=-1<S.inArray(S.valHooks.option.get(r),o))&&(n=!0);return n||(e.selectedIndex=-1),o}}}}),S.each(["radio","checkbox"],function(){S.valHooks[this]={set:function(e,t){if(Array.isArray(t))return e.checked=-1<S.inArray(S(e).val(),t)}},y.checkOn||(S.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})}),y.focusin="onfocusin"in C;var mt=/^(?:focusinfocus|focusoutblur)$/,xt=function(e){e.stopPropagation()};S.extend(S.event,{trigger:function(e,t,n,r){var i,o,a,s,u,l,c,f,p=[n||E],d=v.call(e,"type")?e.type:e,h=v.call(e,"namespace")?e.namespace.split("."):[];if(o=f=a=n=n||E,3!==n.nodeType&&8!==n.nodeType&&!mt.test(d+S.event.triggered)&&(-1<d.indexOf(".")&&(d=(h=d.split(".")).shift(),h.sort()),u=d.indexOf(":")<0&&"on"+d,(e=e[S.expando]?e:new S.Event(d,"object"==typeof e&&e)).isTrigger=r?2:3,e.namespace=h.join("."),e.rnamespace=e.namespace?new RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,e.result=void 0,e.target||(e.target=n),t=null==t?[e]:S.makeArray(t,[e]),c=S.event.special[d]||{},r||!c.trigger||!1!==c.trigger.apply(n,t))){if(!r&&!c.noBubble&&!x(n)){for(s=c.delegateType||d,mt.test(s+d)||(o=o.parentNode);o;o=o.parentNode)p.push(o),a=o;a===(n.ownerDocument||E)&&p.push(a.defaultView||a.parentWindow||C)}i=0;while((o=p[i++])&&!e.isPropagationStopped())f=o,e.type=1<i?s:c.bindType||d,(l=(Y.get(o,"events")||Object.create(null))[e.type]&&Y.get(o,"handle"))&&l.apply(o,t),(l=u&&o[u])&&l.apply&&V(o)&&(e.result=l.apply(o,t),!1===e.result&&e.preventDefault());return e.type=d,r||e.isDefaultPrevented()||c._default&&!1!==c._default.apply(p.pop(),t)||!V(n)||u&&m(n[d])&&!x(n)&&((a=n[u])&&(n[u]=null),S.event.triggered=d,e.isPropagationStopped()&&f.addEventListener(d,xt),n[d](),e.isPropagationStopped()&&f.removeEventListener(d,xt),S.event.triggered=void 0,a&&(n[u]=a)),e.result}},simulate:function(e,t,n){var r=S.extend(new S.Event,n,{type:e,isSimulated:!0});S.event.trigger(r,null,t)}}),S.fn.extend({trigger:function(e,t){return this.each(function(){S.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];if(n)return S.event.trigger(e,t,n,!0)}}),y.focusin||S.each({focus:"focusin",blur:"focusout"},function(n,r){var i=function(e){S.event.simulate(r,e.target,S.event.fix(e))};S.event.special[r]={setup:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r);t||e.addEventListener(n,i,!0),Y.access(e,r,(t||0)+1)},teardown:function(){var e=this.ownerDocument||this.document||this,t=Y.access(e,r)-1;t?Y.access(e,r,t):(e.removeEventListener(n,i,!0),Y.remove(e,r))}}});var bt=C.location,wt={guid:Date.now()},Tt=/\?/;S.parseXML=function(e){var t,n;if(!e||"string"!=typeof e)return null;try{t=(new C.DOMParser).parseFromString(e,"text/xml")}catch(e){}return n=t&&t.getElementsByTagName("parsererror")[0],t&&!n||S.error("Invalid XML: "+(n?S.map(n.childNodes,function(e){return e.textContent}).join("\n"):e)),t};var Ct=/\[\]$/,Et=/\r?\n/g,St=/^(?:submit|button|image|reset|file)$/i,kt=/^(?:input|select|textarea|keygen)/i;function At(n,e,r,i){var t;if(Array.isArray(e))S.each(e,function(e,t){r||Ct.test(n)?i(n,t):At(n+"["+("object"==typeof t&&null!=t?e:"")+"]",t,r,i)});else if(r||"object"!==w(e))i(n,e);else for(t in e)At(n+"["+t+"]",e[t],r,i)}S.param=function(e,t){var n,r=[],i=function(e,t){var n=m(t)?t():t;r[r.length]=encodeURIComponent(e)+"="+encodeURIComponent(null==n?"":n)};if(null==e)return"";if(Array.isArray(e)||e.jquery&&!S.isPlainObject(e))S.each(e,function(){i(this.name,this.value)});else for(n in e)At(n,e[n],t,i);return r.join("&")},S.fn.extend({serialize:function(){return S.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=S.prop(this,"elements");return e?S.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!S(this).is(":disabled")&&kt.test(this.nodeName)&&!St.test(e)&&(this.checked||!pe.test(e))}).map(function(e,t){var n=S(this).val();return null==n?null:Array.isArray(n)?S.map(n,function(e){return{name:t.name,value:e.replace(Et,"\r\n")}}):{name:t.name,value:n.replace(Et,"\r\n")}}).get()}});var Nt=/%20/g,jt=/#.*$/,Dt=/([?&])_=[^&]*/,qt=/^(.*?):[ \t]*([^\r\n]*)$/gm,Lt=/^(?:GET|HEAD)$/,Ht=/^\/\//,Ot={},Pt={},Rt="*/".concat("*"),Mt=E.createElement("a");function It(o){return function(e,t){"string"!=typeof e&&(t=e,e="*");var n,r=0,i=e.toLowerCase().match(P)||[];if(m(t))while(n=i[r++])"+"===n[0]?(n=n.slice(1)||"*",(o[n]=o[n]||[]).unshift(t)):(o[n]=o[n]||[]).push(t)}}function Wt(t,i,o,a){var s={},u=t===Pt;function l(e){var r;return s[e]=!0,S.each(t[e]||[],function(e,t){var n=t(i,o,a);return"string"!=typeof n||u||s[n]?u?!(r=n):void 0:(i.dataTypes.unshift(n),l(n),!1)}),r}return l(i.dataTypes[0])||!s["*"]&&l("*")}function Ft(e,t){var n,r,i=S.ajaxSettings.flatOptions||{};for(n in t)void 0!==t[n]&&((i[n]?e:r||(r={}))[n]=t[n]);return r&&S.extend(!0,e,r),e}Mt.href=bt.href,S.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:bt.href,type:"GET",isLocal:/^(?:about|app|app-storage|.+-extension|file|res|widget):$/.test(bt.protocol),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Rt,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/\bxml\b/,html:/\bhtml/,json:/\bjson\b/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":JSON.parse,"text xml":S.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?Ft(Ft(e,S.ajaxSettings),t):Ft(S.ajaxSettings,e)},ajaxPrefilter:It(Ot),ajaxTransport:It(Pt),ajax:function(e,t){"object"==typeof e&&(t=e,e=void 0),t=t||{};var c,f,p,n,d,r,h,g,i,o,v=S.ajaxSetup({},t),y=v.context||v,m=v.context&&(y.nodeType||y.jquery)?S(y):S.event,x=S.Deferred(),b=S.Callbacks("once memory"),w=v.statusCode||{},a={},s={},u="canceled",T={readyState:0,getResponseHeader:function(e){var t;if(h){if(!n){n={};while(t=qt.exec(p))n[t[1].toLowerCase()+" "]=(n[t[1].toLowerCase()+" "]||[]).concat(t[2])}t=n[e.toLowerCase()+" "]}return null==t?null:t.join(", ")},getAllResponseHeaders:function(){return h?p:null},setRequestHeader:function(e,t){return null==h&&(e=s[e.toLowerCase()]=s[e.toLowerCase()]||e,a[e]=t),this},overrideMimeType:function(e){return null==h&&(v.mimeType=e),this},statusCode:function(e){var t;if(e)if(h)T.always(e[T.status]);else for(t in e)w[t]=[w[t],e[t]];return this},abort:function(e){var t=e||u;return c&&c.abort(t),l(0,t),this}};if(x.promise(T),v.url=((e||v.url||bt.href)+"").replace(Ht,bt.protocol+"//"),v.type=t.method||t.type||v.method||v.type,v.dataTypes=(v.dataType||"*").toLowerCase().match(P)||[""],null==v.crossDomain){r=E.createElement("a");try{r.href=v.url,r.href=r.href,v.crossDomain=Mt.protocol+"//"+Mt.host!=r.protocol+"//"+r.host}catch(e){v.crossDomain=!0}}if(v.data&&v.processData&&"string"!=typeof v.data&&(v.data=S.param(v.data,v.traditional)),Wt(Ot,v,t,T),h)return T;for(i in(g=S.event&&v.global)&&0==S.active++&&S.event.trigger("ajaxStart"),v.type=v.type.toUpperCase(),v.hasContent=!Lt.test(v.type),f=v.url.replace(jt,""),v.hasContent?v.data&&v.processData&&0===(v.contentType||"").indexOf("application/x-www-form-urlencoded")&&(v.data=v.data.replace(Nt,"+")):(o=v.url.slice(f.length),v.data&&(v.processData||"string"==typeof v.data)&&(f+=(Tt.test(f)?"&":"?")+v.data,delete v.data),!1===v.cache&&(f=f.replace(Dt,"$1"),o=(Tt.test(f)?"&":"?")+"_="+wt.guid+++o),v.url=f+o),v.ifModified&&(S.lastModified[f]&&T.setRequestHeader("If-Modified-Since",S.lastModified[f]),S.etag[f]&&T.setRequestHeader("If-None-Match",S.etag[f])),(v.data&&v.hasContent&&!1!==v.contentType||t.contentType)&&T.setRequestHeader("Content-Type",v.contentType),T.setRequestHeader("Accept",v.dataTypes[0]&&v.accepts[v.dataTypes[0]]?v.accepts[v.dataTypes[0]]+("*"!==v.dataTypes[0]?", "+Rt+"; q=0.01":""):v.accepts["*"]),v.headers)T.setRequestHeader(i,v.headers[i]);if(v.beforeSend&&(!1===v.beforeSend.call(y,T,v)||h))return T.abort();if(u="abort",b.add(v.complete),T.done(v.success),T.fail(v.error),c=Wt(Pt,v,t,T)){if(T.readyState=1,g&&m.trigger("ajaxSend",[T,v]),h)return T;v.async&&0<v.timeout&&(d=C.setTimeout(function(){T.abort("timeout")},v.timeout));try{h=!1,c.send(a,l)}catch(e){if(h)throw e;l(-1,e)}}else l(-1,"No Transport");function l(e,t,n,r){var i,o,a,s,u,l=t;h||(h=!0,d&&C.clearTimeout(d),c=void 0,p=r||"",T.readyState=0<e?4:0,i=200<=e&&e<300||304===e,n&&(s=function(e,t,n){var r,i,o,a,s=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),void 0===r&&(r=e.mimeType||t.getResponseHeader("Content-Type"));if(r)for(i in s)if(s[i]&&s[i].test(r)){u.unshift(i);break}if(u[0]in n)o=u[0];else{for(i in n){if(!u[0]||e.converters[i+" "+u[0]]){o=i;break}a||(a=i)}o=o||a}if(o)return o!==u[0]&&u.unshift(o),n[o]}(v,T,n)),!i&&-1<S.inArray("script",v.dataTypes)&&S.inArray("json",v.dataTypes)<0&&(v.converters["text script"]=function(){}),s=function(e,t,n,r){var i,o,a,s,u,l={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)l[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!u&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),u=o,o=c.shift())if("*"===o)o=u;else if("*"!==u&&u!==o){if(!(a=l[u+" "+o]||l["* "+o]))for(i in l)if((s=i.split(" "))[1]===o&&(a=l[u+" "+s[0]]||l["* "+s[0]])){!0===a?a=l[i]:!0!==l[i]&&(o=s[0],c.unshift(s[1]));break}if(!0!==a)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(e){return{state:"parsererror",error:a?e:"No conversion from "+u+" to "+o}}}return{state:"success",data:t}}(v,s,T,i),i?(v.ifModified&&((u=T.getResponseHeader("Last-Modified"))&&(S.lastModified[f]=u),(u=T.getResponseHeader("etag"))&&(S.etag[f]=u)),204===e||"HEAD"===v.type?l="nocontent":304===e?l="notmodified":(l=s.state,o=s.data,i=!(a=s.error))):(a=l,!e&&l||(l="error",e<0&&(e=0))),T.status=e,T.statusText=(t||l)+"",i?x.resolveWith(y,[o,l,T]):x.rejectWith(y,[T,l,a]),T.statusCode(w),w=void 0,g&&m.trigger(i?"ajaxSuccess":"ajaxError",[T,v,i?o:a]),b.fireWith(y,[T,l]),g&&(m.trigger("ajaxComplete",[T,v]),--S.active||S.event.trigger("ajaxStop")))}return T},getJSON:function(e,t,n){return S.get(e,t,n,"json")},getScript:function(e,t){return S.get(e,void 0,t,"script")}}),S.each(["get","post"],function(e,i){S[i]=function(e,t,n,r){return m(t)&&(r=r||n,n=t,t=void 0),S.ajax(S.extend({url:e,type:i,dataType:r,data:t,success:n},S.isPlainObject(e)&&e))}}),S.ajaxPrefilter(function(e){var t;for(t in e.headers)"content-type"===t.toLowerCase()&&(e.contentType=e.headers[t]||"")}),S._evalUrl=function(e,t,n){return S.ajax({url:e,type:"GET",dataType:"script",cache:!0,async:!1,global:!1,converters:{"text script":function(){}},dataFilter:function(e){S.globalEval(e,t,n)}})},S.fn.extend({wrapAll:function(e){var t;return this[0]&&(m(e)&&(e=e.call(this[0])),t=S(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this},wrapInner:function(n){return m(n)?this.each(function(e){S(this).wrapInner(n.call(this,e))}):this.each(function(){var e=S(this),t=e.contents();t.length?t.wrapAll(n):e.append(n)})},wrap:function(t){var n=m(t);return this.each(function(e){S(this).wrapAll(n?t.call(this,e):t)})},unwrap:function(e){return this.parent(e).not("body").each(function(){S(this).replaceWith(this.childNodes)}),this}}),S.expr.pseudos.hidden=function(e){return!S.expr.pseudos.visible(e)},S.expr.pseudos.visible=function(e){return!!(e.offsetWidth||e.offsetHeight||e.getClientRects().length)},S.ajaxSettings.xhr=function(){try{return new C.XMLHttpRequest}catch(e){}};var Bt={0:200,1223:204},$t=S.ajaxSettings.xhr();y.cors=!!$t&&"withCredentials"in $t,y.ajax=$t=!!$t,S.ajaxTransport(function(i){var o,a;if(y.cors||$t&&!i.crossDomain)return{send:function(e,t){var n,r=i.xhr();if(r.open(i.type,i.url,i.async,i.username,i.password),i.xhrFields)for(n in i.xhrFields)r[n]=i.xhrFields[n];for(n in i.mimeType&&r.overrideMimeType&&r.overrideMimeType(i.mimeType),i.crossDomain||e["X-Requested-With"]||(e["X-Requested-With"]="XMLHttpRequest"),e)r.setRequestHeader(n,e[n]);o=function(e){return function(){o&&(o=a=r.onload=r.onerror=r.onabort=r.ontimeout=r.onreadystatechange=null,"abort"===e?r.abort():"error"===e?"number"!=typeof r.status?t(0,"error"):t(r.status,r.statusText):t(Bt[r.status]||r.status,r.statusText,"text"!==(r.responseType||"text")||"string"!=typeof r.responseText?{binary:r.response}:{text:r.responseText},r.getAllResponseHeaders()))}},r.onload=o(),a=r.onerror=r.ontimeout=o("error"),void 0!==r.onabort?r.onabort=a:r.onreadystatechange=function(){4===r.readyState&&C.setTimeout(function(){o&&a()})},o=o("abort");try{r.send(i.hasContent&&i.data||null)}catch(e){if(o)throw e}},abort:function(){o&&o()}}}),S.ajaxPrefilter(function(e){e.crossDomain&&(e.contents.script=!1)}),S.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/\b(?:java|ecma)script\b/},converters:{"text script":function(e){return S.globalEval(e),e}}}),S.ajaxPrefilter("script",function(e){void 0===e.cache&&(e.cache=!1),e.crossDomain&&(e.type="GET")}),S.ajaxTransport("script",function(n){var r,i;if(n.crossDomain||n.scriptAttrs)return{send:function(e,t){r=S("<script>").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var _t,zt=[],Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="<form></form><form></form>",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1<s&&(r=ht(e.slice(s)),e=e.slice(0,s)),m(t)?(n=t,t=void 0):t&&"object"==typeof t&&(i="POST"),0<a.length&&S.ajax({url:e,type:i||"GET",dataType:"html",data:t}).done(function(e){o=arguments,a.html(r?S("<div>").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0<arguments.length?this.on(n,null,e,t):this.trigger(n)}});var Xt=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g;S.proxy=function(e,t){var n,r,i;if("string"==typeof t&&(n=e[t],t=e,e=n),m(e))return r=s.call(arguments,2),(i=function(){return e.apply(t||this,r.concat(s.call(arguments)))}).guid=e.guid=e.guid||S.guid++,i},S.holdReady=function(e){e?S.readyWait++:S.ready(!0)},S.isArray=Array.isArray,S.parseJSON=JSON.parse,S.nodeName=A,S.isFunction=m,S.isWindow=x,S.camelCase=X,S.type=w,S.now=Date.now,S.isNumeric=function(e){var t=S.type(e);return("number"===t||"string"===t)&&!isNaN(e-parseFloat(e))},S.trim=function(e){return null==e?"":(e+"").replace(Xt,"")},"function"==typeof define&&define.amd&&define("jquery",[],function(){return S});var Vt=C.jQuery,Gt=C.$;return S.noConflict=function(e){return C.$===S&&(C.$=Gt),e&&C.jQuery===S&&(C.jQuery=Vt),S},"undefined"==typeof e&&(C.jQuery=C.$=S),S});
diff --git a/js/modernizr-2.8.3.min.js b/js/modernizr-2.8.3.min.js
deleted file mode 100755
index 40dd2a9..0000000
--- a/js/modernizr-2.8.3.min.js
+++ /dev/null
@@ -1 +0,0 @@
-window.Modernizr=function(e,t,n){function r(e){b.cssText=e}function o(e,t){return r(S.join(e+";")+(t||""))}function a(e,t){return typeof e===t}function i(e,t){return!!~(""+e).indexOf(t)}function c(e,t){for(var r in e){var o=e[r];if(!i(o,"-")&&b[o]!==n)return"pfx"==t?o:!0}return!1}function s(e,t,r){for(var o in e){var i=t[e[o]];if(i!==n)return r===!1?e[o]:a(i,"function")?i.bind(r||t):i}return!1}function u(e,t,n){var r=e.charAt(0).toUpperCase()+e.slice(1),o=(e+" "+k.join(r+" ")+r).split(" ");return a(t,"string")||a(t,"undefined")?c(o,t):(o=(e+" "+T.join(r+" ")+r).split(" "),s(o,t,n))}function l(){p.input=function(n){for(var r=0,o=n.length;o>r;r++)j[n[r]]=!!(n[r]in E);return j.list&&(j.list=!(!t.createElement("datalist")||!e.HTMLDataListElement)),j}("autocomplete autofocus list placeholder max min multiple pattern required step".split(" ")),p.inputtypes=function(e){for(var r,o,a,i=0,c=e.length;c>i;i++)E.setAttribute("type",o=e[i]),r="text"!==E.type,r&&(E.value=x,E.style.cssText="position:absolute;visibility:hidden;",/^range$/.test(o)&&E.style.WebkitAppearance!==n?(g.appendChild(E),a=t.defaultView,r=a.getComputedStyle&&"textfield"!==a.getComputedStyle(E,null).WebkitAppearance&&0!==E.offsetHeight,g.removeChild(E)):/^(search|tel)$/.test(o)||(r=/^(url|email)$/.test(o)?E.checkValidity&&E.checkValidity()===!1:E.value!=x)),P[e[i]]=!!r;return P}("search tel url email datetime date month week time datetime-local number range color".split(" "))}var d,f,m="2.8.3",p={},h=!0,g=t.documentElement,v="modernizr",y=t.createElement(v),b=y.style,E=t.createElement("input"),x=":)",w={}.toString,S=" -webkit- -moz- -o- -ms- ".split(" "),C="Webkit Moz O ms",k=C.split(" "),T=C.toLowerCase().split(" "),N={svg:"http://www.w3.org/2000/svg"},M={},P={},j={},$=[],D=$.slice,F=function(e,n,r,o){var a,i,c,s,u=t.createElement("div"),l=t.body,d=l||t.createElement("body");if(parseInt(r,10))for(;r--;)c=t.createElement("div"),c.id=o?o[r]:v+(r+1),u.appendChild(c);return a=["&#173;",'<style id="s',v,'">',e,"</style>"].join(""),u.id=v,(l?u:d).innerHTML+=a,d.appendChild(u),l||(d.style.background="",d.style.overflow="hidden",s=g.style.overflow,g.style.overflow="hidden",g.appendChild(d)),i=n(u,e),l?u.parentNode.removeChild(u):(d.parentNode.removeChild(d),g.style.overflow=s),!!i},z=function(t){var n=e.matchMedia||e.msMatchMedia;if(n)return n(t)&&n(t).matches||!1;var r;return F("@media "+t+" { #"+v+" { position: absolute; } }",function(t){r="absolute"==(e.getComputedStyle?getComputedStyle(t,null):t.currentStyle).position}),r},A=function(){function e(e,o){o=o||t.createElement(r[e]||"div"),e="on"+e;var i=e in o;return i||(o.setAttribute||(o=t.createElement("div")),o.setAttribute&&o.removeAttribute&&(o.setAttribute(e,""),i=a(o[e],"function"),a(o[e],"undefined")||(o[e]=n),o.removeAttribute(e))),o=null,i}var r={select:"input",change:"input",submit:"form",reset:"form",error:"img",load:"img",abort:"img"};return e}(),L={}.hasOwnProperty;f=a(L,"undefined")||a(L.call,"undefined")?function(e,t){return t in e&&a(e.constructor.prototype[t],"undefined")}:function(e,t){return L.call(e,t)},Function.prototype.bind||(Function.prototype.bind=function(e){var t=this;if("function"!=typeof t)throw new TypeError;var n=D.call(arguments,1),r=function(){if(this instanceof r){var o=function(){};o.prototype=t.prototype;var a=new o,i=t.apply(a,n.concat(D.call(arguments)));return Object(i)===i?i:a}return t.apply(e,n.concat(D.call(arguments)))};return r}),M.flexbox=function(){return u("flexWrap")},M.flexboxlegacy=function(){return u("boxDirection")},M.canvas=function(){var e=t.createElement("canvas");return!(!e.getContext||!e.getContext("2d"))},M.canvastext=function(){return!(!p.canvas||!a(t.createElement("canvas").getContext("2d").fillText,"function"))},M.webgl=function(){return!!e.WebGLRenderingContext},M.touch=function(){var n;return"ontouchstart"in e||e.DocumentTouch&&t instanceof DocumentTouch?n=!0:F(["@media (",S.join("touch-enabled),("),v,")","{#modernizr{top:9px;position:absolute}}"].join(""),function(e){n=9===e.offsetTop}),n},M.geolocation=function(){return"geolocation"in navigator},M.postmessage=function(){return!!e.postMessage},M.websqldatabase=function(){return!!e.openDatabase},M.indexedDB=function(){return!!u("indexedDB",e)},M.hashchange=function(){return A("hashchange",e)&&(t.documentMode===n||t.documentMode>7)},M.history=function(){return!(!e.history||!history.pushState)},M.draganddrop=function(){var e=t.createElement("div");return"draggable"in e||"ondragstart"in e&&"ondrop"in e},M.websockets=function(){return"WebSocket"in e||"MozWebSocket"in e},M.rgba=function(){return r("background-color:rgba(150,255,150,.5)"),i(b.backgroundColor,"rgba")},M.hsla=function(){return r("background-color:hsla(120,40%,100%,.5)"),i(b.backgroundColor,"rgba")||i(b.backgroundColor,"hsla")},M.multiplebgs=function(){return r("background:url(https://),url(https://),red url(https://)"),/(url\s*\(.*?){3}/.test(b.background)},M.backgroundsize=function(){return u("backgroundSize")},M.borderimage=function(){return u("borderImage")},M.borderradius=function(){return u("borderRadius")},M.boxshadow=function(){return u("boxShadow")},M.textshadow=function(){return""===t.createElement("div").style.textShadow},M.opacity=function(){return o("opacity:.55"),/^0.55$/.test(b.opacity)},M.cssanimations=function(){return u("animationName")},M.csscolumns=function(){return u("columnCount")},M.cssgradients=function(){var e="background-image:",t="gradient(linear,left top,right bottom,from(#9f9),to(white));",n="linear-gradient(left top,#9f9, white);";return r((e+"-webkit- ".split(" ").join(t+e)+S.join(n+e)).slice(0,-e.length)),i(b.backgroundImage,"gradient")},M.cssreflections=function(){return u("boxReflect")},M.csstransforms=function(){return!!u("transform")},M.csstransforms3d=function(){var e=!!u("perspective");return e&&"webkitPerspective"in g.style&&F("@media (transform-3d),(-webkit-transform-3d){#modernizr{left:9px;position:absolute;height:3px;}}",function(t){e=9===t.offsetLeft&&3===t.offsetHeight}),e},M.csstransitions=function(){return u("transition")},M.fontface=function(){var e;return F('@font-face {font-family:"font";src:url("https://")}',function(n,r){var o=t.getElementById("smodernizr"),a=o.sheet||o.styleSheet,i=a?a.cssRules&&a.cssRules[0]?a.cssRules[0].cssText:a.cssText||"":"";e=/src/i.test(i)&&0===i.indexOf(r.split(" ")[0])}),e},M.generatedcontent=function(){var e;return F(["#",v,"{font:0/0 a}#",v,':after{content:"',x,'";visibility:hidden;font:3px/1 a}'].join(""),function(t){e=t.offsetHeight>=3}),e},M.video=function(){var e=t.createElement("video"),n=!1;try{(n=!!e.canPlayType)&&(n=new Boolean(n),n.ogg=e.canPlayType('video/ogg; codecs="theora"').replace(/^no$/,""),n.h264=e.canPlayType('video/mp4; codecs="avc1.42E01E"').replace(/^no$/,""),n.webm=e.canPlayType('video/webm; codecs="vp8, vorbis"').replace(/^no$/,""))}catch(r){}return n},M.audio=function(){var e=t.createElement("audio"),n=!1;try{(n=!!e.canPlayType)&&(n=new Boolean(n),n.ogg=e.canPlayType('audio/ogg; codecs="vorbis"').replace(/^no$/,""),n.mp3=e.canPlayType("audio/mpeg;").replace(/^no$/,""),n.wav=e.canPlayType('audio/wav; codecs="1"').replace(/^no$/,""),n.m4a=(e.canPlayType("audio/x-m4a;")||e.canPlayType("audio/aac;")).replace(/^no$/,""))}catch(r){}return n},M.localstorage=function(){try{return localStorage.setItem(v,v),localStorage.removeItem(v),!0}catch(e){return!1}},M.sessionstorage=function(){try{return sessionStorage.setItem(v,v),sessionStorage.removeItem(v),!0}catch(e){return!1}},M.webworkers=function(){return!!e.Worker},M.applicationcache=function(){return!!e.applicationCache},M.svg=function(){return!!t.createElementNS&&!!t.createElementNS(N.svg,"svg").createSVGRect},M.inlinesvg=function(){var e=t.createElement("div");return e.innerHTML="<svg/>",(e.firstChild&&e.firstChild.namespaceURI)==N.svg},M.smil=function(){return!!t.createElementNS&&/SVGAnimate/.test(w.call(t.createElementNS(N.svg,"animate")))},M.svgclippaths=function(){return!!t.createElementNS&&/SVGClipPath/.test(w.call(t.createElementNS(N.svg,"clipPath")))};for(var H in M)f(M,H)&&(d=H.toLowerCase(),p[d]=M[H](),$.push((p[d]?"":"no-")+d));return p.input||l(),p.addTest=function(e,t){if("object"==typeof e)for(var r in e)f(e,r)&&p.addTest(r,e[r]);else{if(e=e.toLowerCase(),p[e]!==n)return p;t="function"==typeof t?t():t,"undefined"!=typeof h&&h&&(g.className+=" "+(t?"":"no-")+e),p[e]=t}return p},r(""),y=E=null,function(e,t){function n(e,t){var n=e.createElement("p"),r=e.getElementsByTagName("head")[0]||e.documentElement;return n.innerHTML="x<style>"+t+"</style>",r.insertBefore(n.lastChild,r.firstChild)}function r(){var e=y.elements;return"string"==typeof e?e.split(" "):e}function o(e){var t=v[e[h]];return t||(t={},g++,e[h]=g,v[g]=t),t}function a(e,n,r){if(n||(n=t),l)return n.createElement(e);r||(r=o(n));var a;return a=r.cache[e]?r.cache[e].cloneNode():p.test(e)?(r.cache[e]=r.createElem(e)).cloneNode():r.createElem(e),!a.canHaveChildren||m.test(e)||a.tagUrn?a:r.frag.appendChild(a)}function i(e,n){if(e||(e=t),l)return e.createDocumentFragment();n=n||o(e);for(var a=n.frag.cloneNode(),i=0,c=r(),s=c.length;s>i;i++)a.createElement(c[i]);return a}function c(e,t){t.cache||(t.cache={},t.createElem=e.createElement,t.createFrag=e.createDocumentFragment,t.frag=t.createFrag()),e.createElement=function(n){return y.shivMethods?a(n,e,t):t.createElem(n)},e.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+r().join().replace(/[\w\-]+/g,function(e){return t.createElem(e),t.frag.createElement(e),'c("'+e+'")'})+");return n}")(y,t.frag)}function s(e){e||(e=t);var r=o(e);return!y.shivCSS||u||r.hasCSS||(r.hasCSS=!!n(e,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||c(e,r),e}var u,l,d="3.7.0",f=e.html5||{},m=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,h="_html5shiv",g=0,v={};!function(){try{var e=t.createElement("a");e.innerHTML="<xyz></xyz>",u="hidden"in e,l=1==e.childNodes.length||function(){t.createElement("a");var e=t.createDocumentFragment();return"undefined"==typeof e.cloneNode||"undefined"==typeof e.createDocumentFragment||"undefined"==typeof e.createElement}()}catch(n){u=!0,l=!0}}();var y={elements:f.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output progress section summary template time video",version:d,shivCSS:f.shivCSS!==!1,supportsUnknownElements:l,shivMethods:f.shivMethods!==!1,type:"default",shivDocument:s,createElement:a,createDocumentFragment:i};e.html5=y,s(t)}(this,t),p._version=m,p._prefixes=S,p._domPrefixes=T,p._cssomPrefixes=k,p.mq=z,p.hasEvent=A,p.testProp=function(e){return c([e])},p.testAllProps=u,p.testStyles=F,p.prefixed=function(e,t,n){return t?u(e,t,n):u(e,"pfx")},g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(h?" js "+$.join(" "):""),p}(this,this.document);
\ No newline at end of file
diff --git a/js/theme.js b/js/theme.js
index 68d3ba0..533e634 100755
--- a/js/theme.js
+++ b/js/theme.js
@@ -1,3 +1,2 @@
-/* sphinx_rtd_theme version 0.4.1 | MIT license */
-/* Built 20180727 10:07 */
-require=function n(e,i,t){function o(s,a){if(!i[s]){if(!e[s]){var l="function"==typeof require&&require;if(!a&&l)return l(s,!0);if(r)return r(s,!0);var c=new Error("Cannot find module '"+s+"'");throw c.code="MODULE_NOT_FOUND",c}var u=i[s]={exports:{}};e[s][0].call(u.exports,function(n){var i=e[s][1][n];return o(i||n)},u,u.exports,n,e,i,t)}return i[s].exports}for(var r="function"==typeof require&&require,s=0;s<t.length;s++)o(t[s]);return o}({"sphinx-rtd-theme":[function(n,e,i){var jQuery="undefined"!=typeof window?window.jQuery:n("jquery");e.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var e=this;void 0===n&&(n=!0),e.isRunning||(e.isRunning=!0,jQuery(function(i){e.init(i),e.reset(),e.win.on("hashchange",e.reset),n&&e.win.on("scroll",function(){e.linkScroll||e.winScroll||(e.winScroll=!0,requestAnimationFrame(function(){e.onScroll()}))}),e.win.on("resize",function(){e.winResize||(e.winResize=!0,requestAnimationFrame(function(){e.onResize()}))}),e.onResize()}))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var i=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(i),e.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")}),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var i=n(this);expand=n('<span class="toctree-expand"></span>'),expand.on("click",function(n){return e.toggleCurrent(i),n.stopPropagation(),!1}),i.prepend(expand)})},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),i=e.find('[href="'+n+'"]');if(0===i.length){var t=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(i=e.find('[href="#'+t.attr("id")+'"]')).length&&(i=e.find('[href="#"]'))}i.length>0&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"))}catch(o){console.log("Error expanding nav for anchor",o)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,i=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current"),e.siblings().find("li.current").removeClass("current"),e.find("> ul li.current").removeClass("current"),e.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:e.exports.ThemeNav,StickyNav:e.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],i=0;i<e.length&&!window.requestAnimationFrame;++i)window.requestAnimationFrame=window[e[i]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[i]+"CancelAnimationFrame"]||window[e[i]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,i){var t=(new Date).getTime(),o=Math.max(0,16-(t-n)),r=window.setTimeout(function(){e(t+o)},o);return n=t+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()},{jquery:"jquery"}]},{},["sphinx-rtd-theme"]);
+/* sphinx_rtd_theme version 1.0.0 | MIT license */
+!function(n){var e={};function t(i){if(e[i])return e[i].exports;var o=e[i]={i:i,l:!1,exports:{}};return n[i].call(o.exports,o,o.exports,t),o.l=!0,o.exports}t.m=n,t.c=e,t.d=function(n,e,i){t.o(n,e)||Object.defineProperty(n,e,{enumerable:!0,get:i})},t.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},t.t=function(n,e){if(1&e&&(n=t(n)),8&e)return n;if(4&e&&"object"==typeof n&&n&&n.__esModule)return n;var i=Object.create(null);if(t.r(i),Object.defineProperty(i,"default",{enumerable:!0,value:n}),2&e&&"string"!=typeof n)for(var o in n)t.d(i,o,function(e){return n[e]}.bind(null,o));return i},t.n=function(n){var e=n&&n.__esModule?function(){return n.default}:function(){return n};return t.d(e,"a",e),e},t.o=function(n,e){return Object.prototype.hasOwnProperty.call(n,e)},t.p="",t(t.s=0)}([function(n,e,t){t(1),n.exports=t(3)},function(n,e,t){(function(){var e="undefined"!=typeof window?window.jQuery:t(2);n.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var t=this;void 0===n&&(n=!0),t.isRunning||(t.isRunning=!0,e((function(e){t.init(e),t.reset(),t.win.on("hashchange",t.reset),n&&t.win.on("scroll",(function(){t.linkScroll||t.winScroll||(t.winScroll=!0,requestAnimationFrame((function(){t.onScroll()})))})),t.win.on("resize",(function(){t.winResize||(t.winResize=!0,requestAnimationFrame((function(){t.onResize()})))})),t.onResize()})))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",(function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")})).on("click",".wy-menu-vertical ul li a",(function(){var t=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(t),e.hashChange()})).on("click","[data-toggle='rst-current-version']",(function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")})),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),n("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),n("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n('<button class="toctree-expand" title="Open/close menu"></button>'),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}if(t.length>0){$(".wy-menu-vertical .current").removeClass("current").attr("aria-expanded","false"),t.addClass("current").attr("aria-expanded","true"),t.closest("li.toctree-l1").parent().addClass("current").attr("aria-expanded","true");for(let n=1;n<=10;n++)t.closest("li.toctree-l"+n).addClass("current").attr("aria-expanded","true");t[0].scrollIntoView()}}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current").attr("aria-expanded","false"),e.siblings().find("li.current").removeClass("current").attr("aria-expanded","false");var t=e.find("> ul li");t.length&&(t.removeClass("current").attr("aria-expanded","false"),e.toggleClass("current").attr("aria-expanded",(function(n,e){return"true"==e?"false":"true"})))}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t<e.length&&!window.requestAnimationFrame;++t)window.requestAnimationFrame=window[e[t]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[t]+"CancelAnimationFrame"]||window[e[t]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,t){var i=(new Date).getTime(),o=Math.max(0,16-(i-n)),r=window.setTimeout((function(){e(i+o)}),o);return n=i+o,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(n){clearTimeout(n)})}()}).call(window)},function(n,e){n.exports=jQuery},function(n,e,t){}]);
diff --git a/search.html b/search.html
index c149f7f..d73e1ec 100755
--- a/search.html
+++ b/search.html
@@ -1,201 +1,185 @@
 <!DOCTYPE html>
-<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
-<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<html class="writer-html5" lang="en" >
 <head>
-  <meta charset="utf-8">
-  <meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  
-  <meta name="author" content="Mouse0w0">
-  
-  <link rel="shortcut icon" href="./img/favicon.ico">
-  <title>Lwjglbook中文翻译</title>
-  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700" />
-
-  <link rel="stylesheet" href="./css/theme.css" />
-  <link rel="stylesheet" href="./css/theme_extra.css" />
-  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/github.min.css" />
-  
-  <script src="./js/jquery-2.1.1.min.js" defer></script>
-  <script src="./js/modernizr-2.8.3.min.js" defer></script>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/highlight.min.js"></script>
-  <script>hljs.initHighlightingOnLoad();</script> 
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="author" content="Mouse0w0" />
+      <link rel="shortcut icon" href="./img/favicon.ico" />
+    <title>Lwjglbook中文翻译</title>
+    <link rel="stylesheet" href="./css/theme.css" />
+    <link rel="stylesheet" href="./css/theme_extra.css" />
+        <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/github.min.css" />
+    
+    <!--[if lt IE 9]>
+      <script src="./js/html5shiv.min.js"></script>
+    <![endif]-->
+      <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script>
+      <script>hljs.highlightAll();</script> 
 </head>
 
 <body class="wy-body-for-nav" role="document">
 
   <div class="wy-grid-for-nav">
-
-    
     <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
     <div class="wy-side-scroll">
       <div class="wy-side-nav-search">
-        <a href="./." class="icon icon-home"> Lwjglbook中文翻译</a>
-        <div role="search">
+          <a href="./." class="icon icon-home"> Lwjglbook中文翻译
+        </a><div role="search">
   <form id ="rtd-search-form" class="wy-form" action="./search.html" method="get">
-      <input type="text" name="q" placeholder="Search docs" title="Type search term here" />
+      <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" title="Type search term here" />
   </form>
 </div>
       </div>
 
-      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./01-first-steps/">事前准备</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./02-the-game-loop/">游戏循环</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./03-a-brief-about-coordinates/">坐标简介</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./04-rendering/">渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./05-more-on-rendering/">渲染补充</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./06-transformations/">变换</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./07-textures/">纹理</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./08-camera/">摄像机</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./09-loading-more-complex-models/">加载更复杂的模型</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./10-let-there-be-light/">要有光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./11-let-there-be-even-more-light/">要有更多的光</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./12-game-hud/">游戏HUD</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./14-height-maps/">高度图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./15-terrain-collisions/">地形碰撞</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./16-fog/">雾</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./17-normal-mapping/">法线贴图</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./18-shadows/">阴影</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./19-animations/">动画</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./20-particles/">粒子</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./21-instanced-rendering/">实例化渲染</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./22-audio/">音效</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./23-3d-object-picking/">三维物体选取</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./24-hud-revisited/">回顾HUD - NanoVG</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./26-cascaded-shadow-maps/">级联阴影映射</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./27-assimp/">Assimp库</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./28-deferred-shading/">延迟着色法</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./a01-opengl-debugging/">附录 A - OpenGL调试</a>
-                    </li>
-                </ul>
-                <ul>
-                    <li class="toctree-l1"><a class="reference internal" href="./glossary/">术语表</a>
-                    </li>
-                </ul>
+      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./01-first-steps/">事前准备</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./02-the-game-loop/">游戏循环</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./03-a-brief-about-coordinates/">坐标简介</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./04-rendering/">渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./05-more-on-rendering/">渲染补充</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./06-transformations/">变换</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./07-textures/">纹理</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./08-camera/">摄像机</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./09-loading-more-complex-models/">加载更复杂的模型</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./10-let-there-be-light/">要有光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./11-let-there-be-even-more-light/">要有更多的光</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./12-game-hud/">游戏HUD</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./13-sky-box-and-some-optimizations/">天空盒与一些优化</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./14-height-maps/">高度图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./15-terrain-collisions/">地形碰撞</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./16-fog/">雾</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./17-normal-mapping/">法线贴图</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./18-shadows/">阴影</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./19-animations/">动画</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./20-particles/">粒子</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./21-instanced-rendering/">实例化渲染</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./22-audio/">音效</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./23-3d-object-picking/">三维物体选取</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./24-hud-revisited/">回顾HUD - NanoVG</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./25-optimizations-frustum-culling/">优化 - 截锥剔除</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./26-cascaded-shadow-maps/">级联阴影映射</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./27-assimp/">Assimp库</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./28-deferred-shading/">延迟着色法</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./a01-opengl-debugging/">附录 A - OpenGL调试</a>
+                </li>
+              </ul>
+              <ul>
+                <li class="toctree-l1"><a class="reference internal" href="./glossary/">术语表</a>
+                </li>
+              </ul>
       </div>
     </div>
     </nav>
 
     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
-
-      
-      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
-        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
-        <a href="./.">Lwjglbook中文翻译</a>
+      <nav class="wy-nav-top" role="navigation" aria-label="Mobile navigation menu">
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="./.">Lwjglbook中文翻译</a>
+        
       </nav>
-
-      
       <div class="wy-nav-content">
-        <div class="rst-content">
-          <div role="navigation" aria-label="breadcrumbs navigation">
+        <div class="rst-content"><div role="navigation" aria-label="breadcrumbs navigation">
   <ul class="wy-breadcrumbs">
-    <li><a href="./.">Docs</a> &raquo;</li>
-    
-    
+    <li><a href="./." class="icon icon-home" aria-label="Docs"></a></li>
     <li class="wy-breadcrumbs-aside">
-      
     </li>
   </ul>
-  
   <hr/>
 </div>
-
-          <div role="main">
-            <div class="section">
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+            <div class="section" itemprop="articleBody">
               
 
   <h1 id="search">Search Results</h1>
 
   <form id="content_search" action="search.html">
     <span role="status" aria-live="polite" class="ui-helper-hidden-accessible"></span>
-    <input name="q" id="mkdocs-search-query" type="text" class="search_input search-query ui-autocomplete-input" placeholder="Search the Docs" autocomplete="off" autofocus title="Type search term here">
+    <input name="q" id="mkdocs-search-query" type="text" class="search_input search-query ui-autocomplete-input" placeholder="Search the Docs" aria-label="Search the Docs" autocomplete="off" autofocus title="Type search term here">
   </form>
 
   <div id="mkdocs-search-results" class="search-results" data-no-results-text="No results found">
@@ -204,22 +188,18 @@
 
 
             </div>
-          </div>
-          <footer>
-  
+          </div><footer>
 
   <hr/>
 
   <div role="contentinfo">
     <!-- Copyright etc -->
-    
       <p>2019, Mouse0w0</p>
-    
   </div>
 
-  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+  Built with <a href="https://www.mkdocs.org/">MkDocs</a> using a <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
 </footer>
-      
+          
         </div>
       </div>
 
@@ -227,26 +207,27 @@
 
   </div>
 
-  <div class="rst-versions" role="note" aria-label="versions">
+  <div class="rst-versions" role="note" aria-label="Versions">
   <span class="rst-current-version" data-toggle="rst-current-version">
     
         <span>
-          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation/" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
+          <a href="https://github.com/Mouse0w0/lwjglbook-CN-Translation" class="fa fa-github" style="color: #fcfcfc"> GitHub</a>
         </span>
     
     
     
   </span>
 </div>
-    <script>var base_url = '.';</script>
-    <script src="./js/theme_extra.js" defer></script>
-    <script src="./js/theme.js" defer></script>
-      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" defer></script>
-      <script src="./search/main.js" defer></script>
-    <script defer>
-        window.onload = function () {
+    <script src="./js/jquery-3.6.0.min.js"></script>
+    <script>var base_url = ".";</script>
+    <script src="./js/theme_extra.js"></script>
+    <script src="./js/theme.js"></script>
+      <script src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>
+      <script src="./search/main.js"></script>
+    <script>
+        jQuery(function () {
             SphinxRtdTheme.Navigation.enable(true);
-        };
+        });
     </script>
 
 </body>
diff --git a/search/lunr.js b/search/lunr.js
index 6aa370f..aca0a16 100755
--- a/search/lunr.js
+++ b/search/lunr.js
@@ -3456,7 +3456,7 @@ lunr.QueryParser.parseBoost = function (parser) {
     } else if (typeof exports === 'object') {
       /**
        * Node. Does not work with strict CommonJS, but
-       * only CommonJS-like enviroments that support module.exports,
+       * only CommonJS-like environments that support module.exports,
        * like Node.
        */
       module.exports = factory()
diff --git a/search/main.js b/search/main.js
index c5ccfa6..a5e469d 100755
--- a/search/main.js
+++ b/search/main.js
@@ -21,8 +21,15 @@ function joinUrl (base, path) {
   return base + "/" + path;
 }
 
+function escapeHtml (value) {
+  return value.replace(/&/g, '&amp;')
+    .replace(/"/g, '&quot;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}
+
 function formatResult (location, title, summary) {
-  return '<article><h3><a href="' + joinUrl(base_url, location) + '">'+ title + '</a></h3><p>' + summary +'</p></article>';
+  return '<article><h3><a href="' + joinUrl(base_url, location) + '">'+ escapeHtml(title) + '</a></h3><p>' + escapeHtml(summary) +'</p></article>';
 }
 
 function displayResults (results) {
diff --git a/search/search_index.json b/search/search_index.json
index b82a5cd..ac8e3ab 100755
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1 \u672c\u4e66\u539f\u4ecb\u7ecd \u8fd9\u672c\u5728\u7ebf\u7535\u5b50\u4e66\u4e3b\u8981\u8bb2\u89e3\u4f7f\u7528LWJGL 3\u5e93\u5f00\u53d13D\u6e38\u620f\u3002 LWJGL\u662f\u4e00\u4e2aJava\u5e93\uff0c\u63d0\u4f9b\u4e86\u8bbf\u95eeOpenGL\u3001OpenAL\u548cOpenCL\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u5e93\u53ef\u4ee5\u5728\u4f7f\u7528\u9ad8\u6027\u80fd\u7684OpenGL\u7684\u540c\u65f6\uff0c\u4f7f\u7528Java\u8bed\u8a00\u5f00\u53d1\u3002 \u6211\u6700\u521d\u7684\u76ee\u6807\u662f\u5b66\u4e60\u4f7f\u7528OpenGL\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u6280\u672f\u3002\u6240\u9700\u8d44\u6599\u90fd\u53ef\u5728\u7f51\u4e0a\u627e\u5230\uff0c\u4f46\u662f\u6ca1\u6709\u4eba\u5c06\u5176\u6574\u7406\uff0c\u6709\u65f6\u5f88\u96be\u627e\u5230\uff0c\u751a\u81f3\u6709\u4e9b\u8d44\u6599\u4e0d\u5b8c\u6574\u6216\u5b58\u5728\u8bef\u5bfc\u3002 \u6211\u5f00\u59cb\u6536\u96c6\u4e00\u4e9b\u8d44\u6599\uff0c\u7f16\u5199\u4e00\u4e9b\u793a\u4f8b\uff0c\u5e76\u51b3\u5b9a\u4ee5\u7535\u5b50\u4e66\u7684\u5f62\u5f0f\u6574\u7406\u8fd9\u4e9b\u8d44\u6599\u3002 \u6e90\u4ee3\u7801 \u672c\u4e66\u4e2d\u6240\u6709\u7684\u6e90\u7801\u793a\u4f8b\u5747\u4e0a\u4f20\u81f3 GitHub . \u672c\u4e66\u82f1\u6587\u539f\u6587\u5730\u5740 GitBook GitHub . \u8bb8\u53ef\u8bc1 \u672c\u4f5c\u54c1\u91c7\u7528 \u77e5\u8bc6\u5171\u4eab\u7f72\u540d-\u76f8\u540c\u65b9\u5f0f\u5171\u4eab 4.0 \u56fd\u9645\u8bb8\u53ef\u534f\u8bae \u8fdb\u884c\u8bb8\u53ef\u3002 \u6240\u6709\u7684\u6e90\u4ee3\u7801\u7684\u8bb8\u53ef\u534f\u8bae\u5747\u4e3a Apache v2.0 \u539f\u4f5c\u8005 Antonio Hern\u00e1ndez Bejarano \u652f\u6301\u4f5c\u8005 \u5982\u679c\u4f60\u559c\u6b22\u8fd9\u672c\u4e66\uff0c\u8bf7Star\u5e76\u4e14\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u4f5c\u8005\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u6309\u94ae\u6350\u52a9\uff1a \u7279\u522b\u611f\u8c22 \u611f\u8c22\u6240\u6709\u63d0\u4f9b\u4e86\u6307\u6b63\u3001\u610f\u89c1\u548c\u5efa\u8bae\u7684\u8bfb\u8005\u3002 \u8bd1\u8005\u7684\u8bdd \u672c\u4e66\u662f\u8bd1\u8005\u4e3a\u4e86\u5b66\u4e60LWJGL3\u548cOpenGL\u800c\u7ffb\u8bd1\u7684\u3002\u9650\u4e8e\u8bd1\u8005\u7684\u80fd\u529b\uff0c\u672c\u8bd1\u672c\u4e2d\u5982\u6709\u4e0d\u59a5\u4e4b\u5904\u6b22\u8fce\u5404\u4f4d\u8bfb\u8005\u6307\u6b63\u3002 \u5982\u679c\u4f60\u559c\u6b22\u672c\u8bd1\u672c\uff0c\u8bf7Star\u5e76\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u8bd1\u8005\uff0c\u8bf7\u901a\u8fc7\u4e0b\u9762\u7684\u94fe\u63a5\u6350\u52a9\uff1a \u7231\u53d1\u7535 \u3002","title":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1"},{"location":"#lwjgl-33d3d-game-development-with-lwjgl-3","text":"","title":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1"},{"location":"#_1","text":"\u8fd9\u672c\u5728\u7ebf\u7535\u5b50\u4e66\u4e3b\u8981\u8bb2\u89e3\u4f7f\u7528LWJGL 3\u5e93\u5f00\u53d13D\u6e38\u620f\u3002 LWJGL\u662f\u4e00\u4e2aJava\u5e93\uff0c\u63d0\u4f9b\u4e86\u8bbf\u95eeOpenGL\u3001OpenAL\u548cOpenCL\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u5e93\u53ef\u4ee5\u5728\u4f7f\u7528\u9ad8\u6027\u80fd\u7684OpenGL\u7684\u540c\u65f6\uff0c\u4f7f\u7528Java\u8bed\u8a00\u5f00\u53d1\u3002 \u6211\u6700\u521d\u7684\u76ee\u6807\u662f\u5b66\u4e60\u4f7f\u7528OpenGL\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u6280\u672f\u3002\u6240\u9700\u8d44\u6599\u90fd\u53ef\u5728\u7f51\u4e0a\u627e\u5230\uff0c\u4f46\u662f\u6ca1\u6709\u4eba\u5c06\u5176\u6574\u7406\uff0c\u6709\u65f6\u5f88\u96be\u627e\u5230\uff0c\u751a\u81f3\u6709\u4e9b\u8d44\u6599\u4e0d\u5b8c\u6574\u6216\u5b58\u5728\u8bef\u5bfc\u3002 \u6211\u5f00\u59cb\u6536\u96c6\u4e00\u4e9b\u8d44\u6599\uff0c\u7f16\u5199\u4e00\u4e9b\u793a\u4f8b\uff0c\u5e76\u51b3\u5b9a\u4ee5\u7535\u5b50\u4e66\u7684\u5f62\u5f0f\u6574\u7406\u8fd9\u4e9b\u8d44\u6599\u3002","title":"\u672c\u4e66\u539f\u4ecb\u7ecd"},{"location":"#_2","text":"\u672c\u4e66\u4e2d\u6240\u6709\u7684\u6e90\u7801\u793a\u4f8b\u5747\u4e0a\u4f20\u81f3 GitHub . \u672c\u4e66\u82f1\u6587\u539f\u6587\u5730\u5740 GitBook GitHub .","title":"\u6e90\u4ee3\u7801"},{"location":"#_3","text":"\u672c\u4f5c\u54c1\u91c7\u7528 \u77e5\u8bc6\u5171\u4eab\u7f72\u540d-\u76f8\u540c\u65b9\u5f0f\u5171\u4eab 4.0 \u56fd\u9645\u8bb8\u53ef\u534f\u8bae \u8fdb\u884c\u8bb8\u53ef\u3002 \u6240\u6709\u7684\u6e90\u4ee3\u7801\u7684\u8bb8\u53ef\u534f\u8bae\u5747\u4e3a Apache v2.0","title":"\u8bb8\u53ef\u8bc1"},{"location":"#_4","text":"Antonio Hern\u00e1ndez Bejarano","title":"\u539f\u4f5c\u8005"},{"location":"#_5","text":"\u5982\u679c\u4f60\u559c\u6b22\u8fd9\u672c\u4e66\uff0c\u8bf7Star\u5e76\u4e14\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u4f5c\u8005\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u6309\u94ae\u6350\u52a9\uff1a","title":"\u652f\u6301\u4f5c\u8005"},{"location":"#_6","text":"\u611f\u8c22\u6240\u6709\u63d0\u4f9b\u4e86\u6307\u6b63\u3001\u610f\u89c1\u548c\u5efa\u8bae\u7684\u8bfb\u8005\u3002","title":"\u7279\u522b\u611f\u8c22"},{"location":"#_7","text":"\u672c\u4e66\u662f\u8bd1\u8005\u4e3a\u4e86\u5b66\u4e60LWJGL3\u548cOpenGL\u800c\u7ffb\u8bd1\u7684\u3002\u9650\u4e8e\u8bd1\u8005\u7684\u80fd\u529b\uff0c\u672c\u8bd1\u672c\u4e2d\u5982\u6709\u4e0d\u59a5\u4e4b\u5904\u6b22\u8fce\u5404\u4f4d\u8bfb\u8005\u6307\u6b63\u3002 \u5982\u679c\u4f60\u559c\u6b22\u672c\u8bd1\u672c\uff0c\u8bf7Star\u5e76\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u8bd1\u8005\uff0c\u8bf7\u901a\u8fc7\u4e0b\u9762\u7684\u94fe\u63a5\u6350\u52a9\uff1a \u7231\u53d1\u7535 \u3002","title":"\u8bd1\u8005\u7684\u8bdd"},{"location":"01-first-steps/","text":"\u4e8b\u524d\u51c6\u5907\uff08First Steps\uff09 \u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u6280\u672f\u3002\u672c\u4e66\u5c06\u4f7f\u7528Java\u8bed\u8a00\u548cJava\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93( LWJGL )\u6765\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002LWJGL\u5e93\u5141\u8bb8\u6211\u4eec\u8bbf\u95ee\u5e95\u5c42\u7684API\uff08\u5e94\u7528\u7a0b\u5e8f\u63a5\u53e3\uff09\uff0c\u4f8b\u5982OpenGL\u3002 LWJGL\u662f\u4e00\u4e2a\u5e95\u5c42\u7684API\uff0c\u5b83\u50cf\u4e00\u4e2aOpenGL\u5305\u88c5\u5e93\u3002\u5982\u679c\u4f60\u662f\u60f3\u5728\u77ed\u65f6\u95f4\u5185\u5f00\u59cb\u5236\u4f5c\u4e00\u4e2a3D\u6e38\u620f\uff0c\u90a3\u4e48\u4f60\u4e5f\u8bb8\u8be5\u8003\u8651\u5176\u5b83\u9009\u62e9\uff0c\u6bd4\u5982\u4f7f\u7528\u5f15\u64ce[JmonkeyEngine]\u3002\u4f7f\u7528LWJGL\u8fd9\u4e2a\u5e95\u5c42API\uff0c\u5728\u4f60\u6536\u5230\u6210\u6548\u4e4b\u524d\uff0c\u9700\u8981\u4e86\u89e3\u8bb8\u591a\u6982\u5ff5\u5e76\u4e14\u7f16\u5199\u5927\u91cf\u7684\u4ee3\u7801\u3002\u8fd9\u6837\u505a\u7684\u597d\u5904\u662f\u4f60\u53ef\u4ee5\u66f4\u597d\u7684\u7406\u89e33D\u56fe\u5f62\u6e32\u67d3\uff0c\u5e76\u4e14\u53ef\u4ee5\u66f4\u597d\u7684\u63a7\u5236\u5b83\u3002 \u5728\u4e0a\u6587\u8bf4\u5230\uff0c\u5728\u672c\u4e66\u4e2d\u6211\u4eec\u5c06\u4f7f\u7528Java\uff0c\u66f4\u786e\u5207\u6765\u8bf4\u6211\u4eec\u5c06\u4f7f\u7528Java 10\u3002\u6240\u4ee5\u4f60\u9700\u8981\u4eceOracle\u7684\u9875\u9762\u4e0b\u8f7d\u5bf9\u5e94\u7248\u672c\u7684JDK\u3002\u8bf7\u9009\u62e9\u9002\u5408\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u7684\u5b89\u88c5\u7a0b\u5e8f\u3002\u672c\u4e66\u5047\u5b9a\u4f60\u5bf9Java\u8bed\u8a00\u6709\u4e00\u5b9a\u7684\u4e86\u89e3\u3002 \u5982\u679c\u4f60\u9700\u8981\u4e00\u4e2a\u53ef\u4ee5\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\u7684Java IDE\uff08\u96c6\u6210\u5f00\u53d1\u73af\u5883\uff09\uff0c\u4f60\u53ef\u4ee5\u4e0b\u8f7d\u4e3aJava 10\u63d0\u4f9b\u826f\u597d\u652f\u6301\u7684IntelliJ IDEA\u3002\u7531\u4e8eJava 10\u4ec5\u652f\u630164\u4f4d\u7684\u5e73\u53f0\uff0c\u8bb0\u5f97\u4e0b\u8f7d64\u4f4d\u7248\u672c\u7684IntelliJ\u3002IntelliJ\u63d0\u4f9b\u6709\u4e00\u4e2a\u514d\u8d39\u4e14\u5f00\u6e90\u7684\u793e\u533a\u7248\uff0c\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83\uff1a https://www.jetbrains.com/idea/download/ \u3002 \u4e3a\u4e86\u6784\u5efa\u793a\u4f8b\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u4f7f\u7528 Maven \u3002Maven\u5df2\u7ecf\u96c6\u6210\u5728\u5927\u591a\u6570IDE\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5728IDE\u4e2d\u76f4\u63a5\u6253\u5f00\u4e0d\u540c\u7ae0\u8282\u7684\u793a\u4f8b\u4ee3\u7801\u3002\u53ea\u8981\u6253\u5f00\u4e86\u793a\u4f8b\u4ee3\u7801\u6240\u5728\u7684\u6587\u4ef6\u5939\uff0cIntelliJ\u5c31\u4f1a\u68c0\u6d4b\u5230\u5b83\u662f\u4e00\u4e2aMaven\u9879\u76ee\u3002 Maven\u57fa\u4e8e\u4e00\u4e2a\u540d\u4e3a pom.xml \uff08Project Object Model\uff0c\u9879\u76ee\u5bf9\u8c61\u6a21\u578b\uff09\u7684XML\u6587\u4ef6\u6765\u6784\u5efa\u9879\u76ee\uff0c\u5b83\u7ba1\u7406\u4e86\u9879\u76ee\u7684\u4f9d\u8d56\uff08\u9700\u8981\u4f7f\u7528\u7684\u5e93\uff09\u548c\u5728\u6784\u5efa\u8fc7\u7a0b\u4e2d\u9700\u8981\u6267\u884c\u7684\u6b65\u9aa4\u3002Maven\u9075\u5faa\u7ea6\u5b9a\u9ad8\u4e8e\u914d\u7f6e\u7684\u539f\u5219\uff0c\u5373\u5982\u679c\u4f60\u9075\u5b88\u6807\u51c6\u7684\u9879\u76ee\u7ed3\u6784\u548c\u547d\u540d\u7ea6\u5b9a\uff0c\u5c31\u4e0d\u9700\u8981\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u660e\u786e\u5730\u58f0\u660e\u6e90\u6587\u4ef6\u5728\u54ea\u91cc\u6216\u8005\u5e94\u8be5\u5728\u54ea\u91cc\u7f16\u8bd1\u7c7b\u3002 \u672c\u4e66\u4e0d\u662f\u4e00\u4e2aMaven\u6559\u7a0b\uff0c\u5982\u679c\u6709\u9700\u8981\uff0c\u8bf7\u5728\u7f51\u4e0a\u641c\u7d22Maven\u7684\u76f8\u5173\u8d44\u6599\u3002\u6e90\u4ee3\u7801\u6587\u4ef6\u5939\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7236\u9879\u76ee\uff0c\u5b83\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u63d2\u4ef6\u5e76\u4e14\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u5e93\u7684\u7248\u672c\u3002 LWJGL 3.1\u5728\u9879\u76ee\u6784\u5efa\u4e0a\u6709\u4e00\u4e9b\u53d8\u5316\u3002\u73b0\u5728\uff0c\u5b83\u53d8\u5f97\u66f4\u52a0\u6a21\u5757\u5316\uff0c\u6211\u4eec\u53ef\u4ee5\u6709\u9009\u62e9\u5730\u4f7f\u7528\u7c7b\u5e93\uff0c\u800c\u4e0d\u662f\u5bfc\u5165\u4e00\u4e2a\u5de8\u5927\u7684Jar\u6587\u4ef6\u3002\u4f46\u8fd9\u662f\u6709\u4ee3\u4ef7\u7684\uff1a\u4f60\u9700\u8981\u4ed4\u7ec6\u5730\u9010\u4e2a\u6307\u5b9a\u4f9d\u8d56\u5173\u7cfb\u3002\u4e0d\u8fc7 LWJGL\u4e0b\u8f7d \u9875\u9762\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4e3a\u60a8\u751f\u6210POM\u6587\u4ef6\u7684\u811a\u672c\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u4f7f\u7528GLFW\u548cOpenGL\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u6211\u4eec\u7684POM\u6587\u4ef6\u3002 LWJGL\u5e73\u53f0\u4f9d\u8d56\u5e93\u5df2\u7ecf\u53ef\u4ee5\u4e3a\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u81ea\u52a8\u89e3\u538b\u672c\u5730\u5e93\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u4f7f\u7528\u5176\u4ed6\u63d2\u4ef6\uff08\u4f8b\u5982 mavennatives \uff09\u3002\u6211\u4eec\u53ea\u9700\u8981\u914d\u7f6e\u4e09\u4e2aProfile\u6765\u8bbe\u7f6eLWJGL\u6240\u5904\u7684\u64cd\u4f5c\u7cfb\u7edf\u3002Profile\u5c06\u4f1a\u4e3aWindows\u3001Linux\u548cMac OS\u7cfb\u5217\u8bbe\u7f6e\u6b63\u786e\u7684\u503c\u3002 <profiles> <profile> <id>windows-profile</id> <activation> <os> <family>Windows</family> </os> </activation> <properties> <native.target>natives-windows</native.target> </properties> </profile> <profile> <id>linux-profile</id> <activation> <os> <family>Linux</family> </os> </activation> <properties> <native.target>natives-linux</native.target> </properties> </profile> <profile> <id>OSX-profile</id> <activation> <os> <family>mac</family> </os> </activation> <properties> <native.target>natives-osx</native.target> </properties> </profile> </profiles> \u5728\u6bcf\u4e2a\u9879\u76ee\u4e2d\uff0cLWJGL\u5e73\u53f0\u4f9d\u8d56\u9879\u5c06\u4f7f\u7528\u914d\u7f6e\u6587\u4ef6\u4e3a\u5f53\u524d\u5e73\u53f0\u8bbe\u7f6e\u7684\u6b63\u786e\u7684\u5c5e\u6027\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-platform</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> </dependency> \u6b64\u5916\uff0c\u6bcf\u4e2a\u9879\u76ee\u53ef\u751f\u6210\u4e00\u4e2a\u53ef\u8fd0\u884c\u7684Jar\uff08\u4e00\u79cd\u53ef\u4ee5\u901a\u8fc7\u8f93\u5165 java -jar name_of_the_jar.jar \u5c31\u53ef\u8fd0\u884c\u7684Jar\uff09\uff0c\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528Maven\u7684 maven-jar-plugin \u63d2\u4ef6\u5b9e\u73b0\u7684\u3002\u8be5\u63d2\u4ef6\u521b\u5efa\u4e86\u4e00\u4e2a\u542b\u6709 MANIFEST.MF \u6587\u4ef6\u7684Jar\uff0c\u5e76\u4e14\u6587\u4ef6\u5185\u6709\u6307\u5b9a\u7684\u503c\uff0c\u8be5\u6587\u4ef6\u6700\u91cd\u8981\u7684\u5c5e\u6027\u5c31\u662f Main-Class \uff0c\u5b83\u6307\u660e\u4e86\u7a0b\u5e8f\u7684\u5165\u53e3\u3002\u6b64\u5916\uff0c\u6240\u6709\u7684\u4f9d\u8d56\u5e93\u90fd\u88ab\u8bbe\u7f6e\u5728\u8be5\u6587\u4ef6\u7684 Class-Path \u5c5e\u6027\u4e2d\u3002\u8981\u5728\u53e6\u4e00\u53f0\u8ba1\u7b97\u673a\u4e0a\u8fd0\u884c\u5b83\uff0c\u4f60\u53ea\u9700\u8981\u590d\u5236\u4f4d\u4e8e\u76ee\u6807\u76ee\u5f55\u4e0b\u7684\u4e3bJar\u6587\u4ef6\u548cLib\u76ee\u5f55\uff08\u5305\u62ec\u5176\u4e2d\u6240\u6709\u7684Jar\u6587\u4ef6\uff09\u3002 Jar\u6587\u4ef6\u50a8\u5b58\u7740LWJGL\u7c7b\u548c\u672c\u5730\u5e93\u3002LWJGL\u8fd8\u5c06\u8d1f\u8d23\u63d0\u53d6\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u6dfb\u52a0\u5230JVM\u7684\u5e93\u8def\u5f84\u4e2d\u3002 \u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u662fLWJGL\u7f51\u7ad9( https://www.lwjgl.org/guide )\u63d0\u4f9b\u7684\u7684\u5165\u95e8\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6ca1\u6709\u4f7f\u7528Swing\u6216JavaFX\u4f5c\u4e3a\u6211\u4eec\u7684GUI\u5e93\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f GLFW \uff0c\u5b83\u662f\u4e00\u4e2a\u7528\u4e8e\u5904\u7406GUI\u7ec4\u4ef6\uff08\u7a97\u53e3\u7b49\uff09\u548c\u4e8b\u4ef6\uff08\u6309\u952e\u6309\u4e0b\u3001\u9f20\u6807\u79fb\u52a8\u7b49\uff09\uff0c\u5e76\u4e14\u4e0eOpenGL\u4e0a\u4e0b\u6587\u8fdb\u884c\u7b80\u5355\u8fde\u63a5\u7684\u5e93\u3002\u6b64\u524d\u7248\u672c\u7684LWJGL\u63d0\u4f9b\u4e86\u4e00\u4e2a\u81ea\u5b9a\u4e49GUI API\uff0c\u4f46\u5728LWJGL 3\u4e2d\uff0cGLFW\u662f\u9996\u9009\u7684\u7a97\u53e3API\u3002 \u793a\u4f8b\u6e90\u7801\u5f88\u7b80\u5355\u5e76\u6709\u7740\u826f\u597d\u7684\u6587\u6863\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u4f1a\u5728\u4e66\u4e2d\u518d\u6b21\u8bf4\u660e\u3002 \u5982\u679c\u4f60\u6b63\u786e\u5730\u914d\u7f6e\u4e86\u73af\u5883\uff0c\u4f60\u5e94\u8be5\u80fd\u591f\u8fd0\u884c\u5b83\u5e76\u770b\u5230\u4e00\u4e2a\u6709\u7ea2\u8272\u80cc\u666f\u7684\u7a97\u53e3\u3002 \u672c\u4e66\u4e2d\u6e90\u4ee3\u7801\u53d1\u5e03\u4e8e GitHub \u3002","title":"\u4e8b\u524d\u51c6\u5907"},{"location":"01-first-steps/#first-steps","text":"\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u6280\u672f\u3002\u672c\u4e66\u5c06\u4f7f\u7528Java\u8bed\u8a00\u548cJava\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93( LWJGL )\u6765\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002LWJGL\u5e93\u5141\u8bb8\u6211\u4eec\u8bbf\u95ee\u5e95\u5c42\u7684API\uff08\u5e94\u7528\u7a0b\u5e8f\u63a5\u53e3\uff09\uff0c\u4f8b\u5982OpenGL\u3002 LWJGL\u662f\u4e00\u4e2a\u5e95\u5c42\u7684API\uff0c\u5b83\u50cf\u4e00\u4e2aOpenGL\u5305\u88c5\u5e93\u3002\u5982\u679c\u4f60\u662f\u60f3\u5728\u77ed\u65f6\u95f4\u5185\u5f00\u59cb\u5236\u4f5c\u4e00\u4e2a3D\u6e38\u620f\uff0c\u90a3\u4e48\u4f60\u4e5f\u8bb8\u8be5\u8003\u8651\u5176\u5b83\u9009\u62e9\uff0c\u6bd4\u5982\u4f7f\u7528\u5f15\u64ce[JmonkeyEngine]\u3002\u4f7f\u7528LWJGL\u8fd9\u4e2a\u5e95\u5c42API\uff0c\u5728\u4f60\u6536\u5230\u6210\u6548\u4e4b\u524d\uff0c\u9700\u8981\u4e86\u89e3\u8bb8\u591a\u6982\u5ff5\u5e76\u4e14\u7f16\u5199\u5927\u91cf\u7684\u4ee3\u7801\u3002\u8fd9\u6837\u505a\u7684\u597d\u5904\u662f\u4f60\u53ef\u4ee5\u66f4\u597d\u7684\u7406\u89e33D\u56fe\u5f62\u6e32\u67d3\uff0c\u5e76\u4e14\u53ef\u4ee5\u66f4\u597d\u7684\u63a7\u5236\u5b83\u3002 \u5728\u4e0a\u6587\u8bf4\u5230\uff0c\u5728\u672c\u4e66\u4e2d\u6211\u4eec\u5c06\u4f7f\u7528Java\uff0c\u66f4\u786e\u5207\u6765\u8bf4\u6211\u4eec\u5c06\u4f7f\u7528Java 10\u3002\u6240\u4ee5\u4f60\u9700\u8981\u4eceOracle\u7684\u9875\u9762\u4e0b\u8f7d\u5bf9\u5e94\u7248\u672c\u7684JDK\u3002\u8bf7\u9009\u62e9\u9002\u5408\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u7684\u5b89\u88c5\u7a0b\u5e8f\u3002\u672c\u4e66\u5047\u5b9a\u4f60\u5bf9Java\u8bed\u8a00\u6709\u4e00\u5b9a\u7684\u4e86\u89e3\u3002 \u5982\u679c\u4f60\u9700\u8981\u4e00\u4e2a\u53ef\u4ee5\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\u7684Java IDE\uff08\u96c6\u6210\u5f00\u53d1\u73af\u5883\uff09\uff0c\u4f60\u53ef\u4ee5\u4e0b\u8f7d\u4e3aJava 10\u63d0\u4f9b\u826f\u597d\u652f\u6301\u7684IntelliJ IDEA\u3002\u7531\u4e8eJava 10\u4ec5\u652f\u630164\u4f4d\u7684\u5e73\u53f0\uff0c\u8bb0\u5f97\u4e0b\u8f7d64\u4f4d\u7248\u672c\u7684IntelliJ\u3002IntelliJ\u63d0\u4f9b\u6709\u4e00\u4e2a\u514d\u8d39\u4e14\u5f00\u6e90\u7684\u793e\u533a\u7248\uff0c\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83\uff1a https://www.jetbrains.com/idea/download/ \u3002 \u4e3a\u4e86\u6784\u5efa\u793a\u4f8b\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u4f7f\u7528 Maven \u3002Maven\u5df2\u7ecf\u96c6\u6210\u5728\u5927\u591a\u6570IDE\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5728IDE\u4e2d\u76f4\u63a5\u6253\u5f00\u4e0d\u540c\u7ae0\u8282\u7684\u793a\u4f8b\u4ee3\u7801\u3002\u53ea\u8981\u6253\u5f00\u4e86\u793a\u4f8b\u4ee3\u7801\u6240\u5728\u7684\u6587\u4ef6\u5939\uff0cIntelliJ\u5c31\u4f1a\u68c0\u6d4b\u5230\u5b83\u662f\u4e00\u4e2aMaven\u9879\u76ee\u3002 Maven\u57fa\u4e8e\u4e00\u4e2a\u540d\u4e3a pom.xml \uff08Project Object Model\uff0c\u9879\u76ee\u5bf9\u8c61\u6a21\u578b\uff09\u7684XML\u6587\u4ef6\u6765\u6784\u5efa\u9879\u76ee\uff0c\u5b83\u7ba1\u7406\u4e86\u9879\u76ee\u7684\u4f9d\u8d56\uff08\u9700\u8981\u4f7f\u7528\u7684\u5e93\uff09\u548c\u5728\u6784\u5efa\u8fc7\u7a0b\u4e2d\u9700\u8981\u6267\u884c\u7684\u6b65\u9aa4\u3002Maven\u9075\u5faa\u7ea6\u5b9a\u9ad8\u4e8e\u914d\u7f6e\u7684\u539f\u5219\uff0c\u5373\u5982\u679c\u4f60\u9075\u5b88\u6807\u51c6\u7684\u9879\u76ee\u7ed3\u6784\u548c\u547d\u540d\u7ea6\u5b9a\uff0c\u5c31\u4e0d\u9700\u8981\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u660e\u786e\u5730\u58f0\u660e\u6e90\u6587\u4ef6\u5728\u54ea\u91cc\u6216\u8005\u5e94\u8be5\u5728\u54ea\u91cc\u7f16\u8bd1\u7c7b\u3002 \u672c\u4e66\u4e0d\u662f\u4e00\u4e2aMaven\u6559\u7a0b\uff0c\u5982\u679c\u6709\u9700\u8981\uff0c\u8bf7\u5728\u7f51\u4e0a\u641c\u7d22Maven\u7684\u76f8\u5173\u8d44\u6599\u3002\u6e90\u4ee3\u7801\u6587\u4ef6\u5939\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7236\u9879\u76ee\uff0c\u5b83\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u63d2\u4ef6\u5e76\u4e14\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u5e93\u7684\u7248\u672c\u3002 LWJGL 3.1\u5728\u9879\u76ee\u6784\u5efa\u4e0a\u6709\u4e00\u4e9b\u53d8\u5316\u3002\u73b0\u5728\uff0c\u5b83\u53d8\u5f97\u66f4\u52a0\u6a21\u5757\u5316\uff0c\u6211\u4eec\u53ef\u4ee5\u6709\u9009\u62e9\u5730\u4f7f\u7528\u7c7b\u5e93\uff0c\u800c\u4e0d\u662f\u5bfc\u5165\u4e00\u4e2a\u5de8\u5927\u7684Jar\u6587\u4ef6\u3002\u4f46\u8fd9\u662f\u6709\u4ee3\u4ef7\u7684\uff1a\u4f60\u9700\u8981\u4ed4\u7ec6\u5730\u9010\u4e2a\u6307\u5b9a\u4f9d\u8d56\u5173\u7cfb\u3002\u4e0d\u8fc7 LWJGL\u4e0b\u8f7d \u9875\u9762\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4e3a\u60a8\u751f\u6210POM\u6587\u4ef6\u7684\u811a\u672c\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u4f7f\u7528GLFW\u548cOpenGL\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u6211\u4eec\u7684POM\u6587\u4ef6\u3002 LWJGL\u5e73\u53f0\u4f9d\u8d56\u5e93\u5df2\u7ecf\u53ef\u4ee5\u4e3a\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u81ea\u52a8\u89e3\u538b\u672c\u5730\u5e93\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u4f7f\u7528\u5176\u4ed6\u63d2\u4ef6\uff08\u4f8b\u5982 mavennatives \uff09\u3002\u6211\u4eec\u53ea\u9700\u8981\u914d\u7f6e\u4e09\u4e2aProfile\u6765\u8bbe\u7f6eLWJGL\u6240\u5904\u7684\u64cd\u4f5c\u7cfb\u7edf\u3002Profile\u5c06\u4f1a\u4e3aWindows\u3001Linux\u548cMac OS\u7cfb\u5217\u8bbe\u7f6e\u6b63\u786e\u7684\u503c\u3002 <profiles> <profile> <id>windows-profile</id> <activation> <os> <family>Windows</family> </os> </activation> <properties> <native.target>natives-windows</native.target> </properties> </profile> <profile> <id>linux-profile</id> <activation> <os> <family>Linux</family> </os> </activation> <properties> <native.target>natives-linux</native.target> </properties> </profile> <profile> <id>OSX-profile</id> <activation> <os> <family>mac</family> </os> </activation> <properties> <native.target>natives-osx</native.target> </properties> </profile> </profiles> \u5728\u6bcf\u4e2a\u9879\u76ee\u4e2d\uff0cLWJGL\u5e73\u53f0\u4f9d\u8d56\u9879\u5c06\u4f7f\u7528\u914d\u7f6e\u6587\u4ef6\u4e3a\u5f53\u524d\u5e73\u53f0\u8bbe\u7f6e\u7684\u6b63\u786e\u7684\u5c5e\u6027\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-platform</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> </dependency> \u6b64\u5916\uff0c\u6bcf\u4e2a\u9879\u76ee\u53ef\u751f\u6210\u4e00\u4e2a\u53ef\u8fd0\u884c\u7684Jar\uff08\u4e00\u79cd\u53ef\u4ee5\u901a\u8fc7\u8f93\u5165 java -jar name_of_the_jar.jar \u5c31\u53ef\u8fd0\u884c\u7684Jar\uff09\uff0c\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528Maven\u7684 maven-jar-plugin \u63d2\u4ef6\u5b9e\u73b0\u7684\u3002\u8be5\u63d2\u4ef6\u521b\u5efa\u4e86\u4e00\u4e2a\u542b\u6709 MANIFEST.MF \u6587\u4ef6\u7684Jar\uff0c\u5e76\u4e14\u6587\u4ef6\u5185\u6709\u6307\u5b9a\u7684\u503c\uff0c\u8be5\u6587\u4ef6\u6700\u91cd\u8981\u7684\u5c5e\u6027\u5c31\u662f Main-Class \uff0c\u5b83\u6307\u660e\u4e86\u7a0b\u5e8f\u7684\u5165\u53e3\u3002\u6b64\u5916\uff0c\u6240\u6709\u7684\u4f9d\u8d56\u5e93\u90fd\u88ab\u8bbe\u7f6e\u5728\u8be5\u6587\u4ef6\u7684 Class-Path \u5c5e\u6027\u4e2d\u3002\u8981\u5728\u53e6\u4e00\u53f0\u8ba1\u7b97\u673a\u4e0a\u8fd0\u884c\u5b83\uff0c\u4f60\u53ea\u9700\u8981\u590d\u5236\u4f4d\u4e8e\u76ee\u6807\u76ee\u5f55\u4e0b\u7684\u4e3bJar\u6587\u4ef6\u548cLib\u76ee\u5f55\uff08\u5305\u62ec\u5176\u4e2d\u6240\u6709\u7684Jar\u6587\u4ef6\uff09\u3002 Jar\u6587\u4ef6\u50a8\u5b58\u7740LWJGL\u7c7b\u548c\u672c\u5730\u5e93\u3002LWJGL\u8fd8\u5c06\u8d1f\u8d23\u63d0\u53d6\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u6dfb\u52a0\u5230JVM\u7684\u5e93\u8def\u5f84\u4e2d\u3002 \u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u662fLWJGL\u7f51\u7ad9( https://www.lwjgl.org/guide )\u63d0\u4f9b\u7684\u7684\u5165\u95e8\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6ca1\u6709\u4f7f\u7528Swing\u6216JavaFX\u4f5c\u4e3a\u6211\u4eec\u7684GUI\u5e93\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f GLFW \uff0c\u5b83\u662f\u4e00\u4e2a\u7528\u4e8e\u5904\u7406GUI\u7ec4\u4ef6\uff08\u7a97\u53e3\u7b49\uff09\u548c\u4e8b\u4ef6\uff08\u6309\u952e\u6309\u4e0b\u3001\u9f20\u6807\u79fb\u52a8\u7b49\uff09\uff0c\u5e76\u4e14\u4e0eOpenGL\u4e0a\u4e0b\u6587\u8fdb\u884c\u7b80\u5355\u8fde\u63a5\u7684\u5e93\u3002\u6b64\u524d\u7248\u672c\u7684LWJGL\u63d0\u4f9b\u4e86\u4e00\u4e2a\u81ea\u5b9a\u4e49GUI API\uff0c\u4f46\u5728LWJGL 3\u4e2d\uff0cGLFW\u662f\u9996\u9009\u7684\u7a97\u53e3API\u3002 \u793a\u4f8b\u6e90\u7801\u5f88\u7b80\u5355\u5e76\u6709\u7740\u826f\u597d\u7684\u6587\u6863\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u4f1a\u5728\u4e66\u4e2d\u518d\u6b21\u8bf4\u660e\u3002 \u5982\u679c\u4f60\u6b63\u786e\u5730\u914d\u7f6e\u4e86\u73af\u5883\uff0c\u4f60\u5e94\u8be5\u80fd\u591f\u8fd0\u884c\u5b83\u5e76\u770b\u5230\u4e00\u4e2a\u6709\u7ea2\u8272\u80cc\u666f\u7684\u7a97\u53e3\u3002 \u672c\u4e66\u4e2d\u6e90\u4ee3\u7801\u53d1\u5e03\u4e8e GitHub \u3002","title":"\u4e8b\u524d\u51c6\u5907\uff08First Steps\uff09"},{"location":"02-the-game-loop/","text":"\u6e38\u620f\u5faa\u73af\uff08The Game Loop\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u6e38\u620f\u5faa\u73af\u6765\u5f00\u59cb\u5f00\u53d1\u6e38\u620f\u5f15\u64ce\u3002\u6e38\u620f\u5faa\u73af\u662f\u6bcf\u4e2a\u6e38\u620f\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u4e2a\u65e0\u4f11\u6b62\u7684\u5faa\u73af\uff0c\u8d1f\u8d23\u5468\u671f\u5730\u5904\u7406\u7528\u6237\u7684\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u56fe\u50cf\u5230\u5c4f\u5e55\u4e0a\u3002 \u4e0b\u8ff0\u4ee3\u7801\u7247\u6bb5\u5c55\u793a\u4e86\u6e38\u620f\u5faa\u73af\u7684\u7ed3\u6784\uff1a while (keepOnRunning) { handleInput(); updateGameState(); render(); } \u90a3\u4e48\uff0c\u8fd9\u5c31\u5b8c\u4e86\u5417\uff1f\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u6e38\u620f\u5faa\u73af\u4e86\u5417\uff1f\u663e\u7136\u8fd8\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6709\u5f88\u591a\u7f3a\u9677\u3002\u9996\u5148\uff0c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u7684\u901f\u5ea6\u5c06\u53d6\u51b3\u4e8e\u8fd0\u884c\u5b83\u7684\u8ba1\u7b97\u673a\u3002\u5982\u679c\u8ba1\u7b97\u673a\u8db3\u591f\u5feb\uff0c\u7528\u6237\u751a\u81f3\u770b\u4e0d\u5230\u6e38\u620f\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u6b64\u5916\uff0c\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5c06\u6d88\u8017\u6240\u6709\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6e38\u620f\u5faa\u73af\u72ec\u7acb\u4e8e\u8fd0\u884c\u7684\u8ba1\u7b97\u673a\uff0c\u5c1d\u8bd5\u4ee5\u6052\u5b9a\u901f\u7387\u8fd0\u884c\u3002\u5047\u8bbe\u6211\u4eec\u5e0c\u671b\u6e38\u620f\u4ee5\u6bcf\u79d250\u5e27\uff0850 Frames Per Second\uff0c50 FPS\uff09\u7684\u6052\u5b9a\u901f\u7387\u8fd0\u884c\uff0c\u90a3\u4e48\u6e38\u620f\u5faa\u73af\u4ee3\u7801\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff1a double secsPerFrame = 1.0d / 50.0d; while (keepOnRunning) { double now = getTime(); handleInput(); updateGameState(); render(); sleep(now + secsPerFrame \u2013 getTime()); } \u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5f88\u7b80\u5355\uff0c\u53ef\u4ee5\u7528\u4e8e\u4e00\u4e9b\u6e38\u620f\uff0c\u4f46\u662f\u5b83\u4e5f\u5b58\u5728\u4e00\u4e9b\u7f3a\u9677\u3002\u9996\u5148\uff0c\u5b83\u5047\u5b9a\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u9002\u5408\u4ee550FPS\uff08\u5373 secsPerFrame \u7b49\u4e8e20\u6beb\u79d2\uff09\u7684\u901f\u7387\u66f4\u65b0\u3002 \u6b64\u5916\uff0c\u6211\u4eec\u7684\u8ba1\u7b97\u673a\u53ef\u80fd\u4f1a\u4f18\u5148\u8003\u8651\u6682\u505c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u4e00\u6bb5\u65f6\u95f4\uff0c\u4ee5\u8fd0\u884c\u5176\u4ed6\u7684\u4efb\u52a1\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u80fd\u4f1a\u5728\u975e\u5e38\u4e0d\u7a33\u5b9a\u7684\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\uff0c\u8fd9\u662f\u4e0d\u7b26\u5408\u6e38\u620f\u7269\u7406\u7684\u8981\u6c42\u7684\u3002 \u6700\u540e\uff0c\u7ebf\u7a0b\u4f11\u7720\u7684\u65f6\u95f4\u7cbe\u5ea6\u4ec5\u4ec5\u53ea\u67090.1\u79d2\uff0c\u6240\u4ee5\u5373\u4f7f\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u6ca1\u6709\u6d88\u8017\u65f6\u95f4\uff0c\u4e5f\u4e0d\u4f1a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u3002\u6240\u4ee5\uff0c\u5982\u4f60\u6240\u89c1\uff0c\u95ee\u9898\u6ca1\u90a3\u4e48\u7b80\u5355\u3002 \u5728\u7f51\u4e0a\u4f60\u53ef\u4ee5\u627e\u5230\u5927\u91cf\u7684\u6e38\u620f\u5faa\u73af\u7684\u53d8\u79cd\u3002\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u7528\u4e00\u4e2a\u4e0d\u592a\u590d\u6742\u7684\uff0c\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u80fd\u6b63\u5e38\u5de5\u4f5c\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u7528\u7684\u65b9\u6cd5\u901a\u5e38\u88ab\u79f0\u4e3a \u5b9a\u957f\u6e38\u620f\u5faa\u73af \uff08Fixed Step Game Loop\uff09\u3002 \u9996\u5148\uff0c\u6211\u4eec\u53ef\u80fd\u60f3\u8981\u5355\u72ec\u63a7\u5236\u6e38\u620f\u72b6\u6001\u88ab\u66f4\u65b0\u7684\u5468\u671f\u548c\u6e38\u620f\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u7684\u5468\u671f\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u56e0\u4e3a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u66f4\u4e3a\u91cd\u8981\uff0c\u7279\u522b\u662f\u5982\u679c\u4f7f\u7528\u7269\u7406\u5f15\u64ce\u3002\u76f8\u53cd\uff0c\u5982\u679c\u6e32\u67d3\u6ca1\u6709\u53ca\u65f6\u5b8c\u6210\uff0c\u5728\u8fd0\u884c\u6e38\u620f\u5faa\u73af\u65f6\u6e32\u67d3\u65e7\u5e27\u4e5f\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6211\u4eec\u53ef\u4ee5\u7075\u6d3b\u5730\u8df3\u8fc7\u67d0\u4e9b\u5e27\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u73b0\u5728\u7684\u6e38\u620f\u5faa\u73af\u662f\u4ec0\u4e48\u6837\u7684\uff1a double secsPerUpdate = 1.0d / 30.0d; double previous = getTime(); double steps = 0.0; while (true) { double loopStartTime = getTime(); double elapsed = loopStartTime - previous; previous = loopStartTime; steps += elapsed; handleInput(); while (steps >= secsPerUpdate) { updateGameState(); steps -= secsPerUpdate; } render(); sync(loopStartTime); } \u4f7f\u7528\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u56fa\u5b9a\u7684\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u3002\u4f46\u662f\u5982\u4f55\u907f\u514d\u8017\u5c3d\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u4f7f\u5b83\u4e0d\u8fde\u7eed\u6e32\u67d3\u5462\uff1f\u8fd9\u5728 sync \u65b9\u6cd5\u4e2d\u5b9e\u73b0\uff1a private void sync(double loopStartTime) { float loopSlot = 1f / 50; double endTime = loopStartTime + loopSlot; while(getTime() < endTime) { try { Thread.sleep(1); } catch (InterruptedException ie) {} } } \u90a3\u4e48\u4e0a\u8ff0\u65b9\u6cd5\u505a\u4e86\u4ec0\u4e48\u5462\uff1f\u7b80\u800c\u8a00\u4e4b\uff0c\u6211\u4eec\u8ba1\u7b97\u6e38\u620f\u5faa\u73af\u8fed\u4ee3\u5e94\u8be5\u6301\u7eed\u591a\u957f\u65f6\u95f4\uff08\u5b83\u88ab\u50a8\u5b58\u5728 loopSlot \u53d8\u91cf\u4e2d\uff09\uff0c\u4f11\u7720\u7684\u65f6\u95f4\u53d6\u51b3\u4e8e\u5728\u5faa\u73af\u4e2d\u82b1\u8d39\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u4e0d\u505a\u4e00\u6574\u6bb5\u65f6\u95f4\u7684\u4f11\u7720\uff0c\u800c\u662f\u8fdb\u884c\u4e00\u4e9b\u5c0f\u7684\u4f11\u7720\u3002\u8fd9\u5141\u8bb8\u5176\u4ed6\u4efb\u52a1\u8fd0\u884c\uff0c\u5e76\u907f\u514d\u6b64\u524d\u63d0\u5230\u7684\u4f11\u7720\u51c6\u786e\u6027\u95ee\u9898\u3002\u63a5\u4e0b\u6765\u6211\u4eec\u8981\u505a\u7684\u662f\uff1a 1. \u8ba1\u7b97\u5e94\u8be5\u9000\u51fa\u8fd9\u4e2a\u65b9\u6cd5\u7684\u65f6\u95f4\uff08\u8fd9\u4e2a\u53d8\u91cf\u540d\u4e3a endTime \uff09\uff0c\u5e76\u5f00\u59cb\u6e38\u620f\u5faa\u73af\u7684\u53e6\u4e00\u6b21\u8fed\u4ee3\u3002 2. \u6bd4\u8f83\u5f53\u524d\u65f6\u95f4\u548c\u7ed3\u675f\u65f6\u95f4\uff0c\u5982\u679c\u6ca1\u6709\u5230\u8fbe\u7ed3\u675f\u65f6\u95f4\uff0c\u5c31\u4f11\u77201\u6beb\u79d2\u3002 \u73b0\u5728\u662f\u6784\u5efa\u4ee3\u7801\u5e93\u4ee5\u4fbf\u5f00\u59cb\u7f16\u5199\u6e38\u620f\u5f15\u64ce\u7684\u7b2c\u4e00\u4e2a\u7248\u672c\u7684\u65f6\u5019\u4e86\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u6765\u8ba8\u8bba\u4e00\u4e0b\u63a7\u5236\u6e32\u67d3\u901f\u7387\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u505a\u5fae\u4f11\u7720\u662f\u4e3a\u4e86\u63a7\u5236\u9700\u8981\u7b49\u5f85\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u53e6\u4e00\u79cd\u65b9\u6cd5\u6765\u9650\u5236\u5e27\u7387\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 \u5782\u76f4\u540c\u6b65 \uff08Vertical Synchronization\uff09\uff0c\u5782\u76f4\u540c\u6b65\u7684\u4e3b\u8981\u76ee\u7684\u662f\u907f\u514d\u753b\u9762\u6495\u88c2\u3002\u4ec0\u4e48\u662f\u753b\u9762\u6495\u88c2\uff1f\u8fd9\u662f\u4e00\u79cd\u663e\u793a\u73b0\u8c61\uff0c\u5f53\u6b63\u5728\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u66f4\u65b0\u56fe\u50cf\u50a8\u5b58\u533a\uff0c\u5bfc\u81f4\u5c4f\u5e55\u7684\u4e00\u90e8\u5206\u663e\u793a\u5148\u524d\u7684\u56fe\u50cf\uff0c\u800c\u5c4f\u5e55\u7684\u53e6\u4e00\u90e8\u5206\u663e\u793a\u6b63\u5728\u6e32\u67d3\u7684\u56fe\u50cf\u3002\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u5f53GPU\u4e2d\u7684\u6570\u636e\u6b63\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4e0d\u4f1a\u5411GPU\u53d1\u9001\u6570\u636e\u3002 \u5f53\u5f00\u542f\u5782\u76f4\u540c\u6b65\u65f6\uff0c\u6211\u4eec\u5c06\u4e0e\u663e\u5361\u7684\u5237\u65b0\u7387\u540c\u6b65\uff0c\u663e\u5361\u5c06\u4ee5\u6052\u5b9a\u7684\u5e27\u7387\u6e32\u67d3\u3002\u7528\u4e0b\u8ff0\u4e00\u884c\u4ee3\u7801\u542f\u7528\u5b83\uff1a glfwSwapInterval(1); \u6709\u4e86\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u610f\u5473\u7740\u81f3\u5c11\u5728\u4e00\u4e2a\u5c4f\u5e55\u66f4\u65b0\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u7b49\u5f85\u3002\u4e8b\u5b9e\u4e0a\u6211\u4eec\u4e0d\u662f\u76f4\u63a5\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u6570\u636e\u50a8\u5b58\u5728\u7f13\u51b2\u533a\u4e2d\uff0c\u7136\u540e\u7528\u4e0b\u9762\u7684\u65b9\u6cd5\u4ea4\u6362\u5b83\uff1a glfwSwapBuffers(windowHandle); \u56e0\u6b64\uff0c\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u7a33\u5b9a\u7684\u5e27\u7387\uff0c\u800c\u4e0d\u9700\u8981\u8fdb\u884c\u5fae\u4f11\u7720\u6765\u68c0\u67e5\u66f4\u65b0\u65f6\u95f4\u3002\u6b64\u5916\uff0c\u5e27\u7387\u5c06\u4e0e\u8bbe\u5907\u7684\u663e\u5361\u5237\u65b0\u7387\u76f8\u5339\u914d\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5982\u679c\u5b83\u8bbe\u5b9a\u4e3a60Hz\uff0860FPS\uff09\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u670960FPS\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5728 glfwSwapInterval \u65b9\u6cd5\u4e2d\u8bbe\u7f6e\u9ad8\u4e8e1\u7684\u6570\u5b57\u6765\u964d\u4f4e\u8fd9\u4e2a\u901f\u7387\uff08\u5982\u679c\u8bbe\u7f6e\u4e3a2\uff0c\u5c06\u5f97\u523030FPS\uff09\u3002 \u8ba9\u6211\u4eec\u6574\u7406\u4e00\u4e0b\u6e90\u4ee3\u7801\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u628a\u6240\u6709\u7684GLFW\u7a97\u53e3\u521d\u59cb\u5316\u4ee3\u7801\u5c01\u88c5\u5728\u4e00\u4e2a\u540d\u4e3a Window \u7684\u7c7b\u4e2d\uff0c\u4f20\u9012\u4e00\u4e9b\u57fa\u672c\u7684\u53c2\u6570\uff08\u5982\u6807\u9898\u548c\u5927\u5c0f\uff09\u3002 Window \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u4ee5\u4fbf\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u68c0\u6d4b\u6309\u4e0b\u7684\u6309\u952e\uff1a public boolean isKeyPressed(int keyCode) { return glfwGetKey(windowHandle, keyCode) == GLFW_PRESS; } \u9664\u4e86\u6709\u521d\u59cb\u5316\u4ee3\u7801\u4ee5\u5916\uff0c Window \u7c7b\u8fd8\u9700\u8981\u77e5\u9053\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u3002\u56e0\u6b64\u9700\u8981\u8bbe\u7f6e\u4e00\u4e2a\u56de\u8c03\u65b9\u6cd5\uff0c\u5728\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\u8c03\u7528\u5b83\u3002\u56de\u8c03\u65b9\u6cd5\u5c06\u63a5\u6536\u5e27\u7f13\u51b2\u533a\uff08\u6e32\u67d3\u533a\u57df\uff0c\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u663e\u793a\u533a\u57df\uff09\u7684\u4ee5\u50cf\u7d20\u4e3a\u5355\u4f4d\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u3002\u5982\u679c\u5e0c\u671b\u5f97\u5230\u5e27\u7f13\u51b2\u533a\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 glfwSetWindowSizeCallback \u65b9\u6cd5\u3002\u5c4f\u5e55\u5750\u6807\u4e0d\u4e00\u5b9a\u5bf9\u5e94\u50cf\u7d20\uff08\u4f8b\u5982\uff0c\u5177\u6709\u89c6\u7f51\u819c\u663e\u793a\u5c4f\uff08Retina Display\uff09\u7684Mac\u8bbe\u5907\uff09\u3002\u56e0\u4e3a\u6211\u4eec\u5c06\u5728\u8fdb\u884cOpenGL\u8c03\u7528\u65f6\u4f7f\u7528\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6240\u4ee5\u8981\u6ce8\u610f\u50cf\u7d20\u4e0d\u5728\u5c4f\u5e55\u5750\u6807\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7GLFW\u7684\u6587\u6863\u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002 // \u8bbe\u7f6e\u8c03\u6574\u5927\u5c0f\u56de\u8c03 glfwSetFramebufferSizeCallback(windowHandle, (window, width, height) -> { Window.this.width = width; Window.this.height = height; Window.this.setResized(true); }); \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a Renderer \u7c7b\uff0c\u5b83\u5c06\u5904\u7406\u6211\u4eec\u6e38\u620f\u7684\u6e32\u67d3\u3002\u73b0\u5728\uff0c\u5b83\u4ec5\u4f1a\u6709\u4e00\u4e2a\u7a7a\u7684 init \u65b9\u6cd5\uff0c\u548c\u53e6\u4e00\u4e2a\u7528\u9884\u8bbe\u989c\u8272\u6e05\u7a7a\u5c4f\u5e55\u7684\u65b9\u6cd5\uff1a public void init() throws Exception { } public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IGameLogic \u7684\u63a5\u53e3\uff0c\u5b83\u5c01\u88c5\u4e86\u6211\u4eec\u7684\u6e38\u620f\u903b\u8f91\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba9\u6e38\u620f\u5f15\u64ce\u5728\u4e0d\u540c\u7684\u6e38\u620f\u4e0a\u91cd\u590d\u4f7f\u7528\u3002\u8be5\u63a5\u53e3\u5c06\u5177\u6709\u83b7\u53d6\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u6e38\u620f\u5185\u5bb9\u7684\u65b9\u6cd5\u3002 public interface IGameLogic { void init() throws Exception; void input(Window window); void update(float interval); void render(Window window); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameEngine \u7684\u7c7b\uff0c\u5b83\u5c06\u5305\u542b\u6211\u4eec\u6e38\u620f\u5faa\u73af\u7684\u4ee3\u7801\uff0c\u8be5\u7c7b\u5c06\u5b9e\u73b0\u50a8\u5b58\u6e38\u620f\u5faa\u73af\uff1a public class GameEngine implements Runnable { //... public GameEngine(String windowTitle, int width, int height, boolean vSync, IGameLogic gameLogic) throws Exception { window = new Window(windowTitle, width, height, vSync); this.gameLogic = gameLogic; //... } vSync \u53c2\u6570\u5141\u8bb8\u6211\u4eec\u9009\u62e9\u662f\u5426\u542f\u7528\u5782\u76f4\u540c\u6b65\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5b9e\u73b0\u4e86 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u62ec\u6e38\u620f\u5faa\u73af\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } } GameEngine \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a run \u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u6267\u884c\u521d\u59cb\u5316\u4efb\u52a1\uff0c\u5e76\u8fd0\u884c\u6e38\u620f\u5faa\u73af\uff0c\u76f4\u5230\u6211\u4eec\u5173\u95ed\u7a97\u53e3\u3002\u5173\u4e8e\u7ebf\u7a0b\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0cGLFW\u9700\u8981\u4ece\u4e3b\u7ebf\u7a0b\u521d\u59cb\u5316\uff0c\u4e8b\u4ef6\u7684\u8f6e\u8be2\u4e5f\u5e94\u8be5\u5728\u8be5\u7ebf\u7a0b\u4e2d\u5b8c\u6210\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728\u4e3b\u7ebf\u7a0b\u4e2d\u6267\u884c\u6240\u6709\u5185\u5bb9\uff0c\u800c\u4e0d\u662f\u4e3a\u6e38\u620f\u5faa\u73af\u521b\u5efa\u5355\u72ec\u7684\u7ebf\u7a0b\u3002 \u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u5c06\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u5176\u4ed6\u8f85\u52a9\u7c7b\uff0c\u4f8b\u5982 Timer \uff08\u5b83\u5c06\u63d0\u4f9b\u7528\u4e8e\u8ba1\u7b97\u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\u7684\u5b9e\u7528\u65b9\u6cd5\uff09\uff0c\u5e76\u5728\u6e38\u620f\u5faa\u73af\u903b\u8f91\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002 GameEngine \u7c7b\u53ea\u662f\u5c06 input \u548c update \u65b9\u6cd5\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u3002\u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5b83\u4e5f\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u5e76\u66f4\u65b0\u7a97\u53e3\u3002 protected void input() { gameLogic.input(window); } protected void update(float interval) { gameLogic.update(interval); } protected void render() { gameLogic.render(window); window.update(); } \u5728\u7a0b\u5e8f\u7684\u5165\u53e3\uff0c\u542b\u6709 main \u65b9\u6cd5\u7684\u7c7b\u53ea\u4f1a\u521b\u5efa\u4e00\u4e2a GameEngine \u5b9e\u4f8b\u5e76\u8fd0\u884c\u5b83\u3002 public class Main { public static void main(String[] args) { try { boolean vSync = true; IGameLogic gameLogic = new DummyGame(); GameEngine gameEng = new GameEngine(\"GAME\", 600, 480, vSync, gameLogic); gameEng.run(); } catch (Exception excp) { excp.printStackTrace(); System.exit(-1); } } } \u6700\u540e\uff0c\u5728\u672c\u7ae0\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684\u6e38\u620f\u903b\u8f91\u7c7b\u3002\u5b83\u53ea\u4f1a\u5728\u6309\u4e0b\u4e0a\u6216\u4e0b\u952e\u65f6\uff0c\u53d8\u4eae\u6216\u53d8\u6697\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u7684\u6e05\u7a7a\u989c\u8272\uff0c render \u65b9\u6cd5\u5c06\u4f1a\u7528\u8fd9\u4e2a\u989c\u8272\u6e05\u7a7a\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u3002 public class DummyGame implements IGameLogic { private int direction = 0; private float color = 0.0f; private final Renderer renderer; public DummyGame() { renderer = new Renderer(); } @Override public void init() throws Exception { renderer.init(); } @Override public void input(Window window) { if (window.isKeyPressed(GLFW_KEY_UP)) { direction = 1; } else if (window.isKeyPressed(GLFW_KEY_DOWN)) { direction = -1; } else { direction = 0; } } @Override public void update(float interval) { color += direction * 0.01f; if (color > 1) { color = 1.0f; } else if ( color < 0 ) { color = 0.0f; } } @Override public void render(Window window) { if (window.isResized()) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } window.setClearColor(color, color, color, 0.0f); renderer.clear(); } } \u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5f53\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\uff0c\u6211\u4eec\u63a5\u6536\u901a\u77e5\uff0c\u4ee5\u4fbf\u66f4\u65b0\u89c6\u53e3\u5c06\u5750\u6807\u4e2d\u5fc3\u5b9a\u4f4d\u5230\u7a97\u53e3\u7684\u4e2d\u5fc3\u3002 \u521b\u5efa\u7684\u7c7b\u5c42\u6b21\u7ed3\u6784\u5c06\u5e2e\u52a9\u6211\u4eec\u5c06\u6e38\u620f\u5f15\u64ce\u4ee3\u7801\u4e0e\u5177\u4f53\u7684\u6e38\u620f\u4ee3\u7801\u5206\u5f00\u3002\u867d\u7136\u73b0\u5728\u53ef\u80fd\u770b\u8d77\u6765\u6ca1\u6709\u5fc5\u8981\uff0c\u4f46\u6211\u4eec\u5df2\u5c06\u6bcf\u4e2a\u6e38\u620f\u7684\u901a\u7528\u4ee3\u7801\uff0c\u4ece\u5177\u4f53\u7684\u6e38\u620f\u7684\u903b\u8f91\u3001\u7f8e\u672f\u4f5c\u54c1\u548c\u8d44\u6e90\u4e2d\u5206\u79bb\u51fa\u6765\uff0c\u4ee5\u4fbf\u91cd\u7528\u6e38\u620f\u5f15\u64ce\u3002\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u8fd9\u4e2a\u7c7b\u5c42\u6b21\u7ed3\u6784\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u6e38\u620f\u5f15\u64ce\u53d8\u5f97\u66f4\u52a0\u590d\u6742\u3002 \u5e73\u53f0\u5dee\u5f02\uff08OSX\uff09 \u4f60\u53ef\u4ee5\u8fd0\u884c\u4e0a\u9762\u7684\u4ee3\u7801\u5728Windows\u6216Linux\u4e0a\uff0c\u4f46\u6211\u4eec\u4ecd\u9700\u8981\u4e3aOS X\u5e73\u53f0\u505a\u4e00\u4e9b\u4fee\u6539\u3002\u6b63\u5982GLFW\u6587\u6863\u4e2d\u6240\u63cf\u8ff0\u7684\uff1a \u76ee\u524dOS X\u4ec5\u652f\u6301\u7684OpenGL 3.x\u548c4.x\u7248\u672c\u7684\u73af\u5883\u662f\u5411\u4e0a\u517c\u5bb9\u7684\u3002OS X 10.7 Lion\u652f\u6301OpenGL 3.2\u7248\u672c\u548cOS X 10.9 Mavericks\u652f\u6301OpenGL 3.3\u548c4.1\u7248\u672c\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u7684GPU\u9700\u8981\u652f\u6301\u6307\u5b9a\u7248\u672c\u7684OpenGL\uff0c\u4ee5\u6210\u529f\u521b\u5efa\u73af\u5883\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u652f\u6301\u5728\u6b64\u540e\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u7279\u6027\uff0c\u6211\u4eec\u9700\u8981\u5c06\u4e0b\u8ff0\u4ee3\u7801\u6dfb\u52a0\u5230 Window \u7c7b\u521b\u5efa\u7a97\u53e3\u4ee3\u7801\u4e4b\u524d\uff1a glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 2); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE); \u8fd9\u5c06\u4f7f\u7a0b\u5e8f\u4f7f\u7528OpenGL 3.2\u52304.1\u4e4b\u95f4\u7684\u6700\u9ad8\u7248\u672c\u3002\u5982\u679c\u6ca1\u6709\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u4f1a\u4f7f\u7528\u65e7\u7248\u672c\u7684OpenGL\u3002","title":"\u6e38\u620f\u5faa\u73af"},{"location":"02-the-game-loop/#the-game-loop","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u6e38\u620f\u5faa\u73af\u6765\u5f00\u59cb\u5f00\u53d1\u6e38\u620f\u5f15\u64ce\u3002\u6e38\u620f\u5faa\u73af\u662f\u6bcf\u4e2a\u6e38\u620f\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u4e2a\u65e0\u4f11\u6b62\u7684\u5faa\u73af\uff0c\u8d1f\u8d23\u5468\u671f\u5730\u5904\u7406\u7528\u6237\u7684\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u56fe\u50cf\u5230\u5c4f\u5e55\u4e0a\u3002 \u4e0b\u8ff0\u4ee3\u7801\u7247\u6bb5\u5c55\u793a\u4e86\u6e38\u620f\u5faa\u73af\u7684\u7ed3\u6784\uff1a while (keepOnRunning) { handleInput(); updateGameState(); render(); } \u90a3\u4e48\uff0c\u8fd9\u5c31\u5b8c\u4e86\u5417\uff1f\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u6e38\u620f\u5faa\u73af\u4e86\u5417\uff1f\u663e\u7136\u8fd8\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6709\u5f88\u591a\u7f3a\u9677\u3002\u9996\u5148\uff0c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u7684\u901f\u5ea6\u5c06\u53d6\u51b3\u4e8e\u8fd0\u884c\u5b83\u7684\u8ba1\u7b97\u673a\u3002\u5982\u679c\u8ba1\u7b97\u673a\u8db3\u591f\u5feb\uff0c\u7528\u6237\u751a\u81f3\u770b\u4e0d\u5230\u6e38\u620f\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u6b64\u5916\uff0c\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5c06\u6d88\u8017\u6240\u6709\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6e38\u620f\u5faa\u73af\u72ec\u7acb\u4e8e\u8fd0\u884c\u7684\u8ba1\u7b97\u673a\uff0c\u5c1d\u8bd5\u4ee5\u6052\u5b9a\u901f\u7387\u8fd0\u884c\u3002\u5047\u8bbe\u6211\u4eec\u5e0c\u671b\u6e38\u620f\u4ee5\u6bcf\u79d250\u5e27\uff0850 Frames Per Second\uff0c50 FPS\uff09\u7684\u6052\u5b9a\u901f\u7387\u8fd0\u884c\uff0c\u90a3\u4e48\u6e38\u620f\u5faa\u73af\u4ee3\u7801\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff1a double secsPerFrame = 1.0d / 50.0d; while (keepOnRunning) { double now = getTime(); handleInput(); updateGameState(); render(); sleep(now + secsPerFrame \u2013 getTime()); } \u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5f88\u7b80\u5355\uff0c\u53ef\u4ee5\u7528\u4e8e\u4e00\u4e9b\u6e38\u620f\uff0c\u4f46\u662f\u5b83\u4e5f\u5b58\u5728\u4e00\u4e9b\u7f3a\u9677\u3002\u9996\u5148\uff0c\u5b83\u5047\u5b9a\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u9002\u5408\u4ee550FPS\uff08\u5373 secsPerFrame \u7b49\u4e8e20\u6beb\u79d2\uff09\u7684\u901f\u7387\u66f4\u65b0\u3002 \u6b64\u5916\uff0c\u6211\u4eec\u7684\u8ba1\u7b97\u673a\u53ef\u80fd\u4f1a\u4f18\u5148\u8003\u8651\u6682\u505c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u4e00\u6bb5\u65f6\u95f4\uff0c\u4ee5\u8fd0\u884c\u5176\u4ed6\u7684\u4efb\u52a1\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u80fd\u4f1a\u5728\u975e\u5e38\u4e0d\u7a33\u5b9a\u7684\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\uff0c\u8fd9\u662f\u4e0d\u7b26\u5408\u6e38\u620f\u7269\u7406\u7684\u8981\u6c42\u7684\u3002 \u6700\u540e\uff0c\u7ebf\u7a0b\u4f11\u7720\u7684\u65f6\u95f4\u7cbe\u5ea6\u4ec5\u4ec5\u53ea\u67090.1\u79d2\uff0c\u6240\u4ee5\u5373\u4f7f\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u6ca1\u6709\u6d88\u8017\u65f6\u95f4\uff0c\u4e5f\u4e0d\u4f1a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u3002\u6240\u4ee5\uff0c\u5982\u4f60\u6240\u89c1\uff0c\u95ee\u9898\u6ca1\u90a3\u4e48\u7b80\u5355\u3002 \u5728\u7f51\u4e0a\u4f60\u53ef\u4ee5\u627e\u5230\u5927\u91cf\u7684\u6e38\u620f\u5faa\u73af\u7684\u53d8\u79cd\u3002\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u7528\u4e00\u4e2a\u4e0d\u592a\u590d\u6742\u7684\uff0c\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u80fd\u6b63\u5e38\u5de5\u4f5c\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u7528\u7684\u65b9\u6cd5\u901a\u5e38\u88ab\u79f0\u4e3a \u5b9a\u957f\u6e38\u620f\u5faa\u73af \uff08Fixed Step Game Loop\uff09\u3002 \u9996\u5148\uff0c\u6211\u4eec\u53ef\u80fd\u60f3\u8981\u5355\u72ec\u63a7\u5236\u6e38\u620f\u72b6\u6001\u88ab\u66f4\u65b0\u7684\u5468\u671f\u548c\u6e38\u620f\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u7684\u5468\u671f\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u56e0\u4e3a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u66f4\u4e3a\u91cd\u8981\uff0c\u7279\u522b\u662f\u5982\u679c\u4f7f\u7528\u7269\u7406\u5f15\u64ce\u3002\u76f8\u53cd\uff0c\u5982\u679c\u6e32\u67d3\u6ca1\u6709\u53ca\u65f6\u5b8c\u6210\uff0c\u5728\u8fd0\u884c\u6e38\u620f\u5faa\u73af\u65f6\u6e32\u67d3\u65e7\u5e27\u4e5f\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6211\u4eec\u53ef\u4ee5\u7075\u6d3b\u5730\u8df3\u8fc7\u67d0\u4e9b\u5e27\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u73b0\u5728\u7684\u6e38\u620f\u5faa\u73af\u662f\u4ec0\u4e48\u6837\u7684\uff1a double secsPerUpdate = 1.0d / 30.0d; double previous = getTime(); double steps = 0.0; while (true) { double loopStartTime = getTime(); double elapsed = loopStartTime - previous; previous = loopStartTime; steps += elapsed; handleInput(); while (steps >= secsPerUpdate) { updateGameState(); steps -= secsPerUpdate; } render(); sync(loopStartTime); } \u4f7f\u7528\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u56fa\u5b9a\u7684\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u3002\u4f46\u662f\u5982\u4f55\u907f\u514d\u8017\u5c3d\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u4f7f\u5b83\u4e0d\u8fde\u7eed\u6e32\u67d3\u5462\uff1f\u8fd9\u5728 sync \u65b9\u6cd5\u4e2d\u5b9e\u73b0\uff1a private void sync(double loopStartTime) { float loopSlot = 1f / 50; double endTime = loopStartTime + loopSlot; while(getTime() < endTime) { try { Thread.sleep(1); } catch (InterruptedException ie) {} } } \u90a3\u4e48\u4e0a\u8ff0\u65b9\u6cd5\u505a\u4e86\u4ec0\u4e48\u5462\uff1f\u7b80\u800c\u8a00\u4e4b\uff0c\u6211\u4eec\u8ba1\u7b97\u6e38\u620f\u5faa\u73af\u8fed\u4ee3\u5e94\u8be5\u6301\u7eed\u591a\u957f\u65f6\u95f4\uff08\u5b83\u88ab\u50a8\u5b58\u5728 loopSlot \u53d8\u91cf\u4e2d\uff09\uff0c\u4f11\u7720\u7684\u65f6\u95f4\u53d6\u51b3\u4e8e\u5728\u5faa\u73af\u4e2d\u82b1\u8d39\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u4e0d\u505a\u4e00\u6574\u6bb5\u65f6\u95f4\u7684\u4f11\u7720\uff0c\u800c\u662f\u8fdb\u884c\u4e00\u4e9b\u5c0f\u7684\u4f11\u7720\u3002\u8fd9\u5141\u8bb8\u5176\u4ed6\u4efb\u52a1\u8fd0\u884c\uff0c\u5e76\u907f\u514d\u6b64\u524d\u63d0\u5230\u7684\u4f11\u7720\u51c6\u786e\u6027\u95ee\u9898\u3002\u63a5\u4e0b\u6765\u6211\u4eec\u8981\u505a\u7684\u662f\uff1a 1. \u8ba1\u7b97\u5e94\u8be5\u9000\u51fa\u8fd9\u4e2a\u65b9\u6cd5\u7684\u65f6\u95f4\uff08\u8fd9\u4e2a\u53d8\u91cf\u540d\u4e3a endTime \uff09\uff0c\u5e76\u5f00\u59cb\u6e38\u620f\u5faa\u73af\u7684\u53e6\u4e00\u6b21\u8fed\u4ee3\u3002 2. \u6bd4\u8f83\u5f53\u524d\u65f6\u95f4\u548c\u7ed3\u675f\u65f6\u95f4\uff0c\u5982\u679c\u6ca1\u6709\u5230\u8fbe\u7ed3\u675f\u65f6\u95f4\uff0c\u5c31\u4f11\u77201\u6beb\u79d2\u3002 \u73b0\u5728\u662f\u6784\u5efa\u4ee3\u7801\u5e93\u4ee5\u4fbf\u5f00\u59cb\u7f16\u5199\u6e38\u620f\u5f15\u64ce\u7684\u7b2c\u4e00\u4e2a\u7248\u672c\u7684\u65f6\u5019\u4e86\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u6765\u8ba8\u8bba\u4e00\u4e0b\u63a7\u5236\u6e32\u67d3\u901f\u7387\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u505a\u5fae\u4f11\u7720\u662f\u4e3a\u4e86\u63a7\u5236\u9700\u8981\u7b49\u5f85\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u53e6\u4e00\u79cd\u65b9\u6cd5\u6765\u9650\u5236\u5e27\u7387\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 \u5782\u76f4\u540c\u6b65 \uff08Vertical Synchronization\uff09\uff0c\u5782\u76f4\u540c\u6b65\u7684\u4e3b\u8981\u76ee\u7684\u662f\u907f\u514d\u753b\u9762\u6495\u88c2\u3002\u4ec0\u4e48\u662f\u753b\u9762\u6495\u88c2\uff1f\u8fd9\u662f\u4e00\u79cd\u663e\u793a\u73b0\u8c61\uff0c\u5f53\u6b63\u5728\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u66f4\u65b0\u56fe\u50cf\u50a8\u5b58\u533a\uff0c\u5bfc\u81f4\u5c4f\u5e55\u7684\u4e00\u90e8\u5206\u663e\u793a\u5148\u524d\u7684\u56fe\u50cf\uff0c\u800c\u5c4f\u5e55\u7684\u53e6\u4e00\u90e8\u5206\u663e\u793a\u6b63\u5728\u6e32\u67d3\u7684\u56fe\u50cf\u3002\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u5f53GPU\u4e2d\u7684\u6570\u636e\u6b63\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4e0d\u4f1a\u5411GPU\u53d1\u9001\u6570\u636e\u3002 \u5f53\u5f00\u542f\u5782\u76f4\u540c\u6b65\u65f6\uff0c\u6211\u4eec\u5c06\u4e0e\u663e\u5361\u7684\u5237\u65b0\u7387\u540c\u6b65\uff0c\u663e\u5361\u5c06\u4ee5\u6052\u5b9a\u7684\u5e27\u7387\u6e32\u67d3\u3002\u7528\u4e0b\u8ff0\u4e00\u884c\u4ee3\u7801\u542f\u7528\u5b83\uff1a glfwSwapInterval(1); \u6709\u4e86\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u610f\u5473\u7740\u81f3\u5c11\u5728\u4e00\u4e2a\u5c4f\u5e55\u66f4\u65b0\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u7b49\u5f85\u3002\u4e8b\u5b9e\u4e0a\u6211\u4eec\u4e0d\u662f\u76f4\u63a5\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u6570\u636e\u50a8\u5b58\u5728\u7f13\u51b2\u533a\u4e2d\uff0c\u7136\u540e\u7528\u4e0b\u9762\u7684\u65b9\u6cd5\u4ea4\u6362\u5b83\uff1a glfwSwapBuffers(windowHandle); \u56e0\u6b64\uff0c\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u7a33\u5b9a\u7684\u5e27\u7387\uff0c\u800c\u4e0d\u9700\u8981\u8fdb\u884c\u5fae\u4f11\u7720\u6765\u68c0\u67e5\u66f4\u65b0\u65f6\u95f4\u3002\u6b64\u5916\uff0c\u5e27\u7387\u5c06\u4e0e\u8bbe\u5907\u7684\u663e\u5361\u5237\u65b0\u7387\u76f8\u5339\u914d\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5982\u679c\u5b83\u8bbe\u5b9a\u4e3a60Hz\uff0860FPS\uff09\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u670960FPS\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5728 glfwSwapInterval \u65b9\u6cd5\u4e2d\u8bbe\u7f6e\u9ad8\u4e8e1\u7684\u6570\u5b57\u6765\u964d\u4f4e\u8fd9\u4e2a\u901f\u7387\uff08\u5982\u679c\u8bbe\u7f6e\u4e3a2\uff0c\u5c06\u5f97\u523030FPS\uff09\u3002 \u8ba9\u6211\u4eec\u6574\u7406\u4e00\u4e0b\u6e90\u4ee3\u7801\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u628a\u6240\u6709\u7684GLFW\u7a97\u53e3\u521d\u59cb\u5316\u4ee3\u7801\u5c01\u88c5\u5728\u4e00\u4e2a\u540d\u4e3a Window \u7684\u7c7b\u4e2d\uff0c\u4f20\u9012\u4e00\u4e9b\u57fa\u672c\u7684\u53c2\u6570\uff08\u5982\u6807\u9898\u548c\u5927\u5c0f\uff09\u3002 Window \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u4ee5\u4fbf\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u68c0\u6d4b\u6309\u4e0b\u7684\u6309\u952e\uff1a public boolean isKeyPressed(int keyCode) { return glfwGetKey(windowHandle, keyCode) == GLFW_PRESS; } \u9664\u4e86\u6709\u521d\u59cb\u5316\u4ee3\u7801\u4ee5\u5916\uff0c Window \u7c7b\u8fd8\u9700\u8981\u77e5\u9053\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u3002\u56e0\u6b64\u9700\u8981\u8bbe\u7f6e\u4e00\u4e2a\u56de\u8c03\u65b9\u6cd5\uff0c\u5728\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\u8c03\u7528\u5b83\u3002\u56de\u8c03\u65b9\u6cd5\u5c06\u63a5\u6536\u5e27\u7f13\u51b2\u533a\uff08\u6e32\u67d3\u533a\u57df\uff0c\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u663e\u793a\u533a\u57df\uff09\u7684\u4ee5\u50cf\u7d20\u4e3a\u5355\u4f4d\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u3002\u5982\u679c\u5e0c\u671b\u5f97\u5230\u5e27\u7f13\u51b2\u533a\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 glfwSetWindowSizeCallback \u65b9\u6cd5\u3002\u5c4f\u5e55\u5750\u6807\u4e0d\u4e00\u5b9a\u5bf9\u5e94\u50cf\u7d20\uff08\u4f8b\u5982\uff0c\u5177\u6709\u89c6\u7f51\u819c\u663e\u793a\u5c4f\uff08Retina Display\uff09\u7684Mac\u8bbe\u5907\uff09\u3002\u56e0\u4e3a\u6211\u4eec\u5c06\u5728\u8fdb\u884cOpenGL\u8c03\u7528\u65f6\u4f7f\u7528\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6240\u4ee5\u8981\u6ce8\u610f\u50cf\u7d20\u4e0d\u5728\u5c4f\u5e55\u5750\u6807\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7GLFW\u7684\u6587\u6863\u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002 // \u8bbe\u7f6e\u8c03\u6574\u5927\u5c0f\u56de\u8c03 glfwSetFramebufferSizeCallback(windowHandle, (window, width, height) -> { Window.this.width = width; Window.this.height = height; Window.this.setResized(true); }); \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a Renderer \u7c7b\uff0c\u5b83\u5c06\u5904\u7406\u6211\u4eec\u6e38\u620f\u7684\u6e32\u67d3\u3002\u73b0\u5728\uff0c\u5b83\u4ec5\u4f1a\u6709\u4e00\u4e2a\u7a7a\u7684 init \u65b9\u6cd5\uff0c\u548c\u53e6\u4e00\u4e2a\u7528\u9884\u8bbe\u989c\u8272\u6e05\u7a7a\u5c4f\u5e55\u7684\u65b9\u6cd5\uff1a public void init() throws Exception { } public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IGameLogic \u7684\u63a5\u53e3\uff0c\u5b83\u5c01\u88c5\u4e86\u6211\u4eec\u7684\u6e38\u620f\u903b\u8f91\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba9\u6e38\u620f\u5f15\u64ce\u5728\u4e0d\u540c\u7684\u6e38\u620f\u4e0a\u91cd\u590d\u4f7f\u7528\u3002\u8be5\u63a5\u53e3\u5c06\u5177\u6709\u83b7\u53d6\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u6e38\u620f\u5185\u5bb9\u7684\u65b9\u6cd5\u3002 public interface IGameLogic { void init() throws Exception; void input(Window window); void update(float interval); void render(Window window); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameEngine \u7684\u7c7b\uff0c\u5b83\u5c06\u5305\u542b\u6211\u4eec\u6e38\u620f\u5faa\u73af\u7684\u4ee3\u7801\uff0c\u8be5\u7c7b\u5c06\u5b9e\u73b0\u50a8\u5b58\u6e38\u620f\u5faa\u73af\uff1a public class GameEngine implements Runnable { //... public GameEngine(String windowTitle, int width, int height, boolean vSync, IGameLogic gameLogic) throws Exception { window = new Window(windowTitle, width, height, vSync); this.gameLogic = gameLogic; //... } vSync \u53c2\u6570\u5141\u8bb8\u6211\u4eec\u9009\u62e9\u662f\u5426\u542f\u7528\u5782\u76f4\u540c\u6b65\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5b9e\u73b0\u4e86 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u62ec\u6e38\u620f\u5faa\u73af\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } } GameEngine \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a run \u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u6267\u884c\u521d\u59cb\u5316\u4efb\u52a1\uff0c\u5e76\u8fd0\u884c\u6e38\u620f\u5faa\u73af\uff0c\u76f4\u5230\u6211\u4eec\u5173\u95ed\u7a97\u53e3\u3002\u5173\u4e8e\u7ebf\u7a0b\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0cGLFW\u9700\u8981\u4ece\u4e3b\u7ebf\u7a0b\u521d\u59cb\u5316\uff0c\u4e8b\u4ef6\u7684\u8f6e\u8be2\u4e5f\u5e94\u8be5\u5728\u8be5\u7ebf\u7a0b\u4e2d\u5b8c\u6210\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728\u4e3b\u7ebf\u7a0b\u4e2d\u6267\u884c\u6240\u6709\u5185\u5bb9\uff0c\u800c\u4e0d\u662f\u4e3a\u6e38\u620f\u5faa\u73af\u521b\u5efa\u5355\u72ec\u7684\u7ebf\u7a0b\u3002 \u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u5c06\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u5176\u4ed6\u8f85\u52a9\u7c7b\uff0c\u4f8b\u5982 Timer \uff08\u5b83\u5c06\u63d0\u4f9b\u7528\u4e8e\u8ba1\u7b97\u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\u7684\u5b9e\u7528\u65b9\u6cd5\uff09\uff0c\u5e76\u5728\u6e38\u620f\u5faa\u73af\u903b\u8f91\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002 GameEngine \u7c7b\u53ea\u662f\u5c06 input \u548c update \u65b9\u6cd5\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u3002\u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5b83\u4e5f\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u5e76\u66f4\u65b0\u7a97\u53e3\u3002 protected void input() { gameLogic.input(window); } protected void update(float interval) { gameLogic.update(interval); } protected void render() { gameLogic.render(window); window.update(); } \u5728\u7a0b\u5e8f\u7684\u5165\u53e3\uff0c\u542b\u6709 main \u65b9\u6cd5\u7684\u7c7b\u53ea\u4f1a\u521b\u5efa\u4e00\u4e2a GameEngine \u5b9e\u4f8b\u5e76\u8fd0\u884c\u5b83\u3002 public class Main { public static void main(String[] args) { try { boolean vSync = true; IGameLogic gameLogic = new DummyGame(); GameEngine gameEng = new GameEngine(\"GAME\", 600, 480, vSync, gameLogic); gameEng.run(); } catch (Exception excp) { excp.printStackTrace(); System.exit(-1); } } } \u6700\u540e\uff0c\u5728\u672c\u7ae0\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684\u6e38\u620f\u903b\u8f91\u7c7b\u3002\u5b83\u53ea\u4f1a\u5728\u6309\u4e0b\u4e0a\u6216\u4e0b\u952e\u65f6\uff0c\u53d8\u4eae\u6216\u53d8\u6697\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u7684\u6e05\u7a7a\u989c\u8272\uff0c render \u65b9\u6cd5\u5c06\u4f1a\u7528\u8fd9\u4e2a\u989c\u8272\u6e05\u7a7a\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u3002 public class DummyGame implements IGameLogic { private int direction = 0; private float color = 0.0f; private final Renderer renderer; public DummyGame() { renderer = new Renderer(); } @Override public void init() throws Exception { renderer.init(); } @Override public void input(Window window) { if (window.isKeyPressed(GLFW_KEY_UP)) { direction = 1; } else if (window.isKeyPressed(GLFW_KEY_DOWN)) { direction = -1; } else { direction = 0; } } @Override public void update(float interval) { color += direction * 0.01f; if (color > 1) { color = 1.0f; } else if ( color < 0 ) { color = 0.0f; } } @Override public void render(Window window) { if (window.isResized()) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } window.setClearColor(color, color, color, 0.0f); renderer.clear(); } } \u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5f53\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\uff0c\u6211\u4eec\u63a5\u6536\u901a\u77e5\uff0c\u4ee5\u4fbf\u66f4\u65b0\u89c6\u53e3\u5c06\u5750\u6807\u4e2d\u5fc3\u5b9a\u4f4d\u5230\u7a97\u53e3\u7684\u4e2d\u5fc3\u3002 \u521b\u5efa\u7684\u7c7b\u5c42\u6b21\u7ed3\u6784\u5c06\u5e2e\u52a9\u6211\u4eec\u5c06\u6e38\u620f\u5f15\u64ce\u4ee3\u7801\u4e0e\u5177\u4f53\u7684\u6e38\u620f\u4ee3\u7801\u5206\u5f00\u3002\u867d\u7136\u73b0\u5728\u53ef\u80fd\u770b\u8d77\u6765\u6ca1\u6709\u5fc5\u8981\uff0c\u4f46\u6211\u4eec\u5df2\u5c06\u6bcf\u4e2a\u6e38\u620f\u7684\u901a\u7528\u4ee3\u7801\uff0c\u4ece\u5177\u4f53\u7684\u6e38\u620f\u7684\u903b\u8f91\u3001\u7f8e\u672f\u4f5c\u54c1\u548c\u8d44\u6e90\u4e2d\u5206\u79bb\u51fa\u6765\uff0c\u4ee5\u4fbf\u91cd\u7528\u6e38\u620f\u5f15\u64ce\u3002\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u8fd9\u4e2a\u7c7b\u5c42\u6b21\u7ed3\u6784\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u6e38\u620f\u5f15\u64ce\u53d8\u5f97\u66f4\u52a0\u590d\u6742\u3002","title":"\u6e38\u620f\u5faa\u73af\uff08The Game Loop\uff09"},{"location":"02-the-game-loop/#osx","text":"\u4f60\u53ef\u4ee5\u8fd0\u884c\u4e0a\u9762\u7684\u4ee3\u7801\u5728Windows\u6216Linux\u4e0a\uff0c\u4f46\u6211\u4eec\u4ecd\u9700\u8981\u4e3aOS X\u5e73\u53f0\u505a\u4e00\u4e9b\u4fee\u6539\u3002\u6b63\u5982GLFW\u6587\u6863\u4e2d\u6240\u63cf\u8ff0\u7684\uff1a \u76ee\u524dOS X\u4ec5\u652f\u6301\u7684OpenGL 3.x\u548c4.x\u7248\u672c\u7684\u73af\u5883\u662f\u5411\u4e0a\u517c\u5bb9\u7684\u3002OS X 10.7 Lion\u652f\u6301OpenGL 3.2\u7248\u672c\u548cOS X 10.9 Mavericks\u652f\u6301OpenGL 3.3\u548c4.1\u7248\u672c\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u7684GPU\u9700\u8981\u652f\u6301\u6307\u5b9a\u7248\u672c\u7684OpenGL\uff0c\u4ee5\u6210\u529f\u521b\u5efa\u73af\u5883\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u652f\u6301\u5728\u6b64\u540e\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u7279\u6027\uff0c\u6211\u4eec\u9700\u8981\u5c06\u4e0b\u8ff0\u4ee3\u7801\u6dfb\u52a0\u5230 Window \u7c7b\u521b\u5efa\u7a97\u53e3\u4ee3\u7801\u4e4b\u524d\uff1a glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 2); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE); \u8fd9\u5c06\u4f7f\u7a0b\u5e8f\u4f7f\u7528OpenGL 3.2\u52304.1\u4e4b\u95f4\u7684\u6700\u9ad8\u7248\u672c\u3002\u5982\u679c\u6ca1\u6709\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u4f1a\u4f7f\u7528\u65e7\u7248\u672c\u7684OpenGL\u3002","title":"\u5e73\u53f0\u5dee\u5f02\uff08OSX\uff09"},{"location":"03-a-brief-about-coordinates/","text":"\u5750\u6807\u7b80\u4ecb\uff08A brief about coordinates\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u8ba8\u8bba\u5750\u6807\u548c\u5750\u6807\u7cfb\uff08Coordinate System\uff09\uff0c\u5c1d\u8bd5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u4ecb\u7ecd\u4e00\u4e9b\u57fa\u672c\u7684\u6570\u5b66\u6982\u5ff5\uff0c\u4e3a\u540e\u9762\u7ae0\u8282\u5c06\u8981\u4ecb\u7ecd\u7684\u6280\u672f\u548c\u5185\u5bb9\u63d0\u4f9b\u5e2e\u52a9\u3002\u6211\u4eec\u5c06\u4f1a\u5c06\u4e00\u4e9b\u5185\u5bb9\u7b80\u5316\uff0c\u4ee5\u6613\u4e8e\u5b66\u4e60\uff0c\u4f46\u727a\u7272\u4e86\u51c6\u786e\u6027\u3002 \u6211\u4eec\u901a\u8fc7\u6307\u5b9a\u5750\u6807\u6765\u786e\u5b9a\u7269\u4f53\u5728\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\u3002\u8054\u60f3\u5730\u56fe\uff0c\u901a\u8fc7\u5728\u5730\u56fe\u4e0a\u6307\u5b9a\u7eac\u5ea6\u548c\u7ecf\u5ea6\u6765\u786e\u5b9a\u4e00\u4e2a\u70b9\u3002\u53ea\u9700\u4e00\u5bf9\u6570\u5b57\uff0c\u5c31\u53ef\u4ee5\u7cbe\u786e\u5730\u786e\u8ba4\u4e00\u4e2a\u70b9\uff0c\u8fd9\u5bf9\u6570\u5b57\u5c31\u662f\u70b9\u5750\u6807\uff08\u5b9e\u9645\u4e0a\u6709\u4e9b\u590d\u6742\uff0c\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u624d\u80fd\u5728\u5730\u56fe\u4e0a\u786e\u5b9a\u4e00\u4e2a\u70b9\uff0c\u56e0\u4e3a\u5730\u56fe\u662f\u4e00\u4e2a\u4e0d\u5b8c\u7f8e\u7684\u692d\u5706\u7403\u4f53\uff08\u5730\u7403\uff09\u7684\u6295\u5f71\uff0c\u4f46\u8fd9\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u7c7b\u6bd4\uff09\u3002 \u5750\u6807\u7cfb\u662f\u4e00\u4e2a\u7cfb\u7edf\uff0c\u5b83\u4f7f\u7528\u4e00\u4e2a\u6216\u591a\u4e2a\u6570\u5b57\uff0c\u5373\u4e00\u4e2a\u6216\u591a\u4e2a\u5206\u91cf\u6765\u552f\u4e00\u5730\u786e\u5b9a\u4e00\u4e2a\u70b9\u7684\u4f4d\u7f6e\u3002\u5b58\u5728\u7740\u591a\u79cd\u4e0d\u540c\u7684\u5750\u6807\u7cfb\uff08\u5982\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6781\u5750\u6807\u7cfb\u7b49\uff09\uff0c\u5e76\u4e14\u53ef\u4ee5\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u5750\u6807\u7531\u4e24\u4e2a\u6570\u5b57\u5b9a\u4e49\uff0c\u5b83\u4eec\u8868\u793a\u5230\u4e24\u4e2a\u76f8\u4e92\u5782\u76f4\u7684X\u8f74\u548cY\u8f74\u95f4\u8ddd\u79bb\u3002 \u7ee7\u7eed\u7c7b\u6bd4\u5730\u56fe\uff0c\u5750\u6807\u7cfb\u5b9a\u4e49\u4e00\u4e2a\u539f\u70b9\u3002\u5bf9\u4e8e\u5730\u7406\u5750\u6807\u6765\u8bf4\uff0c\u539f\u70b9\u88ab\u8bbe\u7f6e\u4e3a\u8d64\u9053\u548c\u96f6\u5ea6\u7ecf\u7ebf\u4ea4\u53c9\u7684\u70b9\u3002\u6839\u636e\u539f\u70b9\u8bbe\u7f6e\u7684\u4f4d\u7f6e\uff0c\u7279\u5b9a\u70b9\u7684\u5750\u6807\u662f\u4e0d\u540c\u7684\u3002\u5750\u6807\u7cfb\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u8f74\u7684\u65b9\u5411\u3002\u5728\u4e0a\u56fe\u4e2d\uff0cX\u5750\u6807\u968f\u7740\u70b9\u5411\u53f3\u79fb\u52a8\u800c\u589e\u52a0\uff0cY\u5750\u6807\u968f\u7740\u70b9\u5411\u4e0a\u79fb\u52a8\u800c\u589e\u52a0\u3002\u4f46\u6211\u4eec\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e0e\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e0d\u540c\u7684\uff0c\u5177\u6709\u4e0d\u540c\u7684\u8f74\u53d6\u5411\u7684\u5750\u6807\u7cfb\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e0d\u540c\u7684\u5750\u6807\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e9b\u53c2\u6570\uff0c\u4f8b\u5982\u539f\u70b9\u548c\u8f74\u65b9\u5411\uff0c\u4ee5\u4fbf\u4f7f\u6784\u6210\u5750\u6807\u7684\u6570\u5b57\u5bf9\u6709\u6070\u5f53\u7684\u542b\u4e49\u3002\u4e3a\u4e86\u4f7f\u7528\u4e00\u7ec4\u5750\u6807\uff0c\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u5bf9\u5e94\u7684\u5750\u6807\u7cfb\uff0c\u597d\u6d88\u606f\u662f\u53ef\u4ee5\u901a\u8fc7\u5e73\u79fb\u548c\u65cb\u8f6c\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u5982\u679c\u8981\u5904\u7406\u4e09\u7ef4\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u589e\u52a0\u4e00\u4e2a\u8f74\uff0c\u5373Z\u8f74\u3002\u4e09\u7ef4\u5750\u6807\u5c06\u7531\u4e09\u4e2a\u6570\u5b57(x, y, z)\u6784\u6210\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u53ea\u8981\u8f74\u76f8\u4e92\u5782\u76f4\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6539\u53d8\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u7684\u8f74\u7684\u65b9\u5411\u3002\u4e0b\u56fe\u663e\u793a\u53e6\u4e00\u4e2a\u4e09\u7ef4\u5750\u6807\u7cfb\u3002 \u4e09\u7ef4\u5750\u6807\u53ef\u5206\u4e3a\u5de6\u624b\u7cfb\u548c\u53f3\u624b\u7cfb\u4e24\u79cd\u7c7b\u578b\u3002\u4f60\u600e\u4e48\u77e5\u9053\u5b83\u662f\u4ec0\u4e48\u7c7b\u578b\u7684\uff1f\u7528\u4f60\u7684\u624b\u5728\u4f60\u7684\u62c7\u6307\u548c\u98df\u6307\u4e4b\u95f4\u5f62\u6210\u4e00\u4e2a\u201cL\u201d\uff0c\u4e2d\u6307\u5e94\u6307\u5411\u5782\u76f4\u4e8e\u5176\u4ed6\u4e24\u4e2a\u624b\u6307\u7684\u65b9\u5411\u3002\u62c7\u6307\u5e94\u8be5\u6307\u5411X\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u98df\u6307\u5e94\u8be5\u6307\u5411Y\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u800c\u4e2d\u6307\u5e94\u8be5\u6307\u5411Z\u8f74\u7684\u6b63\u65b9\u5411\u3002\u5982\u679c\u4f60\u80fd\u7528\u5de6\u624b\u505a\u5230\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5de6\u624b\u7cfb\uff0c\u5982\u679c\u4f60\u9700\u8981\u7528\u53f3\u624b\uff0c\u90a3\u5b83\u5c31\u662f\u53f3\u624b\u7cfb\u3002 \u4e8c\u7ef4\u5750\u6807\u7cfb\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u901a\u8fc7\u65cb\u8f6c\uff0c\u6211\u4eec\u53ef\u4ee5\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u4f46\u662f\uff0c\u4e09\u7ef4\u5750\u6807\u7cfb\u5e76\u4e0d\u90fd\u662f\u76f8\u540c\u7684\u3002\u5982\u679c\u5b83\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u624b\u6765\u8868\u793a\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u4e24\u8005\u90fd\u662f\u5de6\u624b\u7cfb\u6216\u8005\u53f3\u624b\u7cfb\uff0c\u90a3\u4e48\u5c31\u80fd\u901a\u8fc7\u65cb\u8f6c\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u73b0\u5728\u5df2\u7ecf\u660e\u786e\u4e86\u4e00\u4e9b\u57fa\u672c\u7684\u6982\u5ff5\uff0c\u8ba9\u6211\u4eec\u6765\u8bb2\u89e3\u4e00\u4e9b\u5728\u5904\u7406\u4e09\u7ef4\u56fe\u5f62\u65f6\u5e38\u7528\u7684\u672f\u8bed\u3002\u5f53\u6211\u4eec\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u91ca\u5982\u4f55\u6e32\u67d3\u4e09\u7ef4\u6a21\u578b\u65f6\uff0c\u5c06\u770b\u5230\u6211\u4eec\u5c06\u4f7f\u7528\u4e0d\u540c\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\uff0c\u8fd9\u662f\u56e0\u4e3a\u6bcf\u4e2a\u5750\u6807\u7cfb\u90fd\u6709\u4e0d\u540c\u7684\u8bbe\u5b9a\uff0c\u6709\u4e0d\u540c\u7684\u76ee\u7684\u3002\u4e00\u7ec4\u5750\u6807\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u9664\u975e\u660e\u786e\u5b83\u662f\u67d0\u4e2a\u5750\u6807\u7cfb\u7684\u5750\u6807\u3002\u5f53\u4f60\u770b\u5230\u5750\u6807(40.438031, -3.676626)\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u6709\u4e00\u4e2a\u5927\u80c6\u7684\u60f3\u6cd5\u3002\u4f46\u662f\u5982\u679c\u6211\u8bf4\u5b83\u662f\u51e0\u4f55\u5750\u6807\uff08\u7ecf\u5ea6\u548c\u7eac\u5ea6\uff09\u65f6\uff0c\u4f60\u5c31\u4f1a\u53d1\u73b0\u5b83\u662f\u9a6c\u5fb7\u91cc\u67d0\u4e2a\u5730\u65b9\u7684\u5750\u6807\u3002 \u5f53\u6211\u4eec\u52a0\u8f7d\u4e09\u7ef4\u7269\u4f53\u65f6\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e00\u7ec4\u4e09\u7ef4\u5750\u6807\u3002\u8fd9\u4e9b\u5750\u6807\u5728\u88ab\u79f0\u4e3a\u7269\u4f53\u5750\u6807\u7cfb\uff08Object Coordinate Space\uff09\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u8868\u8fbe\u3002\u5f53\u5efa\u6a21\u5e08\u5728\u8bbe\u8ba1\u8fd9\u4e9b\u4e09\u7ef4\u6a21\u578b\u7684\u65f6\u5019\uff0c\u4ed6\u4eec\u5bf9\u8be5\u6a21\u578b\u5c06\u663e\u793a\u7684\u4e09\u7ef4\u573a\u666f\u6beb\u4e0d\u77e5\u60c5\uff0c\u56e0\u6b64\u53ea\u80fd\u4f7f\u7528\u4e0e\u6a21\u578b\u76f8\u5173\u7684\u5750\u6807\u7cfb\u6765\u5b9a\u4e49\u5750\u6807\u3002 \u5f53\u8981\u7ed8\u5236\u4e00\u4e2a\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u6240\u6709\u7684\u4e09\u7ef4\u7269\u4f53\u5c06\u4e0e\u88ab\u79f0\u4e3a\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u7cfb\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u7269\u4f53\u7684\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u4e16\u754c\u5750\u6807\u7cfb\u3002\u4e00\u4e9b\u7269\u4f53\u9700\u8981\u65cb\u8f6c\u3001\u62c9\u4f38\u3001\u653e\u5927\u548c\u8f6c\u6362\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u80fd\u591f\u6b63\u786e\u5730\u663e\u793a\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u9650\u5236\u6240\u663e\u793a\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u8303\u56f4\uff0c\u4f8b\u5982\u79fb\u52a8\u6444\u50cf\u673a\u7a7f\u68ad\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u8f6c\u6362\u5230\u6444\u50cf\u673a\u6216\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u6700\u540e\uff0c\u8fd9\u4e9b\u5750\u6807\u9700\u8981\u8f6c\u6362\u4e3a\u4e8c\u7ef4\u7684\u5c4f\u5e55\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u89c2\u5bdf\u5750\u6807\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u5750\u6807\u7cfb\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08Z\u8f74\u5782\u76f4\u4e8e\u5c4f\u5e55\uff09\uff0c\u5750\u6807\u5728-1\u548c+1\u4e4b\u95f4\u3002 \u5982\u679c\u4f60\u4e0d\u80fd\u6e05\u695a\u5730\u7406\u89e3\u8fd9\u4e9b\u6982\u5ff5\uff0c\u522b\u62c5\u5fc3\u3002\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff0c\u5b83\u4eec\u5c06\u7528\u5b9e\u4f8b\u8868\u73b0\u51fa\u6765\u3002","title":"\u5750\u6807\u7b80\u4ecb"},{"location":"03-a-brief-about-coordinates/#a-brief-about-coordinates","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u8ba8\u8bba\u5750\u6807\u548c\u5750\u6807\u7cfb\uff08Coordinate System\uff09\uff0c\u5c1d\u8bd5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u4ecb\u7ecd\u4e00\u4e9b\u57fa\u672c\u7684\u6570\u5b66\u6982\u5ff5\uff0c\u4e3a\u540e\u9762\u7ae0\u8282\u5c06\u8981\u4ecb\u7ecd\u7684\u6280\u672f\u548c\u5185\u5bb9\u63d0\u4f9b\u5e2e\u52a9\u3002\u6211\u4eec\u5c06\u4f1a\u5c06\u4e00\u4e9b\u5185\u5bb9\u7b80\u5316\uff0c\u4ee5\u6613\u4e8e\u5b66\u4e60\uff0c\u4f46\u727a\u7272\u4e86\u51c6\u786e\u6027\u3002 \u6211\u4eec\u901a\u8fc7\u6307\u5b9a\u5750\u6807\u6765\u786e\u5b9a\u7269\u4f53\u5728\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\u3002\u8054\u60f3\u5730\u56fe\uff0c\u901a\u8fc7\u5728\u5730\u56fe\u4e0a\u6307\u5b9a\u7eac\u5ea6\u548c\u7ecf\u5ea6\u6765\u786e\u5b9a\u4e00\u4e2a\u70b9\u3002\u53ea\u9700\u4e00\u5bf9\u6570\u5b57\uff0c\u5c31\u53ef\u4ee5\u7cbe\u786e\u5730\u786e\u8ba4\u4e00\u4e2a\u70b9\uff0c\u8fd9\u5bf9\u6570\u5b57\u5c31\u662f\u70b9\u5750\u6807\uff08\u5b9e\u9645\u4e0a\u6709\u4e9b\u590d\u6742\uff0c\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u624d\u80fd\u5728\u5730\u56fe\u4e0a\u786e\u5b9a\u4e00\u4e2a\u70b9\uff0c\u56e0\u4e3a\u5730\u56fe\u662f\u4e00\u4e2a\u4e0d\u5b8c\u7f8e\u7684\u692d\u5706\u7403\u4f53\uff08\u5730\u7403\uff09\u7684\u6295\u5f71\uff0c\u4f46\u8fd9\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u7c7b\u6bd4\uff09\u3002 \u5750\u6807\u7cfb\u662f\u4e00\u4e2a\u7cfb\u7edf\uff0c\u5b83\u4f7f\u7528\u4e00\u4e2a\u6216\u591a\u4e2a\u6570\u5b57\uff0c\u5373\u4e00\u4e2a\u6216\u591a\u4e2a\u5206\u91cf\u6765\u552f\u4e00\u5730\u786e\u5b9a\u4e00\u4e2a\u70b9\u7684\u4f4d\u7f6e\u3002\u5b58\u5728\u7740\u591a\u79cd\u4e0d\u540c\u7684\u5750\u6807\u7cfb\uff08\u5982\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6781\u5750\u6807\u7cfb\u7b49\uff09\uff0c\u5e76\u4e14\u53ef\u4ee5\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u5750\u6807\u7531\u4e24\u4e2a\u6570\u5b57\u5b9a\u4e49\uff0c\u5b83\u4eec\u8868\u793a\u5230\u4e24\u4e2a\u76f8\u4e92\u5782\u76f4\u7684X\u8f74\u548cY\u8f74\u95f4\u8ddd\u79bb\u3002 \u7ee7\u7eed\u7c7b\u6bd4\u5730\u56fe\uff0c\u5750\u6807\u7cfb\u5b9a\u4e49\u4e00\u4e2a\u539f\u70b9\u3002\u5bf9\u4e8e\u5730\u7406\u5750\u6807\u6765\u8bf4\uff0c\u539f\u70b9\u88ab\u8bbe\u7f6e\u4e3a\u8d64\u9053\u548c\u96f6\u5ea6\u7ecf\u7ebf\u4ea4\u53c9\u7684\u70b9\u3002\u6839\u636e\u539f\u70b9\u8bbe\u7f6e\u7684\u4f4d\u7f6e\uff0c\u7279\u5b9a\u70b9\u7684\u5750\u6807\u662f\u4e0d\u540c\u7684\u3002\u5750\u6807\u7cfb\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u8f74\u7684\u65b9\u5411\u3002\u5728\u4e0a\u56fe\u4e2d\uff0cX\u5750\u6807\u968f\u7740\u70b9\u5411\u53f3\u79fb\u52a8\u800c\u589e\u52a0\uff0cY\u5750\u6807\u968f\u7740\u70b9\u5411\u4e0a\u79fb\u52a8\u800c\u589e\u52a0\u3002\u4f46\u6211\u4eec\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e0e\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e0d\u540c\u7684\uff0c\u5177\u6709\u4e0d\u540c\u7684\u8f74\u53d6\u5411\u7684\u5750\u6807\u7cfb\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e0d\u540c\u7684\u5750\u6807\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e9b\u53c2\u6570\uff0c\u4f8b\u5982\u539f\u70b9\u548c\u8f74\u65b9\u5411\uff0c\u4ee5\u4fbf\u4f7f\u6784\u6210\u5750\u6807\u7684\u6570\u5b57\u5bf9\u6709\u6070\u5f53\u7684\u542b\u4e49\u3002\u4e3a\u4e86\u4f7f\u7528\u4e00\u7ec4\u5750\u6807\uff0c\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u5bf9\u5e94\u7684\u5750\u6807\u7cfb\uff0c\u597d\u6d88\u606f\u662f\u53ef\u4ee5\u901a\u8fc7\u5e73\u79fb\u548c\u65cb\u8f6c\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u5982\u679c\u8981\u5904\u7406\u4e09\u7ef4\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u589e\u52a0\u4e00\u4e2a\u8f74\uff0c\u5373Z\u8f74\u3002\u4e09\u7ef4\u5750\u6807\u5c06\u7531\u4e09\u4e2a\u6570\u5b57(x, y, z)\u6784\u6210\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u53ea\u8981\u8f74\u76f8\u4e92\u5782\u76f4\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6539\u53d8\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u7684\u8f74\u7684\u65b9\u5411\u3002\u4e0b\u56fe\u663e\u793a\u53e6\u4e00\u4e2a\u4e09\u7ef4\u5750\u6807\u7cfb\u3002 \u4e09\u7ef4\u5750\u6807\u53ef\u5206\u4e3a\u5de6\u624b\u7cfb\u548c\u53f3\u624b\u7cfb\u4e24\u79cd\u7c7b\u578b\u3002\u4f60\u600e\u4e48\u77e5\u9053\u5b83\u662f\u4ec0\u4e48\u7c7b\u578b\u7684\uff1f\u7528\u4f60\u7684\u624b\u5728\u4f60\u7684\u62c7\u6307\u548c\u98df\u6307\u4e4b\u95f4\u5f62\u6210\u4e00\u4e2a\u201cL\u201d\uff0c\u4e2d\u6307\u5e94\u6307\u5411\u5782\u76f4\u4e8e\u5176\u4ed6\u4e24\u4e2a\u624b\u6307\u7684\u65b9\u5411\u3002\u62c7\u6307\u5e94\u8be5\u6307\u5411X\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u98df\u6307\u5e94\u8be5\u6307\u5411Y\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u800c\u4e2d\u6307\u5e94\u8be5\u6307\u5411Z\u8f74\u7684\u6b63\u65b9\u5411\u3002\u5982\u679c\u4f60\u80fd\u7528\u5de6\u624b\u505a\u5230\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5de6\u624b\u7cfb\uff0c\u5982\u679c\u4f60\u9700\u8981\u7528\u53f3\u624b\uff0c\u90a3\u5b83\u5c31\u662f\u53f3\u624b\u7cfb\u3002 \u4e8c\u7ef4\u5750\u6807\u7cfb\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u901a\u8fc7\u65cb\u8f6c\uff0c\u6211\u4eec\u53ef\u4ee5\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u4f46\u662f\uff0c\u4e09\u7ef4\u5750\u6807\u7cfb\u5e76\u4e0d\u90fd\u662f\u76f8\u540c\u7684\u3002\u5982\u679c\u5b83\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u624b\u6765\u8868\u793a\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u4e24\u8005\u90fd\u662f\u5de6\u624b\u7cfb\u6216\u8005\u53f3\u624b\u7cfb\uff0c\u90a3\u4e48\u5c31\u80fd\u901a\u8fc7\u65cb\u8f6c\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u73b0\u5728\u5df2\u7ecf\u660e\u786e\u4e86\u4e00\u4e9b\u57fa\u672c\u7684\u6982\u5ff5\uff0c\u8ba9\u6211\u4eec\u6765\u8bb2\u89e3\u4e00\u4e9b\u5728\u5904\u7406\u4e09\u7ef4\u56fe\u5f62\u65f6\u5e38\u7528\u7684\u672f\u8bed\u3002\u5f53\u6211\u4eec\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u91ca\u5982\u4f55\u6e32\u67d3\u4e09\u7ef4\u6a21\u578b\u65f6\uff0c\u5c06\u770b\u5230\u6211\u4eec\u5c06\u4f7f\u7528\u4e0d\u540c\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\uff0c\u8fd9\u662f\u56e0\u4e3a\u6bcf\u4e2a\u5750\u6807\u7cfb\u90fd\u6709\u4e0d\u540c\u7684\u8bbe\u5b9a\uff0c\u6709\u4e0d\u540c\u7684\u76ee\u7684\u3002\u4e00\u7ec4\u5750\u6807\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u9664\u975e\u660e\u786e\u5b83\u662f\u67d0\u4e2a\u5750\u6807\u7cfb\u7684\u5750\u6807\u3002\u5f53\u4f60\u770b\u5230\u5750\u6807(40.438031, -3.676626)\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u6709\u4e00\u4e2a\u5927\u80c6\u7684\u60f3\u6cd5\u3002\u4f46\u662f\u5982\u679c\u6211\u8bf4\u5b83\u662f\u51e0\u4f55\u5750\u6807\uff08\u7ecf\u5ea6\u548c\u7eac\u5ea6\uff09\u65f6\uff0c\u4f60\u5c31\u4f1a\u53d1\u73b0\u5b83\u662f\u9a6c\u5fb7\u91cc\u67d0\u4e2a\u5730\u65b9\u7684\u5750\u6807\u3002 \u5f53\u6211\u4eec\u52a0\u8f7d\u4e09\u7ef4\u7269\u4f53\u65f6\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e00\u7ec4\u4e09\u7ef4\u5750\u6807\u3002\u8fd9\u4e9b\u5750\u6807\u5728\u88ab\u79f0\u4e3a\u7269\u4f53\u5750\u6807\u7cfb\uff08Object Coordinate Space\uff09\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u8868\u8fbe\u3002\u5f53\u5efa\u6a21\u5e08\u5728\u8bbe\u8ba1\u8fd9\u4e9b\u4e09\u7ef4\u6a21\u578b\u7684\u65f6\u5019\uff0c\u4ed6\u4eec\u5bf9\u8be5\u6a21\u578b\u5c06\u663e\u793a\u7684\u4e09\u7ef4\u573a\u666f\u6beb\u4e0d\u77e5\u60c5\uff0c\u56e0\u6b64\u53ea\u80fd\u4f7f\u7528\u4e0e\u6a21\u578b\u76f8\u5173\u7684\u5750\u6807\u7cfb\u6765\u5b9a\u4e49\u5750\u6807\u3002 \u5f53\u8981\u7ed8\u5236\u4e00\u4e2a\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u6240\u6709\u7684\u4e09\u7ef4\u7269\u4f53\u5c06\u4e0e\u88ab\u79f0\u4e3a\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u7cfb\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u7269\u4f53\u7684\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u4e16\u754c\u5750\u6807\u7cfb\u3002\u4e00\u4e9b\u7269\u4f53\u9700\u8981\u65cb\u8f6c\u3001\u62c9\u4f38\u3001\u653e\u5927\u548c\u8f6c\u6362\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u80fd\u591f\u6b63\u786e\u5730\u663e\u793a\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u9650\u5236\u6240\u663e\u793a\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u8303\u56f4\uff0c\u4f8b\u5982\u79fb\u52a8\u6444\u50cf\u673a\u7a7f\u68ad\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u8f6c\u6362\u5230\u6444\u50cf\u673a\u6216\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u6700\u540e\uff0c\u8fd9\u4e9b\u5750\u6807\u9700\u8981\u8f6c\u6362\u4e3a\u4e8c\u7ef4\u7684\u5c4f\u5e55\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u89c2\u5bdf\u5750\u6807\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u5750\u6807\u7cfb\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08Z\u8f74\u5782\u76f4\u4e8e\u5c4f\u5e55\uff09\uff0c\u5750\u6807\u5728-1\u548c+1\u4e4b\u95f4\u3002 \u5982\u679c\u4f60\u4e0d\u80fd\u6e05\u695a\u5730\u7406\u89e3\u8fd9\u4e9b\u6982\u5ff5\uff0c\u522b\u62c5\u5fc3\u3002\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff0c\u5b83\u4eec\u5c06\u7528\u5b9e\u4f8b\u8868\u73b0\u51fa\u6765\u3002","title":"\u5750\u6807\u7b80\u4ecb\uff08A brief about coordinates\uff09"},{"location":"04-rendering/","text":"\u6e32\u67d3\uff08Rendering\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u7528OpenGL\u6e32\u67d3\u573a\u666f\u65f6\u8981\u505a\u7684\u4e8b\u9879\u3002\u5982\u679c\u4f60\u5df2\u7ecf\u4e60\u60ef\u4e86OpenGL\u7684\u65e7\u7248\u672c\uff0c\u4e60\u60ef\u4e86\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\uff0c\u4f60\u53ef\u80fd\u4f1a\u8df3\u8fc7\u8fd9\u4e00\u7ae0\uff0c\u4e0d\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u5b83\u9700\u8981\u8fd9\u4e48\u590d\u6742\u3002\u5b83\u5176\u5b9e\u66f4\u7b80\u5355\u3001\u66f4\u7075\u6d3b\uff0c\u4f60\u53ea\u9700\u8981\u7ed9\u5b83\u4e00\u4e2a\u8868\u73b0\u7684\u673a\u4f1a\u3002\u73b0\u4ee3OpenGL\u4f7f\u4f60\u53ea\u9700\u8003\u8651\u4e00\u4e2a\u95ee\u9898\uff0c\u8fd9\u53ef\u4ee5\u4f7f\u4f60\u4ee5\u66f4\u5408\u7406\u7684\u65b9\u5f0f\u7ec4\u7ec7\u4ee3\u7801\u548c\u5f00\u53d1\u3002 \u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u88ab\u7edf\u79f0\u4e3a\u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\u3002OpenGL\u6700\u521d\u7684\u7248\u672c\u4f7f\u7528\u4e86\u4e00\u4e2a\u88ab\u79f0\u4e3a\u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\u7684\u6a21\u578b\u3002\u8be5\u6a21\u578b\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\uff08\u4f8b\u5982\uff0c\u201c\u8bbe\u7f6e\u96fe\u201d\u6216\u201c\u6dfb\u52a0\u5149\u7167\u201d\uff09\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u56fe\u5f62\u7ba1\u7ebf\u7531\u4ee5\u4e0b\u64cd\u4f5c\u6b65\u9aa4\u7ec4\u6210\uff1a OpenGL 2.0 \u5f15\u5165\u4e86\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\u7684\u6982\u5ff5\u3002\u5728\u8be5\u6a21\u578b\u4e2d\uff0c\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\uff08Shader\uff09\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002\u4e0b\u56fe\u7b80\u5355\u7684\u5c55\u793a\u4e86OpenGL\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff1a \u8be5\u6e32\u67d3\u65b9\u5f0f\u6700\u521d\u5c06\u4ee5\u9876\u70b9\u7f13\u51b2\u533a\u4e3a\u5f62\u5f0f\u7684\u4e00\u7cfb\u5217\u9876\u70b9\u4f5c\u4e3a\u8f93\u5165\u3002\u4f46\u662f\uff0c\u4ec0\u4e48\u662f\u9876\u70b9\uff1f\u9876\u70b9\uff08Vertex\uff09\u662f\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002\u5982\u4f55\u63cf\u8ff0\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4e00\u4e2a\u70b9\u5462\uff1f\u901a\u8fc7\u6307\u5b9a\u5176X\u3001Y\u548cZ\u5750\u6807\u3002\u4ec0\u4e48\u662f\u9876\u70b9\u7f13\u51b2\u533a\uff1f\u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\u662f\u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u53e6\u4e00\u79cd\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u8fd9\u4e9b\u9876\u70b9\u7531\u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\u5904\u7406\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u529f\u80fd\u662f\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002\u8be5\u7740\u8272\u5668\u8fd8\u53ef\u4ee5\u751f\u6210\u4e0e\u989c\u8272\u6216\u7eb9\u7406\u76f8\u5173\u7684\u5176\u4ed6\u8f93\u51fa\uff0c\u4f46\u5176\u4e3b\u8981\u76ee\u7684\u8fd8\u662f\u5c06\u9876\u70b9\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\uff0c\u5373\u751f\u6210\u70b9\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002\u5b83\u4f9d\u7167\u9876\u70b9\u50a8\u5b58\u7684\u987a\u5e8f\uff0c\u4f7f\u7528\u4e0d\u540c\u7684\u6a21\u578b\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002\u4e3a\u4ec0\u4e48\u662f\u4e09\u89d2\u5f62\uff1f\u4e09\u89d2\u5f62\u5c31\u662f\u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\uff0c\u5b83\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u53ef\u4ee5\u7ec4\u5408\u548c\u53d8\u6362\uff0c\u4ee5\u6784\u5efa\u590d\u6742\u7684\u4e09\u7ef4\u573a\u666f\u3002\u6b64\u9636\u6bb5\u8fd8\u53ef\u4ee5\u4f7f\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6765\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\u9636\u6bb5\u63a5\u6536\u6b64\u524d\u751f\u6210\u7684\u4e09\u89d2\u5f62\uff0c\u526a\u8f91\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u8fd9\u4e9b\u7247\u5143\u5c06\u5728\u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\u88ab\u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\u4f7f\u7528\uff0c\u4ee5\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002\u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\u662f\u56fe\u5f62\u7ba1\u7ebf\u7684\u6700\u7ec8\u8f93\u51fa\uff0c\u5b83\u50a8\u5b58\u4e86\u6bcf\u4e2a\u50cf\u7d20\u5e94\u8be5\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u7684\u503c\u3002 \u6ce8\u610f\uff0c\u663e\u5361\u88ab\u8bbe\u8ba1\u6210\u5e76\u884c\u5904\u7406\u4e0a\u8ff0\u6240\u6709\u64cd\u4f5c\uff0c\u8f93\u5165\u7684\u6570\u636e\u53ef\u4ee5\u5e76\u884c\u5904\u7406\u4ee5\u751f\u6210\u6700\u7ec8\u573a\u666f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u7b2c\u4e00\u4e2a\u7740\u8272\u5668\u7a0b\u5e8f\u3002\u7740\u8272\u5668\u662f\u4f7f\u7528\u57fa\u4e8eANSI C\u7684OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\u7f16\u5199\u7684\u3002\u9996\u5148\uff0c\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a\u201c vertex.vs \u201d\uff08\u6269\u5c55\u540d\u4e3a\u9876\u70b9\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; void main() { gl_Position = vec4(position, 1.0); } \u7b2c\u4e00\u884c\u662f\u4e00\u4e2a\u8868\u793a\u6211\u4eec\u6b63\u4f7f\u7528\u7684GLSL\u8bed\u8a00\u7248\u672c\u7684\u6807\u8bc6\u7b26\u3002\u4e0b\u8868\u662fGLSL\u7248\u672c\u3001\u4e0e\u8be5\u7248\u672c\u5339\u914d\u7684OpenGL\u7248\u672c\u548c\u4f7f\u7528\u65b9\u6cd5\uff08\u6765\u81ea\u7ef4\u57fa\u767e\u79d1\uff1a https://en.wikipedia.org/wiki/OpenGL_Shading_Language#Versions \uff09\uff1a GLSL\u7248\u672c OpenGL\u7248\u672c \u7740\u8272\u5668\u6807\u8bc6\u7b26 1.10.59 2.0 #version 110 1.20.8 2.1 #version 120 1.30.10 3.0 #version 130 1.40.08 3.1 #version 140 1.50.11 3.2 #version 150 3.30.6 3.3 #version 330 4.00.9 4.0 #version 400 4.10.6 4.1 #version 410 4.20.11 4.2 #version 420 4.30.8 4.3 #version 430 4.40 4.4 #version 440 4.50 4.5 #version 450 \u7b2c\u4e8c\u884c\u6307\u5b9a\u6b64\u7740\u8272\u5668\u7684\u8f93\u5165\u683c\u5f0f\u3002OpenGL\u7f13\u51b2\u533a\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u662f\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u8be5\u8bed\u8a00\u4e0d\u4f1a\u5f3a\u8feb\u4f60\u4f20\u9012\u9884\u5b9a\u4e49\u8bed\u8a00\u7684\u4efb\u4f55\u6307\u5b9a\u6570\u636e\u7ed3\u6784\u3002\u4ece\u7740\u8272\u5668\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u5b83\u671f\u671b\u63a5\u6536\u4e00\u4e2a\u5b58\u6709\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002\u5b83\u53ef\u4ee5\u662f\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4e00\u4e2a\u6709\u4e00\u4e9b\u9644\u52a0\u4fe1\u606f\u7684\u4f4d\u7f6e\uff0c\u6216\u8005\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\u3002\u9876\u70b9\u7740\u8272\u5668\u53ea\u63a5\u6536\u6d6e\u70b9\u6570\u7ec4\u3002\u5f53\u586b\u5145\u7f13\u51b2\u533a\u65f6\uff0c\u6211\u4eec\u5b9a\u4e49\u8981\u7531\u7740\u8272\u5668\u5904\u7406\u7684\u7f13\u51b2\u533a\u5757\u3002 \u9996\u5148\uff0c\u9700\u8981\u628a\u8fd9\u4e9b\u5757\u53d8\u6210\u5bf9\u6211\u4eec\u6709\u610f\u4e49\u7684\u6570\u636e\u3002\u73b0\u5728\u89c4\u5b9a\u4ece\u4f4d\u7f6e0\u5f00\u59cb\uff0c\u6211\u4eec\u671f\u671b\u63a5\u6536\u7531\u4e09\u4e2a\u5c5e\u6027(X, Y, Z)\u7ec4\u6210\u7684\u5411\u91cf\u3002 \u7740\u8272\u5668\u6709\u4e2a main \u4ee3\u7801\u5757\uff0c\u5c31\u50cf\u4efb\u4f55C\u8bed\u8a00\u7a0b\u5e8f\u4e00\u6837\uff0c\u4e0a\u8ff0\u793a\u4f8b\u662f\u975e\u5e38\u7b80\u5355\u7684\u3002\u5b83\u53ea\u662f\u5c06\u63a5\u6536\u5230\u7684\u5750\u6807\u4e0d\u7ecf\u4efb\u4f55\u53d8\u6362\u5730\u8fd4\u56de\u5230 gl_Position \u3002\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u4e09\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\u88ab\u8f6c\u6362\u6210\u56db\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\uff08 vec4 \uff09\u3002\u8fd9\u662f\u56e0\u4e3a gl_Position \u4ec5\u63a5\u6536 vec4 \u7c7b\u578b\u7684\u6570\u636e\uff0c\u56e0\u4e3a\u5b83\u662f\u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u5e0c\u671b\u63a5\u6536\u5230\u5f62\u4f3c(X, Y, Z, W)\u7684\u4e1c\u897f\uff0c\u5176\u4e2dW\u4ee3\u8868\u4e00\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u3002\u4e3a\u4ec0\u4e48\u8fd8\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u7ef4\u5ea6\uff1f\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u6211\u4eec\u9700\u8981\u505a\u7684\u5927\u90e8\u5206\u64cd\u4f5c\u90fd\u662f\u57fa\u4e8e\u5411\u91cf\u548c\u77e9\u9635\u7684\u3002\u5982\u679c\u6ca1\u6709\u989d\u5916\u7684\u7ef4\u5ea6\uff0c\u4e00\u4e9b\u64cd\u4f5c\u4e0d\u80fd\u7ec4\u5408\u3002\u4f8b\u5982\uff0c\u4e0d\u80fd\u628a\u65cb\u8f6c\u548c\u4f4d\u79fb\u64cd\u4f5c\u7ec4\u5408\u8d77\u6765\u3002\uff08\u5982\u679c\u4f60\u60f3\u5b66\u4e60\u66f4\u591a\u6709\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u77e5\u8bc6\uff0c\u8fd9\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u5141\u8bb8\u6211\u4eec\u7ec4\u5408\u4eff\u5c04\u548c\u7ebf\u6027\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7\u9605\u8bfb\u300a3D Math Primer for Graphics and Game Development\u300b\uff08\u4f5c\u8005\u662fFletcher Dunn \u548c Ian Parberry\uff09\u6765\u66f4\u591a\u5730\u4e86\u89e3\u8fd9\u4e00\u70b9\u3002\uff09 \u73b0\u5728\u6765\u770b\u770b\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\u3002\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a fragment.fs \uff08\u6269\u5c55\u540d\u7247\u5143\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; void main() { fragColor = vec4(0.0, 0.5, 0.5, 1.0); } \u8be5\u7ed3\u6784\u4e0e\u6211\u4eec\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\u3002\u73b0\u5728\uff0c\u5b83\u5c06\u4e3a\u6bcf\u4e2a\u7247\u5143\u8bbe\u7f6e\u56fa\u5b9a\u7684\u989c\u8272\u3002\u8f93\u51fa\u503c\u88ab\u5b9a\u4e49\u4e3a\u7b2c\u4e8c\u884c\u7684 vec4 \u7c7b\u578b\u7684 fragColor \u53d8\u91cf\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u7740\u8272\u5668\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u4eec\u5462\uff1f\u4ee5\u4e0b\u662f\u6211\u4eec\u8981\u505a\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\uff1a 1. \u521b\u5efaOpenGL\u7a0b\u5e8f\u3002 2. \u8f7d\u5165\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6587\u4ef6\u3002 3. \u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u5e76\u6307\u5b9a\u5b83\u7684\u7c7b\u578b\uff08\u9876\u70b9\u6216\u7247\u5143\uff09\u3002 4. \u7f16\u8bd1\u7740\u8272\u5668\u3002 5. \u5c06\u7740\u8272\u5668\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e0a\u3002 6. \u8fde\u63a5\u7a0b\u5e8f\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u5c06\u4f1a\u88ab\u8f7d\u5165\u5230\u663e\u5361\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5f15\u7528\u7a0b\u5e8fID\u6765\u4f7f\u7528\u5b83\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL20.*; public class ShaderProgram { private final int programId; private int vertexShaderId; private int fragmentShaderId; public ShaderProgram() throws Exception { programId = glCreateProgram(); if (programId == 0) { throw new Exception(\"Could not create Shader\"); } } public void createVertexShader(String shaderCode) throws Exception { vertexShaderId = createShader(shaderCode, GL_VERTEX_SHADER); } public void createFragmentShader(String shaderCode) throws Exception { fragmentShaderId = createShader(shaderCode, GL_FRAGMENT_SHADER); } protected int createShader(String shaderCode, int shaderType) throws Exception { int shaderId = glCreateShader(shaderType); if (shaderId == 0) { throw new Exception(\"Error creating shader. Type: \" + shaderType); } glShaderSource(shaderId, shaderCode); glCompileShader(shaderId); if (glGetShaderi(shaderId, GL_COMPILE_STATUS) == 0) { throw new Exception(\"Error compiling Shader code: \" + glGetShaderInfoLog(shaderId, 1024)); } glAttachShader(programId, shaderId); return shaderId; } public void link() throws Exception { glLinkProgram(programId); if (glGetProgrami(programId, GL_LINK_STATUS) == 0) { throw new Exception(\"Error linking Shader code: \" + glGetProgramInfoLog(programId, 1024)); } if (vertexShaderId != 0) { glDetachShader(programId, vertexShaderId); } if (fragmentShaderId != 0) { glDetachShader(programId, fragmentShaderId); } glValidateProgram(programId); if (glGetProgrami(programId, GL_VALIDATE_STATUS) == 0) { System.err.println(\"Warning validating Shader code: \" + glGetProgramInfoLog(programId, 1024)); } } public void bind() { glUseProgram(programId); } public void unbind() { glUseProgram(0); } public void cleanup() { unbind(); if (programId != 0) { glDeleteProgram(programId); } } } ShaderProgram \u7c7b\u7684\u6784\u9020\u51fd\u6570\u5728OpenGL\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7a0b\u5e8f\uff0c\u5e76\u63d0\u4f9b\u6dfb\u52a0\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u7684\u65b9\u6cd5\u3002\u8fd9\u4e9b\u7740\u8272\u5668\u88ab\u7f16\u8bd1\u5e76\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e2d\u3002\u5f53\u6240\u6709\u7684\u7740\u8272\u5668\u90fd\u88ab\u7ed1\u5b9a\u65f6\uff0c\u5e94\u8be5\u8c03\u7528 link \u65b9\u6cd5\uff0c\u6765\u8fde\u63a5\u6240\u6709\u4ee3\u7801\u5e76\u9a8c\u8bc1\u6240\u6709\u64cd\u4f5c\u90fd\u5df2\u6b63\u786e\u5730\u5b8c\u6210\u3002 \u4e00\u65e6\u7740\u8272\u5668\u7a0b\u5e8f\u88ab\u8fde\u63a5\uff0c\u7f16\u8bd1\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u88ab\u91ca\u653e\uff08\u901a\u8fc7\u8c03\u7528 glDetachShader \u65b9\u6cd5\uff09\u3002 \u9a8c\u8bc1\u662f\u901a\u8fc7\u8c03\u7528 glValidateProgram \u65b9\u6cd5\u5b8c\u6210\u7684\u3002\u6b64\u65b9\u6cd5\u4e3b\u8981\u7528\u4e8e\u8c03\u8bd5\uff0c\u5f53\u6e38\u620f\u5230\u8fbe\u751f\u4ea7\u9636\u6bb5\u65f6\uff0c\u5e94\u5c06\u5176\u5220\u9664\u3002\u6b64\u65b9\u6cd5\u5c06\u9a8c\u8bc1\u5728 \u5f53\u524dOpenGL\u72b6\u6001 \u4e0b\u7740\u8272\u5668\u662f\u5426\u6b63\u786e\u3002\u8fd9\u610f\u5473\u7740\uff0c\u5373\u4f7f\u7740\u8272\u5668\u662f\u6b63\u786e\u7684\uff0c\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u4e5f\u53ef\u80fd\u9a8c\u8bc1\u5931\u8d25\uff0c\u8fd9\u662f\u56e0\u4e3a\u5f53\u524d\u72b6\u6001\u4e0d\u591f\u5b8c\u6574\uff08\u4e00\u4e9b\u6570\u636e\u53ef\u80fd\u5c1a\u672a\u52a0\u8f7d\uff09\uff0c\u65e0\u6cd5\u8fd0\u884c\u7740\u8272\u5668\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u9519\u8bef\u4fe1\u606f\u8f93\u51fa\u5230\u6807\u51c6\u9519\u8bef\u8f93\u51fa\u4e2d\u3002 ShaderProgram \u7c7b\u8fd8\u63d0\u4f9b\u4e86\u5728\u6e32\u67d3\u65f6\u6fc0\u6d3b\u8be5\u7a0b\u5e8f\uff08\u7ed1\u5b9a\uff09\u548c\u505c\u6b62\u4f7f\u7528\u5b83\uff08\u89e3\u7ed1\uff09\u7684\u65b9\u6cd5\u3002\u6700\u540e\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\uff0c\u7528\u4e8e\u5728\u5b83\u4e0d\u518d\u88ab\u9700\u8981\u65f6\uff0c\u91ca\u653e\u6240\u6709\u8d44\u6e90\u3002 \u65e2\u7136\u6709\u4e00\u4e2a\u6e05\u7406\u65b9\u6cd5\uff0c\u8ba9\u6211\u4eec\u66f4\u6539 IGameLogic \u63a5\u53e3\u6765\u6dfb\u52a0\u4e00\u4e2a cleanup \u65b9\u6cd5\uff1a void cleanup(); \u8be5\u65b9\u6cd5\u5c06\u5728\u6e38\u620f\u5faa\u73af\u7ed3\u675f\u65f6\u8c03\u7528\uff0c\u6240\u4ee5\u9700\u8981\u4fee\u6539 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } finally { cleanup(); } } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u7740\u8272\u5668\u6765\u663e\u793a\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002\u9996\u5148\uff0c\u6211\u4eec\u8981\u521b\u5efa\u7740\u8272\u5668\u7a0b\u5e8f\uff1a public void init() throws Exception { shaderProgram = new ShaderProgram(); shaderProgram.createVertexShader(Utils.loadResource(\"/vertex.vs\")); shaderProgram.createFragmentShader(Utils.loadResource(\"/fragment.fs\")); shaderProgram.link(); } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4ece\u7c7b\u8def\u5f84\u4e2d\u53d6\u5f97\u6587\u4ef6\u5185\u5bb9\u7684\u65b9\u6cd5\uff0c\u6b64\u65b9\u6cd5\u7528\u4e8e\u53d6\u5f97\u6211\u4eec\u7684\u7740\u8272\u5668\u4ee3\u7801\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u628a\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e3a\u4e00\u7ec4\u6d6e\u70b9\u6570\uff0c\u521b\u5efa\u4e00\u4e2a\u4e00\u7ef4\u6d6e\u70b9\u6570\u7ec4\uff0c\u5b83\u5c06\u5b9a\u4e49\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6570\u7ec4\u4e2d\u6ca1\u6709\u6570\u636e\u7ed3\u6784\u3002\u5c31\u76ee\u524d\u800c\u8a00\uff0cOpenGL\u65e0\u6cd5\u77e5\u9053\u8be5\u6570\u7ec4\u7684\u7ed3\u6784\uff0c\u8fd9\u53ea\u662f\u4e00\u7ec4\u6d6e\u70b9\u6570\uff1a float[] vertices = new float[]{ 0.0f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f }; \u4e0b\u56fe\u4f53\u73b0\u4e86\u5728\u5750\u6807\u7cfb\u4e2d\u7684\u4e09\u89d2\u5f62\u3002 \u73b0\u5728\u6211\u4eec\u6709\u4e86\u5750\u6807\uff0c\u9700\u8981\u628a\u5b83\u4eec\u50a8\u5b58\u5230\u663e\u5361\u4e2d\uff0c\u5e76\u544a\u8bc9OpenGL\u5b83\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u5c06\u4ecb\u7ecd\u4e24\u4e2a\u91cd\u8981\u7684\u6982\u5ff5\uff0c\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\u548c\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\u3002\u5982\u679c\u4f60\u5bf9\u63a5\u4e0b\u6765\u7684\u4ee3\u7801\u611f\u5230\u56f0\u60d1\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u73b0\u5728\u6240\u505a\u7684\u662f\u628a\u5c06\u8981\u7ed8\u5236\u7684\u6a21\u578b\u5bf9\u8c61\u7684\u6570\u636e\u4f20\u9012\u5230\u663e\u5b58\u4e2d\u3002\u5f53\u50a8\u5b58\u5b83\u7684\u65f6\u5019\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2aID\uff0c\u7a0d\u540e\u7ed8\u5236\u65f6\u4f1a\u4f7f\u7528\u5b83\u3002 \u5148\u4ecb\u7ecd\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08VBO\uff09\u5427\uff0cVBO\u53ea\u662f\u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7528\u6765\u6682\u5b58\u4e00\u7ec4\u7528\u4e8e\u5efa\u6a21\u4e09\u89d2\u5f62\u7684\u6d6e\u70b9\u6570\u7684\u5730\u65b9\u3002\u5982\u4e0a\u6240\u8ff0\uff0cOpenGL\u5bf9\u6211\u4eec\u7684\u6570\u636e\u7ed3\u6784\u4e00\u65e0\u6240\u77e5\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u4e0d\u4ec5\u53ef\u4ee5\u50a8\u5b58\u5750\u6807\uff0c\u8fd8\u53ef\u4ee5\u50a8\u5b58\u5176\u4ed6\u4fe1\u606f\uff0c\u6bd4\u5982\u7eb9\u7406\u3001\u989c\u8272\u7b49\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\u662f\u4e00\u4e2a\u5bf9\u8c61\uff0c\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u901a\u5e38\u88ab\u79f0\u4e3a\u5c5e\u6027\u5217\u8868\u7684VBO\u3002\u6bcf\u4e2a\u5c5e\u6027\u5217\u8868\u53ef\u4ee5\u4fdd\u5b58\u4e00\u79cd\u7c7b\u578b\u7684\u6570\u636e\uff1a\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\u3002\u5728\u6bcf\u4e2a\u6e32\u67d3\u95f4\u9694\u4e2d\uff0c\u4f60\u53ef\u4ee5\u81ea\u7531\u5730\u50a8\u5b58\u6240\u9700\u7684\u4efb\u4f55\u6570\u636e\u3002 \u4e00\u4e2aVAO\u5c31\u50cf\u662f\u4e00\u4e2a\u5305\u88c5\uff0c\u5b83\u6309\u4e00\u7ec4\u5b9a\u4e49\u5bf9\u50a8\u5b58\u5728\u663e\u5361\u4e2d\u7684\u6570\u636e\u5206\u7ec4\u3002\u5f53\u521b\u5efa\u4e00\u4e2aVAO\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u4e00\u4e2aID\u3002\u6211\u4eec\u4f7f\u7528\u6b64ID\u6765\u6e32\u67d3\u5b83\u548c\u4f7f\u7528\u5b83\u5728\u521b\u5efa\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002\u9996\u5148\u8981\u505a\u7684\u4e8b\u5c31\u662f\u628a\u6d6e\u70b9\u6570\u50a8\u5b58\u5728\u4e00\u4e2a FloatBuffer \u4e2d\u3002\u8fd9\u4e3b\u8981\u662f\u56e0\u4e3a\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u57fa\u4e8eC\u8bed\u8a00\u7684OpenGL\u5e93\u7684\u63a5\u53e3\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u6d6e\u70b9\u6570\u7ec4\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u5e93\u7ba1\u7406\u7684\u4e1c\u897f\u3002 FloatBuffer verticesBuffer = MemoryUtil.memAllocFloat(vertices.length); verticesBuffer.put(vertices).flip(); \u6211\u4eec\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u5728\u5806\u5916\u5185\u5b58\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4ee5\u4fbfOpenGL\u5e93\u8bbf\u95ee\u5b83\u3002\u5728\u50a8\u5b58\u4e86\u6570\u636e\uff08\u8c03\u7528 put \u65b9\u6cd5\uff09\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8c03\u7528 flip \u65b9\u6cd5\u5c06\u7f13\u51b2\u533a\u7684\u4f4d\u7f6e\u91cd\u7f6e\u4e3a0\uff08\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9\u5b83\u7684\u5199\u5165\uff09\u3002\u8bb0\u4f4f\uff0cJava\u4e2d\u7684\u5bf9\u8c61\uff0c\u88ab\u5206\u914d\u5728\u4e00\u4e2a\u53eb\u5806\uff08Heap\uff09\u7684\u5185\u5b58\u7a7a\u95f4\u3002\u5806\u662fJVM\u5185\u5b58\u4e2d\u4fdd\u7559\u7684\u4e00\u5927\u5806\u5185\u5b58\uff0c\u50a8\u5b58\u5728\u5806\u4e2d\u7684\u5bf9\u8c61\u4e0d\u80fd\u901a\u8fc7\u672c\u5730\u4ee3\u7801\u8bbf\u95ee\uff08JNI\uff0c\u8fd9\u79cd\u673a\u5236\u4f7f\u5f97Java\u4e0d\u80fd\u76f4\u63a5\u8c03\u7528\u672c\u5730\u4ee3\u7801\uff09\u3002Java\u4ee3\u7801\u548c\u672c\u5730\u4ee3\u7801\u76f4\u63a5\u5171\u4eab\u5185\u5b58\u6570\u636e\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u5728Java\u4e2d\u76f4\u63a5\u5730\u5206\u914d\u5185\u5b58\u3002 \u5982\u679c\u4f60\u6765\u81eaLWJGL\u7684\u65e7\u7248\u672c\uff0c\u5f3a\u8c03\u4e00\u4e9b\u8981\u70b9\u662f\u5f88\u91cd\u8981\u7684\u3002\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e86\uff0c\u6211\u4eec\u4e0d\u4f7f\u7528\u5de5\u5177\u7c7b BufferUtils \uff0c\u800c\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u521b\u5efa\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7531\u4e8e BufferUtils \u4e0d\u662f\u975e\u5e38\u6709\u6548\u7684\uff0c\u5e76\u4e14\u4ec5\u88ab\u7528\u4e8e\u5411\u4e0b\u517c\u5bb9\u3002LWJGL3\u63d0\u4f9b\u4e86\u4e24\u79cd\u7f13\u51b2\u533a\u7684\u7ba1\u7406\u65b9\u6cd5\uff1a \u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\uff0c\u5373\u7531\u5783\u573e\u56de\u6536\u5668\u81ea\u52a8\u56de\u6536\u7684\u7f13\u51b2\u533a\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u77ed\u6682\u7684\u64cd\u4f5c\uff0c\u6216\u8005\u7528\u4e8e\u4f20\u9012\u5230GPU\u7684\u6570\u636e\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u50a8\u5b58\u4e8e\u8fdb\u7a0b\u5185\u5b58\u4e2d\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 org.lwjgl.system.MemoryStack \u5b9e\u73b0\u7684\u3002 \u624b\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002\u6b64\u60c5\u51b5\u4e0b\uff0c\u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u5c0f\u5fc3\u5730\u91ca\u653e\u5b83\u4eec\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u957f\u65f6\u95f4\u7684\u64cd\u4f5c\u6216\u8005\u5927\u91cf\u7684\u6570\u636e\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 MemoryUtil \u7c7b\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u4ee5\u5728\u6b64\u5904\u67e5\u9605\u7ec6\u8282\uff1a https://blog.lwjgl.org/memory-management-in-lwjgl-3/ \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u7684\u6570\u636e\u88ab\u53d1\u9001\u5230GPU\uff0c\u8fd9\u6837\u53ef\u4ee5\u8003\u8651\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\u3002\u4f46\u7a0d\u540e\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u50a8\u5b58\u53ef\u80fd\u9700\u8981\u624b\u52a8\u7ba1\u7406\u7684\u5927\u91cf\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u4f7f\u7528 MemoryUtil \u7c7b\u7684\u539f\u56e0\uff0c\u56e0\u6b64\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u8981\u5728\u6700\u540e\u4e00\u4e2a\u5757\u4e2d\u91ca\u653e\u7f13\u51b2\u533a\u8d44\u6e90\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002 \u73b0\u5728\u9700\u8981\u521b\u5efaVAO\u7136\u540e\u7ed1\u5b9a\u5b83\uff1a vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); \u7136\u540e\u9700\u8981\u521b\u5efaVBO\uff0c\u7ed1\u5b9a\u5b83\u5e76\u5c06\u6570\u636e\u8f93\u5165\uff1a vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); \u63a5\u4e0b\u6765\u662f\u6700\u91cd\u8981\u7684\u90e8\u5206\u3002\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u5c06\u5176\u50a8\u5b58\u5728VAO\u7684\u5c5e\u6027\u5217\u8868\u4e2d\uff0c\u8fd9\u662f\u7528\u4e0b\u8ff0\u4ee3\u7801\u5b8c\u6210\u7684\uff1a glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); \u5b83\u7684\u53c2\u6570\u662f\uff1a index: \u6307\u5b9a\u7740\u8272\u5668\u671f\u671b\u6b64\u6570\u636e\u7684\u4f4d\u7f6e\u3002 size: \u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u7684\u6570\u636e\u6570\uff08\u4ece1\u52304\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u7ef4\u5750\u6807\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u662f3\u3002 type: \u6307\u5b9a\u6570\u7ec4\u4e2d\u6bcf\u4e2a\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u6d6e\u70b9\u6570\u3002 normalized: \u6307\u5b9a\u503c\u662f\u5426\u5e94\u5f52\u4e00\u5316\u3002 stride: \u6307\u5b9a\u8fde\u7eed\u9876\u70b9\u6570\u636e\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\uff08\u7a0d\u540e\u6211\u4eec\u518d\u89e3\u91ca\uff09\u3002 offset: \u6307\u5b9a\u7f13\u51b2\u533a\u4e2d\u7b2c\u4e00\u4e2a\u6570\u636e\u7684\u504f\u79fb\u91cf\u3002 \u5728\u5b8c\u6210\u4e86VBO\u64cd\u4f5c\u4e4b\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u9664\u5b83\u548cVAO\u7684\u7ed1\u5b9a\uff08\u7ed1\u5b9a\u52300\uff09\u3002 // \u89e3\u7ed1VBO glBindBuffer(GL_ARRAY_BUFFER, 0); // \u89e3\u7ed1VAO glBindVertexArray(0); \u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec \u5fc5\u987b \u901a\u8fc7\u624b\u52a8\u8c03\u7528 memFree \u65b9\u6cd5\u91ca\u653e\u7531 FloatBuffer \u5360\u7528\u7684\u5806\u5916\u5185\u5b58\uff0c\u56e0\u4e3aJava\u5783\u573e\u56de\u6536\u4e0d\u4f1a\u6e05\u7406\u5206\u914d\u7684\u5806\u5916\u5185\u5b58\u3002 if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } \u8fd9\u5c31\u662f init \u65b9\u6cd5\u5e94\u6709\u7684\u4ee3\u7801\u3002\u6211\u4eec\u7684\u6570\u636e\u5df2\u7ecf\u5728\u663e\u5361\u4e2d\u51c6\u5907\u4f7f\u7528\u4e86\uff0c\u73b0\u5728\u53ea\u9700\u8981\u4fee\u6539 render \u65b9\u6cd5\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u8fdb\u884c\u6e32\u67d3\u3002 public void render(Window window) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed1\u5b9aVAO glBindVertexArray(vaoId); // \u7ed8\u5236\u9876\u70b9 glDrawArrays(GL_TRIANGLES, 0, 3); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e05\u7406\u7a97\u53e3\uff0c\u7ed1\u5b9a\u7740\u8272\u5668\u7a0b\u5e8f\uff0c\u7ed1\u5b9aVAO\uff0c\u7ed8\u5236\u50a8\u5b58\u5728VAO\u5173\u8054\u7684VBO\u4e2d\u7684\u9876\u70b9\uff0c\u7136\u540e\u8fd8\u539f\u72b6\u6001\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6211\u4eec\u8fd8\u5728 Renderer \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u7528\u4e8e\u91ca\u653e\u8d44\u6e90\u3002 public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u5c31\u8fd9\u6837\uff01\u5982\u679c\u4f60\u5c0f\u5fc3\u5730\u6309\u7740\u4e0a\u8ff0\u6b65\u9aa4\u505a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u7684\u56fe\u50cf\u3002 \u8fd9\u5c31\u662f\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff01\u4f60\u4e5f\u8bb8\u4f1a\u60f3\u8fd9\u5e76\u4e0d\u4f1a\u4f7f\u5b83\u6210\u4e3a\u524d\u5341\u540d\u7684\u6e38\u620f\uff0c\u4f60\u7684\u60f3\u6cd5\u662f\u5bf9\u7684\u3002\u4f60\u4e5f\u53ef\u4ee5\u8ba4\u4e3a\u8fd9\u662f\u4e00\u4ef6\u65e0\u804a\u7684\u4e8b\u60c5\u6765\u753b\u4e00\u4e2a\u65e0\u804a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u6b63\u5728\u4ecb\u7ecd\u5173\u952e\u7684\u6982\u5ff5\uff0c\u5e76\u51c6\u5907\u57fa\u4e8e\u67b6\u6784\u6765\u505a\u66f4\u590d\u6742\u7684\u4e8b\u60c5\uff0c\u8bf7\u8010\u5fc3\u7b49\u5f85\uff0c\u7ee7\u7eed\u9605\u8bfb\u3002","title":"\u6e32\u67d3"},{"location":"04-rendering/#rendering","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u7528OpenGL\u6e32\u67d3\u573a\u666f\u65f6\u8981\u505a\u7684\u4e8b\u9879\u3002\u5982\u679c\u4f60\u5df2\u7ecf\u4e60\u60ef\u4e86OpenGL\u7684\u65e7\u7248\u672c\uff0c\u4e60\u60ef\u4e86\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\uff0c\u4f60\u53ef\u80fd\u4f1a\u8df3\u8fc7\u8fd9\u4e00\u7ae0\uff0c\u4e0d\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u5b83\u9700\u8981\u8fd9\u4e48\u590d\u6742\u3002\u5b83\u5176\u5b9e\u66f4\u7b80\u5355\u3001\u66f4\u7075\u6d3b\uff0c\u4f60\u53ea\u9700\u8981\u7ed9\u5b83\u4e00\u4e2a\u8868\u73b0\u7684\u673a\u4f1a\u3002\u73b0\u4ee3OpenGL\u4f7f\u4f60\u53ea\u9700\u8003\u8651\u4e00\u4e2a\u95ee\u9898\uff0c\u8fd9\u53ef\u4ee5\u4f7f\u4f60\u4ee5\u66f4\u5408\u7406\u7684\u65b9\u5f0f\u7ec4\u7ec7\u4ee3\u7801\u548c\u5f00\u53d1\u3002 \u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u88ab\u7edf\u79f0\u4e3a\u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\u3002OpenGL\u6700\u521d\u7684\u7248\u672c\u4f7f\u7528\u4e86\u4e00\u4e2a\u88ab\u79f0\u4e3a\u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\u7684\u6a21\u578b\u3002\u8be5\u6a21\u578b\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\uff08\u4f8b\u5982\uff0c\u201c\u8bbe\u7f6e\u96fe\u201d\u6216\u201c\u6dfb\u52a0\u5149\u7167\u201d\uff09\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u56fe\u5f62\u7ba1\u7ebf\u7531\u4ee5\u4e0b\u64cd\u4f5c\u6b65\u9aa4\u7ec4\u6210\uff1a OpenGL 2.0 \u5f15\u5165\u4e86\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\u7684\u6982\u5ff5\u3002\u5728\u8be5\u6a21\u578b\u4e2d\uff0c\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\uff08Shader\uff09\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002\u4e0b\u56fe\u7b80\u5355\u7684\u5c55\u793a\u4e86OpenGL\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff1a \u8be5\u6e32\u67d3\u65b9\u5f0f\u6700\u521d\u5c06\u4ee5\u9876\u70b9\u7f13\u51b2\u533a\u4e3a\u5f62\u5f0f\u7684\u4e00\u7cfb\u5217\u9876\u70b9\u4f5c\u4e3a\u8f93\u5165\u3002\u4f46\u662f\uff0c\u4ec0\u4e48\u662f\u9876\u70b9\uff1f\u9876\u70b9\uff08Vertex\uff09\u662f\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002\u5982\u4f55\u63cf\u8ff0\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4e00\u4e2a\u70b9\u5462\uff1f\u901a\u8fc7\u6307\u5b9a\u5176X\u3001Y\u548cZ\u5750\u6807\u3002\u4ec0\u4e48\u662f\u9876\u70b9\u7f13\u51b2\u533a\uff1f\u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\u662f\u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u53e6\u4e00\u79cd\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u8fd9\u4e9b\u9876\u70b9\u7531\u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\u5904\u7406\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u529f\u80fd\u662f\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002\u8be5\u7740\u8272\u5668\u8fd8\u53ef\u4ee5\u751f\u6210\u4e0e\u989c\u8272\u6216\u7eb9\u7406\u76f8\u5173\u7684\u5176\u4ed6\u8f93\u51fa\uff0c\u4f46\u5176\u4e3b\u8981\u76ee\u7684\u8fd8\u662f\u5c06\u9876\u70b9\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\uff0c\u5373\u751f\u6210\u70b9\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002\u5b83\u4f9d\u7167\u9876\u70b9\u50a8\u5b58\u7684\u987a\u5e8f\uff0c\u4f7f\u7528\u4e0d\u540c\u7684\u6a21\u578b\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002\u4e3a\u4ec0\u4e48\u662f\u4e09\u89d2\u5f62\uff1f\u4e09\u89d2\u5f62\u5c31\u662f\u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\uff0c\u5b83\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u53ef\u4ee5\u7ec4\u5408\u548c\u53d8\u6362\uff0c\u4ee5\u6784\u5efa\u590d\u6742\u7684\u4e09\u7ef4\u573a\u666f\u3002\u6b64\u9636\u6bb5\u8fd8\u53ef\u4ee5\u4f7f\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6765\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\u9636\u6bb5\u63a5\u6536\u6b64\u524d\u751f\u6210\u7684\u4e09\u89d2\u5f62\uff0c\u526a\u8f91\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u8fd9\u4e9b\u7247\u5143\u5c06\u5728\u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\u88ab\u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\u4f7f\u7528\uff0c\u4ee5\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002\u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\u662f\u56fe\u5f62\u7ba1\u7ebf\u7684\u6700\u7ec8\u8f93\u51fa\uff0c\u5b83\u50a8\u5b58\u4e86\u6bcf\u4e2a\u50cf\u7d20\u5e94\u8be5\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u7684\u503c\u3002 \u6ce8\u610f\uff0c\u663e\u5361\u88ab\u8bbe\u8ba1\u6210\u5e76\u884c\u5904\u7406\u4e0a\u8ff0\u6240\u6709\u64cd\u4f5c\uff0c\u8f93\u5165\u7684\u6570\u636e\u53ef\u4ee5\u5e76\u884c\u5904\u7406\u4ee5\u751f\u6210\u6700\u7ec8\u573a\u666f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u7b2c\u4e00\u4e2a\u7740\u8272\u5668\u7a0b\u5e8f\u3002\u7740\u8272\u5668\u662f\u4f7f\u7528\u57fa\u4e8eANSI C\u7684OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\u7f16\u5199\u7684\u3002\u9996\u5148\uff0c\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a\u201c vertex.vs \u201d\uff08\u6269\u5c55\u540d\u4e3a\u9876\u70b9\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; void main() { gl_Position = vec4(position, 1.0); } \u7b2c\u4e00\u884c\u662f\u4e00\u4e2a\u8868\u793a\u6211\u4eec\u6b63\u4f7f\u7528\u7684GLSL\u8bed\u8a00\u7248\u672c\u7684\u6807\u8bc6\u7b26\u3002\u4e0b\u8868\u662fGLSL\u7248\u672c\u3001\u4e0e\u8be5\u7248\u672c\u5339\u914d\u7684OpenGL\u7248\u672c\u548c\u4f7f\u7528\u65b9\u6cd5\uff08\u6765\u81ea\u7ef4\u57fa\u767e\u79d1\uff1a https://en.wikipedia.org/wiki/OpenGL_Shading_Language#Versions \uff09\uff1a GLSL\u7248\u672c OpenGL\u7248\u672c \u7740\u8272\u5668\u6807\u8bc6\u7b26 1.10.59 2.0 #version 110 1.20.8 2.1 #version 120 1.30.10 3.0 #version 130 1.40.08 3.1 #version 140 1.50.11 3.2 #version 150 3.30.6 3.3 #version 330 4.00.9 4.0 #version 400 4.10.6 4.1 #version 410 4.20.11 4.2 #version 420 4.30.8 4.3 #version 430 4.40 4.4 #version 440 4.50 4.5 #version 450 \u7b2c\u4e8c\u884c\u6307\u5b9a\u6b64\u7740\u8272\u5668\u7684\u8f93\u5165\u683c\u5f0f\u3002OpenGL\u7f13\u51b2\u533a\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u662f\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u8be5\u8bed\u8a00\u4e0d\u4f1a\u5f3a\u8feb\u4f60\u4f20\u9012\u9884\u5b9a\u4e49\u8bed\u8a00\u7684\u4efb\u4f55\u6307\u5b9a\u6570\u636e\u7ed3\u6784\u3002\u4ece\u7740\u8272\u5668\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u5b83\u671f\u671b\u63a5\u6536\u4e00\u4e2a\u5b58\u6709\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002\u5b83\u53ef\u4ee5\u662f\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4e00\u4e2a\u6709\u4e00\u4e9b\u9644\u52a0\u4fe1\u606f\u7684\u4f4d\u7f6e\uff0c\u6216\u8005\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\u3002\u9876\u70b9\u7740\u8272\u5668\u53ea\u63a5\u6536\u6d6e\u70b9\u6570\u7ec4\u3002\u5f53\u586b\u5145\u7f13\u51b2\u533a\u65f6\uff0c\u6211\u4eec\u5b9a\u4e49\u8981\u7531\u7740\u8272\u5668\u5904\u7406\u7684\u7f13\u51b2\u533a\u5757\u3002 \u9996\u5148\uff0c\u9700\u8981\u628a\u8fd9\u4e9b\u5757\u53d8\u6210\u5bf9\u6211\u4eec\u6709\u610f\u4e49\u7684\u6570\u636e\u3002\u73b0\u5728\u89c4\u5b9a\u4ece\u4f4d\u7f6e0\u5f00\u59cb\uff0c\u6211\u4eec\u671f\u671b\u63a5\u6536\u7531\u4e09\u4e2a\u5c5e\u6027(X, Y, Z)\u7ec4\u6210\u7684\u5411\u91cf\u3002 \u7740\u8272\u5668\u6709\u4e2a main \u4ee3\u7801\u5757\uff0c\u5c31\u50cf\u4efb\u4f55C\u8bed\u8a00\u7a0b\u5e8f\u4e00\u6837\uff0c\u4e0a\u8ff0\u793a\u4f8b\u662f\u975e\u5e38\u7b80\u5355\u7684\u3002\u5b83\u53ea\u662f\u5c06\u63a5\u6536\u5230\u7684\u5750\u6807\u4e0d\u7ecf\u4efb\u4f55\u53d8\u6362\u5730\u8fd4\u56de\u5230 gl_Position \u3002\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u4e09\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\u88ab\u8f6c\u6362\u6210\u56db\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\uff08 vec4 \uff09\u3002\u8fd9\u662f\u56e0\u4e3a gl_Position \u4ec5\u63a5\u6536 vec4 \u7c7b\u578b\u7684\u6570\u636e\uff0c\u56e0\u4e3a\u5b83\u662f\u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u5e0c\u671b\u63a5\u6536\u5230\u5f62\u4f3c(X, Y, Z, W)\u7684\u4e1c\u897f\uff0c\u5176\u4e2dW\u4ee3\u8868\u4e00\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u3002\u4e3a\u4ec0\u4e48\u8fd8\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u7ef4\u5ea6\uff1f\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u6211\u4eec\u9700\u8981\u505a\u7684\u5927\u90e8\u5206\u64cd\u4f5c\u90fd\u662f\u57fa\u4e8e\u5411\u91cf\u548c\u77e9\u9635\u7684\u3002\u5982\u679c\u6ca1\u6709\u989d\u5916\u7684\u7ef4\u5ea6\uff0c\u4e00\u4e9b\u64cd\u4f5c\u4e0d\u80fd\u7ec4\u5408\u3002\u4f8b\u5982\uff0c\u4e0d\u80fd\u628a\u65cb\u8f6c\u548c\u4f4d\u79fb\u64cd\u4f5c\u7ec4\u5408\u8d77\u6765\u3002\uff08\u5982\u679c\u4f60\u60f3\u5b66\u4e60\u66f4\u591a\u6709\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u77e5\u8bc6\uff0c\u8fd9\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u5141\u8bb8\u6211\u4eec\u7ec4\u5408\u4eff\u5c04\u548c\u7ebf\u6027\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7\u9605\u8bfb\u300a3D Math Primer for Graphics and Game Development\u300b\uff08\u4f5c\u8005\u662fFletcher Dunn \u548c Ian Parberry\uff09\u6765\u66f4\u591a\u5730\u4e86\u89e3\u8fd9\u4e00\u70b9\u3002\uff09 \u73b0\u5728\u6765\u770b\u770b\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\u3002\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a fragment.fs \uff08\u6269\u5c55\u540d\u7247\u5143\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; void main() { fragColor = vec4(0.0, 0.5, 0.5, 1.0); } \u8be5\u7ed3\u6784\u4e0e\u6211\u4eec\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\u3002\u73b0\u5728\uff0c\u5b83\u5c06\u4e3a\u6bcf\u4e2a\u7247\u5143\u8bbe\u7f6e\u56fa\u5b9a\u7684\u989c\u8272\u3002\u8f93\u51fa\u503c\u88ab\u5b9a\u4e49\u4e3a\u7b2c\u4e8c\u884c\u7684 vec4 \u7c7b\u578b\u7684 fragColor \u53d8\u91cf\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u7740\u8272\u5668\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u4eec\u5462\uff1f\u4ee5\u4e0b\u662f\u6211\u4eec\u8981\u505a\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\uff1a 1. \u521b\u5efaOpenGL\u7a0b\u5e8f\u3002 2. \u8f7d\u5165\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6587\u4ef6\u3002 3. \u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u5e76\u6307\u5b9a\u5b83\u7684\u7c7b\u578b\uff08\u9876\u70b9\u6216\u7247\u5143\uff09\u3002 4. \u7f16\u8bd1\u7740\u8272\u5668\u3002 5. \u5c06\u7740\u8272\u5668\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e0a\u3002 6. \u8fde\u63a5\u7a0b\u5e8f\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u5c06\u4f1a\u88ab\u8f7d\u5165\u5230\u663e\u5361\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5f15\u7528\u7a0b\u5e8fID\u6765\u4f7f\u7528\u5b83\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL20.*; public class ShaderProgram { private final int programId; private int vertexShaderId; private int fragmentShaderId; public ShaderProgram() throws Exception { programId = glCreateProgram(); if (programId == 0) { throw new Exception(\"Could not create Shader\"); } } public void createVertexShader(String shaderCode) throws Exception { vertexShaderId = createShader(shaderCode, GL_VERTEX_SHADER); } public void createFragmentShader(String shaderCode) throws Exception { fragmentShaderId = createShader(shaderCode, GL_FRAGMENT_SHADER); } protected int createShader(String shaderCode, int shaderType) throws Exception { int shaderId = glCreateShader(shaderType); if (shaderId == 0) { throw new Exception(\"Error creating shader. Type: \" + shaderType); } glShaderSource(shaderId, shaderCode); glCompileShader(shaderId); if (glGetShaderi(shaderId, GL_COMPILE_STATUS) == 0) { throw new Exception(\"Error compiling Shader code: \" + glGetShaderInfoLog(shaderId, 1024)); } glAttachShader(programId, shaderId); return shaderId; } public void link() throws Exception { glLinkProgram(programId); if (glGetProgrami(programId, GL_LINK_STATUS) == 0) { throw new Exception(\"Error linking Shader code: \" + glGetProgramInfoLog(programId, 1024)); } if (vertexShaderId != 0) { glDetachShader(programId, vertexShaderId); } if (fragmentShaderId != 0) { glDetachShader(programId, fragmentShaderId); } glValidateProgram(programId); if (glGetProgrami(programId, GL_VALIDATE_STATUS) == 0) { System.err.println(\"Warning validating Shader code: \" + glGetProgramInfoLog(programId, 1024)); } } public void bind() { glUseProgram(programId); } public void unbind() { glUseProgram(0); } public void cleanup() { unbind(); if (programId != 0) { glDeleteProgram(programId); } } } ShaderProgram \u7c7b\u7684\u6784\u9020\u51fd\u6570\u5728OpenGL\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7a0b\u5e8f\uff0c\u5e76\u63d0\u4f9b\u6dfb\u52a0\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u7684\u65b9\u6cd5\u3002\u8fd9\u4e9b\u7740\u8272\u5668\u88ab\u7f16\u8bd1\u5e76\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e2d\u3002\u5f53\u6240\u6709\u7684\u7740\u8272\u5668\u90fd\u88ab\u7ed1\u5b9a\u65f6\uff0c\u5e94\u8be5\u8c03\u7528 link \u65b9\u6cd5\uff0c\u6765\u8fde\u63a5\u6240\u6709\u4ee3\u7801\u5e76\u9a8c\u8bc1\u6240\u6709\u64cd\u4f5c\u90fd\u5df2\u6b63\u786e\u5730\u5b8c\u6210\u3002 \u4e00\u65e6\u7740\u8272\u5668\u7a0b\u5e8f\u88ab\u8fde\u63a5\uff0c\u7f16\u8bd1\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u88ab\u91ca\u653e\uff08\u901a\u8fc7\u8c03\u7528 glDetachShader \u65b9\u6cd5\uff09\u3002 \u9a8c\u8bc1\u662f\u901a\u8fc7\u8c03\u7528 glValidateProgram \u65b9\u6cd5\u5b8c\u6210\u7684\u3002\u6b64\u65b9\u6cd5\u4e3b\u8981\u7528\u4e8e\u8c03\u8bd5\uff0c\u5f53\u6e38\u620f\u5230\u8fbe\u751f\u4ea7\u9636\u6bb5\u65f6\uff0c\u5e94\u5c06\u5176\u5220\u9664\u3002\u6b64\u65b9\u6cd5\u5c06\u9a8c\u8bc1\u5728 \u5f53\u524dOpenGL\u72b6\u6001 \u4e0b\u7740\u8272\u5668\u662f\u5426\u6b63\u786e\u3002\u8fd9\u610f\u5473\u7740\uff0c\u5373\u4f7f\u7740\u8272\u5668\u662f\u6b63\u786e\u7684\uff0c\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u4e5f\u53ef\u80fd\u9a8c\u8bc1\u5931\u8d25\uff0c\u8fd9\u662f\u56e0\u4e3a\u5f53\u524d\u72b6\u6001\u4e0d\u591f\u5b8c\u6574\uff08\u4e00\u4e9b\u6570\u636e\u53ef\u80fd\u5c1a\u672a\u52a0\u8f7d\uff09\uff0c\u65e0\u6cd5\u8fd0\u884c\u7740\u8272\u5668\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u9519\u8bef\u4fe1\u606f\u8f93\u51fa\u5230\u6807\u51c6\u9519\u8bef\u8f93\u51fa\u4e2d\u3002 ShaderProgram \u7c7b\u8fd8\u63d0\u4f9b\u4e86\u5728\u6e32\u67d3\u65f6\u6fc0\u6d3b\u8be5\u7a0b\u5e8f\uff08\u7ed1\u5b9a\uff09\u548c\u505c\u6b62\u4f7f\u7528\u5b83\uff08\u89e3\u7ed1\uff09\u7684\u65b9\u6cd5\u3002\u6700\u540e\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\uff0c\u7528\u4e8e\u5728\u5b83\u4e0d\u518d\u88ab\u9700\u8981\u65f6\uff0c\u91ca\u653e\u6240\u6709\u8d44\u6e90\u3002 \u65e2\u7136\u6709\u4e00\u4e2a\u6e05\u7406\u65b9\u6cd5\uff0c\u8ba9\u6211\u4eec\u66f4\u6539 IGameLogic \u63a5\u53e3\u6765\u6dfb\u52a0\u4e00\u4e2a cleanup \u65b9\u6cd5\uff1a void cleanup(); \u8be5\u65b9\u6cd5\u5c06\u5728\u6e38\u620f\u5faa\u73af\u7ed3\u675f\u65f6\u8c03\u7528\uff0c\u6240\u4ee5\u9700\u8981\u4fee\u6539 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } finally { cleanup(); } } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u7740\u8272\u5668\u6765\u663e\u793a\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002\u9996\u5148\uff0c\u6211\u4eec\u8981\u521b\u5efa\u7740\u8272\u5668\u7a0b\u5e8f\uff1a public void init() throws Exception { shaderProgram = new ShaderProgram(); shaderProgram.createVertexShader(Utils.loadResource(\"/vertex.vs\")); shaderProgram.createFragmentShader(Utils.loadResource(\"/fragment.fs\")); shaderProgram.link(); } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4ece\u7c7b\u8def\u5f84\u4e2d\u53d6\u5f97\u6587\u4ef6\u5185\u5bb9\u7684\u65b9\u6cd5\uff0c\u6b64\u65b9\u6cd5\u7528\u4e8e\u53d6\u5f97\u6211\u4eec\u7684\u7740\u8272\u5668\u4ee3\u7801\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u628a\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e3a\u4e00\u7ec4\u6d6e\u70b9\u6570\uff0c\u521b\u5efa\u4e00\u4e2a\u4e00\u7ef4\u6d6e\u70b9\u6570\u7ec4\uff0c\u5b83\u5c06\u5b9a\u4e49\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6570\u7ec4\u4e2d\u6ca1\u6709\u6570\u636e\u7ed3\u6784\u3002\u5c31\u76ee\u524d\u800c\u8a00\uff0cOpenGL\u65e0\u6cd5\u77e5\u9053\u8be5\u6570\u7ec4\u7684\u7ed3\u6784\uff0c\u8fd9\u53ea\u662f\u4e00\u7ec4\u6d6e\u70b9\u6570\uff1a float[] vertices = new float[]{ 0.0f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f }; \u4e0b\u56fe\u4f53\u73b0\u4e86\u5728\u5750\u6807\u7cfb\u4e2d\u7684\u4e09\u89d2\u5f62\u3002 \u73b0\u5728\u6211\u4eec\u6709\u4e86\u5750\u6807\uff0c\u9700\u8981\u628a\u5b83\u4eec\u50a8\u5b58\u5230\u663e\u5361\u4e2d\uff0c\u5e76\u544a\u8bc9OpenGL\u5b83\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u5c06\u4ecb\u7ecd\u4e24\u4e2a\u91cd\u8981\u7684\u6982\u5ff5\uff0c\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\u548c\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\u3002\u5982\u679c\u4f60\u5bf9\u63a5\u4e0b\u6765\u7684\u4ee3\u7801\u611f\u5230\u56f0\u60d1\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u73b0\u5728\u6240\u505a\u7684\u662f\u628a\u5c06\u8981\u7ed8\u5236\u7684\u6a21\u578b\u5bf9\u8c61\u7684\u6570\u636e\u4f20\u9012\u5230\u663e\u5b58\u4e2d\u3002\u5f53\u50a8\u5b58\u5b83\u7684\u65f6\u5019\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2aID\uff0c\u7a0d\u540e\u7ed8\u5236\u65f6\u4f1a\u4f7f\u7528\u5b83\u3002 \u5148\u4ecb\u7ecd\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08VBO\uff09\u5427\uff0cVBO\u53ea\u662f\u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7528\u6765\u6682\u5b58\u4e00\u7ec4\u7528\u4e8e\u5efa\u6a21\u4e09\u89d2\u5f62\u7684\u6d6e\u70b9\u6570\u7684\u5730\u65b9\u3002\u5982\u4e0a\u6240\u8ff0\uff0cOpenGL\u5bf9\u6211\u4eec\u7684\u6570\u636e\u7ed3\u6784\u4e00\u65e0\u6240\u77e5\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u4e0d\u4ec5\u53ef\u4ee5\u50a8\u5b58\u5750\u6807\uff0c\u8fd8\u53ef\u4ee5\u50a8\u5b58\u5176\u4ed6\u4fe1\u606f\uff0c\u6bd4\u5982\u7eb9\u7406\u3001\u989c\u8272\u7b49\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\u662f\u4e00\u4e2a\u5bf9\u8c61\uff0c\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u901a\u5e38\u88ab\u79f0\u4e3a\u5c5e\u6027\u5217\u8868\u7684VBO\u3002\u6bcf\u4e2a\u5c5e\u6027\u5217\u8868\u53ef\u4ee5\u4fdd\u5b58\u4e00\u79cd\u7c7b\u578b\u7684\u6570\u636e\uff1a\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\u3002\u5728\u6bcf\u4e2a\u6e32\u67d3\u95f4\u9694\u4e2d\uff0c\u4f60\u53ef\u4ee5\u81ea\u7531\u5730\u50a8\u5b58\u6240\u9700\u7684\u4efb\u4f55\u6570\u636e\u3002 \u4e00\u4e2aVAO\u5c31\u50cf\u662f\u4e00\u4e2a\u5305\u88c5\uff0c\u5b83\u6309\u4e00\u7ec4\u5b9a\u4e49\u5bf9\u50a8\u5b58\u5728\u663e\u5361\u4e2d\u7684\u6570\u636e\u5206\u7ec4\u3002\u5f53\u521b\u5efa\u4e00\u4e2aVAO\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u4e00\u4e2aID\u3002\u6211\u4eec\u4f7f\u7528\u6b64ID\u6765\u6e32\u67d3\u5b83\u548c\u4f7f\u7528\u5b83\u5728\u521b\u5efa\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002\u9996\u5148\u8981\u505a\u7684\u4e8b\u5c31\u662f\u628a\u6d6e\u70b9\u6570\u50a8\u5b58\u5728\u4e00\u4e2a FloatBuffer \u4e2d\u3002\u8fd9\u4e3b\u8981\u662f\u56e0\u4e3a\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u57fa\u4e8eC\u8bed\u8a00\u7684OpenGL\u5e93\u7684\u63a5\u53e3\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u6d6e\u70b9\u6570\u7ec4\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u5e93\u7ba1\u7406\u7684\u4e1c\u897f\u3002 FloatBuffer verticesBuffer = MemoryUtil.memAllocFloat(vertices.length); verticesBuffer.put(vertices).flip(); \u6211\u4eec\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u5728\u5806\u5916\u5185\u5b58\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4ee5\u4fbfOpenGL\u5e93\u8bbf\u95ee\u5b83\u3002\u5728\u50a8\u5b58\u4e86\u6570\u636e\uff08\u8c03\u7528 put \u65b9\u6cd5\uff09\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8c03\u7528 flip \u65b9\u6cd5\u5c06\u7f13\u51b2\u533a\u7684\u4f4d\u7f6e\u91cd\u7f6e\u4e3a0\uff08\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9\u5b83\u7684\u5199\u5165\uff09\u3002\u8bb0\u4f4f\uff0cJava\u4e2d\u7684\u5bf9\u8c61\uff0c\u88ab\u5206\u914d\u5728\u4e00\u4e2a\u53eb\u5806\uff08Heap\uff09\u7684\u5185\u5b58\u7a7a\u95f4\u3002\u5806\u662fJVM\u5185\u5b58\u4e2d\u4fdd\u7559\u7684\u4e00\u5927\u5806\u5185\u5b58\uff0c\u50a8\u5b58\u5728\u5806\u4e2d\u7684\u5bf9\u8c61\u4e0d\u80fd\u901a\u8fc7\u672c\u5730\u4ee3\u7801\u8bbf\u95ee\uff08JNI\uff0c\u8fd9\u79cd\u673a\u5236\u4f7f\u5f97Java\u4e0d\u80fd\u76f4\u63a5\u8c03\u7528\u672c\u5730\u4ee3\u7801\uff09\u3002Java\u4ee3\u7801\u548c\u672c\u5730\u4ee3\u7801\u76f4\u63a5\u5171\u4eab\u5185\u5b58\u6570\u636e\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u5728Java\u4e2d\u76f4\u63a5\u5730\u5206\u914d\u5185\u5b58\u3002 \u5982\u679c\u4f60\u6765\u81eaLWJGL\u7684\u65e7\u7248\u672c\uff0c\u5f3a\u8c03\u4e00\u4e9b\u8981\u70b9\u662f\u5f88\u91cd\u8981\u7684\u3002\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e86\uff0c\u6211\u4eec\u4e0d\u4f7f\u7528\u5de5\u5177\u7c7b BufferUtils \uff0c\u800c\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u521b\u5efa\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7531\u4e8e BufferUtils \u4e0d\u662f\u975e\u5e38\u6709\u6548\u7684\uff0c\u5e76\u4e14\u4ec5\u88ab\u7528\u4e8e\u5411\u4e0b\u517c\u5bb9\u3002LWJGL3\u63d0\u4f9b\u4e86\u4e24\u79cd\u7f13\u51b2\u533a\u7684\u7ba1\u7406\u65b9\u6cd5\uff1a \u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\uff0c\u5373\u7531\u5783\u573e\u56de\u6536\u5668\u81ea\u52a8\u56de\u6536\u7684\u7f13\u51b2\u533a\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u77ed\u6682\u7684\u64cd\u4f5c\uff0c\u6216\u8005\u7528\u4e8e\u4f20\u9012\u5230GPU\u7684\u6570\u636e\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u50a8\u5b58\u4e8e\u8fdb\u7a0b\u5185\u5b58\u4e2d\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 org.lwjgl.system.MemoryStack \u5b9e\u73b0\u7684\u3002 \u624b\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002\u6b64\u60c5\u51b5\u4e0b\uff0c\u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u5c0f\u5fc3\u5730\u91ca\u653e\u5b83\u4eec\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u957f\u65f6\u95f4\u7684\u64cd\u4f5c\u6216\u8005\u5927\u91cf\u7684\u6570\u636e\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 MemoryUtil \u7c7b\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u4ee5\u5728\u6b64\u5904\u67e5\u9605\u7ec6\u8282\uff1a https://blog.lwjgl.org/memory-management-in-lwjgl-3/ \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u7684\u6570\u636e\u88ab\u53d1\u9001\u5230GPU\uff0c\u8fd9\u6837\u53ef\u4ee5\u8003\u8651\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\u3002\u4f46\u7a0d\u540e\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u50a8\u5b58\u53ef\u80fd\u9700\u8981\u624b\u52a8\u7ba1\u7406\u7684\u5927\u91cf\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u4f7f\u7528 MemoryUtil \u7c7b\u7684\u539f\u56e0\uff0c\u56e0\u6b64\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u8981\u5728\u6700\u540e\u4e00\u4e2a\u5757\u4e2d\u91ca\u653e\u7f13\u51b2\u533a\u8d44\u6e90\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002 \u73b0\u5728\u9700\u8981\u521b\u5efaVAO\u7136\u540e\u7ed1\u5b9a\u5b83\uff1a vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); \u7136\u540e\u9700\u8981\u521b\u5efaVBO\uff0c\u7ed1\u5b9a\u5b83\u5e76\u5c06\u6570\u636e\u8f93\u5165\uff1a vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); \u63a5\u4e0b\u6765\u662f\u6700\u91cd\u8981\u7684\u90e8\u5206\u3002\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u5c06\u5176\u50a8\u5b58\u5728VAO\u7684\u5c5e\u6027\u5217\u8868\u4e2d\uff0c\u8fd9\u662f\u7528\u4e0b\u8ff0\u4ee3\u7801\u5b8c\u6210\u7684\uff1a glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); \u5b83\u7684\u53c2\u6570\u662f\uff1a index: \u6307\u5b9a\u7740\u8272\u5668\u671f\u671b\u6b64\u6570\u636e\u7684\u4f4d\u7f6e\u3002 size: \u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u7684\u6570\u636e\u6570\uff08\u4ece1\u52304\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u7ef4\u5750\u6807\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u662f3\u3002 type: \u6307\u5b9a\u6570\u7ec4\u4e2d\u6bcf\u4e2a\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u6d6e\u70b9\u6570\u3002 normalized: \u6307\u5b9a\u503c\u662f\u5426\u5e94\u5f52\u4e00\u5316\u3002 stride: \u6307\u5b9a\u8fde\u7eed\u9876\u70b9\u6570\u636e\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\uff08\u7a0d\u540e\u6211\u4eec\u518d\u89e3\u91ca\uff09\u3002 offset: \u6307\u5b9a\u7f13\u51b2\u533a\u4e2d\u7b2c\u4e00\u4e2a\u6570\u636e\u7684\u504f\u79fb\u91cf\u3002 \u5728\u5b8c\u6210\u4e86VBO\u64cd\u4f5c\u4e4b\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u9664\u5b83\u548cVAO\u7684\u7ed1\u5b9a\uff08\u7ed1\u5b9a\u52300\uff09\u3002 // \u89e3\u7ed1VBO glBindBuffer(GL_ARRAY_BUFFER, 0); // \u89e3\u7ed1VAO glBindVertexArray(0); \u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec \u5fc5\u987b \u901a\u8fc7\u624b\u52a8\u8c03\u7528 memFree \u65b9\u6cd5\u91ca\u653e\u7531 FloatBuffer \u5360\u7528\u7684\u5806\u5916\u5185\u5b58\uff0c\u56e0\u4e3aJava\u5783\u573e\u56de\u6536\u4e0d\u4f1a\u6e05\u7406\u5206\u914d\u7684\u5806\u5916\u5185\u5b58\u3002 if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } \u8fd9\u5c31\u662f init \u65b9\u6cd5\u5e94\u6709\u7684\u4ee3\u7801\u3002\u6211\u4eec\u7684\u6570\u636e\u5df2\u7ecf\u5728\u663e\u5361\u4e2d\u51c6\u5907\u4f7f\u7528\u4e86\uff0c\u73b0\u5728\u53ea\u9700\u8981\u4fee\u6539 render \u65b9\u6cd5\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u8fdb\u884c\u6e32\u67d3\u3002 public void render(Window window) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed1\u5b9aVAO glBindVertexArray(vaoId); // \u7ed8\u5236\u9876\u70b9 glDrawArrays(GL_TRIANGLES, 0, 3); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e05\u7406\u7a97\u53e3\uff0c\u7ed1\u5b9a\u7740\u8272\u5668\u7a0b\u5e8f\uff0c\u7ed1\u5b9aVAO\uff0c\u7ed8\u5236\u50a8\u5b58\u5728VAO\u5173\u8054\u7684VBO\u4e2d\u7684\u9876\u70b9\uff0c\u7136\u540e\u8fd8\u539f\u72b6\u6001\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6211\u4eec\u8fd8\u5728 Renderer \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u7528\u4e8e\u91ca\u653e\u8d44\u6e90\u3002 public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u5c31\u8fd9\u6837\uff01\u5982\u679c\u4f60\u5c0f\u5fc3\u5730\u6309\u7740\u4e0a\u8ff0\u6b65\u9aa4\u505a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u7684\u56fe\u50cf\u3002 \u8fd9\u5c31\u662f\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff01\u4f60\u4e5f\u8bb8\u4f1a\u60f3\u8fd9\u5e76\u4e0d\u4f1a\u4f7f\u5b83\u6210\u4e3a\u524d\u5341\u540d\u7684\u6e38\u620f\uff0c\u4f60\u7684\u60f3\u6cd5\u662f\u5bf9\u7684\u3002\u4f60\u4e5f\u53ef\u4ee5\u8ba4\u4e3a\u8fd9\u662f\u4e00\u4ef6\u65e0\u804a\u7684\u4e8b\u60c5\u6765\u753b\u4e00\u4e2a\u65e0\u804a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u6b63\u5728\u4ecb\u7ecd\u5173\u952e\u7684\u6982\u5ff5\uff0c\u5e76\u51c6\u5907\u57fa\u4e8e\u67b6\u6784\u6765\u505a\u66f4\u590d\u6742\u7684\u4e8b\u60c5\uff0c\u8bf7\u8010\u5fc3\u7b49\u5f85\uff0c\u7ee7\u7eed\u9605\u8bfb\u3002","title":"\u6e32\u67d3\uff08Rendering\uff09"},{"location":"05-more-on-rendering/","text":"\u6e32\u67d3\u8865\u5145\uff08More on Rendering\uff09 \u672c\u7ae0\u6211\u4eec\u5c06\u7ee7\u7eed\u8bb2\u8ff0OpenGL\u5982\u4f55\u6e32\u67d3\u7269\u4f53\u3002\u4e3a\u4e86\u6574\u7406\u4ee3\u7801\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Mesh \u7684\u65b0\u7c7b\uff0c\u628a\u4e00\u4e2a\u4f4d\u7f6e\u6570\u7ec4\u4f5c\u4e3a\u8f93\u5165\uff0c\u4e3a\u9700\u8981\u52a0\u8f7d\u5230\u663e\u5361\u4e2d\u7684\u6a21\u578b\u521b\u5efaVBO\u548cVAO\u5bf9\u8c61\u3002 package org.lwjglb.engine.graph; import java.nio.FloatBuffer; import org.lwjgl.system.MemoryUtil; import static org.lwjgl.opengl.GL30.*; public class Mesh { private final int vaoId; private final int vboId; private final int vertexCount; public Mesh(float[] positions) { FloatBuffer verticesBuffer = null; try { verticesBuffer = MemoryUtil.memAllocFloat(positions.length); vertexCount = positions.length / 3; verticesBuffer.put(positions).flip(); vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); glBindBuffer(GL_ARRAY_BUFFER, 0); glBindVertexArray(0); } finally { if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } } } public int getVaoId() { return vaoId; } public int getVertexCount() { return vertexCount; } public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } } \u6211\u4eec\u5c06\u5728 DummyGame \u7c7b\u4e2d\u5b9e\u4f8b\u5316 Mesh \uff0c\u7136\u540e\u5c06 Renderer \u7684 init \u65b9\u6cd5\u4e2d\u7684VAO\u548cVBO\u4ee3\u7801\u5220\u9664\u3002\u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\u5c06\u63a5\u6536\u4e00\u4e2a Mesh \u5bf9\u8c61\u6765\u6e32\u67d3\u3002 cleanup \u65b9\u6cd5\u4e5f\u88ab\u7b80\u5316\uff0c\u56e0\u4e3a Mesh \u7c7b\u5df2\u7ecf\u63d0\u4f9b\u4e86\u4e00\u4e2a\u91ca\u653eVAO\u548cVBO\u8d44\u6e90\u7684\u65b9\u6cd5\u3002 public void render(Mesh mesh) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed8\u5236 glBindVertexArray(mesh.getVaoId()); glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } } \u503c\u5f97\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); Mesh \u7c7b\u901a\u8fc7\u5c06\u4f4d\u7f6e\u6570\u7ec4\u9664\u4ee53\u6765\u8ba1\u7b97\u9876\u70b9\u7684\u6570\u76ee\uff08\u56e0\u4e3a\u6211\u4eec\u4f7f\u7528X\uff0cY\u548cZ\u5750\u6807\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u66f4\u590d\u6742\u7684\u5f62\u72b6\u3002\u6765\u8bd5\u8bd5\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4e00\u4e2a\u6b63\u65b9\u5f62\u53ef\u4ee5\u7528\u4e24\u4e2a\u4e09\u89d2\u5f62\u6765\u7ec4\u6210\uff0c\u5982\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u4e2d\u7684\u6bcf\u4e00\u4e2a\u90fd\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V1\u3001V2\u548cV4\uff08\u6a59\u8272\u7684\u70b9\uff09\u7ec4\u6210\uff0c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V4\uff0cV2\u548cV3\uff08\u7eff\u8272\u7684\u70b9\uff09\u7ec4\u6210\u3002\u9876\u70b9\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u8fde\u63a5\uff0c\u56e0\u6b64\u8981\u4f20\u9012\u7684\u6d6e\u70b9\u6570\u6570\u7ec4\u5e94\u8be5\u662f[V1, V2, V4, V4, V2, V3]\u3002\u56e0\u6b64\uff0c DummyGame \u7684 init \u65b9\u6cd5\u5c06\u662f\u8fd9\u6837\u7684\uff1a @Override public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, 0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, }; mesh = new Mesh(positions); } \u73b0\u5728\u4f60\u5e94\u8be5\u53ef\u4ee5\u770b\u5230\u8fd9\u6837\u7684\u4e00\u4e2a\u6b63\u65b9\u5f62\uff1a \u6211\u4eec\u505a\u5b8c\u4e86\u5417\uff1f\u5e76\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4ecd\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u6211\u4eec\u4f7f\u7528\u4e86\u91cd\u590d\u7684\u5750\u6807\u6765\u8868\u793a\u6b63\u65b9\u5f62\uff0c\u4f20\u9012\u4e86\u4e24\u6b21V2\u548cV4\u5750\u6807\u3002\u8fd9\u662f\u4e2a\u5c0f\u56fe\u5f62\uff0c\u5b83\u53ef\u80fd\u4e0d\u662f\u4ec0\u4e48\u5927\u95ee\u9898\uff0c\u4f46\u60f3\u8c61\u5728\u4e00\u4e2a\u66f4\u590d\u6742\u76843D\u6a21\u578b\u4e2d\uff0c\u6211\u4eec\u4f1a\u591a\u6b21\u91cd\u590d\u4f20\u9012\u5750\u6807\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u4e2a\u6d6e\u70b9\u6570\u8868\u793a\u9876\u70b9\u7684\u4f4d\u7f6e\uff0c\u4f46\u6b64\u540e\u5c06\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u6765\u8868\u793a\u7eb9\u7406\u7b49\u3002\u8003\u8651\u5230\u5728\u66f4\u590d\u6742\u7684\u5f62\u72b6\u4e2d\uff0c\u4e09\u89d2\u5f62\u76f4\u63a5\u5171\u4eab\u7684\u9876\u70b9\u6570\u91cf\u751a\u81f3\u66f4\u9ad8\uff0c\u5982\u56fe\u6240\u793a\uff08\u5176\u9876\u70b9\u53ef\u4ee5\u5728\u516d\u4e2a\u4e09\u89d2\u5f62\u4e4b\u95f4\u5171\u4eab\uff09\uff1a \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u66f4\u591a\u7684\u5185\u5b58\u6765\u50a8\u5b58\u91cd\u590d\u7684\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\u5927\u663e\u8eab\u624b\u7684\u65f6\u5019\u3002\u4e3a\u4e86\u7ed8\u5236\u6b63\u65b9\u5f62\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4ee5\u8fd9\u6837\u7684\u65b9\u5f0f\u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\uff1aV1, V2, V3, V4\u3002\u6bcf\u4e2a\u9876\u70b9\u5728\u6570\u7ec4\u4e2d\u90fd\u6709\u4e00\u4e2a\u4f4d\u7f6e\u3002V1\u5728\u4f4d\u7f6e0\u4e0a\uff0cV2\u5728\u4f4d\u7f6e1\u4e0a\uff0c\u7b49\u7b49\uff1a V1 V2 V3 V4 0 1 2 3 \u7136\u540e\uff0c\u6211\u4eec\u901a\u8fc7\u5f15\u7528\u5b83\u4eec\u7684\u4f4d\u7f6e\u6765\u6307\u5b9a\u8fd9\u4e9b\u9876\u70b9\u7684\u987a\u5e8f\uff1a 0 1 3 3 1 2 V1 V2 V4 V4 V2 V3 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Mesh \u7c7b\u6765\u63a5\u6536\u53e6\u4e00\u4e2a\u53c2\u6570\uff0c\u4e00\u4e2a\u7d22\u5f15\u6570\u7ec4\uff0c\u73b0\u5728\u7ed8\u5236\u7684\u9876\u70b9\u6570\u91cf\u662f\u8be5\u7d22\u5f15\u6570\u7ec4\u7684\u957f\u5ea6\u3002 public Mesh(float[] positions, int[] indices) { vertexCount = indices.length; \u5728\u521b\u5efa\u4e86\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\u6765\u50a8\u5b58\u7d22\u5f15\u3002\u56e0\u6b64\uff0c\u91cd\u547d\u540d\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u7684ID\u7684\u53d8\u91cf\u540d\uff0c\u5e76\u4e3a\u7d22\u5f15VBO\uff08 idxVboId \uff09\u521b\u5efa\u4e00\u4e2aID\u3002\u521b\u5efaVBO\u7684\u8fc7\u7a0b\u76f8\u4f3c\uff0c\u4f46\u73b0\u5728\u7684\u7c7b\u578b\u662f GL_ELEMENT_ARRAY_BUFFER \u3002 idxVboId = glGenBuffers(); indicesBuffer = MemoryUtil.memAllocInt(indices.length); indicesBuffer.put(indices).flip(); glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, idxVboId); glBufferData(GL_ELEMENT_ARRAY_BUFFER, indicesBuffer, GL_STATIC_DRAW); memFree(indicesBuffer); \u56e0\u4e3a\u6211\u4eec\u662f\u5728\u5904\u7406\u6574\u6570\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a IntBuffer \u800c\u4e0d\u662f\u4e00\u4e2a FloatBuffer \u3002 \u5c31\u662f\u8fd9\u6837\u3002\u73b0\u5728VAO\u5305\u542b\u4e24\u4e2aVBO\uff0c\u4e00\u4e2a\u50a8\u5b58\u4f4d\u7f6e\uff0c\u53e6\u4e00\u4e2a\u50a8\u5b58\u7d22\u5f15\u3002 Mesh \u7c7b\u7684 cleanUp \u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8981\u91ca\u653e\u53e6\u4e00\u4e2aVBO\u3002 public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664 VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(posVboId); glDeleteBuffers(idxVboId); // \u5220\u9664 VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5728\u7ed8\u5236\u65f6\u8c03\u7528\u7684 glDrawArrays \u65b9\u6cd5\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); \u6539\u4e3a\u8c03\u7528 glDrawElements \u65b9\u6cd5\uff1a glDrawElements(GL_TRIANGLES, mesh.getVertexCount(), GL_UNSIGNED_INT, 0); \u65b9\u6cd5\u7684\u53c2\u6570\u5982\u4e0b\uff1a * mode: \u6307\u5b9a\u6e32\u67d3\u7684\u56fe\u5143\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u4e09\u89d2\u5f62\uff0c\u6ca1\u6709\u53d8\u5316\u3002 * count: \u6307\u5b9a\u8981\u6e32\u67d3\u7684\u9876\u70b9\u6570\u3002 * type: \u6307\u5b9a\u7d22\u5f15\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u65e0\u7b26\u53f7\u6574\u6570\u578b\u3002 * indices: \u6307\u5b9a\u8981\u5f00\u59cb\u4f7f\u7528\u7d22\u5f15\u6e32\u67d3\u7684\u6570\u636e\u504f\u79fb\u91cf\u3002 \u73b0\u5728\u53ef\u4ee5\u4f7f\u7528\u5168\u65b0\u548c\u66f4\u6709\u6548\u7684\u65b9\u6cd5\u6765\u7ed8\u5236\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4ec5\u9700\u6307\u5b9a\u7d22\u5f15\u3002 public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; int[] indices = new int[]{ 0, 1, 3, 3, 1, 2, }; mesh = new Mesh(positions, indices); } \u73b0\u5728\u4e3a\u793a\u4f8b\u4ee3\u7801\u6dfb\u52a0\u989c\u8272\u5427\u3002\u6211\u4eec\u628a\u53e6\u4e00\u7ec4\u6d6e\u70b9\u6570\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u5b83\u50a8\u5b58\u4e86\u6b63\u65b9\u5f62\u4e2d\u6bcf\u4e2a\u9876\u70b9\u7684\u989c\u8272\u3002 public Mesh(float[] positions, float[] colours, int[] indices) { \u4e3a\u4e86\u4f7f\u7528\u8be5\u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\uff0c\u5b83\u5c06\u4e0e\u6211\u4eec\u7684VAO\u76f8\u5173\u8054\u3002 // \u989c\u8272 VBO colourVboId = glGenBuffers(); FloatBuffer colourBuffer = memAllocFloat(colours.length); colourBuffer.put(colours).flip(); glBindBuffer(GL_ARRAY_BUFFER, colourVboId); glBufferData(GL_ARRAY_BUFFER, colourBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 3, GL_FLOAT, false, 0, 0); \u8bf7\u6ce8\u610f glVertexAttribPointer \u65b9\u6cd5\u7684\u8c03\u7528\uff0c\u7b2c\u4e00\u4e2a\u53c2\u6570\u73b0\u5728\u662f\u201c1\u201d\uff0c\u8fd9\u662f\u7740\u8272\u5668\u671f\u671b\u6570\u636e\u7684\u4f4d\u7f6e\u3002\uff08\u5f53\u7136\uff0c\u7531\u4e8e\u589e\u52a0\u4e86\u4e00\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u5728 cleanUp \u65b9\u6cd5\u4e2d\u91ca\u653e\u5b83\uff09\u3002\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u9700\u8981\u5728\u6e32\u67d3\u671f\u95f4\u542f\u7528\u4f4d\u7f6e1\u5904\u7684VAO\u5c5e\u6027\u3002 \u63a5\u4e0b\u6765\u662f\u4fee\u6539\u7740\u8272\u5668\u3002\u9876\u70b9\u7740\u8272\u5668\u73b0\u5728\u9700\u8981\u4e24\u4e2a\u53c2\u6570\uff0c\u5750\u6807\uff08\u4f4d\u7f6e0\uff09\u548c\u989c\u8272\uff08\u4f4d\u7f6e1\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c06\u53ea\u8f93\u51fa\u63a5\u6536\u5230\u7684\u989c\u8272\uff0c\u4ee5\u4fbf\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u5bf9\u5176\u8fdb\u884c\u5904\u7406\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; void main() { gl_Position = vec4(position, 1.0); exColour = inColour; } \u73b0\u5728\uff0c\u7247\u5143\u7740\u8272\u5668\u63a5\u6536\u7531\u9876\u70b9\u7740\u8272\u5668\u5904\u7406\u7684\u989c\u8272\uff0c\u5e76\u4f7f\u7528\u5b83\u6765\u751f\u6210\u989c\u8272\u3002 #version 330 in vec3 exColour; out vec4 fragColor; void main() { fragColor = vec4(exColour, 1.0); } \u6700\u540e\u8981\u505a\u7684\u662f\u4fee\u6539\u6e32\u67d3\u4ee3\u7801\u4ee5\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6570\u636e\u6570\u7ec4\uff1a \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5c06\u5982\u4e0b\u6240\u793a\u7684\u989c\u8272\u6570\u7ec4\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u4e3a\u6b63\u65b9\u5f62\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u7136\u540e\u4f1a\u5f97\u5230\u4e00\u4e2a\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002","title":"\u6e32\u67d3\u8865\u5145"},{"location":"05-more-on-rendering/#more-on-rendering","text":"\u672c\u7ae0\u6211\u4eec\u5c06\u7ee7\u7eed\u8bb2\u8ff0OpenGL\u5982\u4f55\u6e32\u67d3\u7269\u4f53\u3002\u4e3a\u4e86\u6574\u7406\u4ee3\u7801\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Mesh \u7684\u65b0\u7c7b\uff0c\u628a\u4e00\u4e2a\u4f4d\u7f6e\u6570\u7ec4\u4f5c\u4e3a\u8f93\u5165\uff0c\u4e3a\u9700\u8981\u52a0\u8f7d\u5230\u663e\u5361\u4e2d\u7684\u6a21\u578b\u521b\u5efaVBO\u548cVAO\u5bf9\u8c61\u3002 package org.lwjglb.engine.graph; import java.nio.FloatBuffer; import org.lwjgl.system.MemoryUtil; import static org.lwjgl.opengl.GL30.*; public class Mesh { private final int vaoId; private final int vboId; private final int vertexCount; public Mesh(float[] positions) { FloatBuffer verticesBuffer = null; try { verticesBuffer = MemoryUtil.memAllocFloat(positions.length); vertexCount = positions.length / 3; verticesBuffer.put(positions).flip(); vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); glBindBuffer(GL_ARRAY_BUFFER, 0); glBindVertexArray(0); } finally { if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } } } public int getVaoId() { return vaoId; } public int getVertexCount() { return vertexCount; } public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } } \u6211\u4eec\u5c06\u5728 DummyGame \u7c7b\u4e2d\u5b9e\u4f8b\u5316 Mesh \uff0c\u7136\u540e\u5c06 Renderer \u7684 init \u65b9\u6cd5\u4e2d\u7684VAO\u548cVBO\u4ee3\u7801\u5220\u9664\u3002\u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\u5c06\u63a5\u6536\u4e00\u4e2a Mesh \u5bf9\u8c61\u6765\u6e32\u67d3\u3002 cleanup \u65b9\u6cd5\u4e5f\u88ab\u7b80\u5316\uff0c\u56e0\u4e3a Mesh \u7c7b\u5df2\u7ecf\u63d0\u4f9b\u4e86\u4e00\u4e2a\u91ca\u653eVAO\u548cVBO\u8d44\u6e90\u7684\u65b9\u6cd5\u3002 public void render(Mesh mesh) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed8\u5236 glBindVertexArray(mesh.getVaoId()); glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } } \u503c\u5f97\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); Mesh \u7c7b\u901a\u8fc7\u5c06\u4f4d\u7f6e\u6570\u7ec4\u9664\u4ee53\u6765\u8ba1\u7b97\u9876\u70b9\u7684\u6570\u76ee\uff08\u56e0\u4e3a\u6211\u4eec\u4f7f\u7528X\uff0cY\u548cZ\u5750\u6807\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u66f4\u590d\u6742\u7684\u5f62\u72b6\u3002\u6765\u8bd5\u8bd5\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4e00\u4e2a\u6b63\u65b9\u5f62\u53ef\u4ee5\u7528\u4e24\u4e2a\u4e09\u89d2\u5f62\u6765\u7ec4\u6210\uff0c\u5982\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u4e2d\u7684\u6bcf\u4e00\u4e2a\u90fd\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V1\u3001V2\u548cV4\uff08\u6a59\u8272\u7684\u70b9\uff09\u7ec4\u6210\uff0c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V4\uff0cV2\u548cV3\uff08\u7eff\u8272\u7684\u70b9\uff09\u7ec4\u6210\u3002\u9876\u70b9\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u8fde\u63a5\uff0c\u56e0\u6b64\u8981\u4f20\u9012\u7684\u6d6e\u70b9\u6570\u6570\u7ec4\u5e94\u8be5\u662f[V1, V2, V4, V4, V2, V3]\u3002\u56e0\u6b64\uff0c DummyGame \u7684 init \u65b9\u6cd5\u5c06\u662f\u8fd9\u6837\u7684\uff1a @Override public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, 0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, }; mesh = new Mesh(positions); } \u73b0\u5728\u4f60\u5e94\u8be5\u53ef\u4ee5\u770b\u5230\u8fd9\u6837\u7684\u4e00\u4e2a\u6b63\u65b9\u5f62\uff1a \u6211\u4eec\u505a\u5b8c\u4e86\u5417\uff1f\u5e76\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4ecd\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u6211\u4eec\u4f7f\u7528\u4e86\u91cd\u590d\u7684\u5750\u6807\u6765\u8868\u793a\u6b63\u65b9\u5f62\uff0c\u4f20\u9012\u4e86\u4e24\u6b21V2\u548cV4\u5750\u6807\u3002\u8fd9\u662f\u4e2a\u5c0f\u56fe\u5f62\uff0c\u5b83\u53ef\u80fd\u4e0d\u662f\u4ec0\u4e48\u5927\u95ee\u9898\uff0c\u4f46\u60f3\u8c61\u5728\u4e00\u4e2a\u66f4\u590d\u6742\u76843D\u6a21\u578b\u4e2d\uff0c\u6211\u4eec\u4f1a\u591a\u6b21\u91cd\u590d\u4f20\u9012\u5750\u6807\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u4e2a\u6d6e\u70b9\u6570\u8868\u793a\u9876\u70b9\u7684\u4f4d\u7f6e\uff0c\u4f46\u6b64\u540e\u5c06\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u6765\u8868\u793a\u7eb9\u7406\u7b49\u3002\u8003\u8651\u5230\u5728\u66f4\u590d\u6742\u7684\u5f62\u72b6\u4e2d\uff0c\u4e09\u89d2\u5f62\u76f4\u63a5\u5171\u4eab\u7684\u9876\u70b9\u6570\u91cf\u751a\u81f3\u66f4\u9ad8\uff0c\u5982\u56fe\u6240\u793a\uff08\u5176\u9876\u70b9\u53ef\u4ee5\u5728\u516d\u4e2a\u4e09\u89d2\u5f62\u4e4b\u95f4\u5171\u4eab\uff09\uff1a \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u66f4\u591a\u7684\u5185\u5b58\u6765\u50a8\u5b58\u91cd\u590d\u7684\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\u5927\u663e\u8eab\u624b\u7684\u65f6\u5019\u3002\u4e3a\u4e86\u7ed8\u5236\u6b63\u65b9\u5f62\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4ee5\u8fd9\u6837\u7684\u65b9\u5f0f\u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\uff1aV1, V2, V3, V4\u3002\u6bcf\u4e2a\u9876\u70b9\u5728\u6570\u7ec4\u4e2d\u90fd\u6709\u4e00\u4e2a\u4f4d\u7f6e\u3002V1\u5728\u4f4d\u7f6e0\u4e0a\uff0cV2\u5728\u4f4d\u7f6e1\u4e0a\uff0c\u7b49\u7b49\uff1a V1 V2 V3 V4 0 1 2 3 \u7136\u540e\uff0c\u6211\u4eec\u901a\u8fc7\u5f15\u7528\u5b83\u4eec\u7684\u4f4d\u7f6e\u6765\u6307\u5b9a\u8fd9\u4e9b\u9876\u70b9\u7684\u987a\u5e8f\uff1a 0 1 3 3 1 2 V1 V2 V4 V4 V2 V3 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Mesh \u7c7b\u6765\u63a5\u6536\u53e6\u4e00\u4e2a\u53c2\u6570\uff0c\u4e00\u4e2a\u7d22\u5f15\u6570\u7ec4\uff0c\u73b0\u5728\u7ed8\u5236\u7684\u9876\u70b9\u6570\u91cf\u662f\u8be5\u7d22\u5f15\u6570\u7ec4\u7684\u957f\u5ea6\u3002 public Mesh(float[] positions, int[] indices) { vertexCount = indices.length; \u5728\u521b\u5efa\u4e86\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\u6765\u50a8\u5b58\u7d22\u5f15\u3002\u56e0\u6b64\uff0c\u91cd\u547d\u540d\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u7684ID\u7684\u53d8\u91cf\u540d\uff0c\u5e76\u4e3a\u7d22\u5f15VBO\uff08 idxVboId \uff09\u521b\u5efa\u4e00\u4e2aID\u3002\u521b\u5efaVBO\u7684\u8fc7\u7a0b\u76f8\u4f3c\uff0c\u4f46\u73b0\u5728\u7684\u7c7b\u578b\u662f GL_ELEMENT_ARRAY_BUFFER \u3002 idxVboId = glGenBuffers(); indicesBuffer = MemoryUtil.memAllocInt(indices.length); indicesBuffer.put(indices).flip(); glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, idxVboId); glBufferData(GL_ELEMENT_ARRAY_BUFFER, indicesBuffer, GL_STATIC_DRAW); memFree(indicesBuffer); \u56e0\u4e3a\u6211\u4eec\u662f\u5728\u5904\u7406\u6574\u6570\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a IntBuffer \u800c\u4e0d\u662f\u4e00\u4e2a FloatBuffer \u3002 \u5c31\u662f\u8fd9\u6837\u3002\u73b0\u5728VAO\u5305\u542b\u4e24\u4e2aVBO\uff0c\u4e00\u4e2a\u50a8\u5b58\u4f4d\u7f6e\uff0c\u53e6\u4e00\u4e2a\u50a8\u5b58\u7d22\u5f15\u3002 Mesh \u7c7b\u7684 cleanUp \u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8981\u91ca\u653e\u53e6\u4e00\u4e2aVBO\u3002 public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664 VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(posVboId); glDeleteBuffers(idxVboId); // \u5220\u9664 VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5728\u7ed8\u5236\u65f6\u8c03\u7528\u7684 glDrawArrays \u65b9\u6cd5\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); \u6539\u4e3a\u8c03\u7528 glDrawElements \u65b9\u6cd5\uff1a glDrawElements(GL_TRIANGLES, mesh.getVertexCount(), GL_UNSIGNED_INT, 0); \u65b9\u6cd5\u7684\u53c2\u6570\u5982\u4e0b\uff1a * mode: \u6307\u5b9a\u6e32\u67d3\u7684\u56fe\u5143\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u4e09\u89d2\u5f62\uff0c\u6ca1\u6709\u53d8\u5316\u3002 * count: \u6307\u5b9a\u8981\u6e32\u67d3\u7684\u9876\u70b9\u6570\u3002 * type: \u6307\u5b9a\u7d22\u5f15\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u65e0\u7b26\u53f7\u6574\u6570\u578b\u3002 * indices: \u6307\u5b9a\u8981\u5f00\u59cb\u4f7f\u7528\u7d22\u5f15\u6e32\u67d3\u7684\u6570\u636e\u504f\u79fb\u91cf\u3002 \u73b0\u5728\u53ef\u4ee5\u4f7f\u7528\u5168\u65b0\u548c\u66f4\u6709\u6548\u7684\u65b9\u6cd5\u6765\u7ed8\u5236\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4ec5\u9700\u6307\u5b9a\u7d22\u5f15\u3002 public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; int[] indices = new int[]{ 0, 1, 3, 3, 1, 2, }; mesh = new Mesh(positions, indices); } \u73b0\u5728\u4e3a\u793a\u4f8b\u4ee3\u7801\u6dfb\u52a0\u989c\u8272\u5427\u3002\u6211\u4eec\u628a\u53e6\u4e00\u7ec4\u6d6e\u70b9\u6570\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u5b83\u50a8\u5b58\u4e86\u6b63\u65b9\u5f62\u4e2d\u6bcf\u4e2a\u9876\u70b9\u7684\u989c\u8272\u3002 public Mesh(float[] positions, float[] colours, int[] indices) { \u4e3a\u4e86\u4f7f\u7528\u8be5\u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\uff0c\u5b83\u5c06\u4e0e\u6211\u4eec\u7684VAO\u76f8\u5173\u8054\u3002 // \u989c\u8272 VBO colourVboId = glGenBuffers(); FloatBuffer colourBuffer = memAllocFloat(colours.length); colourBuffer.put(colours).flip(); glBindBuffer(GL_ARRAY_BUFFER, colourVboId); glBufferData(GL_ARRAY_BUFFER, colourBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 3, GL_FLOAT, false, 0, 0); \u8bf7\u6ce8\u610f glVertexAttribPointer \u65b9\u6cd5\u7684\u8c03\u7528\uff0c\u7b2c\u4e00\u4e2a\u53c2\u6570\u73b0\u5728\u662f\u201c1\u201d\uff0c\u8fd9\u662f\u7740\u8272\u5668\u671f\u671b\u6570\u636e\u7684\u4f4d\u7f6e\u3002\uff08\u5f53\u7136\uff0c\u7531\u4e8e\u589e\u52a0\u4e86\u4e00\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u5728 cleanUp \u65b9\u6cd5\u4e2d\u91ca\u653e\u5b83\uff09\u3002\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u9700\u8981\u5728\u6e32\u67d3\u671f\u95f4\u542f\u7528\u4f4d\u7f6e1\u5904\u7684VAO\u5c5e\u6027\u3002 \u63a5\u4e0b\u6765\u662f\u4fee\u6539\u7740\u8272\u5668\u3002\u9876\u70b9\u7740\u8272\u5668\u73b0\u5728\u9700\u8981\u4e24\u4e2a\u53c2\u6570\uff0c\u5750\u6807\uff08\u4f4d\u7f6e0\uff09\u548c\u989c\u8272\uff08\u4f4d\u7f6e1\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c06\u53ea\u8f93\u51fa\u63a5\u6536\u5230\u7684\u989c\u8272\uff0c\u4ee5\u4fbf\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u5bf9\u5176\u8fdb\u884c\u5904\u7406\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; void main() { gl_Position = vec4(position, 1.0); exColour = inColour; } \u73b0\u5728\uff0c\u7247\u5143\u7740\u8272\u5668\u63a5\u6536\u7531\u9876\u70b9\u7740\u8272\u5668\u5904\u7406\u7684\u989c\u8272\uff0c\u5e76\u4f7f\u7528\u5b83\u6765\u751f\u6210\u989c\u8272\u3002 #version 330 in vec3 exColour; out vec4 fragColor; void main() { fragColor = vec4(exColour, 1.0); } \u6700\u540e\u8981\u505a\u7684\u662f\u4fee\u6539\u6e32\u67d3\u4ee3\u7801\u4ee5\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6570\u636e\u6570\u7ec4\uff1a \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5c06\u5982\u4e0b\u6240\u793a\u7684\u989c\u8272\u6570\u7ec4\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u4e3a\u6b63\u65b9\u5f62\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u7136\u540e\u4f1a\u5f97\u5230\u4e00\u4e2a\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002","title":"\u6e32\u67d3\u8865\u5145\uff08More on Rendering\uff09"},{"location":"06-transformations/","text":"\u53d8\u6362\uff08Transformations\uff09 \u6295\u5f71 \u8ba9\u6211\u4eec\u56de\u770b\u5728\u524d\u4e00\u7ae0\u4e2d\u521b\u5efa\u7684\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002\u5982\u679c\u4ed4\u7ec6\u770b\uff0c\u5b83\u66f4\u50cf\u4e00\u4e2a\u77e9\u5f62\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u5c06\u7a97\u53e3\u7684\u5bbd\u5ea6\u4ece600\u50cf\u7d20\u6539\u4e3a900\u50cf\u7d20\uff0c\u5931\u771f\u5c31\u4f1a\u66f4\u52a0\u660e\u663e\u3002\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\u5462\uff1f \u5982\u679c\u4f60\u67e5\u770b\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u6211\u4eec\u53ea\u662f\u76f4\u63a5\u5730\u4f20\u9012\u5750\u6807\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5f53\u4e00\u4e2a\u9876\u70b9\u7684X\u5750\u6807\u4e3a0.5\u65f6\uff0c\u6211\u4eec\u8ba9OpenGL\u5728\u5c4f\u5e55\u7684X\u5750\u6807\u4e3a0.5\u7684\u4f4d\u7f6e\u7ed8\u5236\u5b83\u3002\u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08\u4ec5\u542bX\u548cY\u8f74\uff09\u3002 \u5c06\u8fd9\u4e9b\u5750\u6807\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807\u7cfb\uff08\u5176\u539f\u70b9\u4f4d\u4e8e\u4e0a\u56fe\u7684\u5de6\u4e0a\u89d2\uff09\uff0c\u9700\u8981\u8003\u8651\u5230\u7a97\u53e3\u7684\u5927\u5c0f\u3002\u56e0\u6b64\uff0c\u5982\u679c\u6211\u4eec\u7684\u7a97\u53e3\u5927\u5c0f\u4e3a900x480\uff0cOpenGL\u5750\u6807(1, 0)\u5c06\u88ab\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807(900, 0)\uff0c\u6700\u7ec8\u521b\u5efa\u4e00\u4e2a\u77e9\u5f62\u800c\u4e0d\u662f\u4e00\u4e2a\u6b63\u65b9\u5f62\u3002 \u4f46\u662f\uff0c\u95ee\u9898\u8fdc\u6bd4\u8fd9\u66f4\u4e25\u91cd\u3002\u5c06\u56db\u8fb9\u5f62\u7684Z\u5750\u6807\u4ece0.0\u4fee\u6539\u4e3a1.0\u548c-1.0\uff0c\u4f60\u53d1\u73b0\u4e86\u4ec0\u4e48\uff1f\u56db\u8fb9\u5f62\u5b8c\u5168\u662f\u7ed8\u5236\u5728\u540c\u4e00\u4e2a\u5730\u65b9\uff0c\u4e0d\u7ba1\u5b83\u662f\u5426\u6cbf\u7740Z\u8f74\u4f4d\u79fb\u3002\u4e3a\u4ec0\u4e48\u4f1a\u53d1\u751f\u8fd9\u79cd\u60c5\u51b5\uff1f\u8fdc\u5904\u7684\u7269\u4f53\u5e94\u8be5\u6bd4\u8fd1\u5904\u7684\u7269\u4f53\u7ed8\u5236\u5f97\u66f4\u5c0f\uff0c\u4f46\u662f\u6211\u4eec\u4f7f\u7528\u76f8\u540c\u7684X\u548cY\u5750\u6807\u7ed8\u5236\u5b83\u4eec\u3002 \u4f46\u7a0d\u7b49\u4e00\u4e0b\uff0c\u8fd9\u4e0d\u5e94\u8be5\u7531Z\u5750\u6807\u6765\u5904\u7406\u5417\uff1f\u8fd9\u534a\u5bf9\u534a\u9519\u3002Z\u5750\u6807\u544a\u8bc9OpenGL\u4e00\u4e2a\u7269\u4f53\u7684\u8fdc\u8fd1\uff0c\u4f46\u662fOpenGL\u5bf9\u4f60\u7684\u7269\u4f53\u7684\u5927\u5c0f\u4e00\u65e0\u6240\u77e5\u3002\u4f60\u53ef\u4ee5\u6709\u4e24\u4e2a\u4e0d\u540c\u5927\u5c0f\u7684\u7269\u4f53\uff0c\u4e00\u4e2a\u66f4\u8fd1\u66f4\u5c0f\uff0c\u4e00\u4e2a\u66f4\u8fdc\u66f4\u5927\uff0c\u800c\u4e14\u53ef\u4ee5\u4ee5\u76f8\u540c\u7684\u5927\u5c0f\u6b63\u786e\u5730\u6295\u5f71\u5230\u5c4f\u5e55\u4e0a\uff08\u6709\u76f8\u540c\u7684\u5c4f\u5e55X\u548cY\u5750\u6807\uff0c\u4f46Z\u5750\u6807\u4e0d\u540c\uff09\u3002OpenGL\u53ea\u4f7f\u7528\u6b63\u5728\u4f20\u9012\u7684\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\u3002 \u65e2\u7136\u5df2\u7ecf\u786e\u8bca\u4e86\u8fd9\u4e2a\u95ee\u9898\uff0c\u8be5\u600e\u4e48\u89e3\u51b3\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\u6216\u622a\u9525\u4f53\uff08Frustum\uff09\u3002\u6295\u5f71\u77e9\u9635\u5c06\u5904\u7406\u7ed8\u5236\u533a\u57df\u7684\u5bbd\u9ad8\u6bd4\uff08\u5927\u5c0f\u4e0e\u9ad8\u5ea6\u4e4b\u95f4\u7684\u5173\u7cfb\uff09\uff0c\u8fd9\u6837\u7269\u4f53\u5c31\u4e0d\u4f1a\u53d8\u5f62\u3002\u5b83\u8fd8\u53ef\u4ee5\u5904\u7406\u8ddd\u79bb\uff0c\u6240\u4ee5\u8f83\u8fdc\u7684\u7269\u4f53\u5c06\u4f1a\u88ab\u7ed8\u5236\u5f97\u66f4\u5c0f\u3002\u6295\u5f71\u77e9\u9635\u8fd8\u5c06\u8003\u8651\u6211\u4eec\u7684\u89c6\u91ce\u548c\u5e94\u8be5\u663e\u793a\u7684\u8ddd\u79bb\u6709\u591a\u8fdc\u3002 \u5bf9\u4e8e\u4e0d\u719f\u6089\u77e9\u9635\u7684\u4eba\uff0c\u77e9\u9635\uff08Matrix\uff09\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\u3002\u77e9\u9635\u4e2d\u7684\u6bcf\u4e2a\u6570\u5b57\u88ab\u79f0\u4e3a\u5143\u7d20\u3002\u77e9\u9635\u9636\u6b21\u662f\u884c\u548c\u5217\u7684\u6570\u91cf\u3002\u4f8b\u5982\uff0c\u6b64\u5904\u662f\u4e00\u4e2a2x2\u77e9\u9635\uff08\u67092\u884c2\u5217\uff09\u3002 \u77e9\u9635\u6709\u8bb8\u591a\u53ef\u4ee5\u5e94\u7528\u4e8e\u5b83\u4eec\u7684\u57fa\u672c\u8fd0\u7b97\uff08\u5982\u52a0\u6cd5\u3001\u4e58\u6cd5\u7b49\uff09\uff0c\u4f60\u53ef\u4ee5\u5728\u6570\u5b66\u4e66\u4e2d\u67e5\u9605\uff0c\u5176\u4e2d\u4e0e\u4e09\u7ef4\u56fe\u5f62\u76f8\u5173\u7684\u77e9\u9635\u5bf9\u7a7a\u95f4\u4e2d\u70b9\u7684\u53d8\u6362\u975e\u5e38\u6709\u7528\u3002 \u4f60\u53ef\u4ee5\u628a\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u6210\u4e00\u4e2a\u6444\u50cf\u673a\uff0c\u5b83\u6709\u4e00\u4e2a\u89c6\u91ce\u548c\u6700\u5c0f\u548c\u6700\u5927\u8ddd\u79bb\u3002\u8be5\u6444\u50cf\u673a\u7684\u53ef\u89c6\u533a\u57df\u662f\u4e00\u4e2a\u622a\u65ad\u7684\u91d1\u5b57\u5854\uff0c\u4e0b\u56fe\u4e3a\u8be5\u533a\u57df\u7684\u4fef\u89c6\u56fe\u3002 \u6295\u5f71\u77e9\u9635\u5c06\u6b63\u786e\u5730\u6295\u5f71\u4e09\u7ef4\u5750\u6807\uff0c\u4ee5\u4fbf\u5b83\u4eec\u80fd\u591f\u5728\u4e8c\u7ef4\u5c4f\u5e55\u4e0a\u6b63\u786e\u5730\u663e\u793a\u3002\u8be5\u77e9\u9635\u7684\u6570\u5b66\u8868\u793a\u5982\u4e0b\uff08\u4e0d\u8981\u5bb3\u6015\uff09\uff1a \u5176\u4e2d\u5c4f\u5e55\u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\u6307\u7684\u662f\u5c4f\u5e55\u5bbd\u5ea6\u4e0e\u5c4f\u5e55\u9ad8\u5ea6\u7684\u5173\u7cfb\uff08 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4=\u5bbd\u5ea6/\u9ad8\u5ea6 \uff09\u3002\u4e3a\u4e86\u83b7\u5f97\u7ed9\u5b9a\u70b9\u7684\u6295\u5f71\u5750\u6807\uff0c\u53ea\u9700\u8981\u5c06\u6295\u5f71\u77e9\u9635\u4e58\u4ee5\u539f\u59cb\u5750\u6807\uff0c\u7ed3\u679c\u662f\u6295\u5f71\u540e\u7684\u53e6\u4e00\u4e2a\u5411\u91cf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u4e00\u7ec4\u6570\u5b66\u5b9e\u4f53\uff0c\u5982\u5411\u91cf\u3001\u77e9\u9635\uff0c\u5e76\u5305\u62ec\u53ef\u4ee5\u5bf9\u5b83\u4eec\u8fdb\u884c\u7684\u8fd0\u7b97\u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4ece\u5934\u5f00\u59cb\u7f16\u5199\u6240\u6709\u7684\u4ee3\u7801\uff0c\u6216\u8005\u4f7f\u7528\u5df2\u5b9e\u73b0\u7684\u5e93\u3002\u5f53\u7136\u6211\u4eec\u4f1a\u9009\u62e9\u5bb9\u6613\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528JOML\uff08Java OpenGL Math Library\uff0cJava OpenGL \u6570\u5b66\u5e93\uff09\u5904\u7406LWJGL\u5185\u7684\u6570\u5b66\u8fd0\u7b97\u3002\u4e3a\u4e86\u4f7f\u7528\u8be5\u5e93\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 pom.xml \u6587\u4ef6\u6dfb\u52a0\u53e6\u4e00\u4e2a\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.joml</groupId> <artifactId>joml</artifactId> <version>${joml.version}</version> </dependency> \u7136\u540e\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u5e93\u7248\u672c\u3002 <properties> [...] <joml.version>1.9.6</joml.version> [...] </properties> \u73b0\u5728\u4e00\u5207\u90fd\u51c6\u5907\u597d\u4e86\uff0c\u6765\u5b9a\u4e49\u6211\u4eec\u7684\u6295\u5f71\u77e9\u9635\u3002\u5728 Renderer \u7c7b\u4e2d\u521b\u5efa Matrix4f \u7c7b\uff08\u7531JOML\u5e93\u63d0\u4f9b\uff09\u7684\u5b9e\u4f8b\u3002 Matrix4f \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a perspective \u65b9\u6cd5\u6765\u521b\u5efa\u6295\u5f71\u77e9\u9635\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u4ee5\u4e0b\u53c2\u6570\uff1a \u89c6\u91ce\uff1a\u53ef\u89c6\u533a\u57df\u89d2\u7684\u5f27\u5ea6\u5927\u5c0f\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u8be5\u503c\u7684\u5e38\u6570\u3002 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4\u3002 \u6700\u8fd1\u89c6\u8ddd\uff08z-near\uff09\u3002 \u6700\u8fdc\u89c6\u8ddd\uff08z-far\uff09\u3002 \u6211\u4eec\u5c06\u5728 init \u65b9\u6cd5\u4e2d\u5b9e\u4f8b\u5316\u8be5\u77e9\u9635\uff0c\u56e0\u6b64\u9700\u8981\u4f20\u9012\u5bf9 Window \u5b9e\u4f8b\u7684\u9634\u5f71\u4ee5\u83b7\u53d6\u7a97\u53e3\u5927\u5c0f\uff08\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u4ee3\u7801\u5982\u4e0b\uff1a /** * \u89c6\u91ce\u5f27\u5ea6 */ private static final float FOV = (float) Math.toRadians(60.0f); private static final float Z_NEAR = 0.01f; private static final float Z_FAR = 1000.f; private Matrix4f projectionMatrix; \u6295\u5f71\u77e9\u9635\u7684\u521b\u5efa\u5982\u4e0b\u6240\u793a\uff1a float aspectRatio = (float) window.getWidth() / window.getHeight(); projectionMatrix = new Matrix4f().perspective(FOV, aspectRatio, Z_NEAR, Z_FAR); \u73b0\u5728\u6211\u4eec\u7701\u7565\u5bbd\u9ad8\u6bd4\u53ef\u53d8\u7684\u60c5\u51b5\uff08\u901a\u8fc7\u8c03\u6574\u7a97\u53e3\u5927\u5c0f\uff09\uff0c\u8fd9\u53ef\u4ee5\u5728 render \u65b9\u6cd5\u4e2d\u68c0\u67e5\u5e76\u76f8\u5e94\u5730\u6539\u53d8\u6295\u5f71\u77e9\u9635\u3002 \u73b0\u5728\u6709\u4e86\u77e9\u9635\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\uff0c\u5e76\u4e14\u5b83\u5e94\u8be5\u88ab\u5e94\u7528\u5230\u6240\u6709\u9876\u70b9\u4e0a\u3002\u9996\u5148\uff0c\u4f60\u53ef\u80fd\u4f1a\u60f3\u5230\u628a\u5b83\u6346\u7ed1\u5728\u9876\u70b9\u8f93\u5165\u4e2d\uff08\u5c31\u50cf\u5750\u6807\u548c\u989c\u8272\u90a3\u6837\uff09\u3002\u4f46\u8fd9\u6837\uff0c\u6211\u4eec\u4f1a\u6d6a\u8d39\u5f88\u591a\u7a7a\u95f4\uff0c\u56e0\u4e3a\u6295\u5f71\u77e9\u9635\u5728\u51e0\u6b21\u6e32\u67d3\u671f\u95f4\u90fd\u4e0d\u4f1a\u53d1\u751f\u6539\u53d8\u3002\u4f60\u53ef\u80fd\u8fd8\u60f3\u5728Java\u4ee3\u7801\u4e2d\u7528\u77e9\u9635\u5904\u7406\u6240\u6709\u9876\u70b9\uff0c\u4f46\u8fd9\u6837\u6211\u4eec\u8f93\u5165\u7684VBO\u5c31\u662f\u6ca1\u7528\u7684\u4e86\uff0c\u8fd9\u6837\u5c31\u4e0d\u80fd\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u5904\u7406\u5668\u8d44\u6e90\u4e86\u3002 \u7b54\u6848\u662f\u4f7f\u7528\u201c uniform \u201d\u3002Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4e0e\u7740\u8272\u5668\u4ea4\u6d41\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u5e76\u58f0\u660e\u4e00\u4e2a\u65b0\u7684\u540d\u4e3a projectionMatrix \u7684Uniform\uff0c\u5e76\u7528\u5b83\u6765\u8ba1\u7b97\u6295\u5f71\u540e\u7684\u4f4d\u7f6e\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u628a projectionMatrix \u5b9a\u4e49\u4e3a\u4e00\u4e2a4x4\u7684\u77e9\u9635\uff0c\u65b0\u7684\u5750\u6807\u662f\u901a\u8fc7\u628a\u5b83\u4e0e\u539f\u59cb\u5750\u6807\u76f8\u4e58\u5f97\u5230\u7684\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u628a\u6295\u5f71\u77e9\u9635\u7684\u503c\u4f20\u9012\u7ed9\u7740\u8272\u5668\uff0c\u9996\u5148\u9700\u8981\u786e\u5b9aUniform\u7684\u4f4d\u7f6e\u3002 \u8fd9\u662f\u901a\u8fc7\u8c03\u7528\u65b9\u6cd5 glGetUniformLocation \u5b9e\u73b0\u7684\uff0c\u5b83\u6709\u4e24\u4e2a\u53c2\u6570\uff1a \u7740\u8272\u5668\u7a0b\u5e8f\u7684ID Uniform\u540d\uff08\u5b83\u5e94\u8be5\u4e0e\u7740\u8272\u5668\u91cc\u5b9a\u4e49\u7684\u540d\u79f0\u76f8\u540c\uff09 \u6b64\u65b9\u6cd5\u8fd4\u56de\u50a8\u5b58Uniform\u4f4d\u7f6e\u7684ID\u3002\u7531\u4e8e\u53ef\u80fd\u6709\u4e00\u4e2a\u4ee5\u4e0a\u7684Uniform\uff0c\u6211\u4eec\u5c06\u628a\u8fd9\u4e9bID\u50a8\u5b58\u5728\u7531\u53d8\u91cf\u540d\u4f5c\u4e3a\u7d22\u5f15\u7684Map\u4e2d\uff08\u6b64\u540e\u6211\u4eec\u9700\u8981\u90a3\u4e2aID\uff09\u3002\u56e0\u6b64\uff0c\u5728 ShaderProgram \u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b57\u6bb5\u6765\u4fdd\u5b58\u8fd9\u4e9bID\uff1a private final Map<String, Integer> uniforms; \u7136\u540e\u7531\u6784\u9020\u65b9\u6cd5\u521d\u59cb\u5316\u5b83\uff1a uniforms = new HashMap<>(); \u6700\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u65b0\u7684Uniform\u548c\u50a8\u5b58\u83b7\u5f97\u7684\u4f4d\u7f6e\u3002 public void createUniform(String uniformName) throws Exception { int uniformLocation = glGetUniformLocation(programId, uniformName); if (uniformLocation < 0) { throw new Exception(\"Could not find uniform:\" + uniformName); } uniforms.put(uniformName, uniformLocation); } \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7a0b\u5e8f\u7f16\u8bd1\u540e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u8c03\u7528 createUniform \u65b9\u6cd5\uff08\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5728\u6295\u5f71\u77e9\u9635\u5b9e\u4f8b\u5316\u540e\u8c03\u7528\u5b83\uff09\u3002 shaderProgram.createUniform(\"projectionMatrix\"); \u6b64\u65f6\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u4e00\u4e2a\u53ef\u4ee5\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u6570\u636e\u7684\u50a8\u5b58\u5668\u3002\u7531\u4e8e\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u671f\u95f4\u4e0d\u4f1a\u53d8\u5316\uff0c\u6240\u4ee5\u53ef\u4ee5\u5728\u521b\u5efaUniform\u540e\u76f4\u63a5\u8bbe\u7f6e\u503c\uff0c\u4f46\u6211\u4eec\u5c06\u5728 render \u65b9\u6cd5\u4e2d\u505a\u6b64\u4e8b\u3002\u7a0d\u540e\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ef\u4ee5\u91cd\u7528\u8be5Uniform\u6765\u6267\u884c\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e2d\u9700\u8981\u6267\u884c\u7684\u5176\u4ed6\u64cd\u4f5c\u3002 \u6211\u4eec\u5c06\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a setUniform \u7684\u65b9\u6cd5\u6765\u8bbe\u7f6e\u6570\u636e\uff0c\u901a\u8fc7\u4f7f\u7528JOML\u5e93\u63d0\u4f9b\u7684\u5b9e\u7528\u65b9\u6cd5\u5c06\u77e9\u9635\u8f6c\u6362\u4e3a4x4\u7684 FloatBuffer \u5bf9\u8c61\uff0c\u5e76\u5c06\u5b83\u4eec\u53d1\u9001\u5230Uniform\u4e2d\u3002 public void setUniform(String uniformName, Matrix4f value) { // \u8f6c\u50a8\u77e9\u9635\u5230FloatBuffer try (MemoryStack stack = MemoryStack.stackPush()) { FloatBuffer fb = stack.mallocFloat(16); value.get(fb); glUniformMatrix4fv(uniforms.get(uniformName), false, fb); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528\u4e0e\u6b64\u524d\u4e0d\u540c\u7684\u65b9\u5f0f\u521b\u5efa\u7f13\u51b2\u533a\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\uff0c\u5e76\u5c06\u5b83\u4eec\u5206\u914d\u5230\u5806\u6808\u4e0a\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u5f88\u5c0f\uff0c\u5e76\u4e14\u5728\u8be5\u65b9\u6cd5\u4e4b\u5916\u4e0d\u4f1a\u4f7f\u7528\u5b83\u3002\u56e0\u6b64\u6211\u4eec\u4f7f\u7528 MemoryStack \u7c7b\u3002 \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7ed1\u5b9a\u4e4b\u540e\uff0c\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); \u6211\u4eec\u5c31\u8981\u5b8c\u6210\u4e86\uff0c\u73b0\u5728\u53ef\u4ee5\u6b63\u786e\u5730\u6e32\u67d3\u56db\u8fb9\u5f62\uff0c\u6240\u4ee5\u73b0\u5728\u53ef\u4ee5\u542f\u52a8\u7a0b\u5e8f\uff0c\u7136\u540e\u5f97\u5230\u4e00\u4e2a...\u9ed1\u8272\u80cc\u666f\uff0c\u6ca1\u6709\u4efb\u4f55\u5f69\u8272\u56db\u8fb9\u5f62\u3002\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u6211\u4eec\u628a\u4ec0\u4e48\u5f04\u574f\u4e86\u5417\uff1f\u5b9e\u9645\u4e0a\u6ca1\u6709\u4efb\u4f55\u95ee\u9898\u3002\u8bb0\u4f4f\u6211\u4eec\u6b63\u5728\u6a21\u62df\u6444\u50cf\u673a\u89c2\u5bdf\u573a\u666f\u7684\u6548\u679c\u3002\u6211\u4eec\u63d0\u4f9b\u4e86\u4e24\u4e2a\u8ddd\u79bb\uff0c\u4e00\u4e2a\u662f\u6700\u8fdc\u89c6\u8ddd\uff081000f\uff09\u548c\u4e00\u4e2a\u6700\u8fd1\u89c6\u8ddd\uff080.01f\uff09\u3002\u800c\u6211\u4eec\u7684\u5750\u6807\u662f\uff1a float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; \u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5750\u6807\u4e2d\u7684Z\u5750\u6807\u4f4d\u4e8e\u53ef\u89c6\u533a\u57df\u4e4b\u5916\u3002\u5c06\u5b83\u4eec\u8d4b\u503c\u4e3a-0.05f\uff0c\u73b0\u5728\u4f60\u4f1a\u770b\u5230\u50cf\u8fd9\u6837\u7684\u4e00\u4e2a\u5de8\u5927\u7684\u7eff\u8272\u6b63\u65b9\u5f62\uff1a \u8fd9\u662f\u56e0\u4e3a\uff0c\u6211\u4eec\u6b63\u7ed8\u5236\u51fa\u79bb\u6444\u50cf\u673a\u592a\u8fd1\u7684\u6b63\u65b9\u5f62\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u653e\u5927\u5b83\u3002\u5982\u679c\u73b0\u5728\u628a\u4e00\u4e2a -1.05f \u7684\u503c\u8d4b\u503c\u7ed9Z\u5750\u6807\uff0c\u5c31\u53ef\u4ee5\u770b\u5230\u5f69\u8272\u6b63\u65b9\u5f62\u4e86\u3002 \u5982\u679c\u7ee7\u7eed\u5411\u540e\u79fb\u52a8\u56db\u8fb9\u5f62\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u5b83\u53d8\u5c0f\u4e86\u3002\u8fd8\u8981\u6ce8\u610f\u5230\u56db\u8fb9\u5f62\u4e0d\u518d\u50cf\u77e9\u5f62\u4e86\u3002 \u4f7f\u7528\u53d8\u6362 \u56de\u60f3\u4e00\u4e0b\u5230\u76ee\u524d\u4e3a\u6b62\u6211\u4eec\u90fd\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u5df2\u7ecf\u5b66\u4f1a\u4e86\u5982\u4f55\u5c06\u6570\u636e\u4ee5\u6709\u6548\u7684\u683c\u5f0f\u4f20\u9012\u7ed9\u663e\u5361\uff0c\u4ee5\u53ca\u5982\u4f55\u4f7f\u7528\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6765\u6295\u5f71\u8fd9\u4e9b\u9876\u70b9\u5e76\u8bbe\u7f6e\u5b83\u4eec\u7684\u989c\u8272\u3002\u73b0\u5728\u5e94\u8be5\u5f00\u59cb\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7ed8\u5236\u66f4\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4f46\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u80fd\u591f\u52a0\u8f7d\u6a21\u578b\uff0c\u5e76\u5728\u6307\u5b9a\u7684\u4f4d\u7f6e\u4ee5\u9002\u5f53\u7684\u5927\u5c0f\u548c\u6240\u9700\u7684\u65cb\u8f6c\u5c06\u5b83\u6e32\u67d3\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002 \u73b0\u5728\u4e3a\u4e86\u5b9e\u73b0\u8fd9\u6837\u7684\u6e32\u67d3\uff0c\u6211\u4eec\u9700\u8981\u63d0\u4f9b\u4e00\u4e9b\u57fa\u672c\u64cd\u4f5c\u6765\u64cd\u4f5c\u6a21\u578b\uff1a \u4f4d\u79fb\uff08Translation\uff09: \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09: \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09: \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u4e0a\u9762\u7684\u64cd\u4f5c\u7edf\u79f0\u4e3a\u53d8\u6362\uff08Transformation\uff09\u3002\u4f60\u53ef\u80fd\u731c\u5230\u8981\u5b9e\u73b0\u8fd9\u4e00\u70b9\u7684\u65b9\u6cd5\u662f\u628a\u5750\u6807\u4e58\u4ee5\u4e00\u7ec4\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u79fb\u52a8\uff0c\u4e00\u4e2a\u7528\u4e8e\u65cb\u8f6c\uff0c\u4e00\u4e2a\u7528\u4e8e\u7f29\u653e\uff09\u3002\u8fd9\u4e09\u4e2a\u77e9\u9635\u5c06\u88ab\u7ec4\u5408\u6210\u4e00\u4e2a\u79f0\u4e3a\u201c\u4e16\u754c\u77e9\u9635\u201d\u7684\u77e9\u9635\uff0c\u5e76\u4f5c\u4e3a\u4e00\u4e2aUniform\u4f20\u9012\u7ed9\u9876\u70b9\u7740\u8272\u5668\u3002 \u4e4b\u6240\u4ee5\u88ab\u79f0\u4e3a\u4e16\u754c\u77e9\u9635\uff0c\u662f\u56e0\u4e3a\u6211\u4eec\u6b63\u5728\u5c06\u6a21\u578b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002\u5f53\u5b66\u4e60\u52a0\u8f7d3D\u6a21\u578b\u65f6\uff0c\u4f60\u4f1a\u53d1\u73b0\u8fd9\u4e9b\u6a21\u578b\u662f\u5728\u5b83\u4eec\u81ea\u5df1\u7684\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u7684\uff0c\u5b83\u4eec\u4e0d\u77e5\u9053\u4f60\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u5927\u5c0f\uff0c\u4f46\u5b83\u4eec\u9700\u8981\u5728\u91cc\u9762\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u7528\u77e9\u9635\u4e58\u4ee5\u5750\u6807\u65f6\uff0c\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u6a21\u578b\u5750\u6807\u7cfb\uff09\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u4e09\u7ef4\u4e16\u754c\u5750\u6807\u7cfb\uff09\u3002 \u4e16\u754c\u77e9\u9635\u5e94\u8be5\u8fd9\u6837\u8ba1\u7b97\uff08\u987a\u5e8f\u5f88\u91cd\u8981\uff0c\u56e0\u4e3a\u4e58\u6cd5\u4ea4\u6362\u5f8b\u4e0d\u9002\u7528\u4e8e\u77e9\u9635\uff09: \u4e16\u754c\u77e9\u9635=\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \u5982\u679c\u628a\u6295\u5f71\u77e9\u9635\u5305\u542b\u5728\u53d8\u6362\u77e9\u9635\u4e2d\uff0c\u5b83\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\begin{array}{lcl} Transf & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \\\\ & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4e16\u754c\u77e9\u9635\\right] \\end{array} \u4f4d\u79fb\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a \\begin{bmatrix} 1 & 0 & 0 & dx \\\\ 0 & 1 & 0 & dy \\\\ 0 & 0 & 1 & dz \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u4f4d\u79fb\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a dx: \u6cbfX\u8f74\u4f4d\u79fb\u3002 dy: \u6cbfY\u8f74\u4f4d\u79fb\u3002 dz: \u6cbfZ\u8f74\u4f4d\u79fb\u3002 \u7f29\u653e\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1b \\begin{bmatrix} sx & 0 & 0 & 0 \\\\ 0 & sy & 0 & 0 \\\\ 0 & 0 & sz & 0 \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7f29\u653e\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a sx: \u6cbf\u7740X\u8f74\u7f29\u653e\u3002 sy: \u6cbf\u7740Y\u8f74\u7f29\u653e\u3002 sz: \u6cbf\u7740Z\u8f74\u7f29\u653e\u3002 \u65cb\u8f6c\u77e9\u9635\u8981\u590d\u6742\u5f97\u591a\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u5b83\u53ef\u4ee5\u7531\u6bcf\u4e2a\u7ed5\u5355\u72ec\u7684\u8f74\u65cb\u8f6c\u7684\u65cb\u8f6c\u77e9\u9635\u76f8\u4e58\u5f97\u5230\u3002 \u73b0\u5728\uff0c\u4e3a\u4e86\u5b9e\u8df5\u8fd9\u4e9b\u7406\u8bba\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u4ee3\u7801\u4e00\u70b9\u70b9\u3002\u5728\u6e38\u620f\u4e2d\uff0c\u6211\u4eec\u5c06\u52a0\u8f7d\u4e00\u7ec4\u6a21\u578b\uff0c\u7528\u6765\u6839\u636e\u6e38\u620f\u903b\u8f91\u5728\u4e0d\u540c\u7684\u4f4d\u7f6e\u6e32\u67d3\u8bb8\u591a\u7269\u4f53\uff08\u60f3\u8c61\u4e00\u4e2aFPS\u6e38\u620f\uff0c\u5b83\u8f7d\u5165\u4e86\u4e09\u4e2a\u4e0d\u540c\u654c\u4eba\u7684\u6a21\u578b\u3002\u786e\u5b9e\u53ea\u6709\u4e09\u4e2a\u6a21\u578b\uff0c\u4f46\u4f7f\u7528\u8fd9\u4e9b\u6a21\u578b\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u60f3\u8981\u7684\u4efb\u610f\u6570\u91cf\u7684\u654c\u4eba\uff09\u3002\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u5bf9\u8c61\u521b\u5efa\u4e00\u4e2aVAO\u548c\u4e00\u7ec4VBO\u5417\uff1f\u7b54\u6848\u662f\u4e0d\u9700\u8981\uff0c\u53ea\u9700\u8981\u6bcf\u4e2a\u6a21\u578b\u52a0\u8f7d\u4e00\u6b21\u5c31\u884c\u3002\u6211\u4eec\u9700\u8981\u505a\u7684\u662f\u6839\u636e\u5b83\u7684\u4f4d\u7f6e\uff0c\u5927\u5c0f\u548c\u65cb\u8f6c\u6765\u72ec\u7acb\u5730\u7ed8\u5236\u5b83\u3002\u5f53\u6e32\u67d3\u8fd9\u4e9b\u6a21\u578b\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u5b83\u4eec\u8fdb\u884c\u53d8\u6362\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameItem \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u6a21\u578b\u52a0\u8f7d\u5230 Mesh \u5b9e\u4f8b\u4e2d\u3002\u4e00\u4e2a GameItem \u5b9e\u4f8b\u5c06\u7531\u53d8\u91cf\u50a8\u5b58\u5b83\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u72b6\u6001\u548c\u7f29\u653e\u3002\u5982\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private final Mesh mesh; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem(Mesh mesh) { this.mesh = mesh; position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return mesh; } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Transformation \u7684\u7c7b\uff0c\u8ba9\u5b83\u6765\u5904\u7406\u53d8\u6362\u3002 package org.lwjglb.engine.graph; import org.joml.Matrix4f; import org.joml.Vector3f; public class Transformation { private final Matrix4f projectionMatrix; private final Matrix4f worldMatrix; public Transformation() { worldMatrix = new Matrix4f(); projectionMatrix = new Matrix4f(); } public final Matrix4f getProjectionMatrix(float fov, float width, float height, float zNear, float zFar) { float aspectRatio = width / height; projectionMatrix.identity(); projectionMatrix.perspective(fov, aspectRatio, zNear, zFar); return projectionMatrix; } public Matrix4f getWorldMatrix(Vector3f offset, Vector3f rotation, float scale) { worldMatrix.identity().translate(offset). rotateX((float)Math.toRadians(rotation.x)). rotateY((float)Math.toRadians(rotation.y)). rotateZ((float)Math.toRadians(rotation.z)). scale(scale); return worldMatrix; } } \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e2a\u7c7b\u628a\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u8d77\u6765\u3002\u7ed9\u5b9a\u4e00\u7ec4\u53c2\u6570\u6765\u8fdb\u884c\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u7136\u540e\u8fd4\u56de\u4e16\u754c\u77e9\u9635\u3002 getWorldMatrix \u8fd4\u56de\u7684\u7ed3\u679c\u5c06\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u53d8\u6362\u5750\u6807\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u83b7\u5f97\u6295\u5f71\u77e9\u9635\u7684\u65b9\u6cd5\u3002 \u9700\u8981\u6ce8\u610f\u7684\u4e00\u4ef6\u4e8b\u662f\uff0c Matrix4f \u7c7b\u7684 mul \u65b9\u6cd5\u4fee\u6539\u4e86\u8be5\u5b9e\u4f8b\u7684\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u6295\u5f71\u77e9\u9635\u4e0e\u53d8\u6362\u77e9\u9635\u76f8\u4e58\uff0c\u6211\u4eec\u4f1a\u4fee\u6539\u6295\u5f71\u77e9\u9635\u672c\u8eab\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u603b\u662f\u5728\u6bcf\u6b21\u8c03\u7528\u65f6\u5c06\u6bcf\u4e2a\u77e9\u9635\u521d\u59cb\u5316\u4e3a\u5355\u4f4d\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4ec5\u5b9e\u4f8b\u5316\u4e86\u6ca1\u6709\u4efb\u4f55\u53c2\u6570\u7684 Transformation \u7c7b\uff0c\u800c\u5728 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u521b\u5efa\u4e86Uniform\u3002 public Renderer() { transformation = new Transformation(); } public void init(Window window) throws Exception { // ... \u6b64\u524d\u7684\u4e00\u4e9b\u4ee3\u7801 ... // \u4e3a\u4e16\u754c\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u521b\u5efaUniform shaderProgram.createUniform(\"projectionMatrix\"); shaderProgram.createUniform(\"worldMatrix\"); window.setClearColor(0.0f, 0.0f, 0.0f, 0.0f); } \u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\uff0c\u73b0\u5728\u53ef\u4ee5\u63a5\u6536\u5230\u4e00\u4e2a GameItem \u7684\u6570\u7ec4\uff1a public void render(Window window, GameItem[] gameItems) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u6e32\u67d3\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u4e16\u754c\u77e9\u9635 Matrix4f worldMatrix = transformation.getWorldMatrix( gameItem.getPosition(), gameItem.getRotation(), gameItem.getScale()); shaderProgram.setUniform(\"worldMatrix\", worldMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c gameItem.getMesh().render(); } shaderProgram.unbind(); } \u6bcf\u6b21\u8c03\u7528 render \u65f6\u5c31\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21\uff0c\u8fd9\u6837\u6211\u4eec\u53ef\u4ee5\u5904\u7406\u7a97\u53e3\u5927\u5c0f\u7684\u8c03\u6574\u64cd\u4f5c\u3002\u7136\u540e\u6211\u4eec\u904d\u5386 GameItem \u6570\u7ec4\uff0c\u5e76\u6839\u636e\u5b83\u4eec\u5404\u81ea\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u521b\u5efa\u53d8\u6362\u77e9\u9635\uff0c\u8be5\u77e9\u9635\u5c06\u88ab\u4f20\u9012\u5230\u7740\u8272\u5668\u5e76\u7ed8\u5236 Mesh \u3002\u6295\u5f71\u77e9\u9635\u5bf9\u4e8e\u6240\u6709\u8981\u6e32\u67d3\u7684\u9879\u76ee\u90fd\u662f\u76f8\u540c\u7684\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u5728 Transformation \u7c7b\u4e2d\u662f\u5355\u72ec\u4e00\u4e2a\u53d8\u91cf\u7684\u539f\u56e0\u3002 \u6211\u4eec\u5c06\u6e32\u67d3\u4ee3\u7801\u79fb\u52a8\u5230 Mesh \u7c7b\u4e2d\uff1a public void render() { // \u7ed8\u5236Mesh glBindVertexArray(getVaoId()); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); // \u91cd\u7f6e\u72b6\u6001 glBindVertexArray(0); } \u9876\u70b9\u7740\u8272\u5668\u53ea\u9700\u7b80\u5355\u5730\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 worldMatrix \u77e9\u9635\uff0c\u7136\u540e\u7528\u5b83\u4e0e projectionMatrix \u4e00\u540c\u8ba1\u7b97\u5750\u6807\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4f60\u6240\u89c1\uff0c\u4ee3\u7801\u5b8c\u5168\u4e00\u81f4\u3002\u6211\u4eec\u4f7f\u7528Uniform\u6765\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\uff0c\u5e76\u4e14\u8003\u8651\u622a\u9525\u3001\u4f4d\u7f6e\u3001\u7f29\u653e\u548c\u65cb\u8f6c\u7b49\u3002 \u53e6\u5916\u4e00\u4e2a\u91cd\u8981\u7684\u95ee\u9898\u662f\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u76f4\u63a5\u4f7f\u7528\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u800c\u662f\u628a\u5b83\u4eec\u7ec4\u5408\u6210\u4e00\u4e2a\u4e16\u754c\u77e9\u9635\u5462\uff1f\u539f\u56e0\u662f\u6211\u4eec\u5e94\u8be5\u5c3d\u91cf\u51cf\u5c11\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u77e9\u9635\u3002\u8fd8\u8981\u8bb0\u4f4f\uff0c\u5728\u7740\u8272\u5668\u4e2d\u6240\u505a\u7684\u77e9\u9635\u4e58\u6cd5\u662f\u6bcf\u4e2a\u9876\u70b9\u4e00\u6b21\uff0c\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u8c03\u7528\u671f\u95f4\u4e0d\u4f1a\u6539\u53d8\uff0c\u800c\u6bcf\u4e00\u4e2a GameItem \u5b9e\u4f8b\u7684\u4e16\u754c\u77e9\u9635\u4e5f\u4e0d\u4f1a\u6539\u53d8\u3002\u5982\u679c\u72ec\u7acb\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u6211\u4eec\u8981\u505a\u66f4\u591a\u7684\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\u3002\u5728\u4e00\u4e2a\u6709\u8d85\u591a\u9876\u70b9\u7684\u6a21\u578b\u4e2d\uff0c\u8fd9\u662f\u5f88\u591a\u4f59\u7684\u64cd\u4f5c\u3002 \u4f46\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u60f3\uff0c\u5982\u679c\u6bcf\u4e2a GameItem \u4e2d\u7684\u4e16\u754c\u77e9\u9635\u90fd\u4e0d\u4f1a\u53d1\u751f\u53d8\u5316\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u5728Java\u7c7b\u4e2d\u505a\u77e9\u9635\u4e58\u6cd5\uff1f\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u4e0e\u6bcf\u4e2a GameItem \u76f8\u4e58\uff0c\u628a\u5b83\u4eec\u4f5c\u4e3a\u4e00\u4e2aUniform\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u786e\u5b9e\u80fd\u7701\u4e0b\u66f4\u591a\u7684\u64cd\u4f5c\u3002\u4f46\u5f53\u6211\u4eec\u5411\u6e38\u620f\u5f15\u64ce\u4e2d\u6dfb\u52a0\u66f4\u591a\u7684\u7279\u6027\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u6240\u4ee5\u6700\u597d\u72ec\u7acb\u5730\u5904\u7406\u8fd9\u4e24\u4e2a\u77e9\u9635\u3002 \u6700\u540e\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\uff0c\u8ba9\u5176\u4e0e Mesh \u5173\u8054\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e9b\u903b\u8f91\u6765\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u56db\u8fb9\u5f62\u3002\u56e0\u4e3a\u8fd9\u53ea\u662f\u4e2a\u6d4b\u8bd5\u793a\u4f8b\uff0c\u6ca1\u6709\u6dfb\u52a0\u592a\u591a\u5185\u5bb9\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u76f8\u5173\u4ee3\u7801\u3002","title":"\u53d8\u6362"},{"location":"06-transformations/#transformations","text":"","title":"\u53d8\u6362\uff08Transformations\uff09"},{"location":"06-transformations/#_1","text":"\u8ba9\u6211\u4eec\u56de\u770b\u5728\u524d\u4e00\u7ae0\u4e2d\u521b\u5efa\u7684\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002\u5982\u679c\u4ed4\u7ec6\u770b\uff0c\u5b83\u66f4\u50cf\u4e00\u4e2a\u77e9\u5f62\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u5c06\u7a97\u53e3\u7684\u5bbd\u5ea6\u4ece600\u50cf\u7d20\u6539\u4e3a900\u50cf\u7d20\uff0c\u5931\u771f\u5c31\u4f1a\u66f4\u52a0\u660e\u663e\u3002\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\u5462\uff1f \u5982\u679c\u4f60\u67e5\u770b\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u6211\u4eec\u53ea\u662f\u76f4\u63a5\u5730\u4f20\u9012\u5750\u6807\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5f53\u4e00\u4e2a\u9876\u70b9\u7684X\u5750\u6807\u4e3a0.5\u65f6\uff0c\u6211\u4eec\u8ba9OpenGL\u5728\u5c4f\u5e55\u7684X\u5750\u6807\u4e3a0.5\u7684\u4f4d\u7f6e\u7ed8\u5236\u5b83\u3002\u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08\u4ec5\u542bX\u548cY\u8f74\uff09\u3002 \u5c06\u8fd9\u4e9b\u5750\u6807\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807\u7cfb\uff08\u5176\u539f\u70b9\u4f4d\u4e8e\u4e0a\u56fe\u7684\u5de6\u4e0a\u89d2\uff09\uff0c\u9700\u8981\u8003\u8651\u5230\u7a97\u53e3\u7684\u5927\u5c0f\u3002\u56e0\u6b64\uff0c\u5982\u679c\u6211\u4eec\u7684\u7a97\u53e3\u5927\u5c0f\u4e3a900x480\uff0cOpenGL\u5750\u6807(1, 0)\u5c06\u88ab\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807(900, 0)\uff0c\u6700\u7ec8\u521b\u5efa\u4e00\u4e2a\u77e9\u5f62\u800c\u4e0d\u662f\u4e00\u4e2a\u6b63\u65b9\u5f62\u3002 \u4f46\u662f\uff0c\u95ee\u9898\u8fdc\u6bd4\u8fd9\u66f4\u4e25\u91cd\u3002\u5c06\u56db\u8fb9\u5f62\u7684Z\u5750\u6807\u4ece0.0\u4fee\u6539\u4e3a1.0\u548c-1.0\uff0c\u4f60\u53d1\u73b0\u4e86\u4ec0\u4e48\uff1f\u56db\u8fb9\u5f62\u5b8c\u5168\u662f\u7ed8\u5236\u5728\u540c\u4e00\u4e2a\u5730\u65b9\uff0c\u4e0d\u7ba1\u5b83\u662f\u5426\u6cbf\u7740Z\u8f74\u4f4d\u79fb\u3002\u4e3a\u4ec0\u4e48\u4f1a\u53d1\u751f\u8fd9\u79cd\u60c5\u51b5\uff1f\u8fdc\u5904\u7684\u7269\u4f53\u5e94\u8be5\u6bd4\u8fd1\u5904\u7684\u7269\u4f53\u7ed8\u5236\u5f97\u66f4\u5c0f\uff0c\u4f46\u662f\u6211\u4eec\u4f7f\u7528\u76f8\u540c\u7684X\u548cY\u5750\u6807\u7ed8\u5236\u5b83\u4eec\u3002 \u4f46\u7a0d\u7b49\u4e00\u4e0b\uff0c\u8fd9\u4e0d\u5e94\u8be5\u7531Z\u5750\u6807\u6765\u5904\u7406\u5417\uff1f\u8fd9\u534a\u5bf9\u534a\u9519\u3002Z\u5750\u6807\u544a\u8bc9OpenGL\u4e00\u4e2a\u7269\u4f53\u7684\u8fdc\u8fd1\uff0c\u4f46\u662fOpenGL\u5bf9\u4f60\u7684\u7269\u4f53\u7684\u5927\u5c0f\u4e00\u65e0\u6240\u77e5\u3002\u4f60\u53ef\u4ee5\u6709\u4e24\u4e2a\u4e0d\u540c\u5927\u5c0f\u7684\u7269\u4f53\uff0c\u4e00\u4e2a\u66f4\u8fd1\u66f4\u5c0f\uff0c\u4e00\u4e2a\u66f4\u8fdc\u66f4\u5927\uff0c\u800c\u4e14\u53ef\u4ee5\u4ee5\u76f8\u540c\u7684\u5927\u5c0f\u6b63\u786e\u5730\u6295\u5f71\u5230\u5c4f\u5e55\u4e0a\uff08\u6709\u76f8\u540c\u7684\u5c4f\u5e55X\u548cY\u5750\u6807\uff0c\u4f46Z\u5750\u6807\u4e0d\u540c\uff09\u3002OpenGL\u53ea\u4f7f\u7528\u6b63\u5728\u4f20\u9012\u7684\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\u3002 \u65e2\u7136\u5df2\u7ecf\u786e\u8bca\u4e86\u8fd9\u4e2a\u95ee\u9898\uff0c\u8be5\u600e\u4e48\u89e3\u51b3\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\u6216\u622a\u9525\u4f53\uff08Frustum\uff09\u3002\u6295\u5f71\u77e9\u9635\u5c06\u5904\u7406\u7ed8\u5236\u533a\u57df\u7684\u5bbd\u9ad8\u6bd4\uff08\u5927\u5c0f\u4e0e\u9ad8\u5ea6\u4e4b\u95f4\u7684\u5173\u7cfb\uff09\uff0c\u8fd9\u6837\u7269\u4f53\u5c31\u4e0d\u4f1a\u53d8\u5f62\u3002\u5b83\u8fd8\u53ef\u4ee5\u5904\u7406\u8ddd\u79bb\uff0c\u6240\u4ee5\u8f83\u8fdc\u7684\u7269\u4f53\u5c06\u4f1a\u88ab\u7ed8\u5236\u5f97\u66f4\u5c0f\u3002\u6295\u5f71\u77e9\u9635\u8fd8\u5c06\u8003\u8651\u6211\u4eec\u7684\u89c6\u91ce\u548c\u5e94\u8be5\u663e\u793a\u7684\u8ddd\u79bb\u6709\u591a\u8fdc\u3002 \u5bf9\u4e8e\u4e0d\u719f\u6089\u77e9\u9635\u7684\u4eba\uff0c\u77e9\u9635\uff08Matrix\uff09\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\u3002\u77e9\u9635\u4e2d\u7684\u6bcf\u4e2a\u6570\u5b57\u88ab\u79f0\u4e3a\u5143\u7d20\u3002\u77e9\u9635\u9636\u6b21\u662f\u884c\u548c\u5217\u7684\u6570\u91cf\u3002\u4f8b\u5982\uff0c\u6b64\u5904\u662f\u4e00\u4e2a2x2\u77e9\u9635\uff08\u67092\u884c2\u5217\uff09\u3002 \u77e9\u9635\u6709\u8bb8\u591a\u53ef\u4ee5\u5e94\u7528\u4e8e\u5b83\u4eec\u7684\u57fa\u672c\u8fd0\u7b97\uff08\u5982\u52a0\u6cd5\u3001\u4e58\u6cd5\u7b49\uff09\uff0c\u4f60\u53ef\u4ee5\u5728\u6570\u5b66\u4e66\u4e2d\u67e5\u9605\uff0c\u5176\u4e2d\u4e0e\u4e09\u7ef4\u56fe\u5f62\u76f8\u5173\u7684\u77e9\u9635\u5bf9\u7a7a\u95f4\u4e2d\u70b9\u7684\u53d8\u6362\u975e\u5e38\u6709\u7528\u3002 \u4f60\u53ef\u4ee5\u628a\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u6210\u4e00\u4e2a\u6444\u50cf\u673a\uff0c\u5b83\u6709\u4e00\u4e2a\u89c6\u91ce\u548c\u6700\u5c0f\u548c\u6700\u5927\u8ddd\u79bb\u3002\u8be5\u6444\u50cf\u673a\u7684\u53ef\u89c6\u533a\u57df\u662f\u4e00\u4e2a\u622a\u65ad\u7684\u91d1\u5b57\u5854\uff0c\u4e0b\u56fe\u4e3a\u8be5\u533a\u57df\u7684\u4fef\u89c6\u56fe\u3002 \u6295\u5f71\u77e9\u9635\u5c06\u6b63\u786e\u5730\u6295\u5f71\u4e09\u7ef4\u5750\u6807\uff0c\u4ee5\u4fbf\u5b83\u4eec\u80fd\u591f\u5728\u4e8c\u7ef4\u5c4f\u5e55\u4e0a\u6b63\u786e\u5730\u663e\u793a\u3002\u8be5\u77e9\u9635\u7684\u6570\u5b66\u8868\u793a\u5982\u4e0b\uff08\u4e0d\u8981\u5bb3\u6015\uff09\uff1a \u5176\u4e2d\u5c4f\u5e55\u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\u6307\u7684\u662f\u5c4f\u5e55\u5bbd\u5ea6\u4e0e\u5c4f\u5e55\u9ad8\u5ea6\u7684\u5173\u7cfb\uff08 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4=\u5bbd\u5ea6/\u9ad8\u5ea6 \uff09\u3002\u4e3a\u4e86\u83b7\u5f97\u7ed9\u5b9a\u70b9\u7684\u6295\u5f71\u5750\u6807\uff0c\u53ea\u9700\u8981\u5c06\u6295\u5f71\u77e9\u9635\u4e58\u4ee5\u539f\u59cb\u5750\u6807\uff0c\u7ed3\u679c\u662f\u6295\u5f71\u540e\u7684\u53e6\u4e00\u4e2a\u5411\u91cf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u4e00\u7ec4\u6570\u5b66\u5b9e\u4f53\uff0c\u5982\u5411\u91cf\u3001\u77e9\u9635\uff0c\u5e76\u5305\u62ec\u53ef\u4ee5\u5bf9\u5b83\u4eec\u8fdb\u884c\u7684\u8fd0\u7b97\u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4ece\u5934\u5f00\u59cb\u7f16\u5199\u6240\u6709\u7684\u4ee3\u7801\uff0c\u6216\u8005\u4f7f\u7528\u5df2\u5b9e\u73b0\u7684\u5e93\u3002\u5f53\u7136\u6211\u4eec\u4f1a\u9009\u62e9\u5bb9\u6613\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528JOML\uff08Java OpenGL Math Library\uff0cJava OpenGL \u6570\u5b66\u5e93\uff09\u5904\u7406LWJGL\u5185\u7684\u6570\u5b66\u8fd0\u7b97\u3002\u4e3a\u4e86\u4f7f\u7528\u8be5\u5e93\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 pom.xml \u6587\u4ef6\u6dfb\u52a0\u53e6\u4e00\u4e2a\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.joml</groupId> <artifactId>joml</artifactId> <version>${joml.version}</version> </dependency> \u7136\u540e\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u5e93\u7248\u672c\u3002 <properties> [...] <joml.version>1.9.6</joml.version> [...] </properties> \u73b0\u5728\u4e00\u5207\u90fd\u51c6\u5907\u597d\u4e86\uff0c\u6765\u5b9a\u4e49\u6211\u4eec\u7684\u6295\u5f71\u77e9\u9635\u3002\u5728 Renderer \u7c7b\u4e2d\u521b\u5efa Matrix4f \u7c7b\uff08\u7531JOML\u5e93\u63d0\u4f9b\uff09\u7684\u5b9e\u4f8b\u3002 Matrix4f \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a perspective \u65b9\u6cd5\u6765\u521b\u5efa\u6295\u5f71\u77e9\u9635\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u4ee5\u4e0b\u53c2\u6570\uff1a \u89c6\u91ce\uff1a\u53ef\u89c6\u533a\u57df\u89d2\u7684\u5f27\u5ea6\u5927\u5c0f\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u8be5\u503c\u7684\u5e38\u6570\u3002 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4\u3002 \u6700\u8fd1\u89c6\u8ddd\uff08z-near\uff09\u3002 \u6700\u8fdc\u89c6\u8ddd\uff08z-far\uff09\u3002 \u6211\u4eec\u5c06\u5728 init \u65b9\u6cd5\u4e2d\u5b9e\u4f8b\u5316\u8be5\u77e9\u9635\uff0c\u56e0\u6b64\u9700\u8981\u4f20\u9012\u5bf9 Window \u5b9e\u4f8b\u7684\u9634\u5f71\u4ee5\u83b7\u53d6\u7a97\u53e3\u5927\u5c0f\uff08\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u4ee3\u7801\u5982\u4e0b\uff1a /** * \u89c6\u91ce\u5f27\u5ea6 */ private static final float FOV = (float) Math.toRadians(60.0f); private static final float Z_NEAR = 0.01f; private static final float Z_FAR = 1000.f; private Matrix4f projectionMatrix; \u6295\u5f71\u77e9\u9635\u7684\u521b\u5efa\u5982\u4e0b\u6240\u793a\uff1a float aspectRatio = (float) window.getWidth() / window.getHeight(); projectionMatrix = new Matrix4f().perspective(FOV, aspectRatio, Z_NEAR, Z_FAR); \u73b0\u5728\u6211\u4eec\u7701\u7565\u5bbd\u9ad8\u6bd4\u53ef\u53d8\u7684\u60c5\u51b5\uff08\u901a\u8fc7\u8c03\u6574\u7a97\u53e3\u5927\u5c0f\uff09\uff0c\u8fd9\u53ef\u4ee5\u5728 render \u65b9\u6cd5\u4e2d\u68c0\u67e5\u5e76\u76f8\u5e94\u5730\u6539\u53d8\u6295\u5f71\u77e9\u9635\u3002 \u73b0\u5728\u6709\u4e86\u77e9\u9635\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\uff0c\u5e76\u4e14\u5b83\u5e94\u8be5\u88ab\u5e94\u7528\u5230\u6240\u6709\u9876\u70b9\u4e0a\u3002\u9996\u5148\uff0c\u4f60\u53ef\u80fd\u4f1a\u60f3\u5230\u628a\u5b83\u6346\u7ed1\u5728\u9876\u70b9\u8f93\u5165\u4e2d\uff08\u5c31\u50cf\u5750\u6807\u548c\u989c\u8272\u90a3\u6837\uff09\u3002\u4f46\u8fd9\u6837\uff0c\u6211\u4eec\u4f1a\u6d6a\u8d39\u5f88\u591a\u7a7a\u95f4\uff0c\u56e0\u4e3a\u6295\u5f71\u77e9\u9635\u5728\u51e0\u6b21\u6e32\u67d3\u671f\u95f4\u90fd\u4e0d\u4f1a\u53d1\u751f\u6539\u53d8\u3002\u4f60\u53ef\u80fd\u8fd8\u60f3\u5728Java\u4ee3\u7801\u4e2d\u7528\u77e9\u9635\u5904\u7406\u6240\u6709\u9876\u70b9\uff0c\u4f46\u8fd9\u6837\u6211\u4eec\u8f93\u5165\u7684VBO\u5c31\u662f\u6ca1\u7528\u7684\u4e86\uff0c\u8fd9\u6837\u5c31\u4e0d\u80fd\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u5904\u7406\u5668\u8d44\u6e90\u4e86\u3002 \u7b54\u6848\u662f\u4f7f\u7528\u201c uniform \u201d\u3002Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4e0e\u7740\u8272\u5668\u4ea4\u6d41\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u5e76\u58f0\u660e\u4e00\u4e2a\u65b0\u7684\u540d\u4e3a projectionMatrix \u7684Uniform\uff0c\u5e76\u7528\u5b83\u6765\u8ba1\u7b97\u6295\u5f71\u540e\u7684\u4f4d\u7f6e\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u628a projectionMatrix \u5b9a\u4e49\u4e3a\u4e00\u4e2a4x4\u7684\u77e9\u9635\uff0c\u65b0\u7684\u5750\u6807\u662f\u901a\u8fc7\u628a\u5b83\u4e0e\u539f\u59cb\u5750\u6807\u76f8\u4e58\u5f97\u5230\u7684\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u628a\u6295\u5f71\u77e9\u9635\u7684\u503c\u4f20\u9012\u7ed9\u7740\u8272\u5668\uff0c\u9996\u5148\u9700\u8981\u786e\u5b9aUniform\u7684\u4f4d\u7f6e\u3002 \u8fd9\u662f\u901a\u8fc7\u8c03\u7528\u65b9\u6cd5 glGetUniformLocation \u5b9e\u73b0\u7684\uff0c\u5b83\u6709\u4e24\u4e2a\u53c2\u6570\uff1a \u7740\u8272\u5668\u7a0b\u5e8f\u7684ID Uniform\u540d\uff08\u5b83\u5e94\u8be5\u4e0e\u7740\u8272\u5668\u91cc\u5b9a\u4e49\u7684\u540d\u79f0\u76f8\u540c\uff09 \u6b64\u65b9\u6cd5\u8fd4\u56de\u50a8\u5b58Uniform\u4f4d\u7f6e\u7684ID\u3002\u7531\u4e8e\u53ef\u80fd\u6709\u4e00\u4e2a\u4ee5\u4e0a\u7684Uniform\uff0c\u6211\u4eec\u5c06\u628a\u8fd9\u4e9bID\u50a8\u5b58\u5728\u7531\u53d8\u91cf\u540d\u4f5c\u4e3a\u7d22\u5f15\u7684Map\u4e2d\uff08\u6b64\u540e\u6211\u4eec\u9700\u8981\u90a3\u4e2aID\uff09\u3002\u56e0\u6b64\uff0c\u5728 ShaderProgram \u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b57\u6bb5\u6765\u4fdd\u5b58\u8fd9\u4e9bID\uff1a private final Map<String, Integer> uniforms; \u7136\u540e\u7531\u6784\u9020\u65b9\u6cd5\u521d\u59cb\u5316\u5b83\uff1a uniforms = new HashMap<>(); \u6700\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u65b0\u7684Uniform\u548c\u50a8\u5b58\u83b7\u5f97\u7684\u4f4d\u7f6e\u3002 public void createUniform(String uniformName) throws Exception { int uniformLocation = glGetUniformLocation(programId, uniformName); if (uniformLocation < 0) { throw new Exception(\"Could not find uniform:\" + uniformName); } uniforms.put(uniformName, uniformLocation); } \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7a0b\u5e8f\u7f16\u8bd1\u540e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u8c03\u7528 createUniform \u65b9\u6cd5\uff08\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5728\u6295\u5f71\u77e9\u9635\u5b9e\u4f8b\u5316\u540e\u8c03\u7528\u5b83\uff09\u3002 shaderProgram.createUniform(\"projectionMatrix\"); \u6b64\u65f6\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u4e00\u4e2a\u53ef\u4ee5\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u6570\u636e\u7684\u50a8\u5b58\u5668\u3002\u7531\u4e8e\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u671f\u95f4\u4e0d\u4f1a\u53d8\u5316\uff0c\u6240\u4ee5\u53ef\u4ee5\u5728\u521b\u5efaUniform\u540e\u76f4\u63a5\u8bbe\u7f6e\u503c\uff0c\u4f46\u6211\u4eec\u5c06\u5728 render \u65b9\u6cd5\u4e2d\u505a\u6b64\u4e8b\u3002\u7a0d\u540e\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ef\u4ee5\u91cd\u7528\u8be5Uniform\u6765\u6267\u884c\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e2d\u9700\u8981\u6267\u884c\u7684\u5176\u4ed6\u64cd\u4f5c\u3002 \u6211\u4eec\u5c06\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a setUniform \u7684\u65b9\u6cd5\u6765\u8bbe\u7f6e\u6570\u636e\uff0c\u901a\u8fc7\u4f7f\u7528JOML\u5e93\u63d0\u4f9b\u7684\u5b9e\u7528\u65b9\u6cd5\u5c06\u77e9\u9635\u8f6c\u6362\u4e3a4x4\u7684 FloatBuffer \u5bf9\u8c61\uff0c\u5e76\u5c06\u5b83\u4eec\u53d1\u9001\u5230Uniform\u4e2d\u3002 public void setUniform(String uniformName, Matrix4f value) { // \u8f6c\u50a8\u77e9\u9635\u5230FloatBuffer try (MemoryStack stack = MemoryStack.stackPush()) { FloatBuffer fb = stack.mallocFloat(16); value.get(fb); glUniformMatrix4fv(uniforms.get(uniformName), false, fb); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528\u4e0e\u6b64\u524d\u4e0d\u540c\u7684\u65b9\u5f0f\u521b\u5efa\u7f13\u51b2\u533a\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\uff0c\u5e76\u5c06\u5b83\u4eec\u5206\u914d\u5230\u5806\u6808\u4e0a\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u5f88\u5c0f\uff0c\u5e76\u4e14\u5728\u8be5\u65b9\u6cd5\u4e4b\u5916\u4e0d\u4f1a\u4f7f\u7528\u5b83\u3002\u56e0\u6b64\u6211\u4eec\u4f7f\u7528 MemoryStack \u7c7b\u3002 \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7ed1\u5b9a\u4e4b\u540e\uff0c\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); \u6211\u4eec\u5c31\u8981\u5b8c\u6210\u4e86\uff0c\u73b0\u5728\u53ef\u4ee5\u6b63\u786e\u5730\u6e32\u67d3\u56db\u8fb9\u5f62\uff0c\u6240\u4ee5\u73b0\u5728\u53ef\u4ee5\u542f\u52a8\u7a0b\u5e8f\uff0c\u7136\u540e\u5f97\u5230\u4e00\u4e2a...\u9ed1\u8272\u80cc\u666f\uff0c\u6ca1\u6709\u4efb\u4f55\u5f69\u8272\u56db\u8fb9\u5f62\u3002\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u6211\u4eec\u628a\u4ec0\u4e48\u5f04\u574f\u4e86\u5417\uff1f\u5b9e\u9645\u4e0a\u6ca1\u6709\u4efb\u4f55\u95ee\u9898\u3002\u8bb0\u4f4f\u6211\u4eec\u6b63\u5728\u6a21\u62df\u6444\u50cf\u673a\u89c2\u5bdf\u573a\u666f\u7684\u6548\u679c\u3002\u6211\u4eec\u63d0\u4f9b\u4e86\u4e24\u4e2a\u8ddd\u79bb\uff0c\u4e00\u4e2a\u662f\u6700\u8fdc\u89c6\u8ddd\uff081000f\uff09\u548c\u4e00\u4e2a\u6700\u8fd1\u89c6\u8ddd\uff080.01f\uff09\u3002\u800c\u6211\u4eec\u7684\u5750\u6807\u662f\uff1a float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; \u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5750\u6807\u4e2d\u7684Z\u5750\u6807\u4f4d\u4e8e\u53ef\u89c6\u533a\u57df\u4e4b\u5916\u3002\u5c06\u5b83\u4eec\u8d4b\u503c\u4e3a-0.05f\uff0c\u73b0\u5728\u4f60\u4f1a\u770b\u5230\u50cf\u8fd9\u6837\u7684\u4e00\u4e2a\u5de8\u5927\u7684\u7eff\u8272\u6b63\u65b9\u5f62\uff1a \u8fd9\u662f\u56e0\u4e3a\uff0c\u6211\u4eec\u6b63\u7ed8\u5236\u51fa\u79bb\u6444\u50cf\u673a\u592a\u8fd1\u7684\u6b63\u65b9\u5f62\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u653e\u5927\u5b83\u3002\u5982\u679c\u73b0\u5728\u628a\u4e00\u4e2a -1.05f \u7684\u503c\u8d4b\u503c\u7ed9Z\u5750\u6807\uff0c\u5c31\u53ef\u4ee5\u770b\u5230\u5f69\u8272\u6b63\u65b9\u5f62\u4e86\u3002 \u5982\u679c\u7ee7\u7eed\u5411\u540e\u79fb\u52a8\u56db\u8fb9\u5f62\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u5b83\u53d8\u5c0f\u4e86\u3002\u8fd8\u8981\u6ce8\u610f\u5230\u56db\u8fb9\u5f62\u4e0d\u518d\u50cf\u77e9\u5f62\u4e86\u3002","title":"\u6295\u5f71"},{"location":"06-transformations/#_2","text":"\u56de\u60f3\u4e00\u4e0b\u5230\u76ee\u524d\u4e3a\u6b62\u6211\u4eec\u90fd\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u5df2\u7ecf\u5b66\u4f1a\u4e86\u5982\u4f55\u5c06\u6570\u636e\u4ee5\u6709\u6548\u7684\u683c\u5f0f\u4f20\u9012\u7ed9\u663e\u5361\uff0c\u4ee5\u53ca\u5982\u4f55\u4f7f\u7528\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6765\u6295\u5f71\u8fd9\u4e9b\u9876\u70b9\u5e76\u8bbe\u7f6e\u5b83\u4eec\u7684\u989c\u8272\u3002\u73b0\u5728\u5e94\u8be5\u5f00\u59cb\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7ed8\u5236\u66f4\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4f46\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u80fd\u591f\u52a0\u8f7d\u6a21\u578b\uff0c\u5e76\u5728\u6307\u5b9a\u7684\u4f4d\u7f6e\u4ee5\u9002\u5f53\u7684\u5927\u5c0f\u548c\u6240\u9700\u7684\u65cb\u8f6c\u5c06\u5b83\u6e32\u67d3\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002 \u73b0\u5728\u4e3a\u4e86\u5b9e\u73b0\u8fd9\u6837\u7684\u6e32\u67d3\uff0c\u6211\u4eec\u9700\u8981\u63d0\u4f9b\u4e00\u4e9b\u57fa\u672c\u64cd\u4f5c\u6765\u64cd\u4f5c\u6a21\u578b\uff1a \u4f4d\u79fb\uff08Translation\uff09: \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09: \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09: \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u4e0a\u9762\u7684\u64cd\u4f5c\u7edf\u79f0\u4e3a\u53d8\u6362\uff08Transformation\uff09\u3002\u4f60\u53ef\u80fd\u731c\u5230\u8981\u5b9e\u73b0\u8fd9\u4e00\u70b9\u7684\u65b9\u6cd5\u662f\u628a\u5750\u6807\u4e58\u4ee5\u4e00\u7ec4\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u79fb\u52a8\uff0c\u4e00\u4e2a\u7528\u4e8e\u65cb\u8f6c\uff0c\u4e00\u4e2a\u7528\u4e8e\u7f29\u653e\uff09\u3002\u8fd9\u4e09\u4e2a\u77e9\u9635\u5c06\u88ab\u7ec4\u5408\u6210\u4e00\u4e2a\u79f0\u4e3a\u201c\u4e16\u754c\u77e9\u9635\u201d\u7684\u77e9\u9635\uff0c\u5e76\u4f5c\u4e3a\u4e00\u4e2aUniform\u4f20\u9012\u7ed9\u9876\u70b9\u7740\u8272\u5668\u3002 \u4e4b\u6240\u4ee5\u88ab\u79f0\u4e3a\u4e16\u754c\u77e9\u9635\uff0c\u662f\u56e0\u4e3a\u6211\u4eec\u6b63\u5728\u5c06\u6a21\u578b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002\u5f53\u5b66\u4e60\u52a0\u8f7d3D\u6a21\u578b\u65f6\uff0c\u4f60\u4f1a\u53d1\u73b0\u8fd9\u4e9b\u6a21\u578b\u662f\u5728\u5b83\u4eec\u81ea\u5df1\u7684\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u7684\uff0c\u5b83\u4eec\u4e0d\u77e5\u9053\u4f60\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u5927\u5c0f\uff0c\u4f46\u5b83\u4eec\u9700\u8981\u5728\u91cc\u9762\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u7528\u77e9\u9635\u4e58\u4ee5\u5750\u6807\u65f6\uff0c\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u6a21\u578b\u5750\u6807\u7cfb\uff09\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u4e09\u7ef4\u4e16\u754c\u5750\u6807\u7cfb\uff09\u3002 \u4e16\u754c\u77e9\u9635\u5e94\u8be5\u8fd9\u6837\u8ba1\u7b97\uff08\u987a\u5e8f\u5f88\u91cd\u8981\uff0c\u56e0\u4e3a\u4e58\u6cd5\u4ea4\u6362\u5f8b\u4e0d\u9002\u7528\u4e8e\u77e9\u9635\uff09: \u4e16\u754c\u77e9\u9635=\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \u5982\u679c\u628a\u6295\u5f71\u77e9\u9635\u5305\u542b\u5728\u53d8\u6362\u77e9\u9635\u4e2d\uff0c\u5b83\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\begin{array}{lcl} Transf & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \\\\ & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4e16\u754c\u77e9\u9635\\right] \\end{array} \u4f4d\u79fb\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a \\begin{bmatrix} 1 & 0 & 0 & dx \\\\ 0 & 1 & 0 & dy \\\\ 0 & 0 & 1 & dz \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u4f4d\u79fb\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a dx: \u6cbfX\u8f74\u4f4d\u79fb\u3002 dy: \u6cbfY\u8f74\u4f4d\u79fb\u3002 dz: \u6cbfZ\u8f74\u4f4d\u79fb\u3002 \u7f29\u653e\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1b \\begin{bmatrix} sx & 0 & 0 & 0 \\\\ 0 & sy & 0 & 0 \\\\ 0 & 0 & sz & 0 \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7f29\u653e\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a sx: \u6cbf\u7740X\u8f74\u7f29\u653e\u3002 sy: \u6cbf\u7740Y\u8f74\u7f29\u653e\u3002 sz: \u6cbf\u7740Z\u8f74\u7f29\u653e\u3002 \u65cb\u8f6c\u77e9\u9635\u8981\u590d\u6742\u5f97\u591a\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u5b83\u53ef\u4ee5\u7531\u6bcf\u4e2a\u7ed5\u5355\u72ec\u7684\u8f74\u65cb\u8f6c\u7684\u65cb\u8f6c\u77e9\u9635\u76f8\u4e58\u5f97\u5230\u3002 \u73b0\u5728\uff0c\u4e3a\u4e86\u5b9e\u8df5\u8fd9\u4e9b\u7406\u8bba\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u4ee3\u7801\u4e00\u70b9\u70b9\u3002\u5728\u6e38\u620f\u4e2d\uff0c\u6211\u4eec\u5c06\u52a0\u8f7d\u4e00\u7ec4\u6a21\u578b\uff0c\u7528\u6765\u6839\u636e\u6e38\u620f\u903b\u8f91\u5728\u4e0d\u540c\u7684\u4f4d\u7f6e\u6e32\u67d3\u8bb8\u591a\u7269\u4f53\uff08\u60f3\u8c61\u4e00\u4e2aFPS\u6e38\u620f\uff0c\u5b83\u8f7d\u5165\u4e86\u4e09\u4e2a\u4e0d\u540c\u654c\u4eba\u7684\u6a21\u578b\u3002\u786e\u5b9e\u53ea\u6709\u4e09\u4e2a\u6a21\u578b\uff0c\u4f46\u4f7f\u7528\u8fd9\u4e9b\u6a21\u578b\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u60f3\u8981\u7684\u4efb\u610f\u6570\u91cf\u7684\u654c\u4eba\uff09\u3002\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u5bf9\u8c61\u521b\u5efa\u4e00\u4e2aVAO\u548c\u4e00\u7ec4VBO\u5417\uff1f\u7b54\u6848\u662f\u4e0d\u9700\u8981\uff0c\u53ea\u9700\u8981\u6bcf\u4e2a\u6a21\u578b\u52a0\u8f7d\u4e00\u6b21\u5c31\u884c\u3002\u6211\u4eec\u9700\u8981\u505a\u7684\u662f\u6839\u636e\u5b83\u7684\u4f4d\u7f6e\uff0c\u5927\u5c0f\u548c\u65cb\u8f6c\u6765\u72ec\u7acb\u5730\u7ed8\u5236\u5b83\u3002\u5f53\u6e32\u67d3\u8fd9\u4e9b\u6a21\u578b\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u5b83\u4eec\u8fdb\u884c\u53d8\u6362\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameItem \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u6a21\u578b\u52a0\u8f7d\u5230 Mesh \u5b9e\u4f8b\u4e2d\u3002\u4e00\u4e2a GameItem \u5b9e\u4f8b\u5c06\u7531\u53d8\u91cf\u50a8\u5b58\u5b83\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u72b6\u6001\u548c\u7f29\u653e\u3002\u5982\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private final Mesh mesh; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem(Mesh mesh) { this.mesh = mesh; position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return mesh; } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Transformation \u7684\u7c7b\uff0c\u8ba9\u5b83\u6765\u5904\u7406\u53d8\u6362\u3002 package org.lwjglb.engine.graph; import org.joml.Matrix4f; import org.joml.Vector3f; public class Transformation { private final Matrix4f projectionMatrix; private final Matrix4f worldMatrix; public Transformation() { worldMatrix = new Matrix4f(); projectionMatrix = new Matrix4f(); } public final Matrix4f getProjectionMatrix(float fov, float width, float height, float zNear, float zFar) { float aspectRatio = width / height; projectionMatrix.identity(); projectionMatrix.perspective(fov, aspectRatio, zNear, zFar); return projectionMatrix; } public Matrix4f getWorldMatrix(Vector3f offset, Vector3f rotation, float scale) { worldMatrix.identity().translate(offset). rotateX((float)Math.toRadians(rotation.x)). rotateY((float)Math.toRadians(rotation.y)). rotateZ((float)Math.toRadians(rotation.z)). scale(scale); return worldMatrix; } } \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e2a\u7c7b\u628a\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u8d77\u6765\u3002\u7ed9\u5b9a\u4e00\u7ec4\u53c2\u6570\u6765\u8fdb\u884c\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u7136\u540e\u8fd4\u56de\u4e16\u754c\u77e9\u9635\u3002 getWorldMatrix \u8fd4\u56de\u7684\u7ed3\u679c\u5c06\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u53d8\u6362\u5750\u6807\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u83b7\u5f97\u6295\u5f71\u77e9\u9635\u7684\u65b9\u6cd5\u3002 \u9700\u8981\u6ce8\u610f\u7684\u4e00\u4ef6\u4e8b\u662f\uff0c Matrix4f \u7c7b\u7684 mul \u65b9\u6cd5\u4fee\u6539\u4e86\u8be5\u5b9e\u4f8b\u7684\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u6295\u5f71\u77e9\u9635\u4e0e\u53d8\u6362\u77e9\u9635\u76f8\u4e58\uff0c\u6211\u4eec\u4f1a\u4fee\u6539\u6295\u5f71\u77e9\u9635\u672c\u8eab\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u603b\u662f\u5728\u6bcf\u6b21\u8c03\u7528\u65f6\u5c06\u6bcf\u4e2a\u77e9\u9635\u521d\u59cb\u5316\u4e3a\u5355\u4f4d\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4ec5\u5b9e\u4f8b\u5316\u4e86\u6ca1\u6709\u4efb\u4f55\u53c2\u6570\u7684 Transformation \u7c7b\uff0c\u800c\u5728 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u521b\u5efa\u4e86Uniform\u3002 public Renderer() { transformation = new Transformation(); } public void init(Window window) throws Exception { // ... \u6b64\u524d\u7684\u4e00\u4e9b\u4ee3\u7801 ... // \u4e3a\u4e16\u754c\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u521b\u5efaUniform shaderProgram.createUniform(\"projectionMatrix\"); shaderProgram.createUniform(\"worldMatrix\"); window.setClearColor(0.0f, 0.0f, 0.0f, 0.0f); } \u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\uff0c\u73b0\u5728\u53ef\u4ee5\u63a5\u6536\u5230\u4e00\u4e2a GameItem \u7684\u6570\u7ec4\uff1a public void render(Window window, GameItem[] gameItems) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u6e32\u67d3\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u4e16\u754c\u77e9\u9635 Matrix4f worldMatrix = transformation.getWorldMatrix( gameItem.getPosition(), gameItem.getRotation(), gameItem.getScale()); shaderProgram.setUniform(\"worldMatrix\", worldMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c gameItem.getMesh().render(); } shaderProgram.unbind(); } \u6bcf\u6b21\u8c03\u7528 render \u65f6\u5c31\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21\uff0c\u8fd9\u6837\u6211\u4eec\u53ef\u4ee5\u5904\u7406\u7a97\u53e3\u5927\u5c0f\u7684\u8c03\u6574\u64cd\u4f5c\u3002\u7136\u540e\u6211\u4eec\u904d\u5386 GameItem \u6570\u7ec4\uff0c\u5e76\u6839\u636e\u5b83\u4eec\u5404\u81ea\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u521b\u5efa\u53d8\u6362\u77e9\u9635\uff0c\u8be5\u77e9\u9635\u5c06\u88ab\u4f20\u9012\u5230\u7740\u8272\u5668\u5e76\u7ed8\u5236 Mesh \u3002\u6295\u5f71\u77e9\u9635\u5bf9\u4e8e\u6240\u6709\u8981\u6e32\u67d3\u7684\u9879\u76ee\u90fd\u662f\u76f8\u540c\u7684\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u5728 Transformation \u7c7b\u4e2d\u662f\u5355\u72ec\u4e00\u4e2a\u53d8\u91cf\u7684\u539f\u56e0\u3002 \u6211\u4eec\u5c06\u6e32\u67d3\u4ee3\u7801\u79fb\u52a8\u5230 Mesh \u7c7b\u4e2d\uff1a public void render() { // \u7ed8\u5236Mesh glBindVertexArray(getVaoId()); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); // \u91cd\u7f6e\u72b6\u6001 glBindVertexArray(0); } \u9876\u70b9\u7740\u8272\u5668\u53ea\u9700\u7b80\u5355\u5730\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 worldMatrix \u77e9\u9635\uff0c\u7136\u540e\u7528\u5b83\u4e0e projectionMatrix \u4e00\u540c\u8ba1\u7b97\u5750\u6807\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4f60\u6240\u89c1\uff0c\u4ee3\u7801\u5b8c\u5168\u4e00\u81f4\u3002\u6211\u4eec\u4f7f\u7528Uniform\u6765\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\uff0c\u5e76\u4e14\u8003\u8651\u622a\u9525\u3001\u4f4d\u7f6e\u3001\u7f29\u653e\u548c\u65cb\u8f6c\u7b49\u3002 \u53e6\u5916\u4e00\u4e2a\u91cd\u8981\u7684\u95ee\u9898\u662f\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u76f4\u63a5\u4f7f\u7528\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u800c\u662f\u628a\u5b83\u4eec\u7ec4\u5408\u6210\u4e00\u4e2a\u4e16\u754c\u77e9\u9635\u5462\uff1f\u539f\u56e0\u662f\u6211\u4eec\u5e94\u8be5\u5c3d\u91cf\u51cf\u5c11\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u77e9\u9635\u3002\u8fd8\u8981\u8bb0\u4f4f\uff0c\u5728\u7740\u8272\u5668\u4e2d\u6240\u505a\u7684\u77e9\u9635\u4e58\u6cd5\u662f\u6bcf\u4e2a\u9876\u70b9\u4e00\u6b21\uff0c\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u8c03\u7528\u671f\u95f4\u4e0d\u4f1a\u6539\u53d8\uff0c\u800c\u6bcf\u4e00\u4e2a GameItem \u5b9e\u4f8b\u7684\u4e16\u754c\u77e9\u9635\u4e5f\u4e0d\u4f1a\u6539\u53d8\u3002\u5982\u679c\u72ec\u7acb\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u6211\u4eec\u8981\u505a\u66f4\u591a\u7684\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\u3002\u5728\u4e00\u4e2a\u6709\u8d85\u591a\u9876\u70b9\u7684\u6a21\u578b\u4e2d\uff0c\u8fd9\u662f\u5f88\u591a\u4f59\u7684\u64cd\u4f5c\u3002 \u4f46\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u60f3\uff0c\u5982\u679c\u6bcf\u4e2a GameItem \u4e2d\u7684\u4e16\u754c\u77e9\u9635\u90fd\u4e0d\u4f1a\u53d1\u751f\u53d8\u5316\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u5728Java\u7c7b\u4e2d\u505a\u77e9\u9635\u4e58\u6cd5\uff1f\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u4e0e\u6bcf\u4e2a GameItem \u76f8\u4e58\uff0c\u628a\u5b83\u4eec\u4f5c\u4e3a\u4e00\u4e2aUniform\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u786e\u5b9e\u80fd\u7701\u4e0b\u66f4\u591a\u7684\u64cd\u4f5c\u3002\u4f46\u5f53\u6211\u4eec\u5411\u6e38\u620f\u5f15\u64ce\u4e2d\u6dfb\u52a0\u66f4\u591a\u7684\u7279\u6027\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u6240\u4ee5\u6700\u597d\u72ec\u7acb\u5730\u5904\u7406\u8fd9\u4e24\u4e2a\u77e9\u9635\u3002 \u6700\u540e\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\uff0c\u8ba9\u5176\u4e0e Mesh \u5173\u8054\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e9b\u903b\u8f91\u6765\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u56db\u8fb9\u5f62\u3002\u56e0\u4e3a\u8fd9\u53ea\u662f\u4e2a\u6d4b\u8bd5\u793a\u4f8b\uff0c\u6ca1\u6709\u6dfb\u52a0\u592a\u591a\u5185\u5bb9\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u76f8\u5173\u4ee3\u7801\u3002","title":"\u4f7f\u7528\u53d8\u6362"},{"location":"07-textures/","text":"\u7eb9\u7406\uff08Textures\uff09 \u521b\u5efa\u4e00\u4e2a\u4e09\u7ef4\u7acb\u65b9\u4f53 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u4e2d\u52a0\u8f7d\u7eb9\u7406\u5e76\u4f7f\u7528\u5b83\u4eec\u3002\u4e3a\u4e86\u8bb2\u89e3\u4e0e\u7eb9\u7406\u76f8\u5173\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u628a\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u6b63\u65b9\u5f62\u66f4\u6539\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u7ed8\u5236\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6b63\u786e\u5730\u5b9a\u4e49\u4e00\u4e2a\u7acb\u65b9\u4f53\u7684\u5750\u6807\uff0c\u5c31\u80fd\u4f7f\u7528\u73b0\u6709\u4ee3\u7801\u6b63\u786e\u5730\u7ed8\u5236\u5b83\u3002 \u4e3a\u4e86\u7ed8\u5236\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u516b\u4e2a\u9876\u70b9\u3002 \u56e0\u6b64\uff0c\u5b83\u7684\u5750\u6807\u6570\u7ec4\u5c06\u662f\u8fd9\u6837\u7684\uff1a float[] positions = new float[] { // VO -0.5f, 0.5f, 0.5f, // V1 -0.5f, -0.5f, 0.5f, // V2 0.5f, -0.5f, 0.5f, // V3 0.5f, 0.5f, 0.5f, // V4 -0.5f, 0.5f, -0.5f, // V5 0.5f, 0.5f, -0.5f, // V6 -0.5f, -0.5f, -0.5f, // V7 0.5f, -0.5f, -0.5f, }; \u5f53\u7136\uff0c\u7531\u4e8e\u6211\u4eec\u591a\u4e864\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u9700\u8981\u66f4\u6539\u989c\u8272\u6570\u7ec4\uff0c\u76ee\u524d\u4ec5\u91cd\u590d\u524d\u56db\u9879\u7684\u503c\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u6700\u540e\uff0c\u7531\u4e8e\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u6784\u6210\u7684\uff0c\u9700\u8981\u7ed8\u5236\u5341\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u6bcf\u4e2a\u9762\u4e24\u4e2a\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4fee\u6539\u7d22\u5f15\u6570\u7ec4\u3002\u8bb0\u4f4f\u4e09\u89d2\u5f62\u5fc5\u987b\u6309\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\uff0c\u5982\u679c\u4f60\u76f4\u63a5\u53bb\u5b9a\u4e49\u4e09\u89d2\u5f62\uff0c\u5f88\u5bb9\u6613\u72af\u9519\u3002\u4e00\u5b9a\u8981\u5c06\u4f60\u60f3\u5b9a\u4e49\u7684\u9762\u6446\u5728\u4f60\u7684\u9762\u524d\uff0c\u786e\u8ba4\u9876\u70b9\u5e76\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 int[] indices = new int[] { // \u524d\u9762 0, 1, 3, 3, 1, 2, // \u4e0a\u9762 4, 0, 3, 5, 4, 3, // \u53f3\u9762 3, 2, 7, 5, 3, 7, // \u5de6\u9762 6, 1, 0, 6, 0, 4, // \u4e0b\u9762 2, 1, 6, 2, 6, 7, // \u540e\u9762 7, 6, 4, 7, 4, 5, }; \u4e3a\u4e86\u66f4\u597d\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u5c06\u4fee\u6539 DummyGame \u7c7b\u4e2d\u65cb\u8f6c\u6a21\u578b\u7684\u4ee3\u7801\uff0c\u4f7f\u6a21\u578b\u6cbf\u7740\u4e09\u4e2a\u8f74\u65cb\u8f6c\u3002 // \u66f4\u65b0\u65cb\u8f6c\u89d2 float rotation = gameItem.getRotation().x + 1.5f; if ( rotation > 360 ) { rotation = 0; } gameItem.setRotation(rotation, rotation, rotation); \u8fd9\u5c31\u5b8c\u4e86\uff0c\u73b0\u5728\u80fd\u591f\u663e\u793a\u4e00\u4e2a\u65cb\u8f6c\u7684\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e86\uff0c\u4f60\u53ef\u4ee5\u7f16\u8bd1\u548c\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u8fd9\u4e2a\u7acb\u65b9\u4f53\u6709\u4e9b\u5947\u602a\uff0c\u6709\u4e9b\u9762\u6ca1\u88ab\u6b63\u786e\u5730\u7ed8\u5236\uff0c\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u7acb\u65b9\u4f53\u4e4b\u6240\u4ee5\u51fa\u73b0\u8fd9\u4e2a\u73b0\u8c61\uff0c\u662f\u56e0\u4e3a\u7ec4\u6210\u7acb\u65b9\u4f53\u7684\u4e09\u89d2\u5f62\u662f\u4ee5\u4e00\u79cd\u968f\u673a\u987a\u5e8f\u7ed8\u5236\u7684\u3002\u4e8b\u5b9e\u4e0a\u8ddd\u79bb\u8f83\u8fdc\u7684\u50cf\u7d20\u5e94\u8be5\u5728\u8ddd\u79bb\u8f83\u8fd1\u7684\u50cf\u7d20\u4e4b\u524d\u7ed8\u5236\uff0c\u800c\u4e0d\u662f\u73b0\u5728\u8fd9\u6837\u3002\u4e3a\u4e86\u4fee\u590d\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\u3002 \u8fd9\u5c06\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u53bb\u505a\uff1a glEnable(GL_DEPTH_TEST); \u73b0\u5728\u7acb\u65b9\u4f53\u88ab\u6b63\u786e\u5730\u6e32\u67d3\u4e86\uff01 \u5982\u679c\u4f60\u770b\u4e86\u672c\u7ae0\u8be5\u5c0f\u8282\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230 Mesh \u7c7b\u505a\u4e86\u4e00\u4e0b\u5c0f\u89c4\u6a21\u7684\u8c03\u6574\uff0cVBO\u7684ID\u73b0\u5728\u88ab\u50a8\u5b58\u5728\u4e00\u4e2aList\u4e2d\uff0c\u4ee5\u4fbf\u4e8e\u8fed\u4ee3\u5b83\u4eec\u3002 \u4e3a\u7acb\u65b9\u4f53\u6dfb\u52a0\u7eb9\u7406 \u73b0\u5728\u6211\u4eec\u5c06\u628a\u7eb9\u7406\u5e94\u7528\u5230\u7acb\u65b9\u4f53\u4e0a\u3002\u7eb9\u7406\uff08Texture\uff09\u662f\u7528\u6765\u7ed8\u5236\u67d0\u4e2a\u6a21\u578b\u7684\u50cf\u7d20\u989c\u8272\u7684\u56fe\u50cf\uff0c\u53ef\u4ee5\u8ba4\u4e3a\u7eb9\u7406\u662f\u5305\u5728\u4e09\u7ef4\u6a21\u578b\u4e0a\u7684\u76ae\u80a4\u3002\u4f60\u8981\u505a\u7684\u662f\u5c06\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u70b9\u5206\u914d\u7ed9\u6a21\u578b\u4e2d\u7684\u9876\u70b9\uff0c\u8fd9\u6837\u505aOpenGL\u5c31\u80fd\u6839\u636e\u7eb9\u7406\u56fe\u50cf\u8ba1\u7b97\u5176\u4ed6\u50cf\u7d20\u7684\u989c\u8272\u3002 \u7eb9\u7406\u56fe\u50cf\u4e0d\u5fc5\u4e0e\u6a21\u578b\u540c\u6837\u5927\u5c0f\uff0c\u5b83\u53ef\u4ee5\u53d8\u5927\u6216\u53d8\u5c0f\u3002\u5982\u679c\u8981\u5904\u7406\u7684\u50cf\u7d20\u4e0d\u80fd\u6620\u5c04\u5230\u7eb9\u7406\u4e2d\u7684\u6307\u5b9a\u70b9\uff0cOpenGL\u5c06\u63a8\u65ad\u989c\u8272\u3002\u53ef\u5728\u521b\u5efa\u7eb9\u7406\u65f6\u63a7\u5236\u5982\u4f55\u8fdb\u884c\u989c\u8272\u63a8\u65ad\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u5c06\u7eb9\u7406\u5e94\u7528\u5230\u6a21\u578b\u4e0a\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u662f\u5c06\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u6bcf\u4e2a\u9876\u70b9\u3002\u7eb9\u7406\u5750\u6807\u7cfb\u6709\u4e9b\u4e0d\u540c\u4e8e\u6a21\u578b\u5750\u6807\u7cfb\u3002\u9996\u5148\uff0c\u6211\u4eec\u7684\u7eb9\u7406\u662f\u4e8c\u7ef4\u7eb9\u7406\uff0c\u6240\u4ee5\u5750\u6807\u53ea\u6709X\u548cY\u4e24\u4e2a\u91cf\u3002\u6b64\u5916\uff0c\u539f\u70b9\u662f\u56fe\u50cf\u7684\u5de6\u4e0a\u89d2\uff0cX\u6216Y\u7684\u6700\u5927\u503c\u90fd\u662f1\u3002 \u6211\u4eec\u5982\u4f55\u5c06\u7eb9\u7406\u5750\u6807\u4e0e\u4f4d\u7f6e\u5750\u6807\u8054\u7cfb\u8d77\u6765\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5c31\u50cf\u4f20\u9012\u989c\u8272\u4fe1\u606f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2aVBO\uff0c\u4e3a\u6bcf\u4e2a\u9876\u70b9\u50a8\u5b58\u5176\u7eb9\u7406\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e0a\u4f7f\u7528\u7eb9\u7406\u5427\u3002\u9996\u5148\u662f\u52a0\u8f7d\u5c06\u88ab\u7528\u4f5c\u7eb9\u7406\u7684\u56fe\u50cf\u3002\u5bf9\u6b64\u5728LWJGL\u7684\u65e9\u671f\u7248\u672c\u4e2d\uff0c\u901a\u5e38\u4f7f\u7528Slick2D\u5e93\u3002\u5728\u64b0\u5199\u672c\u6587\u65f6\uff0c\u8be5\u5e93\u4f3c\u4e4e\u4e0eLWJGL 3\u4e0d\u517c\u5bb9\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u4f7f\u7528LWJGL\u4e3a stb \u5e93\u63d0\u4f9b\u7684\u5c01\u88c5\u3002\u4e3a\u4e86\u4f7f\u7528\u5b83\uff0c\u9996\u5148\u9700\u8981\u5728\u672c\u5730\u7684 pom.xml \u6587\u4ef6\u4e2d\u58f0\u660e\u4f9d\u8d56\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> </dependency> [...] <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u4e00\u4e9b\u6559\u7a0b\u4e2d\uff0c\u4f60\u53ef\u80fd\u770b\u5230\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u8c03\u7528 glEnable(GL_TEXTURE_2D) \u6765\u542f\u7528OpenGL\u73af\u5883\u4e2d\u7684\u7eb9\u7406\u3002\u5982\u679c\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\u8fd9\u662f\u5bf9\u7684\uff0c\u4f46\u6211\u4eec\u4f7f\u7528GLSL\u7740\u8272\u5668\uff0c\u56e0\u6b64\u4e0d\u518d\u9700\u8981\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 Texture \u7c7b\uff0c\u5b83\u5c06\u6267\u884c\u52a0\u8f7d\u7eb9\u7406\u6240\u5fc5\u987b\u7684\u6b65\u9aa4\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5c06\u56fe\u50cf\u8f7d\u5165\u5230 ByteBuffer \u4e2d\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a private static int loadTexture(String fileName) throws Exception { int width; int height; ByteBuffer buf; // \u52a0\u8f7d\u7eb9\u7406\u6587\u4ef6 try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer w = stack.mallocInt(1); IntBuffer h = stack.mallocInt(1); IntBuffer channels = stack.mallocInt(1); buf = stbi_load(fileName, w, h, channels, 4); if (buf == null) { throw new Exception(\"Image file [\" + fileName + \"] not loaded: \" + stbi_failure_reason()); } /* \u83b7\u5f97\u56fe\u50cf\u7684\u9ad8\u5ea6\u4e0e\u5bbd\u5ea6 */ width = w.get(); height = h.get(); } [... \u63a5\u4e0b\u6765\u8fd8\u6709\u66f4\u591a\u4ee3\u7801 ...] \u9996\u5148\u6211\u4eec\u8981\u4e3a\u5e93\u5206\u914d IntBuffer \uff0c\u4ee5\u8fd4\u56de\u56fe\u50cf\u5927\u5c0f\u4e0e\u901a\u9053\u6570\u3002\u7136\u540e\uff0c\u6211\u4eec\u8c03\u7528 stbi_load \u65b9\u6cd5\u5c06\u56fe\u50cf\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u5982\u4e0b\u53c2\u6570\uff1a filePath \uff1a\u6587\u4ef6\u7684\u7edd\u5bf9\u8def\u5f84\u3002stb\u5e93\u662f\u672c\u5730\u7684\uff0c\u4e0d\u77e5\u9053\u5173\u4e8e CLASSPATH \u7684\u4efb\u4f55\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5e38\u89c4\u7684\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 width \uff1a\u56fe\u50cf\u5bbd\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u5bbd\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 height \uff1a\u56fe\u50cf\u9ad8\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u9ad8\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 channels \uff1a\u56fe\u50cf\u901a\u9053\u3002 desired_channels \uff1a\u6240\u9700\u7684\u56fe\u50cf\u901a\u9053\uff0c\u6211\u4eec\u4f20\u51654\uff08RGBA\uff09\u3002 \u4e00\u4ef6\u5173\u4e8eOpenGL\u7684\u91cd\u8981\u4e8b\u9879\uff0c\u7531\u4e8e\u5386\u53f2\u539f\u56e0\uff0c\u8981\u6c42\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u6bcf\u4e2a\u8f74\u7684\u50cf\u7d20\u6570\uff09\u5fc5\u987b\u662f\u4e8c\u7684\u6307\u6570\uff082, 4, 8, 16, ....\uff09\u3002\u4e00\u4e9b\u9a71\u52a8\u89e3\u9664\u4e86\u8fd9\u79cd\u9650\u5236\uff0c\u4f46\u6700\u597d\u8fd8\u662f\u4fdd\u6301\u4ee5\u514d\u51fa\u73b0\u95ee\u9898\u3002 \u4e0b\u4e00\u6b65\u662f\u5c06\u7eb9\u7406\u4e0a\u4f20\u5230\u663e\u5b58\u4e2d\u3002\u9996\u5148\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7eb9\u7406ID\uff0c\u4e0e\u8be5\u7eb9\u7406\u76f8\u5173\u7684\u64cd\u4f5c\u90fd\u8981\u4f7f\u7528\u8be5ID\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u5b83\u3002 // \u521b\u5efa\u4e00\u4e2a\u65b0\u7684OpenGL\u7eb9\u7406 int textureId = glGenTextures(); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, textureId); \u7136\u540e\u9700\u8981\u544a\u8bc9OpenGL\u5982\u4f55\u89e3\u5305RGBA\u5b57\u8282\uff0c\u7531\u4e8e\u6bcf\u4e2a\u5206\u91cf\u53ea\u6709\u4e00\u4e2a\u5b57\u8282\u5927\u5c0f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u4ee5\u4e0b\u4ee3\u7801\uff1a glPixelStorei(GL_UNPACK_ALIGNMENT, 1); \u6700\u540e\u6211\u4eec\u53ef\u4ee5\u4e0a\u4f20\u7eb9\u7406\u6570\u636e\uff1a glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, buf); glTexImage2D \u7684\u53c2\u6570\u5982\u4e0b\u6240\u793a\uff1a target : \u6307\u5b9a\u76ee\u6807\u7eb9\u7406\uff08\u7eb9\u7406\u7c7b\u578b\uff09\uff0c\u672c\u4f8b\u4e2d\u662f GL_TEXTURE_2D \u3002 level : \u6307\u5b9a\u7eb9\u7406\u7ec6\u8282\u7684\u7b49\u7ea7\u30020\u7ea7\u662f\u57fa\u672c\u56fe\u50cf\u7b49\u7ea7\uff0c\u7b2cn\u7ea7\u662f\u7b2cn\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u7684\u56fe\u50cf\uff0c\u4e4b\u540e\u518d\u8c08\u8bba\u8fd9\u4e2a\u95ee\u9898\u3002 internal format : \u6307\u5b9a\u7eb9\u7406\u4e2d\u989c\u8272\u5206\u91cf\u7684\u6570\u91cf\u3002 width : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u5bbd\u5ea6\u3002 height : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u9ad8\u5ea6\u3002 border : \u6b64\u503c\u5fc5\u987b\u4e3a0\u3002 format : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u683c\u5f0f\uff0c\u73b0\u5728\u4e3aRGBA\u3002 type : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u7c7b\u578b\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65e0\u7b26\u53f7\u5b57\u8282\u3002 data : \u50a8\u5b58\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002 \u5728\u4e00\u4e9b\u4ee3\u7801\u4e2d\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5728\u8c03\u7528 glTexImage2D \u65b9\u6cd5\u524d\u8bbe\u7f6e\u4e86\u4e00\u4e9b\u8fc7\u6ee4\u53c2\u6570\u3002\u8fc7\u6ee4\u662f\u6307\u5728\u7f29\u653e\u65f6\u5982\u4f55\u7ed8\u5236\u56fe\u50cf\uff0c\u4ee5\u53ca\u5982\u4f55\u63d2\u503c\u50cf\u7d20\u3002\u5982\u679c\u672a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff0c\u7eb9\u7406\u5c06\u4e0d\u4f1a\u663e\u793a\u3002\u56e0\u6b64\uff0c\u5728 glTexImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u524d\uff0c\u4f1a\u770b\u5230\u4ee5\u4e0b\u4ee3\u7801\uff1a glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u8fd9\u4e9b\u53c2\u6570\u57fa\u672c\u4e0a\u5728\u8bf4\uff0c\u5f53\u7ed8\u5236\u4e00\u4e2a\u50cf\u7d20\u65f6\uff0c\u5982\u679c\u6ca1\u6709\u76f4\u63a5\u4e00\u5bf9\u4e00\u5730\u5173\u8054\u5230\u7eb9\u7406\u5750\u6807\uff0c\u5b83\u5c06\u9009\u62e9\u6700\u8fd1\u7684\u7eb9\u7406\u5750\u6807\u70b9\u3002 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e0d\u4f1a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u751f\u6210\u4e00\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u662f\u7531\u9ad8\u7ec6\u8282\u7eb9\u7406\u751f\u6210\u7684\u9010\u7ea7\u964d\u4f4e\u5206\u8fa8\u7387\u7684\u7eb9\u7406\u96c6\u5408\u3002\u5f53\u6211\u4eec\u7684\u7269\u4f53\u7f29\u653e\u65f6\uff0c\u5c31\u5c06\u81ea\u52a8\u4f7f\u7528\u4f4e\u5206\u8fa8\u7387\u7684\u56fe\u50cf\u3002 \u4e3a\u4e86\u751f\u6210\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff0c\u53ea\u9700\u8981\u7f16\u5199\u4ee5\u4e0b\u4ee3\u7801\uff08\u76ee\u524d\u6211\u4eec\u628a\u5b83\u653e\u5728 glTextImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u540e\uff09\uff1a glGenerateMipmap(GL_TEXTURE_2D); \u6700\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u91ca\u653e\u539f\u59cb\u56fe\u50cf\u6570\u636e\u672c\u8eab\u7684\u5185\u5b58\uff1a stbi_image_free(buf); \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u5df2\u7ecf\u6210\u529f\u5730\u52a0\u8f7d\u4e86\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6b63\u5982\u6b64\u524d\u6240\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u628a\u7eb9\u7406\u5750\u6807\u4f5c\u4e3a\u53e6\u4e00\u4e2aVBO\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u4fee\u6539 Mesh \u7c7b\u4ee5\u63a5\u6536\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u800c\u4e0d\u662f\u989c\u8272\uff08\u6211\u4eec\u53ef\u4ee5\u540c\u65f6\u6709\u989c\u8272\u548c\u7eb9\u7406\uff0c\u4f46\u4e3a\u4e86\u7b80\u5316\u5b83\uff0c\u6211\u4eec\u5c06\u5220\u9664\u989c\u8272\uff09\uff0c\u6784\u9020\u51fd\u6570\u73b0\u5728\u5982\u4e0b\u6240\u793a\uff1a public Mesh(float[] positions, float[] textCoords, int[] indices, Texture texture) \u7eb9\u7406\u5750\u6807VBO\u4e0e\u989c\u8272VBO\u521b\u5efa\u7684\u65b9\u5f0f\u76f8\u540c\u3002\u552f\u4e00\u7684\u533a\u522b\u662f\u5b83\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\u800c\u4e0d\u662f\u4e09\u4e2a\uff1a vboId = glGenBuffers(); vboIdList.add(vboId); textCoordsBuffer = MemoryUtil.memAllocFloat(textCoords.length); textCoordsBuffer.put(textCoords).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, textCoordsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 2, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4fee\u6539\u4e86\u7b2c\u4e8c\u4e2a\u8f93\u5165\u53c2\u6570\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u662f\u4e00\u4e2a vec2 \uff08\u4e5f\u987a\u4fbf\u66f4\u6539\u4e86\u540d\u79f0\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c31\u50cf\u6b64\u524d\u4e00\u6837\uff0c\u4ec5\u5c06\u7eb9\u7406\u5750\u6807\u4f20\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; out vec2 outTexCoord; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u90a3\u4e9b\u7eb9\u7406\u5750\u6807\u6765\u8bbe\u7f6e\u50cf\u7d20\u989c\u8272\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5728\u5206\u6790\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u7406\u6e05\u4e00\u4e9b\u6982\u5ff5\u3002\u663e\u5361\u6709\u51e0\u4e2a\u7a7a\u95f4\u6216\u69fd\u6765\u50a8\u5b58\u7eb9\u7406\uff0c\u6bcf\u4e00\u4e2a\u7a7a\u95f4\u88ab\u79f0\u4e3a\u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\u3002\u5f53\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u6211\u4eec\u5fc5\u987b\u8bbe\u7f6e\u60f3\u7528\u7684\u7eb9\u7406\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a texture_sampler \u7684\u65b0Uniform\uff0c\u8be5Uniform\u7684\u7c7b\u578b\u662f sampler2D \uff0c\u5e76\u50a8\u5b58\u6709\u6211\u4eec\u5e0c\u671b\u4f7f\u7528\u7684\u7eb9\u7406\u5355\u5143\u7684\u503c\u3002 \u5728 main \u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u540d\u4e3a texture \u7684\u7eb9\u7406\u91c7\u6837\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u6709\u4e24\u4e2a\u53c2\u6570\uff1a\u53d6\u6837\u5668\uff08Sampler\uff09\u548c\u7eb9\u7406\u5750\u6807\uff0c\u5e76\u8fd4\u56de\u6b63\u786e\u7684\u989c\u8272\u3002\u53d6\u6837\u5668Uniform\u5141\u8bb8\u4f7f\u7528\u591a\u91cd\u7eb9\u7406\uff08Multi-texture\uff09\uff0c\u4e0d\u8fc7\u73b0\u5728\u4e0d\u662f\u8ba8\u8bba\u8fd9\u4e2a\u8bdd\u9898\u7684\u65f6\u5019\uff0c\u4f46\u662f\u6211\u4eec\u4f1a\u5728\u7a0d\u540e\u518d\u5c1d\u8bd5\u6dfb\u52a0\u3002 \u56e0\u6b64\uff0c\u5728 ShaderProgram \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u5141\u8bb8\u4e3a\u6574\u6570\u578bUniform\u8bbe\u7f6e\u503c\uff1a public void setUniform(String uniformName, int value) { glUniform1i(uniforms.get(uniformName), value); } \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684Uniform\uff1a shaderProgram.createUniform(\"texture_sampler\"); \u6b64\u5916\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06Uniform\u7684\u503c\u8bbe\u7f6e\u4e3a0\uff08\u6211\u4eec\u73b0\u5728\u4e0d\u4f7f\u7528\u591a\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u53ea\u4f7f\u7528\u5355\u51430\uff09\u3002 shaderProgram.setUniform(\"texture_sampler\", 0); \u6700\u597d\uff0c\u6211\u4eec\u53ea\u9700\u4fee\u6539 Mesh \u7c7b\u7684 render \u65b9\u6cd5\u5c31\u53ef\u4ee5\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u65b9\u6cd5\u8d77\u59cb\u5904\uff0c\u6dfb\u52a0\u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\uff1a // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5355\u5143 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); \u6211\u4eec\u5df2\u7ecf\u5c06 texture.getId() \u6240\u83b7\u5f97\u7684\u7eb9\u7406ID\u7ed1\u5b9a\u5230\u7eb9\u7406\u5355\u51430\u4e0a\u3002 \u6211\u4eec\u521a\u521a\u4fee\u6539\u4e86\u4ee3\u7801\u6765\u652f\u6301\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\uff0c\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\u662f\u8fd9\u6837\u7684\uff1a \u5728\u6211\u4eec\u7684\u4e09\u7ef4\u6a21\u578b\u4e2d\uff0c\u5171\u6709\u516b\u4e2a\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u5b9a\u4e49\u6b63\u9762\u6bcf\u4e2a\u9876\u70b9\u7684\u7eb9\u7406\u5750\u6807\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V0 0.0, 0.0 V1 0.0, 0.5 V2 0.5, 0.5 V3 0.5, 0.0 \u7136\u540e\uff0c\u5b9a\u4e49\u9876\u9762\u7684\u7eb9\u7406\u6620\u5c04\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V4 0.0, 0.5 V5 0.5, 0.5 V0 0.0, 1.0 V3 0.5, 1.0 \u5982\u4f60\u6240\u89c1\uff0c\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u540c\u4e00\u4e2a\u9876\u70b9\uff08V0\u548cV3\uff09\u8bbe\u7f6e\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u600e\u4e48\u6837\u624d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u5462\uff1f\u89e3\u51b3\u8fd9\u4e00\u95ee\u9898\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u91cd\u590d\u4e00\u4e9b\u9876\u70b9\u5e76\u5173\u8054\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u5bf9\u4e8e\u9876\u9762\uff0c\u6211\u4eec\u9700\u8981\u91cd\u590d\u56db\u4e2a\u9876\u70b9\u5e76\u4e3a\u5b83\u4eec\u5206\u914d\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u3002 \u56e0\u4e3a\u524d\u9762\u3001\u540e\u9762\u548c\u4fa7\u9762\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u9700\u8981\u91cd\u590d\u8fd9\u4e9b\u9876\u70b9\u3002\u5728\u6e90\u7801\u4e2d\u6709\u5b8c\u6574\u7684\u5b9a\u4e49\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ece8\u4e2a\u70b9\u4e0a\u5347\u523020\u4e2a\u70b9\u4e86\u3002\u6700\u7ec8\u7684\u7ed3\u679c\u5c31\u50cf\u8fd9\u6837\u3002 \u5728\u63a5\u4e0b\u6765\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u75313D\u5efa\u6a21\u5de5\u5177\u751f\u6210\u7684\u6a21\u578b\uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u624b\u52a8\u5b9a\u4e49\u9876\u70b9\u548c\u7eb9\u7406\u5750\u6807\u4e86\uff08\u987a\u4fbf\u4e00\u63d0\uff0c\u5bf9\u4e8e\u66f4\u590d\u6742\u7684\u6a21\u578b\uff0c\u624b\u52a8\u5b9a\u4e49\u662f\u4e0d\u5b58\u5728\u7684\uff09\u3002 \u900f\u660e\u7eb9\u7406\u7b80\u4ecb \u5982\u4f60\u6240\u89c1\uff0c\u5f53\u52a0\u8f7d\u56fe\u50cf\u65f6\uff0c\u6211\u4eec\u68c0\u7d22\u4e86\u56db\u4e2aRGBA\u7ec4\u4ef6\uff0c\u5305\u62ec\u900f\u660e\u5ea6\u7b49\u7ea7\u3002\u4f46\u5982\u679c\u52a0\u8f7d\u4e00\u4e2a\u900f\u660e\u7684\u7eb9\u7406\uff0c\u53ef\u80fd\u770b\u4e0d\u5230\u4efb\u4f55\u4e1c\u897f\u3002\u4e3a\u4e86\u652f\u6301\u900f\u660e\u5ea6\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u4ee5\u4e0b\u4ee3\u7801\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff1a glEnable(GL_BLEND); \u4f46\u4ec5\u542f\u7528\u6df7\u5408\uff0c\u900f\u660e\u6548\u679c\u4ecd\u7136\u4e0d\u4f1a\u663e\u793a\uff0c\u6211\u4eec\u8fd8\u9700\u8981\u6307\u793aOpenGL\u5982\u4f55\u8fdb\u884c\u6df7\u5408\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glBlendFunc \u65b9\u6cd5\u5b8c\u6210\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u4f60\u53ef\u4ee5\u67e5\u770b \u6b64\u5904 \u6709\u5173\u53ef\u4f7f\u7528\u7684\u4e0d\u540c\u529f\u80fd\u7684\u8be6\u7ec6\u8bf4\u660e\u3002 \u5373\u4f7f\u542f\u7528\u4e86\u6df7\u5408\u5e76\u8bbe\u7f6e\u4e86\u529f\u80fd\uff0c\u4e5f\u53ef\u80fd\u770b\u4e0d\u5230\u6b63\u786e\u7684\u900f\u660e\u6548\u679c\u3002\u5176\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5f53\u4f7f\u7528\u6df1\u5ea6\u503c\u4e22\u5f03\u7247\u5143\u65f6\uff0c\u6211\u4eec\u53ef\u80fd\u5c06\u5177\u6709\u900f\u660e\u5ea6\u7684\u7247\u5143\u4e0e\u80cc\u666f\u6df7\u5408\uff0c\u800c\u4e0d\u662f\u4e0e\u5b83\u4eec\u540e\u9762\u7684\u7247\u5143\u6df7\u5408\uff0c\u8fd9\u5c06\u5f97\u5230\u9519\u8bef\u7684\u6e32\u67d3\u7ed3\u679c\u3002\u4e3a\u4e86\u89e3\u51b3\u8be5\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u5148\u7ed8\u5236\u4e0d\u900f\u660e\u7269\u4f53\uff0c\u7136\u540e\u6309\u6df1\u5ea6\u9012\u51cf\u987a\u5e8f\u7ed8\u5236\u5177\u6709\u900f\u660e\u5ea6\u7684\u7269\u4f53\uff08\u5e94\u5148\u7ed8\u5236\u8f83\u8fdc\u7269\u4f53\uff09\u3002","title":"\u7eb9\u7406"},{"location":"07-textures/#textures","text":"","title":"\u7eb9\u7406\uff08Textures\uff09"},{"location":"07-textures/#_1","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u4e2d\u52a0\u8f7d\u7eb9\u7406\u5e76\u4f7f\u7528\u5b83\u4eec\u3002\u4e3a\u4e86\u8bb2\u89e3\u4e0e\u7eb9\u7406\u76f8\u5173\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u628a\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u6b63\u65b9\u5f62\u66f4\u6539\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u7ed8\u5236\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6b63\u786e\u5730\u5b9a\u4e49\u4e00\u4e2a\u7acb\u65b9\u4f53\u7684\u5750\u6807\uff0c\u5c31\u80fd\u4f7f\u7528\u73b0\u6709\u4ee3\u7801\u6b63\u786e\u5730\u7ed8\u5236\u5b83\u3002 \u4e3a\u4e86\u7ed8\u5236\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u516b\u4e2a\u9876\u70b9\u3002 \u56e0\u6b64\uff0c\u5b83\u7684\u5750\u6807\u6570\u7ec4\u5c06\u662f\u8fd9\u6837\u7684\uff1a float[] positions = new float[] { // VO -0.5f, 0.5f, 0.5f, // V1 -0.5f, -0.5f, 0.5f, // V2 0.5f, -0.5f, 0.5f, // V3 0.5f, 0.5f, 0.5f, // V4 -0.5f, 0.5f, -0.5f, // V5 0.5f, 0.5f, -0.5f, // V6 -0.5f, -0.5f, -0.5f, // V7 0.5f, -0.5f, -0.5f, }; \u5f53\u7136\uff0c\u7531\u4e8e\u6211\u4eec\u591a\u4e864\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u9700\u8981\u66f4\u6539\u989c\u8272\u6570\u7ec4\uff0c\u76ee\u524d\u4ec5\u91cd\u590d\u524d\u56db\u9879\u7684\u503c\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u6700\u540e\uff0c\u7531\u4e8e\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u6784\u6210\u7684\uff0c\u9700\u8981\u7ed8\u5236\u5341\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u6bcf\u4e2a\u9762\u4e24\u4e2a\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4fee\u6539\u7d22\u5f15\u6570\u7ec4\u3002\u8bb0\u4f4f\u4e09\u89d2\u5f62\u5fc5\u987b\u6309\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\uff0c\u5982\u679c\u4f60\u76f4\u63a5\u53bb\u5b9a\u4e49\u4e09\u89d2\u5f62\uff0c\u5f88\u5bb9\u6613\u72af\u9519\u3002\u4e00\u5b9a\u8981\u5c06\u4f60\u60f3\u5b9a\u4e49\u7684\u9762\u6446\u5728\u4f60\u7684\u9762\u524d\uff0c\u786e\u8ba4\u9876\u70b9\u5e76\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 int[] indices = new int[] { // \u524d\u9762 0, 1, 3, 3, 1, 2, // \u4e0a\u9762 4, 0, 3, 5, 4, 3, // \u53f3\u9762 3, 2, 7, 5, 3, 7, // \u5de6\u9762 6, 1, 0, 6, 0, 4, // \u4e0b\u9762 2, 1, 6, 2, 6, 7, // \u540e\u9762 7, 6, 4, 7, 4, 5, }; \u4e3a\u4e86\u66f4\u597d\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u5c06\u4fee\u6539 DummyGame \u7c7b\u4e2d\u65cb\u8f6c\u6a21\u578b\u7684\u4ee3\u7801\uff0c\u4f7f\u6a21\u578b\u6cbf\u7740\u4e09\u4e2a\u8f74\u65cb\u8f6c\u3002 // \u66f4\u65b0\u65cb\u8f6c\u89d2 float rotation = gameItem.getRotation().x + 1.5f; if ( rotation > 360 ) { rotation = 0; } gameItem.setRotation(rotation, rotation, rotation); \u8fd9\u5c31\u5b8c\u4e86\uff0c\u73b0\u5728\u80fd\u591f\u663e\u793a\u4e00\u4e2a\u65cb\u8f6c\u7684\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e86\uff0c\u4f60\u53ef\u4ee5\u7f16\u8bd1\u548c\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u8fd9\u4e2a\u7acb\u65b9\u4f53\u6709\u4e9b\u5947\u602a\uff0c\u6709\u4e9b\u9762\u6ca1\u88ab\u6b63\u786e\u5730\u7ed8\u5236\uff0c\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u7acb\u65b9\u4f53\u4e4b\u6240\u4ee5\u51fa\u73b0\u8fd9\u4e2a\u73b0\u8c61\uff0c\u662f\u56e0\u4e3a\u7ec4\u6210\u7acb\u65b9\u4f53\u7684\u4e09\u89d2\u5f62\u662f\u4ee5\u4e00\u79cd\u968f\u673a\u987a\u5e8f\u7ed8\u5236\u7684\u3002\u4e8b\u5b9e\u4e0a\u8ddd\u79bb\u8f83\u8fdc\u7684\u50cf\u7d20\u5e94\u8be5\u5728\u8ddd\u79bb\u8f83\u8fd1\u7684\u50cf\u7d20\u4e4b\u524d\u7ed8\u5236\uff0c\u800c\u4e0d\u662f\u73b0\u5728\u8fd9\u6837\u3002\u4e3a\u4e86\u4fee\u590d\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\u3002 \u8fd9\u5c06\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u53bb\u505a\uff1a glEnable(GL_DEPTH_TEST); \u73b0\u5728\u7acb\u65b9\u4f53\u88ab\u6b63\u786e\u5730\u6e32\u67d3\u4e86\uff01 \u5982\u679c\u4f60\u770b\u4e86\u672c\u7ae0\u8be5\u5c0f\u8282\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230 Mesh \u7c7b\u505a\u4e86\u4e00\u4e0b\u5c0f\u89c4\u6a21\u7684\u8c03\u6574\uff0cVBO\u7684ID\u73b0\u5728\u88ab\u50a8\u5b58\u5728\u4e00\u4e2aList\u4e2d\uff0c\u4ee5\u4fbf\u4e8e\u8fed\u4ee3\u5b83\u4eec\u3002","title":"\u521b\u5efa\u4e00\u4e2a\u4e09\u7ef4\u7acb\u65b9\u4f53"},{"location":"07-textures/#_2","text":"\u73b0\u5728\u6211\u4eec\u5c06\u628a\u7eb9\u7406\u5e94\u7528\u5230\u7acb\u65b9\u4f53\u4e0a\u3002\u7eb9\u7406\uff08Texture\uff09\u662f\u7528\u6765\u7ed8\u5236\u67d0\u4e2a\u6a21\u578b\u7684\u50cf\u7d20\u989c\u8272\u7684\u56fe\u50cf\uff0c\u53ef\u4ee5\u8ba4\u4e3a\u7eb9\u7406\u662f\u5305\u5728\u4e09\u7ef4\u6a21\u578b\u4e0a\u7684\u76ae\u80a4\u3002\u4f60\u8981\u505a\u7684\u662f\u5c06\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u70b9\u5206\u914d\u7ed9\u6a21\u578b\u4e2d\u7684\u9876\u70b9\uff0c\u8fd9\u6837\u505aOpenGL\u5c31\u80fd\u6839\u636e\u7eb9\u7406\u56fe\u50cf\u8ba1\u7b97\u5176\u4ed6\u50cf\u7d20\u7684\u989c\u8272\u3002 \u7eb9\u7406\u56fe\u50cf\u4e0d\u5fc5\u4e0e\u6a21\u578b\u540c\u6837\u5927\u5c0f\uff0c\u5b83\u53ef\u4ee5\u53d8\u5927\u6216\u53d8\u5c0f\u3002\u5982\u679c\u8981\u5904\u7406\u7684\u50cf\u7d20\u4e0d\u80fd\u6620\u5c04\u5230\u7eb9\u7406\u4e2d\u7684\u6307\u5b9a\u70b9\uff0cOpenGL\u5c06\u63a8\u65ad\u989c\u8272\u3002\u53ef\u5728\u521b\u5efa\u7eb9\u7406\u65f6\u63a7\u5236\u5982\u4f55\u8fdb\u884c\u989c\u8272\u63a8\u65ad\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u5c06\u7eb9\u7406\u5e94\u7528\u5230\u6a21\u578b\u4e0a\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u662f\u5c06\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u6bcf\u4e2a\u9876\u70b9\u3002\u7eb9\u7406\u5750\u6807\u7cfb\u6709\u4e9b\u4e0d\u540c\u4e8e\u6a21\u578b\u5750\u6807\u7cfb\u3002\u9996\u5148\uff0c\u6211\u4eec\u7684\u7eb9\u7406\u662f\u4e8c\u7ef4\u7eb9\u7406\uff0c\u6240\u4ee5\u5750\u6807\u53ea\u6709X\u548cY\u4e24\u4e2a\u91cf\u3002\u6b64\u5916\uff0c\u539f\u70b9\u662f\u56fe\u50cf\u7684\u5de6\u4e0a\u89d2\uff0cX\u6216Y\u7684\u6700\u5927\u503c\u90fd\u662f1\u3002 \u6211\u4eec\u5982\u4f55\u5c06\u7eb9\u7406\u5750\u6807\u4e0e\u4f4d\u7f6e\u5750\u6807\u8054\u7cfb\u8d77\u6765\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5c31\u50cf\u4f20\u9012\u989c\u8272\u4fe1\u606f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2aVBO\uff0c\u4e3a\u6bcf\u4e2a\u9876\u70b9\u50a8\u5b58\u5176\u7eb9\u7406\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e0a\u4f7f\u7528\u7eb9\u7406\u5427\u3002\u9996\u5148\u662f\u52a0\u8f7d\u5c06\u88ab\u7528\u4f5c\u7eb9\u7406\u7684\u56fe\u50cf\u3002\u5bf9\u6b64\u5728LWJGL\u7684\u65e9\u671f\u7248\u672c\u4e2d\uff0c\u901a\u5e38\u4f7f\u7528Slick2D\u5e93\u3002\u5728\u64b0\u5199\u672c\u6587\u65f6\uff0c\u8be5\u5e93\u4f3c\u4e4e\u4e0eLWJGL 3\u4e0d\u517c\u5bb9\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u4f7f\u7528LWJGL\u4e3a stb \u5e93\u63d0\u4f9b\u7684\u5c01\u88c5\u3002\u4e3a\u4e86\u4f7f\u7528\u5b83\uff0c\u9996\u5148\u9700\u8981\u5728\u672c\u5730\u7684 pom.xml \u6587\u4ef6\u4e2d\u58f0\u660e\u4f9d\u8d56\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> </dependency> [...] <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u4e00\u4e9b\u6559\u7a0b\u4e2d\uff0c\u4f60\u53ef\u80fd\u770b\u5230\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u8c03\u7528 glEnable(GL_TEXTURE_2D) \u6765\u542f\u7528OpenGL\u73af\u5883\u4e2d\u7684\u7eb9\u7406\u3002\u5982\u679c\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\u8fd9\u662f\u5bf9\u7684\uff0c\u4f46\u6211\u4eec\u4f7f\u7528GLSL\u7740\u8272\u5668\uff0c\u56e0\u6b64\u4e0d\u518d\u9700\u8981\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 Texture \u7c7b\uff0c\u5b83\u5c06\u6267\u884c\u52a0\u8f7d\u7eb9\u7406\u6240\u5fc5\u987b\u7684\u6b65\u9aa4\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5c06\u56fe\u50cf\u8f7d\u5165\u5230 ByteBuffer \u4e2d\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a private static int loadTexture(String fileName) throws Exception { int width; int height; ByteBuffer buf; // \u52a0\u8f7d\u7eb9\u7406\u6587\u4ef6 try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer w = stack.mallocInt(1); IntBuffer h = stack.mallocInt(1); IntBuffer channels = stack.mallocInt(1); buf = stbi_load(fileName, w, h, channels, 4); if (buf == null) { throw new Exception(\"Image file [\" + fileName + \"] not loaded: \" + stbi_failure_reason()); } /* \u83b7\u5f97\u56fe\u50cf\u7684\u9ad8\u5ea6\u4e0e\u5bbd\u5ea6 */ width = w.get(); height = h.get(); } [... \u63a5\u4e0b\u6765\u8fd8\u6709\u66f4\u591a\u4ee3\u7801 ...] \u9996\u5148\u6211\u4eec\u8981\u4e3a\u5e93\u5206\u914d IntBuffer \uff0c\u4ee5\u8fd4\u56de\u56fe\u50cf\u5927\u5c0f\u4e0e\u901a\u9053\u6570\u3002\u7136\u540e\uff0c\u6211\u4eec\u8c03\u7528 stbi_load \u65b9\u6cd5\u5c06\u56fe\u50cf\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u5982\u4e0b\u53c2\u6570\uff1a filePath \uff1a\u6587\u4ef6\u7684\u7edd\u5bf9\u8def\u5f84\u3002stb\u5e93\u662f\u672c\u5730\u7684\uff0c\u4e0d\u77e5\u9053\u5173\u4e8e CLASSPATH \u7684\u4efb\u4f55\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5e38\u89c4\u7684\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 width \uff1a\u56fe\u50cf\u5bbd\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u5bbd\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 height \uff1a\u56fe\u50cf\u9ad8\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u9ad8\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 channels \uff1a\u56fe\u50cf\u901a\u9053\u3002 desired_channels \uff1a\u6240\u9700\u7684\u56fe\u50cf\u901a\u9053\uff0c\u6211\u4eec\u4f20\u51654\uff08RGBA\uff09\u3002 \u4e00\u4ef6\u5173\u4e8eOpenGL\u7684\u91cd\u8981\u4e8b\u9879\uff0c\u7531\u4e8e\u5386\u53f2\u539f\u56e0\uff0c\u8981\u6c42\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u6bcf\u4e2a\u8f74\u7684\u50cf\u7d20\u6570\uff09\u5fc5\u987b\u662f\u4e8c\u7684\u6307\u6570\uff082, 4, 8, 16, ....\uff09\u3002\u4e00\u4e9b\u9a71\u52a8\u89e3\u9664\u4e86\u8fd9\u79cd\u9650\u5236\uff0c\u4f46\u6700\u597d\u8fd8\u662f\u4fdd\u6301\u4ee5\u514d\u51fa\u73b0\u95ee\u9898\u3002 \u4e0b\u4e00\u6b65\u662f\u5c06\u7eb9\u7406\u4e0a\u4f20\u5230\u663e\u5b58\u4e2d\u3002\u9996\u5148\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7eb9\u7406ID\uff0c\u4e0e\u8be5\u7eb9\u7406\u76f8\u5173\u7684\u64cd\u4f5c\u90fd\u8981\u4f7f\u7528\u8be5ID\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u5b83\u3002 // \u521b\u5efa\u4e00\u4e2a\u65b0\u7684OpenGL\u7eb9\u7406 int textureId = glGenTextures(); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, textureId); \u7136\u540e\u9700\u8981\u544a\u8bc9OpenGL\u5982\u4f55\u89e3\u5305RGBA\u5b57\u8282\uff0c\u7531\u4e8e\u6bcf\u4e2a\u5206\u91cf\u53ea\u6709\u4e00\u4e2a\u5b57\u8282\u5927\u5c0f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u4ee5\u4e0b\u4ee3\u7801\uff1a glPixelStorei(GL_UNPACK_ALIGNMENT, 1); \u6700\u540e\u6211\u4eec\u53ef\u4ee5\u4e0a\u4f20\u7eb9\u7406\u6570\u636e\uff1a glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, buf); glTexImage2D \u7684\u53c2\u6570\u5982\u4e0b\u6240\u793a\uff1a target : \u6307\u5b9a\u76ee\u6807\u7eb9\u7406\uff08\u7eb9\u7406\u7c7b\u578b\uff09\uff0c\u672c\u4f8b\u4e2d\u662f GL_TEXTURE_2D \u3002 level : \u6307\u5b9a\u7eb9\u7406\u7ec6\u8282\u7684\u7b49\u7ea7\u30020\u7ea7\u662f\u57fa\u672c\u56fe\u50cf\u7b49\u7ea7\uff0c\u7b2cn\u7ea7\u662f\u7b2cn\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u7684\u56fe\u50cf\uff0c\u4e4b\u540e\u518d\u8c08\u8bba\u8fd9\u4e2a\u95ee\u9898\u3002 internal format : \u6307\u5b9a\u7eb9\u7406\u4e2d\u989c\u8272\u5206\u91cf\u7684\u6570\u91cf\u3002 width : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u5bbd\u5ea6\u3002 height : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u9ad8\u5ea6\u3002 border : \u6b64\u503c\u5fc5\u987b\u4e3a0\u3002 format : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u683c\u5f0f\uff0c\u73b0\u5728\u4e3aRGBA\u3002 type : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u7c7b\u578b\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65e0\u7b26\u53f7\u5b57\u8282\u3002 data : \u50a8\u5b58\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002 \u5728\u4e00\u4e9b\u4ee3\u7801\u4e2d\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5728\u8c03\u7528 glTexImage2D \u65b9\u6cd5\u524d\u8bbe\u7f6e\u4e86\u4e00\u4e9b\u8fc7\u6ee4\u53c2\u6570\u3002\u8fc7\u6ee4\u662f\u6307\u5728\u7f29\u653e\u65f6\u5982\u4f55\u7ed8\u5236\u56fe\u50cf\uff0c\u4ee5\u53ca\u5982\u4f55\u63d2\u503c\u50cf\u7d20\u3002\u5982\u679c\u672a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff0c\u7eb9\u7406\u5c06\u4e0d\u4f1a\u663e\u793a\u3002\u56e0\u6b64\uff0c\u5728 glTexImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u524d\uff0c\u4f1a\u770b\u5230\u4ee5\u4e0b\u4ee3\u7801\uff1a glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u8fd9\u4e9b\u53c2\u6570\u57fa\u672c\u4e0a\u5728\u8bf4\uff0c\u5f53\u7ed8\u5236\u4e00\u4e2a\u50cf\u7d20\u65f6\uff0c\u5982\u679c\u6ca1\u6709\u76f4\u63a5\u4e00\u5bf9\u4e00\u5730\u5173\u8054\u5230\u7eb9\u7406\u5750\u6807\uff0c\u5b83\u5c06\u9009\u62e9\u6700\u8fd1\u7684\u7eb9\u7406\u5750\u6807\u70b9\u3002 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e0d\u4f1a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u751f\u6210\u4e00\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u662f\u7531\u9ad8\u7ec6\u8282\u7eb9\u7406\u751f\u6210\u7684\u9010\u7ea7\u964d\u4f4e\u5206\u8fa8\u7387\u7684\u7eb9\u7406\u96c6\u5408\u3002\u5f53\u6211\u4eec\u7684\u7269\u4f53\u7f29\u653e\u65f6\uff0c\u5c31\u5c06\u81ea\u52a8\u4f7f\u7528\u4f4e\u5206\u8fa8\u7387\u7684\u56fe\u50cf\u3002 \u4e3a\u4e86\u751f\u6210\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff0c\u53ea\u9700\u8981\u7f16\u5199\u4ee5\u4e0b\u4ee3\u7801\uff08\u76ee\u524d\u6211\u4eec\u628a\u5b83\u653e\u5728 glTextImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u540e\uff09\uff1a glGenerateMipmap(GL_TEXTURE_2D); \u6700\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u91ca\u653e\u539f\u59cb\u56fe\u50cf\u6570\u636e\u672c\u8eab\u7684\u5185\u5b58\uff1a stbi_image_free(buf); \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u5df2\u7ecf\u6210\u529f\u5730\u52a0\u8f7d\u4e86\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6b63\u5982\u6b64\u524d\u6240\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u628a\u7eb9\u7406\u5750\u6807\u4f5c\u4e3a\u53e6\u4e00\u4e2aVBO\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u4fee\u6539 Mesh \u7c7b\u4ee5\u63a5\u6536\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u800c\u4e0d\u662f\u989c\u8272\uff08\u6211\u4eec\u53ef\u4ee5\u540c\u65f6\u6709\u989c\u8272\u548c\u7eb9\u7406\uff0c\u4f46\u4e3a\u4e86\u7b80\u5316\u5b83\uff0c\u6211\u4eec\u5c06\u5220\u9664\u989c\u8272\uff09\uff0c\u6784\u9020\u51fd\u6570\u73b0\u5728\u5982\u4e0b\u6240\u793a\uff1a public Mesh(float[] positions, float[] textCoords, int[] indices, Texture texture) \u7eb9\u7406\u5750\u6807VBO\u4e0e\u989c\u8272VBO\u521b\u5efa\u7684\u65b9\u5f0f\u76f8\u540c\u3002\u552f\u4e00\u7684\u533a\u522b\u662f\u5b83\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\u800c\u4e0d\u662f\u4e09\u4e2a\uff1a vboId = glGenBuffers(); vboIdList.add(vboId); textCoordsBuffer = MemoryUtil.memAllocFloat(textCoords.length); textCoordsBuffer.put(textCoords).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, textCoordsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 2, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4fee\u6539\u4e86\u7b2c\u4e8c\u4e2a\u8f93\u5165\u53c2\u6570\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u662f\u4e00\u4e2a vec2 \uff08\u4e5f\u987a\u4fbf\u66f4\u6539\u4e86\u540d\u79f0\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c31\u50cf\u6b64\u524d\u4e00\u6837\uff0c\u4ec5\u5c06\u7eb9\u7406\u5750\u6807\u4f20\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; out vec2 outTexCoord; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u90a3\u4e9b\u7eb9\u7406\u5750\u6807\u6765\u8bbe\u7f6e\u50cf\u7d20\u989c\u8272\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5728\u5206\u6790\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u7406\u6e05\u4e00\u4e9b\u6982\u5ff5\u3002\u663e\u5361\u6709\u51e0\u4e2a\u7a7a\u95f4\u6216\u69fd\u6765\u50a8\u5b58\u7eb9\u7406\uff0c\u6bcf\u4e00\u4e2a\u7a7a\u95f4\u88ab\u79f0\u4e3a\u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\u3002\u5f53\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u6211\u4eec\u5fc5\u987b\u8bbe\u7f6e\u60f3\u7528\u7684\u7eb9\u7406\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a texture_sampler \u7684\u65b0Uniform\uff0c\u8be5Uniform\u7684\u7c7b\u578b\u662f sampler2D \uff0c\u5e76\u50a8\u5b58\u6709\u6211\u4eec\u5e0c\u671b\u4f7f\u7528\u7684\u7eb9\u7406\u5355\u5143\u7684\u503c\u3002 \u5728 main \u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u540d\u4e3a texture \u7684\u7eb9\u7406\u91c7\u6837\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u6709\u4e24\u4e2a\u53c2\u6570\uff1a\u53d6\u6837\u5668\uff08Sampler\uff09\u548c\u7eb9\u7406\u5750\u6807\uff0c\u5e76\u8fd4\u56de\u6b63\u786e\u7684\u989c\u8272\u3002\u53d6\u6837\u5668Uniform\u5141\u8bb8\u4f7f\u7528\u591a\u91cd\u7eb9\u7406\uff08Multi-texture\uff09\uff0c\u4e0d\u8fc7\u73b0\u5728\u4e0d\u662f\u8ba8\u8bba\u8fd9\u4e2a\u8bdd\u9898\u7684\u65f6\u5019\uff0c\u4f46\u662f\u6211\u4eec\u4f1a\u5728\u7a0d\u540e\u518d\u5c1d\u8bd5\u6dfb\u52a0\u3002 \u56e0\u6b64\uff0c\u5728 ShaderProgram \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u5141\u8bb8\u4e3a\u6574\u6570\u578bUniform\u8bbe\u7f6e\u503c\uff1a public void setUniform(String uniformName, int value) { glUniform1i(uniforms.get(uniformName), value); } \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684Uniform\uff1a shaderProgram.createUniform(\"texture_sampler\"); \u6b64\u5916\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06Uniform\u7684\u503c\u8bbe\u7f6e\u4e3a0\uff08\u6211\u4eec\u73b0\u5728\u4e0d\u4f7f\u7528\u591a\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u53ea\u4f7f\u7528\u5355\u51430\uff09\u3002 shaderProgram.setUniform(\"texture_sampler\", 0); \u6700\u597d\uff0c\u6211\u4eec\u53ea\u9700\u4fee\u6539 Mesh \u7c7b\u7684 render \u65b9\u6cd5\u5c31\u53ef\u4ee5\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u65b9\u6cd5\u8d77\u59cb\u5904\uff0c\u6dfb\u52a0\u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\uff1a // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5355\u5143 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); \u6211\u4eec\u5df2\u7ecf\u5c06 texture.getId() \u6240\u83b7\u5f97\u7684\u7eb9\u7406ID\u7ed1\u5b9a\u5230\u7eb9\u7406\u5355\u51430\u4e0a\u3002 \u6211\u4eec\u521a\u521a\u4fee\u6539\u4e86\u4ee3\u7801\u6765\u652f\u6301\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\uff0c\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\u662f\u8fd9\u6837\u7684\uff1a \u5728\u6211\u4eec\u7684\u4e09\u7ef4\u6a21\u578b\u4e2d\uff0c\u5171\u6709\u516b\u4e2a\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u5b9a\u4e49\u6b63\u9762\u6bcf\u4e2a\u9876\u70b9\u7684\u7eb9\u7406\u5750\u6807\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V0 0.0, 0.0 V1 0.0, 0.5 V2 0.5, 0.5 V3 0.5, 0.0 \u7136\u540e\uff0c\u5b9a\u4e49\u9876\u9762\u7684\u7eb9\u7406\u6620\u5c04\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V4 0.0, 0.5 V5 0.5, 0.5 V0 0.0, 1.0 V3 0.5, 1.0 \u5982\u4f60\u6240\u89c1\uff0c\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u540c\u4e00\u4e2a\u9876\u70b9\uff08V0\u548cV3\uff09\u8bbe\u7f6e\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u600e\u4e48\u6837\u624d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u5462\uff1f\u89e3\u51b3\u8fd9\u4e00\u95ee\u9898\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u91cd\u590d\u4e00\u4e9b\u9876\u70b9\u5e76\u5173\u8054\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u5bf9\u4e8e\u9876\u9762\uff0c\u6211\u4eec\u9700\u8981\u91cd\u590d\u56db\u4e2a\u9876\u70b9\u5e76\u4e3a\u5b83\u4eec\u5206\u914d\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u3002 \u56e0\u4e3a\u524d\u9762\u3001\u540e\u9762\u548c\u4fa7\u9762\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u9700\u8981\u91cd\u590d\u8fd9\u4e9b\u9876\u70b9\u3002\u5728\u6e90\u7801\u4e2d\u6709\u5b8c\u6574\u7684\u5b9a\u4e49\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ece8\u4e2a\u70b9\u4e0a\u5347\u523020\u4e2a\u70b9\u4e86\u3002\u6700\u7ec8\u7684\u7ed3\u679c\u5c31\u50cf\u8fd9\u6837\u3002 \u5728\u63a5\u4e0b\u6765\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u75313D\u5efa\u6a21\u5de5\u5177\u751f\u6210\u7684\u6a21\u578b\uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u624b\u52a8\u5b9a\u4e49\u9876\u70b9\u548c\u7eb9\u7406\u5750\u6807\u4e86\uff08\u987a\u4fbf\u4e00\u63d0\uff0c\u5bf9\u4e8e\u66f4\u590d\u6742\u7684\u6a21\u578b\uff0c\u624b\u52a8\u5b9a\u4e49\u662f\u4e0d\u5b58\u5728\u7684\uff09\u3002","title":"\u4e3a\u7acb\u65b9\u4f53\u6dfb\u52a0\u7eb9\u7406"},{"location":"07-textures/#_3","text":"\u5982\u4f60\u6240\u89c1\uff0c\u5f53\u52a0\u8f7d\u56fe\u50cf\u65f6\uff0c\u6211\u4eec\u68c0\u7d22\u4e86\u56db\u4e2aRGBA\u7ec4\u4ef6\uff0c\u5305\u62ec\u900f\u660e\u5ea6\u7b49\u7ea7\u3002\u4f46\u5982\u679c\u52a0\u8f7d\u4e00\u4e2a\u900f\u660e\u7684\u7eb9\u7406\uff0c\u53ef\u80fd\u770b\u4e0d\u5230\u4efb\u4f55\u4e1c\u897f\u3002\u4e3a\u4e86\u652f\u6301\u900f\u660e\u5ea6\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u4ee5\u4e0b\u4ee3\u7801\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff1a glEnable(GL_BLEND); \u4f46\u4ec5\u542f\u7528\u6df7\u5408\uff0c\u900f\u660e\u6548\u679c\u4ecd\u7136\u4e0d\u4f1a\u663e\u793a\uff0c\u6211\u4eec\u8fd8\u9700\u8981\u6307\u793aOpenGL\u5982\u4f55\u8fdb\u884c\u6df7\u5408\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glBlendFunc \u65b9\u6cd5\u5b8c\u6210\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u4f60\u53ef\u4ee5\u67e5\u770b \u6b64\u5904 \u6709\u5173\u53ef\u4f7f\u7528\u7684\u4e0d\u540c\u529f\u80fd\u7684\u8be6\u7ec6\u8bf4\u660e\u3002 \u5373\u4f7f\u542f\u7528\u4e86\u6df7\u5408\u5e76\u8bbe\u7f6e\u4e86\u529f\u80fd\uff0c\u4e5f\u53ef\u80fd\u770b\u4e0d\u5230\u6b63\u786e\u7684\u900f\u660e\u6548\u679c\u3002\u5176\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5f53\u4f7f\u7528\u6df1\u5ea6\u503c\u4e22\u5f03\u7247\u5143\u65f6\uff0c\u6211\u4eec\u53ef\u80fd\u5c06\u5177\u6709\u900f\u660e\u5ea6\u7684\u7247\u5143\u4e0e\u80cc\u666f\u6df7\u5408\uff0c\u800c\u4e0d\u662f\u4e0e\u5b83\u4eec\u540e\u9762\u7684\u7247\u5143\u6df7\u5408\uff0c\u8fd9\u5c06\u5f97\u5230\u9519\u8bef\u7684\u6e32\u67d3\u7ed3\u679c\u3002\u4e3a\u4e86\u89e3\u51b3\u8be5\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u5148\u7ed8\u5236\u4e0d\u900f\u660e\u7269\u4f53\uff0c\u7136\u540e\u6309\u6df1\u5ea6\u9012\u51cf\u987a\u5e8f\u7ed8\u5236\u5177\u6709\u900f\u660e\u5ea6\u7684\u7269\u4f53\uff08\u5e94\u5148\u7ed8\u5236\u8f83\u8fdc\u7269\u4f53\uff09\u3002","title":"\u900f\u660e\u7eb9\u7406\u7b80\u4ecb"},{"location":"08-camera/","text":"\u6444\u50cf\u673a\uff08Camera\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u7684\u4e09\u7ef4\u573a\u666f\u4e2d\u79fb\u52a8\u3002\u8be5\u529f\u80fd\u5c31\u50cf\u662f\u6709\u4e00\u53f0\u53ef\u4ee5\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\u7684\u6444\u50cf\u673a\uff0c\u7136\u800c\u4e8b\u5b9e\u4e0a\u6444\u50cf\u673a\u5c31\u662f\u63cf\u8ff0\u8be5\u529f\u80fd\u7684\u672f\u8bed\u3002 \u4f46\u5982\u679c\u4f60\u5c1d\u8bd5\u5728OpenGL\u5bfb\u627e\u6444\u50cf\u673a\u529f\u80fd\uff0c\u4f60\u4f1a\u53d1\u73b0\u6ca1\u6709\u6444\u50cf\u673a\u8fd9\u4e2a\u6982\u5ff5\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u6444\u50cf\u673a\u4e00\u76f4\u662f\u56fa\u5b9a\u5728\u5c4f\u5e55\u4e2d\u5fc3\u7684\u4ee5(0, 0, 0)\u4e3a\u4e2d\u5fc3\u70b9\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u51fa\u4e00\u4e2a\u53ef\u4ee5\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u79fb\u52a8\u7684\u6444\u50cf\u3002\u4f46\u8981\u600e\u4e48\u505a\u5462\uff1f\u6444\u50cf\u673a\u662f\u4e0d\u80fd\u79fb\u52a8\u7684\uff0c\u56e0\u6b64\u6211\u4eec\u5fc5\u987b\u8981\u79fb\u52a8\u4e16\u754c\u4e2d\u7684\u5168\u90e8\u7269\u4f53\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u79fb\u52a8\u4e0d\u4e86\u6444\u50cf\u673a\u5c31\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002 \u5047\u8bbe\u6444\u50cf\u673a\u4ece(Cx, Cy, Cz)\u6cbf\u7740Z\u8f74\u79fb\u52a8\u5230(Cx, Cy, Cz+dz)\uff0c\u4ece\u800c\u9760\u8fd1\u5728(Ox, Oy, Oz)\u653e\u7f6e\u7684\u7269\u4f53\u3002 \u6211\u4eec\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u5c06\u7269\u4f53\uff08\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u6240\u6709\u7269\u4f53\uff09\u6309\u6444\u50cf\u673a\u5e94\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u79fb\u52a8\u3002\u5176\u5b9e\u7269\u4f53\u5c31\u50cf\u662f\u653e\u5728\u8dd1\u6b65\u673a\u4e0a\u4e00\u6837\u5411\u540e\u9000\u3002 \u6444\u50cf\u673a\u53ef\u4ee5\u6cbf\u7740\u4e09\u4e2a\u8f74\uff08X\u3001Y\u548cZ\uff09\u79fb\u52a8\uff0c\u4e5f\u53ef\u4ee5\u7ed5\u7740\u5b83\u4eec\u65cb\u8f6c\uff08\u7ffb\u6eda\uff08Roll\uff09\u3001\u4fef\u4ef0\uff08Pitch\uff09\u548c\u504f\u822a\uff08Yaw\uff09\uff09\u3002 \u57fa\u672c\u4e0a\u8981\u505a\u7684\u5c31\u662f\u8ba9\u79fb\u52a8\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u4e09\u7ef4\u4e16\u754c\u5168\u90e8\u7269\u4f53\u3002\u90a3\u8981\u600e\u4e48\u505a\u5462\uff1f\u7b54\u6848\u662f\u5e94\u7528\u53e6\u4e00\u79cd\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u5c06\u6240\u6709\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u6309\u6444\u50cf\u673a\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u5e73\u79fb\uff0c\u518d\u6839\u636e\u6444\u50cf\u673a\u7684\u65cb\u8f6c\u6765\u65cb\u8f6c\u5b83\u4eec\u3002\u5f53\u7136\uff0c\u8fd9\u5c06\u7528\u5230\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6240\u8c13\u7684\u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\u6765\u5b8c\u6210\u3002\u8fd9\u4e2a\u77e9\u9635\u9996\u5148\u8fdb\u884c\u5e73\u79fb\uff0c\u7136\u540e\u6cbf\u7740\u8f74\u7ebf\u8fdb\u884c\u65cb\u8f6c\u3002 \u6765\u770b\u770b\u5982\u4f55\u6784\u9020\u8fd9\u4e2a\u77e9\u9635\u3002\u5982\u679c\u4f60\u60f3\u8d77\u53d8\u6362\u4e00\u7ae0\uff08\u7b2c6\u7ae0\uff09\uff0c\u5176\u4e2d\u7684\u53d8\u6362\u65b9\u7a0b\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u89c2\u5bdf\u77e9\u9635\u5e94\u5728\u5e94\u7528\u6295\u5f71\u77e9\u9635\u4e4b\u524d\u5e94\u7528\uff0c\u56e0\u6b64\u6211\u4eec\u7684\u65b9\u7a0b\u5e94\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u73b0\u5728\u6709\u4e09\u4e2a\u77e9\u9635\u4e86\uff0c\u6211\u4eec\u5e94\u7a0d\u5fae\u601d\u8003\u4e00\u4e0b\u8fd9\u4e9b\u77e9\u9635\u7684\u751f\u547d\u5468\u671f\u3002\u5728\u6e38\u620f\u8fd0\u884c\u65f6\uff0c\u6295\u5f71\u77e9\u9635\u5e94\u8be5\u4e0d\u4f1a\u6709\u592a\u591a\u7684\u53d8\u5316\uff0c\u6700\u574f\u7684\u60c5\u51b5\u4e0b\uff0c\u6bcf\u6b21\u6e32\u67d3\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u5982\u679c\u6444\u50cf\u673a\u79fb\u52a8\uff0c\u5219\u89c2\u5bdf\u77e9\u9635\u5728\u6bcf\u6b21\u6e32\u67d3\u65f6\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u6bcf\u6e32\u67d3\u4e00\u4e2a GameItem \u5b9e\u4f8b\u4e16\u754c\u77e9\u9635\u90fd\u4f1a\u6539\u53d8\u4e00\u6b21\uff0c\u4e00\u6b21\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u90fd\u4f1a\u6539\u53d8\u591a\u6b21\u3002 \u56e0\u6b64\u6211\u4eec\u5e94\u8be5\u5c06\u591a\u5c11\u77e9\u9635\u4f20\u9012\u5230\u9876\u70b9\u7740\u8272\u5668\u5462\uff1f\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e9b\u4ee3\u7801\uff0c\u4e3a\u4e09\u4e2a\u77e9\u9635\u5206\u522b\u5b9a\u4e49\u4e00\u4e2aUniform\uff0c\u4f46\u7406\u8bba\u4e0a\u6700\u6709\u6548\u7684\u65b9\u6cd5\u662f\u5c06\u6295\u5f71\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u7ec4\u5408\uff0c\u5c06\u5176\u79f0\u4e3a pv \u77e9\u9635\uff0c\u5e76\u4f20\u9012 world \u548c pv \u77e9\u9635\u5230\u7740\u8272\u5668\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u5e76\u53ef\u4ee5\u907f\u514d\u4e00\u4e9b\u989d\u5916\u7684\u8fd0\u7b97\u3002 \u4f46\u5b9e\u9645\u4e0a\uff0c\u6700\u65b9\u4fbf\u7684\u65b9\u6cd5\u662f\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u3002\u4e3a\u4ec0\u4e48\u8fd9\u6837\uff1f\u56e0\u4e3a\u8981\u8bb0\u4f4f\u6574\u4e2a\u6444\u50cf\u673a\u6982\u5ff5\u5c31\u662f\u4e2a\u9a97\u5c40\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u6765\u6a21\u62df\u6444\u50cf\u673a\u7684\u4f4d\u79fb\uff0c\u5e76\u4ec5\u663e\u793a\u4e00\u5c0f\u90e8\u5206\u7684\u4e09\u7ef4\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5904\u7406\u4e16\u754c\u5750\u6807\uff0c\u53ef\u80fd\u4f1a\u8ba9\u8fdc\u79bb\u539f\u70b9\u7684\u4e16\u754c\u5750\u6807\u9047\u5230\u4e00\u4e9b\u7cbe\u5ea6\u95ee\u9898\u3002\u5982\u679c\u5728\u6240\u8c13\u7684\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u5904\u7406\uff0c\u6211\u4eec\u5c06\u5904\u7406\u7684\u70b9\u867d\u7136\u8fdc\u79bb\u4e16\u754c\u539f\u70b9\uff0c\u4f46\u4e5f\u9760\u8fd1\u6444\u50cf\u673a\u3002\u53ef\u4ee5\u5c06\u89c2\u5bdf\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u7684\u77e9\u9635\u79f0\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u4ee5\u652f\u6301\u6444\u50cf\u673a\u5427\u3002\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Camera \u7684\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u72b6\u6001\u3002\u8be5\u7c7b\u5c06\u63d0\u4f9b\u8bbe\u7f6e\u4f4d\u7f6e\u6216\u65cb\u8f6c\u72b6\u6001\u7684\u65b9\u6cd5\uff08 setPosition \u6216 setRotation \uff09\uff0c\u6216\u5728\u5f53\u524d\u72b6\u6001\u4e0b\u7528\u504f\u79fb\u91cf\u66f4\u65b0\u8fd9\u4e9b\u503c\u7684\u65b9\u6cd5\uff08 movePosition \u6216 moveRotation \uff09\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class Camera { private final Vector3f position; private final Vector3f rotation; public Camera() { position = new Vector3f(0, 0, 0); rotation = new Vector3f(0, 0, 0); } public Camera(Vector3f position, Vector3f rotation) { this.position = position; this.rotation = rotation; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { position.x = x; position.y = y; position.z = z; } public void movePosition(float offsetX, float offsetY, float offsetZ) { if ( offsetZ != 0 ) { position.x += (float)Math.sin(Math.toRadians(rotation.y)) * -1.0f * offsetZ; position.z += (float)Math.cos(Math.toRadians(rotation.y)) * offsetZ; } if ( offsetX != 0) { position.x += (float)Math.sin(Math.toRadians(rotation.y - 90)) * -1.0f * offsetX; position.z += (float)Math.cos(Math.toRadians(rotation.y - 90)) * offsetX; } position.y += offsetY; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { rotation.x = x; rotation.y = y; rotation.z = z; } public void moveRotation(float offsetX, float offsetY, float offsetZ) { rotation.x += offsetX; rotation.y += offsetY; rotation.z += offsetZ; } } \u63a5\u4e0b\u6765\u5728 Transformation \u4e2d\uff0c\u5c06\u5b9a\u4e49\u4e00\u4e2a\u65b0\u77e9\u9635\u6765\u50a8\u5b58\u89c2\u5bdf\u77e9\u9635\u3002 private final Matrix4f viewMatrix; \u6211\u4eec\u8981\u63d0\u4f9b\u4e00\u4e2a\u66f4\u65b0\u8fd9\u4e2a\u503c\u7684\u65b9\u6cd5\u3002\u4e0e\u6295\u5f71\u77e9\u9635\u76f8\u4f3c\uff0c\u8fd9\u4e2a\u77e9\u9635\u5bf9\u4e8e\u6e32\u67d3\u5468\u671f\u4e2d\u6e32\u67d3\u7684\u6240\u6709\u7269\u4f53\u90fd\u662f\u76f8\u540c\u7684\u3002 public Matrix4f getViewMatrix(Camera camera) { Vector3f cameraPos = camera.getPosition(); Vector3f rotation = camera.getRotation(); viewMatrix.identity(); // \u9996\u5148\u8fdb\u884c\u65cb\u8f6c\uff0c\u4f7f\u6444\u50cf\u673a\u5728\u5176\u4f4d\u7f6e\u4e0a\u65cb\u8f6c viewMatrix.rotate((float)Math.toRadians(rotation.x), new Vector3f(1, 0, 0)) .rotate((float)Math.toRadians(rotation.y), new Vector3f(0, 1, 0)); // \u7136\u540e\u505a\u4f4d\u79fb viewMatrix.translate(-cameraPos.x, -cameraPos.y, -cameraPos.z); return viewMatrix; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u65cb\u8f6c\uff0c\u7136\u540e\u4f4d\u79fb\u3002\u5982\u679c\u64cd\u4f5c\u987a\u5e8f\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u4e0d\u4f1a\u6cbf\u7740\u6444\u50cf\u673a\u4f4d\u7f6e\u65cb\u8f6c\uff0c\u800c\u662f\u6cbf\u7740\u5750\u6807\u539f\u70b9\u65cb\u8f6c\u3002\u8bf7\u6ce8\u610f\uff0c\u5728 Camera \u7c7b\u7684 movePosition \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u53ea\u662f\u7b80\u5355\u5730\u589e\u52a0\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u504f\u79fb\u91cf\u3002\u6211\u4eec\u8fd8\u8003\u8651\u4e86\u6cbfY\u8f74\u7684\u65cb\u8f6c\uff0c\u4e5f\u5c31\u662f\u504f\u822a\uff0c\u4ee5\u4fbf\u8ba1\u7b97\u6700\u7ec8\u4f4d\u7f6e\u3002\u5982\u679c\u53ea\u662f\u901a\u8fc7\u504f\u79fb\u6765\u589e\u52a0\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u6444\u50cf\u673a\u5c31\u4e0d\u4f1a\u671d\u7740\u5b83\u6240\u671d\u5411\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u9664\u4e86\u4e0a\u8ff0\u6240\u8bf4\u7684\uff0c\u6211\u4eec\u73b0\u5728\u8fd8\u6ca1\u6709\u5f97\u5230\u4e00\u4e2a\u53ef\u4ee5\u5b8c\u5168\u81ea\u7531\u79fb\u52a8\u7684\u6444\u50cf\u673a\uff08\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u6cbf\u7740X\u8f74\u65cb\u8f6c\uff0c\u5f53\u5411\u524d\u79fb\u52a8\u65f6\uff0c\u6444\u50cf\u673a\u4e0d\u4f1a\u5728\u7a7a\u95f4\u4e2d\u5411\u4e0a\u6216\u5411\u4e0b\u79fb\u52a8\uff09\uff0c\u8fd9\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u8fd9\u6709\u70b9\u590d\u6742\u3002 \u6700\u540e\uff0c\u6211\u4eec\u5c06\u79fb\u9664\u4e4b\u524d\u7684 getWorldMatrix \u65b9\u6cd5\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e2a\u540d\u4e3a getModelViewMatrix \u7684\u65b0\u65b9\u6cd5\u3002 public Matrix4f getModelViewMatrix(GameItem gameItem, Matrix4f viewMatrix) { Vector3f rotation = gameItem.getRotation(); modelViewMatrix.set(viewMatrix).translate(gameItem.getPosition()). rotateX((float)Math.toRadians(-rotation.x)). rotateY((float)Math.toRadians(-rotation.y)). rotateZ((float)Math.toRadians(-rotation.z)). scale(gameItem.getScale()); return modelViewMatrix; } \u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u5c06\u8c03\u7528\u4e00\u6b21 getModelViewMatrix \u65b9\u6cd5\u3002 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u6444\u50cf\u673a\u7684\u503c\uff0c\u5728\u6295\u5f71\u77e9\u9635\u66f4\u65b0\u4e4b\u540e\u66f4\u65b0\u89c2\u5bdf\u77e9\u9635\u3002 // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 Matrix4f viewMatrix = transformation.getViewMatrix(camera); shaderProgram.setUniform(\"texture_sampler\", 0); // \u6e32\u67d3\u6bcf\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u6e32\u67d3\u8be5\u6e38\u620f\u9879\u7684\u7f51\u683c gameItem.getMesh().render(); } \u8fd9\u5c31\u662f\u5b9e\u73b0\u6444\u50cf\u673a\u6982\u5ff5\u7684\u57fa\u672c\u4ee3\u7801\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u53ef\u4ee5\u4fee\u6539\u8f93\u5165\u5904\u7406\u548c\u66f4\u65b0\u6444\u50cf\u673a\u7684\u65b9\u5f0f\uff0c\u5c06\u8bbe\u7f6e\u5982\u4e0b\u6309\u952e\uff1a \u201cA\u201d\u548c\u201cD\u201d\u952e\u4f7f\u6444\u50cf\u673a\u5de6\u53f3\uff08X\u8f74\uff09\u79fb\u52a8\u3002 \u201cW\u201d\u548c\u201cS\u201d\u952e\u4f7f\u6444\u50cf\u673a\u524d\u540e\uff08Z\u8f74\uff09\u79fb\u52a8\u3002 \u201cZ\u201d\u548c\u201cX\u201d\u952e\u4f7f\u6444\u50cf\u673a\u4e0a\u4e0b\uff08Y\u8f74\uff09\u79fb\u52a8\u3002 \u5f53\u9f20\u6807\u6309\u4e0b\u53f3\u952e\u65f6\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9f20\u6807\u4f4d\u7f6e\u6cbfX\u548cY\u8f74\u65cb\u8f6c\u6444\u50cf\u673a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u5c06\u9996\u6b21\u4f7f\u7528\u9f20\u6807\uff0c\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MouseInput \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u5c01\u88c5\u9f20\u6807\u8bbf\u95ee\u3002\u8be5\u7c7b\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine; import org.joml.Vector2d; import org.joml.Vector2f; import static org.lwjgl.glfw.GLFW.*; public class MouseInput { private final Vector2d previousPos; private final Vector2d currentPos; private final Vector2f displVec; private boolean inWindow = false; private boolean leftButtonPressed = false; private boolean rightButtonPressed = false; public MouseInput() { previousPos = new Vector2d(-1, -1); currentPos = new Vector2d(0, 0); displVec = new Vector2f(); } public void init(Window window) { glfwSetCursorPosCallback(window.getWindowHandle(), (windowHandle, xpos, ypos) -> { currentPos.x = xpos; currentPos.y = ypos; }); glfwSetCursorEnterCallback(window.getWindowHandle(), (windowHandle, entered) -> { inWindow = entered; }); glfwSetMouseButtonCallback(window.getWindowHandle(), (windowHandle, button, action, mode) -> { leftButtonPressed = button == GLFW_MOUSE_BUTTON_1 && action == GLFW_PRESS; rightButtonPressed = button == GLFW_MOUSE_BUTTON_2 && action == GLFW_PRESS; }); } public Vector2f getDisplVec() { return displVec; } public void input(Window window) { displVec.x = 0; displVec.y = 0; if (previousPos.x > 0 && previousPos.y > 0 && inWindow) { double deltax = currentPos.x - previousPos.x; double deltay = currentPos.y - previousPos.y; boolean rotateX = deltax != 0; boolean rotateY = deltay != 0; if (rotateX) { displVec.y = (float) deltax; } if (rotateY) { displVec.x = (float) deltay; } } previousPos.x = currentPos.x; previousPos.y = currentPos.y; } public boolean isLeftButtonPressed() { return leftButtonPressed; } public boolean isRightButtonPressed() { return rightButtonPressed; } } MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5e94\u5728\u5728\u521d\u59cb\u5316\u9636\u6bb5\u8c03\u7528\u7684 init \u65b9\u6cd5\uff0c\u5e76\u6ce8\u518c\u4e00\u7ec4\u56de\u8c03\u4ee5\u5904\u7406\u9f20\u6807\u4e8b\u4ef6\uff1a glfwSetCursorPosCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u79fb\u52a8\u65f6\u88ab\u8c03\u7528\u3002 glfwSetCursorEnterCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u65f6\u88ab\u8c03\u7528\u3002\u5373\u4f7f\u9f20\u6807\u4e0d\u5728\u7a97\u53e3\u5185\uff0c\u6211\u4eec\u4e5f\u4f1a\u6536\u5230\u9f20\u6807\u4e8b\u4ef6\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e2a\u56de\u8c03\u6765\u786e\u8ba4\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u3002 glfwSetMouseButtonCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5728\u6309\u4e0b\u9f20\u6807\u6309\u94ae\u65f6\u88ab\u8c03\u7528\u3002 MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a input \u65b9\u6cd5\uff0c\u5728\u5904\u7406\u6e38\u620f\u8f93\u5165\u65f6\u5e94\u8c03\u7528\u8be5\u65b9\u6cd5\u3002\u8be5\u65b9\u6cd5\u8ba1\u7b97\u9f20\u6807\u4ece\u4e0a\u4e00\u4e2a\u4f4d\u7f6e\u7684\u4f4d\u79fb\uff0c\u5e76\u5c06\u5176\u5b58\u50a8\u5230 Vector2f \u7c7b\u578b\u7684 displVec \u53d8\u91cf\u4e2d\uff0c\u4ee5\u4fbf\u6e38\u620f\u4f7f\u7528\u5b83\u3002 MouseInput \u7c7b\u5c06\u5728 GameEngine \u7c7b\u4e2d\u5b9e\u4f8b\u5316\uff0c\u5e76\u4e14\u5c06\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7ed9\u6e38\u620f\u5b9e\u73b0\u7684 init \u548c update \u65b9\u6cd5\uff08\u56e0\u6b64\u9700\u8981\u76f8\u5e94\u5730\u66f4\u6539 IGameLogic \u63a5\u53e3\uff09\u3002 void input(Window window, MouseInput mouseInput); void update(float interval, MouseInput mouseInput); \u9f20\u6807\u8f93\u5165\u5c06\u5728 GameEngine \u7c7b\u7684 input \u65b9\u6cd5\u4e2d\u88ab\u5904\u7406\uff0c\u800c\u6700\u7ec8\u7684\u63a7\u5236\u5c06\u4ea4\u7531\u6e38\u620f\u5b9e\u73b0\u3002 protected void input() { mouseInput.input(window); gameLogic.input(window, mouseInput); } \u73b0\u5728\u5df2\u7ecf\u51c6\u5907\u597d\u4fee\u6539 DummyGame \u7c7b\u6765\u5904\u7406\u952e\u76d8\u548c\u9f20\u6807\u8f93\u5165\u4e86\u3002\u8be5\u7c7b\u7684\u8f93\u5165\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a @Override public void input(Window window, MouseInput mouseInput) { cameraInc.set(0, 0, 0); if (window.isKeyPressed(GLFW_KEY_W)) { cameraInc.z = -1; } else if (window.isKeyPressed(GLFW_KEY_S)) { cameraInc.z = 1; } if (window.isKeyPressed(GLFW_KEY_A)) { cameraInc.x = -1; } else if (window.isKeyPressed(GLFW_KEY_D)) { cameraInc.x = 1; } if (window.isKeyPressed(GLFW_KEY_Z)) { cameraInc.y = -1; } else if (window.isKeyPressed(GLFW_KEY_X)) { cameraInc.y = 1; } } \u8fd9\u53ea\u662f\u66f4\u65b0\u4e00\u4e2a\u540d\u4e3a cameraInc \u7684 Vector3f \u53d8\u91cf\uff0c\u5b83\u50a8\u5b58\u4e86\u6444\u50cf\u673a\u5e94\u7528\u7684\u4f4d\u79fb\u3002 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u5c06\u6839\u636e\u5904\u7406\u7684\u952e\u76d8\u548c\u9f20\u6807\u4e8b\u4ef6\uff0c\u4fee\u6539\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u3002 @Override public void update(float interval, MouseInput mouseInput) { // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u57fa\u4e8e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); } } \u73b0\u5728\u53ef\u4ee5\u6dfb\u52a0\u66f4\u591a\u7684\u7acb\u65b9\u4f53\u5230\u4e16\u754c\u4e2d\uff0c\u7f29\u653e\u5b83\u4eec\uff0c\u5c06\u5b83\u4eec\u8bbe\u7f6e\u5728\u7279\u5b9a\u4f4d\u7f6e\uff0c\u5e76\u4f7f\u7528\u65b0\u6444\u50cf\u673a\u6e38\u73a9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6240\u6709\u7684\u7acb\u65b9\u4f53\u5171\u4eab\u76f8\u540c\u7684\u7f51\u683c\u3002 GameItem gameItem1 = new GameItem(mesh); gameItem1.setScale(0.5f); gameItem1.setPosition(0, 0, -2); GameItem gameItem2 = new GameItem(mesh); gameItem2.setScale(0.5f); gameItem2.setPosition(0.5f, 0.5f, -2); GameItem gameItem3 = new GameItem(mesh); gameItem3.setScale(0.5f); gameItem3.setPosition(0, 0, -2.5f); GameItem gameItem4 = new GameItem(mesh); gameItem4.setScale(0.5f); gameItem4.setPosition(0.5f, 0, -2.5f); gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4}; \u4f60\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\u3002","title":"\u6444\u50cf\u673a"},{"location":"08-camera/#camera","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u7684\u4e09\u7ef4\u573a\u666f\u4e2d\u79fb\u52a8\u3002\u8be5\u529f\u80fd\u5c31\u50cf\u662f\u6709\u4e00\u53f0\u53ef\u4ee5\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\u7684\u6444\u50cf\u673a\uff0c\u7136\u800c\u4e8b\u5b9e\u4e0a\u6444\u50cf\u673a\u5c31\u662f\u63cf\u8ff0\u8be5\u529f\u80fd\u7684\u672f\u8bed\u3002 \u4f46\u5982\u679c\u4f60\u5c1d\u8bd5\u5728OpenGL\u5bfb\u627e\u6444\u50cf\u673a\u529f\u80fd\uff0c\u4f60\u4f1a\u53d1\u73b0\u6ca1\u6709\u6444\u50cf\u673a\u8fd9\u4e2a\u6982\u5ff5\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u6444\u50cf\u673a\u4e00\u76f4\u662f\u56fa\u5b9a\u5728\u5c4f\u5e55\u4e2d\u5fc3\u7684\u4ee5(0, 0, 0)\u4e3a\u4e2d\u5fc3\u70b9\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u51fa\u4e00\u4e2a\u53ef\u4ee5\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u79fb\u52a8\u7684\u6444\u50cf\u3002\u4f46\u8981\u600e\u4e48\u505a\u5462\uff1f\u6444\u50cf\u673a\u662f\u4e0d\u80fd\u79fb\u52a8\u7684\uff0c\u56e0\u6b64\u6211\u4eec\u5fc5\u987b\u8981\u79fb\u52a8\u4e16\u754c\u4e2d\u7684\u5168\u90e8\u7269\u4f53\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u79fb\u52a8\u4e0d\u4e86\u6444\u50cf\u673a\u5c31\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002 \u5047\u8bbe\u6444\u50cf\u673a\u4ece(Cx, Cy, Cz)\u6cbf\u7740Z\u8f74\u79fb\u52a8\u5230(Cx, Cy, Cz+dz)\uff0c\u4ece\u800c\u9760\u8fd1\u5728(Ox, Oy, Oz)\u653e\u7f6e\u7684\u7269\u4f53\u3002 \u6211\u4eec\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u5c06\u7269\u4f53\uff08\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u6240\u6709\u7269\u4f53\uff09\u6309\u6444\u50cf\u673a\u5e94\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u79fb\u52a8\u3002\u5176\u5b9e\u7269\u4f53\u5c31\u50cf\u662f\u653e\u5728\u8dd1\u6b65\u673a\u4e0a\u4e00\u6837\u5411\u540e\u9000\u3002 \u6444\u50cf\u673a\u53ef\u4ee5\u6cbf\u7740\u4e09\u4e2a\u8f74\uff08X\u3001Y\u548cZ\uff09\u79fb\u52a8\uff0c\u4e5f\u53ef\u4ee5\u7ed5\u7740\u5b83\u4eec\u65cb\u8f6c\uff08\u7ffb\u6eda\uff08Roll\uff09\u3001\u4fef\u4ef0\uff08Pitch\uff09\u548c\u504f\u822a\uff08Yaw\uff09\uff09\u3002 \u57fa\u672c\u4e0a\u8981\u505a\u7684\u5c31\u662f\u8ba9\u79fb\u52a8\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u4e09\u7ef4\u4e16\u754c\u5168\u90e8\u7269\u4f53\u3002\u90a3\u8981\u600e\u4e48\u505a\u5462\uff1f\u7b54\u6848\u662f\u5e94\u7528\u53e6\u4e00\u79cd\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u5c06\u6240\u6709\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u6309\u6444\u50cf\u673a\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u5e73\u79fb\uff0c\u518d\u6839\u636e\u6444\u50cf\u673a\u7684\u65cb\u8f6c\u6765\u65cb\u8f6c\u5b83\u4eec\u3002\u5f53\u7136\uff0c\u8fd9\u5c06\u7528\u5230\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6240\u8c13\u7684\u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\u6765\u5b8c\u6210\u3002\u8fd9\u4e2a\u77e9\u9635\u9996\u5148\u8fdb\u884c\u5e73\u79fb\uff0c\u7136\u540e\u6cbf\u7740\u8f74\u7ebf\u8fdb\u884c\u65cb\u8f6c\u3002 \u6765\u770b\u770b\u5982\u4f55\u6784\u9020\u8fd9\u4e2a\u77e9\u9635\u3002\u5982\u679c\u4f60\u60f3\u8d77\u53d8\u6362\u4e00\u7ae0\uff08\u7b2c6\u7ae0\uff09\uff0c\u5176\u4e2d\u7684\u53d8\u6362\u65b9\u7a0b\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u89c2\u5bdf\u77e9\u9635\u5e94\u5728\u5e94\u7528\u6295\u5f71\u77e9\u9635\u4e4b\u524d\u5e94\u7528\uff0c\u56e0\u6b64\u6211\u4eec\u7684\u65b9\u7a0b\u5e94\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u73b0\u5728\u6709\u4e09\u4e2a\u77e9\u9635\u4e86\uff0c\u6211\u4eec\u5e94\u7a0d\u5fae\u601d\u8003\u4e00\u4e0b\u8fd9\u4e9b\u77e9\u9635\u7684\u751f\u547d\u5468\u671f\u3002\u5728\u6e38\u620f\u8fd0\u884c\u65f6\uff0c\u6295\u5f71\u77e9\u9635\u5e94\u8be5\u4e0d\u4f1a\u6709\u592a\u591a\u7684\u53d8\u5316\uff0c\u6700\u574f\u7684\u60c5\u51b5\u4e0b\uff0c\u6bcf\u6b21\u6e32\u67d3\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u5982\u679c\u6444\u50cf\u673a\u79fb\u52a8\uff0c\u5219\u89c2\u5bdf\u77e9\u9635\u5728\u6bcf\u6b21\u6e32\u67d3\u65f6\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u6bcf\u6e32\u67d3\u4e00\u4e2a GameItem \u5b9e\u4f8b\u4e16\u754c\u77e9\u9635\u90fd\u4f1a\u6539\u53d8\u4e00\u6b21\uff0c\u4e00\u6b21\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u90fd\u4f1a\u6539\u53d8\u591a\u6b21\u3002 \u56e0\u6b64\u6211\u4eec\u5e94\u8be5\u5c06\u591a\u5c11\u77e9\u9635\u4f20\u9012\u5230\u9876\u70b9\u7740\u8272\u5668\u5462\uff1f\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e9b\u4ee3\u7801\uff0c\u4e3a\u4e09\u4e2a\u77e9\u9635\u5206\u522b\u5b9a\u4e49\u4e00\u4e2aUniform\uff0c\u4f46\u7406\u8bba\u4e0a\u6700\u6709\u6548\u7684\u65b9\u6cd5\u662f\u5c06\u6295\u5f71\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u7ec4\u5408\uff0c\u5c06\u5176\u79f0\u4e3a pv \u77e9\u9635\uff0c\u5e76\u4f20\u9012 world \u548c pv \u77e9\u9635\u5230\u7740\u8272\u5668\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u5e76\u53ef\u4ee5\u907f\u514d\u4e00\u4e9b\u989d\u5916\u7684\u8fd0\u7b97\u3002 \u4f46\u5b9e\u9645\u4e0a\uff0c\u6700\u65b9\u4fbf\u7684\u65b9\u6cd5\u662f\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u3002\u4e3a\u4ec0\u4e48\u8fd9\u6837\uff1f\u56e0\u4e3a\u8981\u8bb0\u4f4f\u6574\u4e2a\u6444\u50cf\u673a\u6982\u5ff5\u5c31\u662f\u4e2a\u9a97\u5c40\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u6765\u6a21\u62df\u6444\u50cf\u673a\u7684\u4f4d\u79fb\uff0c\u5e76\u4ec5\u663e\u793a\u4e00\u5c0f\u90e8\u5206\u7684\u4e09\u7ef4\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5904\u7406\u4e16\u754c\u5750\u6807\uff0c\u53ef\u80fd\u4f1a\u8ba9\u8fdc\u79bb\u539f\u70b9\u7684\u4e16\u754c\u5750\u6807\u9047\u5230\u4e00\u4e9b\u7cbe\u5ea6\u95ee\u9898\u3002\u5982\u679c\u5728\u6240\u8c13\u7684\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u5904\u7406\uff0c\u6211\u4eec\u5c06\u5904\u7406\u7684\u70b9\u867d\u7136\u8fdc\u79bb\u4e16\u754c\u539f\u70b9\uff0c\u4f46\u4e5f\u9760\u8fd1\u6444\u50cf\u673a\u3002\u53ef\u4ee5\u5c06\u89c2\u5bdf\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u7684\u77e9\u9635\u79f0\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u4ee5\u652f\u6301\u6444\u50cf\u673a\u5427\u3002\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Camera \u7684\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u72b6\u6001\u3002\u8be5\u7c7b\u5c06\u63d0\u4f9b\u8bbe\u7f6e\u4f4d\u7f6e\u6216\u65cb\u8f6c\u72b6\u6001\u7684\u65b9\u6cd5\uff08 setPosition \u6216 setRotation \uff09\uff0c\u6216\u5728\u5f53\u524d\u72b6\u6001\u4e0b\u7528\u504f\u79fb\u91cf\u66f4\u65b0\u8fd9\u4e9b\u503c\u7684\u65b9\u6cd5\uff08 movePosition \u6216 moveRotation \uff09\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class Camera { private final Vector3f position; private final Vector3f rotation; public Camera() { position = new Vector3f(0, 0, 0); rotation = new Vector3f(0, 0, 0); } public Camera(Vector3f position, Vector3f rotation) { this.position = position; this.rotation = rotation; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { position.x = x; position.y = y; position.z = z; } public void movePosition(float offsetX, float offsetY, float offsetZ) { if ( offsetZ != 0 ) { position.x += (float)Math.sin(Math.toRadians(rotation.y)) * -1.0f * offsetZ; position.z += (float)Math.cos(Math.toRadians(rotation.y)) * offsetZ; } if ( offsetX != 0) { position.x += (float)Math.sin(Math.toRadians(rotation.y - 90)) * -1.0f * offsetX; position.z += (float)Math.cos(Math.toRadians(rotation.y - 90)) * offsetX; } position.y += offsetY; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { rotation.x = x; rotation.y = y; rotation.z = z; } public void moveRotation(float offsetX, float offsetY, float offsetZ) { rotation.x += offsetX; rotation.y += offsetY; rotation.z += offsetZ; } } \u63a5\u4e0b\u6765\u5728 Transformation \u4e2d\uff0c\u5c06\u5b9a\u4e49\u4e00\u4e2a\u65b0\u77e9\u9635\u6765\u50a8\u5b58\u89c2\u5bdf\u77e9\u9635\u3002 private final Matrix4f viewMatrix; \u6211\u4eec\u8981\u63d0\u4f9b\u4e00\u4e2a\u66f4\u65b0\u8fd9\u4e2a\u503c\u7684\u65b9\u6cd5\u3002\u4e0e\u6295\u5f71\u77e9\u9635\u76f8\u4f3c\uff0c\u8fd9\u4e2a\u77e9\u9635\u5bf9\u4e8e\u6e32\u67d3\u5468\u671f\u4e2d\u6e32\u67d3\u7684\u6240\u6709\u7269\u4f53\u90fd\u662f\u76f8\u540c\u7684\u3002 public Matrix4f getViewMatrix(Camera camera) { Vector3f cameraPos = camera.getPosition(); Vector3f rotation = camera.getRotation(); viewMatrix.identity(); // \u9996\u5148\u8fdb\u884c\u65cb\u8f6c\uff0c\u4f7f\u6444\u50cf\u673a\u5728\u5176\u4f4d\u7f6e\u4e0a\u65cb\u8f6c viewMatrix.rotate((float)Math.toRadians(rotation.x), new Vector3f(1, 0, 0)) .rotate((float)Math.toRadians(rotation.y), new Vector3f(0, 1, 0)); // \u7136\u540e\u505a\u4f4d\u79fb viewMatrix.translate(-cameraPos.x, -cameraPos.y, -cameraPos.z); return viewMatrix; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u65cb\u8f6c\uff0c\u7136\u540e\u4f4d\u79fb\u3002\u5982\u679c\u64cd\u4f5c\u987a\u5e8f\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u4e0d\u4f1a\u6cbf\u7740\u6444\u50cf\u673a\u4f4d\u7f6e\u65cb\u8f6c\uff0c\u800c\u662f\u6cbf\u7740\u5750\u6807\u539f\u70b9\u65cb\u8f6c\u3002\u8bf7\u6ce8\u610f\uff0c\u5728 Camera \u7c7b\u7684 movePosition \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u53ea\u662f\u7b80\u5355\u5730\u589e\u52a0\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u504f\u79fb\u91cf\u3002\u6211\u4eec\u8fd8\u8003\u8651\u4e86\u6cbfY\u8f74\u7684\u65cb\u8f6c\uff0c\u4e5f\u5c31\u662f\u504f\u822a\uff0c\u4ee5\u4fbf\u8ba1\u7b97\u6700\u7ec8\u4f4d\u7f6e\u3002\u5982\u679c\u53ea\u662f\u901a\u8fc7\u504f\u79fb\u6765\u589e\u52a0\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u6444\u50cf\u673a\u5c31\u4e0d\u4f1a\u671d\u7740\u5b83\u6240\u671d\u5411\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u9664\u4e86\u4e0a\u8ff0\u6240\u8bf4\u7684\uff0c\u6211\u4eec\u73b0\u5728\u8fd8\u6ca1\u6709\u5f97\u5230\u4e00\u4e2a\u53ef\u4ee5\u5b8c\u5168\u81ea\u7531\u79fb\u52a8\u7684\u6444\u50cf\u673a\uff08\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u6cbf\u7740X\u8f74\u65cb\u8f6c\uff0c\u5f53\u5411\u524d\u79fb\u52a8\u65f6\uff0c\u6444\u50cf\u673a\u4e0d\u4f1a\u5728\u7a7a\u95f4\u4e2d\u5411\u4e0a\u6216\u5411\u4e0b\u79fb\u52a8\uff09\uff0c\u8fd9\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u8fd9\u6709\u70b9\u590d\u6742\u3002 \u6700\u540e\uff0c\u6211\u4eec\u5c06\u79fb\u9664\u4e4b\u524d\u7684 getWorldMatrix \u65b9\u6cd5\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e2a\u540d\u4e3a getModelViewMatrix \u7684\u65b0\u65b9\u6cd5\u3002 public Matrix4f getModelViewMatrix(GameItem gameItem, Matrix4f viewMatrix) { Vector3f rotation = gameItem.getRotation(); modelViewMatrix.set(viewMatrix).translate(gameItem.getPosition()). rotateX((float)Math.toRadians(-rotation.x)). rotateY((float)Math.toRadians(-rotation.y)). rotateZ((float)Math.toRadians(-rotation.z)). scale(gameItem.getScale()); return modelViewMatrix; } \u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u5c06\u8c03\u7528\u4e00\u6b21 getModelViewMatrix \u65b9\u6cd5\u3002 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u6444\u50cf\u673a\u7684\u503c\uff0c\u5728\u6295\u5f71\u77e9\u9635\u66f4\u65b0\u4e4b\u540e\u66f4\u65b0\u89c2\u5bdf\u77e9\u9635\u3002 // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 Matrix4f viewMatrix = transformation.getViewMatrix(camera); shaderProgram.setUniform(\"texture_sampler\", 0); // \u6e32\u67d3\u6bcf\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u6e32\u67d3\u8be5\u6e38\u620f\u9879\u7684\u7f51\u683c gameItem.getMesh().render(); } \u8fd9\u5c31\u662f\u5b9e\u73b0\u6444\u50cf\u673a\u6982\u5ff5\u7684\u57fa\u672c\u4ee3\u7801\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u53ef\u4ee5\u4fee\u6539\u8f93\u5165\u5904\u7406\u548c\u66f4\u65b0\u6444\u50cf\u673a\u7684\u65b9\u5f0f\uff0c\u5c06\u8bbe\u7f6e\u5982\u4e0b\u6309\u952e\uff1a \u201cA\u201d\u548c\u201cD\u201d\u952e\u4f7f\u6444\u50cf\u673a\u5de6\u53f3\uff08X\u8f74\uff09\u79fb\u52a8\u3002 \u201cW\u201d\u548c\u201cS\u201d\u952e\u4f7f\u6444\u50cf\u673a\u524d\u540e\uff08Z\u8f74\uff09\u79fb\u52a8\u3002 \u201cZ\u201d\u548c\u201cX\u201d\u952e\u4f7f\u6444\u50cf\u673a\u4e0a\u4e0b\uff08Y\u8f74\uff09\u79fb\u52a8\u3002 \u5f53\u9f20\u6807\u6309\u4e0b\u53f3\u952e\u65f6\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9f20\u6807\u4f4d\u7f6e\u6cbfX\u548cY\u8f74\u65cb\u8f6c\u6444\u50cf\u673a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u5c06\u9996\u6b21\u4f7f\u7528\u9f20\u6807\uff0c\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MouseInput \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u5c01\u88c5\u9f20\u6807\u8bbf\u95ee\u3002\u8be5\u7c7b\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine; import org.joml.Vector2d; import org.joml.Vector2f; import static org.lwjgl.glfw.GLFW.*; public class MouseInput { private final Vector2d previousPos; private final Vector2d currentPos; private final Vector2f displVec; private boolean inWindow = false; private boolean leftButtonPressed = false; private boolean rightButtonPressed = false; public MouseInput() { previousPos = new Vector2d(-1, -1); currentPos = new Vector2d(0, 0); displVec = new Vector2f(); } public void init(Window window) { glfwSetCursorPosCallback(window.getWindowHandle(), (windowHandle, xpos, ypos) -> { currentPos.x = xpos; currentPos.y = ypos; }); glfwSetCursorEnterCallback(window.getWindowHandle(), (windowHandle, entered) -> { inWindow = entered; }); glfwSetMouseButtonCallback(window.getWindowHandle(), (windowHandle, button, action, mode) -> { leftButtonPressed = button == GLFW_MOUSE_BUTTON_1 && action == GLFW_PRESS; rightButtonPressed = button == GLFW_MOUSE_BUTTON_2 && action == GLFW_PRESS; }); } public Vector2f getDisplVec() { return displVec; } public void input(Window window) { displVec.x = 0; displVec.y = 0; if (previousPos.x > 0 && previousPos.y > 0 && inWindow) { double deltax = currentPos.x - previousPos.x; double deltay = currentPos.y - previousPos.y; boolean rotateX = deltax != 0; boolean rotateY = deltay != 0; if (rotateX) { displVec.y = (float) deltax; } if (rotateY) { displVec.x = (float) deltay; } } previousPos.x = currentPos.x; previousPos.y = currentPos.y; } public boolean isLeftButtonPressed() { return leftButtonPressed; } public boolean isRightButtonPressed() { return rightButtonPressed; } } MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5e94\u5728\u5728\u521d\u59cb\u5316\u9636\u6bb5\u8c03\u7528\u7684 init \u65b9\u6cd5\uff0c\u5e76\u6ce8\u518c\u4e00\u7ec4\u56de\u8c03\u4ee5\u5904\u7406\u9f20\u6807\u4e8b\u4ef6\uff1a glfwSetCursorPosCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u79fb\u52a8\u65f6\u88ab\u8c03\u7528\u3002 glfwSetCursorEnterCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u65f6\u88ab\u8c03\u7528\u3002\u5373\u4f7f\u9f20\u6807\u4e0d\u5728\u7a97\u53e3\u5185\uff0c\u6211\u4eec\u4e5f\u4f1a\u6536\u5230\u9f20\u6807\u4e8b\u4ef6\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e2a\u56de\u8c03\u6765\u786e\u8ba4\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u3002 glfwSetMouseButtonCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5728\u6309\u4e0b\u9f20\u6807\u6309\u94ae\u65f6\u88ab\u8c03\u7528\u3002 MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a input \u65b9\u6cd5\uff0c\u5728\u5904\u7406\u6e38\u620f\u8f93\u5165\u65f6\u5e94\u8c03\u7528\u8be5\u65b9\u6cd5\u3002\u8be5\u65b9\u6cd5\u8ba1\u7b97\u9f20\u6807\u4ece\u4e0a\u4e00\u4e2a\u4f4d\u7f6e\u7684\u4f4d\u79fb\uff0c\u5e76\u5c06\u5176\u5b58\u50a8\u5230 Vector2f \u7c7b\u578b\u7684 displVec \u53d8\u91cf\u4e2d\uff0c\u4ee5\u4fbf\u6e38\u620f\u4f7f\u7528\u5b83\u3002 MouseInput \u7c7b\u5c06\u5728 GameEngine \u7c7b\u4e2d\u5b9e\u4f8b\u5316\uff0c\u5e76\u4e14\u5c06\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7ed9\u6e38\u620f\u5b9e\u73b0\u7684 init \u548c update \u65b9\u6cd5\uff08\u56e0\u6b64\u9700\u8981\u76f8\u5e94\u5730\u66f4\u6539 IGameLogic \u63a5\u53e3\uff09\u3002 void input(Window window, MouseInput mouseInput); void update(float interval, MouseInput mouseInput); \u9f20\u6807\u8f93\u5165\u5c06\u5728 GameEngine \u7c7b\u7684 input \u65b9\u6cd5\u4e2d\u88ab\u5904\u7406\uff0c\u800c\u6700\u7ec8\u7684\u63a7\u5236\u5c06\u4ea4\u7531\u6e38\u620f\u5b9e\u73b0\u3002 protected void input() { mouseInput.input(window); gameLogic.input(window, mouseInput); } \u73b0\u5728\u5df2\u7ecf\u51c6\u5907\u597d\u4fee\u6539 DummyGame \u7c7b\u6765\u5904\u7406\u952e\u76d8\u548c\u9f20\u6807\u8f93\u5165\u4e86\u3002\u8be5\u7c7b\u7684\u8f93\u5165\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a @Override public void input(Window window, MouseInput mouseInput) { cameraInc.set(0, 0, 0); if (window.isKeyPressed(GLFW_KEY_W)) { cameraInc.z = -1; } else if (window.isKeyPressed(GLFW_KEY_S)) { cameraInc.z = 1; } if (window.isKeyPressed(GLFW_KEY_A)) { cameraInc.x = -1; } else if (window.isKeyPressed(GLFW_KEY_D)) { cameraInc.x = 1; } if (window.isKeyPressed(GLFW_KEY_Z)) { cameraInc.y = -1; } else if (window.isKeyPressed(GLFW_KEY_X)) { cameraInc.y = 1; } } \u8fd9\u53ea\u662f\u66f4\u65b0\u4e00\u4e2a\u540d\u4e3a cameraInc \u7684 Vector3f \u53d8\u91cf\uff0c\u5b83\u50a8\u5b58\u4e86\u6444\u50cf\u673a\u5e94\u7528\u7684\u4f4d\u79fb\u3002 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u5c06\u6839\u636e\u5904\u7406\u7684\u952e\u76d8\u548c\u9f20\u6807\u4e8b\u4ef6\uff0c\u4fee\u6539\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u3002 @Override public void update(float interval, MouseInput mouseInput) { // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u57fa\u4e8e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); } } \u73b0\u5728\u53ef\u4ee5\u6dfb\u52a0\u66f4\u591a\u7684\u7acb\u65b9\u4f53\u5230\u4e16\u754c\u4e2d\uff0c\u7f29\u653e\u5b83\u4eec\uff0c\u5c06\u5b83\u4eec\u8bbe\u7f6e\u5728\u7279\u5b9a\u4f4d\u7f6e\uff0c\u5e76\u4f7f\u7528\u65b0\u6444\u50cf\u673a\u6e38\u73a9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6240\u6709\u7684\u7acb\u65b9\u4f53\u5171\u4eab\u76f8\u540c\u7684\u7f51\u683c\u3002 GameItem gameItem1 = new GameItem(mesh); gameItem1.setScale(0.5f); gameItem1.setPosition(0, 0, -2); GameItem gameItem2 = new GameItem(mesh); gameItem2.setScale(0.5f); gameItem2.setPosition(0.5f, 0.5f, -2); GameItem gameItem3 = new GameItem(mesh); gameItem3.setScale(0.5f); gameItem3.setPosition(0, 0, -2.5f); GameItem gameItem4 = new GameItem(mesh); gameItem4.setScale(0.5f); gameItem4.setPosition(0.5f, 0, -2.5f); gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4}; \u4f60\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\u3002","title":"\u6444\u50cf\u673a\uff08Camera\uff09"},{"location":"09-loading-more-complex-models/","text":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b\uff08Loading more complex models\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u52a0\u8f7d\u5728\u5916\u90e8\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u590d\u6742\u6a21\u578b\u3002\u8fd9\u4e9b\u6a21\u578b\u5c06\u4f7f\u75283D\u5efa\u6a21\u5de5\u5177(\u4f8b\u5982 Blender )\u521b\u5efa\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u901a\u8fc7\u76f4\u63a5\u7f16\u7801\u5b9a\u4e49\u5176\u51e0\u4f55\u56fe\u5f62\u7684\u6570\u7ec4\u6765\u521b\u5efa\u6a21\u578b\u3002\u4f46\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u4ee5OBJ\u683c\u5f0f\u5b9a\u4e49\u7684\u6a21\u578b\u3002 OBJ\uff08\u6216.obj\uff09\u662fWavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002OBJ\u6587\u4ef6\u5b9a\u4e49\u6784\u6210\u4e09\u7ef4\u6a21\u578b\u7684\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u591a\u8fb9\u5f62\u3002\u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5bb9\u6613\u89e3\u6790\u7684\u683c\u5f0f\uff0c\u56e0\u4e3a\u5b83\u57fa\u4e8e\u6587\u672c\uff0c\u6bcf\u4e00\u884c\u5b9a\u4e49\u4e00\u4e2a\u5143\u7d20\uff08\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u7b49\uff09\u3002 \u5728.obj\u6587\u4ef6\u4e2d\uff0c\u6bcf\u884c\u4ee5\u4e00\u4e2a\u6807\u8bb0\u5143\u7d20\u7c7b\u578b\u7684\u6807\u8bc6\u7b26\u5f00\u5934\uff1a \u4ee5\"#\"\u5f00\u59cb\u7684\u884c\u662f\u6ce8\u91ca\u3002 \u4ee5\"v\"\u5f00\u59cb\u7684\u884c\u7528\u5750\u6807(x, y, z, w)\u5b9a\u4e49\u4e00\u4e2a\u51e0\u4f55\u9876\u70b9\u3002\u4f8b\u5982\uff1a v 0.155 0.211 0.32 1.0 \u3002 \u4ee5\"vn\"\u5f00\u59cb\u7684\u884c\u662f\u7528\u5750\u6807(x, y, z)\u5b9a\u4e49\u9876\u70b9\u6cd5\u7ebf\uff08Normals\uff09\u3002\u4f8b\u5982\uff1a vn 0.71 0.21 0.82 \u3002\u4e4b\u540e\u518d\u8ba8\u8bba\u8fd9\u4e2a\u4e1c\u897f\u3002 \u4ee5\"vt\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u3002\u4f8b\u5982\uff1a vt 0.500 1 \u3002 \u4ee5\"f\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u9762\u3002\u5229\u7528\u8be5\u884c\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u6784\u9020\u7d22\u5f15\u6570\u7ec4\u3002\u6211\u4eec\u53ea\u5904\u7406\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u7684\u60c5\u51b5\u3002\u5b83\u53ef\u4ee5\u6709\u51e0\u79cd\u5b9a\u4e49\u65b9\u5f0f\uff1a \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\uff08 f v1 v2 v3 \uff09\u3002\u4f8b\u5982\uff1a f 6 3 1 \u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u8fd9\u4e2a\u4e09\u89d2\u5f62\u662f\u7531\u4f4d\u7f6e\u4e3a6\u30013\u548c1\u7684\u51e0\u4f55\u9876\u70b9\u5b9a\u4e49\u7684\uff08\u9876\u70b9\u7d22\u5f15\u603b\u662f\u4ece1\u5f00\u59cb\uff09\u3002 \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff08 f v1/t1/n1 v2/t2/n2 v3/t3/n3 \uff09\u3002\u4f8b\u5982\uff1a f 6/4/1 3/5/3 7/6/5 \u3002\u7b2c\u4e00\u90e8\u5206\u662f v1/t1/n1 \uff0c\u5176\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6cd5\u7ebf\u3002\u770b\u5230\u8be5\u90e8\u5206\u53ef\u4ee5\u8bf4\u51fa\uff1a\u9009\u62e9\u51e0\u4f55\u9876\u70b96\u3001\u7eb9\u7406\u5750\u68074\u548c\u9876\u70b9\u6cd5\u7ebf1\u3002 OBJ\u683c\u5f0f\u6709\u66f4\u591a\u7684\u5143\u7d20\u7c7b\u578b\uff08\u5982\u4e00\u7ec4\u591a\u8fb9\u5f62\u3001\u5b9a\u4e49\u6750\u8d28\u7b49\uff09\u3002\u73b0\u5728\u6211\u4eec\u4ec5\u5b9e\u73b0\u4e0a\u8ff0\u5b50\u96c6\uff0c\u6211\u4eec\u7684OBJ\u52a0\u8f7d\u5668\u5c06\u5ffd\u7565\u5176\u4ed6\u5143\u7d20\u7c7b\u578b\u3002 \u4f46\u662f\u4ec0\u4e48\u662f\u6cd5\u7ebf\u5462\uff1f\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u5b83\u3002\u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u5982\u4e0a\u6240\u89c1\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u6709\u4e24\u6761\u6cd5\u7ebf\uff0c\u6211\u4eec\u5e94\u8be5\u7528\u54ea\u4e00\u4e2a\u5462\uff1f\u4e09\u7ef4\u56fe\u5f62\u4e2d\u7684\u6cd5\u7ebf\u662f\u7528\u4e8e\u5149\u7167\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u9762\u5411\u5149\u6e90\u7684\u6cd5\u7ebf\u3002\u6362\u8a00\u4e4b\uff0c\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u6307\u5411\u6a21\u578b\u5916\u7684\u6cd5\u7ebf\u3002 \u6211\u4eec\u6709\u4e00\u4e2a\u7531\u591a\u8fb9\u5f62\u548c\u4e09\u89d2\u5f62\u7ec4\u6210\u76843D\u6a21\u578b\uff0c\u6bcf\u4e2a\u4e09\u89d2\u5f62\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\uff0c\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u5411\u91cf\u662f\u5782\u76f4\u4e8e\u4e09\u89d2\u5f62\u8868\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u9876\u70b9\u6cd5\u7ebf\u4e0e\u7279\u5b9a\u9876\u70b9\u76f8\u5173\u8054\uff0c\u5e76\u4e14\u662f\u5468\u56f4\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff08\u5f53\u7136\u5b83\u7684\u957f\u5ea6\u7b49\u4e8e1\uff09\u3002\u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u4e00\u4e2a3D\u7f51\u683c\u7684\u9876\u70b9\u6a21\u578b\uff08\u53d6\u81ea \u7ef4\u57fa\u767e\u79d1 \uff09 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u521b\u5efaOBJ\u52a0\u8f7d\u5668\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u4fee\u6539 Mesh \u7c7b\uff0c\u56e0\u4e3a\u73b0\u5728\u5fc5\u987b\u4f7f\u7528\u7eb9\u7406\u3002\u6211\u4eec\u53ef\u80fd\u52a0\u8f7d\u4e00\u4e9b\u6ca1\u6709\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u7684OBJ\u6587\u4ef6\uff0c\u56e0\u6b64\u5fc5\u987b\u80fd\u591f\u4f7f\u7528\u989c\u8272\u800c\u4e0d\u662f\u4f7f\u7528\u7eb9\u7406\u6e32\u67d3\u5b83\u4eec\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u7684\u5b9a\u4e49\u683c\u5f0f\u4e3a\uff1a f v/n \u3002 Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u540d\u4e3a colour \u7684\u65b0\u5c5e\u6027\u3002 private Vector3f colour; \u5e76\u4e14\u6784\u9020\u51fd\u6570\u4e0d\u518d\u9700\u8981 Texture \u3002\u53d6\u800c\u4ee3\u4e4b\u7684\u662f\uff0c\u6211\u4eec\u5c06\u4e3a\u7eb9\u7406\u548c\u989c\u8272\u5c5e\u6027\u63d0\u4f9b get \u548c set \u65b9\u6cd5\u3002 public Mesh(float[] positions, float[] textCoords, float[] normals, int[] indices) { \u5f53\u7136\uff0c\u5728 render \u548c clear \u65b9\u6cd5\u4e2d\uff0c\u5728\u4f7f\u7528\u7eb9\u7406\u4e4b\u524d\uff0c\u5fc5\u987b\u68c0\u67e5\u7eb9\u7406\u662f\u5426\u4e3a null \u3002\u6b63\u5982\u4f60\u5728\u6784\u9020\u51fd\u6570\u4e2d\u770b\u5230\u7684\uff0c\u73b0\u5728\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u540d\u4e3a normals \u7684\u65b0\u6d6e\u70b9\u6570\u7ec4\u3002\u5982\u4f55\u4f7f\u7528\u6cd5\u7ebf\u6e32\u67d3\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5b83\u53ea\u662fVAO\u4e2d\u7684\u53e6\u4e00\u4e2aVBO\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u5982\u4e0b\u4ee3\u7801\uff1a // \u9876\u70b9\u6cd5\u7ebfVBO vboId = glGenBuffers(); vboIdList.add(vboId); vecNormalsBuffer = MemoryUtil.memAllocFloat(normals.length); vecNormalsBuffer.put(normals).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, vecNormalsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(2); glVertexAttribPointer(2, 3, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9 Mesh \u7c7b\u7684\u4fee\u6539\uff0c\u53ef\u4ee5\u4fee\u6539\u4ee3\u7801\u6765\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6216\u56fa\u5b9a\u7684\u989c\u8272\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u50cf\u8fd9\u6837\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 colour; uniform int useColour; void main() { if ( useColour == 1 ) { fragColor = vec4(colour, 1); } else { fragColor = texture(texture_sampler, outTexCoord); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e24\u4e2a\u65b0Uniform\uff1a colour : \u5c06\u50a8\u5b58\u57fa\u672c\u989c\u8272\u3002 useColour : \u8fd9\u662f\u4e2a\u6807\u5fd7\uff0c\u5f53\u4f60\u4e0d\u60f3\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u5b83\u5c06\u88ab\u8bbe\u7f6e\u4e3a1\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u8fd9\u4e24\u4e2aUniform\u3002 // \u4e3a\u9ed8\u8ba4\u989c\u8272\u4e0e\u63a7\u5236\u5b83\u7684\u6807\u5fd7\u521b\u5efaUniform shaderProgram.createUniform(\"colour\"); shaderProgram.createUniform(\"useColour\"); \u548c\u5176\u4ed6Uniform\u4e00\u6837\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e5f\u9700\u8981\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\u3002 for(GameItem gameItem : gameItems) { Mesh mesh = gameItem.getMesh(); // \u4e3a\u8be5\u6e38\u620f\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c shaderProgram.setUniform(\"colour\", mesh.getColour()); shaderProgram.setUniform(\"useColour\", mesh.isTextured() ? 0 : 1); mesh.render(); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a OBJLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u89e3\u6790OBJ\u6587\u4ef6\uff0c\u5e76\u7528\u5176\u4e2d\u5305\u542b\u7684\u6570\u636e\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u3002\u4f60\u53ef\u80fd\u4f1a\u5728\u7f51\u4e0a\u53d1\u73b0\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\u53ef\u80fd\u6bd4\u8fd9\u66f4\u6709\u6548\uff0c\u4f46\u6211\u8ba4\u4e3a\u8be5\u65b9\u6848\u66f4\u5bb9\u6613\u7406\u89e3\u3002\u8fd9\u662f\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u5c06\u6709\u5982\u4e0b\u9759\u6001\u65b9\u6cd5\uff1a public static Mesh loadMesh(String fileName) throws Exception { \u53c2\u6570 fileName \u6307\u5b9aOBJ\u6a21\u578b\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8be5\u6587\u4ef6\u5fc5\u987b\u5305\u542b\u5728\u7c7b\u8def\u5f84\u4e2d\u3002 \u5728\u8be5\u65b9\u6cd5\u4e2d\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9\u5e76\u5c06\u6240\u6709\u884c\u50a8\u5b58\u5230\u4e00\u4e2a\u6570\u7ec4\u4e2d\uff0c\u7136\u540e\u521b\u5efa\u51e0\u4e2a\u5217\u8868\u6765\u50a8\u5b58\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u9762\u3002 List<String> lines = Utils.readAllLines(fileName); List<Vector3f> vertices = new ArrayList<>(); List<Vector2f> textures = new ArrayList<>(); List<Vector3f> normals = new ArrayList<>(); List<Face> faces = new ArrayList<>(); \u7136\u540e\u89e3\u6790\u6bcf\u4e00\u884c\uff0c\u5e76\u6839\u636e\u5f00\u5934\u6807\u8bc6\u7b26\u5f97\u5230\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u9876\u70b9\u6cd5\u7ebf\u6216\u9762\u5b9a\u4e49\uff0c\u6700\u540e\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 for (String line : lines) { String[] tokens = line.split(\"\\\\s+\"); switch (tokens[0]) { case \"v\": // \u51e0\u4f55\u9876\u70b9 Vector3f vec3f = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); vertices.add(vec3f); break; case \"vt\": // \u7eb9\u7406\u5750\u6807 Vector2f vec2f = new Vector2f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2])); textures.add(vec2f); break; case \"vn\": // \u9876\u70b9\u6cd5\u7ebf Vector3f vec3fNorm = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); normals.add(vec3fNorm); break; case \"f\": Face face = new Face(tokens[1], tokens[2], tokens[3]); faces.add(face); break; default: // \u5ffd\u7565\u5176\u4ed6\u884c break; } } return reorderLists(vertices, textures, normals, faces); \u5728\u8bb2\u89e3\u91cd\u65b0\u6392\u5e8f\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u5982\u4f55\u89e3\u6790\u9762\u7684\u5b9a\u4e49\u3002\u6211\u4eec\u5df2\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Face \u7684\u7c7b\uff0c\u5b83\u8d1f\u8d23\u89e3\u6790\u4e00\u4e2a\u9762\u7684\u5b9a\u4e49\u3002\u4e00\u4e2a Face \u662f\u7531\u4e00\u4e2a\u7d22\u5f15\u7ec4\u5217\u8868\u7ec4\u6210\u7684\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u5904\u7406\u7684\u662f\u4e09\u89d2\u5f62\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u6709\u4e09\u4e2a\u7d22\u5f15\u7ec4\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a IndexGroup \u7684\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u7d22\u5f15\u7ec4\u7684\u6570\u636e\u3002 protected static class IdxGroup { public static final int NO_VALUE = -1; public int idxPos; public int idxTextCoord; public int idxVecNormal; public IdxGroup() { idxPos = NO_VALUE; idxTextCoord = NO_VALUE; idxVecNormal = NO_VALUE; } } Face \u7c7b\u5982\u4e0b\u6240\u793a\uff1a protected static class Face { /** * \u9762\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u7ec4\u5217\u8868\uff08\u6bcf\u4e2a\u9762\u4e09\u4e2a\u9876\u70b9\uff09\u3002 */ private IdxGroup[] idxGroups = new IdxGroup[3]; public Face(String v1, String v2, String v3) { idxGroups = new IdxGroup[3]; // \u89e3\u6790\u884c idxGroups[0] = parseLine(v1); idxGroups[1] = parseLine(v2); idxGroups[2] = parseLine(v3); } private IdxGroup parseLine(String line) { IdxGroup idxGroup = new IdxGroup(); String[] lineTokens = line.split(\"/\"); int length = lineTokens.length; idxGroup.idxPos = Integer.parseInt(lineTokens[0]) - 1; if (length > 1) { // \u5982\u679cOBJ\u4e0d\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\uff0c\u5219\u53ef\u4e3anull String textCoord = lineTokens[1]; idxGroup.idxTextCoord = textCoord.length() > 0 ? Integer.parseInt(textCoord) - 1 : IdxGroup.NO_VALUE; if (length > 2) { idxGroup.idxVecNormal = Integer.parseInt(lineTokens[2]) - 1; } } return idxGroup; } public IdxGroup[] getFaceVertexIndices() { return idxGroups; } } \u5f53\u89e3\u6790\u9762\u65f6\uff0c\u6211\u4eec\u53ef\u4ee5\u770b\u5230\u6ca1\u6709\u7eb9\u7406\u4f46\u5e26\u6709\u77e2\u91cf\u6cd5\u7ebf\u7684\u5bf9\u8c61\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u5b9a\u4e49\u53ef\u80fd\u50cf f 11//1 17//1 13//1 \u8fd9\u6837\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8fd9\u4e9b\u60c5\u51b5\u3002 \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 Mesh \u7c7b\u9700\u8981\u56db\u4e2a\u6570\u7ec4\uff0c\u5206\u522b\u7528\u4e8e\u4f4d\u7f6e\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u77e2\u91cf\u548c\u7d22\u5f15\u3002\u524d\u4e09\u4e2a\u6570\u7ec4\u5e94\u8be5\u5177\u6709\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\uff0c\u56e0\u4e3a\u7d22\u5f15\u6570\u7ec4\u662f\u552f\u4e00\u7684\uff08\u6ce8\u610f\uff0c\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\u5e76\u4e0d\u610f\u5473\u7740\u76f8\u540c\u7684\u957f\u5ea6\u3002\u9876\u70b9\u5750\u6807\u662f\u4e09\u7ef4\u7684\uff0c\u7531\u4e09\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u3002\u7eb9\u7406\u5750\u6807\u662f\u4e8c\u7ef4\u7684\uff0c\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\uff09\u3002OpenGL\u4e0d\u5141\u8bb8\u6211\u4eec\u5bf9\u6bcf\u4e2a\u5143\u7d20\u7c7b\u578b\u5b9a\u4e49\u4e0d\u540c\u7684\u7d22\u5f15\u6570\u7ec4\uff08\u5982\u679c\u53ef\u4ee5\u7684\u8bdd\uff0c\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u5728\u5e94\u7528\u7eb9\u7406\u65f6\u91cd\u590d\u9876\u70b9\uff09\u3002 \u5f53\u4f60\u6253\u5f00\u4e00\u4e2aOBJ\u6587\u4ef6\u65f6\uff0c\u4f60\u9996\u5148\u53ef\u80fd\u4f1a\u770b\u5230\u50a8\u5b58\u9876\u70b9\u5750\u6807\u7684\u5217\u8868\uff0c\u6bd4\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6570\u91cf\u7684\u5217\u8868\u7684\u5143\u7d20\u6570\u91cf\u66f4\u591a\u3002\u8fd9\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u95ee\u9898\u3002\u4e3e\u4e00\u4e2a\u7b80\u5355\u7684\u4f8b\u5b50\uff0c\u5b9a\u4e49\u4e00\u4e2a\u5177\u6709\u50cf\u7d20\u9ad8\u5ea6\u7684\u6b63\u65b9\u5f62\uff08\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\uff0c\u5176OBJ\u6587\u4ef6\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff08\u4e0d\u8981\u592a\u5173\u6ce8\u6cd5\u7ebf\u5750\u6807\uff0c\u56e0\u4e3a\u5b83\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\u3002 v 0 0 0 v 1 0 0 v 1 1 0 v 0 1 0 vt 0 1 vt 1 1 vn 0 0 1 f 1/2/1 2/1/1 3/2/1 f 1/2/1 3/2/1 4/1/1 \u5f53\u5b8c\u6210\u5bf9\u6587\u4ef6\u7684\u89e3\u6790\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u5982\u4e0b\u6240\u793a\u5217\u8868\uff08\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b57\u662f\u5b83\u5728\u6587\u4ef6\u4e2d\u7684\u4f4d\u7f6e\u987a\u5e8f\uff0c\u6309\u51fa\u73b0\u987a\u5e8f\u6392\u5217\uff09\uff1a \u73b0\u5728\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u5b9a\u4e49\u6765\u521b\u5efa\u5305\u542b\u7d22\u5f15\u7684\u6700\u7ec8\u6570\u7ec4\u3002\u9700\u8981\u8003\u8651\u7684\u662f\uff0c\u7eb9\u7406\u5750\u6807\u4e0e\u6cd5\u7ebf\u5411\u91cf\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0e\u9876\u70b9\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0d\u5bf9\u5e94\u3002\u5982\u679c\u5217\u8868\u7684\u5927\u5c0f\u662f\u76f8\u540c\u7684\u5e76\u6709\u5e8f\u7684\uff0c\u90a3\u4e48\u9762\u5b9a\u4e49\u5c31\u53ea\u9700\u8981\u6bcf\u4e2a\u9876\u70b9\u4e00\u4e2a\u7d22\u5f15\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6392\u5217\u6570\u636e\uff0c\u5e76\u6839\u636e\u9700\u8981\u8fdb\u884c\u76f8\u5e94\u7684\u8bbe\u7f6e\u3002\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e09\u4e2a\u6570\u7ec4\uff08\u7528\u4e8e\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff09\u548c\u4e00\u4e2a\u7d22\u5f15\u5217\u8868\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u4e09\u4e2a\u6570\u7ec4\u5143\u7d20\u6570\u91cf\u76f8\u540c\uff08\u7b49\u4e8e\u9876\u70b9\u6570\uff09\uff0c\u9876\u70b9\u6570\u7ec4\u5c06\u662f\u9876\u70b9\u5217\u8868\u7684\u526f\u672c\u3002 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u5904\u7406\u8fd9\u4e9b\u9762\u3002\u7b2c\u4e00\u4e2a\u9762\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u7ec4\u662f1/2/1\u3002\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\uff08\u5b9a\u4e49\u51e0\u4f55\u9876\u70b9\u7684\u7d22\u5f15\uff09\u6765\u6784\u9020\u7d22\u5f15\u5217\u8868\uff0c\u79f0\u4e4b\u4e3a posIndex \u3002 \u9762\u6307\u5b9a\u6211\u4eec\u5e94\u8be5\u628a\u5360\u636e\u7b2c\u4e00\u4e2a\u4f4d\u7f6e\u7684\u5143\u7d20\u7684\u7d22\u5f15\u6dfb\u52a0\u5230\u7d22\u5f15\u5217\u8868\u4e2d\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06 posIndex \u51cf\u53bb1\u540e\u653e\u5230 indicesList \u4e2d\uff08\u5fc5\u987b\u51cf1\uff0c\u56e0\u4e3a\u6570\u7ec4\u7684\u8d77\u59cb\u662f0\uff0c\u800cOBJ\u6587\u4ef6\u683c\u5f0f\u4e2d\u8d77\u59cb\u662f1\uff09\u3002 \u7136\u540e\uff0c\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u7684\u5176\u4ed6\u7d22\u5f15\u6765\u8bbe\u7f6e texturesArray \u548c normalsArray \u3002\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u662f2\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5c06\u7b2c\u4e8c\u4e2a\u7eb9\u7406\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u7136\u540e\u6211\u4eec\u770b\u5230\u7b2c\u4e09\u4e2a\u7d22\u5f15\uff0c\u5b83\u4e3a1\uff0c\u6240\u4ee5\u8981\u505a\u7684\u662f\u5c06\u7b2c\u4e00\u4e2a\u6cd5\u7ebf\u5411\u91cf\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e00\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e8c\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u7b2c\u4e8c\u4e2a\u9762\u4e5f\u5b9a\u4e49\u4e86\u5df2\u7ecf\u88ab\u8d4b\u503c\u7684\u9876\u70b9\uff0c\u4f46\u662f\u5b83\u4eec\u6709\u76f8\u540c\u7684\u503c\uff0c\u6240\u4ee5\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u4e0a\u5f88\u7b80\u5355\u3002\u6211\u89c9\u5f97\u8fd9\u4e2a\u8fc7\u7a0b\u5df2\u7ecf\u8bb2\u89e3\u5f97\u8db3\u591f\u6e05\u6670\u4e86\uff0c\u4e0d\u8fc7\u5728\u4f60\u660e\u767d\u4e4b\u524d\u53ef\u80fd\u4f1a\u6709\u4e9b\u68d8\u624b\u3002\u91cd\u65b0\u6392\u5217\u6570\u636e\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\u3002\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u8981\u7684\u662f\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u9876\u70b9\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u7ec4\u8f6c\u6362\u4e3a\u6d6e\u70b9\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u5bf9\u4e8e\u9876\u70b9\u548c\u6cd5\u7ebf\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee53\uff0c\u800c\u5bf9\u4e8e\u7eb9\u7406\u5750\u6807\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee52\u3002 private static Mesh reorderLists(List<Vector3f> posList, List<Vector2f> textCoordList, List<Vector3f> normList, List<Face> facesList) { List<Integer> indices = new ArrayList<>(); // \u6309\u58f0\u660e\u7684\u987a\u5e8f\u521b\u5efa\u4f4d\u7f6e\u6570\u7ec4 float[] posArr = new float[posList.size() * 3]; int i = 0; for (Vector3f pos : posList) { posArr[i * 3] = pos.x; posArr[i * 3 + 1] = pos.y; posArr[i * 3 + 2] = pos.z; i++; } float[] textCoordArr = new float[posList.size() * 2]; float[] normArr = new float[posList.size() * 3]; for (Face face : facesList) { IdxGroup[] faceVertexIndices = face.getFaceVertexIndices(); for (IdxGroup indValue : faceVertexIndices) { processFaceVertex(indValue, textCoordList, normList, indices, textCoordArr, normArr); } } int[] indicesArr = new int[indices.size()]; indicesArr = indices.stream().mapToInt((Integer v) -> v).toArray(); Mesh mesh = new Mesh(posArr, textCoordArr, normArr, indicesArr); return mesh; } private static void processFaceVertex(IdxGroup indices, List<Vector2f> textCoordList, List<Vector3f> normList, List<Integer> indicesList, float[] texCoordArr, float[] normArr) { // \u8bbe\u7f6e\u9876\u70b9\u5750\u6807\u7684\u7d22\u5f15 int posIndex = indices.idxPos; indicesList.add(posIndex); // \u5bf9\u7eb9\u7406\u5750\u6807\u91cd\u65b0\u6392\u5e8f if (indices.idxTextCoord >= 0) { Vector2f textCoord = textCoordList.get(indices.idxTextCoord); texCoordArr[posIndex * 2] = textCoord.x; texCoordArr[posIndex * 2 + 1] = 1 - textCoord.y; } if (indices.idxVecNormal >= 0) { // \u5bf9\u6cd5\u7ebf\u5411\u91cf\u91cd\u65b0\u6392\u5e8f Vector3f vecNorm = normList.get(indices.idxVecNormal); normArr[posIndex * 3] = vecNorm.x; normArr[posIndex * 3 + 1] = vecNorm.y; normArr[posIndex * 3 + 2] = vecNorm.z; } } \u6b64\u5916\u9700\u8981\u6ce8\u610f\u7684\u662f\u7eb9\u7406\u5750\u6807\u662fUV\u683c\u5f0f\uff0c\u6240\u4ee5Y\u5750\u6807\u4e3a\u7528\u4e00\u51cf\u53bb\u6587\u4ef6\u4e2d\u53d6\u5230\u7684\u503c\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6e32\u67d3OBJ\u6a21\u578b\u3002\u6211\u51c6\u5907\u4e86\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u662f\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u8fc7\u7684\u5177\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u5728 DummyGame \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002 Texture texture = new Texture(\"/textures/grassblock.png\"); mesh.setTexture(texture); GameItem gameItem = new GameItem(mesh); gameItem.setScale(0.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u7136\u540e\u5c06\u4f1a\u5f97\u5230\u4e00\u4e2a\u719f\u6089\u7684\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002 \u6211\u4eec\u53ef\u4ee5\u5c1d\u8bd5\u6e32\u67d3\u5176\u4ed6\u6a21\u578b\uff0c\u4f8b\u5982\u53ef\u4ee5\u4f7f\u7528\u8457\u540d\u7684Stanford Bunny\u6a21\u578b\uff08\u5b83\u53ef\u4ee5\u514d\u8d39\u4e0b\u8f7d\uff09\uff0c\u5b83\u653e\u5728resources\u6587\u4ef6\u5939\u4e2d\u3002\u8fd9\u4e2a\u6a21\u578b\u6ca1\u6709\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u505a\uff1a Mesh mesh = OBJLoader.loadMesh(\"/models/bunny.obj\"); GameItem gameItem = new GameItem(mesh); gameItem.setScale(1.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u8fd9\u4e2a\u6a21\u578b\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u56e0\u4e3a\u6ca1\u6709\u7eb9\u7406\u4e5f\u6ca1\u6709\u5149\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u80fd\u770b\u5230\u5b83\u7684\u4f53\u79ef\uff0c\u4f46\u662f\u4f60\u53ef\u4ee5\u68c0\u67e5\u6a21\u578b\u662f\u5426\u6b63\u786e\u5730\u52a0\u8f7d\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u8bbe\u7f6eOpenGL\u53c2\u6570\u65f6\uff0c\u6dfb\u52a0\u8fd9\u4e00\u884c\u4ee3\u7801\u3002 glPolygonMode( GL_FRONT_AND_BACK, GL_LINE ); \u5f53\u4f60\u653e\u5927\u7684\u65f6\u5019\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6784\u6210\u6a21\u578b\u7684\u6240\u6709\u4e09\u89d2\u5f62\u3002 \u6709\u4e86\u8fd9\u4e2aOBJ\u8f7d\u5165\u7c7b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u4f7f\u7528Blender\u521b\u5efa\u6a21\u578b\u3002Blender\u662f\u4e00\u4e2a\u5f3a\u5927\u7684\u5de5\u5177\uff0c\u4f46\u521a\u5f00\u59cb\u4f7f\u7528\u5b83\u6709\u70b9\u56f0\u96be\uff0c\u5b83\u6709\u5f88\u591a\u9009\u9879\uff0c\u5f88\u591a\u5173\u8282\u7ec4\u5408\uff0c\u5728\u9996\u6b21\u4f7f\u7528\u5b83\u65f6\u4f60\u9700\u8981\u82b1\u65f6\u95f4\u505a\u5f88\u591a\u6700\u57fa\u672c\u7684\u4e8b\u60c5\u3002\u5f53\u4f7f\u7528Blender\u5bfc\u51fa\u6a21\u578b\u65f6\uff0c\u8bf7\u786e\u4fdd\u5305\u542b\u6cd5\u7ebf\u5e76\u5c06\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u3002 \u5bfc\u51fa\u65f6\u8bf7\u8bb0\u5f97\u5206\u5272\u8fb9\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u80fd\u5c06\u591a\u4e2a\u7eb9\u7406\u5750\u6807\u6307\u5b9a\u7ed9\u540c\u4e00\u4e2a\u9876\u70b9\u3002\u6b64\u5916\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u4e09\u89d2\u5f62\u5b9a\u4e49\u6cd5\u7ebf\uff0c\u800c\u4e0d\u662f\u6307\u5b9a\u7ed9\u9876\u70b9\u3002\u5982\u679c\u4f60\u5728\u67d0\u4e9b\u6a21\u578b\u4e2d\u9047\u5230\u4e86\u5149\u7167\u95ee\u9898\uff08\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff09\uff0c\u4f60\u5e94\u8be5\u9a8c\u8bc1\u4e00\u4e0b\u6cd5\u7ebf\u3002\u4f60\u53ef\u4ee5\u5728Blender\u4e2d\u770b\u5230\u6cd5\u7ebf\u3002","title":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b"},{"location":"09-loading-more-complex-models/#loading-more-complex-models","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u52a0\u8f7d\u5728\u5916\u90e8\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u590d\u6742\u6a21\u578b\u3002\u8fd9\u4e9b\u6a21\u578b\u5c06\u4f7f\u75283D\u5efa\u6a21\u5de5\u5177(\u4f8b\u5982 Blender )\u521b\u5efa\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u901a\u8fc7\u76f4\u63a5\u7f16\u7801\u5b9a\u4e49\u5176\u51e0\u4f55\u56fe\u5f62\u7684\u6570\u7ec4\u6765\u521b\u5efa\u6a21\u578b\u3002\u4f46\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u4ee5OBJ\u683c\u5f0f\u5b9a\u4e49\u7684\u6a21\u578b\u3002 OBJ\uff08\u6216.obj\uff09\u662fWavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002OBJ\u6587\u4ef6\u5b9a\u4e49\u6784\u6210\u4e09\u7ef4\u6a21\u578b\u7684\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u591a\u8fb9\u5f62\u3002\u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5bb9\u6613\u89e3\u6790\u7684\u683c\u5f0f\uff0c\u56e0\u4e3a\u5b83\u57fa\u4e8e\u6587\u672c\uff0c\u6bcf\u4e00\u884c\u5b9a\u4e49\u4e00\u4e2a\u5143\u7d20\uff08\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u7b49\uff09\u3002 \u5728.obj\u6587\u4ef6\u4e2d\uff0c\u6bcf\u884c\u4ee5\u4e00\u4e2a\u6807\u8bb0\u5143\u7d20\u7c7b\u578b\u7684\u6807\u8bc6\u7b26\u5f00\u5934\uff1a \u4ee5\"#\"\u5f00\u59cb\u7684\u884c\u662f\u6ce8\u91ca\u3002 \u4ee5\"v\"\u5f00\u59cb\u7684\u884c\u7528\u5750\u6807(x, y, z, w)\u5b9a\u4e49\u4e00\u4e2a\u51e0\u4f55\u9876\u70b9\u3002\u4f8b\u5982\uff1a v 0.155 0.211 0.32 1.0 \u3002 \u4ee5\"vn\"\u5f00\u59cb\u7684\u884c\u662f\u7528\u5750\u6807(x, y, z)\u5b9a\u4e49\u9876\u70b9\u6cd5\u7ebf\uff08Normals\uff09\u3002\u4f8b\u5982\uff1a vn 0.71 0.21 0.82 \u3002\u4e4b\u540e\u518d\u8ba8\u8bba\u8fd9\u4e2a\u4e1c\u897f\u3002 \u4ee5\"vt\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u3002\u4f8b\u5982\uff1a vt 0.500 1 \u3002 \u4ee5\"f\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u9762\u3002\u5229\u7528\u8be5\u884c\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u6784\u9020\u7d22\u5f15\u6570\u7ec4\u3002\u6211\u4eec\u53ea\u5904\u7406\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u7684\u60c5\u51b5\u3002\u5b83\u53ef\u4ee5\u6709\u51e0\u79cd\u5b9a\u4e49\u65b9\u5f0f\uff1a \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\uff08 f v1 v2 v3 \uff09\u3002\u4f8b\u5982\uff1a f 6 3 1 \u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u8fd9\u4e2a\u4e09\u89d2\u5f62\u662f\u7531\u4f4d\u7f6e\u4e3a6\u30013\u548c1\u7684\u51e0\u4f55\u9876\u70b9\u5b9a\u4e49\u7684\uff08\u9876\u70b9\u7d22\u5f15\u603b\u662f\u4ece1\u5f00\u59cb\uff09\u3002 \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff08 f v1/t1/n1 v2/t2/n2 v3/t3/n3 \uff09\u3002\u4f8b\u5982\uff1a f 6/4/1 3/5/3 7/6/5 \u3002\u7b2c\u4e00\u90e8\u5206\u662f v1/t1/n1 \uff0c\u5176\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6cd5\u7ebf\u3002\u770b\u5230\u8be5\u90e8\u5206\u53ef\u4ee5\u8bf4\u51fa\uff1a\u9009\u62e9\u51e0\u4f55\u9876\u70b96\u3001\u7eb9\u7406\u5750\u68074\u548c\u9876\u70b9\u6cd5\u7ebf1\u3002 OBJ\u683c\u5f0f\u6709\u66f4\u591a\u7684\u5143\u7d20\u7c7b\u578b\uff08\u5982\u4e00\u7ec4\u591a\u8fb9\u5f62\u3001\u5b9a\u4e49\u6750\u8d28\u7b49\uff09\u3002\u73b0\u5728\u6211\u4eec\u4ec5\u5b9e\u73b0\u4e0a\u8ff0\u5b50\u96c6\uff0c\u6211\u4eec\u7684OBJ\u52a0\u8f7d\u5668\u5c06\u5ffd\u7565\u5176\u4ed6\u5143\u7d20\u7c7b\u578b\u3002 \u4f46\u662f\u4ec0\u4e48\u662f\u6cd5\u7ebf\u5462\uff1f\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u5b83\u3002\u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u5982\u4e0a\u6240\u89c1\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u6709\u4e24\u6761\u6cd5\u7ebf\uff0c\u6211\u4eec\u5e94\u8be5\u7528\u54ea\u4e00\u4e2a\u5462\uff1f\u4e09\u7ef4\u56fe\u5f62\u4e2d\u7684\u6cd5\u7ebf\u662f\u7528\u4e8e\u5149\u7167\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u9762\u5411\u5149\u6e90\u7684\u6cd5\u7ebf\u3002\u6362\u8a00\u4e4b\uff0c\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u6307\u5411\u6a21\u578b\u5916\u7684\u6cd5\u7ebf\u3002 \u6211\u4eec\u6709\u4e00\u4e2a\u7531\u591a\u8fb9\u5f62\u548c\u4e09\u89d2\u5f62\u7ec4\u6210\u76843D\u6a21\u578b\uff0c\u6bcf\u4e2a\u4e09\u89d2\u5f62\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\uff0c\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u5411\u91cf\u662f\u5782\u76f4\u4e8e\u4e09\u89d2\u5f62\u8868\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u9876\u70b9\u6cd5\u7ebf\u4e0e\u7279\u5b9a\u9876\u70b9\u76f8\u5173\u8054\uff0c\u5e76\u4e14\u662f\u5468\u56f4\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff08\u5f53\u7136\u5b83\u7684\u957f\u5ea6\u7b49\u4e8e1\uff09\u3002\u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u4e00\u4e2a3D\u7f51\u683c\u7684\u9876\u70b9\u6a21\u578b\uff08\u53d6\u81ea \u7ef4\u57fa\u767e\u79d1 \uff09 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u521b\u5efaOBJ\u52a0\u8f7d\u5668\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u4fee\u6539 Mesh \u7c7b\uff0c\u56e0\u4e3a\u73b0\u5728\u5fc5\u987b\u4f7f\u7528\u7eb9\u7406\u3002\u6211\u4eec\u53ef\u80fd\u52a0\u8f7d\u4e00\u4e9b\u6ca1\u6709\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u7684OBJ\u6587\u4ef6\uff0c\u56e0\u6b64\u5fc5\u987b\u80fd\u591f\u4f7f\u7528\u989c\u8272\u800c\u4e0d\u662f\u4f7f\u7528\u7eb9\u7406\u6e32\u67d3\u5b83\u4eec\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u7684\u5b9a\u4e49\u683c\u5f0f\u4e3a\uff1a f v/n \u3002 Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u540d\u4e3a colour \u7684\u65b0\u5c5e\u6027\u3002 private Vector3f colour; \u5e76\u4e14\u6784\u9020\u51fd\u6570\u4e0d\u518d\u9700\u8981 Texture \u3002\u53d6\u800c\u4ee3\u4e4b\u7684\u662f\uff0c\u6211\u4eec\u5c06\u4e3a\u7eb9\u7406\u548c\u989c\u8272\u5c5e\u6027\u63d0\u4f9b get \u548c set \u65b9\u6cd5\u3002 public Mesh(float[] positions, float[] textCoords, float[] normals, int[] indices) { \u5f53\u7136\uff0c\u5728 render \u548c clear \u65b9\u6cd5\u4e2d\uff0c\u5728\u4f7f\u7528\u7eb9\u7406\u4e4b\u524d\uff0c\u5fc5\u987b\u68c0\u67e5\u7eb9\u7406\u662f\u5426\u4e3a null \u3002\u6b63\u5982\u4f60\u5728\u6784\u9020\u51fd\u6570\u4e2d\u770b\u5230\u7684\uff0c\u73b0\u5728\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u540d\u4e3a normals \u7684\u65b0\u6d6e\u70b9\u6570\u7ec4\u3002\u5982\u4f55\u4f7f\u7528\u6cd5\u7ebf\u6e32\u67d3\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5b83\u53ea\u662fVAO\u4e2d\u7684\u53e6\u4e00\u4e2aVBO\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u5982\u4e0b\u4ee3\u7801\uff1a // \u9876\u70b9\u6cd5\u7ebfVBO vboId = glGenBuffers(); vboIdList.add(vboId); vecNormalsBuffer = MemoryUtil.memAllocFloat(normals.length); vecNormalsBuffer.put(normals).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, vecNormalsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(2); glVertexAttribPointer(2, 3, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9 Mesh \u7c7b\u7684\u4fee\u6539\uff0c\u53ef\u4ee5\u4fee\u6539\u4ee3\u7801\u6765\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6216\u56fa\u5b9a\u7684\u989c\u8272\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u50cf\u8fd9\u6837\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 colour; uniform int useColour; void main() { if ( useColour == 1 ) { fragColor = vec4(colour, 1); } else { fragColor = texture(texture_sampler, outTexCoord); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e24\u4e2a\u65b0Uniform\uff1a colour : \u5c06\u50a8\u5b58\u57fa\u672c\u989c\u8272\u3002 useColour : \u8fd9\u662f\u4e2a\u6807\u5fd7\uff0c\u5f53\u4f60\u4e0d\u60f3\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u5b83\u5c06\u88ab\u8bbe\u7f6e\u4e3a1\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u8fd9\u4e24\u4e2aUniform\u3002 // \u4e3a\u9ed8\u8ba4\u989c\u8272\u4e0e\u63a7\u5236\u5b83\u7684\u6807\u5fd7\u521b\u5efaUniform shaderProgram.createUniform(\"colour\"); shaderProgram.createUniform(\"useColour\"); \u548c\u5176\u4ed6Uniform\u4e00\u6837\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e5f\u9700\u8981\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\u3002 for(GameItem gameItem : gameItems) { Mesh mesh = gameItem.getMesh(); // \u4e3a\u8be5\u6e38\u620f\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c shaderProgram.setUniform(\"colour\", mesh.getColour()); shaderProgram.setUniform(\"useColour\", mesh.isTextured() ? 0 : 1); mesh.render(); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a OBJLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u89e3\u6790OBJ\u6587\u4ef6\uff0c\u5e76\u7528\u5176\u4e2d\u5305\u542b\u7684\u6570\u636e\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u3002\u4f60\u53ef\u80fd\u4f1a\u5728\u7f51\u4e0a\u53d1\u73b0\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\u53ef\u80fd\u6bd4\u8fd9\u66f4\u6709\u6548\uff0c\u4f46\u6211\u8ba4\u4e3a\u8be5\u65b9\u6848\u66f4\u5bb9\u6613\u7406\u89e3\u3002\u8fd9\u662f\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u5c06\u6709\u5982\u4e0b\u9759\u6001\u65b9\u6cd5\uff1a public static Mesh loadMesh(String fileName) throws Exception { \u53c2\u6570 fileName \u6307\u5b9aOBJ\u6a21\u578b\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8be5\u6587\u4ef6\u5fc5\u987b\u5305\u542b\u5728\u7c7b\u8def\u5f84\u4e2d\u3002 \u5728\u8be5\u65b9\u6cd5\u4e2d\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9\u5e76\u5c06\u6240\u6709\u884c\u50a8\u5b58\u5230\u4e00\u4e2a\u6570\u7ec4\u4e2d\uff0c\u7136\u540e\u521b\u5efa\u51e0\u4e2a\u5217\u8868\u6765\u50a8\u5b58\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u9762\u3002 List<String> lines = Utils.readAllLines(fileName); List<Vector3f> vertices = new ArrayList<>(); List<Vector2f> textures = new ArrayList<>(); List<Vector3f> normals = new ArrayList<>(); List<Face> faces = new ArrayList<>(); \u7136\u540e\u89e3\u6790\u6bcf\u4e00\u884c\uff0c\u5e76\u6839\u636e\u5f00\u5934\u6807\u8bc6\u7b26\u5f97\u5230\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u9876\u70b9\u6cd5\u7ebf\u6216\u9762\u5b9a\u4e49\uff0c\u6700\u540e\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 for (String line : lines) { String[] tokens = line.split(\"\\\\s+\"); switch (tokens[0]) { case \"v\": // \u51e0\u4f55\u9876\u70b9 Vector3f vec3f = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); vertices.add(vec3f); break; case \"vt\": // \u7eb9\u7406\u5750\u6807 Vector2f vec2f = new Vector2f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2])); textures.add(vec2f); break; case \"vn\": // \u9876\u70b9\u6cd5\u7ebf Vector3f vec3fNorm = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); normals.add(vec3fNorm); break; case \"f\": Face face = new Face(tokens[1], tokens[2], tokens[3]); faces.add(face); break; default: // \u5ffd\u7565\u5176\u4ed6\u884c break; } } return reorderLists(vertices, textures, normals, faces); \u5728\u8bb2\u89e3\u91cd\u65b0\u6392\u5e8f\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u5982\u4f55\u89e3\u6790\u9762\u7684\u5b9a\u4e49\u3002\u6211\u4eec\u5df2\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Face \u7684\u7c7b\uff0c\u5b83\u8d1f\u8d23\u89e3\u6790\u4e00\u4e2a\u9762\u7684\u5b9a\u4e49\u3002\u4e00\u4e2a Face \u662f\u7531\u4e00\u4e2a\u7d22\u5f15\u7ec4\u5217\u8868\u7ec4\u6210\u7684\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u5904\u7406\u7684\u662f\u4e09\u89d2\u5f62\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u6709\u4e09\u4e2a\u7d22\u5f15\u7ec4\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a IndexGroup \u7684\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u7d22\u5f15\u7ec4\u7684\u6570\u636e\u3002 protected static class IdxGroup { public static final int NO_VALUE = -1; public int idxPos; public int idxTextCoord; public int idxVecNormal; public IdxGroup() { idxPos = NO_VALUE; idxTextCoord = NO_VALUE; idxVecNormal = NO_VALUE; } } Face \u7c7b\u5982\u4e0b\u6240\u793a\uff1a protected static class Face { /** * \u9762\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u7ec4\u5217\u8868\uff08\u6bcf\u4e2a\u9762\u4e09\u4e2a\u9876\u70b9\uff09\u3002 */ private IdxGroup[] idxGroups = new IdxGroup[3]; public Face(String v1, String v2, String v3) { idxGroups = new IdxGroup[3]; // \u89e3\u6790\u884c idxGroups[0] = parseLine(v1); idxGroups[1] = parseLine(v2); idxGroups[2] = parseLine(v3); } private IdxGroup parseLine(String line) { IdxGroup idxGroup = new IdxGroup(); String[] lineTokens = line.split(\"/\"); int length = lineTokens.length; idxGroup.idxPos = Integer.parseInt(lineTokens[0]) - 1; if (length > 1) { // \u5982\u679cOBJ\u4e0d\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\uff0c\u5219\u53ef\u4e3anull String textCoord = lineTokens[1]; idxGroup.idxTextCoord = textCoord.length() > 0 ? Integer.parseInt(textCoord) - 1 : IdxGroup.NO_VALUE; if (length > 2) { idxGroup.idxVecNormal = Integer.parseInt(lineTokens[2]) - 1; } } return idxGroup; } public IdxGroup[] getFaceVertexIndices() { return idxGroups; } } \u5f53\u89e3\u6790\u9762\u65f6\uff0c\u6211\u4eec\u53ef\u4ee5\u770b\u5230\u6ca1\u6709\u7eb9\u7406\u4f46\u5e26\u6709\u77e2\u91cf\u6cd5\u7ebf\u7684\u5bf9\u8c61\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u5b9a\u4e49\u53ef\u80fd\u50cf f 11//1 17//1 13//1 \u8fd9\u6837\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8fd9\u4e9b\u60c5\u51b5\u3002 \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 Mesh \u7c7b\u9700\u8981\u56db\u4e2a\u6570\u7ec4\uff0c\u5206\u522b\u7528\u4e8e\u4f4d\u7f6e\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u77e2\u91cf\u548c\u7d22\u5f15\u3002\u524d\u4e09\u4e2a\u6570\u7ec4\u5e94\u8be5\u5177\u6709\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\uff0c\u56e0\u4e3a\u7d22\u5f15\u6570\u7ec4\u662f\u552f\u4e00\u7684\uff08\u6ce8\u610f\uff0c\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\u5e76\u4e0d\u610f\u5473\u7740\u76f8\u540c\u7684\u957f\u5ea6\u3002\u9876\u70b9\u5750\u6807\u662f\u4e09\u7ef4\u7684\uff0c\u7531\u4e09\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u3002\u7eb9\u7406\u5750\u6807\u662f\u4e8c\u7ef4\u7684\uff0c\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\uff09\u3002OpenGL\u4e0d\u5141\u8bb8\u6211\u4eec\u5bf9\u6bcf\u4e2a\u5143\u7d20\u7c7b\u578b\u5b9a\u4e49\u4e0d\u540c\u7684\u7d22\u5f15\u6570\u7ec4\uff08\u5982\u679c\u53ef\u4ee5\u7684\u8bdd\uff0c\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u5728\u5e94\u7528\u7eb9\u7406\u65f6\u91cd\u590d\u9876\u70b9\uff09\u3002 \u5f53\u4f60\u6253\u5f00\u4e00\u4e2aOBJ\u6587\u4ef6\u65f6\uff0c\u4f60\u9996\u5148\u53ef\u80fd\u4f1a\u770b\u5230\u50a8\u5b58\u9876\u70b9\u5750\u6807\u7684\u5217\u8868\uff0c\u6bd4\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6570\u91cf\u7684\u5217\u8868\u7684\u5143\u7d20\u6570\u91cf\u66f4\u591a\u3002\u8fd9\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u95ee\u9898\u3002\u4e3e\u4e00\u4e2a\u7b80\u5355\u7684\u4f8b\u5b50\uff0c\u5b9a\u4e49\u4e00\u4e2a\u5177\u6709\u50cf\u7d20\u9ad8\u5ea6\u7684\u6b63\u65b9\u5f62\uff08\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\uff0c\u5176OBJ\u6587\u4ef6\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff08\u4e0d\u8981\u592a\u5173\u6ce8\u6cd5\u7ebf\u5750\u6807\uff0c\u56e0\u4e3a\u5b83\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\u3002 v 0 0 0 v 1 0 0 v 1 1 0 v 0 1 0 vt 0 1 vt 1 1 vn 0 0 1 f 1/2/1 2/1/1 3/2/1 f 1/2/1 3/2/1 4/1/1 \u5f53\u5b8c\u6210\u5bf9\u6587\u4ef6\u7684\u89e3\u6790\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u5982\u4e0b\u6240\u793a\u5217\u8868\uff08\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b57\u662f\u5b83\u5728\u6587\u4ef6\u4e2d\u7684\u4f4d\u7f6e\u987a\u5e8f\uff0c\u6309\u51fa\u73b0\u987a\u5e8f\u6392\u5217\uff09\uff1a \u73b0\u5728\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u5b9a\u4e49\u6765\u521b\u5efa\u5305\u542b\u7d22\u5f15\u7684\u6700\u7ec8\u6570\u7ec4\u3002\u9700\u8981\u8003\u8651\u7684\u662f\uff0c\u7eb9\u7406\u5750\u6807\u4e0e\u6cd5\u7ebf\u5411\u91cf\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0e\u9876\u70b9\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0d\u5bf9\u5e94\u3002\u5982\u679c\u5217\u8868\u7684\u5927\u5c0f\u662f\u76f8\u540c\u7684\u5e76\u6709\u5e8f\u7684\uff0c\u90a3\u4e48\u9762\u5b9a\u4e49\u5c31\u53ea\u9700\u8981\u6bcf\u4e2a\u9876\u70b9\u4e00\u4e2a\u7d22\u5f15\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6392\u5217\u6570\u636e\uff0c\u5e76\u6839\u636e\u9700\u8981\u8fdb\u884c\u76f8\u5e94\u7684\u8bbe\u7f6e\u3002\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e09\u4e2a\u6570\u7ec4\uff08\u7528\u4e8e\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff09\u548c\u4e00\u4e2a\u7d22\u5f15\u5217\u8868\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u4e09\u4e2a\u6570\u7ec4\u5143\u7d20\u6570\u91cf\u76f8\u540c\uff08\u7b49\u4e8e\u9876\u70b9\u6570\uff09\uff0c\u9876\u70b9\u6570\u7ec4\u5c06\u662f\u9876\u70b9\u5217\u8868\u7684\u526f\u672c\u3002 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u5904\u7406\u8fd9\u4e9b\u9762\u3002\u7b2c\u4e00\u4e2a\u9762\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u7ec4\u662f1/2/1\u3002\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\uff08\u5b9a\u4e49\u51e0\u4f55\u9876\u70b9\u7684\u7d22\u5f15\uff09\u6765\u6784\u9020\u7d22\u5f15\u5217\u8868\uff0c\u79f0\u4e4b\u4e3a posIndex \u3002 \u9762\u6307\u5b9a\u6211\u4eec\u5e94\u8be5\u628a\u5360\u636e\u7b2c\u4e00\u4e2a\u4f4d\u7f6e\u7684\u5143\u7d20\u7684\u7d22\u5f15\u6dfb\u52a0\u5230\u7d22\u5f15\u5217\u8868\u4e2d\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06 posIndex \u51cf\u53bb1\u540e\u653e\u5230 indicesList \u4e2d\uff08\u5fc5\u987b\u51cf1\uff0c\u56e0\u4e3a\u6570\u7ec4\u7684\u8d77\u59cb\u662f0\uff0c\u800cOBJ\u6587\u4ef6\u683c\u5f0f\u4e2d\u8d77\u59cb\u662f1\uff09\u3002 \u7136\u540e\uff0c\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u7684\u5176\u4ed6\u7d22\u5f15\u6765\u8bbe\u7f6e texturesArray \u548c normalsArray \u3002\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u662f2\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5c06\u7b2c\u4e8c\u4e2a\u7eb9\u7406\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u7136\u540e\u6211\u4eec\u770b\u5230\u7b2c\u4e09\u4e2a\u7d22\u5f15\uff0c\u5b83\u4e3a1\uff0c\u6240\u4ee5\u8981\u505a\u7684\u662f\u5c06\u7b2c\u4e00\u4e2a\u6cd5\u7ebf\u5411\u91cf\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e00\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e8c\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u7b2c\u4e8c\u4e2a\u9762\u4e5f\u5b9a\u4e49\u4e86\u5df2\u7ecf\u88ab\u8d4b\u503c\u7684\u9876\u70b9\uff0c\u4f46\u662f\u5b83\u4eec\u6709\u76f8\u540c\u7684\u503c\uff0c\u6240\u4ee5\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u4e0a\u5f88\u7b80\u5355\u3002\u6211\u89c9\u5f97\u8fd9\u4e2a\u8fc7\u7a0b\u5df2\u7ecf\u8bb2\u89e3\u5f97\u8db3\u591f\u6e05\u6670\u4e86\uff0c\u4e0d\u8fc7\u5728\u4f60\u660e\u767d\u4e4b\u524d\u53ef\u80fd\u4f1a\u6709\u4e9b\u68d8\u624b\u3002\u91cd\u65b0\u6392\u5217\u6570\u636e\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\u3002\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u8981\u7684\u662f\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u9876\u70b9\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u7ec4\u8f6c\u6362\u4e3a\u6d6e\u70b9\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u5bf9\u4e8e\u9876\u70b9\u548c\u6cd5\u7ebf\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee53\uff0c\u800c\u5bf9\u4e8e\u7eb9\u7406\u5750\u6807\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee52\u3002 private static Mesh reorderLists(List<Vector3f> posList, List<Vector2f> textCoordList, List<Vector3f> normList, List<Face> facesList) { List<Integer> indices = new ArrayList<>(); // \u6309\u58f0\u660e\u7684\u987a\u5e8f\u521b\u5efa\u4f4d\u7f6e\u6570\u7ec4 float[] posArr = new float[posList.size() * 3]; int i = 0; for (Vector3f pos : posList) { posArr[i * 3] = pos.x; posArr[i * 3 + 1] = pos.y; posArr[i * 3 + 2] = pos.z; i++; } float[] textCoordArr = new float[posList.size() * 2]; float[] normArr = new float[posList.size() * 3]; for (Face face : facesList) { IdxGroup[] faceVertexIndices = face.getFaceVertexIndices(); for (IdxGroup indValue : faceVertexIndices) { processFaceVertex(indValue, textCoordList, normList, indices, textCoordArr, normArr); } } int[] indicesArr = new int[indices.size()]; indicesArr = indices.stream().mapToInt((Integer v) -> v).toArray(); Mesh mesh = new Mesh(posArr, textCoordArr, normArr, indicesArr); return mesh; } private static void processFaceVertex(IdxGroup indices, List<Vector2f> textCoordList, List<Vector3f> normList, List<Integer> indicesList, float[] texCoordArr, float[] normArr) { // \u8bbe\u7f6e\u9876\u70b9\u5750\u6807\u7684\u7d22\u5f15 int posIndex = indices.idxPos; indicesList.add(posIndex); // \u5bf9\u7eb9\u7406\u5750\u6807\u91cd\u65b0\u6392\u5e8f if (indices.idxTextCoord >= 0) { Vector2f textCoord = textCoordList.get(indices.idxTextCoord); texCoordArr[posIndex * 2] = textCoord.x; texCoordArr[posIndex * 2 + 1] = 1 - textCoord.y; } if (indices.idxVecNormal >= 0) { // \u5bf9\u6cd5\u7ebf\u5411\u91cf\u91cd\u65b0\u6392\u5e8f Vector3f vecNorm = normList.get(indices.idxVecNormal); normArr[posIndex * 3] = vecNorm.x; normArr[posIndex * 3 + 1] = vecNorm.y; normArr[posIndex * 3 + 2] = vecNorm.z; } } \u6b64\u5916\u9700\u8981\u6ce8\u610f\u7684\u662f\u7eb9\u7406\u5750\u6807\u662fUV\u683c\u5f0f\uff0c\u6240\u4ee5Y\u5750\u6807\u4e3a\u7528\u4e00\u51cf\u53bb\u6587\u4ef6\u4e2d\u53d6\u5230\u7684\u503c\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6e32\u67d3OBJ\u6a21\u578b\u3002\u6211\u51c6\u5907\u4e86\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u662f\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u8fc7\u7684\u5177\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u5728 DummyGame \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002 Texture texture = new Texture(\"/textures/grassblock.png\"); mesh.setTexture(texture); GameItem gameItem = new GameItem(mesh); gameItem.setScale(0.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u7136\u540e\u5c06\u4f1a\u5f97\u5230\u4e00\u4e2a\u719f\u6089\u7684\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002 \u6211\u4eec\u53ef\u4ee5\u5c1d\u8bd5\u6e32\u67d3\u5176\u4ed6\u6a21\u578b\uff0c\u4f8b\u5982\u53ef\u4ee5\u4f7f\u7528\u8457\u540d\u7684Stanford Bunny\u6a21\u578b\uff08\u5b83\u53ef\u4ee5\u514d\u8d39\u4e0b\u8f7d\uff09\uff0c\u5b83\u653e\u5728resources\u6587\u4ef6\u5939\u4e2d\u3002\u8fd9\u4e2a\u6a21\u578b\u6ca1\u6709\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u505a\uff1a Mesh mesh = OBJLoader.loadMesh(\"/models/bunny.obj\"); GameItem gameItem = new GameItem(mesh); gameItem.setScale(1.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u8fd9\u4e2a\u6a21\u578b\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u56e0\u4e3a\u6ca1\u6709\u7eb9\u7406\u4e5f\u6ca1\u6709\u5149\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u80fd\u770b\u5230\u5b83\u7684\u4f53\u79ef\uff0c\u4f46\u662f\u4f60\u53ef\u4ee5\u68c0\u67e5\u6a21\u578b\u662f\u5426\u6b63\u786e\u5730\u52a0\u8f7d\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u8bbe\u7f6eOpenGL\u53c2\u6570\u65f6\uff0c\u6dfb\u52a0\u8fd9\u4e00\u884c\u4ee3\u7801\u3002 glPolygonMode( GL_FRONT_AND_BACK, GL_LINE ); \u5f53\u4f60\u653e\u5927\u7684\u65f6\u5019\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6784\u6210\u6a21\u578b\u7684\u6240\u6709\u4e09\u89d2\u5f62\u3002 \u6709\u4e86\u8fd9\u4e2aOBJ\u8f7d\u5165\u7c7b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u4f7f\u7528Blender\u521b\u5efa\u6a21\u578b\u3002Blender\u662f\u4e00\u4e2a\u5f3a\u5927\u7684\u5de5\u5177\uff0c\u4f46\u521a\u5f00\u59cb\u4f7f\u7528\u5b83\u6709\u70b9\u56f0\u96be\uff0c\u5b83\u6709\u5f88\u591a\u9009\u9879\uff0c\u5f88\u591a\u5173\u8282\u7ec4\u5408\uff0c\u5728\u9996\u6b21\u4f7f\u7528\u5b83\u65f6\u4f60\u9700\u8981\u82b1\u65f6\u95f4\u505a\u5f88\u591a\u6700\u57fa\u672c\u7684\u4e8b\u60c5\u3002\u5f53\u4f7f\u7528Blender\u5bfc\u51fa\u6a21\u578b\u65f6\uff0c\u8bf7\u786e\u4fdd\u5305\u542b\u6cd5\u7ebf\u5e76\u5c06\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u3002 \u5bfc\u51fa\u65f6\u8bf7\u8bb0\u5f97\u5206\u5272\u8fb9\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u80fd\u5c06\u591a\u4e2a\u7eb9\u7406\u5750\u6807\u6307\u5b9a\u7ed9\u540c\u4e00\u4e2a\u9876\u70b9\u3002\u6b64\u5916\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u4e09\u89d2\u5f62\u5b9a\u4e49\u6cd5\u7ebf\uff0c\u800c\u4e0d\u662f\u6307\u5b9a\u7ed9\u9876\u70b9\u3002\u5982\u679c\u4f60\u5728\u67d0\u4e9b\u6a21\u578b\u4e2d\u9047\u5230\u4e86\u5149\u7167\u95ee\u9898\uff08\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff09\uff0c\u4f60\u5e94\u8be5\u9a8c\u8bc1\u4e00\u4e0b\u6cd5\u7ebf\u3002\u4f60\u53ef\u4ee5\u5728Blender\u4e2d\u770b\u5230\u6cd5\u7ebf\u3002","title":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b\uff08Loading more complex models\uff09"},{"location":"10-let-there-be-light/","text":"\u8981\u6709\u5149\uff08Let there be light\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4e3a3D\u6e38\u620f\u5f15\u64ce\u6dfb\u52a0\u5149\u7167\u3002\u6211\u4eec\u4e0d\u4f1a\u53bb\u5b9e\u73b0\u4e00\u4e2a\u5b8c\u7f8e\u7684\u5149\u7167\u6a21\u578b\uff0c\u56e0\u4e3a\u629b\u5f00\u590d\u6742\u6027\u4e0d\u8c08\uff0c\u5b83\u8fd8\u9700\u8981\u6d88\u8017\u5927\u91cf\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u76f8\u53cd\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u8fd1\u4f3c\u7684\u3001\u50cf\u6837\u7684\u5149\u7167\u6548\u679c\uff1a\u6211\u4eec\u5c06\u4f7f\u7528\u540d\u4e3a Phong \u7684\u7740\u8272\u7b97\u6cd5\uff08\u7531Bui Tuong Phong\u5f00\u53d1\uff09\u3002\u53e6\u4e00\u4e2a\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u5c06\u53ea\u6a21\u62df\u5149\u7167\uff0c\u4f46\u4e0d\u4f1a\u6a21\u62df\u8fd9\u4e9b\u5149\u7167\u6240\u4ea7\u751f\u7684\u9634\u5f71\uff08\u8fd9\u5c06\u5728\u540e\u7eed\u7ae0\u8282\u4e2d\u5b9e\u73b0\uff09\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5148\u5b9a\u4e49\u51e0\u4e2a\u5149\u7167\u7c7b\u578b\uff1a \u70b9\u5149\u6e90\uff08Point Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u6a21\u62df\u5149\u7167\uff0c\u6211\u4eec\u9700\u8981\u8003\u8651\u5149\u7167\u7684\u7c7b\u578b\u3001\u4f4d\u7f6e\u548c\u5176\u4ed6\u4e00\u4e9b\u53c2\u6570\uff0c\u5982\u989c\u8272\u3002\u5f53\u7136\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u8003\u8651\u7269\u4f53\u5982\u4f55\u53d7\u5149\u7167\u5f71\u54cd\u5438\u6536\u548c\u53cd\u5c04\u5149\u3002 Phong\u7740\u8272\u7b97\u6cd5\u5c06\u6a21\u62df\u5149\u7ebf\u5bf9\u6211\u4eec\u6a21\u578b\u4e2d\u6bcf\u4e2a\u70b9\u7684\u5f71\u54cd\uff0c\u5373\u5bf9\u6bcf\u4e2a\u9876\u70b9\u7684\u5f71\u54cd\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u88ab\u79f0\u4e3a\u5c40\u90e8\u5149\u7167\u6a21\u578b\u7684\u539f\u56e0\uff0c\u8fd9\u4e5f\u662f\u8be5\u7b97\u6cd5\u4e0d\u80fd\u8ba1\u7b97\u9634\u5f71\u7684\u539f\u56e0\uff1a\u5b83\u53ea\u4f1a\u8ba1\u7b97\u5e94\u7528\u5230\u6bcf\u4e2a\u9876\u70b9\u7684\u5149\u7167\uff0c\u800c\u4e0d\u8003\u8651\u9876\u70b9\u662f\u5426\u4f4d\u4e8e\u906e\u5149\u7269\u4f53\u4e4b\u540e\u3002\u6211\u4eec\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u3002\u4f46\u6b63\u56e0\u5982\u6b64\uff0c\u5b83\u662f\u4e00\u79cd\u975e\u5e38\u7b80\u5355\u5feb\u901f\u7684\u7b97\u6cd5\uff0c\u5e76\u4e14\u53ef\u4ee5\u63d0\u4f9b\u975e\u5e38\u597d\u7684\u6548\u679c\u3002\u6211\u4eec\u5c06\u5728\u6b64\u5b9e\u73b0\u4e00\u4e2a\u6ca1\u6709\u6df1\u5165\u8003\u8651\u6750\u8d28\u5f71\u54cd\u7684\u7b80\u5316\u7248\u672c\u3002 Phong\u7b97\u6cd5\u63d0\u4f9b\u4e86\u4e09\u79cd\u5149\u7167\u5206\u91cf\uff1a \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u6a21\u62df\u6765\u81ea\u4efb\u4f55\u65b9\u5411\u7684\u5149\u7167\uff0c\u5b83\u5c06\u7167\u4eae\uff08\u9700\u8981\u5bf9\u5e94\u5f3a\u5ea6\u503c\uff09\u672a\u53d7\u4efb\u4f55\u5149\u7ebf\u7167\u5c04\u7684\u533a\u57df\uff0c\u5c31\u50cf\u80cc\u666f\u5149\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09 \uff1a\u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09 \uff1a\u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 \u6700\u540e\uff0c\u6211\u4eec\u8981\u5f97\u5230\u4e00\u4e2a\u56e0\u6570\uff0c\u5c06\u5b83\u4e0e\u6307\u5b9a\u7247\u5143\u7684\u989c\u8272\u76f8\u4e58\uff0c\u6839\u636e\u5b83\u6240\u53d7\u7684\u5149\u7167\u5c06\u8be5\u989c\u8272\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u4ee4 A \u4e3a\u73af\u5883\u5149\u3001 D \u4e3a\u6f2b\u53cd\u5c04\u5149\u3001 S \u4e3a\u955c\u9762\u53cd\u5c04\u5149\uff0c\u76ee\u6807\u56e0\u6570\u5c06\u662f\u4e0a\u8ff0\u5206\u91cf\u7684\u603b\u548c\uff1a L = A + D + S \u8fd9\u4e9b\u5206\u91cf\u5176\u5b9e\u5c31\u662f\u989c\u8272\uff0c\u4e5f\u5c31\u662f\u6bcf\u4e2a\u5149\u7167\u5206\u91cf\u6240\u8d21\u732e\u7684\u989c\u8272\u5206\u91cf\u3002\u8fd9\u662f\u56e0\u4e3a\u5149\u7167\u5206\u91cf\u4e0d\u4ec5\u4f1a\u63d0\u4f9b\u4e00\u5b9a\u7a0b\u5ea6\u7684\u4eae\u5ea6\uff0c\u8fd8\u4f1a\u6539\u53d8\u6a21\u578b\u7684\u989c\u8272\u3002\u5728\u6211\u4eec\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u53ea\u9700\u5c06\u8be5\u5149\u7167\u7684\u989c\u8272\u4e0e\u539f\u59cb\u7247\u5143\u989c\u8272\uff08\u4ece\u7eb9\u7406\u6216\u57fa\u8272\u83b7\u5f97\u7684\uff09\u76f8\u4e58\u5373\u53ef\u3002 \u6211\u4eec\u8fd8\u53ef\u4ee5\u4e3a\u76f8\u540c\u7684\u6750\u8d28\u6307\u5b9a\u4e0d\u540c\u7684\u989c\u8272\uff0c\u8fd9\u4e9b\u989c\u8272\u5c06\u7528\u4e8e\u73af\u5883\u5149\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002\u56e0\u6b64\uff0c\u8fd9\u4e9b\u5206\u91cf\u5c06\u7531\u6750\u8d28\u5173\u8054\u7684\u989c\u8272\u8c03\u6574\u3002\u5982\u679c\u6750\u8d28\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u5206\u91cf\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u3002 \u6240\u4ee5\u5bf9\u4e8e\u65e0\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u73af\u5883\u5149\u7684\u989c\u8272 + D * \u6f2b\u53cd\u5c04\u7684\u989c\u8272 + S * \u955c\u9762\u53cd\u5c04\u7684\u989c\u8272 \u5bf9\u4e8e\u6709\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u7eb9\u7406\u989c\u8272 + D * \u7eb9\u7406\u989c\u8272 + S * \u7eb9\u7406\u989c\u8272 \u73af\u5883\u5149\u5206\u91cf \u8ba9\u6211\u4eec\u6765\u770b\u770b\u7b2c\u4e00\u4e2a\u5206\u91cf\uff0c\u5373\u73af\u5883\u5149\u5206\u91cf\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u5e38\u91cf\uff0c\u4f1a\u4f7f\u6211\u4eec\u7684\u6240\u6709\u7269\u4f53\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5b83\u6765\u6a21\u62df\u4e00\u5929\u4e2d\u7279\u5b9a\u65f6\u95f4\u6bb5\u5185\u7684\u5149\u7167\uff08\u9ece\u660e\u3001\u9ec4\u660f\u7b49\uff09\uff0c\u4e5f\u53ef\u4ee5\u7528\u5b83\u6765\u6dfb\u52a0\u4e00\u4e9b\u4e0d\u76f4\u63a5\u88ab\u5149\u7ebf\u7167\u5c04\u5230\uff0c\u4f46\u53ef\u4ee5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u88ab\u95f4\u63a5\u5149\u7ebf\u7167\u5c04\uff08\u6bd4\u5982\u53cd\u5c04\uff09\u5230\u7684\u70b9\u7684\u5149\u7167\u3002 \u73af\u5883\u5149\u662f\u6700\u5bb9\u6613\u8ba1\u7b97\u7684\u5206\u91cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u4e00\u79cd\u989c\u8272\uff0c\u5b83\u5c06\u4e0e\u57fa\u8272\u76f8\u4e58\uff0c\u4ee5\u8c03\u6574\u8be5\u57fa\u8272\u3002\u5047\u5982\u6211\u4eec\u5df2\u7ecf\u786e\u5b9a\u7247\u5143\u7684\u989c\u8272\u662f (1.0, 0.0, 0.0) \uff0c\u5373\u7ea2\u8272\u3002\u5982\u679c\u6ca1\u6709\u73af\u5883\u5149\u65f6\uff0c\u5b83\u5c06\u663e\u793a\u4e3a\u5b8c\u5168\u7ea2\u8272\u7684\u7247\u5143\u3002\u5982\u679c\u6211\u4eec\u5c06\u73af\u5883\u5149\u8bbe\u7f6e\u4e3a (0.5, 0.5, 0.5) \uff0c\u5219\u6700\u7ec8\u989c\u8272\u5c06\u4e3a (0.5, 0.0, 0.0) \uff0c\u5176\u5b9e\u5c31\u662f\u53d8\u6697\u7684\u7ea2\u8272\u3002\u8fd9\u79cd\u5149\u7167\u4f1a\u4ee5\u76f8\u540c\u7684\u65b9\u5f0f\u4f7f\u6240\u6709\u7247\u5143\u53d8\u6697\uff08\u79f0\u5176\u4e3a\u4f7f\u7269\u4f53\u53d8\u6697\u7684\u5149\u4f3c\u4e4e\u6709\u70b9\u5947\u602a\uff0c\u4e8b\u5b9e\u4e0a\u8fd9\u5c31\u662f\u6211\u4eec\u5f97\u5230\u7684\u6548\u679c\uff09\u3002\u6b64\u5916\uff0c\u5982\u679c\u5149\u8272\u7684RGB\u5206\u91cf\u4e0d\u76f8\u540c\uff0c\u5b83\u8fd8\u53ef\u4ee5\u4e3a\u7247\u5143\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u77e2\u91cf\u6765\u8c03\u8282\u73af\u5883\u5149\u5f3a\u5ea6\u548c\u989c\u8272\u3002 \u6f2b\u53cd\u5c04 \u73b0\u5728\u6211\u4eec\u6765\u8c08\u8c08\u6f2b\u53cd\u5c04\uff0c\u5b83\u6a21\u62df\u4e86\u8fd9\u6837\u4e00\u4e2a\u73b0\u8c61\uff1a\u4e0e\u5149\u7ebf\u5782\u76f4\u7684\u9762\u770b\u8d77\u6765\u6bd4\u4ee5\u66f4\u63a5\u8fd1\u4e0e\u5149\u7ebf\u5e73\u884c\u7684\u89d2\u5ea6\u63a5\u6536\u5149\u7ebf\u7684\u9762\u66f4\u4eae\u3002\u4e00\u4e2a\u7269\u4f53\u63a5\u6536\u5230\u7684\u5149\u8d8a\u591a\uff0c\u5176\u5149\u5bc6\u5ea6\uff08\u5728\u6b64\u8fd9\u6837\u79f0\u547c\uff09\u5c31\u8d8a\u9ad8\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\uff1f\u4f60\u8fd8\u8bb0\u5f97\u4e0a\u4e00\u7ae0\u4e2d\u6211\u4eec\u4ecb\u7ecd\u8fc7\u7684\u6cd5\u7ebf\u7684\u6982\u5ff5\u5417\uff1f\u6cd5\u7ebf\u662f\u5782\u76f4\u4e8e\u5e73\u9762\u5e76\u4e14\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002\u56e0\u6b64\uff0c\u8ba9\u6211\u4eec\u4e3a\u4e0a\u56fe\u4e2d\u7684\u4e09\u4e2a\u70b9\u7684\u7ed8\u5236\u6cd5\u7ebf\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6bcf\u4e2a\u70b9\u7684\u6cd5\u7ebf\u5c06\u662f\u5782\u76f4\u4e8e\u6bcf\u4e2a\u70b9\u7684\u5207\u5e73\u9762\u7684\u5411\u91cf\u3002\u6211\u4eec\u4e0d\u7528\u7ed8\u5236\u6765\u81ea\u5149\u6e90\u7684\u5149\u7ebf\uff0c\u800c\u662f\u7ed8\u5236\u4ece\u6bcf\u4e2a\u70b9\u5230\u5149\u6e90\uff08\u5373\u76f8\u53cd\u7684\u65b9\u5411\uff09\u7684\u5411\u91cf\u3002 \u5982\u4f60\u6240\u89c1\uff0c P1 \u70b9\u7684\u6cd5\u7ebf N1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u8be5\u6cd5\u7ebf\u7684\u65b9\u5411\u4e0e\u5149\u7ebf\u7684\u65b9\u5411\u76f8\u53cd\uff08 N1 \u5df2\u88ab\u79fb\u52a8\uff0c\u4ee5\u4fbf\u4f60\u53ef\u4ee5\u770b\u5230\u5b83\uff0c\u4f46\u8fd9\u5728\u6570\u5b66\u4e0a\u662f\u7b49\u4ef7\u7684\uff09\u3002 P1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7b49\u4e8e 0 \u3002\u56e0\u4e3a\u5b83\u7684\u5207\u5e73\u9762\u5782\u76f4\u4e8e\u5149\u6e90\uff0c\u6240\u4ee5 P1 \u5c06\u662f\u6700\u4eae\u7684\u70b9\u3002 P2 \u70b9\u7684\u6cd5\u7ebf N2 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7ea6\u4e3a30\u5ea6\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u6bd4 P1 \u66f4\u6697\u3002\u6700\u540e\uff0c P3 \u7684\u6cd5\u7ebf N3 \u4e5f\u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u4f46\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\u3002 P3 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u7684\u89d2\u5ea6\u4e3a180\u5ea6\uff0c\u6240\u4ee5\u6839\u672c\u4e0d\u5e94\u8be5\u63a5\u6536\u5230\u4efb\u4f55\u5149\u7ebf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u4f3c\u4e4e\u5f97\u5230\u4e86\u4e00\u4e2a\u8ba1\u7b97\u67d0\u70b9\u7684\u5149\u7167\u5f3a\u5ea6\u7684\u597d\u65b9\u6cd5\uff0c\u5149\u5f3a\u4e0e\u8be5\u70b9\u7684\u6cd5\u7ebf\u548c\u8be5\u70b9\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u4e4b\u95f4\u7684\u5939\u89d2\u5927\u5c0f\u6709\u5173\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u8ba1\u7b97\u5b83\u5462\uff1f \u6709\u4e00\u4e2a\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u7684\u6570\u5b66\u8fd0\u7b97\u2014\u2014\u2014\u2014\u6570\u91cf\u79ef\uff08\u53c8\u79f0\u4e3a\u70b9\u79ef\uff09\u3002\u8be5\u8fd0\u7b97\u9700\u8981\u4e24\u4e2a\u5411\u91cf\u5e76\u5f97\u5230\u4e00\u4e2a\u6570\u5b57\uff08\u6807\u91cf\uff09\uff0c\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u8f83\u5c0f\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u6b63\u6570\uff1b\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u5f88\u5927\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u8d1f\u6570\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u88ab\u5f52\u4e00\u5316\uff0c\u5373\u4e24\u8005\u7684\u957f\u5ea6\u90fd\u7b49\u4e8e1\uff0c\u90a3\u4e48\u6570\u91cf\u79ef\u7684\u7ed3\u679c\u5c06\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u540c\uff08\u5373\u5939\u89d2\u4e3a 0 \uff09\uff0c\u5219\u6570\u91cf\u79ef\u4e3a1\uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u5939\u89d2\u4e3a\u76f4\u89d2\uff0c\u5219\u5b83\u7684\u503c\u4e3a 0 \uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\uff0c\u5219\u4e3a -1 \u3002 \u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u5411\u91cf\uff0c v1 \u548c v2 \uff0c\u5e76\u4ee5 \u03b1 \u4f5c\u4e3a\u5b83\u4eec\u4e4b\u95f4\u7684\u5939\u89d2\u3002\u6570\u91cf\u79ef\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a \u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u5f52\u4e00\u5316\uff0c\u5373\u5b83\u4eec\u7684\u957f\u5ea6\uff0c\u6216\u5b83\u4eec\u7684\u6a21\u957f\u7b49\u4e8e1\uff0c\u5b83\u4eec\u7684\u6570\u91cf\u79ef\u5373\u4e3a\u5939\u89d2\u7684\u4f59\u5f26\u503c\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u8fd0\u7b97\u6765\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff0c\u8be5\u600e\u4e48\u505a\u5462\uff1f\u5047\u5982\u6211\u4eec\u6709\u6bcf\u4e2a\u70b9\u7684\u4f4d\u7f6e\uff08\u5373\u9876\u70b9\u4f4d\u7f6e\uff09\u548c\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u9996\u5148\uff0c\u8fd9\u4e24\u4e2a\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u540c\u4e00\u4e2a\u5750\u6807\u7a7a\u95f4\u4e2d\u3002\u4e3a\u4e86\u7b80\u5316\uff0c\u6211\u4eec\u5047\u8bbe\u5b83\u4eec\u90fd\u5904\u4e8e\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\uff0c\u90a3\u4e48\u8fd9\u4e9b\u4f4d\u7f6e\u662f\u6307\u5411\u9876\u70b9\u4f4d\u7f6e\uff08 VP \uff09\u548c\u5149\u6e90\uff08 VS \uff09\u7684\u5411\u91cf\u7684\u5750\u6807\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u679c\u6211\u4eec\u4ece VP \u4e2d\u51cf\u53bb VS \uff0c\u5c31\u4f1a\u5f97\u5230\u6211\u4eec\u6240\u9700\u7684\u5411\u91cf\uff0c\u79f0\u4e3a L \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u6307\u5411\u5149\u6e90\u7684\u77e2\u91cf\u548c\u6cd5\u7ebf\u4e4b\u95f4\u505a\u6570\u91cf\u79ef\uff0c\u56e0\u4e3aJohann Lambert\u662f\u7b2c\u4e00\u4e2a\u63d0\u51fa\u8fd9\u79cd\u5173\u7cfb\u6765\u6a21\u62df\u5e73\u9762\u4eae\u5ea6\u7684\uff0c\u6240\u4ee5\u8be5\u4e58\u79ef\u88ab\u79f0\u4e3a\u5170\u4f2f\u7279\u9879\u3002 \u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\uff0c\u5b9a\u4e49\u4ee5\u4e0b\u53d8\u91cf\uff1a vPos \uff1a\u6211\u4eec\u7684\u9876\u70b9\u5728\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 lPos \uff1a\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5149\u6e90\u4f4d\u7f6e\u3002 intensity \uff1a\u5149\u7684\u5f3a\u5ea6\uff08\u4ece0\u52301\uff09\u3002 lCourour \uff1a\u5149\u7684\u989c\u8272\u3002 normal \uff1a\u9876\u70b9\u6cd5\u7ebf\u3002 \u9996\u5148\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4ece\u5f53\u524d\u4f4d\u7f6e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff1a toLightDirection = lPos - vPos \uff0c\u8be5\u8fd0\u7b97\u7684\u7ed3\u679c\u9700\u8981\u5f52\u4e00\u5316\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6f2b\u53cd\u5c04\u56e0\u6570\uff08\u6807\u91cf\uff09\uff1a diffuseFactor = normal \\cdot toLightDirection \u3002\u8ba1\u7b97\u4e24\u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\uff0c\u6211\u4eec\u5e0c\u671b\u503c\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u4e24\u4e2a\u5411\u91cf\u90fd\u9700\u8981\u5f52\u4e00\u5316\u3002\u989c\u8272\u9700\u8981\u4ecb\u4e8e 0 \u5230 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u503c\u4f4e\u4e8e 0 \uff0c\u6211\u4eec\u5c06\u5176\u8bbe\u4e3a 0 \u3002 \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u901a\u8fc7\u6f2b\u53cd\u5c04\u56e0\u6570\u548c\u5149\u7684\u5f3a\u5ea6\u6765\u8c03\u8282\u5149\u7684\u989c\u8272\uff1a color = diffuseColour * lColour * diffuseFactor * intensity \u955c\u9762\u53cd\u5c04 \u73b0\u5728\u770b\u5230\u955c\u9762\u53cd\u5c04\uff0c\u4f46\u9996\u5148\u6211\u4eec\u9700\u8981\u77e5\u9053\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002\u5f53\u5149\u7167\u5c04\u5230\u4e00\u4e2a\u8868\u9762\u65f6\uff0c\u5b83\u7684\u4e00\u90e8\u5206\u88ab\u5438\u6536\uff0c\u53e6\u4e00\u90e8\u5206\u88ab\u53cd\u5c04\uff0c\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u4f60\u7684\u7269\u7406\u8bfe\u77e5\u8bc6\uff0c\u53cd\u5c04\u5c31\u662f\u5149\u4ece\u7269\u4f53\u53cd\u5f39\u56de\u6765\u3002 \u5f53\u7136\uff0c\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u629b\u5149\u7684\uff0c\u5982\u679c\u4f60\u4ed4\u7ec6\u89c2\u5bdf\uff0c\u4f60\u4f1a\u770b\u5230\u5f88\u591a\u4e0d\u5e73\u6574\u7684\u5730\u65b9\u3002\u6b64\u5916\u8fd8\u6709\u8bb8\u591a\u5149\u7ebf\uff08\u5b9e\u9645\u4e0a\u662f\u5149\u5b50\uff09\uff0c\u4f1a\u649e\u51fb\u8fd9\u4e2a\u8868\u9762\uff0c\u5e76\u4e14\u4f1a\u4ee5\u4e0d\u540c\u7684\u89d2\u5ea6\u8fdb\u884c\u53cd\u5c04\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u770b\u5230\u7684\u5c31\u50cf\u662f\u4e00\u675f\u5149\u7167\u5c04\u8868\u9762\u5e76\u6563\u5c04\u56de\u6765\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5149\u5728\u649e\u51fb\u8868\u9762\u65f6\u4f1a\u53d1\u6563\uff0c\u8fd9\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8ba8\u8bba\u8fc7\u7684\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u4f46\u662f\uff0c\u5f53\u5149\u7ebf\u7167\u5c04\u629b\u5149\u8868\u9762\u65f6\uff0c\u4f8b\u5982\u91d1\u5c5e\uff0c\u5149\u7ebf\u4f1a\u53d7\u5230\u8f83\u4f4e\u7684\u6269\u6563\u5f71\u54cd\uff0c\u5e76\u4e14\u5728\u5b83\u649e\u5230\u8868\u9762\u65f6\uff0c\u5927\u90e8\u5206\u4f1a\u5411\u53cd\u65b9\u5411\u53cd\u5c04\u3002 \u8fd9\u5c31\u662f\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u6a21\u578b\uff0c\u5b83\u53d6\u51b3\u4e8e\u6750\u8d28\u5c5e\u6027\u3002\u5bf9\u4e8e\u955c\u9762\u53cd\u5c04\uff0c\u91cd\u8981\u7684\u662f\u53ea\u6709\u5f53\u6444\u50cf\u673a\u5904\u4e8e\u6070\u5f53\u7684\u4f4d\u7f6e\u65f6\uff0c\u5373\u53cd\u5c04\u5149\u7684\u53cd\u5c04\u533a\u57df\u5185\uff0c\u53cd\u5c04\u5149\u624d\u53ef\u89c1\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u4e86\u955c\u9762\u53cd\u5c04\u4e4b\u4e2d\u7684\u673a\u7406\uff0c\u6211\u4eec\u63a5\u4e0b\u6765\u51c6\u5907\u8ba1\u7b97\u8fd9\u4e2a\u5206\u91cf\u3002\u9996\u5148\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u4ece\u5149\u6e90\u6307\u5411\u9876\u70b9\u7684\u5411\u91cf\u3002\u5f53\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65b9\u5411\u4e0e\u4e4b\u76f8\u53cd\u7684\u5411\u91cf\uff0c\u5b83\u6307\u5411\u7684\u662f\u5149\u6e90\uff0c\u5373 toLightDirection \u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u8ba1\u7b97\u4e3a fromLightDirection = -(toLightDirection) \u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8003\u8651\u5230\u8868\u9762\u7684\u6cd5\u7ebf\uff0c\u6765\u8ba1\u7b97\u7531 fromLightDirection \u5c04\u51fa\u7684\u5149\u7ebf\u649e\u51fb\u8868\u9762\u6240\u4ea7\u751f\u7684\u53cd\u5c04\u5149\u3002\u6709\u4e00\u4e2a\u540d\u4e3a reflect \u7684GLSL\u51fd\u6570\u5b9e\u73b0\u4e86\u8be5\u529f\u80fd\u3002\u6240\u4ee5\uff0c reflectLight = reflect(fromLightSource, normal) \u3002 \u6211\u4eec\u8fd8\u9700\u8981\u4e00\u4e2a\u6307\u5411\u6444\u50cf\u673a\u7684\u5411\u91cf\uff0c\u5e76\u5c06\u5176\u547d\u540d\u4e3a cameraDirection \uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u6444\u50cf\u673a\u4f4d\u7f6e\u548c\u9876\u70b9\u4f4d\u7f6e\u4e4b\u95f4\u7684\u5dee\u503c\uff1a cameraDirection = cameraPos - vPos \u3002\u6444\u50cf\u673a\u4f4d\u7f6e\u5411\u91cf\u548c\u9876\u70b9\u4f4d\u7f6e\u9700\u8981\u5904\u4e8e\u76f8\u540c\u7684\u5750\u6807\u7cfb\u4e2d\uff0c\u5e76\u4e14\u5f97\u5230\u7684\u5411\u91cf\u9700\u8981\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u6982\u8ff0\u4e86\u6211\u4eec\u76ee\u524d\u8ba1\u7b97\u7684\u4e3b\u8981\u5206\u91cf\uff1a \u73b0\u5728\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5149\u5f3a\uff0c\u5373 specularFactor \u3002\u5982\u679c cameraDirection \u548c reflectLight \u5411\u91cf\u6307\u5411\u76f8\u540c\u7684\u65b9\u5411\uff0c\u8be5\u503c\u5c31\u8d8a\u9ad8\uff0c\u5982\u679c\u5b83\u4eec\u65b9\u5411\u76f8\u53cd\u5176\u503c\u5219\u8d8a\u4f4e\u3002\u4e3a\u4e86\u8ba1\u7b97\u8be5\u503c\u6211\u4eec\u5c06\u518d\u6b21\u8fd0\u7528\u6570\u91cf\u79ef\u3002 specularFactor = cameraDirection \\cdot reflectLight \u3002\u6211\u4eec\u53ea\u5e0c\u671b\u8be5\u503c\u4f4d\u4e8e 0 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u5b83\u4f4e\u4e8e 0 \uff0c\u5c31\u5c06\u5b83\u8bbe\u4e3a0\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u8003\u8651\u5230\uff0c\u5982\u679c\u6444\u50cf\u673a\u6307\u5411\u53cd\u5c04\u5149\u9525\uff0c\u5219\u8be5\u5149\u66f4\u5f3a\u70c8\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97 specularFactor \u7684 specularPower \u6b21\u5e42\u6765\u5b9e\u73b0\uff0c\u5176\u4e2d specularPower \u4e3a\u7ed9\u5b9a\u7684\u53c2\u6570\uff1a specularFactor = specularFactor^{specularPower} \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u6750\u8d28\u7684\u53cd\u5c04\u7387\u8fdb\u884c\u5efa\u6a21\uff0c\u5982\u679c\u5149\u7ebf\u53cd\u5c04\uff0c\u53cd\u5c04\u7387\u5c06\u8c03\u8282\u53cd\u5c04\u5149\u7684\u5f3a\u5ea6\uff0c\u8fd9\u5c06\u7528\u5230\u4e00\u4e2a\u540d\u4e3a reflectance \u7684\u53c2\u6570\u3002\u6240\u4ee5\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u4e3a\uff1a specularColour * lColour * reflectance * specularFactor * intensity \u8870\u51cf \u6211\u4eec\u73b0\u5728\u77e5\u9053\u5982\u4f55\u8ba1\u7b97\u8fd9\u4e09\u4e2a\u5206\u91cf\u4e86\uff0c\u8fd9\u4e9b\u5206\u91cf\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u7528\u73af\u5883\u5149\u6a21\u62df\u70b9\u5149\u6e90\u3002\u4f46\u662f\u6211\u4eec\u7684\u5149\u7167\u6a21\u578b\u8fd8\u4e0d\u5b8c\u6574\uff0c\u56e0\u4e3a\u7269\u4f53\u53cd\u5c04\u7684\u5149\u4e0e\u5149\u6e90\u7684\u8ddd\u79bb\u65e0\u5173\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u5149\u7ebf\u8870\u51cf\u3002 \u8870\u51cf\u662f\u4e00\u4e2a\u4e0e\u8ddd\u79bb\u548c\u5149\u6709\u5173\u7684\u51fd\u6570\u3002\u5149\u7684\u5f3a\u5ea6\u4e0e\u8ddd\u79bb\u7684\u5e73\u65b9\u6210\u53cd\u6bd4\u3002\u8fd9\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u968f\u7740\u5149\u7ebf\u7684\u4f20\u64ad\uff0c\u5176\u80fd\u91cf\u6cbf\u7740\u7403\u4f53\u8868\u9762\u5206\u5e03\uff0c\u5176\u534a\u5f84\u7b49\u4e8e\u5149\u7ebf\u884c\u8fdb\u7684\u8ddd\u79bb\uff0c\u800c\u7403\u7684\u8868\u9762\u79ef\u4e0e\u5176\u534a\u5f84\u7684\u5e73\u65b9\u6210\u6b63\u6bd4\u3002\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u5f0f\u6765\u8ba1\u7b97\u8870\u51cf\u56e0\u5b50\uff1a 1.0 /(atConstant + atLineardist + atExponentdist ^ {2}) \u3002 \u4e3a\u4e86\u6a21\u62df\u8870\u51cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u8870\u51cf\u56e0\u6570\u4e58\u4ee5\u6700\u7ec8\u989c\u8272\u5373\u53ef\u3002 \u5b9e\u73b0 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u7f16\u7a0b\u5b9e\u73b0\u4e0a\u8ff0\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u4ece\u7740\u8272\u5668\u5f00\u59cb\u3002\u5927\u90e8\u5206\u5de5\u4f5c\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u4f46\u6211\u4eec\u8fd8\u9700\u8981\u5c06\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u4e00\u4e9b\u6570\u636e\u4f20\u9012\u7ed9\u5b83\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u7247\u5143\u7740\u8272\u5668\u4ec5\u63a5\u6536\u7eb9\u7406\u5750\u6807\uff0c\u73b0\u5728\u6211\u4eec\u8fd8\u5c06\u4f20\u9012\u4e24\u4e2a\u53c2\u6570\uff1a \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u5e76\u5df2\u5f52\u4e00\u5316\u7684\u9876\u70b9\u6cd5\u7ebf\u3002 \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; } \u5728\u6211\u4eec\u7ee7\u7eed\u8bb2\u89e3\u7247\u5143\u7740\u8272\u5668\u4e4b\u524d\uff0c\u5fc5\u987b\u5f3a\u8c03\u4e00\u4e2a\u975e\u5e38\u91cd\u8981\u7684\u6982\u5ff5\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u5230\uff0c mvVertexNormal \uff0c\u8be5\u53d8\u91cf\u5305\u542b\u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7684\u9876\u70b9\u6cd5\u7ebf\u3002\u8fd9\u662f\u901a\u8fc7\u5c06 vertexNormal \u4e58\u4e0a modelViewMatrix \u6765\u5b9e\u73b0\u7684\uff0c\u5c31\u50cf\u9876\u70b9\u4f4d\u7f6e\u4e00\u6837\u3002\u4f46\u6709\u4e00\u4e2a\u7ec6\u5fae\u7684\u533a\u522b\uff0c\u8be5\u9876\u70b9\u6cd5\u7ebf\u7684w\u5206\u91cf\u5728\u4e58\u4ee5\u77e9\u9635\u4e4b\u524d\u88ab\u8bbe\u7f6e\u4e3a0\uff1a vec4(vertexNormal, 0.0) \u3002\u6211\u4eec\u4e3a\u4ec0\u4e48\u8981\u8fd9\u6837\u505a\u5462?\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u6cd5\u7ebf\u88ab\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u4f46\u6211\u4eec\u4e0d\u5e0c\u671b\u5b83\u88ab\u5e73\u79fb\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u5bf9\u5b83\u7684\u65b9\u5411\u611f\u5174\u8da3\uff0c\u800c\u4e0d\u662f\u5b83\u7684\u4f4d\u7f6e\u3002\u800c\u8fd9\u662f\u901a\u8fc7\u5c06w\u5206\u91cf\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\uff0c\u8fd9\u4e5f\u662f\u662f\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u7684\u4f18\u70b9\u4e4b\u4e00\uff0c\u901a\u8fc7\u8bbe\u7f6ew\u5206\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u63a7\u5236\u5e94\u7528\u7684\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u5728\u7eb8\u4e0a\u505a\u77e9\u9635\u4e58\u6cd5\uff0c\u770b\u770b\u4e3a\u4ec0\u4e48\u662f\u8fd9\u6837\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5f00\u5de5\u4e86\uff0c\u9664\u4e86\u5c06\u6765\u81ea\u9876\u70b9\u7740\u8272\u5668\u7684\u503c\u58f0\u660e\u4e3a\u8f93\u5165\u53c2\u6570\u4e4b\u5916\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e9b\u6709\u7528\u7684\u7ed3\u6784\u4f53\u6765\u5efa\u6a21\u5149\u7167\u548c\u6750\u8d28\u5c5e\u6027\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u7528\u4e8e\u5efa\u6a21\u5149\u7684\u7ed3\u6784\u4f53\u3002 struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // \u5149\u6e90\u4f4d\u7f6e\u662f\u5728\u89c2\u5bdf\u5750\u6807\u7cfb\u4e2d\u7684 vec3 position; float intensity; Attenuation att; }; \u70b9\u5149\u6e90\u7531\u4e00\u4e2a\u989c\u8272\uff0c\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4ee5\u53ca\u4e00\u4e2a\u4ecb\u4e8e 0 \u548c 1 \u4e4b\u95f4\u7684\u6570\u5b57\uff08\u7528\u4e8e\u6a21\u62df\u5149\u7167\u5f3a\u5ea6\uff09\u548c\u4e00\u7ec4\u7528\u4e8e\u6a21\u62df\u8870\u51cf\u65b9\u7a0b\u7684\u53c2\u6570\u5b9a\u4e49\u3002 \u5efa\u6a21\u6750\u8d28\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u5982\u4e0b\uff1a struct Material { vec4 ambient; vec4 diffuse; vec4 specular; int hasTexture; float reflectance; }; \u6750\u8d28\u7531\u4e00\u7ec4\u989c\u8272\u5b9a\u4e49\uff08\u5047\u5982\u6211\u4eec\u4e0d\u4f7f\u7528\u7eb9\u7406\u4e3a\u7247\u5143\u7740\u8272\uff09\uff1a \u7528\u4e8e\u73af\u5883\u5149\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u6750\u8d28\u8fd8\u7531\u4e00\u4e2a\u6807\u5fd7\u63a7\u5236\u5b83\u662f\u5426\u62e5\u6709\u5173\u8054\u7684\u7eb9\u7406\u548c\u53cd\u5c04\u7387\u6307\u6570\u5b9a\u4e49\u3002\u6211\u4eec\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4ee5\u4e0bUniform\u3002 uniform sampler2D texture_sampler; uniform vec3 ambientLight; uniform float specularPower; uniform Material material; uniform PointLight pointLight; uniform vec3 camera_pos; \u6211\u4eec\u7528\u65b0\u5efa\u7684Uniform\u8bbe\u7f6e\u4ee5\u4e0b\u53d8\u91cf\uff1a \u73af\u5883\u5149\uff1a\u50a8\u5b58\u989c\u8272\uff0c\u4ee5\u540c\u6837\u65b9\u5f0f\u5f71\u54cd\u6bcf\u4e2a\u7247\u5143\u3002 \u955c\u9762\u53cd\u5c04\u5f3a\u5ea6\uff08\u5728\u8ba8\u8bba\u955c\u9762\u53cd\u5c04\u5149\u65f6\u7ed9\u51fa\u7684\u65b9\u7a0b\u5f0f\u4e2d\u4f7f\u7528\u7684\u6307\u6570\uff09\u3002 \u4e00\u4e2a\u70b9\u5149\u6e90\u3002 \u6750\u8d28\u5c5e\u6027\u3002 \u6444\u50cf\u673a\u5728\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 \u6211\u4eec\u8fd8\u5c06\u5b9a\u4e49\u4e00\u4e9b\u5168\u5c40\u53d8\u91cf\uff0c\u5b83\u4eec\u5c06\u50a8\u5b58\u8981\u5728\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u4e2d\u4f7f\u7528\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u53d8\u91cf\u662f\u56e0\u4e3a\u5982\u679c\u5206\u91cf\u5177\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u5c06\u5bf9\u6240\u6709\u5206\u91cf\u4f7f\u7528\u76f8\u540c\u7684\u989c\u8272\uff0c\u5e76\u4e14\u6211\u4eec\u4e0d\u5e0c\u671b\u8fdb\u884c\u5197\u4f59\u7684\u7eb9\u7406\u67e5\u627e\u3002\u8fd9\u4e9b\u53d8\u91cf\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a vec4 ambientC; vec4 diffuseC; vec4 speculrC; \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u6765\u6839\u636e\u6750\u8d28\u5c5e\u6027\u8bbe\u7f6e\u8fd9\u4e9b\u53d8\u91cf\uff1a void setupColours(Material material, vec2 textCoord) { if (material.hasTexture == 1) { ambientC = texture(texture_sampler, textCoord); diffuseC = ambientC; speculrC = ambientC; } else { ambientC = material.ambient; diffuseC = material.diffuse; speculrC = material.specular; } } \u73b0\u5728\u6211\u4eec\u8981\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u5b83\u4ee5\u70b9\u5149\u6e90\u3001\u9876\u70b9\u4f4d\u7f6e\u53ca\u5176\u6cd5\u7ebf\u4e3a\u8f93\u5165\u5e76\u8fd4\u56de\u6b64\u524d\u63cf\u8ff0\u7684\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u8ba1\u7b97\u7684\u989c\u8272\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04 vec3 light_direction = light.position - position; vec3 to_light_source = normalize(light_direction); float diffuseFactor = max(dot(normal, to_light_source ), 0.0); diffuseColour = diffuseC * vec4(light.colour, 1.0) * light.intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04 vec3 camera_direction = normalize(-position); vec3 from_light_source = -to_light_source; vec3 reflected_light = normalize(reflect(from_light_source, normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * specularFactor * material.reflectance * vec4(light.colour, 1.0); // \u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return (diffuseColour + specColour) / attenuationInv; } \u4e0a\u8ff0\u4ee3\u7801\u76f8\u5bf9\u6bd4\u8f83\u76f4\u767d\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u8ba1\u7b97\u4e86\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\uff0c\u53e6\u4e00\u4e2a\u662f\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u7684\u989c\u8272\uff0c\u5e76\u901a\u8fc7\u5149\u7ebf\u5728\u5230\u8fbe\u6211\u4eec\u6b63\u5728\u5904\u7406\u7684\u9876\u70b9\u65f6\u53d7\u5230\u7684\u8870\u51cf\u6765\u8c03\u6574\u5b83\u4eec\u3002 \u8bf7\u6ce8\u610f\uff0c\u9876\u70b9\u5750\u6807\u662f\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u7684\u3002\u5728\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u65f6\uff0c\u6211\u4eec\u5f97\u51fa\u5230\u89c2\u5bdf\u70b9\uff08\u5373\u6444\u50cf\u673a\u4f4d\u7f6e\uff09\u7684\u65b9\u5411\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a vec3 camera_direction = normalize(camera_pos - position); \u4f46\u662f\uff0c\u7531\u4e8e position \u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\uff0c\u6444\u50cf\u673a\u4f4d\u7f6e\u59cb\u7ec8\u4f4d\u4e8e\u539f\u70b9\uff0c\u5373 (0, 0, 0) \uff0c\u6240\u4ee5\u6211\u4eec\u6309\u5982\u4e0b\u4ee3\u7801\u8ba1\u7b97\u5b83\uff1a vec3 camera_direction = normalize(vec3(0, 0, 0) - position); \u53ef\u4ee5\u7b80\u5316\u4e3a\uff1a vec3 camera_direction = normalize(-position); \u6709\u4e86\u4e0a\u8ff0\u51fd\u6570\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u4e3b\u51fd\u6570\u5c31\u53d8\u5f97\u975e\u5e38\u7b80\u5355\u4e86\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u8c03\u7528 setupColours \u51fd\u6570\u5c06\u4f7f\u7528\u9002\u5f53\u7684\u989c\u8272\u6765\u8bbe\u7f6e\u53d8\u91cf ambientC \u3001 diffuseC \u548c speculrC \u3002\u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u8003\u8651\u5230\u8870\u51cf\u3002\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\uff0c\u6211\u4eec\u4f7f\u7528\u5355\u4e2a\u51fd\u6570\u8c03\u7528\u6765\u5b9e\u73b0\u6b64\u64cd\u4f5c\uff0c\u5982\u4e0a\u6240\u8ff0\u3002\u6700\u7ec8\u7684\u989c\u8272\u662f\u901a\u8fc7\u6dfb\u52a0\u73af\u5883\u5149\u5206\u91cf\u6765\u8ba1\u7b97\u7684\uff08\u5c06 ambientC \u4e58\u4ee5\u73af\u5883\u5149\uff09\u3002\u5982\u4f60\u6240\u89c1\uff0c\u73af\u5883\u5149\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002 \u5728\u7740\u8272\u5668\u4e2d\u6211\u4eec\u5f15\u5165\u4e86\u4e00\u4e9b\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u65b0\u6982\u5ff5\uff0c\u6211\u4eec\u6b63\u5728\u5b9a\u4e49\u7ed3\u6784\u4f53\u5e76\u5c06\u5b83\u4eec\u7528\u4f5cUniform\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u4f20\u9012\u8fd9\u4e9b\u7ed3\u6784\u4f53\uff1f\u9996\u5148\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e24\u4e2a\u65b0\u7c7b\uff0c\u5b83\u4eec\u5efa\u6a21\u70b9\u5149\u6e90\u548c\u6750\u8d28\u5c5e\u6027\uff0c\u540d\u4e3a PointLight \u548c Material \u3002\u5b83\u4eec\u53ea\u662f\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u4eec\u3002\u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u65b0\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u80fd\u591f\u4e3a\u70b9\u5149\u6e90\u548c\u6750\u8d28\u7ed3\u6784\u4f53\u521b\u5efaUniform\u3002 public void createPointLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".position\"); createUniform(uniformName + \".intensity\"); createUniform(uniformName + \".att.constant\"); createUniform(uniformName + \".att.linear\"); createUniform(uniformName + \".att.exponent\"); } public void createMaterialUniform(String uniformName) throws Exception { createUniform(uniformName + \".ambient\"); createUniform(uniformName + \".diffuse\"); createUniform(uniformName + \".specular\"); createUniform(uniformName + \".hasTexture\"); createUniform(uniformName + \".reflectance\"); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4e3a\u6784\u6210\u7ed3\u6784\u4f53\u7684\u6240\u6709\u5c5e\u6027\u521b\u5efa\u4e00\u4e2a\u5355\u72ec\u7684Uniform\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u5916\u4e24\u4e2a\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff0c\u5e76\u5c06 PointLight \u548c Material \u7684\u5b9e\u4f8b\u4f5c\u4e3a\u53c2\u6570\u3002 public void setUniform(String uniformName, PointLight pointLight) { setUniform(uniformName + \".colour\", pointLight.getColor() ); setUniform(uniformName + \".position\", pointLight.getPosition()); setUniform(uniformName + \".intensity\", pointLight.getIntensity()); PointLight.Attenuation att = pointLight.getAttenuation(); setUniform(uniformName + \".att.constant\", att.getConstant()); setUniform(uniformName + \".att.linear\", att.getLinear()); setUniform(uniformName + \".att.exponent\", att.getExponent()); } public void setUniform(String uniformName, Material material) { setUniform(uniformName + \".ambient\", material.getAmbientColour()); setUniform(uniformName + \".diffuse\", material.getDiffuseColour()); setUniform(uniformName + \".specular\", material.getSpecularColour()); setUniform(uniformName + \".hasTexture\", material.isTextured() ? 1 : 0); setUniform(uniformName + \".reflectance\", material.getReflectance()); } \u5728\u672c\u7ae0\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u8fd8\u5c06\u770b\u5230\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 Mesh \u7c7b\u6765\u50a8\u5b58\u6750\u8d28\u5b9e\u4f8b\uff0c\u5e76\u4e14\u521b\u5efa\u4e86\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u5728\u5176\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u53ef\u7528\u201cN\u201d\u548c\u201cM\u201d\u952e\u63a7\u5236\u79fb\u52a8\u7684\u70b9\u5149\u6e90\uff0c\u4ee5\u663e\u793a\u70b9\u5149\u6e90\u805a\u7126\u5728\u53cd\u5c04\u7387\u503c\u9ad8\u4e8e0\u7684\u7f51\u683c\u4e0a\u65f6\u662f\u600e\u6837\u7684\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u7247\u5143\u7740\u8272\u5668\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u9700\u8981\u53e6\u4e00\u4e2a\u50a8\u5b58\u6444\u50cf\u673a\u4f4d\u7f6e camera_pos \u7684Uniform\u3002\u8fd9\u4e9b\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u3002\u901a\u5e38\u6211\u4eec\u5c06\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u8bbe\u7f6e\u5149\u6e90\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u89c2\u5bdf\u77e9\u9635\uff0c\u4ee5\u4fbf\u80fd\u591f\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\uff0c\u6240\u4ee5\u9700\u8981\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u89c2\u5bdf\u77e9\u9635\u4ee5\u4fbf\u53d8\u6362\u5149\u6e90\u5750\u6807\u3002 // \u83b7\u5f97\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5b83\u7684\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLight); Vector3f lightPos = currPointLight.getPosition(); Vector4f aux = new Vector4f(lightPos, 1); aux.mul(viewMatrix); lightPos.x = aux.x; lightPos.y = aux.y; lightPos.z = aux.z; shaderProgram.setUniform(\"pointLight\", currPointLight); \u6211\u4eec\u4e0d\u4f1a\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5982\u679c\u8fd9\u6837\u8fd9\u4e00\u7ae0\u5c31\u592a\u957f\u4e86\uff0c\u4e14\u5bf9\u4e8e\u89e3\u91ca\u6e05\u695a\u6982\u5ff5\u6ca1\u6709\u592a\u591a\u7684\u5e2e\u52a9\uff0c\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6e90\u4ee3\u7801\u3002","title":"\u8981\u6709\u5149"},{"location":"10-let-there-be-light/#let-there-be-light","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4e3a3D\u6e38\u620f\u5f15\u64ce\u6dfb\u52a0\u5149\u7167\u3002\u6211\u4eec\u4e0d\u4f1a\u53bb\u5b9e\u73b0\u4e00\u4e2a\u5b8c\u7f8e\u7684\u5149\u7167\u6a21\u578b\uff0c\u56e0\u4e3a\u629b\u5f00\u590d\u6742\u6027\u4e0d\u8c08\uff0c\u5b83\u8fd8\u9700\u8981\u6d88\u8017\u5927\u91cf\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u76f8\u53cd\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u8fd1\u4f3c\u7684\u3001\u50cf\u6837\u7684\u5149\u7167\u6548\u679c\uff1a\u6211\u4eec\u5c06\u4f7f\u7528\u540d\u4e3a Phong \u7684\u7740\u8272\u7b97\u6cd5\uff08\u7531Bui Tuong Phong\u5f00\u53d1\uff09\u3002\u53e6\u4e00\u4e2a\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u5c06\u53ea\u6a21\u62df\u5149\u7167\uff0c\u4f46\u4e0d\u4f1a\u6a21\u62df\u8fd9\u4e9b\u5149\u7167\u6240\u4ea7\u751f\u7684\u9634\u5f71\uff08\u8fd9\u5c06\u5728\u540e\u7eed\u7ae0\u8282\u4e2d\u5b9e\u73b0\uff09\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5148\u5b9a\u4e49\u51e0\u4e2a\u5149\u7167\u7c7b\u578b\uff1a \u70b9\u5149\u6e90\uff08Point Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u6a21\u62df\u5149\u7167\uff0c\u6211\u4eec\u9700\u8981\u8003\u8651\u5149\u7167\u7684\u7c7b\u578b\u3001\u4f4d\u7f6e\u548c\u5176\u4ed6\u4e00\u4e9b\u53c2\u6570\uff0c\u5982\u989c\u8272\u3002\u5f53\u7136\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u8003\u8651\u7269\u4f53\u5982\u4f55\u53d7\u5149\u7167\u5f71\u54cd\u5438\u6536\u548c\u53cd\u5c04\u5149\u3002 Phong\u7740\u8272\u7b97\u6cd5\u5c06\u6a21\u62df\u5149\u7ebf\u5bf9\u6211\u4eec\u6a21\u578b\u4e2d\u6bcf\u4e2a\u70b9\u7684\u5f71\u54cd\uff0c\u5373\u5bf9\u6bcf\u4e2a\u9876\u70b9\u7684\u5f71\u54cd\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u88ab\u79f0\u4e3a\u5c40\u90e8\u5149\u7167\u6a21\u578b\u7684\u539f\u56e0\uff0c\u8fd9\u4e5f\u662f\u8be5\u7b97\u6cd5\u4e0d\u80fd\u8ba1\u7b97\u9634\u5f71\u7684\u539f\u56e0\uff1a\u5b83\u53ea\u4f1a\u8ba1\u7b97\u5e94\u7528\u5230\u6bcf\u4e2a\u9876\u70b9\u7684\u5149\u7167\uff0c\u800c\u4e0d\u8003\u8651\u9876\u70b9\u662f\u5426\u4f4d\u4e8e\u906e\u5149\u7269\u4f53\u4e4b\u540e\u3002\u6211\u4eec\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u3002\u4f46\u6b63\u56e0\u5982\u6b64\uff0c\u5b83\u662f\u4e00\u79cd\u975e\u5e38\u7b80\u5355\u5feb\u901f\u7684\u7b97\u6cd5\uff0c\u5e76\u4e14\u53ef\u4ee5\u63d0\u4f9b\u975e\u5e38\u597d\u7684\u6548\u679c\u3002\u6211\u4eec\u5c06\u5728\u6b64\u5b9e\u73b0\u4e00\u4e2a\u6ca1\u6709\u6df1\u5165\u8003\u8651\u6750\u8d28\u5f71\u54cd\u7684\u7b80\u5316\u7248\u672c\u3002 Phong\u7b97\u6cd5\u63d0\u4f9b\u4e86\u4e09\u79cd\u5149\u7167\u5206\u91cf\uff1a \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u6a21\u62df\u6765\u81ea\u4efb\u4f55\u65b9\u5411\u7684\u5149\u7167\uff0c\u5b83\u5c06\u7167\u4eae\uff08\u9700\u8981\u5bf9\u5e94\u5f3a\u5ea6\u503c\uff09\u672a\u53d7\u4efb\u4f55\u5149\u7ebf\u7167\u5c04\u7684\u533a\u57df\uff0c\u5c31\u50cf\u80cc\u666f\u5149\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09 \uff1a\u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09 \uff1a\u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 \u6700\u540e\uff0c\u6211\u4eec\u8981\u5f97\u5230\u4e00\u4e2a\u56e0\u6570\uff0c\u5c06\u5b83\u4e0e\u6307\u5b9a\u7247\u5143\u7684\u989c\u8272\u76f8\u4e58\uff0c\u6839\u636e\u5b83\u6240\u53d7\u7684\u5149\u7167\u5c06\u8be5\u989c\u8272\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u4ee4 A \u4e3a\u73af\u5883\u5149\u3001 D \u4e3a\u6f2b\u53cd\u5c04\u5149\u3001 S \u4e3a\u955c\u9762\u53cd\u5c04\u5149\uff0c\u76ee\u6807\u56e0\u6570\u5c06\u662f\u4e0a\u8ff0\u5206\u91cf\u7684\u603b\u548c\uff1a L = A + D + S \u8fd9\u4e9b\u5206\u91cf\u5176\u5b9e\u5c31\u662f\u989c\u8272\uff0c\u4e5f\u5c31\u662f\u6bcf\u4e2a\u5149\u7167\u5206\u91cf\u6240\u8d21\u732e\u7684\u989c\u8272\u5206\u91cf\u3002\u8fd9\u662f\u56e0\u4e3a\u5149\u7167\u5206\u91cf\u4e0d\u4ec5\u4f1a\u63d0\u4f9b\u4e00\u5b9a\u7a0b\u5ea6\u7684\u4eae\u5ea6\uff0c\u8fd8\u4f1a\u6539\u53d8\u6a21\u578b\u7684\u989c\u8272\u3002\u5728\u6211\u4eec\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u53ea\u9700\u5c06\u8be5\u5149\u7167\u7684\u989c\u8272\u4e0e\u539f\u59cb\u7247\u5143\u989c\u8272\uff08\u4ece\u7eb9\u7406\u6216\u57fa\u8272\u83b7\u5f97\u7684\uff09\u76f8\u4e58\u5373\u53ef\u3002 \u6211\u4eec\u8fd8\u53ef\u4ee5\u4e3a\u76f8\u540c\u7684\u6750\u8d28\u6307\u5b9a\u4e0d\u540c\u7684\u989c\u8272\uff0c\u8fd9\u4e9b\u989c\u8272\u5c06\u7528\u4e8e\u73af\u5883\u5149\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002\u56e0\u6b64\uff0c\u8fd9\u4e9b\u5206\u91cf\u5c06\u7531\u6750\u8d28\u5173\u8054\u7684\u989c\u8272\u8c03\u6574\u3002\u5982\u679c\u6750\u8d28\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u5206\u91cf\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u3002 \u6240\u4ee5\u5bf9\u4e8e\u65e0\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u73af\u5883\u5149\u7684\u989c\u8272 + D * \u6f2b\u53cd\u5c04\u7684\u989c\u8272 + S * \u955c\u9762\u53cd\u5c04\u7684\u989c\u8272 \u5bf9\u4e8e\u6709\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u7eb9\u7406\u989c\u8272 + D * \u7eb9\u7406\u989c\u8272 + S * \u7eb9\u7406\u989c\u8272","title":"\u8981\u6709\u5149\uff08Let there be light\uff09"},{"location":"10-let-there-be-light/#_1","text":"\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7b2c\u4e00\u4e2a\u5206\u91cf\uff0c\u5373\u73af\u5883\u5149\u5206\u91cf\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u5e38\u91cf\uff0c\u4f1a\u4f7f\u6211\u4eec\u7684\u6240\u6709\u7269\u4f53\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5b83\u6765\u6a21\u62df\u4e00\u5929\u4e2d\u7279\u5b9a\u65f6\u95f4\u6bb5\u5185\u7684\u5149\u7167\uff08\u9ece\u660e\u3001\u9ec4\u660f\u7b49\uff09\uff0c\u4e5f\u53ef\u4ee5\u7528\u5b83\u6765\u6dfb\u52a0\u4e00\u4e9b\u4e0d\u76f4\u63a5\u88ab\u5149\u7ebf\u7167\u5c04\u5230\uff0c\u4f46\u53ef\u4ee5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u88ab\u95f4\u63a5\u5149\u7ebf\u7167\u5c04\uff08\u6bd4\u5982\u53cd\u5c04\uff09\u5230\u7684\u70b9\u7684\u5149\u7167\u3002 \u73af\u5883\u5149\u662f\u6700\u5bb9\u6613\u8ba1\u7b97\u7684\u5206\u91cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u4e00\u79cd\u989c\u8272\uff0c\u5b83\u5c06\u4e0e\u57fa\u8272\u76f8\u4e58\uff0c\u4ee5\u8c03\u6574\u8be5\u57fa\u8272\u3002\u5047\u5982\u6211\u4eec\u5df2\u7ecf\u786e\u5b9a\u7247\u5143\u7684\u989c\u8272\u662f (1.0, 0.0, 0.0) \uff0c\u5373\u7ea2\u8272\u3002\u5982\u679c\u6ca1\u6709\u73af\u5883\u5149\u65f6\uff0c\u5b83\u5c06\u663e\u793a\u4e3a\u5b8c\u5168\u7ea2\u8272\u7684\u7247\u5143\u3002\u5982\u679c\u6211\u4eec\u5c06\u73af\u5883\u5149\u8bbe\u7f6e\u4e3a (0.5, 0.5, 0.5) \uff0c\u5219\u6700\u7ec8\u989c\u8272\u5c06\u4e3a (0.5, 0.0, 0.0) \uff0c\u5176\u5b9e\u5c31\u662f\u53d8\u6697\u7684\u7ea2\u8272\u3002\u8fd9\u79cd\u5149\u7167\u4f1a\u4ee5\u76f8\u540c\u7684\u65b9\u5f0f\u4f7f\u6240\u6709\u7247\u5143\u53d8\u6697\uff08\u79f0\u5176\u4e3a\u4f7f\u7269\u4f53\u53d8\u6697\u7684\u5149\u4f3c\u4e4e\u6709\u70b9\u5947\u602a\uff0c\u4e8b\u5b9e\u4e0a\u8fd9\u5c31\u662f\u6211\u4eec\u5f97\u5230\u7684\u6548\u679c\uff09\u3002\u6b64\u5916\uff0c\u5982\u679c\u5149\u8272\u7684RGB\u5206\u91cf\u4e0d\u76f8\u540c\uff0c\u5b83\u8fd8\u53ef\u4ee5\u4e3a\u7247\u5143\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u77e2\u91cf\u6765\u8c03\u8282\u73af\u5883\u5149\u5f3a\u5ea6\u548c\u989c\u8272\u3002","title":"\u73af\u5883\u5149\u5206\u91cf"},{"location":"10-let-there-be-light/#_2","text":"\u73b0\u5728\u6211\u4eec\u6765\u8c08\u8c08\u6f2b\u53cd\u5c04\uff0c\u5b83\u6a21\u62df\u4e86\u8fd9\u6837\u4e00\u4e2a\u73b0\u8c61\uff1a\u4e0e\u5149\u7ebf\u5782\u76f4\u7684\u9762\u770b\u8d77\u6765\u6bd4\u4ee5\u66f4\u63a5\u8fd1\u4e0e\u5149\u7ebf\u5e73\u884c\u7684\u89d2\u5ea6\u63a5\u6536\u5149\u7ebf\u7684\u9762\u66f4\u4eae\u3002\u4e00\u4e2a\u7269\u4f53\u63a5\u6536\u5230\u7684\u5149\u8d8a\u591a\uff0c\u5176\u5149\u5bc6\u5ea6\uff08\u5728\u6b64\u8fd9\u6837\u79f0\u547c\uff09\u5c31\u8d8a\u9ad8\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\uff1f\u4f60\u8fd8\u8bb0\u5f97\u4e0a\u4e00\u7ae0\u4e2d\u6211\u4eec\u4ecb\u7ecd\u8fc7\u7684\u6cd5\u7ebf\u7684\u6982\u5ff5\u5417\uff1f\u6cd5\u7ebf\u662f\u5782\u76f4\u4e8e\u5e73\u9762\u5e76\u4e14\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002\u56e0\u6b64\uff0c\u8ba9\u6211\u4eec\u4e3a\u4e0a\u56fe\u4e2d\u7684\u4e09\u4e2a\u70b9\u7684\u7ed8\u5236\u6cd5\u7ebf\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6bcf\u4e2a\u70b9\u7684\u6cd5\u7ebf\u5c06\u662f\u5782\u76f4\u4e8e\u6bcf\u4e2a\u70b9\u7684\u5207\u5e73\u9762\u7684\u5411\u91cf\u3002\u6211\u4eec\u4e0d\u7528\u7ed8\u5236\u6765\u81ea\u5149\u6e90\u7684\u5149\u7ebf\uff0c\u800c\u662f\u7ed8\u5236\u4ece\u6bcf\u4e2a\u70b9\u5230\u5149\u6e90\uff08\u5373\u76f8\u53cd\u7684\u65b9\u5411\uff09\u7684\u5411\u91cf\u3002 \u5982\u4f60\u6240\u89c1\uff0c P1 \u70b9\u7684\u6cd5\u7ebf N1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u8be5\u6cd5\u7ebf\u7684\u65b9\u5411\u4e0e\u5149\u7ebf\u7684\u65b9\u5411\u76f8\u53cd\uff08 N1 \u5df2\u88ab\u79fb\u52a8\uff0c\u4ee5\u4fbf\u4f60\u53ef\u4ee5\u770b\u5230\u5b83\uff0c\u4f46\u8fd9\u5728\u6570\u5b66\u4e0a\u662f\u7b49\u4ef7\u7684\uff09\u3002 P1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7b49\u4e8e 0 \u3002\u56e0\u4e3a\u5b83\u7684\u5207\u5e73\u9762\u5782\u76f4\u4e8e\u5149\u6e90\uff0c\u6240\u4ee5 P1 \u5c06\u662f\u6700\u4eae\u7684\u70b9\u3002 P2 \u70b9\u7684\u6cd5\u7ebf N2 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7ea6\u4e3a30\u5ea6\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u6bd4 P1 \u66f4\u6697\u3002\u6700\u540e\uff0c P3 \u7684\u6cd5\u7ebf N3 \u4e5f\u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u4f46\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\u3002 P3 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u7684\u89d2\u5ea6\u4e3a180\u5ea6\uff0c\u6240\u4ee5\u6839\u672c\u4e0d\u5e94\u8be5\u63a5\u6536\u5230\u4efb\u4f55\u5149\u7ebf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u4f3c\u4e4e\u5f97\u5230\u4e86\u4e00\u4e2a\u8ba1\u7b97\u67d0\u70b9\u7684\u5149\u7167\u5f3a\u5ea6\u7684\u597d\u65b9\u6cd5\uff0c\u5149\u5f3a\u4e0e\u8be5\u70b9\u7684\u6cd5\u7ebf\u548c\u8be5\u70b9\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u4e4b\u95f4\u7684\u5939\u89d2\u5927\u5c0f\u6709\u5173\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u8ba1\u7b97\u5b83\u5462\uff1f \u6709\u4e00\u4e2a\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u7684\u6570\u5b66\u8fd0\u7b97\u2014\u2014\u2014\u2014\u6570\u91cf\u79ef\uff08\u53c8\u79f0\u4e3a\u70b9\u79ef\uff09\u3002\u8be5\u8fd0\u7b97\u9700\u8981\u4e24\u4e2a\u5411\u91cf\u5e76\u5f97\u5230\u4e00\u4e2a\u6570\u5b57\uff08\u6807\u91cf\uff09\uff0c\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u8f83\u5c0f\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u6b63\u6570\uff1b\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u5f88\u5927\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u8d1f\u6570\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u88ab\u5f52\u4e00\u5316\uff0c\u5373\u4e24\u8005\u7684\u957f\u5ea6\u90fd\u7b49\u4e8e1\uff0c\u90a3\u4e48\u6570\u91cf\u79ef\u7684\u7ed3\u679c\u5c06\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u540c\uff08\u5373\u5939\u89d2\u4e3a 0 \uff09\uff0c\u5219\u6570\u91cf\u79ef\u4e3a1\uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u5939\u89d2\u4e3a\u76f4\u89d2\uff0c\u5219\u5b83\u7684\u503c\u4e3a 0 \uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\uff0c\u5219\u4e3a -1 \u3002 \u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u5411\u91cf\uff0c v1 \u548c v2 \uff0c\u5e76\u4ee5 \u03b1 \u4f5c\u4e3a\u5b83\u4eec\u4e4b\u95f4\u7684\u5939\u89d2\u3002\u6570\u91cf\u79ef\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a \u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u5f52\u4e00\u5316\uff0c\u5373\u5b83\u4eec\u7684\u957f\u5ea6\uff0c\u6216\u5b83\u4eec\u7684\u6a21\u957f\u7b49\u4e8e1\uff0c\u5b83\u4eec\u7684\u6570\u91cf\u79ef\u5373\u4e3a\u5939\u89d2\u7684\u4f59\u5f26\u503c\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u8fd0\u7b97\u6765\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff0c\u8be5\u600e\u4e48\u505a\u5462\uff1f\u5047\u5982\u6211\u4eec\u6709\u6bcf\u4e2a\u70b9\u7684\u4f4d\u7f6e\uff08\u5373\u9876\u70b9\u4f4d\u7f6e\uff09\u548c\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u9996\u5148\uff0c\u8fd9\u4e24\u4e2a\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u540c\u4e00\u4e2a\u5750\u6807\u7a7a\u95f4\u4e2d\u3002\u4e3a\u4e86\u7b80\u5316\uff0c\u6211\u4eec\u5047\u8bbe\u5b83\u4eec\u90fd\u5904\u4e8e\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\uff0c\u90a3\u4e48\u8fd9\u4e9b\u4f4d\u7f6e\u662f\u6307\u5411\u9876\u70b9\u4f4d\u7f6e\uff08 VP \uff09\u548c\u5149\u6e90\uff08 VS \uff09\u7684\u5411\u91cf\u7684\u5750\u6807\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u679c\u6211\u4eec\u4ece VP \u4e2d\u51cf\u53bb VS \uff0c\u5c31\u4f1a\u5f97\u5230\u6211\u4eec\u6240\u9700\u7684\u5411\u91cf\uff0c\u79f0\u4e3a L \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u6307\u5411\u5149\u6e90\u7684\u77e2\u91cf\u548c\u6cd5\u7ebf\u4e4b\u95f4\u505a\u6570\u91cf\u79ef\uff0c\u56e0\u4e3aJohann Lambert\u662f\u7b2c\u4e00\u4e2a\u63d0\u51fa\u8fd9\u79cd\u5173\u7cfb\u6765\u6a21\u62df\u5e73\u9762\u4eae\u5ea6\u7684\uff0c\u6240\u4ee5\u8be5\u4e58\u79ef\u88ab\u79f0\u4e3a\u5170\u4f2f\u7279\u9879\u3002 \u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\uff0c\u5b9a\u4e49\u4ee5\u4e0b\u53d8\u91cf\uff1a vPos \uff1a\u6211\u4eec\u7684\u9876\u70b9\u5728\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 lPos \uff1a\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5149\u6e90\u4f4d\u7f6e\u3002 intensity \uff1a\u5149\u7684\u5f3a\u5ea6\uff08\u4ece0\u52301\uff09\u3002 lCourour \uff1a\u5149\u7684\u989c\u8272\u3002 normal \uff1a\u9876\u70b9\u6cd5\u7ebf\u3002 \u9996\u5148\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4ece\u5f53\u524d\u4f4d\u7f6e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff1a toLightDirection = lPos - vPos \uff0c\u8be5\u8fd0\u7b97\u7684\u7ed3\u679c\u9700\u8981\u5f52\u4e00\u5316\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6f2b\u53cd\u5c04\u56e0\u6570\uff08\u6807\u91cf\uff09\uff1a diffuseFactor = normal \\cdot toLightDirection \u3002\u8ba1\u7b97\u4e24\u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\uff0c\u6211\u4eec\u5e0c\u671b\u503c\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u4e24\u4e2a\u5411\u91cf\u90fd\u9700\u8981\u5f52\u4e00\u5316\u3002\u989c\u8272\u9700\u8981\u4ecb\u4e8e 0 \u5230 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u503c\u4f4e\u4e8e 0 \uff0c\u6211\u4eec\u5c06\u5176\u8bbe\u4e3a 0 \u3002 \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u901a\u8fc7\u6f2b\u53cd\u5c04\u56e0\u6570\u548c\u5149\u7684\u5f3a\u5ea6\u6765\u8c03\u8282\u5149\u7684\u989c\u8272\uff1a color = diffuseColour * lColour * diffuseFactor * intensity","title":"\u6f2b\u53cd\u5c04"},{"location":"10-let-there-be-light/#_3","text":"\u73b0\u5728\u770b\u5230\u955c\u9762\u53cd\u5c04\uff0c\u4f46\u9996\u5148\u6211\u4eec\u9700\u8981\u77e5\u9053\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002\u5f53\u5149\u7167\u5c04\u5230\u4e00\u4e2a\u8868\u9762\u65f6\uff0c\u5b83\u7684\u4e00\u90e8\u5206\u88ab\u5438\u6536\uff0c\u53e6\u4e00\u90e8\u5206\u88ab\u53cd\u5c04\uff0c\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u4f60\u7684\u7269\u7406\u8bfe\u77e5\u8bc6\uff0c\u53cd\u5c04\u5c31\u662f\u5149\u4ece\u7269\u4f53\u53cd\u5f39\u56de\u6765\u3002 \u5f53\u7136\uff0c\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u629b\u5149\u7684\uff0c\u5982\u679c\u4f60\u4ed4\u7ec6\u89c2\u5bdf\uff0c\u4f60\u4f1a\u770b\u5230\u5f88\u591a\u4e0d\u5e73\u6574\u7684\u5730\u65b9\u3002\u6b64\u5916\u8fd8\u6709\u8bb8\u591a\u5149\u7ebf\uff08\u5b9e\u9645\u4e0a\u662f\u5149\u5b50\uff09\uff0c\u4f1a\u649e\u51fb\u8fd9\u4e2a\u8868\u9762\uff0c\u5e76\u4e14\u4f1a\u4ee5\u4e0d\u540c\u7684\u89d2\u5ea6\u8fdb\u884c\u53cd\u5c04\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u770b\u5230\u7684\u5c31\u50cf\u662f\u4e00\u675f\u5149\u7167\u5c04\u8868\u9762\u5e76\u6563\u5c04\u56de\u6765\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5149\u5728\u649e\u51fb\u8868\u9762\u65f6\u4f1a\u53d1\u6563\uff0c\u8fd9\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8ba8\u8bba\u8fc7\u7684\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u4f46\u662f\uff0c\u5f53\u5149\u7ebf\u7167\u5c04\u629b\u5149\u8868\u9762\u65f6\uff0c\u4f8b\u5982\u91d1\u5c5e\uff0c\u5149\u7ebf\u4f1a\u53d7\u5230\u8f83\u4f4e\u7684\u6269\u6563\u5f71\u54cd\uff0c\u5e76\u4e14\u5728\u5b83\u649e\u5230\u8868\u9762\u65f6\uff0c\u5927\u90e8\u5206\u4f1a\u5411\u53cd\u65b9\u5411\u53cd\u5c04\u3002 \u8fd9\u5c31\u662f\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u6a21\u578b\uff0c\u5b83\u53d6\u51b3\u4e8e\u6750\u8d28\u5c5e\u6027\u3002\u5bf9\u4e8e\u955c\u9762\u53cd\u5c04\uff0c\u91cd\u8981\u7684\u662f\u53ea\u6709\u5f53\u6444\u50cf\u673a\u5904\u4e8e\u6070\u5f53\u7684\u4f4d\u7f6e\u65f6\uff0c\u5373\u53cd\u5c04\u5149\u7684\u53cd\u5c04\u533a\u57df\u5185\uff0c\u53cd\u5c04\u5149\u624d\u53ef\u89c1\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u4e86\u955c\u9762\u53cd\u5c04\u4e4b\u4e2d\u7684\u673a\u7406\uff0c\u6211\u4eec\u63a5\u4e0b\u6765\u51c6\u5907\u8ba1\u7b97\u8fd9\u4e2a\u5206\u91cf\u3002\u9996\u5148\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u4ece\u5149\u6e90\u6307\u5411\u9876\u70b9\u7684\u5411\u91cf\u3002\u5f53\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65b9\u5411\u4e0e\u4e4b\u76f8\u53cd\u7684\u5411\u91cf\uff0c\u5b83\u6307\u5411\u7684\u662f\u5149\u6e90\uff0c\u5373 toLightDirection \u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u8ba1\u7b97\u4e3a fromLightDirection = -(toLightDirection) \u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8003\u8651\u5230\u8868\u9762\u7684\u6cd5\u7ebf\uff0c\u6765\u8ba1\u7b97\u7531 fromLightDirection \u5c04\u51fa\u7684\u5149\u7ebf\u649e\u51fb\u8868\u9762\u6240\u4ea7\u751f\u7684\u53cd\u5c04\u5149\u3002\u6709\u4e00\u4e2a\u540d\u4e3a reflect \u7684GLSL\u51fd\u6570\u5b9e\u73b0\u4e86\u8be5\u529f\u80fd\u3002\u6240\u4ee5\uff0c reflectLight = reflect(fromLightSource, normal) \u3002 \u6211\u4eec\u8fd8\u9700\u8981\u4e00\u4e2a\u6307\u5411\u6444\u50cf\u673a\u7684\u5411\u91cf\uff0c\u5e76\u5c06\u5176\u547d\u540d\u4e3a cameraDirection \uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u6444\u50cf\u673a\u4f4d\u7f6e\u548c\u9876\u70b9\u4f4d\u7f6e\u4e4b\u95f4\u7684\u5dee\u503c\uff1a cameraDirection = cameraPos - vPos \u3002\u6444\u50cf\u673a\u4f4d\u7f6e\u5411\u91cf\u548c\u9876\u70b9\u4f4d\u7f6e\u9700\u8981\u5904\u4e8e\u76f8\u540c\u7684\u5750\u6807\u7cfb\u4e2d\uff0c\u5e76\u4e14\u5f97\u5230\u7684\u5411\u91cf\u9700\u8981\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u6982\u8ff0\u4e86\u6211\u4eec\u76ee\u524d\u8ba1\u7b97\u7684\u4e3b\u8981\u5206\u91cf\uff1a \u73b0\u5728\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5149\u5f3a\uff0c\u5373 specularFactor \u3002\u5982\u679c cameraDirection \u548c reflectLight \u5411\u91cf\u6307\u5411\u76f8\u540c\u7684\u65b9\u5411\uff0c\u8be5\u503c\u5c31\u8d8a\u9ad8\uff0c\u5982\u679c\u5b83\u4eec\u65b9\u5411\u76f8\u53cd\u5176\u503c\u5219\u8d8a\u4f4e\u3002\u4e3a\u4e86\u8ba1\u7b97\u8be5\u503c\u6211\u4eec\u5c06\u518d\u6b21\u8fd0\u7528\u6570\u91cf\u79ef\u3002 specularFactor = cameraDirection \\cdot reflectLight \u3002\u6211\u4eec\u53ea\u5e0c\u671b\u8be5\u503c\u4f4d\u4e8e 0 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u5b83\u4f4e\u4e8e 0 \uff0c\u5c31\u5c06\u5b83\u8bbe\u4e3a0\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u8003\u8651\u5230\uff0c\u5982\u679c\u6444\u50cf\u673a\u6307\u5411\u53cd\u5c04\u5149\u9525\uff0c\u5219\u8be5\u5149\u66f4\u5f3a\u70c8\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97 specularFactor \u7684 specularPower \u6b21\u5e42\u6765\u5b9e\u73b0\uff0c\u5176\u4e2d specularPower \u4e3a\u7ed9\u5b9a\u7684\u53c2\u6570\uff1a specularFactor = specularFactor^{specularPower} \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u6750\u8d28\u7684\u53cd\u5c04\u7387\u8fdb\u884c\u5efa\u6a21\uff0c\u5982\u679c\u5149\u7ebf\u53cd\u5c04\uff0c\u53cd\u5c04\u7387\u5c06\u8c03\u8282\u53cd\u5c04\u5149\u7684\u5f3a\u5ea6\uff0c\u8fd9\u5c06\u7528\u5230\u4e00\u4e2a\u540d\u4e3a reflectance \u7684\u53c2\u6570\u3002\u6240\u4ee5\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u4e3a\uff1a specularColour * lColour * reflectance * specularFactor * intensity","title":"\u955c\u9762\u53cd\u5c04"},{"location":"10-let-there-be-light/#_4","text":"\u6211\u4eec\u73b0\u5728\u77e5\u9053\u5982\u4f55\u8ba1\u7b97\u8fd9\u4e09\u4e2a\u5206\u91cf\u4e86\uff0c\u8fd9\u4e9b\u5206\u91cf\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u7528\u73af\u5883\u5149\u6a21\u62df\u70b9\u5149\u6e90\u3002\u4f46\u662f\u6211\u4eec\u7684\u5149\u7167\u6a21\u578b\u8fd8\u4e0d\u5b8c\u6574\uff0c\u56e0\u4e3a\u7269\u4f53\u53cd\u5c04\u7684\u5149\u4e0e\u5149\u6e90\u7684\u8ddd\u79bb\u65e0\u5173\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u5149\u7ebf\u8870\u51cf\u3002 \u8870\u51cf\u662f\u4e00\u4e2a\u4e0e\u8ddd\u79bb\u548c\u5149\u6709\u5173\u7684\u51fd\u6570\u3002\u5149\u7684\u5f3a\u5ea6\u4e0e\u8ddd\u79bb\u7684\u5e73\u65b9\u6210\u53cd\u6bd4\u3002\u8fd9\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u968f\u7740\u5149\u7ebf\u7684\u4f20\u64ad\uff0c\u5176\u80fd\u91cf\u6cbf\u7740\u7403\u4f53\u8868\u9762\u5206\u5e03\uff0c\u5176\u534a\u5f84\u7b49\u4e8e\u5149\u7ebf\u884c\u8fdb\u7684\u8ddd\u79bb\uff0c\u800c\u7403\u7684\u8868\u9762\u79ef\u4e0e\u5176\u534a\u5f84\u7684\u5e73\u65b9\u6210\u6b63\u6bd4\u3002\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u5f0f\u6765\u8ba1\u7b97\u8870\u51cf\u56e0\u5b50\uff1a 1.0 /(atConstant + atLineardist + atExponentdist ^ {2}) \u3002 \u4e3a\u4e86\u6a21\u62df\u8870\u51cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u8870\u51cf\u56e0\u6570\u4e58\u4ee5\u6700\u7ec8\u989c\u8272\u5373\u53ef\u3002","title":"\u8870\u51cf"},{"location":"10-let-there-be-light/#_5","text":"\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u7f16\u7a0b\u5b9e\u73b0\u4e0a\u8ff0\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u4ece\u7740\u8272\u5668\u5f00\u59cb\u3002\u5927\u90e8\u5206\u5de5\u4f5c\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u4f46\u6211\u4eec\u8fd8\u9700\u8981\u5c06\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u4e00\u4e9b\u6570\u636e\u4f20\u9012\u7ed9\u5b83\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u7247\u5143\u7740\u8272\u5668\u4ec5\u63a5\u6536\u7eb9\u7406\u5750\u6807\uff0c\u73b0\u5728\u6211\u4eec\u8fd8\u5c06\u4f20\u9012\u4e24\u4e2a\u53c2\u6570\uff1a \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u5e76\u5df2\u5f52\u4e00\u5316\u7684\u9876\u70b9\u6cd5\u7ebf\u3002 \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; } \u5728\u6211\u4eec\u7ee7\u7eed\u8bb2\u89e3\u7247\u5143\u7740\u8272\u5668\u4e4b\u524d\uff0c\u5fc5\u987b\u5f3a\u8c03\u4e00\u4e2a\u975e\u5e38\u91cd\u8981\u7684\u6982\u5ff5\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u5230\uff0c mvVertexNormal \uff0c\u8be5\u53d8\u91cf\u5305\u542b\u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7684\u9876\u70b9\u6cd5\u7ebf\u3002\u8fd9\u662f\u901a\u8fc7\u5c06 vertexNormal \u4e58\u4e0a modelViewMatrix \u6765\u5b9e\u73b0\u7684\uff0c\u5c31\u50cf\u9876\u70b9\u4f4d\u7f6e\u4e00\u6837\u3002\u4f46\u6709\u4e00\u4e2a\u7ec6\u5fae\u7684\u533a\u522b\uff0c\u8be5\u9876\u70b9\u6cd5\u7ebf\u7684w\u5206\u91cf\u5728\u4e58\u4ee5\u77e9\u9635\u4e4b\u524d\u88ab\u8bbe\u7f6e\u4e3a0\uff1a vec4(vertexNormal, 0.0) \u3002\u6211\u4eec\u4e3a\u4ec0\u4e48\u8981\u8fd9\u6837\u505a\u5462?\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u6cd5\u7ebf\u88ab\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u4f46\u6211\u4eec\u4e0d\u5e0c\u671b\u5b83\u88ab\u5e73\u79fb\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u5bf9\u5b83\u7684\u65b9\u5411\u611f\u5174\u8da3\uff0c\u800c\u4e0d\u662f\u5b83\u7684\u4f4d\u7f6e\u3002\u800c\u8fd9\u662f\u901a\u8fc7\u5c06w\u5206\u91cf\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\uff0c\u8fd9\u4e5f\u662f\u662f\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u7684\u4f18\u70b9\u4e4b\u4e00\uff0c\u901a\u8fc7\u8bbe\u7f6ew\u5206\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u63a7\u5236\u5e94\u7528\u7684\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u5728\u7eb8\u4e0a\u505a\u77e9\u9635\u4e58\u6cd5\uff0c\u770b\u770b\u4e3a\u4ec0\u4e48\u662f\u8fd9\u6837\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5f00\u5de5\u4e86\uff0c\u9664\u4e86\u5c06\u6765\u81ea\u9876\u70b9\u7740\u8272\u5668\u7684\u503c\u58f0\u660e\u4e3a\u8f93\u5165\u53c2\u6570\u4e4b\u5916\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e9b\u6709\u7528\u7684\u7ed3\u6784\u4f53\u6765\u5efa\u6a21\u5149\u7167\u548c\u6750\u8d28\u5c5e\u6027\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u7528\u4e8e\u5efa\u6a21\u5149\u7684\u7ed3\u6784\u4f53\u3002 struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // \u5149\u6e90\u4f4d\u7f6e\u662f\u5728\u89c2\u5bdf\u5750\u6807\u7cfb\u4e2d\u7684 vec3 position; float intensity; Attenuation att; }; \u70b9\u5149\u6e90\u7531\u4e00\u4e2a\u989c\u8272\uff0c\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4ee5\u53ca\u4e00\u4e2a\u4ecb\u4e8e 0 \u548c 1 \u4e4b\u95f4\u7684\u6570\u5b57\uff08\u7528\u4e8e\u6a21\u62df\u5149\u7167\u5f3a\u5ea6\uff09\u548c\u4e00\u7ec4\u7528\u4e8e\u6a21\u62df\u8870\u51cf\u65b9\u7a0b\u7684\u53c2\u6570\u5b9a\u4e49\u3002 \u5efa\u6a21\u6750\u8d28\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u5982\u4e0b\uff1a struct Material { vec4 ambient; vec4 diffuse; vec4 specular; int hasTexture; float reflectance; }; \u6750\u8d28\u7531\u4e00\u7ec4\u989c\u8272\u5b9a\u4e49\uff08\u5047\u5982\u6211\u4eec\u4e0d\u4f7f\u7528\u7eb9\u7406\u4e3a\u7247\u5143\u7740\u8272\uff09\uff1a \u7528\u4e8e\u73af\u5883\u5149\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u6750\u8d28\u8fd8\u7531\u4e00\u4e2a\u6807\u5fd7\u63a7\u5236\u5b83\u662f\u5426\u62e5\u6709\u5173\u8054\u7684\u7eb9\u7406\u548c\u53cd\u5c04\u7387\u6307\u6570\u5b9a\u4e49\u3002\u6211\u4eec\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4ee5\u4e0bUniform\u3002 uniform sampler2D texture_sampler; uniform vec3 ambientLight; uniform float specularPower; uniform Material material; uniform PointLight pointLight; uniform vec3 camera_pos; \u6211\u4eec\u7528\u65b0\u5efa\u7684Uniform\u8bbe\u7f6e\u4ee5\u4e0b\u53d8\u91cf\uff1a \u73af\u5883\u5149\uff1a\u50a8\u5b58\u989c\u8272\uff0c\u4ee5\u540c\u6837\u65b9\u5f0f\u5f71\u54cd\u6bcf\u4e2a\u7247\u5143\u3002 \u955c\u9762\u53cd\u5c04\u5f3a\u5ea6\uff08\u5728\u8ba8\u8bba\u955c\u9762\u53cd\u5c04\u5149\u65f6\u7ed9\u51fa\u7684\u65b9\u7a0b\u5f0f\u4e2d\u4f7f\u7528\u7684\u6307\u6570\uff09\u3002 \u4e00\u4e2a\u70b9\u5149\u6e90\u3002 \u6750\u8d28\u5c5e\u6027\u3002 \u6444\u50cf\u673a\u5728\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 \u6211\u4eec\u8fd8\u5c06\u5b9a\u4e49\u4e00\u4e9b\u5168\u5c40\u53d8\u91cf\uff0c\u5b83\u4eec\u5c06\u50a8\u5b58\u8981\u5728\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u4e2d\u4f7f\u7528\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u53d8\u91cf\u662f\u56e0\u4e3a\u5982\u679c\u5206\u91cf\u5177\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u5c06\u5bf9\u6240\u6709\u5206\u91cf\u4f7f\u7528\u76f8\u540c\u7684\u989c\u8272\uff0c\u5e76\u4e14\u6211\u4eec\u4e0d\u5e0c\u671b\u8fdb\u884c\u5197\u4f59\u7684\u7eb9\u7406\u67e5\u627e\u3002\u8fd9\u4e9b\u53d8\u91cf\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a vec4 ambientC; vec4 diffuseC; vec4 speculrC; \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u6765\u6839\u636e\u6750\u8d28\u5c5e\u6027\u8bbe\u7f6e\u8fd9\u4e9b\u53d8\u91cf\uff1a void setupColours(Material material, vec2 textCoord) { if (material.hasTexture == 1) { ambientC = texture(texture_sampler, textCoord); diffuseC = ambientC; speculrC = ambientC; } else { ambientC = material.ambient; diffuseC = material.diffuse; speculrC = material.specular; } } \u73b0\u5728\u6211\u4eec\u8981\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u5b83\u4ee5\u70b9\u5149\u6e90\u3001\u9876\u70b9\u4f4d\u7f6e\u53ca\u5176\u6cd5\u7ebf\u4e3a\u8f93\u5165\u5e76\u8fd4\u56de\u6b64\u524d\u63cf\u8ff0\u7684\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u8ba1\u7b97\u7684\u989c\u8272\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04 vec3 light_direction = light.position - position; vec3 to_light_source = normalize(light_direction); float diffuseFactor = max(dot(normal, to_light_source ), 0.0); diffuseColour = diffuseC * vec4(light.colour, 1.0) * light.intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04 vec3 camera_direction = normalize(-position); vec3 from_light_source = -to_light_source; vec3 reflected_light = normalize(reflect(from_light_source, normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * specularFactor * material.reflectance * vec4(light.colour, 1.0); // \u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return (diffuseColour + specColour) / attenuationInv; } \u4e0a\u8ff0\u4ee3\u7801\u76f8\u5bf9\u6bd4\u8f83\u76f4\u767d\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u8ba1\u7b97\u4e86\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\uff0c\u53e6\u4e00\u4e2a\u662f\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u7684\u989c\u8272\uff0c\u5e76\u901a\u8fc7\u5149\u7ebf\u5728\u5230\u8fbe\u6211\u4eec\u6b63\u5728\u5904\u7406\u7684\u9876\u70b9\u65f6\u53d7\u5230\u7684\u8870\u51cf\u6765\u8c03\u6574\u5b83\u4eec\u3002 \u8bf7\u6ce8\u610f\uff0c\u9876\u70b9\u5750\u6807\u662f\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u7684\u3002\u5728\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u65f6\uff0c\u6211\u4eec\u5f97\u51fa\u5230\u89c2\u5bdf\u70b9\uff08\u5373\u6444\u50cf\u673a\u4f4d\u7f6e\uff09\u7684\u65b9\u5411\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a vec3 camera_direction = normalize(camera_pos - position); \u4f46\u662f\uff0c\u7531\u4e8e position \u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\uff0c\u6444\u50cf\u673a\u4f4d\u7f6e\u59cb\u7ec8\u4f4d\u4e8e\u539f\u70b9\uff0c\u5373 (0, 0, 0) \uff0c\u6240\u4ee5\u6211\u4eec\u6309\u5982\u4e0b\u4ee3\u7801\u8ba1\u7b97\u5b83\uff1a vec3 camera_direction = normalize(vec3(0, 0, 0) - position); \u53ef\u4ee5\u7b80\u5316\u4e3a\uff1a vec3 camera_direction = normalize(-position); \u6709\u4e86\u4e0a\u8ff0\u51fd\u6570\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u4e3b\u51fd\u6570\u5c31\u53d8\u5f97\u975e\u5e38\u7b80\u5355\u4e86\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u8c03\u7528 setupColours \u51fd\u6570\u5c06\u4f7f\u7528\u9002\u5f53\u7684\u989c\u8272\u6765\u8bbe\u7f6e\u53d8\u91cf ambientC \u3001 diffuseC \u548c speculrC \u3002\u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u8003\u8651\u5230\u8870\u51cf\u3002\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\uff0c\u6211\u4eec\u4f7f\u7528\u5355\u4e2a\u51fd\u6570\u8c03\u7528\u6765\u5b9e\u73b0\u6b64\u64cd\u4f5c\uff0c\u5982\u4e0a\u6240\u8ff0\u3002\u6700\u7ec8\u7684\u989c\u8272\u662f\u901a\u8fc7\u6dfb\u52a0\u73af\u5883\u5149\u5206\u91cf\u6765\u8ba1\u7b97\u7684\uff08\u5c06 ambientC \u4e58\u4ee5\u73af\u5883\u5149\uff09\u3002\u5982\u4f60\u6240\u89c1\uff0c\u73af\u5883\u5149\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002 \u5728\u7740\u8272\u5668\u4e2d\u6211\u4eec\u5f15\u5165\u4e86\u4e00\u4e9b\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u65b0\u6982\u5ff5\uff0c\u6211\u4eec\u6b63\u5728\u5b9a\u4e49\u7ed3\u6784\u4f53\u5e76\u5c06\u5b83\u4eec\u7528\u4f5cUniform\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u4f20\u9012\u8fd9\u4e9b\u7ed3\u6784\u4f53\uff1f\u9996\u5148\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e24\u4e2a\u65b0\u7c7b\uff0c\u5b83\u4eec\u5efa\u6a21\u70b9\u5149\u6e90\u548c\u6750\u8d28\u5c5e\u6027\uff0c\u540d\u4e3a PointLight \u548c Material \u3002\u5b83\u4eec\u53ea\u662f\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u4eec\u3002\u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u65b0\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u80fd\u591f\u4e3a\u70b9\u5149\u6e90\u548c\u6750\u8d28\u7ed3\u6784\u4f53\u521b\u5efaUniform\u3002 public void createPointLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".position\"); createUniform(uniformName + \".intensity\"); createUniform(uniformName + \".att.constant\"); createUniform(uniformName + \".att.linear\"); createUniform(uniformName + \".att.exponent\"); } public void createMaterialUniform(String uniformName) throws Exception { createUniform(uniformName + \".ambient\"); createUniform(uniformName + \".diffuse\"); createUniform(uniformName + \".specular\"); createUniform(uniformName + \".hasTexture\"); createUniform(uniformName + \".reflectance\"); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4e3a\u6784\u6210\u7ed3\u6784\u4f53\u7684\u6240\u6709\u5c5e\u6027\u521b\u5efa\u4e00\u4e2a\u5355\u72ec\u7684Uniform\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u5916\u4e24\u4e2a\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff0c\u5e76\u5c06 PointLight \u548c Material \u7684\u5b9e\u4f8b\u4f5c\u4e3a\u53c2\u6570\u3002 public void setUniform(String uniformName, PointLight pointLight) { setUniform(uniformName + \".colour\", pointLight.getColor() ); setUniform(uniformName + \".position\", pointLight.getPosition()); setUniform(uniformName + \".intensity\", pointLight.getIntensity()); PointLight.Attenuation att = pointLight.getAttenuation(); setUniform(uniformName + \".att.constant\", att.getConstant()); setUniform(uniformName + \".att.linear\", att.getLinear()); setUniform(uniformName + \".att.exponent\", att.getExponent()); } public void setUniform(String uniformName, Material material) { setUniform(uniformName + \".ambient\", material.getAmbientColour()); setUniform(uniformName + \".diffuse\", material.getDiffuseColour()); setUniform(uniformName + \".specular\", material.getSpecularColour()); setUniform(uniformName + \".hasTexture\", material.isTextured() ? 1 : 0); setUniform(uniformName + \".reflectance\", material.getReflectance()); } \u5728\u672c\u7ae0\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u8fd8\u5c06\u770b\u5230\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 Mesh \u7c7b\u6765\u50a8\u5b58\u6750\u8d28\u5b9e\u4f8b\uff0c\u5e76\u4e14\u521b\u5efa\u4e86\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u5728\u5176\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u53ef\u7528\u201cN\u201d\u548c\u201cM\u201d\u952e\u63a7\u5236\u79fb\u52a8\u7684\u70b9\u5149\u6e90\uff0c\u4ee5\u663e\u793a\u70b9\u5149\u6e90\u805a\u7126\u5728\u53cd\u5c04\u7387\u503c\u9ad8\u4e8e0\u7684\u7f51\u683c\u4e0a\u65f6\u662f\u600e\u6837\u7684\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u7247\u5143\u7740\u8272\u5668\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u9700\u8981\u53e6\u4e00\u4e2a\u50a8\u5b58\u6444\u50cf\u673a\u4f4d\u7f6e camera_pos \u7684Uniform\u3002\u8fd9\u4e9b\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u3002\u901a\u5e38\u6211\u4eec\u5c06\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u8bbe\u7f6e\u5149\u6e90\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u89c2\u5bdf\u77e9\u9635\uff0c\u4ee5\u4fbf\u80fd\u591f\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\uff0c\u6240\u4ee5\u9700\u8981\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u89c2\u5bdf\u77e9\u9635\u4ee5\u4fbf\u53d8\u6362\u5149\u6e90\u5750\u6807\u3002 // \u83b7\u5f97\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5b83\u7684\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLight); Vector3f lightPos = currPointLight.getPosition(); Vector4f aux = new Vector4f(lightPos, 1); aux.mul(viewMatrix); lightPos.x = aux.x; lightPos.y = aux.y; lightPos.z = aux.z; shaderProgram.setUniform(\"pointLight\", currPointLight); \u6211\u4eec\u4e0d\u4f1a\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5982\u679c\u8fd9\u6837\u8fd9\u4e00\u7ae0\u5c31\u592a\u957f\u4e86\uff0c\u4e14\u5bf9\u4e8e\u89e3\u91ca\u6e05\u695a\u6982\u5ff5\u6ca1\u6709\u592a\u591a\u7684\u5e2e\u52a9\uff0c\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6e90\u4ee3\u7801\u3002","title":"\u5b9e\u73b0"},{"location":"11-let-there-be-even-more-light/","text":"\u8981\u6709\u66f4\u591a\u7684\u5149\uff08Let there be even more light\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9e\u73b0\u5728\u6b64\u524d\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u3002\u6211\u4eec\u5148\u4ece\u5e73\u884c\u5149\u5f00\u59cb\u3002 \u5e73\u884c\u5149 \u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\uff0c\u5e73\u884c\u5149\u4ece\u540c\u4e00\u65b9\u5411\u7167\u5c04\u5230\u6240\u6709\u7269\u4f53\u4e0a\u3002\u5b83\u7528\u6765\u6a21\u62df\u9065\u8fdc\u4f46\u5149\u5f3a\u5f88\u9ad8\u7684\u5149\u6e90\uff0c\u6bd4\u5982\u592a\u9633\u3002 \u5e73\u884c\u5149\u7684\u53e6\u4e00\u4e2a\u7279\u70b9\u662f\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u8054\u60f3\u592a\u9633\u5149\uff0c\u6240\u6709\u88ab\u9633\u5149\u7167\u5c04\u7684\u7269\u4f53\u90fd\u4ee5\u76f8\u540c\u7684\u5149\u5f3a\u88ab\u7167\u5c04\uff0c\u56e0\u4e3a\u79bb\u592a\u9633\u7684\u8ddd\u79bb\u592a\u5927\uff0c\u4ee5\u81f3\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u76f8\u5bf9\u4f4d\u7f6e\u90fd\u662f\u65e0\u5173\u7d27\u8981\u7684\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5e73\u884c\u5149\u88ab\u6a21\u62df\u4e3a\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u7684\u5149\u6e90\uff0c\u5982\u679c\u5b83\u53d7\u5230\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u90a3\u4e48\u5b83\u5c06\u5bf9\u4efb\u4f55\u7269\u4f53\u90fd\u6ca1\u6709\u5f71\u54cd\uff08\u5b83\u5bf9\u7269\u4f53\u989c\u8272\u7684\u5f71\u54cd\u5c06\u7b49\u4e8e0\uff09\u3002 \u6b64\u5916\uff0c\u5e73\u884c\u5149\u4e5f\u7531\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7ec4\u6210\uff0c\u4e0e\u70b9\u5149\u6e90\u7684\u533a\u522b\u5728\u4e8e\u5b83\u6ca1\u6709\u4f4d\u7f6e\uff0c\u4f46\u6709\u65b9\u5411\uff0c\u5e76\u4e14\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002\u56de\u5230\u5e73\u884c\u5149\u7684\u5c5e\u6027\uff0c\u60f3\u8c61\u6211\u4eec\u6b63\u5728\u6a21\u62df\u592a\u9633\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\uff0c\u4e0b\u56fe\u5c55\u793a\u4e86\u9ece\u660e\u3001\u6b63\u5348\u548c\u9ec4\u660f\u65f6\u7684\u5149\u7ebf\u65b9\u5411\u3002 \u4e0a\u56fe\u4e2d\u7684\u5149\u7ebf\u7684\u65b9\u5411\u4e3a\uff1a \u9ece\u660e: -1, 0, 0 \u6b63\u5348: 0, 1, 0 \u9ec4\u660f: 1, 0, 0 \u6ce8\u610f\uff1a\u4f60\u53ef\u80fd\u8ba4\u4e3a\u4e0a\u8ff0\u5750\u6807\u662f\u4f4d\u7f6e\u5750\u6807\uff0c\u4f46\u5b83\u4eec\u53ea\u662f\u4e00\u4e2a\u77e2\u91cf\uff0c\u4e00\u4e2a\u65b9\u5411\uff0c\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u4ee5\u6570\u5b66\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u77e2\u91cf\u548c\u4f4d\u7f6e\u662f\u4e0d\u53ef\u5206\u8fa8\u7684\uff0c\u4f46\u5b83\u4eec\u6709\u7740\u5b8c\u5168\u4e0d\u540c\u7684\u542b\u4e49\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u6a21\u62df\u8fd9\u4e2a\u5149\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528 w \u5206\u91cf\uff0c\u5373\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u5e76\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u9ece\u660e: -1, 0, 0, 0 \u6b63\u5348: 0, 1, 0, 0 \u9ec4\u660f: 1, 0, 0, 0 \u8fd9\u5c31\u5982\u540c\u6211\u4eec\u5728\u4f20\u9012\u6cd5\u7ebf\u3002\u5bf9\u4e8e\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c06\u5176 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \uff0c\u8868\u793a\u6211\u4eec\u5bf9\u5176\u4f4d\u79fb\u4e0d\u611f\u5174\u8da3\uff0c\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u6b64\u5916\uff0c\u5f53\u6211\u4eec\u5904\u7406\u5e73\u884c\u5149\u65f6\uff0c\u4e5f\u9700\u8981\u8fd9\u6837\u505a\uff0c\u6444\u50cf\u673a\u7684\u4f4d\u79fb\u4e0d\u5e94\u5f71\u54cd\u5e73\u884c\u5149\u7684\u65b9\u5411\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5b9e\u73b0\u548c\u6a21\u62df\u5e73\u884c\u5149\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2a\u7c7b\u6765\u50a8\u5b58\u5b83\u7684\u5c5e\u6027\u3002\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u5176\u5177\u6709\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u5e76\u50a8\u5b58\u5149\u7684\u65b9\u5411\u3001\u989c\u8272\u548c\u5f3a\u5ea6\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class DirectionalLight { private Vector3f color; private Vector3f direction; private float intensity; public DirectionalLight(Vector3f color, Vector3f direction, float intensity) { this.color = color; this.direction = direction; this.intensity = intensity; } public DirectionalLight(DirectionalLight light) { this(new Vector3f(light.getColor()), new Vector3f(light.getDirection()), light.getIntensity()); } // \u63a5\u4e0b\u6765\u662fGetter\u548cSetter... \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528 Vector3f \u6765\u50a8\u5b58\u65b9\u5411\u3002\u4fdd\u6301\u51b7\u9759\uff0c\u5f53\u5c06\u5e73\u884c\u5149\u4f20\u9012\u5230\u7740\u8272\u5668\u65f6\uff0c\u6211\u4eec\u5c06\u5904\u7406 w \u5206\u91cf\u3002\u987a\u4fbf\u4e00\u63d0\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u5c31\u662f\u66f4\u65b0 ShaderProgram \u6765\u521b\u5efa\u548c\u66f4\u65b0\u50a8\u5b58\u5e73\u884c\u5149\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\u3002 struct DirectionalLight { vec3 colour; vec3 direction; float intensity; }; \u6709\u4e86\u4e0a\u8ff0\u5b9a\u4e49\uff0c ShaderProgram \u7c7b\u4e2d\u7684\u65b0\u65b9\u6cd5\u5c31\u5f88\u7b80\u5355\u4e86\u3002 // ... public void createDirectionalLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".direction\"); createUniform(uniformName + \".intensity\"); } // ... public void setUniform(String uniformName, DirectionalLight dirLight) { setUniform(uniformName + \".colour\", dirLight.getColor() ); setUniform(uniformName + \".direction\", dirLight.getDirection()); setUniform(uniformName + \".intensity\", dirLight.getIntensity()); } \u6211\u4eec\u73b0\u5728\u9700\u8981\u4f7f\u7528Uniform\uff0c\u901a\u8fc7 DummyGame \u7c7b\u63a7\u5236\u592a\u9633\u7684\u89d2\u5ea6\u6765\u6a21\u62df\u5b83\u662f\u5982\u4f55\u5728\u5929\u4e0a\u79fb\u52a8\u7684\u3002 \u6211\u4eec\u9700\u8981\u66f4\u65b0\u5149\u7684\u65b9\u5411\uff0c\u6240\u4ee5\u592a\u9633\u5728\u9ece\u660e\u65f6\uff08 -90\u00b0 \uff09\uff0c\u5149\u7ebf\u5728 (-1, 0, 0) \u65b9\u5411\u4e0a\uff0c\u5176 x \u5206\u91cf\u4ece -1 \u9010\u6e10\u589e\u52a0\u5230 0 \uff0c y \u5206\u91cf\u9010\u6e10\u4ece 0 \u589e\u52a0\u5230 1 \u3002\u63a5\u4e0b\u6765\uff0c x \u5206\u91cf\u589e\u52a0\u5230 1 \uff0c y \u5206\u91cf\u51cf\u5c11\u5230 0 \u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06 x \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u6b63\u5f26\u548c\u5c06 y \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u4f59\u5f26\u6765\u5b9e\u73b0\u3002 \u6211\u4eec\u4e5f\u4f1a\u8c03\u8282\u5149\u5f3a\uff0c\u5f53\u5b83\u8fdc\u79bb\u9ece\u660e\u65f6\u5f3a\u5ea6\u5c06\u589e\u5f3a\uff0c\u5f53\u5b83\u4e34\u8fd1\u9ec4\u660f\u65f6\u5f3a\u5ea6\u5c06\u51cf\u5f31\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u5f3a\u5ea6\u8bbe\u7f6e\u4e3a 0 \u6765\u6a21\u62df\u591c\u665a\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u8c03\u8282\u989c\u8272\uff0c\u4f7f\u5149\u5728\u9ece\u660e\u548c\u9ec4\u660f\u65f6\u53d8\u5f97\u66f4\u7ea2\u3002\u8fd9\u5c06\u5728 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u4e2d\u5b9e\u73b0\u3002 // \u66f4\u65b0\u5e73\u884c\u5149\u7684\u65b9\u5411\uff0c\u5f3a\u5ea6\u548c\u989c\u8272 lightAngle += 1.1f; if (lightAngle > 90) { directionalLight.setIntensity(0); if (lightAngle >= 360) { lightAngle = -90; } } else if (lightAngle <= -80 || lightAngle >= 80) { float factor = 1 - (float)(Math.abs(lightAngle) - 80)/ 10.0f; directionalLight.setIntensity(factor); directionalLight.getColor().y = Math.max(factor, 0.9f); directionalLight.getColor().z = Math.max(factor, 0.5f); } else { directionalLight.setIntensity(1); directionalLight.getColor().x = 1; directionalLight.getColor().y = 1; directionalLight.getColor().z = 1; } double angRad = Math.toRadians(lightAngle); directionalLight.getDirection().x = (float) Math.sin(angRad); directionalLight.getDirection().y = (float) Math.cos(angRad); \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u7684 render \u65b9\u6cd5\u4e2d\u5c06\u5e73\u884c\u5149\u4f20\u7ed9\u7740\u8272\u5668\u3002 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(directionalLight); Vector4f dir = new Vector4f(currDirLight.getDirection(), 0); dir.mul(viewMatrix); currDirLight.setDirection(new Vector3f(dir.x, dir.y, dir.z)); shaderProgram.setUniform(\"directionalLight\", currDirLight); \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u53d8\u6362\u5149\u7684\u65b9\u5411\u5230\u89c2\u5bdf\u7a7a\u95f4\uff0c\u4f46\u6211\u4eec\u4e0d\u60f3\u5e94\u7528\u4f4d\u79fb\uff0c\u6240\u4ee5\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u5728\u7247\u5143\u7740\u8272\u5668\u4e0a\u5b8c\u6210\u5269\u4e0b\u7684\u5de5\u4f5c\u4e86\uff0c\u56e0\u4e3a\u9876\u70b9\u7740\u8272\u5668\u4e0d\u9700\u8981\u4fee\u6539\u3002\u6b64\u524d\u5df2\u7ecf\u8bf4\u8fc7\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a DirectionalLight \u7684\u65b0\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\uff0c\u6240\u4ee5\u9700\u8981\u4e00\u4e2a\u65b0\u7684Uniform\u3002 uniform DirectionalLight directionalLight; \u6211\u4eec\u9700\u8981\u91cd\u6784\u4e00\u4e0b\u4ee3\u7801\uff0c\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a calcPointLight \u7684\u51fd\u6570\uff0c\u5b83\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u5e94\u7528\u8870\u51cf\u3002\u4f46\u5982\u4e0a\u6240\u8ff0\uff0c\u5e73\u884c\u5149\u4f7f\u7528\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u4f46\u4e0d\u53d7\u8870\u51cf\u5f71\u54cd\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcLightColour \u7684\u65b0\u51fd\u6570\u6765\u8ba1\u7b97\u90a3\u4e9b\u5206\u91cf\u3002 vec4 calcLightColour(vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04\u5149 float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04\u5149 vec3 camera_direction = normalize(camera_pos - position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * material.reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } \u7136\u540e\uff0c calcPointLight \u65b9\u6cd5\u5c06\u8870\u51cf\u56e0\u6570\u5e94\u7528\u5230\u4e0a\u8ff0\u51fd\u6570\u8ba1\u7b97\u7684\u7ed3\u679c\u4e0a\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(light.colour, light.intensity, position, to_light_dir, normal); // \u5e94\u7528\u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u5e73\u884c\u5149\u7684\u6548\u679c\uff0c\u5b83\u53ea\u8c03\u7528\u4ec5\u9700\u5149\u7167\u65b9\u5411\u7684 calcLightColour \u65b9\u6cd5\u3002 vec4 calcDirectionalLight(DirectionalLight light, vec3 position, vec3 normal) { return calcLightColour(light.colour, light.intensity, position, normalize(light.direction), normal); } \u6700\u540e\uff0c main \u65b9\u6cd5\u901a\u8fc7\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u7684\u989c\u8272\u5206\u91cf\u7efc\u5408\u8d77\u6765\u8ba1\u7b97\u7247\u5143\u989c\u8272\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcDirectionalLight(directionalLight, mvVertexPos, mvVertexNormal); diffuseSpecularComp += calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u5c31\u8fd9\u6837\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u6a21\u62df\u592a\u9633\u5728\u5929\u7a7a\u4e2d\u7684\u8fd0\u52a8\uff0c\u5982\u4e0b\u6240\u793a\uff08\u5728\u793a\u4f8b\u4ee3\u7801\u4e2d\u8fd0\u52a8\u901f\u5ea6\u52a0\u5feb\uff0c\u4e0d\u7528\u7b49\u5f85\u592a\u4e45\u5c31\u53ef\u4ee5\u770b\u5230\uff09\u3002 \u805a\u5149\u6e90 \u73b0\u5728\u6211\u4eec\u5c06\u5b9e\u73b0\u4e0e\u70b9\u5149\u6e90\u975e\u5e38\u76f8\u4f3c\u7684\u805a\u5149\u6e90\uff0c\u4f46\u662f\u5b83\u53d1\u5c04\u7684\u5149\u4ec5\u9650\u4e8e\u4e09\u7ef4\u5706\u9525\u4f53\u4e2d\u3002\u5b83\u6a21\u62df\u4ece\u7126\u70b9\u6216\u4efb\u4f55\u5176\u4ed6\u4e0d\u5411\u6240\u6709\u65b9\u5411\u53d1\u5c04\u5149\u7684\u5149\u6e90\u3002\u805a\u5149\u6e90\u6709\u7740\u548c\u70b9\u5149\u6e90\u4e00\u6837\u7684\u5c5e\u6027\uff0c\u4f46\u5b83\u6dfb\u52a0\u4e86\u4e24\u4e2a\u65b0\u7684\u53c2\u6570\uff0c\u5706\u9525\u89d2\u548c\u5706\u9525\u65b9\u5411\u3002 \u805a\u5149\u6e90\u4e0e\u70b9\u5149\u6e90\u7684\u8ba1\u7b97\u65b9\u6cd5\u76f8\u540c\uff0c\u4f46\u6709\u4e00\u4e9b\u4e0d\u540c\u3002\u4ece\u9876\u70b9\u4f4d\u7f6e\u5230\u5149\u6e90\u7684\u77e2\u91cf\u4e0d\u5728\u5149\u9525\u5185\u7684\u70b9\u4e0d\u53d7\u5149\u7167\u7684\u5f71\u54cd\u3002 \u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\u662f\u5426\u5728\u5149\u9525\u5185\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u548c\u5706\u9525\u65b9\u5411\u77e2\u91cf\uff08\u4e24\u8005\u90fd\u5f52\u4e00\u5316\u4e86\uff09\u4e4b\u95f4\u518d\u505a\u6b21\u6570\u91cf\u79ef\u3002 L \u548c C \u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\u7b49\u4e8e\uff1a \\vec{L}\\cdot\\vec{C}=|\\vec{L}|\\cdot|\\vec{C}|\\cdot Cos(\\alpha) \u3002\u5728\u805a\u5149\u6e90\u7684\u5b9a\u4e49\u4e2d\uff0c\u6211\u4eec\u50a8\u5b58\u9525\u89d2\u7684\u4f59\u5f26\u503c\uff0c\u5982\u679c\u6570\u91cf\u79ef\u9ad8\u4e8e\u8be5\u503c\uff0c\u6211\u4eec\u5c31\u77e5\u9053\u5b83\u4f4d\u4e8e\u5149\u9525\u5185\u90e8\uff08\u60f3\u60f3\u4f59\u5f26\u56fe\uff0c\u5f53 \u03b1 \u89d2\u4e3a 0 \u65f6\uff0c\u5176\u4f59\u5f26\u503c\u4e3a 1 \u3002\u57280\u00b0~180\u00b0\u65f6\uff0c\u89d2\u5ea6\u8d8a\u5c0f\u4f59\u5f26\u503c\u8d8a\u5927\uff09\u3002 \u7b2c\u4e8c\u4e2a\u4e0d\u540c\u4e4b\u5904\u662f\u8fdc\u79bb\u5149\u9525\u65b9\u5411\u7684\u70b9\u5c06\u53d7\u5230\u66f4\u5c11\u7684\u5149\u7167\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u8870\u51cf\u5f71\u54cd\u5c06\u66f4\u5f3a\u3002\u6709\u51e0\u79cd\u8ba1\u7b97\u65b9\u6cd5\uff0c\u6211\u4eec\u5c06\u9009\u62e9\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u5c06\u8870\u51cf\u4e0e\u4e0b\u8ff0\u516c\u5f0f\u76f8\u4e58\uff1a 1 - (1-Cos(\\alpha))/(1-Cos(cutOffAngle) (\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u6ca1\u6709\u4f20\u9012\u89d2\u5ea6\uff0c\u800c\u662f\u4f20\u9012\u89d2\u5ea6\u7684\u4f59\u5f26\u503c\u3002\u4f60\u53ef\u4ee5\u68c0\u67e5\u4e0a\u9762\u7684\u516c\u5f0f\u7684\u7ed3\u679c\u662f\u5426\u4f4d\u4e8e0\u52301\u4e4b\u95f4\uff0c\u5f53\u89d2\u5ea6\u4e3a0\u65f6\uff0c\u4f59\u5f26\u503c\u4e3a1\u3002) \u5b9e\u73b0\u975e\u5e38\u7c7b\u4f3c\u4e8e\u5176\u4ed6\u7684\u5149\u6e90\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SpotLight \u7684\u7c7b\uff0c\u8bbe\u7f6e\u9002\u5f53\u7684Uniform\uff0c\u5c06\u5176\u4f20\u9012\u7ed9\u7740\u8272\u5668\u5e76\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u4ee5\u83b7\u53d6\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u3002 \u5f53\u4f20\u9012Uniform\u65f6\uff0c\u53e6\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u662f\u4f4d\u79fb\u4e0d\u5e94\u8be5\u5e94\u7528\u5230\u5149\u9525\u65b9\u5411\u4e0a\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u56e0\u6b64\uff0c\u548c\u5e73\u884c\u5149\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u5f53\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u65f6\uff0c\u5fc5\u987b\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u591a\u5149\u6e90 \u6211\u4eec\u7ec8\u4e8e\u5b9e\u73b0\u4e86\u56db\u79cd\u7c7b\u578b\u7684\u5149\u6e90\uff0c\u4f46\u662f\u76ee\u524d\u6bcf\u79cd\u7c7b\u578b\u7684\u5149\u6e90\u53ea\u80fd\u4f7f\u7528\u4e00\u4e2a\u5b9e\u4f8b\u3002\u8fd9\u5bf9\u4e8e\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8bf4\u6ca1\u95ee\u9898\uff0c\u4f46\u662f\u6211\u4eec\u786e\u5b9e\u5e0c\u671b\u4f7f\u7528\u591a\u4e2a\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u6765\u63a5\u6536\u5149\u6e90\u5217\u8868\uff0c\u6240\u4ee5\u4f7f\u7528\u6570\u7ec4\u6765\u50a8\u5b58\u8fd9\u4e9b\u6570\u636e\u3002\u6765\u770b\u770b\u600e\u4e48\u5b9e\u73b0\u5427\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5728GLSL\u4e2d\uff0c\u6570\u7ec4\u7684\u957f\u5ea6\u5fc5\u987b\u5728\u7f16\u8bd1\u65f6\u8bbe\u7f6e\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u8db3\u591f\u5927\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u80fd\u591f\u50a8\u5b58\u6240\u9700\u7684\u6240\u6709\u5bf9\u8c61\u3002\u9996\u5148\u662f\u5b9a\u4e49\u4e00\u4e9b\u5e38\u91cf\u6765\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u6700\u5927\u70b9\u5149\u6e90\u6570\u548c\u805a\u5149\u6e90\u6570\u3002 const int MAX_POINT_LIGHTS = 5; const int MAX_SPOT_LIGHTS = 5; \u7136\u540e\u6211\u4eec\u9700\u8981\u4fee\u6539\u6b64\u524d\u53ea\u50a8\u5b58\u4e00\u4e2a\u70b9\u5149\u6e90\u548c\u4e00\u4e2a\u805a\u5149\u6e90\u7684Uniform\uff0c\u4ee5\u4fbf\u4f7f\u7528\u6570\u7ec4\u3002 uniform PointLight pointLights[MAX_POINT_LIGHTS]; uniform SpotLight spotLights[MAX_SPOT_LIGHTS]; \u5728main\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5bf9\u8fd9\u4e9b\u6570\u7ec4\u8fdb\u884c\u8fed\u4ee3\uff0c\u4ee5\u4f7f\u7528\u73b0\u6709\u51fd\u6570\u8ba1\u7b97\u6bcf\u4e2a\u5bf9\u8c61\u5bf9\u989c\u8272\u7684\u5f71\u54cd\u3002\u6211\u4eec\u53ef\u80fd\u4e0d\u4f1a\u50cfUniform\u6570\u7ec4\u957f\u5ea6\u90a3\u6837\u4f20\u9012\u5f88\u591a\u5149\u6e90\uff0c\u6240\u4ee5\u9700\u8981\u63a7\u5236\u5b83\u3002\u6709\u5f88\u591a\u53ef\u884c\u7684\u65b9\u6cd5\uff0c\u4f46\u8fd9\u53ef\u80fd\u4e0d\u9002\u7528\u4e8e\u65e7\u7684\u663e\u5361\u3002\u6700\u7ec8\u6211\u4eec\u9009\u62e9\u68c0\u67e5\u5149\u5f3a\uff08\u5728\u6570\u7ec4\u4e2d\u7684\u7a7a\u4f4d\uff0c\u5149\u5f3a\u4e3a0\uff09\u3002 for (int i=0; i<MAX_POINT_LIGHTS; i++) { if ( pointLights[i].intensity > 0 ) { diffuseSpecularComp += calcPointLight(pointLights[i], mvVertexPos, mvVertexNormal); } } for (int i=0; i<MAX_SPOT_LIGHTS; i++) { if ( spotLights[i].pl.intensity > 0 ) { diffuseSpecularComp += calcSpotLight(spotLights[i], mvVertexPos, mvVertexNormal); } } \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728 Render \u7c7b\u4e2d\u521b\u5efa\u8fd9\u4e9bUniform\u3002\u5f53\u4f7f\u7528\u6570\u7ec4\u65f6\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u5217\u8868\u4e2d\u7684\u6bcf\u4e2a\u5143\u7d20\u521b\u5efa\u4e00\u4e2aUniform\u3002\u4f8b\u5982\uff0c\u5bf9\u4e8e pointLights \u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u540d\u4e3a pointLights[0] \u3001 pointLights[1] \u4e4b\u7c7b\u7684Uniform\u3002\u5f53\u7136\uff0c\u8fd9\u4e5f\u9002\u7528\u4e8e\u7ed3\u6784\u4f53\u5c5e\u6027\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa pointLights[0].colour \u3001 pointLights[1].colour \u7b49\u7b49\u3002\u521b\u5efa\u8fd9\u4e9bUniform\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a public void createPointLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createPointLightUniform(uniformName + \"[\" + i + \"]\"); } } public void createSpotLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createSpotLightUniform(uniformName + \"[\" + i + \"]\"); } } \u6211\u4eec\u4e5f\u9700\u8981\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff1a public void setUniform(String uniformName, PointLight[] pointLights) { int numLights = pointLights != null ? pointLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, pointLights[i], i); } } public void setUniform(String uniformName, PointLight pointLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", pointLight); } public void setUniform(String uniformName, SpotLight[] spotLights) { int numLights = spotLights != null ? spotLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, spotLights[i], i); } } public void setUniform(String uniformName, SpotLight spotLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", spotLight); } \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u66f4\u65b0 Render \u7c7b\u6765\u63a5\u6536\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u5217\u8868\uff0c\u5e76\u76f8\u5e94\u5730\u4fee\u6539 DummyGame \u7c7b\u4ee5\u521b\u5efa\u8fd9\u4e9b\u5217\u8868\uff0c\u6700\u7ec8\u6548\u679c\u5982\u4e0b\u6240\u793a\u3002","title":"\u8981\u6709\u66f4\u591a\u7684\u5149"},{"location":"11-let-there-be-even-more-light/#let-there-be-even-more-light","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9e\u73b0\u5728\u6b64\u524d\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u3002\u6211\u4eec\u5148\u4ece\u5e73\u884c\u5149\u5f00\u59cb\u3002","title":"\u8981\u6709\u66f4\u591a\u7684\u5149\uff08Let there be even more light\uff09"},{"location":"11-let-there-be-even-more-light/#_1","text":"\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\uff0c\u5e73\u884c\u5149\u4ece\u540c\u4e00\u65b9\u5411\u7167\u5c04\u5230\u6240\u6709\u7269\u4f53\u4e0a\u3002\u5b83\u7528\u6765\u6a21\u62df\u9065\u8fdc\u4f46\u5149\u5f3a\u5f88\u9ad8\u7684\u5149\u6e90\uff0c\u6bd4\u5982\u592a\u9633\u3002 \u5e73\u884c\u5149\u7684\u53e6\u4e00\u4e2a\u7279\u70b9\u662f\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u8054\u60f3\u592a\u9633\u5149\uff0c\u6240\u6709\u88ab\u9633\u5149\u7167\u5c04\u7684\u7269\u4f53\u90fd\u4ee5\u76f8\u540c\u7684\u5149\u5f3a\u88ab\u7167\u5c04\uff0c\u56e0\u4e3a\u79bb\u592a\u9633\u7684\u8ddd\u79bb\u592a\u5927\uff0c\u4ee5\u81f3\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u76f8\u5bf9\u4f4d\u7f6e\u90fd\u662f\u65e0\u5173\u7d27\u8981\u7684\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5e73\u884c\u5149\u88ab\u6a21\u62df\u4e3a\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u7684\u5149\u6e90\uff0c\u5982\u679c\u5b83\u53d7\u5230\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u90a3\u4e48\u5b83\u5c06\u5bf9\u4efb\u4f55\u7269\u4f53\u90fd\u6ca1\u6709\u5f71\u54cd\uff08\u5b83\u5bf9\u7269\u4f53\u989c\u8272\u7684\u5f71\u54cd\u5c06\u7b49\u4e8e0\uff09\u3002 \u6b64\u5916\uff0c\u5e73\u884c\u5149\u4e5f\u7531\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7ec4\u6210\uff0c\u4e0e\u70b9\u5149\u6e90\u7684\u533a\u522b\u5728\u4e8e\u5b83\u6ca1\u6709\u4f4d\u7f6e\uff0c\u4f46\u6709\u65b9\u5411\uff0c\u5e76\u4e14\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002\u56de\u5230\u5e73\u884c\u5149\u7684\u5c5e\u6027\uff0c\u60f3\u8c61\u6211\u4eec\u6b63\u5728\u6a21\u62df\u592a\u9633\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\uff0c\u4e0b\u56fe\u5c55\u793a\u4e86\u9ece\u660e\u3001\u6b63\u5348\u548c\u9ec4\u660f\u65f6\u7684\u5149\u7ebf\u65b9\u5411\u3002 \u4e0a\u56fe\u4e2d\u7684\u5149\u7ebf\u7684\u65b9\u5411\u4e3a\uff1a \u9ece\u660e: -1, 0, 0 \u6b63\u5348: 0, 1, 0 \u9ec4\u660f: 1, 0, 0 \u6ce8\u610f\uff1a\u4f60\u53ef\u80fd\u8ba4\u4e3a\u4e0a\u8ff0\u5750\u6807\u662f\u4f4d\u7f6e\u5750\u6807\uff0c\u4f46\u5b83\u4eec\u53ea\u662f\u4e00\u4e2a\u77e2\u91cf\uff0c\u4e00\u4e2a\u65b9\u5411\uff0c\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u4ee5\u6570\u5b66\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u77e2\u91cf\u548c\u4f4d\u7f6e\u662f\u4e0d\u53ef\u5206\u8fa8\u7684\uff0c\u4f46\u5b83\u4eec\u6709\u7740\u5b8c\u5168\u4e0d\u540c\u7684\u542b\u4e49\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u6a21\u62df\u8fd9\u4e2a\u5149\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528 w \u5206\u91cf\uff0c\u5373\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u5e76\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u9ece\u660e: -1, 0, 0, 0 \u6b63\u5348: 0, 1, 0, 0 \u9ec4\u660f: 1, 0, 0, 0 \u8fd9\u5c31\u5982\u540c\u6211\u4eec\u5728\u4f20\u9012\u6cd5\u7ebf\u3002\u5bf9\u4e8e\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c06\u5176 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \uff0c\u8868\u793a\u6211\u4eec\u5bf9\u5176\u4f4d\u79fb\u4e0d\u611f\u5174\u8da3\uff0c\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u6b64\u5916\uff0c\u5f53\u6211\u4eec\u5904\u7406\u5e73\u884c\u5149\u65f6\uff0c\u4e5f\u9700\u8981\u8fd9\u6837\u505a\uff0c\u6444\u50cf\u673a\u7684\u4f4d\u79fb\u4e0d\u5e94\u5f71\u54cd\u5e73\u884c\u5149\u7684\u65b9\u5411\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5b9e\u73b0\u548c\u6a21\u62df\u5e73\u884c\u5149\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2a\u7c7b\u6765\u50a8\u5b58\u5b83\u7684\u5c5e\u6027\u3002\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u5176\u5177\u6709\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u5e76\u50a8\u5b58\u5149\u7684\u65b9\u5411\u3001\u989c\u8272\u548c\u5f3a\u5ea6\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class DirectionalLight { private Vector3f color; private Vector3f direction; private float intensity; public DirectionalLight(Vector3f color, Vector3f direction, float intensity) { this.color = color; this.direction = direction; this.intensity = intensity; } public DirectionalLight(DirectionalLight light) { this(new Vector3f(light.getColor()), new Vector3f(light.getDirection()), light.getIntensity()); } // \u63a5\u4e0b\u6765\u662fGetter\u548cSetter... \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528 Vector3f \u6765\u50a8\u5b58\u65b9\u5411\u3002\u4fdd\u6301\u51b7\u9759\uff0c\u5f53\u5c06\u5e73\u884c\u5149\u4f20\u9012\u5230\u7740\u8272\u5668\u65f6\uff0c\u6211\u4eec\u5c06\u5904\u7406 w \u5206\u91cf\u3002\u987a\u4fbf\u4e00\u63d0\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u5c31\u662f\u66f4\u65b0 ShaderProgram \u6765\u521b\u5efa\u548c\u66f4\u65b0\u50a8\u5b58\u5e73\u884c\u5149\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\u3002 struct DirectionalLight { vec3 colour; vec3 direction; float intensity; }; \u6709\u4e86\u4e0a\u8ff0\u5b9a\u4e49\uff0c ShaderProgram \u7c7b\u4e2d\u7684\u65b0\u65b9\u6cd5\u5c31\u5f88\u7b80\u5355\u4e86\u3002 // ... public void createDirectionalLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".direction\"); createUniform(uniformName + \".intensity\"); } // ... public void setUniform(String uniformName, DirectionalLight dirLight) { setUniform(uniformName + \".colour\", dirLight.getColor() ); setUniform(uniformName + \".direction\", dirLight.getDirection()); setUniform(uniformName + \".intensity\", dirLight.getIntensity()); } \u6211\u4eec\u73b0\u5728\u9700\u8981\u4f7f\u7528Uniform\uff0c\u901a\u8fc7 DummyGame \u7c7b\u63a7\u5236\u592a\u9633\u7684\u89d2\u5ea6\u6765\u6a21\u62df\u5b83\u662f\u5982\u4f55\u5728\u5929\u4e0a\u79fb\u52a8\u7684\u3002 \u6211\u4eec\u9700\u8981\u66f4\u65b0\u5149\u7684\u65b9\u5411\uff0c\u6240\u4ee5\u592a\u9633\u5728\u9ece\u660e\u65f6\uff08 -90\u00b0 \uff09\uff0c\u5149\u7ebf\u5728 (-1, 0, 0) \u65b9\u5411\u4e0a\uff0c\u5176 x \u5206\u91cf\u4ece -1 \u9010\u6e10\u589e\u52a0\u5230 0 \uff0c y \u5206\u91cf\u9010\u6e10\u4ece 0 \u589e\u52a0\u5230 1 \u3002\u63a5\u4e0b\u6765\uff0c x \u5206\u91cf\u589e\u52a0\u5230 1 \uff0c y \u5206\u91cf\u51cf\u5c11\u5230 0 \u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06 x \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u6b63\u5f26\u548c\u5c06 y \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u4f59\u5f26\u6765\u5b9e\u73b0\u3002 \u6211\u4eec\u4e5f\u4f1a\u8c03\u8282\u5149\u5f3a\uff0c\u5f53\u5b83\u8fdc\u79bb\u9ece\u660e\u65f6\u5f3a\u5ea6\u5c06\u589e\u5f3a\uff0c\u5f53\u5b83\u4e34\u8fd1\u9ec4\u660f\u65f6\u5f3a\u5ea6\u5c06\u51cf\u5f31\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u5f3a\u5ea6\u8bbe\u7f6e\u4e3a 0 \u6765\u6a21\u62df\u591c\u665a\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u8c03\u8282\u989c\u8272\uff0c\u4f7f\u5149\u5728\u9ece\u660e\u548c\u9ec4\u660f\u65f6\u53d8\u5f97\u66f4\u7ea2\u3002\u8fd9\u5c06\u5728 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u4e2d\u5b9e\u73b0\u3002 // \u66f4\u65b0\u5e73\u884c\u5149\u7684\u65b9\u5411\uff0c\u5f3a\u5ea6\u548c\u989c\u8272 lightAngle += 1.1f; if (lightAngle > 90) { directionalLight.setIntensity(0); if (lightAngle >= 360) { lightAngle = -90; } } else if (lightAngle <= -80 || lightAngle >= 80) { float factor = 1 - (float)(Math.abs(lightAngle) - 80)/ 10.0f; directionalLight.setIntensity(factor); directionalLight.getColor().y = Math.max(factor, 0.9f); directionalLight.getColor().z = Math.max(factor, 0.5f); } else { directionalLight.setIntensity(1); directionalLight.getColor().x = 1; directionalLight.getColor().y = 1; directionalLight.getColor().z = 1; } double angRad = Math.toRadians(lightAngle); directionalLight.getDirection().x = (float) Math.sin(angRad); directionalLight.getDirection().y = (float) Math.cos(angRad); \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u7684 render \u65b9\u6cd5\u4e2d\u5c06\u5e73\u884c\u5149\u4f20\u7ed9\u7740\u8272\u5668\u3002 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(directionalLight); Vector4f dir = new Vector4f(currDirLight.getDirection(), 0); dir.mul(viewMatrix); currDirLight.setDirection(new Vector3f(dir.x, dir.y, dir.z)); shaderProgram.setUniform(\"directionalLight\", currDirLight); \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u53d8\u6362\u5149\u7684\u65b9\u5411\u5230\u89c2\u5bdf\u7a7a\u95f4\uff0c\u4f46\u6211\u4eec\u4e0d\u60f3\u5e94\u7528\u4f4d\u79fb\uff0c\u6240\u4ee5\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u5728\u7247\u5143\u7740\u8272\u5668\u4e0a\u5b8c\u6210\u5269\u4e0b\u7684\u5de5\u4f5c\u4e86\uff0c\u56e0\u4e3a\u9876\u70b9\u7740\u8272\u5668\u4e0d\u9700\u8981\u4fee\u6539\u3002\u6b64\u524d\u5df2\u7ecf\u8bf4\u8fc7\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a DirectionalLight \u7684\u65b0\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\uff0c\u6240\u4ee5\u9700\u8981\u4e00\u4e2a\u65b0\u7684Uniform\u3002 uniform DirectionalLight directionalLight; \u6211\u4eec\u9700\u8981\u91cd\u6784\u4e00\u4e0b\u4ee3\u7801\uff0c\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a calcPointLight \u7684\u51fd\u6570\uff0c\u5b83\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u5e94\u7528\u8870\u51cf\u3002\u4f46\u5982\u4e0a\u6240\u8ff0\uff0c\u5e73\u884c\u5149\u4f7f\u7528\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u4f46\u4e0d\u53d7\u8870\u51cf\u5f71\u54cd\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcLightColour \u7684\u65b0\u51fd\u6570\u6765\u8ba1\u7b97\u90a3\u4e9b\u5206\u91cf\u3002 vec4 calcLightColour(vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04\u5149 float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04\u5149 vec3 camera_direction = normalize(camera_pos - position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * material.reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } \u7136\u540e\uff0c calcPointLight \u65b9\u6cd5\u5c06\u8870\u51cf\u56e0\u6570\u5e94\u7528\u5230\u4e0a\u8ff0\u51fd\u6570\u8ba1\u7b97\u7684\u7ed3\u679c\u4e0a\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(light.colour, light.intensity, position, to_light_dir, normal); // \u5e94\u7528\u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u5e73\u884c\u5149\u7684\u6548\u679c\uff0c\u5b83\u53ea\u8c03\u7528\u4ec5\u9700\u5149\u7167\u65b9\u5411\u7684 calcLightColour \u65b9\u6cd5\u3002 vec4 calcDirectionalLight(DirectionalLight light, vec3 position, vec3 normal) { return calcLightColour(light.colour, light.intensity, position, normalize(light.direction), normal); } \u6700\u540e\uff0c main \u65b9\u6cd5\u901a\u8fc7\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u7684\u989c\u8272\u5206\u91cf\u7efc\u5408\u8d77\u6765\u8ba1\u7b97\u7247\u5143\u989c\u8272\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcDirectionalLight(directionalLight, mvVertexPos, mvVertexNormal); diffuseSpecularComp += calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u5c31\u8fd9\u6837\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u6a21\u62df\u592a\u9633\u5728\u5929\u7a7a\u4e2d\u7684\u8fd0\u52a8\uff0c\u5982\u4e0b\u6240\u793a\uff08\u5728\u793a\u4f8b\u4ee3\u7801\u4e2d\u8fd0\u52a8\u901f\u5ea6\u52a0\u5feb\uff0c\u4e0d\u7528\u7b49\u5f85\u592a\u4e45\u5c31\u53ef\u4ee5\u770b\u5230\uff09\u3002","title":"\u5e73\u884c\u5149"},{"location":"11-let-there-be-even-more-light/#_2","text":"\u73b0\u5728\u6211\u4eec\u5c06\u5b9e\u73b0\u4e0e\u70b9\u5149\u6e90\u975e\u5e38\u76f8\u4f3c\u7684\u805a\u5149\u6e90\uff0c\u4f46\u662f\u5b83\u53d1\u5c04\u7684\u5149\u4ec5\u9650\u4e8e\u4e09\u7ef4\u5706\u9525\u4f53\u4e2d\u3002\u5b83\u6a21\u62df\u4ece\u7126\u70b9\u6216\u4efb\u4f55\u5176\u4ed6\u4e0d\u5411\u6240\u6709\u65b9\u5411\u53d1\u5c04\u5149\u7684\u5149\u6e90\u3002\u805a\u5149\u6e90\u6709\u7740\u548c\u70b9\u5149\u6e90\u4e00\u6837\u7684\u5c5e\u6027\uff0c\u4f46\u5b83\u6dfb\u52a0\u4e86\u4e24\u4e2a\u65b0\u7684\u53c2\u6570\uff0c\u5706\u9525\u89d2\u548c\u5706\u9525\u65b9\u5411\u3002 \u805a\u5149\u6e90\u4e0e\u70b9\u5149\u6e90\u7684\u8ba1\u7b97\u65b9\u6cd5\u76f8\u540c\uff0c\u4f46\u6709\u4e00\u4e9b\u4e0d\u540c\u3002\u4ece\u9876\u70b9\u4f4d\u7f6e\u5230\u5149\u6e90\u7684\u77e2\u91cf\u4e0d\u5728\u5149\u9525\u5185\u7684\u70b9\u4e0d\u53d7\u5149\u7167\u7684\u5f71\u54cd\u3002 \u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\u662f\u5426\u5728\u5149\u9525\u5185\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u548c\u5706\u9525\u65b9\u5411\u77e2\u91cf\uff08\u4e24\u8005\u90fd\u5f52\u4e00\u5316\u4e86\uff09\u4e4b\u95f4\u518d\u505a\u6b21\u6570\u91cf\u79ef\u3002 L \u548c C \u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\u7b49\u4e8e\uff1a \\vec{L}\\cdot\\vec{C}=|\\vec{L}|\\cdot|\\vec{C}|\\cdot Cos(\\alpha) \u3002\u5728\u805a\u5149\u6e90\u7684\u5b9a\u4e49\u4e2d\uff0c\u6211\u4eec\u50a8\u5b58\u9525\u89d2\u7684\u4f59\u5f26\u503c\uff0c\u5982\u679c\u6570\u91cf\u79ef\u9ad8\u4e8e\u8be5\u503c\uff0c\u6211\u4eec\u5c31\u77e5\u9053\u5b83\u4f4d\u4e8e\u5149\u9525\u5185\u90e8\uff08\u60f3\u60f3\u4f59\u5f26\u56fe\uff0c\u5f53 \u03b1 \u89d2\u4e3a 0 \u65f6\uff0c\u5176\u4f59\u5f26\u503c\u4e3a 1 \u3002\u57280\u00b0~180\u00b0\u65f6\uff0c\u89d2\u5ea6\u8d8a\u5c0f\u4f59\u5f26\u503c\u8d8a\u5927\uff09\u3002 \u7b2c\u4e8c\u4e2a\u4e0d\u540c\u4e4b\u5904\u662f\u8fdc\u79bb\u5149\u9525\u65b9\u5411\u7684\u70b9\u5c06\u53d7\u5230\u66f4\u5c11\u7684\u5149\u7167\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u8870\u51cf\u5f71\u54cd\u5c06\u66f4\u5f3a\u3002\u6709\u51e0\u79cd\u8ba1\u7b97\u65b9\u6cd5\uff0c\u6211\u4eec\u5c06\u9009\u62e9\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u5c06\u8870\u51cf\u4e0e\u4e0b\u8ff0\u516c\u5f0f\u76f8\u4e58\uff1a 1 - (1-Cos(\\alpha))/(1-Cos(cutOffAngle) (\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u6ca1\u6709\u4f20\u9012\u89d2\u5ea6\uff0c\u800c\u662f\u4f20\u9012\u89d2\u5ea6\u7684\u4f59\u5f26\u503c\u3002\u4f60\u53ef\u4ee5\u68c0\u67e5\u4e0a\u9762\u7684\u516c\u5f0f\u7684\u7ed3\u679c\u662f\u5426\u4f4d\u4e8e0\u52301\u4e4b\u95f4\uff0c\u5f53\u89d2\u5ea6\u4e3a0\u65f6\uff0c\u4f59\u5f26\u503c\u4e3a1\u3002) \u5b9e\u73b0\u975e\u5e38\u7c7b\u4f3c\u4e8e\u5176\u4ed6\u7684\u5149\u6e90\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SpotLight \u7684\u7c7b\uff0c\u8bbe\u7f6e\u9002\u5f53\u7684Uniform\uff0c\u5c06\u5176\u4f20\u9012\u7ed9\u7740\u8272\u5668\u5e76\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u4ee5\u83b7\u53d6\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u3002 \u5f53\u4f20\u9012Uniform\u65f6\uff0c\u53e6\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u662f\u4f4d\u79fb\u4e0d\u5e94\u8be5\u5e94\u7528\u5230\u5149\u9525\u65b9\u5411\u4e0a\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u56e0\u6b64\uff0c\u548c\u5e73\u884c\u5149\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u5f53\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u65f6\uff0c\u5fc5\u987b\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002","title":"\u805a\u5149\u6e90"},{"location":"11-let-there-be-even-more-light/#_3","text":"\u6211\u4eec\u7ec8\u4e8e\u5b9e\u73b0\u4e86\u56db\u79cd\u7c7b\u578b\u7684\u5149\u6e90\uff0c\u4f46\u662f\u76ee\u524d\u6bcf\u79cd\u7c7b\u578b\u7684\u5149\u6e90\u53ea\u80fd\u4f7f\u7528\u4e00\u4e2a\u5b9e\u4f8b\u3002\u8fd9\u5bf9\u4e8e\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8bf4\u6ca1\u95ee\u9898\uff0c\u4f46\u662f\u6211\u4eec\u786e\u5b9e\u5e0c\u671b\u4f7f\u7528\u591a\u4e2a\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u6765\u63a5\u6536\u5149\u6e90\u5217\u8868\uff0c\u6240\u4ee5\u4f7f\u7528\u6570\u7ec4\u6765\u50a8\u5b58\u8fd9\u4e9b\u6570\u636e\u3002\u6765\u770b\u770b\u600e\u4e48\u5b9e\u73b0\u5427\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5728GLSL\u4e2d\uff0c\u6570\u7ec4\u7684\u957f\u5ea6\u5fc5\u987b\u5728\u7f16\u8bd1\u65f6\u8bbe\u7f6e\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u8db3\u591f\u5927\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u80fd\u591f\u50a8\u5b58\u6240\u9700\u7684\u6240\u6709\u5bf9\u8c61\u3002\u9996\u5148\u662f\u5b9a\u4e49\u4e00\u4e9b\u5e38\u91cf\u6765\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u6700\u5927\u70b9\u5149\u6e90\u6570\u548c\u805a\u5149\u6e90\u6570\u3002 const int MAX_POINT_LIGHTS = 5; const int MAX_SPOT_LIGHTS = 5; \u7136\u540e\u6211\u4eec\u9700\u8981\u4fee\u6539\u6b64\u524d\u53ea\u50a8\u5b58\u4e00\u4e2a\u70b9\u5149\u6e90\u548c\u4e00\u4e2a\u805a\u5149\u6e90\u7684Uniform\uff0c\u4ee5\u4fbf\u4f7f\u7528\u6570\u7ec4\u3002 uniform PointLight pointLights[MAX_POINT_LIGHTS]; uniform SpotLight spotLights[MAX_SPOT_LIGHTS]; \u5728main\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5bf9\u8fd9\u4e9b\u6570\u7ec4\u8fdb\u884c\u8fed\u4ee3\uff0c\u4ee5\u4f7f\u7528\u73b0\u6709\u51fd\u6570\u8ba1\u7b97\u6bcf\u4e2a\u5bf9\u8c61\u5bf9\u989c\u8272\u7684\u5f71\u54cd\u3002\u6211\u4eec\u53ef\u80fd\u4e0d\u4f1a\u50cfUniform\u6570\u7ec4\u957f\u5ea6\u90a3\u6837\u4f20\u9012\u5f88\u591a\u5149\u6e90\uff0c\u6240\u4ee5\u9700\u8981\u63a7\u5236\u5b83\u3002\u6709\u5f88\u591a\u53ef\u884c\u7684\u65b9\u6cd5\uff0c\u4f46\u8fd9\u53ef\u80fd\u4e0d\u9002\u7528\u4e8e\u65e7\u7684\u663e\u5361\u3002\u6700\u7ec8\u6211\u4eec\u9009\u62e9\u68c0\u67e5\u5149\u5f3a\uff08\u5728\u6570\u7ec4\u4e2d\u7684\u7a7a\u4f4d\uff0c\u5149\u5f3a\u4e3a0\uff09\u3002 for (int i=0; i<MAX_POINT_LIGHTS; i++) { if ( pointLights[i].intensity > 0 ) { diffuseSpecularComp += calcPointLight(pointLights[i], mvVertexPos, mvVertexNormal); } } for (int i=0; i<MAX_SPOT_LIGHTS; i++) { if ( spotLights[i].pl.intensity > 0 ) { diffuseSpecularComp += calcSpotLight(spotLights[i], mvVertexPos, mvVertexNormal); } } \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728 Render \u7c7b\u4e2d\u521b\u5efa\u8fd9\u4e9bUniform\u3002\u5f53\u4f7f\u7528\u6570\u7ec4\u65f6\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u5217\u8868\u4e2d\u7684\u6bcf\u4e2a\u5143\u7d20\u521b\u5efa\u4e00\u4e2aUniform\u3002\u4f8b\u5982\uff0c\u5bf9\u4e8e pointLights \u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u540d\u4e3a pointLights[0] \u3001 pointLights[1] \u4e4b\u7c7b\u7684Uniform\u3002\u5f53\u7136\uff0c\u8fd9\u4e5f\u9002\u7528\u4e8e\u7ed3\u6784\u4f53\u5c5e\u6027\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa pointLights[0].colour \u3001 pointLights[1].colour \u7b49\u7b49\u3002\u521b\u5efa\u8fd9\u4e9bUniform\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a public void createPointLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createPointLightUniform(uniformName + \"[\" + i + \"]\"); } } public void createSpotLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createSpotLightUniform(uniformName + \"[\" + i + \"]\"); } } \u6211\u4eec\u4e5f\u9700\u8981\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff1a public void setUniform(String uniformName, PointLight[] pointLights) { int numLights = pointLights != null ? pointLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, pointLights[i], i); } } public void setUniform(String uniformName, PointLight pointLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", pointLight); } public void setUniform(String uniformName, SpotLight[] spotLights) { int numLights = spotLights != null ? spotLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, spotLights[i], i); } } public void setUniform(String uniformName, SpotLight spotLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", spotLight); } \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u66f4\u65b0 Render \u7c7b\u6765\u63a5\u6536\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u5217\u8868\uff0c\u5e76\u76f8\u5e94\u5730\u4fee\u6539 DummyGame \u7c7b\u4ee5\u521b\u5efa\u8fd9\u4e9b\u5217\u8868\uff0c\u6700\u7ec8\u6548\u679c\u5982\u4e0b\u6240\u793a\u3002","title":"\u591a\u5149\u6e90"},{"location":"12-game-hud/","text":"\u6e38\u620fHUD\uff08Game HUD\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\uff08Heads-Up Display\uff0c\u5e73\u89c6\u663e\u793a\u5668\uff09\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5c31\u662f\u4e00\u7ec4\u7528\u4e8e\u5728\u4e09\u7ef4\u573a\u666f\u4e0a\uff0c\u968f\u65f6\u663e\u793a\u76f8\u5173\u4fe1\u606f\u7684\u4e8c\u7ef4\u56fe\u5f62\u548c\u6587\u672c\u3002\u672c\u4f8b\u4e2d\u5c06\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684HUD\uff0c\u8fd9\u53ef\u4e3a\u6211\u4eec\u5c55\u73b0\u4e00\u4e9b\u663e\u793a\u4fe1\u606f\u7684\u57fa\u672c\u6280\u672f\u3002 \u5f53\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u65f6\uff0c\u8fd8\u5c06\u53d1\u73b0\u6211\u4eec\u5bf9\u6e90\u4ee3\u7801\u505a\u4e86\u4e00\u4e9b\u5c0f\u7684\u91cd\u6784\uff0c\u7279\u522b\u662f Renderer \u7c7b\uff0c\u4ee5\u4fbf\u4e3aHUD\u6e32\u67d3\u505a\u597d\u51c6\u5907\u3002 \u6587\u672c\u6e32\u67d3 \u521b\u5efaHUD\u6240\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6e32\u67d3\u6587\u672c\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u50a8\u5b58\u5b57\u7b26\u7684\u7eb9\u7406\u6620\u5c04\u5230\u4e00\u4e2a\u65b9\u5f62\u4e2d\uff0c\u8be5\u65b9\u5f62\u5c06\u88ab\u5206\u5272\u4e3a\u4e00\u7ec4\u8868\u793a\u6bcf\u4e2a\u5b57\u7b26\u7684\u7247\u6bb5\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u7eb9\u7406\u5728\u5c4f\u5e55\u4e0a\u7ed8\u5236\u6587\u672c\u3002\u6240\u4ee5\u9996\u5148\u521b\u5efa\u542b\u6709\u6240\u6709\u5b57\u6bcd\u7684\u7eb9\u7406\uff0c\u8fd9\u9879\u5de5\u4f5c\u53ef\u4ee5\u4f7f\u7528\u5f88\u591a\u8f6f\u4ef6\u6765\u505a\uff0c\u4f8b\u5982 CBFG \u3001 F2IBuilder \u7b49\u7b49\u3002\u672c\u4f8b\u4f7f\u7528Codehead\u7684\u4f4d\u56fe\u5b57\u4f53\u751f\u6210\u5668\uff08Codehead\u2019s Bitmap Font Generator\uff0cCBFG\uff09\u3002 CBFG\u5141\u8bb8\u4f60\u914d\u7f6e\u5f88\u591a\u9009\u9879\uff0c\u5982\u7eb9\u7406\u5927\u5c0f\u3001\u5b57\u4f53\u7c7b\u578b\u3001\u8981\u4f7f\u7528\u7684\u6297\u952f\u9f7f\u7b49\u7b49\u3002\u4e0b\u56fe\u662f\u672c\u4f8b\u5c06\u7528\u6765\u751f\u6210\u7eb9\u7406\u6587\u4ef6\u7684\u914d\u7f6e\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u6587\u672c\u7f16\u7801\u4e3aISO-8859-1\uff0c\u5982\u679c\u4f60\u9700\u8981\u5904\u7406\u5176\u4ed6\u7684\u5b57\u7b26\u96c6\uff0c\u5219\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u4ee3\u7801\u3002 \u5f53\u8bbe\u7f6e\u597dCBFG\u7684\u6240\u6709\u9009\u9879\u540e\uff0c\u53ef\u4ee5\u5c06\u5176\u5bfc\u51fa\u4e3a\u591a\u79cd\u56fe\u7247\u683c\u5f0f\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5176\u5bfc\u51fa\u4e3aBMP\u6587\u4ef6\uff0c\u7136\u540e\u518d\u8f6c\u6362\u4e3aPNG\u6587\u4ef6\uff0c\u4ee5\u4fbf\u5c06\u5176\u4f5c\u4e3a\u7eb9\u7406\u52a0\u8f7d\u3002\u5f53\u8f6c\u6362\u4e3aPNG\u683c\u5f0f\u65f6\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u5c06\u9ed1\u8272\u80cc\u666f\u8bbe\u7f6e\u4e3a\u900f\u660e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5c06\u9ed1\u8272\u8bbe\u4e3aAlpha\u503c\u7b49\u4e8e0\uff08\u53ef\u4ee5\u4f7f\u7528GIMP\u8fd9\u6837\u7684\u5de5\u5177\u6765\u5b9e\u73b0\uff09\u3002\u6700\u7ec8\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u56fe\u50cf\u4e2d\u7684\u6240\u6709\u5b57\u7b26\u90fd\u4ee5\u884c\u548c\u5217\u7684\u5f62\u5f0f\u6392\u5217\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u56fe\u50cf\u753115\u5217\u548c17\u884c\u5b57\u7b26\u7ec4\u6210\u3002\u901a\u8fc7\u4f7f\u7528\u7279\u5b9a\u5b57\u7b26\u7684\u7f16\u53f7\uff0c\u6211\u4eec\u53ef\u4ee5\u8ba1\u7b97\u5176\u5bf9\u5e94\u50a8\u5b58\u5728\u56fe\u50cf\u4e2d\u7684\u884c\u548c\u5217\u3002\u6240\u5728\u5217\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u5217\u6570 = \u5b57\u7b26\u7f16\u53f7 \\space mod \\space \u5217\u603b\u6570 \uff0c\u5176\u4e2d mod \u662f\u53d6\u4f59\u8fd0\u7b97\u7b26\uff0c\u6240\u5728\u884c\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u6240\u5728\u884c = \u5b57\u7b26\u7f16\u53f7 / \u884c\u603b\u6570 \u3002\u5728\u672c\u4f8b\u4e2d\u6211\u4eec\u5c06\u6574\u6570\u9664\u4ee5\u6574\u6570\uff0c\u4ee5\u4fbf\u5ffd\u7565\u5c0f\u6570\u90e8\u5206\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a TextItem \u7684\u65b0\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6e32\u67d3\u6587\u672c\u6240\u9700\u7684\u56fe\u5143\u3002\u8fd9\u662f\u4e00\u4e2a\u4e0d\u8003\u8651\u591a\u884c\u6587\u672c\u7684\u7b80\u5316\u5b9e\u73b0\uff0c\u4f46\u662f\u5b83\u80fd\u5728HUD\u4e2d\u663e\u793a\u6587\u672c\u4fe1\u606f\u3002\u4e0b\u5217\u4ee3\u7801\u662f\u8be5\u7c7b\u7684\u58f0\u660e\u4e0e\u6784\u9020\u51fd\u6570\uff1a package org.lwjglb.engine; import java.nio.charset.Charset; import java.util.ArrayList; import java.util.List; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; public class TextItem extends GameItem { private static final float ZPOS = 0.0f; private static final int VERTICES_PER_QUAD = 4; private String text; private final int numCols; private final int numRows; public TextItem(String text, String fontFileName, int numCols, int numRows) throws Exception { super(); this.text = text; this.numCols = numCols; this.numRows = numRows; Texture texture = new Texture(fontFileName); this.setMesh(buildMesh(texture, numCols, numRows)); } \u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u6539\u53d8\u5728\u5c4f\u5e55\u4e0a\u6587\u672c\u7684\u4f4d\u7f6e\uff0c\u4e5f\u53ef\u80fd\u9700\u8981\u7f29\u653e\u548c\u65cb\u8f6c\u5b83\u3002\u6784\u9020\u51fd\u6570\u63a5\u6536\u8981\u6e32\u67d3\u7684\u6587\u672c\u548c\u7528\u4e8e\u6e32\u67d3\u7684\u7eb9\u7406\u7684\u6587\u4ef6\u548c\u76f8\u5173\u6570\u636e\uff08\u50a8\u5b58\u56fe\u50cf\u7684\u6587\u4ef6\u53ca\u884c\u5217\u6570\uff09\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\uff0c\u5e76\u8c03\u7528\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u4e3a\u6587\u672c\u5efa\u6a21\u3002\u8ba9\u6211\u4eec\u770b\u5230 buildMesh \u65b9\u6cd5\uff1a private Mesh buildMesh(Texture texture, int numCols, int numRows) { byte[] chars = text.getBytes(Charset.forName(\"ISO-8859-1\")); int numChars = chars.length; List<Float> positions = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); float[] normals = new float[0]; List<Integer> indices = new ArrayList<>(); float tileWidth = (float)texture.getWidth() / (float)numCols; float tileHeight = (float)texture.getHeight() / (float)numRows; \u4ee3\u7801\u521b\u5efa\u4e86\u7528\u4e8e\u50a8\u5b58Mesh\u7684\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u7d22\u5f15\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u6211\u4eec\u4e0d\u4f7f\u7528\u5149\u7167\uff0c\u56e0\u6b64\u6cd5\u7ebf\u6570\u5217\u662f\u7a7a\u7684\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u7ec4\u5b57\u7b26\u7247\u6bb5\uff0c\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u4ee3\u8868\u4e00\u4e2a\u5b57\u7b26\u3002\u6211\u4eec\u8fd8\u9700\u8981\u6839\u636e\u6bcf\u4e2a\u7247\u6bb5\u5bf9\u5e94\u7684\u5b57\u7b26\u6765\u5206\u914d\u5bf9\u5e94\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u6587\u672c\u77e9\u5f62\u548c\u5b57\u7b26\u7247\u6bb5\u7684\u5173\u7cfb\uff1a \u56e0\u6b64\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u5b57\u7b26\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u6784\u6210\u7684\u5b57\u7b26\u7247\u6bb5\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u53ef\u4ee5\u7528\u56db\u4e2a\u9876\u70b9\uff08V1\u3001V2\u3001V3\u548cV4\uff09\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff08\u5de6\u4e0b\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(0, 1, 2)\uff0c\u800c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u53f3\u4e0a\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(3, 0, 2)\u3002\u7eb9\u7406\u5750\u6807\u662f\u57fa\u4e8e\u4e0e\u7eb9\u7406\u56fe\u50cf\u4e2d\u6bcf\u4e2a\u5b57\u7b26\u76f8\u5173\u7684\u884c\u5217\u8ba1\u7b97\u7684\uff0c\u7eb9\u7406\u5750\u6807\u7684\u8303\u56f4\u4e3a[0, 1]\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5f53\u524d\u884c\u6216\u5f53\u524d\u5217\u9664\u4ee5\u603b\u884c\u6570\u548c\u603b\u5217\u6570\u5c31\u53ef\u4ee5\u83b7\u5f97V1\u7684\u5750\u6807\u3002\u5bf9\u4e8e\u5176\u4ed6\u9876\u70b9\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9002\u5f53\u52a0\u4e0a\u884c\u5bbd\u6216\u5217\u5bbd\u5c31\u53ef\u4ee5\u5f97\u5230\u5bf9\u5e94\u5750\u6807\u3002 \u4e0b\u8ff0\u7684\u5faa\u73af\u8bed\u53e5\u5757\u521b\u5efa\u4e86\u4e0e\u6e32\u67d3\u6587\u672c\u77e9\u5f62\u76f8\u5173\u7684\u6240\u6709\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002 for(int i=0; i<numChars; i++) { byte currChar = chars[i]; int col = currChar % numCols; int row = currChar / numCols; // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD); // \u5de6\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 1); // \u53f3\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 2); // \u53f3\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 3); // \u6dfb\u52a0\u5de6\u4e0a\u89d2\u548c\u53f3\u4e0b\u89d2\u9876\u70b9\u7684\u7d22\u5f15 indices.add(i*VERTICES_PER_QUAD); indices.add(i*VERTICES_PER_QUAD + 2); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u9700\u8981\u6ce8\u610f\u7684\u4e00\u4e9b\u4e8b\u9879\uff1a \u6211\u4eec\u5c06\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u6765\u8868\u793a\u9876\u70b9\uff08\u8bb0\u4f4f\u5c4f\u5e55\u5750\u6807\u7cfb\u7684\u539f\u70b9\u4f4d\u4e8e\u5c4f\u5e55\u5de6\u4e0a\u89d2\uff09\u3002\u4e09\u89d2\u5f62\u4e0a\u9876\u70b9\u7684Y\u5750\u6807\u5c0f\u4e8e\u4e09\u89d2\u5f62\u4e0b\u9876\u70b9\u7684Y\u5750\u6807\u3002 \u6211\u4eec\u4e0d\u7f29\u653e\u56fe\u5f62\uff0c\u56e0\u6b64\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u7684X\u8ddd\u79bb\u5c31\u7b49\u4e8e\u5b57\u7b26\u5bbd\u5ea6\uff0c\u4e09\u89d2\u5f62\u7684\u9ad8\u5ea6\u5c31\u662f\u6bcf\u4e2a\u5b57\u7b26\u7684\u9ad8\u5ea6\u3002\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u5c3d\u53ef\u80fd\u5730\u4f7f\u6e32\u67d3\u6587\u672c\u4e0e\u539f\u59cb\u7eb9\u7406\u76f8\u4f3c\uff08\u4e0d\u7ba1\u600e\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u7a0d\u540e\u7f29\u653e\u5b83\uff0c\u56e0\u4e3a TextItem \u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff09\u3002 Z\u5750\u6807\u4e3a\u56fa\u5b9a\u503c\uff0c\u56e0\u4e3a\u5b83\u4e0e\u7ed8\u5236\u8be5\u56fe\u50cf\u65e0\u5173\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e9b\u9876\u70b9\u7684\u5750\u6807\uff1a \u4e3a\u4ec0\u4e48\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u7cfb\uff1f\u9996\u5148\uff0c\u56e0\u4e3a\u672c\u4f8b\u5c06\u5728HUD\u4e2d\u6e32\u67d32D\u5bf9\u8c61\uff0c\u5e76\u4e14\u901a\u5e38\u8fd9\u6837\u4f7f\u7528\u5b83\u4eec\u66f4\u65b9\u4fbf\u3002\u5176\u6b21\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u7ed8\u5236\u5b83\u4eec\uff0c\u7a0d\u540e\u518d\u89e3\u91ca\u4ec0\u4e48\u662f\u6b63\u4ea4\u6295\u5f71\u3002 TextItem \u7c7b\u6700\u540e\u8fd8\u9700\u6dfb\u52a0\u4e00\u4e9b\u65b9\u6cd5\uff0c\u4ee5\u83b7\u53d6\u6587\u672c\u5e76\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u6587\u672c\u3002\u6bcf\u5f53\u6587\u672c\u88ab\u66f4\u6539\u65f6\uff0c\u9700\u8981\u6e05\u7406\u6b64\u524d\u7684VAO\uff08\u50a8\u5b58\u5728 Mesh \u5b9e\u4f8b\u4e2d\uff09\u5e76\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VAO\u3002\u6211\u4eec\u4e0d\u9700\u8981\u5220\u9664\u7eb9\u7406\uff0c\u6240\u4ee5\u5728 Mesh \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u5220\u9664\u8fd9\u4e9b\u6570\u636e\u3002 public String getText() { return text; } public void setText(String text) { this.text = text; Texture texture = this.getMesh().getMaterial().getTexture(); this.getMesh().deleteBuffers(); this.setMesh(buildMesh(texture, numCols, numRows)); } \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u5efa\u7acb\u4e86\u6e32\u67d3\u6587\u672c\u6240\u9700\u8981\u7684\u57fa\u7840\u7ed3\u6784\uff0c\u63a5\u4e0b\u6765\u8be5\u600e\u4e48\u505a\u5462\uff1f\u9996\u5148\u5982\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\uff0c\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\uff0c\u7136\u540e\u5728\u5176\u4e0a\u6e32\u67d3\u4e8c\u7ef4\u7684HUD\u3002\u4e3a\u4e86\u6e32\u67d3HUD\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08\u4e5f\u79f0\u4e3a\u6b63\u4ea4\u6295\u5f71\uff09\u3002\u6b63\u4ea4\u6295\u5f71\u662f\u4e09\u7ef4\u7269\u4f53\u7684\u4e00\u79cd\u4e8c\u7ef4\u8868\u793a\u65b9\u5f0f\uff0c\u4f60\u53ef\u80fd\u5df2\u7ecf\u5728\u4e09\u7ef4\u6a21\u578b\u7684\u84dd\u56fe\u4e2d\u770b\u5230\u4e86\u4e00\u4e9b\u4f8b\u5b50\uff0c\u5b83\u4eec\u7528\u6765\u8868\u793a\u67d0\u4e9b\u7269\u4f53\u4ece\u9876\u90e8\u6216\u67d0\u4e9b\u4fa7\u9762\u770b\u5230\u7684\u6837\u5b50\u3002\u4e0b\u56fe\u662f\u5706\u67f1\u4f53\u4ece\u9876\u90e8\u548c\u524d\u9762\u7684\u6b63\u4ea4\u6295\u5f71\uff1a \u8fd9\u79cd\u6295\u5f71\u5bf9\u4e8e\u7ed8\u5236\u4e8c\u7ef4\u7269\u4f53\u662f\u975e\u5e38\u65b9\u4fbf\u7684\uff0c\u56e0\u4e3a\u5b83\u201c\u5ffd\u7565\u201d\u4e86Z\u5750\u6807\u7684\u503c\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5ffd\u7565\u4e86\u5230\u5c4f\u5e55\u7684\u8ddd\u79bb\u3002\u4f7f\u7528\u8fd9\u79cd\u6295\u5f71\uff0c\u7269\u4f53\u5927\u5c0f\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u7684\u589e\u5927\u800c\u51cf\u5c0f\uff08\u4e0d\u540c\u4e8e\u900f\u89c6\u6295\u5f71\uff09\u3002\u4e3a\u4e86\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u6295\u5f71\u7269\u4f53\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u516c\u5f0f\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u4e2a\u77e9\u9635\u8fd8\u77eb\u6b63\u4e86\u5931\u771f\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7a97\u53e3\u5e76\u4e0d\u603b\u662f\u5b8c\u7f8e\u7684\u6b63\u65b9\u5f62\uff0c\u800c\u662f\u4e00\u4e2a\u77e9\u5f62\u3002 right \u548c bottom \u662f\u5c4f\u5e55\u5927\u5c0f\uff0c\u800c left \u548c top \u662f\u539f\u70b9\u5750\u6807\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7528\u4e8e\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u8be5\u6295\u5f71\u7684\u6620\u5c04\u8fc7\u7a0b\uff1a \u8be5\u77e9\u9635\u5c06\u5141\u8bb8\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7ee7\u7eed\u5b9e\u73b0HUD\u4e86\u3002\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u521b\u5efa\u53e6\u4e00\u7ec4\u7740\u8272\u5668\uff0c\u4e00\u4e2a\u9876\u70b9\u7740\u8272\u5668\u548c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\uff0c\u6765\u7ed8\u5236HUD\u3002\u9876\u70b9\u7740\u8272\u5668\u5f88\u7b80\u5355\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 projModelMatrix; void main() { gl_Position = projModelMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5b83\u4ec5\u63a5\u6536\u9876\u70b9\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u6cd5\u7ebf\uff0c\u5e76\u5c06\u4f7f\u7528\u77e9\u9635\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\uff0c\u8be5\u77e9\u9635\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u7684\u4e58\u79ef\uff0c\u5373 projModelMatrix = \u6b63\u4ea4\u6295\u5f71\u77e9\u9635 \\cdot \u6a21\u578b\u77e9\u9635 \u3002\u7531\u4e8e\u6211\u4eec\u6ca1\u6709\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\u5bf9\u5750\u6807\u505a\u4efb\u4f55\u5904\u7406\uff0c\u6240\u4ee5\u5728Java\u4ee3\u7801\u4e2d\u5c06\u4e24\u4e2a\u77e9\u9635\u76f8\u4e58\u6bd4\u5728\u7740\u8272\u5668\u4e2d\u76f8\u4e58\u66f4\u9ad8\u6548\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u9879\u76ee\u505a\u4e00\u6b21\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\uff0c\u800c\u4e0d\u662f\u4e3a\u6bcf\u4e2a\u9876\u70b9\u505a\u4e00\u6b21\u3002\u8fd8\u5e94\u8bb0\u4f4f\u9876\u70b9\u5e94\u8be5\u7528\u5c4f\u5e55\u5750\u6807\u8868\u793a\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; void main() { fragColor = colour * texture(texture_sampler, outTexCoord); } \u5b83\u53ea\u662f\u5c06\u57fa\u672c\u989c\u8272\u4e0e\u7eb9\u7406\u989c\u8272\u76f8\u4e58\uff0c\u8fd9\u6837\u53ef\u4ee5\u6539\u53d8\u6e32\u67d3\u6587\u672c\u7684\u989c\u8272\uff0c\u800c\u4e0d\u9700\u8981\u521b\u5efa\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u73b0\u5728\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u7ec4\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IHud \u7684\u63a5\u53e3\uff0c\u8be5\u63a5\u53e3\u50a8\u5b58\u6240\u6709\u8981\u5728HUD\u4e0a\u663e\u793a\u7684\u5143\u7d20\uff0c\u5e76\u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u7684 cleanup \u65b9\u6cd5\u3002 package org.lwjglb.engine; public interface IHud { GameItem[] getGameItems(); default void cleanup() { GameItem[] gameItems = getGameItems(); for (GameItem gameItem : gameItems) { gameItem.getMesh().cleanUp(); } } } \u901a\u8fc7\u8be5\u63a5\u53e3\uff0c\u4e0d\u540c\u7684\u6e38\u620f\u53ef\u4ee5\u5b9a\u4e49\u81ea\u5b9a\u4e49\u7684HUD\uff0c\u800c\u4e0d\u9700\u8981\u6539\u53d8\u6e32\u67d3\u673a\u5236\u3002\u73b0\u5728\u56de\u5230 Renderer \u7c7b\uff0c\u987a\u4fbf\u4e00\u63d0\uff0c\u5b83\u5df2\u7ecf\u88ab\u79fb\u52a8\u5230 engine.graph \u5305\u4e0b\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u7684\u901a\u7528\u6027\u8db3\u4ee5\u4e0d\u4f9d\u8d56\u4efb\u4f55\u6e38\u620f\u7684\u5177\u4f53\u5b9e\u73b0\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u521b\u5efa\u3001\u8fde\u63a5\u548c\u521d\u59cb\u5316\u4e00\u4e2a\u65b0\u7684 ShaderProgram \uff0c\u4ee5\u4fbf\u4f7f\u7528\u4e0a\u8ff0\u6240\u793a\u7684\u7740\u8272\u5668\u3002 private void setupHudShader() throws Exception { hudShaderProgram = new ShaderProgram(); hudShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/hud_vertex.vs\")); hudShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/hud_fragment.fs\")); hudShaderProgram.link(); // \u4e3a\u6b63\u4ea4\u6295\u5f71\u6a21\u578b\u77e9\u9635\u548c\u989c\u8272\u521b\u5efaUniform hudShaderProgram.createUniform(\"projModelMatrix\"); hudShaderProgram.createUniform(\"colour\"); } render \u65b9\u6cd5\u9996\u5148\u4f1a\u8c03\u7528 renderScene \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\u7684\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u4ee3\u7801\uff0c\u7136\u540e\u8c03\u7528\u4e00\u4e2a\u540d\u4e3a renderHud \u7684\u65b0\u65b9\u6cd5\uff0c\u7528\u4e8e\u6e32\u67d3HUD\u3002 public void render(Window window, Camera camera, GameItem[] gameItems, SceneLight sceneLight, IHud hud) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } renderScene(window, camera, gameItems, sceneLight); renderHud(window, hud); } renderHud \u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\uff1a private void renderHud(Window window, IHud hud) { hudShaderProgram.bind(); Matrix4f ortho = transformation.getOrthoProjectionMatrix(0, window.getWidth(), window.getHeight(), 0); for (GameItem gameItem : hud.getGameItems()) { Mesh mesh = gameItem.getMesh(); // HUD\u5143\u7d20\u7684\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58 Matrix4f projModelMatrix = transformation.getOrtoProjModelMatrix(gameItem, ortho); hudShaderProgram.setUniform(\"projModelMatrix\", projModelMatrix); hudShaderProgram.setUniform(\"colour\", gameItem.getMesh().getMaterial().getAmbientColour()); // \u6e32\u67d3\u6b64HUD\u9879\u76ee\u7684\u7f51\u683c mesh.render(); } hudShaderProgram.unbind(); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u904d\u5386\u4e86HUD\u7684\u6240\u6709\u5143\u7d20\uff0c\u5e76\u5c06\u4e0e\u6bcf\u4e2a\u5143\u7d20\u5173\u8054\u7684\u6a21\u578b\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u76f8\u4e58\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5728\u6bcf\u6b21 render \u8c03\u7528\u65f6\u88ab\u5237\u65b0\uff08\u56e0\u4e3a\u5c4f\u5e55\u5927\u5c0f\u53ef\u4ee5\u88ab\u6539\u53d8\uff09\uff0c\u5e76\u4e14\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a public final Matrix4f getOrthoProjectionMatrix(float left, float right, float bottom, float top) { orthoMatrix.identity(); orthoMatrix.setOrtho2D(left, right, bottom, top); return orthoMatrix; } \u6211\u4eec\u5c06\u5728 game \u5305\u4e2d\u521b\u5efa\u4e00\u4e2a Hud \u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86 IHud \u63a5\u53e3\uff0c\u5e76\u5728\u6784\u9020\u51fd\u6570\u63a5\u6536\u4e00\u4e2a\u6587\u672c\uff0c\u7528\u4e8e\u5728\u5176\u4e2d\u521b\u5efa TextItem \u5b9e\u4f8b\u3002 package org.lwjglb.game; import org.joml.Vector4f; import org.lwjglb.engine.GameItem; import org.lwjglb.engine.IHud; import org.lwjglb.engine.TextItem; public class Hud implements IHud { private static final int FONT_COLS = 15; private static final int FONT_ROWS = 17; private static final String FONT_TEXTURE = \"textures/font_texture.png\"; private final GameItem[] gameItems; private final TextItem statusTextItem; public Hud(String statusText) throws Exception { this.statusTextItem = new TextItem(statusText, FONT_TEXTURE, FONT_COLS, FONT_ROWS); this.statusTextItem.getMesh().getMaterial().setColour(new Vector4f(1, 1, 1, 1)); gameItems = new GameItem[]{statusTextItem}; } public void setStatusText(String statusText) { this.statusTextItem.setText(statusText); } @Override public GameItem[] getGameItems() { return gameItems; } public void updateSize(Window window) { this.statusTextItem.setPosition(10f, window.getHeight() - 50f, 0); } } \u5728 DummyGame \u7c7b\u4e2d\u6211\u4eec\u521b\u5efa\u8be5\u7c7b\u7684\u5b9e\u4f8b\uff0c\u5e76\u7528\u9ed8\u8ba4\u6587\u672c\u521d\u59cb\u5316\u5b83\uff0c\u6700\u540e\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\uff1a \u5728 Texture \u7c7b\u4e2d\u53ef\u4ee5\u901a\u8fc7\u4fee\u6539\u7eb9\u7406\u7684\u8fc7\u6ee4\u65b9\u5f0f\u6765\u63d0\u5347\u6587\u672c\u7684\u53ef\u8bfb\u6027\uff08\u5982\u679c\u9700\u8981\u6587\u672c\u7f29\u653e\u7684\u8bdd\u9700\u8981\u6ce8\u610f\u6b64\u4e8b\uff09\u3002 glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u4f46\u662f\u672c\u4f8b\u8fd8\u6ca1\u6709\u505a\u5b8c\u3002\u5982\u679c\u7528\u7f29\u653e\u4f7f\u6587\u672c\u4e0e\u7acb\u65b9\u4f53\u91cd\u53e0\u65f6\uff0c\u5c31\u4f1a\u770b\u5230\u5982\u4e0b\u6548\u679c\uff1a \u7ed8\u5236\u7684\u6587\u672c\u80cc\u666f\u4e0d\u900f\u660e\u3002\u4e3a\u4e86\u5b9e\u73b0\u80cc\u666f\u900f\u660e\uff0c\u6211\u4eec\u5fc5\u987b\u660e\u786e\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u4f7f\u7528Alpha\u5206\u91cf\u3002\u672c\u4f8b\u5c06\u5728 Window \u7c7b\u4e2d\u7528\u4e0b\u8ff0\u4ee3\u7801\u8bbe\u7f6e\u5176\u521d\u59cb\u5316\u53c2\u6570\uff1a // \u652f\u6301\u900f\u660e glEnable(GL_BLEND); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6587\u672c\u4ee5\u900f\u660e\u80cc\u666f\u7ed8\u5236\u4e86\u3002 \u5b8c\u5584HUD \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6e32\u67d3\u4e86\u4e00\u4e9b\u6587\u672c\uff0c\u4f46\u8fd8\u53ef\u4ee5\u5411HUD\u6dfb\u52a0\u66f4\u591a\u7684\u5143\u7d20\u3002\u672c\u4f8b\u5c06\u6dfb\u52a0\u4e00\u4e2a\u6839\u636e\u6444\u50cf\u673a\u671d\u5411\u65cb\u8f6c\u7684\u6307\u9488\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5411 Hud \u7c7b\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 GameItem \uff0c\u5b83\u5c06\u5305\u542b\u4e00\u4e2a\u6307\u9488\u7684\u6a21\u578b\u7f51\u683c\u3002 \u6307\u9488\u7684\u6a21\u578b\u662f.obj\u6587\u4ef6\uff0c\u4f46\u5b83\u4e0d\u4f1a\u5173\u8054\u4efb\u4f55\u7eb9\u7406\uff0c\u76f8\u53cd\uff0c\u5b83\u53ea\u6709\u4e00\u4e2a\u57fa\u7840\u8272\u3002\u6240\u4ee5\u9700\u8981\u4fee\u6539HUD\u7684\u7247\u5143\u7740\u8272\u5668\uff0c\u4ee5\u786e\u8ba4\u662f\u5426\u4f7f\u7528\u7eb9\u7406\u3002\u672c\u4f8b\u5c06\u901a\u8fc7\u8bbe\u7f6e\u4e00\u4e2a\u540d\u4e3a hasTexture \u7684\u65b0Uniform\u6765\u5b9e\u73b0\u5b83\u3002 #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; uniform int hasTexture; void main() { if ( hasTexture == 1 ) { fragColor = colour * texture(texture_sampler, outTexCoord); } else { fragColor = colour; } } \u8981\u5c06\u6307\u9488\u6dfb\u52a0\u5230HUD\u4e0a\uff0c\u53ea\u9700\u5728 Hud \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 GameItem \u5b9e\u4f8b\u3002\u5b83\u52a0\u8f7d\u6307\u9488\u6a21\u578b\uff0c\u5e76\u5c06\u5176\u6dfb\u52a0\u5230\u9879\u76ee\u5217\u8868\u4e2d\u3002\u5728\u672c\u4f8b\u4e2d\u9700\u8981\u653e\u5927\u6307\u9488\uff0c\u56e0\u4e3a\u5b83\u5728\u5c4f\u5e55\u5750\u6807\u7cfb\u4e2d\u6e32\u67d3\uff0c\u6240\u4ee5\u901a\u5e38\u4f60\u9700\u8981\u653e\u5927\u5b83\u3002 // \u521b\u5efa\u6307\u9488 Mesh mesh = OBJLoader.loadMesh(\"/models/compass.obj\"); Material material = new Material(); material.setAmbientColour(new Vector4f(1, 0, 0, 1)); mesh.setMaterial(material); compassItem = new GameItem(mesh); compassItem.setScale(40.0f); // \u65cb\u8f6c\u4ee5\u5c06\u5176\u53d8\u6362\u5230\u5c4f\u5e55\u5750\u6807\u7cfb compassItem.setRotation(0f, 0f, 180f); // \u521b\u5efa\u4e00\u4e2a\u6570\u7ec4\uff0c\u7528\u4e8e\u50a8\u5b58HUD\u9879\u76ee gameItems = new GameItem[]{statusTextItem, compassItem}; \u8fd8\u8981\u6ce8\u610f\uff0c\u4e3a\u4e86\u4f7f\u6307\u9488\u6307\u5411\u4e0a\u65b9\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u65cb\u8f6c180\u00b0\uff0c\u56e0\u4e3a\u6a21\u578b\u901a\u5e38\u503e\u5411\u4e8e\u4f7f\u7528OpenGL\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u5982\u679c\u6211\u4eec\u8981\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\uff0c\u5b83\u4f1a\u6307\u5411\u4e0b\u65b9\u3002 Hud \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u6765\u66f4\u65b0\u6307\u9488\u7684\u6307\u5411\uff0c\u8be5\u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8fd9\u4e00\u70b9\u3002 public void rotateCompass(float angle) { this.compassItem.setRotation(0, 0, 180 + angle); } \u5728 DummyGame \u7c7b\u4e2d\uff0c\u6bcf\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u6211\u4eec\u9700\u8981\u7528Y\u89d2\u65cb\u8f6c\u66f4\u65b0\u89d2\u5ea6\u3002 // \u6839\u636e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); // \u66f4\u65b0HUD\u6307\u9488 hud.rotateCompass(camera.getRotation().y); } \u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff08\u8bb0\u4f4f\u8fd9\u53ea\u662f\u4e2a\u793a\u4f8b\uff0c\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u4f60\u53ef\u80fd\u60f3\u4f7f\u7528\u4e00\u4e9b\u7eb9\u7406\u8bbe\u7f6e\u6307\u9488\u7684\u5916\u89c2\uff09\u3002 \u518d\u8c08\u6587\u672c\u6e32\u67d3 \u5728\u56de\u987e\u5176\u4ed6\u4e3b\u9898\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u518d\u8c08\u8c08\u4e4b\u524d\u4ecb\u7ecd\u7684\u6587\u672c\u6e32\u67d3\u65b9\u6cd5\u3002\u8be5\u65b9\u6848\u975e\u5e38\u7b80\u6d01\u5730\u4ecb\u7ecd\u4e86\u6e32\u67d3HUD\u6240\u6d89\u53ca\u7684\u6982\u5ff5\uff0c\u4f46\u5b83\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\uff1a \u5b83\u4e0d\u652f\u6301\u975e\u62c9\u4e01\u5b57\u7b26\u3002 \u5982\u679c\u4f60\u60f3\u4f7f\u7528\u591a\u79cd\u5b57\u4f53\uff0c\u5219\u9700\u8981\u4e3a\u6bcf\u79cd\u5b57\u4f53\u521b\u5efa\u5355\u72ec\u7684\u7eb9\u7406\u6587\u4ef6\u3002\u6b64\u5916\uff0c\u6539\u53d8\u6587\u672c\u5927\u5c0f\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u7f29\u653e\uff0c\u8fd9\u4f1a\u5bfc\u81f4\u6e32\u67d3\u6587\u672c\u7684\u8d28\u91cf\u8f83\u5dee\uff0c\u6216\u8005\u9700\u8981\u521b\u5efa\u989d\u5916\u7684\u7eb9\u7406\u6587\u4ef6\u3002 \u6700\u91cd\u8981\u7684\u662f\uff0c\u5927\u591a\u6570\u5b57\u4f53\u4e2d\u7684\u5b57\u7b26\u4e4b\u95f4\u7684\u5927\u5c0f\u5e76\u4e0d\u540c\uff0c\u800c\u6211\u4eec\u5c06\u5b57\u4f53\u7eb9\u7406\u5206\u5272\u6210\u540c\u6837\u5927\u5c0f\u7684\u5143\u7d20\u3002\u6211\u4eec\u4f7f\u7528\u4e86 Monospaced \u98ce\u683c\uff08\u5373\u6240\u6709\u5b57\u7b26\u5177\u6709\u76f8\u540c\u7684\u5bbd\u5ea6\uff09\u7684\u201cConsolas\u201d\u5b57\u4f53\uff0c\u4f46\u5982\u679c\u4f7f\u7528\u975eMonospaced\u7684\u5b57\u4f53\uff0c\u5c31\u4f1a\u770b\u5230\u5b57\u7b26\u4e4b\u95f4\u607c\u4eba\u7684\u7a7a\u767d\u3002 \u6211\u4eec\u9700\u8981\u66f4\u6539\u65b9\u6cd5\uff0c\u5e76\u63d0\u4f9b\u4e00\u79cd\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u6587\u672c\u65b9\u5f0f\u3002\u5982\u679c\u4f60\u4ed4\u7ec6\u60f3\u60f3\uff0c\u6574\u4f53\u60f3\u6cd5\u662f\u53ef\u884c\u7684\uff0c\u4e5f\u5c31\u662f\u901a\u8fc7\u5355\u72ec\u6e32\u67d3\u6bcf\u4e2a\u5b57\u7b26\u7684\u77e9\u5f62\u6765\u6e32\u67d3\u6587\u672c\u3002\u8fd9\u91cc\u7684\u95ee\u9898\u5c31\u662f\u8be5\u5982\u4f55\u751f\u6210\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u7cfb\u7edf\u4e2d\u53ef\u7528\u7684\u5b57\u4f53\u52a8\u6001\u5730\u751f\u6210\u8fd9\u4e9b\u7eb9\u7406\u3002 \u8fd9\u5c31\u9700\u8981 java.awt.Font \u51fa\u624b\u4e86\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u6307\u5b9a\u5b57\u4f53\u7cfb\u5217\u548c\u5927\u5c0f\u52a8\u6001\u5730\u7ed8\u5236\u6bcf\u4e00\u4e2a\u5b57\u7b26\u6765\u751f\u6210\u7eb9\u7406\u3002\u8be5\u7eb9\u7406\u7684\u4f7f\u7528\u65b9\u5f0f\u4e0e\u4e4b\u524d\u63cf\u8ff0\u7684\u76f8\u540c\uff0c\u4f46\u5b83\u5c06\u5b8c\u7f8e\u5730\u89e3\u51b3\u4e0a\u8ff0\u6240\u6709\u95ee\u9898\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FontTexture \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u63a5\u6536 Font \u5b9e\u4f8b\u548c\u5b57\u7b26\u96c6\u540d\u79f0\uff0c\u5e76\u5c06\u52a8\u6001\u5730\u521b\u5efa\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u7eb9\u7406\u3002\u6784\u9020\u51fd\u6570\u5982\u4e0b\u6240\u793a\uff1a public FontTexture(Font font, String charSetName) throws Exception { this.font = font; this.charSetName = charSetName; charMap = new HashMap<>(); buildTexture(); } \u9996\u5148\u8981\u5904\u7406\u975e\u62c9\u4e01\u5b57\u7b26\u95ee\u9898\u3002\u7ed9\u5b9a\u5b57\u7b26\u96c6\u548c\u5b57\u4f53\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u4e00\u4e2a\u5305\u542b\u6240\u6709\u53ef\u6e32\u67d3\u5b57\u7b26\u7684 String \u3002 private String getAllAvailableChars(String charsetName) { CharsetEncoder ce = Charset.forName(charsetName).newEncoder(); StringBuilder result = new StringBuilder(); for (char c = 0; c < Character.MAX_VALUE; c++) { if (ce.canEncode(c)) { result.append(c); } } return result.toString(); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5b9e\u9645\u521b\u5efa\u7eb9\u7406\u7684 buildTexture \u65b9\u6cd5\uff1a private void buildTexture() throws Exception { // \u4f7f\u7528FontMetrics\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u4fe1\u606f BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB); Graphics2D g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); FontMetrics fontMetrics = g2D.getFontMetrics(); String allChars = getAllAvailableChars(charSetName); this.width = 0; this.height = fontMetrics.getHeight(); for (char c : allChars.toCharArray()) { // \u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5927\u5c0f\uff0c\u5e76\u66f4\u65b0\u56fe\u50cf\u7684\u5927\u5c0f CharInfo charInfo = new CharInfo(width, fontMetrics.charWidth(c)); charMap.put(c, charInfo); width += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u9996\u5148\u901a\u8fc7\u521b\u5efa\u4e34\u65f6\u56fe\u50cf\u6765\u83b7\u5f97 FontMetrics \uff0c\u7136\u540e\u904d\u5386\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684 String \uff0c\u5e76\u5728 FontMetrics \u7684\u5e2e\u52a9\u4e0b\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5bbd\u5ea6\u3002\u6211\u4eec\u5c06\u8fd9\u4e9b\u4fe1\u606f\u50a8\u5b58\u5728\u4e00\u4e2a charMap \u6620\u5c04\u4e0a\uff0c\u4ee5\u5b57\u7b26\u4f5c\u4e3a\u6620\u5c04\u7684\u952e\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u786e\u5b9a\u4e86\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u56fe\u50cf\u7684\u9ad8\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u6700\u5927\u9ad8\u5ea6\uff0c\u800c\u5bbd\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u5bbd\u5ea6\u603b\u548c\uff09\u3002 ChatSet \u662f\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u50a8\u5b58\u6709\u5173\u5b57\u7b26\u7684\u4fe1\u606f\uff08\u5b83\u7684\u5bbd\u5ea6\u548c\u5b83\u5728\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u8d77\u70b9\uff09\u3002 public static class CharInfo { private final int startX; private final int width; public CharInfo(int startX, int width) { this.startX = startX; this.width = width; } public int getStartX() { return startX; } public int getWidth() { return width; } } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u56fe\u50cf\uff0c\u53ea\u9700\u5728 BufferedImage \u4e0a\u7ed8\u5236\u5b57\u7b26\u4e32\u5373\u53ef\u3002 // \u521b\u5efa\u4e0e\u5b57\u7b26\u96c6\u76f8\u5173\u7684\u56fe\u50cf img = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB); g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); fontMetrics = g2D.getFontMetrics(); g2D.setColor(Color.WHITE); int startX = 0; for (char c : allChars.toCharArray()) { CharInfo charInfo = charMap.get(c); g2D.drawString(\"\" + c, startX, fontMetrics.getAscent()); startX += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u6b63\u5728\u751f\u6210\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5b57\u7b26\u7684\u5355\u884c\u56fe\u50cf\uff08\u53ef\u80fd\u4e0d\u6ee1\u8db3\u7eb9\u7406\u5927\u5c0f\u5e94\u8be5\u4e3a\u4e8c\u7684\u5e42\u7684\u524d\u63d0\uff0c\u4f46\u662f\u5b83\u4ecd\u9002\u7528\u4e8e\u5927\u591a\u6570\u73b0\u4ee3\u663e\u5361\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u989d\u5916\u7684\u7a7a\u767d\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff09\u3002\u4f60\u4e5f\u53ef\u4ee5\u67e5\u770b\u751f\u6210\u7684\u56fe\u50cf\uff0c\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e4b\u540e\uff0c\u6dfb\u52a0\u4e0b\u8ff0\u7684\u4e00\u884c\u4ee3\u7801\uff1a ImageIO.write(img, IMAGE_FORMAT, new java.io.File(\"Temp.png\")); \u56fe\u50cf\u5c06\u88ab\u5199\u5165\u4e00\u4e2a\u4e34\u65f6\u6587\u4ef6\u3002\u8be5\u6587\u4ef6\u5c06\u5305\u542b\u4e00\u4e2a\u5728\u767d\u8272\u80cc\u666f\u4e0b\uff0c\u4f7f\u7528\u6297\u952f\u9f7f\u7ed8\u5236\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u957f\u6761\u3002 \u6700\u540e\u53ea\u9700\u8981\u4ece\u8be5\u56fe\u50cf\u521b\u5efa\u4e00\u4e2a Texture \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ea\u9700\u4f7f\u7528PNG\u683c\u5f0f\uff08\u8fd9\u5c31\u662f Texture \u7c7b\u6240\u671f\u671b\u7684\uff09\u8f6c\u50a8\u56fe\u50cf\u5b57\u8282\u3002 ByteBuffer buf = null; try ( ByteArrayOutputStream out = new ByteArrayOutputStream()) { ImageIO.write(img, IMAGE_FORMAT, out); out.flush(); byte[] data = out.toByteArray(); buf = ByteBuffer.allocateDirect(data.length); buf.put(data, 0, data.length); buf.flip(); } texture = new Texture(buf); } \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u5df2\u7ecf\u7a0d\u5fae\u4fee\u6539\u4e86 Texture \u7c7b\uff0c\u4f7f\u5176\u5177\u6709\u4e00\u4e2a\u63a5\u6536 ByteBuffer \u7684\u6784\u9020\u51fd\u6570\u3002\u5176\u4e2d\u8fd9\u4e2a\u65b0\u7684\u6784\u9020\u51fd\u6570\u4f7f\u7528 stbi_load_from_memory \u52a0\u8f7d\u56fe\u7247\u3002\u73b0\u5728\u6211\u4eec\u53ea\u9700\u66f4\u6539 TextItem \u7c7b\uff0c\u4ee5\u4fbf\u5728\u5176\u6784\u9020\u51fd\u6570\u4e2d\u63a5\u6536 FontTexture \u5b9e\u4f8b\u3002 public TextItem(String text, FontTexture fontTexture) throws Exception { super(); this.text = text; this.fontTexture = fontTexture; setMesh(buildMesh()); } \u53ea\u9700\u8981\u5728\u8bbe\u7f6e\u7247\u6bb5\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u65f6\u7a0d\u7a0d\u4fee\u6539 buildMesh \u65b9\u6cd5\uff0c\u4e0b\u8ff0\u4ee3\u7801\u662f\u5176\u4e2d\u4e00\u4e2a\u9876\u70b9\u7684\u793a\u4f8b\uff1a float startx = 0; for(int i=0; i<numChars; i++) { FontTexture.CharInfo charInfo = fontTexture.getCharInfo(characters[i]); // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u9876\u70b9 positions.add(startx); // x positions.add(0.0f); // y positions.add(ZPOS); // z textCoords.add( (float)charInfo.getStartX() / (float)fontTexture.getWidth()); textCoords.add(0.0f); indices.add(i*VERTICES_PER_QUAD); // \u66f4\u591a\u4ee3\u7801... startx += charInfo.getWidth(); } \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u5176\u4ed6\u66f4\u6539\u3002\u4e0b\u56fe\u662f\u4e00\u4e2a\u5927\u5c0f\u4e3a20\u7684Arial\u5b57\u4f53\u7684\u6e32\u67d3\u6548\u679c\uff1a \u5982\u4f60\u6240\u89c1\u6587\u672c\u6e32\u67d3\u7684\u8d28\u91cf\u5df2\u7ecf\u6709\u4e86\u5f88\u5927\u7684\u63d0\u5347\uff0c\u4f60\u53ef\u4ee5\u7528\u4e0d\u540c\u7684\u5b57\u4f53\u548c\u5927\u5c0f\u6765\u6e32\u67d3\u3002\u8fd9\u4ecd\u7136\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4(\u5982\u652f\u6301\u591a\u884c\u6587\u672c\u3001\u7279\u6548\u7b49)\uff0c\u4f46\u8fd9\u5c06\u7559\u7ed9\u5404\u4f4d\u8bfb\u8005\u4f5c\u4e3a\u7ec3\u4e60\u3002 \u4f60\u53ef\u80fd\u8fd8\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u4ecd\u7136\u80fd\u591f\u7f29\u653e\u6587\u672c\uff08\u901a\u8fc7\u7740\u8272\u5668\u4e2d\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002\u73b0\u5728\u7684\u6587\u672c\u53ef\u80fd\u4e0d\u9700\u8981\u7f29\u653e\uff0c\u4f46\u5bf9\u5176\u4ed6\u7684HUD\u5143\u7d20\u53ef\u80fd\u4f1a\u6709\u7528\u3002 \u6211\u4eec\u5df2\u7ecf\u786e\u7acb\u4e86\u6240\u6709\u7684\u57fa\u672c\u6570\u636e\u7ed3\u6784\uff0c\u4ee5\u4fbf\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\u3002\u73b0\u5728\uff0c\u53ea\u5269\u4e00\u4e2a\u95ee\u9898\uff0c\u90a3\u5c31\u662f\u521b\u5efa\u6240\u6709\u7684\u5143\u7d20\uff0c\u4f20\u9012\u76f8\u5173\u4fe1\u606f\u7ed9\u7528\u6237\uff0c\u5e76\u7ed9\u4ed6\u4eec\u4e00\u4e2a\u4e13\u4e1a\u7684\u5916\u89c2\u3002 OSX \u5982\u679c\u4f60\u8bd5\u56fe\u8fd0\u884c\u672c\u7ae0\u4e2d\u7684\u793a\u4f8b\uff0c\u4ee5\u53ca\u4e0b\u4e00\u4e2a\u6e32\u67d3\u6587\u672c\u7684\u793a\u4f8b\uff0c\u5219\u53ef\u80fd\u4f1a\u53d1\u73b0\u5e94\u7528\u7a0b\u5e8f\u963b\u585e\uff0c\u5c4f\u5e55\u4e0a\u4e0d\u4f1a\u663e\u793a\u4efb\u4f55\u5185\u5bb9\u3002\u8fd9\u662f\u7531\u4e8eAWT\u548cGLFW\u5728OSX\u4e0b\u76f8\u5904\u5f97\u4e0d\u592a\u597d\uff0c\u4f46\u8fd9\u548cAWT\u6709\u4ec0\u4e48\u5173\u7cfb\u5462\uff1f\u6211\u4eec\u4f7f\u7528\u7684\u662f Font \u7c7b\uff0c\u5b83\u5c5e\u4e8eAWT\uff0c\u5982\u679c\u8981\u5b9e\u4f8b\u5316\u5b83\uff0cAWT\u4e5f\u9700\u8981\u521d\u59cb\u5316\u3002\u5728OSX\u4e2d\uff0cAWT\u8bd5\u56fe\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u4f46GLFW\u4e5f\u9700\u8981\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u8fd9\u5c31\u662f\u9020\u6210\u6b64\u95ee\u9898\u7684\u539f\u56e0\u3002 \u4e3a\u4e86\u80fd\u591f\u4f7f\u7528 Font \u7c7b\uff0cGLFW\u5fc5\u987b\u5728AWT\u4e4b\u524d\u521d\u59cb\u5316\uff0c\u5e76\u4e14\u793a\u4f8b\u9700\u8981\u4ee5Headless\u6a21\u5f0f\u8fd0\u884c\u3002\u4f60\u9700\u8981\u5728\u4efb\u4f55\u4e1c\u897f\u88ab\u521d\u59cb\u5316\u4e4b\u524d\u8bbe\u7f6e\u6b64\u5c5e\u6027\uff1a System.setProperty(\"java.awt.headless\", \"true\"); \u4f60\u4e5f\u8bb8\u4f1a\u6536\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u4f46\u793a\u4f8b\u6210\u529f\u8fd0\u884c\u4e86\u3002 \u4e00\u4e2a\u66f4\u7b80\u6d01\u7684\u65b9\u6cd5\u662f\u4f7f\u7528 stb \u5e93\u6765\u6e32\u67d3\u6587\u672c\u3002","title":"\u6e38\u620fHUD"},{"location":"12-game-hud/#hudgame-hud","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\uff08Heads-Up Display\uff0c\u5e73\u89c6\u663e\u793a\u5668\uff09\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5c31\u662f\u4e00\u7ec4\u7528\u4e8e\u5728\u4e09\u7ef4\u573a\u666f\u4e0a\uff0c\u968f\u65f6\u663e\u793a\u76f8\u5173\u4fe1\u606f\u7684\u4e8c\u7ef4\u56fe\u5f62\u548c\u6587\u672c\u3002\u672c\u4f8b\u4e2d\u5c06\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684HUD\uff0c\u8fd9\u53ef\u4e3a\u6211\u4eec\u5c55\u73b0\u4e00\u4e9b\u663e\u793a\u4fe1\u606f\u7684\u57fa\u672c\u6280\u672f\u3002 \u5f53\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u65f6\uff0c\u8fd8\u5c06\u53d1\u73b0\u6211\u4eec\u5bf9\u6e90\u4ee3\u7801\u505a\u4e86\u4e00\u4e9b\u5c0f\u7684\u91cd\u6784\uff0c\u7279\u522b\u662f Renderer \u7c7b\uff0c\u4ee5\u4fbf\u4e3aHUD\u6e32\u67d3\u505a\u597d\u51c6\u5907\u3002","title":"\u6e38\u620fHUD\uff08Game HUD\uff09"},{"location":"12-game-hud/#_1","text":"\u521b\u5efaHUD\u6240\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6e32\u67d3\u6587\u672c\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u50a8\u5b58\u5b57\u7b26\u7684\u7eb9\u7406\u6620\u5c04\u5230\u4e00\u4e2a\u65b9\u5f62\u4e2d\uff0c\u8be5\u65b9\u5f62\u5c06\u88ab\u5206\u5272\u4e3a\u4e00\u7ec4\u8868\u793a\u6bcf\u4e2a\u5b57\u7b26\u7684\u7247\u6bb5\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u7eb9\u7406\u5728\u5c4f\u5e55\u4e0a\u7ed8\u5236\u6587\u672c\u3002\u6240\u4ee5\u9996\u5148\u521b\u5efa\u542b\u6709\u6240\u6709\u5b57\u6bcd\u7684\u7eb9\u7406\uff0c\u8fd9\u9879\u5de5\u4f5c\u53ef\u4ee5\u4f7f\u7528\u5f88\u591a\u8f6f\u4ef6\u6765\u505a\uff0c\u4f8b\u5982 CBFG \u3001 F2IBuilder \u7b49\u7b49\u3002\u672c\u4f8b\u4f7f\u7528Codehead\u7684\u4f4d\u56fe\u5b57\u4f53\u751f\u6210\u5668\uff08Codehead\u2019s Bitmap Font Generator\uff0cCBFG\uff09\u3002 CBFG\u5141\u8bb8\u4f60\u914d\u7f6e\u5f88\u591a\u9009\u9879\uff0c\u5982\u7eb9\u7406\u5927\u5c0f\u3001\u5b57\u4f53\u7c7b\u578b\u3001\u8981\u4f7f\u7528\u7684\u6297\u952f\u9f7f\u7b49\u7b49\u3002\u4e0b\u56fe\u662f\u672c\u4f8b\u5c06\u7528\u6765\u751f\u6210\u7eb9\u7406\u6587\u4ef6\u7684\u914d\u7f6e\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u6587\u672c\u7f16\u7801\u4e3aISO-8859-1\uff0c\u5982\u679c\u4f60\u9700\u8981\u5904\u7406\u5176\u4ed6\u7684\u5b57\u7b26\u96c6\uff0c\u5219\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u4ee3\u7801\u3002 \u5f53\u8bbe\u7f6e\u597dCBFG\u7684\u6240\u6709\u9009\u9879\u540e\uff0c\u53ef\u4ee5\u5c06\u5176\u5bfc\u51fa\u4e3a\u591a\u79cd\u56fe\u7247\u683c\u5f0f\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5176\u5bfc\u51fa\u4e3aBMP\u6587\u4ef6\uff0c\u7136\u540e\u518d\u8f6c\u6362\u4e3aPNG\u6587\u4ef6\uff0c\u4ee5\u4fbf\u5c06\u5176\u4f5c\u4e3a\u7eb9\u7406\u52a0\u8f7d\u3002\u5f53\u8f6c\u6362\u4e3aPNG\u683c\u5f0f\u65f6\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u5c06\u9ed1\u8272\u80cc\u666f\u8bbe\u7f6e\u4e3a\u900f\u660e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5c06\u9ed1\u8272\u8bbe\u4e3aAlpha\u503c\u7b49\u4e8e0\uff08\u53ef\u4ee5\u4f7f\u7528GIMP\u8fd9\u6837\u7684\u5de5\u5177\u6765\u5b9e\u73b0\uff09\u3002\u6700\u7ec8\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u56fe\u50cf\u4e2d\u7684\u6240\u6709\u5b57\u7b26\u90fd\u4ee5\u884c\u548c\u5217\u7684\u5f62\u5f0f\u6392\u5217\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u56fe\u50cf\u753115\u5217\u548c17\u884c\u5b57\u7b26\u7ec4\u6210\u3002\u901a\u8fc7\u4f7f\u7528\u7279\u5b9a\u5b57\u7b26\u7684\u7f16\u53f7\uff0c\u6211\u4eec\u53ef\u4ee5\u8ba1\u7b97\u5176\u5bf9\u5e94\u50a8\u5b58\u5728\u56fe\u50cf\u4e2d\u7684\u884c\u548c\u5217\u3002\u6240\u5728\u5217\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u5217\u6570 = \u5b57\u7b26\u7f16\u53f7 \\space mod \\space \u5217\u603b\u6570 \uff0c\u5176\u4e2d mod \u662f\u53d6\u4f59\u8fd0\u7b97\u7b26\uff0c\u6240\u5728\u884c\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u6240\u5728\u884c = \u5b57\u7b26\u7f16\u53f7 / \u884c\u603b\u6570 \u3002\u5728\u672c\u4f8b\u4e2d\u6211\u4eec\u5c06\u6574\u6570\u9664\u4ee5\u6574\u6570\uff0c\u4ee5\u4fbf\u5ffd\u7565\u5c0f\u6570\u90e8\u5206\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a TextItem \u7684\u65b0\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6e32\u67d3\u6587\u672c\u6240\u9700\u7684\u56fe\u5143\u3002\u8fd9\u662f\u4e00\u4e2a\u4e0d\u8003\u8651\u591a\u884c\u6587\u672c\u7684\u7b80\u5316\u5b9e\u73b0\uff0c\u4f46\u662f\u5b83\u80fd\u5728HUD\u4e2d\u663e\u793a\u6587\u672c\u4fe1\u606f\u3002\u4e0b\u5217\u4ee3\u7801\u662f\u8be5\u7c7b\u7684\u58f0\u660e\u4e0e\u6784\u9020\u51fd\u6570\uff1a package org.lwjglb.engine; import java.nio.charset.Charset; import java.util.ArrayList; import java.util.List; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; public class TextItem extends GameItem { private static final float ZPOS = 0.0f; private static final int VERTICES_PER_QUAD = 4; private String text; private final int numCols; private final int numRows; public TextItem(String text, String fontFileName, int numCols, int numRows) throws Exception { super(); this.text = text; this.numCols = numCols; this.numRows = numRows; Texture texture = new Texture(fontFileName); this.setMesh(buildMesh(texture, numCols, numRows)); } \u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u6539\u53d8\u5728\u5c4f\u5e55\u4e0a\u6587\u672c\u7684\u4f4d\u7f6e\uff0c\u4e5f\u53ef\u80fd\u9700\u8981\u7f29\u653e\u548c\u65cb\u8f6c\u5b83\u3002\u6784\u9020\u51fd\u6570\u63a5\u6536\u8981\u6e32\u67d3\u7684\u6587\u672c\u548c\u7528\u4e8e\u6e32\u67d3\u7684\u7eb9\u7406\u7684\u6587\u4ef6\u548c\u76f8\u5173\u6570\u636e\uff08\u50a8\u5b58\u56fe\u50cf\u7684\u6587\u4ef6\u53ca\u884c\u5217\u6570\uff09\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\uff0c\u5e76\u8c03\u7528\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u4e3a\u6587\u672c\u5efa\u6a21\u3002\u8ba9\u6211\u4eec\u770b\u5230 buildMesh \u65b9\u6cd5\uff1a private Mesh buildMesh(Texture texture, int numCols, int numRows) { byte[] chars = text.getBytes(Charset.forName(\"ISO-8859-1\")); int numChars = chars.length; List<Float> positions = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); float[] normals = new float[0]; List<Integer> indices = new ArrayList<>(); float tileWidth = (float)texture.getWidth() / (float)numCols; float tileHeight = (float)texture.getHeight() / (float)numRows; \u4ee3\u7801\u521b\u5efa\u4e86\u7528\u4e8e\u50a8\u5b58Mesh\u7684\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u7d22\u5f15\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u6211\u4eec\u4e0d\u4f7f\u7528\u5149\u7167\uff0c\u56e0\u6b64\u6cd5\u7ebf\u6570\u5217\u662f\u7a7a\u7684\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u7ec4\u5b57\u7b26\u7247\u6bb5\uff0c\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u4ee3\u8868\u4e00\u4e2a\u5b57\u7b26\u3002\u6211\u4eec\u8fd8\u9700\u8981\u6839\u636e\u6bcf\u4e2a\u7247\u6bb5\u5bf9\u5e94\u7684\u5b57\u7b26\u6765\u5206\u914d\u5bf9\u5e94\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u6587\u672c\u77e9\u5f62\u548c\u5b57\u7b26\u7247\u6bb5\u7684\u5173\u7cfb\uff1a \u56e0\u6b64\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u5b57\u7b26\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u6784\u6210\u7684\u5b57\u7b26\u7247\u6bb5\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u53ef\u4ee5\u7528\u56db\u4e2a\u9876\u70b9\uff08V1\u3001V2\u3001V3\u548cV4\uff09\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff08\u5de6\u4e0b\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(0, 1, 2)\uff0c\u800c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u53f3\u4e0a\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(3, 0, 2)\u3002\u7eb9\u7406\u5750\u6807\u662f\u57fa\u4e8e\u4e0e\u7eb9\u7406\u56fe\u50cf\u4e2d\u6bcf\u4e2a\u5b57\u7b26\u76f8\u5173\u7684\u884c\u5217\u8ba1\u7b97\u7684\uff0c\u7eb9\u7406\u5750\u6807\u7684\u8303\u56f4\u4e3a[0, 1]\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5f53\u524d\u884c\u6216\u5f53\u524d\u5217\u9664\u4ee5\u603b\u884c\u6570\u548c\u603b\u5217\u6570\u5c31\u53ef\u4ee5\u83b7\u5f97V1\u7684\u5750\u6807\u3002\u5bf9\u4e8e\u5176\u4ed6\u9876\u70b9\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9002\u5f53\u52a0\u4e0a\u884c\u5bbd\u6216\u5217\u5bbd\u5c31\u53ef\u4ee5\u5f97\u5230\u5bf9\u5e94\u5750\u6807\u3002 \u4e0b\u8ff0\u7684\u5faa\u73af\u8bed\u53e5\u5757\u521b\u5efa\u4e86\u4e0e\u6e32\u67d3\u6587\u672c\u77e9\u5f62\u76f8\u5173\u7684\u6240\u6709\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002 for(int i=0; i<numChars; i++) { byte currChar = chars[i]; int col = currChar % numCols; int row = currChar / numCols; // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD); // \u5de6\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 1); // \u53f3\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 2); // \u53f3\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 3); // \u6dfb\u52a0\u5de6\u4e0a\u89d2\u548c\u53f3\u4e0b\u89d2\u9876\u70b9\u7684\u7d22\u5f15 indices.add(i*VERTICES_PER_QUAD); indices.add(i*VERTICES_PER_QUAD + 2); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u9700\u8981\u6ce8\u610f\u7684\u4e00\u4e9b\u4e8b\u9879\uff1a \u6211\u4eec\u5c06\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u6765\u8868\u793a\u9876\u70b9\uff08\u8bb0\u4f4f\u5c4f\u5e55\u5750\u6807\u7cfb\u7684\u539f\u70b9\u4f4d\u4e8e\u5c4f\u5e55\u5de6\u4e0a\u89d2\uff09\u3002\u4e09\u89d2\u5f62\u4e0a\u9876\u70b9\u7684Y\u5750\u6807\u5c0f\u4e8e\u4e09\u89d2\u5f62\u4e0b\u9876\u70b9\u7684Y\u5750\u6807\u3002 \u6211\u4eec\u4e0d\u7f29\u653e\u56fe\u5f62\uff0c\u56e0\u6b64\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u7684X\u8ddd\u79bb\u5c31\u7b49\u4e8e\u5b57\u7b26\u5bbd\u5ea6\uff0c\u4e09\u89d2\u5f62\u7684\u9ad8\u5ea6\u5c31\u662f\u6bcf\u4e2a\u5b57\u7b26\u7684\u9ad8\u5ea6\u3002\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u5c3d\u53ef\u80fd\u5730\u4f7f\u6e32\u67d3\u6587\u672c\u4e0e\u539f\u59cb\u7eb9\u7406\u76f8\u4f3c\uff08\u4e0d\u7ba1\u600e\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u7a0d\u540e\u7f29\u653e\u5b83\uff0c\u56e0\u4e3a TextItem \u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff09\u3002 Z\u5750\u6807\u4e3a\u56fa\u5b9a\u503c\uff0c\u56e0\u4e3a\u5b83\u4e0e\u7ed8\u5236\u8be5\u56fe\u50cf\u65e0\u5173\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e9b\u9876\u70b9\u7684\u5750\u6807\uff1a \u4e3a\u4ec0\u4e48\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u7cfb\uff1f\u9996\u5148\uff0c\u56e0\u4e3a\u672c\u4f8b\u5c06\u5728HUD\u4e2d\u6e32\u67d32D\u5bf9\u8c61\uff0c\u5e76\u4e14\u901a\u5e38\u8fd9\u6837\u4f7f\u7528\u5b83\u4eec\u66f4\u65b9\u4fbf\u3002\u5176\u6b21\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u7ed8\u5236\u5b83\u4eec\uff0c\u7a0d\u540e\u518d\u89e3\u91ca\u4ec0\u4e48\u662f\u6b63\u4ea4\u6295\u5f71\u3002 TextItem \u7c7b\u6700\u540e\u8fd8\u9700\u6dfb\u52a0\u4e00\u4e9b\u65b9\u6cd5\uff0c\u4ee5\u83b7\u53d6\u6587\u672c\u5e76\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u6587\u672c\u3002\u6bcf\u5f53\u6587\u672c\u88ab\u66f4\u6539\u65f6\uff0c\u9700\u8981\u6e05\u7406\u6b64\u524d\u7684VAO\uff08\u50a8\u5b58\u5728 Mesh \u5b9e\u4f8b\u4e2d\uff09\u5e76\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VAO\u3002\u6211\u4eec\u4e0d\u9700\u8981\u5220\u9664\u7eb9\u7406\uff0c\u6240\u4ee5\u5728 Mesh \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u5220\u9664\u8fd9\u4e9b\u6570\u636e\u3002 public String getText() { return text; } public void setText(String text) { this.text = text; Texture texture = this.getMesh().getMaterial().getTexture(); this.getMesh().deleteBuffers(); this.setMesh(buildMesh(texture, numCols, numRows)); } \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u5efa\u7acb\u4e86\u6e32\u67d3\u6587\u672c\u6240\u9700\u8981\u7684\u57fa\u7840\u7ed3\u6784\uff0c\u63a5\u4e0b\u6765\u8be5\u600e\u4e48\u505a\u5462\uff1f\u9996\u5148\u5982\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\uff0c\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\uff0c\u7136\u540e\u5728\u5176\u4e0a\u6e32\u67d3\u4e8c\u7ef4\u7684HUD\u3002\u4e3a\u4e86\u6e32\u67d3HUD\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08\u4e5f\u79f0\u4e3a\u6b63\u4ea4\u6295\u5f71\uff09\u3002\u6b63\u4ea4\u6295\u5f71\u662f\u4e09\u7ef4\u7269\u4f53\u7684\u4e00\u79cd\u4e8c\u7ef4\u8868\u793a\u65b9\u5f0f\uff0c\u4f60\u53ef\u80fd\u5df2\u7ecf\u5728\u4e09\u7ef4\u6a21\u578b\u7684\u84dd\u56fe\u4e2d\u770b\u5230\u4e86\u4e00\u4e9b\u4f8b\u5b50\uff0c\u5b83\u4eec\u7528\u6765\u8868\u793a\u67d0\u4e9b\u7269\u4f53\u4ece\u9876\u90e8\u6216\u67d0\u4e9b\u4fa7\u9762\u770b\u5230\u7684\u6837\u5b50\u3002\u4e0b\u56fe\u662f\u5706\u67f1\u4f53\u4ece\u9876\u90e8\u548c\u524d\u9762\u7684\u6b63\u4ea4\u6295\u5f71\uff1a \u8fd9\u79cd\u6295\u5f71\u5bf9\u4e8e\u7ed8\u5236\u4e8c\u7ef4\u7269\u4f53\u662f\u975e\u5e38\u65b9\u4fbf\u7684\uff0c\u56e0\u4e3a\u5b83\u201c\u5ffd\u7565\u201d\u4e86Z\u5750\u6807\u7684\u503c\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5ffd\u7565\u4e86\u5230\u5c4f\u5e55\u7684\u8ddd\u79bb\u3002\u4f7f\u7528\u8fd9\u79cd\u6295\u5f71\uff0c\u7269\u4f53\u5927\u5c0f\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u7684\u589e\u5927\u800c\u51cf\u5c0f\uff08\u4e0d\u540c\u4e8e\u900f\u89c6\u6295\u5f71\uff09\u3002\u4e3a\u4e86\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u6295\u5f71\u7269\u4f53\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u516c\u5f0f\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u4e2a\u77e9\u9635\u8fd8\u77eb\u6b63\u4e86\u5931\u771f\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7a97\u53e3\u5e76\u4e0d\u603b\u662f\u5b8c\u7f8e\u7684\u6b63\u65b9\u5f62\uff0c\u800c\u662f\u4e00\u4e2a\u77e9\u5f62\u3002 right \u548c bottom \u662f\u5c4f\u5e55\u5927\u5c0f\uff0c\u800c left \u548c top \u662f\u539f\u70b9\u5750\u6807\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7528\u4e8e\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u8be5\u6295\u5f71\u7684\u6620\u5c04\u8fc7\u7a0b\uff1a \u8be5\u77e9\u9635\u5c06\u5141\u8bb8\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7ee7\u7eed\u5b9e\u73b0HUD\u4e86\u3002\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u521b\u5efa\u53e6\u4e00\u7ec4\u7740\u8272\u5668\uff0c\u4e00\u4e2a\u9876\u70b9\u7740\u8272\u5668\u548c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\uff0c\u6765\u7ed8\u5236HUD\u3002\u9876\u70b9\u7740\u8272\u5668\u5f88\u7b80\u5355\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 projModelMatrix; void main() { gl_Position = projModelMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5b83\u4ec5\u63a5\u6536\u9876\u70b9\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u6cd5\u7ebf\uff0c\u5e76\u5c06\u4f7f\u7528\u77e9\u9635\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\uff0c\u8be5\u77e9\u9635\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u7684\u4e58\u79ef\uff0c\u5373 projModelMatrix = \u6b63\u4ea4\u6295\u5f71\u77e9\u9635 \\cdot \u6a21\u578b\u77e9\u9635 \u3002\u7531\u4e8e\u6211\u4eec\u6ca1\u6709\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\u5bf9\u5750\u6807\u505a\u4efb\u4f55\u5904\u7406\uff0c\u6240\u4ee5\u5728Java\u4ee3\u7801\u4e2d\u5c06\u4e24\u4e2a\u77e9\u9635\u76f8\u4e58\u6bd4\u5728\u7740\u8272\u5668\u4e2d\u76f8\u4e58\u66f4\u9ad8\u6548\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u9879\u76ee\u505a\u4e00\u6b21\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\uff0c\u800c\u4e0d\u662f\u4e3a\u6bcf\u4e2a\u9876\u70b9\u505a\u4e00\u6b21\u3002\u8fd8\u5e94\u8bb0\u4f4f\u9876\u70b9\u5e94\u8be5\u7528\u5c4f\u5e55\u5750\u6807\u8868\u793a\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; void main() { fragColor = colour * texture(texture_sampler, outTexCoord); } \u5b83\u53ea\u662f\u5c06\u57fa\u672c\u989c\u8272\u4e0e\u7eb9\u7406\u989c\u8272\u76f8\u4e58\uff0c\u8fd9\u6837\u53ef\u4ee5\u6539\u53d8\u6e32\u67d3\u6587\u672c\u7684\u989c\u8272\uff0c\u800c\u4e0d\u9700\u8981\u521b\u5efa\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u73b0\u5728\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u7ec4\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IHud \u7684\u63a5\u53e3\uff0c\u8be5\u63a5\u53e3\u50a8\u5b58\u6240\u6709\u8981\u5728HUD\u4e0a\u663e\u793a\u7684\u5143\u7d20\uff0c\u5e76\u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u7684 cleanup \u65b9\u6cd5\u3002 package org.lwjglb.engine; public interface IHud { GameItem[] getGameItems(); default void cleanup() { GameItem[] gameItems = getGameItems(); for (GameItem gameItem : gameItems) { gameItem.getMesh().cleanUp(); } } } \u901a\u8fc7\u8be5\u63a5\u53e3\uff0c\u4e0d\u540c\u7684\u6e38\u620f\u53ef\u4ee5\u5b9a\u4e49\u81ea\u5b9a\u4e49\u7684HUD\uff0c\u800c\u4e0d\u9700\u8981\u6539\u53d8\u6e32\u67d3\u673a\u5236\u3002\u73b0\u5728\u56de\u5230 Renderer \u7c7b\uff0c\u987a\u4fbf\u4e00\u63d0\uff0c\u5b83\u5df2\u7ecf\u88ab\u79fb\u52a8\u5230 engine.graph \u5305\u4e0b\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u7684\u901a\u7528\u6027\u8db3\u4ee5\u4e0d\u4f9d\u8d56\u4efb\u4f55\u6e38\u620f\u7684\u5177\u4f53\u5b9e\u73b0\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u521b\u5efa\u3001\u8fde\u63a5\u548c\u521d\u59cb\u5316\u4e00\u4e2a\u65b0\u7684 ShaderProgram \uff0c\u4ee5\u4fbf\u4f7f\u7528\u4e0a\u8ff0\u6240\u793a\u7684\u7740\u8272\u5668\u3002 private void setupHudShader() throws Exception { hudShaderProgram = new ShaderProgram(); hudShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/hud_vertex.vs\")); hudShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/hud_fragment.fs\")); hudShaderProgram.link(); // \u4e3a\u6b63\u4ea4\u6295\u5f71\u6a21\u578b\u77e9\u9635\u548c\u989c\u8272\u521b\u5efaUniform hudShaderProgram.createUniform(\"projModelMatrix\"); hudShaderProgram.createUniform(\"colour\"); } render \u65b9\u6cd5\u9996\u5148\u4f1a\u8c03\u7528 renderScene \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\u7684\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u4ee3\u7801\uff0c\u7136\u540e\u8c03\u7528\u4e00\u4e2a\u540d\u4e3a renderHud \u7684\u65b0\u65b9\u6cd5\uff0c\u7528\u4e8e\u6e32\u67d3HUD\u3002 public void render(Window window, Camera camera, GameItem[] gameItems, SceneLight sceneLight, IHud hud) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } renderScene(window, camera, gameItems, sceneLight); renderHud(window, hud); } renderHud \u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\uff1a private void renderHud(Window window, IHud hud) { hudShaderProgram.bind(); Matrix4f ortho = transformation.getOrthoProjectionMatrix(0, window.getWidth(), window.getHeight(), 0); for (GameItem gameItem : hud.getGameItems()) { Mesh mesh = gameItem.getMesh(); // HUD\u5143\u7d20\u7684\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58 Matrix4f projModelMatrix = transformation.getOrtoProjModelMatrix(gameItem, ortho); hudShaderProgram.setUniform(\"projModelMatrix\", projModelMatrix); hudShaderProgram.setUniform(\"colour\", gameItem.getMesh().getMaterial().getAmbientColour()); // \u6e32\u67d3\u6b64HUD\u9879\u76ee\u7684\u7f51\u683c mesh.render(); } hudShaderProgram.unbind(); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u904d\u5386\u4e86HUD\u7684\u6240\u6709\u5143\u7d20\uff0c\u5e76\u5c06\u4e0e\u6bcf\u4e2a\u5143\u7d20\u5173\u8054\u7684\u6a21\u578b\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u76f8\u4e58\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5728\u6bcf\u6b21 render \u8c03\u7528\u65f6\u88ab\u5237\u65b0\uff08\u56e0\u4e3a\u5c4f\u5e55\u5927\u5c0f\u53ef\u4ee5\u88ab\u6539\u53d8\uff09\uff0c\u5e76\u4e14\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a public final Matrix4f getOrthoProjectionMatrix(float left, float right, float bottom, float top) { orthoMatrix.identity(); orthoMatrix.setOrtho2D(left, right, bottom, top); return orthoMatrix; } \u6211\u4eec\u5c06\u5728 game \u5305\u4e2d\u521b\u5efa\u4e00\u4e2a Hud \u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86 IHud \u63a5\u53e3\uff0c\u5e76\u5728\u6784\u9020\u51fd\u6570\u63a5\u6536\u4e00\u4e2a\u6587\u672c\uff0c\u7528\u4e8e\u5728\u5176\u4e2d\u521b\u5efa TextItem \u5b9e\u4f8b\u3002 package org.lwjglb.game; import org.joml.Vector4f; import org.lwjglb.engine.GameItem; import org.lwjglb.engine.IHud; import org.lwjglb.engine.TextItem; public class Hud implements IHud { private static final int FONT_COLS = 15; private static final int FONT_ROWS = 17; private static final String FONT_TEXTURE = \"textures/font_texture.png\"; private final GameItem[] gameItems; private final TextItem statusTextItem; public Hud(String statusText) throws Exception { this.statusTextItem = new TextItem(statusText, FONT_TEXTURE, FONT_COLS, FONT_ROWS); this.statusTextItem.getMesh().getMaterial().setColour(new Vector4f(1, 1, 1, 1)); gameItems = new GameItem[]{statusTextItem}; } public void setStatusText(String statusText) { this.statusTextItem.setText(statusText); } @Override public GameItem[] getGameItems() { return gameItems; } public void updateSize(Window window) { this.statusTextItem.setPosition(10f, window.getHeight() - 50f, 0); } } \u5728 DummyGame \u7c7b\u4e2d\u6211\u4eec\u521b\u5efa\u8be5\u7c7b\u7684\u5b9e\u4f8b\uff0c\u5e76\u7528\u9ed8\u8ba4\u6587\u672c\u521d\u59cb\u5316\u5b83\uff0c\u6700\u540e\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\uff1a \u5728 Texture \u7c7b\u4e2d\u53ef\u4ee5\u901a\u8fc7\u4fee\u6539\u7eb9\u7406\u7684\u8fc7\u6ee4\u65b9\u5f0f\u6765\u63d0\u5347\u6587\u672c\u7684\u53ef\u8bfb\u6027\uff08\u5982\u679c\u9700\u8981\u6587\u672c\u7f29\u653e\u7684\u8bdd\u9700\u8981\u6ce8\u610f\u6b64\u4e8b\uff09\u3002 glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u4f46\u662f\u672c\u4f8b\u8fd8\u6ca1\u6709\u505a\u5b8c\u3002\u5982\u679c\u7528\u7f29\u653e\u4f7f\u6587\u672c\u4e0e\u7acb\u65b9\u4f53\u91cd\u53e0\u65f6\uff0c\u5c31\u4f1a\u770b\u5230\u5982\u4e0b\u6548\u679c\uff1a \u7ed8\u5236\u7684\u6587\u672c\u80cc\u666f\u4e0d\u900f\u660e\u3002\u4e3a\u4e86\u5b9e\u73b0\u80cc\u666f\u900f\u660e\uff0c\u6211\u4eec\u5fc5\u987b\u660e\u786e\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u4f7f\u7528Alpha\u5206\u91cf\u3002\u672c\u4f8b\u5c06\u5728 Window \u7c7b\u4e2d\u7528\u4e0b\u8ff0\u4ee3\u7801\u8bbe\u7f6e\u5176\u521d\u59cb\u5316\u53c2\u6570\uff1a // \u652f\u6301\u900f\u660e glEnable(GL_BLEND); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6587\u672c\u4ee5\u900f\u660e\u80cc\u666f\u7ed8\u5236\u4e86\u3002","title":"\u6587\u672c\u6e32\u67d3"},{"location":"12-game-hud/#hud","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6e32\u67d3\u4e86\u4e00\u4e9b\u6587\u672c\uff0c\u4f46\u8fd8\u53ef\u4ee5\u5411HUD\u6dfb\u52a0\u66f4\u591a\u7684\u5143\u7d20\u3002\u672c\u4f8b\u5c06\u6dfb\u52a0\u4e00\u4e2a\u6839\u636e\u6444\u50cf\u673a\u671d\u5411\u65cb\u8f6c\u7684\u6307\u9488\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5411 Hud \u7c7b\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 GameItem \uff0c\u5b83\u5c06\u5305\u542b\u4e00\u4e2a\u6307\u9488\u7684\u6a21\u578b\u7f51\u683c\u3002 \u6307\u9488\u7684\u6a21\u578b\u662f.obj\u6587\u4ef6\uff0c\u4f46\u5b83\u4e0d\u4f1a\u5173\u8054\u4efb\u4f55\u7eb9\u7406\uff0c\u76f8\u53cd\uff0c\u5b83\u53ea\u6709\u4e00\u4e2a\u57fa\u7840\u8272\u3002\u6240\u4ee5\u9700\u8981\u4fee\u6539HUD\u7684\u7247\u5143\u7740\u8272\u5668\uff0c\u4ee5\u786e\u8ba4\u662f\u5426\u4f7f\u7528\u7eb9\u7406\u3002\u672c\u4f8b\u5c06\u901a\u8fc7\u8bbe\u7f6e\u4e00\u4e2a\u540d\u4e3a hasTexture \u7684\u65b0Uniform\u6765\u5b9e\u73b0\u5b83\u3002 #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; uniform int hasTexture; void main() { if ( hasTexture == 1 ) { fragColor = colour * texture(texture_sampler, outTexCoord); } else { fragColor = colour; } } \u8981\u5c06\u6307\u9488\u6dfb\u52a0\u5230HUD\u4e0a\uff0c\u53ea\u9700\u5728 Hud \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 GameItem \u5b9e\u4f8b\u3002\u5b83\u52a0\u8f7d\u6307\u9488\u6a21\u578b\uff0c\u5e76\u5c06\u5176\u6dfb\u52a0\u5230\u9879\u76ee\u5217\u8868\u4e2d\u3002\u5728\u672c\u4f8b\u4e2d\u9700\u8981\u653e\u5927\u6307\u9488\uff0c\u56e0\u4e3a\u5b83\u5728\u5c4f\u5e55\u5750\u6807\u7cfb\u4e2d\u6e32\u67d3\uff0c\u6240\u4ee5\u901a\u5e38\u4f60\u9700\u8981\u653e\u5927\u5b83\u3002 // \u521b\u5efa\u6307\u9488 Mesh mesh = OBJLoader.loadMesh(\"/models/compass.obj\"); Material material = new Material(); material.setAmbientColour(new Vector4f(1, 0, 0, 1)); mesh.setMaterial(material); compassItem = new GameItem(mesh); compassItem.setScale(40.0f); // \u65cb\u8f6c\u4ee5\u5c06\u5176\u53d8\u6362\u5230\u5c4f\u5e55\u5750\u6807\u7cfb compassItem.setRotation(0f, 0f, 180f); // \u521b\u5efa\u4e00\u4e2a\u6570\u7ec4\uff0c\u7528\u4e8e\u50a8\u5b58HUD\u9879\u76ee gameItems = new GameItem[]{statusTextItem, compassItem}; \u8fd8\u8981\u6ce8\u610f\uff0c\u4e3a\u4e86\u4f7f\u6307\u9488\u6307\u5411\u4e0a\u65b9\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u65cb\u8f6c180\u00b0\uff0c\u56e0\u4e3a\u6a21\u578b\u901a\u5e38\u503e\u5411\u4e8e\u4f7f\u7528OpenGL\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u5982\u679c\u6211\u4eec\u8981\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\uff0c\u5b83\u4f1a\u6307\u5411\u4e0b\u65b9\u3002 Hud \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u6765\u66f4\u65b0\u6307\u9488\u7684\u6307\u5411\uff0c\u8be5\u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8fd9\u4e00\u70b9\u3002 public void rotateCompass(float angle) { this.compassItem.setRotation(0, 0, 180 + angle); } \u5728 DummyGame \u7c7b\u4e2d\uff0c\u6bcf\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u6211\u4eec\u9700\u8981\u7528Y\u89d2\u65cb\u8f6c\u66f4\u65b0\u89d2\u5ea6\u3002 // \u6839\u636e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); // \u66f4\u65b0HUD\u6307\u9488 hud.rotateCompass(camera.getRotation().y); } \u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff08\u8bb0\u4f4f\u8fd9\u53ea\u662f\u4e2a\u793a\u4f8b\uff0c\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u4f60\u53ef\u80fd\u60f3\u4f7f\u7528\u4e00\u4e9b\u7eb9\u7406\u8bbe\u7f6e\u6307\u9488\u7684\u5916\u89c2\uff09\u3002","title":"\u5b8c\u5584HUD"},{"location":"12-game-hud/#_2","text":"\u5728\u56de\u987e\u5176\u4ed6\u4e3b\u9898\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u518d\u8c08\u8c08\u4e4b\u524d\u4ecb\u7ecd\u7684\u6587\u672c\u6e32\u67d3\u65b9\u6cd5\u3002\u8be5\u65b9\u6848\u975e\u5e38\u7b80\u6d01\u5730\u4ecb\u7ecd\u4e86\u6e32\u67d3HUD\u6240\u6d89\u53ca\u7684\u6982\u5ff5\uff0c\u4f46\u5b83\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\uff1a \u5b83\u4e0d\u652f\u6301\u975e\u62c9\u4e01\u5b57\u7b26\u3002 \u5982\u679c\u4f60\u60f3\u4f7f\u7528\u591a\u79cd\u5b57\u4f53\uff0c\u5219\u9700\u8981\u4e3a\u6bcf\u79cd\u5b57\u4f53\u521b\u5efa\u5355\u72ec\u7684\u7eb9\u7406\u6587\u4ef6\u3002\u6b64\u5916\uff0c\u6539\u53d8\u6587\u672c\u5927\u5c0f\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u7f29\u653e\uff0c\u8fd9\u4f1a\u5bfc\u81f4\u6e32\u67d3\u6587\u672c\u7684\u8d28\u91cf\u8f83\u5dee\uff0c\u6216\u8005\u9700\u8981\u521b\u5efa\u989d\u5916\u7684\u7eb9\u7406\u6587\u4ef6\u3002 \u6700\u91cd\u8981\u7684\u662f\uff0c\u5927\u591a\u6570\u5b57\u4f53\u4e2d\u7684\u5b57\u7b26\u4e4b\u95f4\u7684\u5927\u5c0f\u5e76\u4e0d\u540c\uff0c\u800c\u6211\u4eec\u5c06\u5b57\u4f53\u7eb9\u7406\u5206\u5272\u6210\u540c\u6837\u5927\u5c0f\u7684\u5143\u7d20\u3002\u6211\u4eec\u4f7f\u7528\u4e86 Monospaced \u98ce\u683c\uff08\u5373\u6240\u6709\u5b57\u7b26\u5177\u6709\u76f8\u540c\u7684\u5bbd\u5ea6\uff09\u7684\u201cConsolas\u201d\u5b57\u4f53\uff0c\u4f46\u5982\u679c\u4f7f\u7528\u975eMonospaced\u7684\u5b57\u4f53\uff0c\u5c31\u4f1a\u770b\u5230\u5b57\u7b26\u4e4b\u95f4\u607c\u4eba\u7684\u7a7a\u767d\u3002 \u6211\u4eec\u9700\u8981\u66f4\u6539\u65b9\u6cd5\uff0c\u5e76\u63d0\u4f9b\u4e00\u79cd\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u6587\u672c\u65b9\u5f0f\u3002\u5982\u679c\u4f60\u4ed4\u7ec6\u60f3\u60f3\uff0c\u6574\u4f53\u60f3\u6cd5\u662f\u53ef\u884c\u7684\uff0c\u4e5f\u5c31\u662f\u901a\u8fc7\u5355\u72ec\u6e32\u67d3\u6bcf\u4e2a\u5b57\u7b26\u7684\u77e9\u5f62\u6765\u6e32\u67d3\u6587\u672c\u3002\u8fd9\u91cc\u7684\u95ee\u9898\u5c31\u662f\u8be5\u5982\u4f55\u751f\u6210\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u7cfb\u7edf\u4e2d\u53ef\u7528\u7684\u5b57\u4f53\u52a8\u6001\u5730\u751f\u6210\u8fd9\u4e9b\u7eb9\u7406\u3002 \u8fd9\u5c31\u9700\u8981 java.awt.Font \u51fa\u624b\u4e86\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u6307\u5b9a\u5b57\u4f53\u7cfb\u5217\u548c\u5927\u5c0f\u52a8\u6001\u5730\u7ed8\u5236\u6bcf\u4e00\u4e2a\u5b57\u7b26\u6765\u751f\u6210\u7eb9\u7406\u3002\u8be5\u7eb9\u7406\u7684\u4f7f\u7528\u65b9\u5f0f\u4e0e\u4e4b\u524d\u63cf\u8ff0\u7684\u76f8\u540c\uff0c\u4f46\u5b83\u5c06\u5b8c\u7f8e\u5730\u89e3\u51b3\u4e0a\u8ff0\u6240\u6709\u95ee\u9898\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FontTexture \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u63a5\u6536 Font \u5b9e\u4f8b\u548c\u5b57\u7b26\u96c6\u540d\u79f0\uff0c\u5e76\u5c06\u52a8\u6001\u5730\u521b\u5efa\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u7eb9\u7406\u3002\u6784\u9020\u51fd\u6570\u5982\u4e0b\u6240\u793a\uff1a public FontTexture(Font font, String charSetName) throws Exception { this.font = font; this.charSetName = charSetName; charMap = new HashMap<>(); buildTexture(); } \u9996\u5148\u8981\u5904\u7406\u975e\u62c9\u4e01\u5b57\u7b26\u95ee\u9898\u3002\u7ed9\u5b9a\u5b57\u7b26\u96c6\u548c\u5b57\u4f53\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u4e00\u4e2a\u5305\u542b\u6240\u6709\u53ef\u6e32\u67d3\u5b57\u7b26\u7684 String \u3002 private String getAllAvailableChars(String charsetName) { CharsetEncoder ce = Charset.forName(charsetName).newEncoder(); StringBuilder result = new StringBuilder(); for (char c = 0; c < Character.MAX_VALUE; c++) { if (ce.canEncode(c)) { result.append(c); } } return result.toString(); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5b9e\u9645\u521b\u5efa\u7eb9\u7406\u7684 buildTexture \u65b9\u6cd5\uff1a private void buildTexture() throws Exception { // \u4f7f\u7528FontMetrics\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u4fe1\u606f BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB); Graphics2D g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); FontMetrics fontMetrics = g2D.getFontMetrics(); String allChars = getAllAvailableChars(charSetName); this.width = 0; this.height = fontMetrics.getHeight(); for (char c : allChars.toCharArray()) { // \u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5927\u5c0f\uff0c\u5e76\u66f4\u65b0\u56fe\u50cf\u7684\u5927\u5c0f CharInfo charInfo = new CharInfo(width, fontMetrics.charWidth(c)); charMap.put(c, charInfo); width += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u9996\u5148\u901a\u8fc7\u521b\u5efa\u4e34\u65f6\u56fe\u50cf\u6765\u83b7\u5f97 FontMetrics \uff0c\u7136\u540e\u904d\u5386\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684 String \uff0c\u5e76\u5728 FontMetrics \u7684\u5e2e\u52a9\u4e0b\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5bbd\u5ea6\u3002\u6211\u4eec\u5c06\u8fd9\u4e9b\u4fe1\u606f\u50a8\u5b58\u5728\u4e00\u4e2a charMap \u6620\u5c04\u4e0a\uff0c\u4ee5\u5b57\u7b26\u4f5c\u4e3a\u6620\u5c04\u7684\u952e\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u786e\u5b9a\u4e86\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u56fe\u50cf\u7684\u9ad8\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u6700\u5927\u9ad8\u5ea6\uff0c\u800c\u5bbd\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u5bbd\u5ea6\u603b\u548c\uff09\u3002 ChatSet \u662f\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u50a8\u5b58\u6709\u5173\u5b57\u7b26\u7684\u4fe1\u606f\uff08\u5b83\u7684\u5bbd\u5ea6\u548c\u5b83\u5728\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u8d77\u70b9\uff09\u3002 public static class CharInfo { private final int startX; private final int width; public CharInfo(int startX, int width) { this.startX = startX; this.width = width; } public int getStartX() { return startX; } public int getWidth() { return width; } } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u56fe\u50cf\uff0c\u53ea\u9700\u5728 BufferedImage \u4e0a\u7ed8\u5236\u5b57\u7b26\u4e32\u5373\u53ef\u3002 // \u521b\u5efa\u4e0e\u5b57\u7b26\u96c6\u76f8\u5173\u7684\u56fe\u50cf img = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB); g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); fontMetrics = g2D.getFontMetrics(); g2D.setColor(Color.WHITE); int startX = 0; for (char c : allChars.toCharArray()) { CharInfo charInfo = charMap.get(c); g2D.drawString(\"\" + c, startX, fontMetrics.getAscent()); startX += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u6b63\u5728\u751f\u6210\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5b57\u7b26\u7684\u5355\u884c\u56fe\u50cf\uff08\u53ef\u80fd\u4e0d\u6ee1\u8db3\u7eb9\u7406\u5927\u5c0f\u5e94\u8be5\u4e3a\u4e8c\u7684\u5e42\u7684\u524d\u63d0\uff0c\u4f46\u662f\u5b83\u4ecd\u9002\u7528\u4e8e\u5927\u591a\u6570\u73b0\u4ee3\u663e\u5361\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u989d\u5916\u7684\u7a7a\u767d\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff09\u3002\u4f60\u4e5f\u53ef\u4ee5\u67e5\u770b\u751f\u6210\u7684\u56fe\u50cf\uff0c\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e4b\u540e\uff0c\u6dfb\u52a0\u4e0b\u8ff0\u7684\u4e00\u884c\u4ee3\u7801\uff1a ImageIO.write(img, IMAGE_FORMAT, new java.io.File(\"Temp.png\")); \u56fe\u50cf\u5c06\u88ab\u5199\u5165\u4e00\u4e2a\u4e34\u65f6\u6587\u4ef6\u3002\u8be5\u6587\u4ef6\u5c06\u5305\u542b\u4e00\u4e2a\u5728\u767d\u8272\u80cc\u666f\u4e0b\uff0c\u4f7f\u7528\u6297\u952f\u9f7f\u7ed8\u5236\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u957f\u6761\u3002 \u6700\u540e\u53ea\u9700\u8981\u4ece\u8be5\u56fe\u50cf\u521b\u5efa\u4e00\u4e2a Texture \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ea\u9700\u4f7f\u7528PNG\u683c\u5f0f\uff08\u8fd9\u5c31\u662f Texture \u7c7b\u6240\u671f\u671b\u7684\uff09\u8f6c\u50a8\u56fe\u50cf\u5b57\u8282\u3002 ByteBuffer buf = null; try ( ByteArrayOutputStream out = new ByteArrayOutputStream()) { ImageIO.write(img, IMAGE_FORMAT, out); out.flush(); byte[] data = out.toByteArray(); buf = ByteBuffer.allocateDirect(data.length); buf.put(data, 0, data.length); buf.flip(); } texture = new Texture(buf); } \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u5df2\u7ecf\u7a0d\u5fae\u4fee\u6539\u4e86 Texture \u7c7b\uff0c\u4f7f\u5176\u5177\u6709\u4e00\u4e2a\u63a5\u6536 ByteBuffer \u7684\u6784\u9020\u51fd\u6570\u3002\u5176\u4e2d\u8fd9\u4e2a\u65b0\u7684\u6784\u9020\u51fd\u6570\u4f7f\u7528 stbi_load_from_memory \u52a0\u8f7d\u56fe\u7247\u3002\u73b0\u5728\u6211\u4eec\u53ea\u9700\u66f4\u6539 TextItem \u7c7b\uff0c\u4ee5\u4fbf\u5728\u5176\u6784\u9020\u51fd\u6570\u4e2d\u63a5\u6536 FontTexture \u5b9e\u4f8b\u3002 public TextItem(String text, FontTexture fontTexture) throws Exception { super(); this.text = text; this.fontTexture = fontTexture; setMesh(buildMesh()); } \u53ea\u9700\u8981\u5728\u8bbe\u7f6e\u7247\u6bb5\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u65f6\u7a0d\u7a0d\u4fee\u6539 buildMesh \u65b9\u6cd5\uff0c\u4e0b\u8ff0\u4ee3\u7801\u662f\u5176\u4e2d\u4e00\u4e2a\u9876\u70b9\u7684\u793a\u4f8b\uff1a float startx = 0; for(int i=0; i<numChars; i++) { FontTexture.CharInfo charInfo = fontTexture.getCharInfo(characters[i]); // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u9876\u70b9 positions.add(startx); // x positions.add(0.0f); // y positions.add(ZPOS); // z textCoords.add( (float)charInfo.getStartX() / (float)fontTexture.getWidth()); textCoords.add(0.0f); indices.add(i*VERTICES_PER_QUAD); // \u66f4\u591a\u4ee3\u7801... startx += charInfo.getWidth(); } \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u5176\u4ed6\u66f4\u6539\u3002\u4e0b\u56fe\u662f\u4e00\u4e2a\u5927\u5c0f\u4e3a20\u7684Arial\u5b57\u4f53\u7684\u6e32\u67d3\u6548\u679c\uff1a \u5982\u4f60\u6240\u89c1\u6587\u672c\u6e32\u67d3\u7684\u8d28\u91cf\u5df2\u7ecf\u6709\u4e86\u5f88\u5927\u7684\u63d0\u5347\uff0c\u4f60\u53ef\u4ee5\u7528\u4e0d\u540c\u7684\u5b57\u4f53\u548c\u5927\u5c0f\u6765\u6e32\u67d3\u3002\u8fd9\u4ecd\u7136\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4(\u5982\u652f\u6301\u591a\u884c\u6587\u672c\u3001\u7279\u6548\u7b49)\uff0c\u4f46\u8fd9\u5c06\u7559\u7ed9\u5404\u4f4d\u8bfb\u8005\u4f5c\u4e3a\u7ec3\u4e60\u3002 \u4f60\u53ef\u80fd\u8fd8\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u4ecd\u7136\u80fd\u591f\u7f29\u653e\u6587\u672c\uff08\u901a\u8fc7\u7740\u8272\u5668\u4e2d\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002\u73b0\u5728\u7684\u6587\u672c\u53ef\u80fd\u4e0d\u9700\u8981\u7f29\u653e\uff0c\u4f46\u5bf9\u5176\u4ed6\u7684HUD\u5143\u7d20\u53ef\u80fd\u4f1a\u6709\u7528\u3002 \u6211\u4eec\u5df2\u7ecf\u786e\u7acb\u4e86\u6240\u6709\u7684\u57fa\u672c\u6570\u636e\u7ed3\u6784\uff0c\u4ee5\u4fbf\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\u3002\u73b0\u5728\uff0c\u53ea\u5269\u4e00\u4e2a\u95ee\u9898\uff0c\u90a3\u5c31\u662f\u521b\u5efa\u6240\u6709\u7684\u5143\u7d20\uff0c\u4f20\u9012\u76f8\u5173\u4fe1\u606f\u7ed9\u7528\u6237\uff0c\u5e76\u7ed9\u4ed6\u4eec\u4e00\u4e2a\u4e13\u4e1a\u7684\u5916\u89c2\u3002","title":"\u518d\u8c08\u6587\u672c\u6e32\u67d3"},{"location":"12-game-hud/#osx","text":"\u5982\u679c\u4f60\u8bd5\u56fe\u8fd0\u884c\u672c\u7ae0\u4e2d\u7684\u793a\u4f8b\uff0c\u4ee5\u53ca\u4e0b\u4e00\u4e2a\u6e32\u67d3\u6587\u672c\u7684\u793a\u4f8b\uff0c\u5219\u53ef\u80fd\u4f1a\u53d1\u73b0\u5e94\u7528\u7a0b\u5e8f\u963b\u585e\uff0c\u5c4f\u5e55\u4e0a\u4e0d\u4f1a\u663e\u793a\u4efb\u4f55\u5185\u5bb9\u3002\u8fd9\u662f\u7531\u4e8eAWT\u548cGLFW\u5728OSX\u4e0b\u76f8\u5904\u5f97\u4e0d\u592a\u597d\uff0c\u4f46\u8fd9\u548cAWT\u6709\u4ec0\u4e48\u5173\u7cfb\u5462\uff1f\u6211\u4eec\u4f7f\u7528\u7684\u662f Font \u7c7b\uff0c\u5b83\u5c5e\u4e8eAWT\uff0c\u5982\u679c\u8981\u5b9e\u4f8b\u5316\u5b83\uff0cAWT\u4e5f\u9700\u8981\u521d\u59cb\u5316\u3002\u5728OSX\u4e2d\uff0cAWT\u8bd5\u56fe\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u4f46GLFW\u4e5f\u9700\u8981\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u8fd9\u5c31\u662f\u9020\u6210\u6b64\u95ee\u9898\u7684\u539f\u56e0\u3002 \u4e3a\u4e86\u80fd\u591f\u4f7f\u7528 Font \u7c7b\uff0cGLFW\u5fc5\u987b\u5728AWT\u4e4b\u524d\u521d\u59cb\u5316\uff0c\u5e76\u4e14\u793a\u4f8b\u9700\u8981\u4ee5Headless\u6a21\u5f0f\u8fd0\u884c\u3002\u4f60\u9700\u8981\u5728\u4efb\u4f55\u4e1c\u897f\u88ab\u521d\u59cb\u5316\u4e4b\u524d\u8bbe\u7f6e\u6b64\u5c5e\u6027\uff1a System.setProperty(\"java.awt.headless\", \"true\"); \u4f60\u4e5f\u8bb8\u4f1a\u6536\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u4f46\u793a\u4f8b\u6210\u529f\u8fd0\u884c\u4e86\u3002 \u4e00\u4e2a\u66f4\u7b80\u6d01\u7684\u65b9\u6cd5\u662f\u4f7f\u7528 stb \u5e93\u6765\u6e32\u67d3\u6587\u672c\u3002","title":"OSX"},{"location":"13-sky-box-and-some-optimizations/","text":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316 (Sky Box and some optimizations) \u5929\u7a7a\u76d2 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\u5c06\u7528\u4e8e\u4e3a\u4e09\u7ef4\u4e16\u754c\u8bbe\u7f6e\u80cc\u666f\uff0c\u7ed9\u4eba\u4e00\u79cd\u4e16\u754c\u5e7f\u9614\u7684\u9519\u89c9\u3002\u8fd9\u4e2a\u80cc\u666f\u5c06\u6444\u50cf\u673a\u6240\u5904\u4f4d\u7f6e\u5305\u8d77\u6765\uff0c\u7f69\u4f4f\u6574\u4e2a\u7a7a\u95f4\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u4e2a\u6e32\u67d3\u5728\u4e09\u7ef4\u573a\u666f\u5468\u56f4\u7684\u7acb\u65b9\u4f53\uff0c\u5373\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u5c06\u4f4d\u4e8e\u7acb\u65b9\u4f53\u7684\u4e2d\u5fc3\u3002\u8be5\u7acb\u65b9\u4f53\u7684\u9762\u5c06\u5305\u7740\u4e00\u5c42\u7eb9\u7406\uff0c\u7eb9\u7406\u4e0a\u6709\u5c71\u3001\u84dd\u5929\u548c\u4e91\u5f69\uff0c\u5b83\u5c06\u4ee5\u4e00\u79cd\u56fe\u50cf\u770b\u8d77\u6765\u50cf\u662f\u4e00\u4e2a\u8fde\u7eed\u7684\u98ce\u666f\u7684\u65b9\u5f0f\u8fdb\u884c\u6620\u5c04\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002 \u521b\u5efa\u5929\u7a7a\u76d2\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u51e0\u6b65\uff1a \u521b\u5efa\u4e00\u4e2a\u5927\u7acb\u65b9\u4f53\u3002 \u5bf9\u5b83\u5e94\u7528\u7eb9\u7406\uff0c\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u6e32\u67d3\u7acb\u65b9\u4f53\uff0c\u5b83\u7684\u539f\u70b9\u4f4d\u4e8e\u6444\u50cf\u673a\u6240\u5904\u7684\u4f4d\u7f6e\uff0c\u5b83\u7684\u9762\u8ddd\u79bb\u539f\u70b9\u5f88\u8fdc\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u7eb9\u7406\u5f00\u59cb\u3002\u4f60\u4f1a\u53d1\u73b0\u4e92\u8054\u7f51\u4e0a\u6709\u5f88\u591a\u9884\u5148\u751f\u6210\u7684\u7eb9\u7406\u53ef\u4f9b\u4f7f\u7528\uff0c\u672c\u7ae0\u793a\u4f8b\u4e2d\u4f7f\u7528\u7684\u7eb9\u7406\u4ece\u6b64\u5904\u4e0b\u8f7d\uff1a http://www.custommapmakers.org/skyboxes.php \u3002\u672c\u7ae0\u4e2d\u5177\u4f53\u4f7f\u7528\u7684\u7eb9\u7406\u662f\uff1a http://www.custommapmakers.org/skyboxes/zips/ely_hills.zip \uff0c\u4f5c\u8005\u662fColin Lowndes\u3002 \u8be5\u7f51\u7ad9\u7684\u7eb9\u7406\u90fd\u662f\u7531\u5355\u72ec\u7684TGA\u6587\u4ef6\u7ec4\u6210\uff0c\u6bcf\u4e2a\u6587\u4ef6\u90fd\u662f\u7acb\u65b9\u4f53\u7684\u4e00\u9762\u3002\u6211\u4eec\u7684\u7eb9\u7406\u52a0\u8f7d\u5668\u5e0c\u671b\u6587\u4ef6\u683c\u5f0f\u4e3aPNG\uff0c\u6240\u4ee5\u9700\u8981\u5c06\u6bcf\u4e00\u9762\u7684\u56fe\u50cf\u7ec4\u5408\u6210\u4e00\u4e2aPNG\u56fe\u50cf\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5176\u4ed6\u65b9\u6cd5\uff0c\u4f8b\u5982\u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff0c\u4f7f\u5176\u81ea\u52a8\u5e94\u7528\u7eb9\u7406\u3002\u4f46\u4e3a\u4e86\u4f7f\u672c\u7ae0\u5c3d\u53ef\u80fd\u7b80\u6d01\u6613\u61c2\uff0c\u4f60\u5fc5\u987b\u624b\u52a8\u628a\u5b83\u4eec\u6392\u5217\u4e3a\u4e00\u5f20\u56fe\u7247\uff0c\u6700\u7ec8\u56fe\u50cf\u5982\u4e0b\u6240\u793a\uff1a \u63a5\u4e0b\u6765\u9700\u8981\u521b\u5efa\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u542b\u6709\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6b63\u786e\u5730\u8bbe\u7f6e\u6bcf\u4e00\u9762\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u7eb9\u7406\u4e0e\u7acb\u65b9\u4f53\u5404\u9762\u7684\u5173\u7cfb\uff08\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u672c\u7ae0\u4f7f\u7528\u7684OBJ\u6587\u4ef6\uff09\uff1a \u5f53\u76f8\u5173\u8d44\u6e90\u51c6\u5907\u5c31\u7eea\uff0c\u5c31\u53ef\u4ee5\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\u4e86\u3002\u9996\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SkyBox \u7684\u65b0\u7c7b\uff0c\u5b83\u7684\u6784\u9020\u51fd\u6570\u63a5\u6536OBJ\u6a21\u578b\u8def\u5f84\u548c\u5929\u7a7a\u76d2\u7eb9\u7406\u6587\u4ef6\u8def\u5f84\u3002\u5982\u540c\u6b64\u524d\u4e00\u7ae0\u7684HUD\uff0c\u8fd9\u4e2a\u7c7b\u4e5f\u7ee7\u627f GameItem \u7c7b\u3002\u4e3a\u4ec0\u4e48\u5b83\u8981\u7ee7\u627f GameItem \u7c7b\uff1f\u9996\u5148\uff0c\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u91cd\u7528\u5927\u90e8\u5206\u5904\u7406\u7f51\u683c\u548c\u7eb9\u7406\u7684\u4ee3\u7801\uff1b\u7b2c\u4e8c\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u4e0d\u4f1a\u79fb\u52a8\uff0c\u6211\u4eec\u53ea\u60f3\u5e94\u7528\u65cb\u8f6c\u548c\u7f29\u653e\u3002\u8fd9\u6837\u60f3\u60f3 SkyBox \u786e\u5b9e\u662f\u4e00\u4e2a GameItem \u3002 SkyBox \u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.OBJLoader; import org.lwjglb.engine.graph.Texture; public class SkyBox extends GameItem { public SkyBox(String objModel, String textureFile) throws Exception { super(); Mesh skyBoxMesh = OBJLoader.loadMesh(objModel); Texture skyBoxtexture = new Texture(textureFile); skyBoxMesh.setMaterial(new Material(skyBoxtexture, 0.0f)); setMesh(skyBoxMesh); setPosition(0, 0, 0); } } \u5982\u679c\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u53d1\u73b0\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Scene \u7684\u7c7b\uff0c\u5b83\u5c06\u6574\u7406\u4e0e\u4e09\u7ef4\u4e16\u754c\u76f8\u5173\u7684\u6240\u6709\u6570\u636e\u3002 Scene \u7c7b\u7684\u5b9a\u4e49\u548c\u5c5e\u6027\u5982\u4e0b\u6240\u793a\uff0c\u5176\u4e2d\u5305\u542b SkyBox \u7c7b\u7684\u5b9e\u4f8b\uff1a package org.lwjglb.engine; public class Scene { private GameItem[] gameItems; private SkyBox skyBox; private SceneLight sceneLight; public GameItem[] getGameItems() { return gameItems; } // \u66f4\u591a\u4ee3\u7801... \u63a5\u4e0b\u6765\u662f\u4e3a\u5929\u7a7a\u76d2\u521b\u5efa\u53e6\u4e00\u7ec4\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\uff0c\u4f46\u4e3a\u4ec0\u4e48\u4e0d\u91cd\u7528\u5df2\u6709\u7684\u573a\u666f\u7740\u8272\u5668\u5462\uff1f\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u6240\u9700\u7684\u7740\u8272\u5668\u662f\u539f\u6709\u7740\u8272\u5668\u7684\u7b80\u5316\u7248\uff0c\u4e0d\u9700\u8981\u8ba9\u5149\u7167\u5f71\u54cd\u5929\u7a7a\u76d2\uff08\u66f4\u51c6\u786e\u7684\u8bf4\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u70b9\u5149\u6e90\uff0c\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\uff09\u3002\u5929\u7a7a\u76d2\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4ecd\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u7f29\u653e\u5929\u7a7a\u76d2\uff0c\u6240\u4ee5\u9700\u8981\u53d8\u6362\u77e9\u9635\u3002\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5230\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\uff0c\u5728\u521d\u59cb\u5316\u65f6\u5c31\u653e\u5927\u4e86\u7acb\u65b9\u4f53\u6a21\u578b\u7684\u5927\u5c0f\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\u3002\u4f46\u6211\u4eec\u9009\u62e9\u524d\u4e00\u79cd\u65b9\u6cd5\uff0c\u56e0\u4e3a\u5b83\u66f4\u7075\u6d3b\uff0c\u5b83\u5141\u8bb8\u5728\u8fd0\u884c\u65f6\u6539\u53d8\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u3002\u4f46\u5982\u679c\u4f60\u60f3\uff0c\u4f60\u5c31\u53ef\u4ee5\u8f7b\u677e\u6539\u6362\u5230\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u975e\u5e38\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 ambientLight; void main() { fragColor = vec4(ambientLight, 1) * texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u7740\u8272\u5668\u6dfb\u52a0\u4e86\u4e00\u4e2a\u73af\u5883\u5149\uff0c\u8be5Uniform\u7684\u76ee\u7684\u662f\u4fee\u6539\u5929\u7a7a\u76d2\u7684\u989c\u8272\u4ee5\u6a21\u62df\u663c\u591c\uff08\u5982\u679c\u4e0d\u8fd9\u6837\u505a\uff0c\u5728\u4e16\u754c\u7684\u5176\u4ed6\u5730\u65b9\u90fd\u662f\u9ed1\u6697\u7684\u65f6\u5019\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u5c31\u50cf\u662f\u5728\u4e2d\u5348\uff09\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u521a\u521a\u6dfb\u52a0\u4e86\u65b0\u7684\u65b9\u6cd5\u6765\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u5e76\u8bbe\u7f6eUniform\uff08\u8fd9\u4e0d\u662f\u4ec0\u4e48\u65b0\u7684\u6982\u5ff5\uff09\u3002 private void setupSkyBoxShader() throws Exception { skyBoxShaderProgram = new ShaderProgram(); skyBoxShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/sb_vertex.vs\")); skyBoxShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/sb_fragment.fs\")); skyBoxShaderProgram.link(); skyBoxShaderProgram.createUniform(\"projectionMatrix\"); skyBoxShaderProgram.createUniform(\"modelViewMatrix\"); skyBoxShaderProgram.createUniform(\"texture_sampler\"); skyBoxShaderProgram.createUniform(\"ambientLight\"); } \u5f53\u7136\uff0c\u6211\u4eec\u9700\u8981\u5728\u5168\u5c40\u6e32\u67d3\u4e2d\u4e3a\u6e32\u67d3\u5929\u7a7a\u76d2\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u6e32\u67d3\u65b9\u6cd5\u3002 private void renderSkyBox(Window window, Camera camera, Scene scene) { skyBoxShaderProgram.bind(); skyBoxShaderProgram.setUniform(\"texture_sampler\", 0); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); skyBoxShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); SkyBox skyBox = scene.getSkyBox(); Matrix4f viewMatrix = transformation.getViewMatrix(camera); viewMatrix.m30(0); viewMatrix.m31(0); viewMatrix.m32(0); Matrix4f modelViewMatrix = transformation.getModelViewMatrix(skyBox, viewMatrix); skyBoxShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); skyBoxShaderProgram.setUniform(\"ambientLight\", scene.getSceneLight().getAmbientLight()); scene.getSkyBox().getMesh().render(); skyBoxShaderProgram.unbind(); } \u4e0a\u8ff0\u65b9\u6cd5\u4e0e\u5176\u4ed6\u6e32\u67d3\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u4e00\u4e2a\u4e0d\u540c\u4e4b\u5904\u9700\u8981\u89e3\u91ca\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u50cf\u5e73\u5e38\u4e00\u6837\u4f20\u9012\u6295\u5f71\u77e9\u9635\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u4f46\u5f53\u53d6\u5f97\u89c2\u5bdf\u77e9\u9635\u65f6\uff0c\u6211\u4eec\u5c06\u5176\u4e00\u4e9b\u6570\u503c\u8bbe\u7f6e\u4e3a0\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u5176\u4e2d\u7684\u539f\u56e0\u662f\u6211\u4eec\u4e0d\u5e0c\u671b\u5929\u7a7a\u76d2\u88ab\u79fb\u52a8\u3002 \u8bf7\u8bb0\u4f4f\uff0c\u5f53\u6211\u4eec\u5728\u79fb\u52a8\u6444\u50cf\u673a\u65f6\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58\uff0c\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u5929\u7a7a\u76d2\u4e5f\u5c06\u79fb\u52a8\u3002\u4f46\u662f\u6211\u4eec\u4e0d\u60f3\u8fd9\u6837\uff0c\u6211\u4eec\u60f3\u628a\u5b83\u56fa\u5b9a\u5728\u5750\u6807\u539f\u70b9(0, 0, 0)\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u79fb\u589e\u91cf\u90e8\u5206\uff08 m30 , m31 \u548c m32 \uff09\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u8ba4\u4e3a\u53ef\u4ee5\u907f\u514d\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u5fc5\u987b\u56fa\u5b9a\u5728\u539f\u70b9\u3002\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u5929\u7a7a\u76d2\u4e0d\u4f1a\u968f\u7740\u6444\u50cf\u673a\u65cb\u8f6c\uff0c\u8fd9\u4e0d\u662f\u6211\u4eec\u60f3\u8981\u7684\u3002\u56e0\u6b64\u6211\u4eec\u9700\u8981\u65cb\u8f6c\u5b83\u4f46\u4e0d\u8981\u79fb\u52a8\u5b83\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\uff0c\u4f60\u53ef\u4ee5\u67e5\u9605\u672c\u7ae0\u6e90\u4ee3\u7801\uff0c\u672c\u4f8b\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e86\u66f4\u591a\u7684\u65b9\u5757\u5b9e\u4f8b\u6765\u6a21\u62df\u5730\u9762\u548c\u5929\u7a7a\u76d2\u3002\u4f60\u4e5f\u53ef\u4ee5\u6539\u53d8\u73af\u5883\u5149\u6765\u6a21\u62df\u5149\u7167\u548c\u663c\u591c\u4ea4\u66ff\u3002\u6700\u7ec8\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u6548\u679c\uff1a \u5929\u7a7a\u76d2\u662f\u4e00\u4e2a\u5c0f\u7acb\u65b9\u4f53\uff08\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u5b83\u5e94\u8be5\u5927\u5f97\u591a\uff09\uff0c\u6240\u4ee5\u4f60\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u65f6\uff0c\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u770b\u5230\u5176\u6548\u679c\u3002\u4f60\u8fd8\u53ef\u4ee5\u770b\u5230\uff0c\u6784\u6210\u5730\u9762\u7684\u65b9\u5757\u6bd4\u5929\u7a7a\u76d2\u5927\uff0c\u6240\u4ee5\u5f53\u4f60\u79fb\u52a8\u65f6\uff0c\u4f60\u4f1a\u770b\u5230\u4ece\u5c71\u4e2d\u5192\u51fa\u7684\u65b9\u5757\u3002\u8fd9\u5f88\u660e\u663e\uff0c\u56e0\u4e3a\u6211\u4eec\u8bbe\u7f6e\u7684\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u3002\u4f46\u65e0\u8bba\u5982\u4f55\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u9690\u85cf\u548c\u6a21\u7cca\u8fdc\u5904\u7684\u7269\u4f53\u7684\u6548\u679c\uff08\u4f8b\u5982\u4f7f\u7528\u96fe\u6548\u679c\uff09\u6765\u51cf\u8f7b\u8fd9\u79cd\u5f71\u54cd\u3002 \u4e0d\u521b\u5efa\u66f4\u5927\u7684\u5929\u7a7a\u76d2\u7684\u53e6\u4e00\u4e2a\u539f\u56e0\u662f\u6211\u4eec\u9700\u8981\u51e0\u4e2a\u4f18\u5316\u6765\u63d0\u5347\u6548\u7387\uff08\u7a0d\u540e\u5bf9\u6b64\u8fdb\u884c\u89e3\u91ca\uff09\u3002 \u53ef\u4ee5\u6ce8\u91ca\u6e32\u67d3\u65b9\u6cd5\u4e2d\u9632\u6b62\u5929\u7a7a\u76d2\u79fb\u52a8\u7684\u4ee3\u7801\uff0c\u7136\u540e\u4f60\u5c31\u53ef\u4ee5\u5728\u5929\u7a7a\u76d2\u5916\u770b\u5230\u5982\u4e0b\u6240\u793a\u56fe\u50cf\uff1a \u867d\u7136\u8fd9\u4e0d\u662f\u5929\u7a7a\u76d2\u8be5\u505a\u7684\uff0c\u4f46\u8fd9\u53ef\u4ee5\u5e2e\u52a9\u4f60\u7406\u89e3\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u5176\u4ed6\u6548\u679c\u6765\u6539\u5584\u5b83\uff0c\u6bd4\u5982\u592a\u9633\u5728\u5929\u7a79\u79fb\u52a8\u6216\u4e91\u5c42\u79fb\u52a8\u3002\u6b64\u5916\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u4e16\u754c\uff0c\u4f60\u9700\u8981\u5c06\u4e16\u754c\u5206\u5272\u6210\u533a\u57df\uff0c\u53ea\u52a0\u8f7d\u90a3\u4e9b\u4e0e\u73a9\u5bb6\u6240\u5904\u7684\u533a\u57df\u76f8\u90bb\u7684\u533a\u57df\u3002 \u53e6\u5916\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff1a\u4ec0\u4e48\u65f6\u5019\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u8fd8\u662f\u4e4b\u540e\uff1f\u5728\u6e32\u67d3\u573a\u666f\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\u66f4\u4f18\uff0c\u56e0\u4e3a\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5927\u591a\u6570\u7247\u5143\u5c06\u88ab\u4e22\u5f03\u3002\u5f53OpenGL\u5c1d\u8bd5\u6e32\u67d3\u5b83\u4eec\uff0c\u5e76\u4e14\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u65f6\uff0c\u5c06\u4e22\u5f03\u4e00\u4e9b\u4f4d\u4e8e\u5148\u524d\u6e32\u67d3\u7684\u7247\u5143\u4e4b\u540e\u7684\u7247\u5143\uff0c\u8fd9\u4e9b\u7247\u5143\u7684\u6df1\u5ea6\u503c\u66f4\u4f4e\u3002\u6240\u4ee5\u7b54\u6848\u5f88\u660e\u663e\uff0c\u5bf9\u5427\uff1f\u6e32\u67d3\u573a\u666f\u540e\uff0c\u518d\u6e32\u67d3\u5929\u7a7a\u76d2\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5728\u5904\u7406\u900f\u660e\u7eb9\u7406\u65f6\uff0c\u5982\u679c\u5728\u573a\u666f\u4e2d\u6211\u4eec\u6709\u5e94\u7528\u900f\u660e\u7eb9\u7406\u7684\u7269\u4f53\uff0c\u5b83\u4eec\u5c06\u4f7f\u7528\u201c\u80cc\u666f\u201d\u8272\u7ed8\u5236\uff0c\u672c\u4f8b\u4e2d\u662f\u9ed1\u8272\u3002\u4f46\u5982\u679c\u6211\u4eec\u5148\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u90a3\u4e48\u5c06\u4f1a\u6b63\u786e\u5730\u5e94\u7528\u900f\u660e\u6548\u679c\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5e94\u8be5\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\u5417\uff1f\u5173\u952e\u5728\u4e8e\u4f60\u7684\u9009\u62e9\u3002\u5982\u679c\u4f60\u5728\u6e32\u67d3\u573a\u666f\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u53ef\u4ee5\u89e3\u51b3\u900f\u660e\u7eb9\u7406\u95ee\u9898\uff0c\u4f46\u662f\u4f1a\u5f71\u54cd\u6027\u80fd\u3002\u5b9e\u9645\u4e0a\uff0c\u5c31\u7b97\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f60\u4e5f\u53ef\u80fd\u9762\u4e34\u900f\u660e\u95ee\u9898\u3002\u5047\u8bbe\u4f60\u6709\u4e00\u4e2a\u900f\u660e\u7684\u7269\u4f53\uff0c\u5b83\u4e0e\u8fdc\u5904\u7684\u7269\u4f53\u91cd\u53e0\uff0c\u5982\u679c\u9996\u5148\u6e32\u67d3\u900f\u660e\u5bf9\u8c61\uff0c\u90a3\u4e48\u4e5f\u4f1a\u51fa\u73b0\u900f\u660e\u95ee\u9898\u3002\u56e0\u6b64\uff0c\u4e5f\u8bb8\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u5728\u6240\u6709\u5176\u4ed6\u9879\u88ab\u6e32\u67d3\u540e\uff0c\u5355\u72ec\u7ed8\u5236\u900f\u660e\u7684\u9879\u3002\u8fd9\u662f\u4e00\u4e9b\u5546\u4e1a\u6e38\u620f\u4f7f\u7528\u7684\u65b9\u6cd5\u3002\u4e0d\u8fc7\u73b0\u5728\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u4ee5\u83b7\u5f97\u66f4\u9ad8\u7684\u6027\u80fd\u3002 \u4e00\u4e9b\u4f18\u5316 \u4ece\u4e0a\u8ff0\u793a\u4f8b\u6765\u770b\uff0c\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u4f7f\u5f97\u5176\u6548\u679c\u6709\u70b9\u5947\u602a\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u7269\u4f53\u795e\u5947\u5730\u4ece\u5c71\u4f53\u51fa\u73b0\uff09\u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u589e\u52a0\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u548c\u4e16\u754c\u7684\u5927\u5c0f\uff0c\u5c06\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u653e\u592750\u500d\uff0c\u8fd9\u6837\u4e16\u754c\u753140,000\u4e2a\u6e38\u620f\u9879\u5b9e\u4f8b\uff08\u65b9\u5757\uff09\u7ec4\u6210\u3002 \u5982\u679c\u4f60\u66f4\u6539\u7f29\u653e\u5e76\u91cd\u65b0\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u53d1\u73b0\u5f00\u59cb\u51fa\u73b0\u6027\u80fd\u95ee\u9898\uff0c\u5e76\u4e14\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u4e0d\u987a\u7545\u3002\u73b0\u5728\u662f\u65f6\u5019\u5173\u6ce8\u4e00\u4e0b\u6027\u80fd\u4e86\uff08\u4f60\u53ef\u80fd\u542c\u8fc7\u4e00\u53e5\u8001\u8bdd\uff1a\u201c\u8fc7\u65e9\u7684\u4f18\u5316\u662f\u4e07\u6076\u4e4b\u6e90\u201d\uff0c\u4f46\u662f\u4ece\u672c\u7ae0\u5f00\u59cb\uff0c\u6211\u5e0c\u671b\u6ca1\u6709\u4eba\u4f1a\u8bf4\u8fd9\u662f\u8fc7\u65e9\u7684\uff09\u3002 \u8ba9\u6211\u6765\u4ecb\u7ecd\u4e00\u4e2a\u6982\u5ff5\uff0c\u5b83\u80fd\u51cf\u5c11\u6b63\u5728\u6e32\u67d3\u7684\u6570\u636e\u6570\u91cf\uff0c\u5b83\u53eb\u505a\u9762\u5254\u9664\uff08Face Culling\uff09\u3002\u5728\u793a\u4f8b\u4e2d\uff0c\u6211\u4eec\u6e32\u67d3\u4e86\u6210\u5343\u4e0a\u4e07\u4e2a\u7acb\u65b9\u4f53\uff0c\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u7ec4\u6210\u7684\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u6bcf\u4e2a\u7acb\u65b9\u4f53\u7684\u516d\u4e2a\u9762\uff0c\u5373\u4f7f\u5b83\u4eec\u6709\u4e9b\u662f\u770b\u4e0d\u5230\u7684\u3002\u8fdb\u5165\u4e00\u4e2a\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4f60\u4f1a\u770b\u5230\u5b83\u7684\u5185\u90e8\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4e0d\u80fd\u88ab\u770b\u5230\u7684\u9762\u5e94\u8be5\u7acb\u5373\u820d\u5f03\uff0c\u8fd9\u5c31\u662f\u9762\u5254\u9664\u7684\u4f5c\u7528\u3002\u5b9e\u9645\u4e0a\uff0c\u5bf9\u4e8e\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u4f60\u6700\u591a\u53ea\u80fd\u540c\u65f6\u770b\u5230\u4e09\u4e2a\u9762\uff0c\u6240\u4ee5\u53ea\u80fd\u901a\u8fc7\u4f7f\u7528\u9762\u5254\u9664\uff08\u5982\u679c\u4f60\u7684\u6e38\u620f\u4e0d\u8981\u6c42\u4f60\u8fdb\u5165\u6a21\u578b\u7684\u5185\u90e8\uff0c\u8fd9\u6837\u505a\u624d\u662f\u9ad8\u6548\u7684\uff0c\u7a0d\u540e\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\uff09\u6765\u820d\u5f03\u4e00\u534a\u7684\u9762\uff0840,000\u00d73\u00d72\u4e2a\u4e09\u89d2\u5f62\uff09\u3002 \u9762\u5254\u9664\u68c0\u67e5\u6bcf\u4e2a\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e22\u5f03\u90a3\u4e9b\u4e0d\u9762\u5411\u6444\u50cf\u673a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u662f\uff0c\u5982\u4f55\u77e5\u9053\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\u5462\uff1f\u597d\u5427\uff0cOpenGL\u5b9e\u73b0\u5b83\u7684\u65b9\u5f0f\u662f\u901a\u8fc7\u68c0\u67e5\u7ec4\u6210\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002 \u8bb0\u5f97\u4ece\u7b2c\u4e00\u7ae0\u5f00\u59cb\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u4ee5\u987a\u65f6\u9488\u6216\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u3002\u5728OpenGL\u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u6444\u50cf\u673a\uff0c\u800c\u4ee5\u987a\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u76f8\u53cd\u7684\u65b9\u5411\u3002\u5173\u952e\u662f\u5728\u8003\u8651\u6444\u50cf\u673a\u7684\u60c5\u51b5\u4e0b\uff0c\u68c0\u67e5\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002\u56e0\u6b64\uff0c\u6309\u7167\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u4e09\u89d2\u5f62\u53ef\u4ee5\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u5b9e\u73b0\u5b83\uff0c\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e0b\u8ff0\u4ee3\u7801\uff1a glEnable(GL_CULL_FACE); glCullFace(GL_BACK); \u7b2c\u4e00\u884c\u4ee3\u7801\u5c06\u542f\u7528\u9762\u5254\u9664\uff0c\u7b2c\u4e8c\u884c\u4ee3\u7801\u8bbe\u7f6e\u80cc\u5411\u9762\u4e3a\u9700\u8981\u5254\u9664\u7684\u9762\u3002\u5982\u679c\u5411\u4e0a\u770b\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u60c5\u666f\uff1a \u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u5982\u679c\u4f60\u67e5\u770b\u9876\u9762\u7684\u9876\u70b9\u987a\u5e8f\uff0c\u5c06\u770b\u5230\u5b83\u662f\u6309\u9006\u65f6\u9488\u5b9a\u4e49\u7684\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u73af\u7ed5\u987a\u5e8f\u662f\u4ee5\u6444\u50cf\u673a\u4e3a\u89c6\u89d2\u3002\u5b9e\u9645\u4e0a\uff0c\u5982\u679c\u4f60\u8ba9\u4f4d\u79fb\u5f71\u54cd\u5929\u7a7a\u76d2\u4ee5\u4fbf\u80fd\u4ece\u5176\u4e0a\u65b9\u89c2\u5bdf\u5b83\u65f6\uff0c\u5219\u5f53\u4f60\u5728\u5929\u7a7a\u76d2\u5916\u65f6\uff0c\u5c06\u770b\u5230\u9876\u9762\u518d\u6b21\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u63cf\u8ff0\u4e00\u4e0b\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5929\u7a7a\u76d2\u7acb\u65b9\u4f53\u7684\u9876\u9762\u4e09\u89d2\u5f62\u4e2d\u7684\u4e00\u4e2a\u4e09\u89d2\u5f62\uff0c\u5b83\u7531\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u7684\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\uff1a \u4f46\u8981\u8bb0\u4f4f\uff0c\u6211\u4eec\u662f\u5728\u5929\u7a7a\u76d2\u91cc\uff0c\u5982\u679c\u4ece\u5185\u90e8\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u4f1a\u770b\u5230\u9876\u70b9\u662f\u6309\u987a\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u3002 \u8fd9\u662f\u56e0\u4e3a\u5929\u7a7a\u76d2\u88ab\u5b9a\u4e49\u4e3a\u4ece\u5916\u90e8\u89c2\u5bdf\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u7ffb\u8f6c\u4e00\u4e9b\u9762\u7684\u5b9a\u4e49\uff0c\u4ee5\u4fbf\u5728\u542f\u7528\u9762\u5254\u9664\u65f6\u80fd\u6b63\u786e\u5730\u6e32\u67d3\u5b83\u3002 \u4f46\u8fd9\u4ecd\u6709\u66f4\u5927\u7684\u4f18\u5316\u7a7a\u95f4\u3002\u56de\u987e\u4e00\u4e0b\u6e32\u67d3\u6d41\u7a0b\uff0c\u5728 Renderer \u7c7b render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u904d\u5386 GameItem \u6570\u7ec4\u5e76\u6e32\u67d3\u76f8\u5173\u7684 Mesh \u3002\u5bf9\u6bcf\u4e2a GameItem \uff0c\u6211\u4eec\u505a\u4e86\u4e0b\u8ff0\u5de5\u4f5c\uff1a \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u7684\u552f\u4e00\u503c\uff09\u3002 \u83b7\u53d6 GameItem \u50a8\u5b58\u7684 Mesh \u5e76\u7ed1\u5b9a\u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u6267\u884c\u8c03\u7528\u4ee5\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u505c\u7528\u7eb9\u7406\u548cVAO\u3002 \u4f46\u5728\u73b0\u5728\u7684\u6e38\u620f\u4e2d\uff0c40,000\u4e2a GameItem \u90fd\u4f7f\u7528\u76f8\u540c\u7684 Mesh \uff0c\u800c\u6211\u4eec\u4e00\u6b21\u53c8\u4e00\u6b21\u5730\u91cd\u590d\u7b2c\u4e8c\u9879\u5230\u7b2c\u56db\u9879\u7684\u64cd\u4f5c\u3002\u8fd9\u4e0d\u662f\u5f88\u9ad8\u6548\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u5bf9OpenGL\u51fd\u6570\u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u662f\u6709\u6027\u80fd\u5f00\u9500\u7684\u672c\u5730\u8c03\u7528\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5e94\u8be5\u5c3d\u91cf\u9650\u5236OpenGL\u4e2d\u7684\u72b6\u6001\u53d8\u5316\uff08\u7ed1\u5b9a\u548c\u505c\u7528\u7eb9\u7406\u3001VAO\u90fd\u662f\u72b6\u6001\u53d8\u5316\uff09\u3002 \u6211\u4eec\u9700\u8981\u6539\u53d8\u5f00\u53d1\u7684\u65b9\u5f0f\uff0c\u56f4\u7ed5\u7f51\u683c\u7ec4\u7ec7\u4ee3\u7801\u7ed3\u6784\uff0c\u56e0\u4e3a\u7ecf\u5e38\u6709\u8bb8\u591a\u6e38\u620f\u9879\u4f7f\u7528\u76f8\u540c\u7684\u7f51\u683c\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e00\u4e2a\u6e38\u620f\u9879\u6570\u7ec4\uff0c\u6bcf\u9879\u90fd\u6307\u5411\u540c\u4e00\u4e2a\u7f51\u683c\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4f5c\u4e3a\u66ff\u4ee3\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5176\u4e2d\u5305\u62ec\u50a8\u5b58\u5171\u4eab\u8be5\u7f51\u683c\u7684\u6240\u6709\u6e38\u620f\u9879\u3002 \u5bf9\u4e8e\u6bcf\u4e00\u4e2a Mesh \uff0c\u6e32\u67d3\u6b65\u9aa4\u5c06\u4f1a\u662f\uff1a \u83b7\u53d6\u4e0e GameItem \u76f8\u5173\u8054\u7684 Mesh \u5e76\u7ed1\u5b9a Mesh \u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u76f8\u5173\u7684 GameItem \uff1a a. \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u552f\u4e00\u7684\uff09\u3002 b. \u8c03\u7528\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u89e3\u7ed1\u7eb9\u7406\u548cVAO\u3002 \u5728 Scene \u7c7b\u4e2d\u50a8\u5b58\u4e0b\u8ff0 Map \uff1a private Map<Mesh, List<GameItem>> meshMap; \u6211\u4eec\u4ecd\u6709 setGameItems \u65b9\u6cd5\uff0c\u4f46\u6211\u4eec\u4e0d\u53ea\u662f\u50a8\u5b58\u6570\u7ec4\uff0c\u800c\u662f\u6784\u9020\u7f51\u683c\u6620\u5c04\u8868\u3002 public void setGameItems(GameItem[] gameItems) { int numGameItems = gameItems != null ? gameItems.length : 0; for (int i=0; i<numGameItems; i++) { GameItem gameItem = gameItems[i]; Mesh mesh = gameItem.getMesh(); List<GameItem> list = meshMap.get(mesh); if ( list == null ) { list = new ArrayList<>(); meshMap.put(mesh, list); } list.add(gameItem); } } Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u6e32\u67d3\u4e0e\u5176\u76f8\u5173\u7684 GameItem \u5217\u8868\uff0c\u7136\u540e\u5c06\u7ed1\u5b9a\u548c\u89e3\u7ed1\u4ee3\u7801\u5206\u4e3a\u4e0d\u540c\u7684\u65b9\u6cd5\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } private void endRender() { // \u6062\u590d\u72b6\u6001 glDisableVertexAttribArray(0); glDisableVertexAttribArray(1); glDisableVertexAttribArray(2); glBindVertexArray(0); glBindTexture(GL_TEXTURE_2D, 0); } public void render() { initRender(); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); endRender(); } public void renderList(List<GameItem> gameItems, Consumer<GameItem> consumer) { initRender(); for (GameItem gameItem : gameItems) { // \u8bbe\u7f6e\u6e38\u620f\u9879\u76ee\u6240\u9700\u7684\u6e32\u67d3\u6570\u636e consumer.accept(gameItem); // \u6e32\u67d3\u6e38\u620f\u9879\u76ee glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); } endRender(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4ecd\u7136\u4fdd\u7559\u4e86\u65e7\u65b9\u6cd5\uff0c\u5b83\u8fd4\u56de\u4e00\u4e2a Mesh \uff0c\u8fd9\u662f\u8003\u8651\u5230\u5982\u679c\u53ea\u6709\u4e00\u4e2a GameItem \u7684\u60c5\u51b5\uff08\u8fd9\u53ef\u80fd\u5728\u5176\u4ed6\u60c5\u51b5\u4e0b\u4f7f\u7528\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0d\u79fb\u9664\u5b83\uff09\u3002\u65b0\u7684\u65b9\u6cd5\u6e32\u67d3\u4e00\u4e2a List<GameItem> \uff0c\u5e76\u63a5\u53d7\u4e00\u4e2a Counsumer \u7c7b\u578b\u7684\u53c2\u6570\uff08\u4e00\u4e2a\u51fd\u6570\uff0c\u4f7f\u7528\u4e86Java8\u5f15\u5165\u7684\u51fd\u6570\u5f0f\u7f16\u7a0b\uff09\uff0c\u5b83\u5c06\u7528\u4e8e\u5728\u7ed8\u5236\u4e09\u89d2\u5f62\u4e4b\u524d\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u7279\u5b9a\u7684\u5185\u5bb9\uff0c\u56e0\u4e3a\u4e0d\u5e0c\u671b Mesh \u7c7b\u4e0eUniform\u7684\u540d\u79f0\u548c\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u65f6\u6240\u6d89\u53ca\u7684\u53c2\u6570\u76f8\u8026\u5408\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u6765\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u4e2d\u7684 renderScene \u65b9\u6cd5\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u9700\u904d\u5386\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5e76\u901a\u8fc7Lambda\u8868\u8fbe\u5f0f\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002 for (Mesh mesh : mapMeshes.keySet()) { sceneShaderProgram.setUniform(\"material\", mesh.getMaterial()); mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); sceneShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u53ef\u4ee5\u505a\u7684\u53e6\u4e00\u9879\u4f18\u5316\u662f\uff0c\u6211\u4eec\u5728\u6e32\u67d3\u5468\u671f\u4e2d\u521b\u5efa\u4e86\u5927\u91cf\u5bf9\u8c61\u3002\u7279\u522b\u662f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u592a\u591a\u7684 Matrix4f \u5b9e\u4f8b\uff0c\u5b83\u4eec\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u4fdd\u5b58\u4e86\u4e00\u4e2a\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002\u6211\u4eec\u5e94\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u7279\u5b9a\u7684\u77e9\u9635\uff0c\u5e76\u91cd\u7528\u76f8\u540c\u7684\u5b9e\u4f8b\u3002\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f1a\u770b\u5230\u6211\u4eec\u5df2\u7ecf\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u540d\u79f0\uff0c getXX \u65b9\u6cd5\u53ea\u8fd4\u56de\u50a8\u5b58\u7684\u77e9\u9635\u5b9e\u4f8b\uff0c\u5e76\u4e14\u4efb\u4f55\u66f4\u6539\u77e9\u9635\u503c\u7684\u65b9\u6cd5\u90fd\u79f0\u4e3a buildXX \uff0c\u4ee5\u9610\u660e\u5176\u7528\u9014\u3002 \u6211\u4eec\u4e5f\u907f\u514d\u4e86\u6bcf\u6b21\u4e3a\u77e9\u9635\u8bbe\u7f6eUniform\u65f6\u6784\u9020\u65b0\u7684 FloatBuffer \u5b9e\u4f8b\uff0c\u5e76\u79fb\u9664\u4e86\u5176\u4ed6\u4e00\u4e9b\u65e0\u7528\u7684\u5b9e\u4f8b\u5316\u64cd\u4f5c\u3002\u6709\u4e86\u8fd9\u4e9b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u66f4\u6d41\u7545\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u4e86\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6240\u6709\u7ec6\u8282\u3002","title":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316"},{"location":"13-sky-box-and-some-optimizations/#sky-box-and-some-optimizations","text":"","title":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316 (Sky Box and some optimizations)"},{"location":"13-sky-box-and-some-optimizations/#_1","text":"\u5929\u7a7a\u76d2\uff08Sky Box\uff09\u5c06\u7528\u4e8e\u4e3a\u4e09\u7ef4\u4e16\u754c\u8bbe\u7f6e\u80cc\u666f\uff0c\u7ed9\u4eba\u4e00\u79cd\u4e16\u754c\u5e7f\u9614\u7684\u9519\u89c9\u3002\u8fd9\u4e2a\u80cc\u666f\u5c06\u6444\u50cf\u673a\u6240\u5904\u4f4d\u7f6e\u5305\u8d77\u6765\uff0c\u7f69\u4f4f\u6574\u4e2a\u7a7a\u95f4\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u4e2a\u6e32\u67d3\u5728\u4e09\u7ef4\u573a\u666f\u5468\u56f4\u7684\u7acb\u65b9\u4f53\uff0c\u5373\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u5c06\u4f4d\u4e8e\u7acb\u65b9\u4f53\u7684\u4e2d\u5fc3\u3002\u8be5\u7acb\u65b9\u4f53\u7684\u9762\u5c06\u5305\u7740\u4e00\u5c42\u7eb9\u7406\uff0c\u7eb9\u7406\u4e0a\u6709\u5c71\u3001\u84dd\u5929\u548c\u4e91\u5f69\uff0c\u5b83\u5c06\u4ee5\u4e00\u79cd\u56fe\u50cf\u770b\u8d77\u6765\u50cf\u662f\u4e00\u4e2a\u8fde\u7eed\u7684\u98ce\u666f\u7684\u65b9\u5f0f\u8fdb\u884c\u6620\u5c04\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002 \u521b\u5efa\u5929\u7a7a\u76d2\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u51e0\u6b65\uff1a \u521b\u5efa\u4e00\u4e2a\u5927\u7acb\u65b9\u4f53\u3002 \u5bf9\u5b83\u5e94\u7528\u7eb9\u7406\uff0c\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u6e32\u67d3\u7acb\u65b9\u4f53\uff0c\u5b83\u7684\u539f\u70b9\u4f4d\u4e8e\u6444\u50cf\u673a\u6240\u5904\u7684\u4f4d\u7f6e\uff0c\u5b83\u7684\u9762\u8ddd\u79bb\u539f\u70b9\u5f88\u8fdc\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u7eb9\u7406\u5f00\u59cb\u3002\u4f60\u4f1a\u53d1\u73b0\u4e92\u8054\u7f51\u4e0a\u6709\u5f88\u591a\u9884\u5148\u751f\u6210\u7684\u7eb9\u7406\u53ef\u4f9b\u4f7f\u7528\uff0c\u672c\u7ae0\u793a\u4f8b\u4e2d\u4f7f\u7528\u7684\u7eb9\u7406\u4ece\u6b64\u5904\u4e0b\u8f7d\uff1a http://www.custommapmakers.org/skyboxes.php \u3002\u672c\u7ae0\u4e2d\u5177\u4f53\u4f7f\u7528\u7684\u7eb9\u7406\u662f\uff1a http://www.custommapmakers.org/skyboxes/zips/ely_hills.zip \uff0c\u4f5c\u8005\u662fColin Lowndes\u3002 \u8be5\u7f51\u7ad9\u7684\u7eb9\u7406\u90fd\u662f\u7531\u5355\u72ec\u7684TGA\u6587\u4ef6\u7ec4\u6210\uff0c\u6bcf\u4e2a\u6587\u4ef6\u90fd\u662f\u7acb\u65b9\u4f53\u7684\u4e00\u9762\u3002\u6211\u4eec\u7684\u7eb9\u7406\u52a0\u8f7d\u5668\u5e0c\u671b\u6587\u4ef6\u683c\u5f0f\u4e3aPNG\uff0c\u6240\u4ee5\u9700\u8981\u5c06\u6bcf\u4e00\u9762\u7684\u56fe\u50cf\u7ec4\u5408\u6210\u4e00\u4e2aPNG\u56fe\u50cf\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5176\u4ed6\u65b9\u6cd5\uff0c\u4f8b\u5982\u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff0c\u4f7f\u5176\u81ea\u52a8\u5e94\u7528\u7eb9\u7406\u3002\u4f46\u4e3a\u4e86\u4f7f\u672c\u7ae0\u5c3d\u53ef\u80fd\u7b80\u6d01\u6613\u61c2\uff0c\u4f60\u5fc5\u987b\u624b\u52a8\u628a\u5b83\u4eec\u6392\u5217\u4e3a\u4e00\u5f20\u56fe\u7247\uff0c\u6700\u7ec8\u56fe\u50cf\u5982\u4e0b\u6240\u793a\uff1a \u63a5\u4e0b\u6765\u9700\u8981\u521b\u5efa\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u542b\u6709\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6b63\u786e\u5730\u8bbe\u7f6e\u6bcf\u4e00\u9762\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u7eb9\u7406\u4e0e\u7acb\u65b9\u4f53\u5404\u9762\u7684\u5173\u7cfb\uff08\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u672c\u7ae0\u4f7f\u7528\u7684OBJ\u6587\u4ef6\uff09\uff1a \u5f53\u76f8\u5173\u8d44\u6e90\u51c6\u5907\u5c31\u7eea\uff0c\u5c31\u53ef\u4ee5\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\u4e86\u3002\u9996\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SkyBox \u7684\u65b0\u7c7b\uff0c\u5b83\u7684\u6784\u9020\u51fd\u6570\u63a5\u6536OBJ\u6a21\u578b\u8def\u5f84\u548c\u5929\u7a7a\u76d2\u7eb9\u7406\u6587\u4ef6\u8def\u5f84\u3002\u5982\u540c\u6b64\u524d\u4e00\u7ae0\u7684HUD\uff0c\u8fd9\u4e2a\u7c7b\u4e5f\u7ee7\u627f GameItem \u7c7b\u3002\u4e3a\u4ec0\u4e48\u5b83\u8981\u7ee7\u627f GameItem \u7c7b\uff1f\u9996\u5148\uff0c\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u91cd\u7528\u5927\u90e8\u5206\u5904\u7406\u7f51\u683c\u548c\u7eb9\u7406\u7684\u4ee3\u7801\uff1b\u7b2c\u4e8c\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u4e0d\u4f1a\u79fb\u52a8\uff0c\u6211\u4eec\u53ea\u60f3\u5e94\u7528\u65cb\u8f6c\u548c\u7f29\u653e\u3002\u8fd9\u6837\u60f3\u60f3 SkyBox \u786e\u5b9e\u662f\u4e00\u4e2a GameItem \u3002 SkyBox \u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.OBJLoader; import org.lwjglb.engine.graph.Texture; public class SkyBox extends GameItem { public SkyBox(String objModel, String textureFile) throws Exception { super(); Mesh skyBoxMesh = OBJLoader.loadMesh(objModel); Texture skyBoxtexture = new Texture(textureFile); skyBoxMesh.setMaterial(new Material(skyBoxtexture, 0.0f)); setMesh(skyBoxMesh); setPosition(0, 0, 0); } } \u5982\u679c\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u53d1\u73b0\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Scene \u7684\u7c7b\uff0c\u5b83\u5c06\u6574\u7406\u4e0e\u4e09\u7ef4\u4e16\u754c\u76f8\u5173\u7684\u6240\u6709\u6570\u636e\u3002 Scene \u7c7b\u7684\u5b9a\u4e49\u548c\u5c5e\u6027\u5982\u4e0b\u6240\u793a\uff0c\u5176\u4e2d\u5305\u542b SkyBox \u7c7b\u7684\u5b9e\u4f8b\uff1a package org.lwjglb.engine; public class Scene { private GameItem[] gameItems; private SkyBox skyBox; private SceneLight sceneLight; public GameItem[] getGameItems() { return gameItems; } // \u66f4\u591a\u4ee3\u7801... \u63a5\u4e0b\u6765\u662f\u4e3a\u5929\u7a7a\u76d2\u521b\u5efa\u53e6\u4e00\u7ec4\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\uff0c\u4f46\u4e3a\u4ec0\u4e48\u4e0d\u91cd\u7528\u5df2\u6709\u7684\u573a\u666f\u7740\u8272\u5668\u5462\uff1f\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u6240\u9700\u7684\u7740\u8272\u5668\u662f\u539f\u6709\u7740\u8272\u5668\u7684\u7b80\u5316\u7248\uff0c\u4e0d\u9700\u8981\u8ba9\u5149\u7167\u5f71\u54cd\u5929\u7a7a\u76d2\uff08\u66f4\u51c6\u786e\u7684\u8bf4\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u70b9\u5149\u6e90\uff0c\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\uff09\u3002\u5929\u7a7a\u76d2\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4ecd\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u7f29\u653e\u5929\u7a7a\u76d2\uff0c\u6240\u4ee5\u9700\u8981\u53d8\u6362\u77e9\u9635\u3002\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5230\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\uff0c\u5728\u521d\u59cb\u5316\u65f6\u5c31\u653e\u5927\u4e86\u7acb\u65b9\u4f53\u6a21\u578b\u7684\u5927\u5c0f\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\u3002\u4f46\u6211\u4eec\u9009\u62e9\u524d\u4e00\u79cd\u65b9\u6cd5\uff0c\u56e0\u4e3a\u5b83\u66f4\u7075\u6d3b\uff0c\u5b83\u5141\u8bb8\u5728\u8fd0\u884c\u65f6\u6539\u53d8\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u3002\u4f46\u5982\u679c\u4f60\u60f3\uff0c\u4f60\u5c31\u53ef\u4ee5\u8f7b\u677e\u6539\u6362\u5230\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u975e\u5e38\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 ambientLight; void main() { fragColor = vec4(ambientLight, 1) * texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u7740\u8272\u5668\u6dfb\u52a0\u4e86\u4e00\u4e2a\u73af\u5883\u5149\uff0c\u8be5Uniform\u7684\u76ee\u7684\u662f\u4fee\u6539\u5929\u7a7a\u76d2\u7684\u989c\u8272\u4ee5\u6a21\u62df\u663c\u591c\uff08\u5982\u679c\u4e0d\u8fd9\u6837\u505a\uff0c\u5728\u4e16\u754c\u7684\u5176\u4ed6\u5730\u65b9\u90fd\u662f\u9ed1\u6697\u7684\u65f6\u5019\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u5c31\u50cf\u662f\u5728\u4e2d\u5348\uff09\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u521a\u521a\u6dfb\u52a0\u4e86\u65b0\u7684\u65b9\u6cd5\u6765\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u5e76\u8bbe\u7f6eUniform\uff08\u8fd9\u4e0d\u662f\u4ec0\u4e48\u65b0\u7684\u6982\u5ff5\uff09\u3002 private void setupSkyBoxShader() throws Exception { skyBoxShaderProgram = new ShaderProgram(); skyBoxShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/sb_vertex.vs\")); skyBoxShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/sb_fragment.fs\")); skyBoxShaderProgram.link(); skyBoxShaderProgram.createUniform(\"projectionMatrix\"); skyBoxShaderProgram.createUniform(\"modelViewMatrix\"); skyBoxShaderProgram.createUniform(\"texture_sampler\"); skyBoxShaderProgram.createUniform(\"ambientLight\"); } \u5f53\u7136\uff0c\u6211\u4eec\u9700\u8981\u5728\u5168\u5c40\u6e32\u67d3\u4e2d\u4e3a\u6e32\u67d3\u5929\u7a7a\u76d2\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u6e32\u67d3\u65b9\u6cd5\u3002 private void renderSkyBox(Window window, Camera camera, Scene scene) { skyBoxShaderProgram.bind(); skyBoxShaderProgram.setUniform(\"texture_sampler\", 0); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); skyBoxShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); SkyBox skyBox = scene.getSkyBox(); Matrix4f viewMatrix = transformation.getViewMatrix(camera); viewMatrix.m30(0); viewMatrix.m31(0); viewMatrix.m32(0); Matrix4f modelViewMatrix = transformation.getModelViewMatrix(skyBox, viewMatrix); skyBoxShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); skyBoxShaderProgram.setUniform(\"ambientLight\", scene.getSceneLight().getAmbientLight()); scene.getSkyBox().getMesh().render(); skyBoxShaderProgram.unbind(); } \u4e0a\u8ff0\u65b9\u6cd5\u4e0e\u5176\u4ed6\u6e32\u67d3\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u4e00\u4e2a\u4e0d\u540c\u4e4b\u5904\u9700\u8981\u89e3\u91ca\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u50cf\u5e73\u5e38\u4e00\u6837\u4f20\u9012\u6295\u5f71\u77e9\u9635\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u4f46\u5f53\u53d6\u5f97\u89c2\u5bdf\u77e9\u9635\u65f6\uff0c\u6211\u4eec\u5c06\u5176\u4e00\u4e9b\u6570\u503c\u8bbe\u7f6e\u4e3a0\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u5176\u4e2d\u7684\u539f\u56e0\u662f\u6211\u4eec\u4e0d\u5e0c\u671b\u5929\u7a7a\u76d2\u88ab\u79fb\u52a8\u3002 \u8bf7\u8bb0\u4f4f\uff0c\u5f53\u6211\u4eec\u5728\u79fb\u52a8\u6444\u50cf\u673a\u65f6\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58\uff0c\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u5929\u7a7a\u76d2\u4e5f\u5c06\u79fb\u52a8\u3002\u4f46\u662f\u6211\u4eec\u4e0d\u60f3\u8fd9\u6837\uff0c\u6211\u4eec\u60f3\u628a\u5b83\u56fa\u5b9a\u5728\u5750\u6807\u539f\u70b9(0, 0, 0)\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u79fb\u589e\u91cf\u90e8\u5206\uff08 m30 , m31 \u548c m32 \uff09\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u8ba4\u4e3a\u53ef\u4ee5\u907f\u514d\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u5fc5\u987b\u56fa\u5b9a\u5728\u539f\u70b9\u3002\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u5929\u7a7a\u76d2\u4e0d\u4f1a\u968f\u7740\u6444\u50cf\u673a\u65cb\u8f6c\uff0c\u8fd9\u4e0d\u662f\u6211\u4eec\u60f3\u8981\u7684\u3002\u56e0\u6b64\u6211\u4eec\u9700\u8981\u65cb\u8f6c\u5b83\u4f46\u4e0d\u8981\u79fb\u52a8\u5b83\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\uff0c\u4f60\u53ef\u4ee5\u67e5\u9605\u672c\u7ae0\u6e90\u4ee3\u7801\uff0c\u672c\u4f8b\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e86\u66f4\u591a\u7684\u65b9\u5757\u5b9e\u4f8b\u6765\u6a21\u62df\u5730\u9762\u548c\u5929\u7a7a\u76d2\u3002\u4f60\u4e5f\u53ef\u4ee5\u6539\u53d8\u73af\u5883\u5149\u6765\u6a21\u62df\u5149\u7167\u548c\u663c\u591c\u4ea4\u66ff\u3002\u6700\u7ec8\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u6548\u679c\uff1a \u5929\u7a7a\u76d2\u662f\u4e00\u4e2a\u5c0f\u7acb\u65b9\u4f53\uff08\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u5b83\u5e94\u8be5\u5927\u5f97\u591a\uff09\uff0c\u6240\u4ee5\u4f60\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u65f6\uff0c\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u770b\u5230\u5176\u6548\u679c\u3002\u4f60\u8fd8\u53ef\u4ee5\u770b\u5230\uff0c\u6784\u6210\u5730\u9762\u7684\u65b9\u5757\u6bd4\u5929\u7a7a\u76d2\u5927\uff0c\u6240\u4ee5\u5f53\u4f60\u79fb\u52a8\u65f6\uff0c\u4f60\u4f1a\u770b\u5230\u4ece\u5c71\u4e2d\u5192\u51fa\u7684\u65b9\u5757\u3002\u8fd9\u5f88\u660e\u663e\uff0c\u56e0\u4e3a\u6211\u4eec\u8bbe\u7f6e\u7684\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u3002\u4f46\u65e0\u8bba\u5982\u4f55\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u9690\u85cf\u548c\u6a21\u7cca\u8fdc\u5904\u7684\u7269\u4f53\u7684\u6548\u679c\uff08\u4f8b\u5982\u4f7f\u7528\u96fe\u6548\u679c\uff09\u6765\u51cf\u8f7b\u8fd9\u79cd\u5f71\u54cd\u3002 \u4e0d\u521b\u5efa\u66f4\u5927\u7684\u5929\u7a7a\u76d2\u7684\u53e6\u4e00\u4e2a\u539f\u56e0\u662f\u6211\u4eec\u9700\u8981\u51e0\u4e2a\u4f18\u5316\u6765\u63d0\u5347\u6548\u7387\uff08\u7a0d\u540e\u5bf9\u6b64\u8fdb\u884c\u89e3\u91ca\uff09\u3002 \u53ef\u4ee5\u6ce8\u91ca\u6e32\u67d3\u65b9\u6cd5\u4e2d\u9632\u6b62\u5929\u7a7a\u76d2\u79fb\u52a8\u7684\u4ee3\u7801\uff0c\u7136\u540e\u4f60\u5c31\u53ef\u4ee5\u5728\u5929\u7a7a\u76d2\u5916\u770b\u5230\u5982\u4e0b\u6240\u793a\u56fe\u50cf\uff1a \u867d\u7136\u8fd9\u4e0d\u662f\u5929\u7a7a\u76d2\u8be5\u505a\u7684\uff0c\u4f46\u8fd9\u53ef\u4ee5\u5e2e\u52a9\u4f60\u7406\u89e3\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u5176\u4ed6\u6548\u679c\u6765\u6539\u5584\u5b83\uff0c\u6bd4\u5982\u592a\u9633\u5728\u5929\u7a79\u79fb\u52a8\u6216\u4e91\u5c42\u79fb\u52a8\u3002\u6b64\u5916\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u4e16\u754c\uff0c\u4f60\u9700\u8981\u5c06\u4e16\u754c\u5206\u5272\u6210\u533a\u57df\uff0c\u53ea\u52a0\u8f7d\u90a3\u4e9b\u4e0e\u73a9\u5bb6\u6240\u5904\u7684\u533a\u57df\u76f8\u90bb\u7684\u533a\u57df\u3002 \u53e6\u5916\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff1a\u4ec0\u4e48\u65f6\u5019\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u8fd8\u662f\u4e4b\u540e\uff1f\u5728\u6e32\u67d3\u573a\u666f\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\u66f4\u4f18\uff0c\u56e0\u4e3a\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5927\u591a\u6570\u7247\u5143\u5c06\u88ab\u4e22\u5f03\u3002\u5f53OpenGL\u5c1d\u8bd5\u6e32\u67d3\u5b83\u4eec\uff0c\u5e76\u4e14\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u65f6\uff0c\u5c06\u4e22\u5f03\u4e00\u4e9b\u4f4d\u4e8e\u5148\u524d\u6e32\u67d3\u7684\u7247\u5143\u4e4b\u540e\u7684\u7247\u5143\uff0c\u8fd9\u4e9b\u7247\u5143\u7684\u6df1\u5ea6\u503c\u66f4\u4f4e\u3002\u6240\u4ee5\u7b54\u6848\u5f88\u660e\u663e\uff0c\u5bf9\u5427\uff1f\u6e32\u67d3\u573a\u666f\u540e\uff0c\u518d\u6e32\u67d3\u5929\u7a7a\u76d2\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5728\u5904\u7406\u900f\u660e\u7eb9\u7406\u65f6\uff0c\u5982\u679c\u5728\u573a\u666f\u4e2d\u6211\u4eec\u6709\u5e94\u7528\u900f\u660e\u7eb9\u7406\u7684\u7269\u4f53\uff0c\u5b83\u4eec\u5c06\u4f7f\u7528\u201c\u80cc\u666f\u201d\u8272\u7ed8\u5236\uff0c\u672c\u4f8b\u4e2d\u662f\u9ed1\u8272\u3002\u4f46\u5982\u679c\u6211\u4eec\u5148\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u90a3\u4e48\u5c06\u4f1a\u6b63\u786e\u5730\u5e94\u7528\u900f\u660e\u6548\u679c\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5e94\u8be5\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\u5417\uff1f\u5173\u952e\u5728\u4e8e\u4f60\u7684\u9009\u62e9\u3002\u5982\u679c\u4f60\u5728\u6e32\u67d3\u573a\u666f\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u53ef\u4ee5\u89e3\u51b3\u900f\u660e\u7eb9\u7406\u95ee\u9898\uff0c\u4f46\u662f\u4f1a\u5f71\u54cd\u6027\u80fd\u3002\u5b9e\u9645\u4e0a\uff0c\u5c31\u7b97\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f60\u4e5f\u53ef\u80fd\u9762\u4e34\u900f\u660e\u95ee\u9898\u3002\u5047\u8bbe\u4f60\u6709\u4e00\u4e2a\u900f\u660e\u7684\u7269\u4f53\uff0c\u5b83\u4e0e\u8fdc\u5904\u7684\u7269\u4f53\u91cd\u53e0\uff0c\u5982\u679c\u9996\u5148\u6e32\u67d3\u900f\u660e\u5bf9\u8c61\uff0c\u90a3\u4e48\u4e5f\u4f1a\u51fa\u73b0\u900f\u660e\u95ee\u9898\u3002\u56e0\u6b64\uff0c\u4e5f\u8bb8\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u5728\u6240\u6709\u5176\u4ed6\u9879\u88ab\u6e32\u67d3\u540e\uff0c\u5355\u72ec\u7ed8\u5236\u900f\u660e\u7684\u9879\u3002\u8fd9\u662f\u4e00\u4e9b\u5546\u4e1a\u6e38\u620f\u4f7f\u7528\u7684\u65b9\u6cd5\u3002\u4e0d\u8fc7\u73b0\u5728\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u4ee5\u83b7\u5f97\u66f4\u9ad8\u7684\u6027\u80fd\u3002","title":"\u5929\u7a7a\u76d2"},{"location":"13-sky-box-and-some-optimizations/#_2","text":"\u4ece\u4e0a\u8ff0\u793a\u4f8b\u6765\u770b\uff0c\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u4f7f\u5f97\u5176\u6548\u679c\u6709\u70b9\u5947\u602a\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u7269\u4f53\u795e\u5947\u5730\u4ece\u5c71\u4f53\u51fa\u73b0\uff09\u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u589e\u52a0\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u548c\u4e16\u754c\u7684\u5927\u5c0f\uff0c\u5c06\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u653e\u592750\u500d\uff0c\u8fd9\u6837\u4e16\u754c\u753140,000\u4e2a\u6e38\u620f\u9879\u5b9e\u4f8b\uff08\u65b9\u5757\uff09\u7ec4\u6210\u3002 \u5982\u679c\u4f60\u66f4\u6539\u7f29\u653e\u5e76\u91cd\u65b0\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u53d1\u73b0\u5f00\u59cb\u51fa\u73b0\u6027\u80fd\u95ee\u9898\uff0c\u5e76\u4e14\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u4e0d\u987a\u7545\u3002\u73b0\u5728\u662f\u65f6\u5019\u5173\u6ce8\u4e00\u4e0b\u6027\u80fd\u4e86\uff08\u4f60\u53ef\u80fd\u542c\u8fc7\u4e00\u53e5\u8001\u8bdd\uff1a\u201c\u8fc7\u65e9\u7684\u4f18\u5316\u662f\u4e07\u6076\u4e4b\u6e90\u201d\uff0c\u4f46\u662f\u4ece\u672c\u7ae0\u5f00\u59cb\uff0c\u6211\u5e0c\u671b\u6ca1\u6709\u4eba\u4f1a\u8bf4\u8fd9\u662f\u8fc7\u65e9\u7684\uff09\u3002 \u8ba9\u6211\u6765\u4ecb\u7ecd\u4e00\u4e2a\u6982\u5ff5\uff0c\u5b83\u80fd\u51cf\u5c11\u6b63\u5728\u6e32\u67d3\u7684\u6570\u636e\u6570\u91cf\uff0c\u5b83\u53eb\u505a\u9762\u5254\u9664\uff08Face Culling\uff09\u3002\u5728\u793a\u4f8b\u4e2d\uff0c\u6211\u4eec\u6e32\u67d3\u4e86\u6210\u5343\u4e0a\u4e07\u4e2a\u7acb\u65b9\u4f53\uff0c\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u7ec4\u6210\u7684\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u6bcf\u4e2a\u7acb\u65b9\u4f53\u7684\u516d\u4e2a\u9762\uff0c\u5373\u4f7f\u5b83\u4eec\u6709\u4e9b\u662f\u770b\u4e0d\u5230\u7684\u3002\u8fdb\u5165\u4e00\u4e2a\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4f60\u4f1a\u770b\u5230\u5b83\u7684\u5185\u90e8\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4e0d\u80fd\u88ab\u770b\u5230\u7684\u9762\u5e94\u8be5\u7acb\u5373\u820d\u5f03\uff0c\u8fd9\u5c31\u662f\u9762\u5254\u9664\u7684\u4f5c\u7528\u3002\u5b9e\u9645\u4e0a\uff0c\u5bf9\u4e8e\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u4f60\u6700\u591a\u53ea\u80fd\u540c\u65f6\u770b\u5230\u4e09\u4e2a\u9762\uff0c\u6240\u4ee5\u53ea\u80fd\u901a\u8fc7\u4f7f\u7528\u9762\u5254\u9664\uff08\u5982\u679c\u4f60\u7684\u6e38\u620f\u4e0d\u8981\u6c42\u4f60\u8fdb\u5165\u6a21\u578b\u7684\u5185\u90e8\uff0c\u8fd9\u6837\u505a\u624d\u662f\u9ad8\u6548\u7684\uff0c\u7a0d\u540e\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\uff09\u6765\u820d\u5f03\u4e00\u534a\u7684\u9762\uff0840,000\u00d73\u00d72\u4e2a\u4e09\u89d2\u5f62\uff09\u3002 \u9762\u5254\u9664\u68c0\u67e5\u6bcf\u4e2a\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e22\u5f03\u90a3\u4e9b\u4e0d\u9762\u5411\u6444\u50cf\u673a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u662f\uff0c\u5982\u4f55\u77e5\u9053\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\u5462\uff1f\u597d\u5427\uff0cOpenGL\u5b9e\u73b0\u5b83\u7684\u65b9\u5f0f\u662f\u901a\u8fc7\u68c0\u67e5\u7ec4\u6210\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002 \u8bb0\u5f97\u4ece\u7b2c\u4e00\u7ae0\u5f00\u59cb\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u4ee5\u987a\u65f6\u9488\u6216\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u3002\u5728OpenGL\u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u6444\u50cf\u673a\uff0c\u800c\u4ee5\u987a\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u76f8\u53cd\u7684\u65b9\u5411\u3002\u5173\u952e\u662f\u5728\u8003\u8651\u6444\u50cf\u673a\u7684\u60c5\u51b5\u4e0b\uff0c\u68c0\u67e5\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002\u56e0\u6b64\uff0c\u6309\u7167\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u4e09\u89d2\u5f62\u53ef\u4ee5\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u5b9e\u73b0\u5b83\uff0c\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e0b\u8ff0\u4ee3\u7801\uff1a glEnable(GL_CULL_FACE); glCullFace(GL_BACK); \u7b2c\u4e00\u884c\u4ee3\u7801\u5c06\u542f\u7528\u9762\u5254\u9664\uff0c\u7b2c\u4e8c\u884c\u4ee3\u7801\u8bbe\u7f6e\u80cc\u5411\u9762\u4e3a\u9700\u8981\u5254\u9664\u7684\u9762\u3002\u5982\u679c\u5411\u4e0a\u770b\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u60c5\u666f\uff1a \u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u5982\u679c\u4f60\u67e5\u770b\u9876\u9762\u7684\u9876\u70b9\u987a\u5e8f\uff0c\u5c06\u770b\u5230\u5b83\u662f\u6309\u9006\u65f6\u9488\u5b9a\u4e49\u7684\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u73af\u7ed5\u987a\u5e8f\u662f\u4ee5\u6444\u50cf\u673a\u4e3a\u89c6\u89d2\u3002\u5b9e\u9645\u4e0a\uff0c\u5982\u679c\u4f60\u8ba9\u4f4d\u79fb\u5f71\u54cd\u5929\u7a7a\u76d2\u4ee5\u4fbf\u80fd\u4ece\u5176\u4e0a\u65b9\u89c2\u5bdf\u5b83\u65f6\uff0c\u5219\u5f53\u4f60\u5728\u5929\u7a7a\u76d2\u5916\u65f6\uff0c\u5c06\u770b\u5230\u9876\u9762\u518d\u6b21\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u63cf\u8ff0\u4e00\u4e0b\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5929\u7a7a\u76d2\u7acb\u65b9\u4f53\u7684\u9876\u9762\u4e09\u89d2\u5f62\u4e2d\u7684\u4e00\u4e2a\u4e09\u89d2\u5f62\uff0c\u5b83\u7531\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u7684\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\uff1a \u4f46\u8981\u8bb0\u4f4f\uff0c\u6211\u4eec\u662f\u5728\u5929\u7a7a\u76d2\u91cc\uff0c\u5982\u679c\u4ece\u5185\u90e8\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u4f1a\u770b\u5230\u9876\u70b9\u662f\u6309\u987a\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u3002 \u8fd9\u662f\u56e0\u4e3a\u5929\u7a7a\u76d2\u88ab\u5b9a\u4e49\u4e3a\u4ece\u5916\u90e8\u89c2\u5bdf\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u7ffb\u8f6c\u4e00\u4e9b\u9762\u7684\u5b9a\u4e49\uff0c\u4ee5\u4fbf\u5728\u542f\u7528\u9762\u5254\u9664\u65f6\u80fd\u6b63\u786e\u5730\u6e32\u67d3\u5b83\u3002 \u4f46\u8fd9\u4ecd\u6709\u66f4\u5927\u7684\u4f18\u5316\u7a7a\u95f4\u3002\u56de\u987e\u4e00\u4e0b\u6e32\u67d3\u6d41\u7a0b\uff0c\u5728 Renderer \u7c7b render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u904d\u5386 GameItem \u6570\u7ec4\u5e76\u6e32\u67d3\u76f8\u5173\u7684 Mesh \u3002\u5bf9\u6bcf\u4e2a GameItem \uff0c\u6211\u4eec\u505a\u4e86\u4e0b\u8ff0\u5de5\u4f5c\uff1a \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u7684\u552f\u4e00\u503c\uff09\u3002 \u83b7\u53d6 GameItem \u50a8\u5b58\u7684 Mesh \u5e76\u7ed1\u5b9a\u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u6267\u884c\u8c03\u7528\u4ee5\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u505c\u7528\u7eb9\u7406\u548cVAO\u3002 \u4f46\u5728\u73b0\u5728\u7684\u6e38\u620f\u4e2d\uff0c40,000\u4e2a GameItem \u90fd\u4f7f\u7528\u76f8\u540c\u7684 Mesh \uff0c\u800c\u6211\u4eec\u4e00\u6b21\u53c8\u4e00\u6b21\u5730\u91cd\u590d\u7b2c\u4e8c\u9879\u5230\u7b2c\u56db\u9879\u7684\u64cd\u4f5c\u3002\u8fd9\u4e0d\u662f\u5f88\u9ad8\u6548\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u5bf9OpenGL\u51fd\u6570\u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u662f\u6709\u6027\u80fd\u5f00\u9500\u7684\u672c\u5730\u8c03\u7528\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5e94\u8be5\u5c3d\u91cf\u9650\u5236OpenGL\u4e2d\u7684\u72b6\u6001\u53d8\u5316\uff08\u7ed1\u5b9a\u548c\u505c\u7528\u7eb9\u7406\u3001VAO\u90fd\u662f\u72b6\u6001\u53d8\u5316\uff09\u3002 \u6211\u4eec\u9700\u8981\u6539\u53d8\u5f00\u53d1\u7684\u65b9\u5f0f\uff0c\u56f4\u7ed5\u7f51\u683c\u7ec4\u7ec7\u4ee3\u7801\u7ed3\u6784\uff0c\u56e0\u4e3a\u7ecf\u5e38\u6709\u8bb8\u591a\u6e38\u620f\u9879\u4f7f\u7528\u76f8\u540c\u7684\u7f51\u683c\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e00\u4e2a\u6e38\u620f\u9879\u6570\u7ec4\uff0c\u6bcf\u9879\u90fd\u6307\u5411\u540c\u4e00\u4e2a\u7f51\u683c\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4f5c\u4e3a\u66ff\u4ee3\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5176\u4e2d\u5305\u62ec\u50a8\u5b58\u5171\u4eab\u8be5\u7f51\u683c\u7684\u6240\u6709\u6e38\u620f\u9879\u3002 \u5bf9\u4e8e\u6bcf\u4e00\u4e2a Mesh \uff0c\u6e32\u67d3\u6b65\u9aa4\u5c06\u4f1a\u662f\uff1a \u83b7\u53d6\u4e0e GameItem \u76f8\u5173\u8054\u7684 Mesh \u5e76\u7ed1\u5b9a Mesh \u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u76f8\u5173\u7684 GameItem \uff1a a. \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u552f\u4e00\u7684\uff09\u3002 b. \u8c03\u7528\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u89e3\u7ed1\u7eb9\u7406\u548cVAO\u3002 \u5728 Scene \u7c7b\u4e2d\u50a8\u5b58\u4e0b\u8ff0 Map \uff1a private Map<Mesh, List<GameItem>> meshMap; \u6211\u4eec\u4ecd\u6709 setGameItems \u65b9\u6cd5\uff0c\u4f46\u6211\u4eec\u4e0d\u53ea\u662f\u50a8\u5b58\u6570\u7ec4\uff0c\u800c\u662f\u6784\u9020\u7f51\u683c\u6620\u5c04\u8868\u3002 public void setGameItems(GameItem[] gameItems) { int numGameItems = gameItems != null ? gameItems.length : 0; for (int i=0; i<numGameItems; i++) { GameItem gameItem = gameItems[i]; Mesh mesh = gameItem.getMesh(); List<GameItem> list = meshMap.get(mesh); if ( list == null ) { list = new ArrayList<>(); meshMap.put(mesh, list); } list.add(gameItem); } } Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u6e32\u67d3\u4e0e\u5176\u76f8\u5173\u7684 GameItem \u5217\u8868\uff0c\u7136\u540e\u5c06\u7ed1\u5b9a\u548c\u89e3\u7ed1\u4ee3\u7801\u5206\u4e3a\u4e0d\u540c\u7684\u65b9\u6cd5\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } private void endRender() { // \u6062\u590d\u72b6\u6001 glDisableVertexAttribArray(0); glDisableVertexAttribArray(1); glDisableVertexAttribArray(2); glBindVertexArray(0); glBindTexture(GL_TEXTURE_2D, 0); } public void render() { initRender(); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); endRender(); } public void renderList(List<GameItem> gameItems, Consumer<GameItem> consumer) { initRender(); for (GameItem gameItem : gameItems) { // \u8bbe\u7f6e\u6e38\u620f\u9879\u76ee\u6240\u9700\u7684\u6e32\u67d3\u6570\u636e consumer.accept(gameItem); // \u6e32\u67d3\u6e38\u620f\u9879\u76ee glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); } endRender(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4ecd\u7136\u4fdd\u7559\u4e86\u65e7\u65b9\u6cd5\uff0c\u5b83\u8fd4\u56de\u4e00\u4e2a Mesh \uff0c\u8fd9\u662f\u8003\u8651\u5230\u5982\u679c\u53ea\u6709\u4e00\u4e2a GameItem \u7684\u60c5\u51b5\uff08\u8fd9\u53ef\u80fd\u5728\u5176\u4ed6\u60c5\u51b5\u4e0b\u4f7f\u7528\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0d\u79fb\u9664\u5b83\uff09\u3002\u65b0\u7684\u65b9\u6cd5\u6e32\u67d3\u4e00\u4e2a List<GameItem> \uff0c\u5e76\u63a5\u53d7\u4e00\u4e2a Counsumer \u7c7b\u578b\u7684\u53c2\u6570\uff08\u4e00\u4e2a\u51fd\u6570\uff0c\u4f7f\u7528\u4e86Java8\u5f15\u5165\u7684\u51fd\u6570\u5f0f\u7f16\u7a0b\uff09\uff0c\u5b83\u5c06\u7528\u4e8e\u5728\u7ed8\u5236\u4e09\u89d2\u5f62\u4e4b\u524d\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u7279\u5b9a\u7684\u5185\u5bb9\uff0c\u56e0\u4e3a\u4e0d\u5e0c\u671b Mesh \u7c7b\u4e0eUniform\u7684\u540d\u79f0\u548c\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u65f6\u6240\u6d89\u53ca\u7684\u53c2\u6570\u76f8\u8026\u5408\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u6765\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u4e2d\u7684 renderScene \u65b9\u6cd5\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u9700\u904d\u5386\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5e76\u901a\u8fc7Lambda\u8868\u8fbe\u5f0f\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002 for (Mesh mesh : mapMeshes.keySet()) { sceneShaderProgram.setUniform(\"material\", mesh.getMaterial()); mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); sceneShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u53ef\u4ee5\u505a\u7684\u53e6\u4e00\u9879\u4f18\u5316\u662f\uff0c\u6211\u4eec\u5728\u6e32\u67d3\u5468\u671f\u4e2d\u521b\u5efa\u4e86\u5927\u91cf\u5bf9\u8c61\u3002\u7279\u522b\u662f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u592a\u591a\u7684 Matrix4f \u5b9e\u4f8b\uff0c\u5b83\u4eec\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u4fdd\u5b58\u4e86\u4e00\u4e2a\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002\u6211\u4eec\u5e94\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u7279\u5b9a\u7684\u77e9\u9635\uff0c\u5e76\u91cd\u7528\u76f8\u540c\u7684\u5b9e\u4f8b\u3002\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f1a\u770b\u5230\u6211\u4eec\u5df2\u7ecf\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u540d\u79f0\uff0c getXX \u65b9\u6cd5\u53ea\u8fd4\u56de\u50a8\u5b58\u7684\u77e9\u9635\u5b9e\u4f8b\uff0c\u5e76\u4e14\u4efb\u4f55\u66f4\u6539\u77e9\u9635\u503c\u7684\u65b9\u6cd5\u90fd\u79f0\u4e3a buildXX \uff0c\u4ee5\u9610\u660e\u5176\u7528\u9014\u3002 \u6211\u4eec\u4e5f\u907f\u514d\u4e86\u6bcf\u6b21\u4e3a\u77e9\u9635\u8bbe\u7f6eUniform\u65f6\u6784\u9020\u65b0\u7684 FloatBuffer \u5b9e\u4f8b\uff0c\u5e76\u79fb\u9664\u4e86\u5176\u4ed6\u4e00\u4e9b\u65e0\u7528\u7684\u5b9e\u4f8b\u5316\u64cd\u4f5c\u3002\u6709\u4e86\u8fd9\u4e9b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u66f4\u6d41\u7545\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u4e86\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6240\u6709\u7ec6\u8282\u3002","title":"\u4e00\u4e9b\u4f18\u5316"},{"location":"14-height-maps/","text":"\u9ad8\u5ea6\u56fe\uff08Height Maps\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u9ad8\u5ea6\u56fe\u521b\u5efa\u590d\u6742\u7684\u5730\u5f62\u3002\u5728\u5f00\u59cb\u524d\uff0c\u4f60\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e9b\u65b0\u7684\u5305\u548c\u79fb\u52a8\u4e86\u4e00\u4e9b\u7c7b\u4ee5\u66f4\u597d\u5730\u7ec4\u7ec7\u5b83\u4eec\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u8fd9\u4e9b\u6539\u53d8\u3002 \u6240\u4ee5\u4ec0\u4e48\u662f\u9ad8\u5ea6\u56fe\uff1f\u9ad8\u5ea6\u56fe\u662f\u7528\u4e8e\u751f\u6210\u4e09\u7ef4\u5730\u5f62\u7684\u56fe\u50cf\uff0c\u5b83\u4f7f\u7528\u50cf\u7d20\u989c\u8272\u6765\u83b7\u53d6\u8868\u9762\u9ad8\u5ea6\u3002\u9ad8\u5ea6\u56fe\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5b83\u53ef\u4ee5\u7531 Terragen \u7b49\u8f6f\u4ef6\u751f\u6210\u3002\u4e00\u5f20\u9ad8\u5ea6\u56fe\u56fe\u50cf\u770b\u8d77\u6765\u5c31\u50cf\u8fd9\u6837\u3002 \u4e0a\u56fe\u5c31\u50cf\u4f60\u4fef\u89c6\u4e00\u7247\u9646\u5730\u4e00\u6837\u3002\u5229\u7528\u4e0a\u56fe\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u7531\u9876\u70b9\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u6240\u7ec4\u6210\u7684\u7f51\u683c\u3002\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u5c06\u6839\u636e\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u3002\u9ed1\u8272\u662f\u6700\u4f4e\uff0c\u767d\u8272\u662f\u6700\u9ad8\u3002 \u6211\u4eec\u5c06\u4e3a\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u7ec4\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5c06\u7ec4\u6210\u4e09\u89d2\u5f62\uff0c\u8fd9\u4e9b\u4e09\u89d2\u5f62\u5c06\u7ec4\u6210\u4e0b\u56fe\u6240\u793a\u7684\u7f51\u683c\u3002 \u7f51\u683c\u5c06\u7ec4\u6210\u4e00\u4e2a\u5de8\u5927\u7684\u56db\u8fb9\u5f62\uff0c\u5b83\u5c06\u4f1a\u5728X\u548cZ\u8f74\u4e0a\u6e32\u67d3\uff0c\u5e76\u6839\u636e\u50cf\u7d20\u989c\u8272\u6765\u6539\u53d8\u5b83\u7684Y\u8f74\u9ad8\u5ea6\u3002 \u7531\u9ad8\u5ea6\u56fe\u521b\u5efa\u4e09\u7ef4\u5730\u5f62\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u6b65\u9aa4\uff1a * \u52a0\u8f7d\u50a8\u5b58\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf(\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a BufferedImage \u5b9e\u4f8b\u4ee5\u83b7\u53d6\u6bcf\u4e2a\u50cf\u7d20)\u3002 * \u4e3a\u6bcf\u4e2a\u56fe\u50cf\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u5176\u9ad8\u5ea6\u57fa\u4e8e\u50cf\u7d20\u989c\u8272\u3002 * \u5c06\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u9876\u70b9\u3002 * \u8bbe\u7f6e\u7d22\u5f15\u4ee5\u7ed8\u5236\u4e0e\u9876\u70b9\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a HeightMapMesh \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u6309\u4ee5\u4e0a\u6b65\u9aa4\u521b\u5efa\u4e00\u4e2a Mesh \u3002\u8ba9\u6211\u4eec\u5148\u770b\u770b\u8be5\u7c7b\u5b9a\u4e49\u7684\u5e38\u91cf\uff1a private static final int MAX_COLOUR = 255 * 255 * 255; \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u3002\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5bf9\u4e8ePNG\u56fe\u50cf\u6765\u8bf4\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u50cf\u7d20\u7684\u6bcf\u4e2aRGB\u503c\u53ef\u4ee5\u57280\u5230255\u4e4b\u95f4\u53d8\u5316\uff0c\u56e0\u6b64\u6211\u4eec\u6709256\u4e2a\u503c\u6765\u8868\u793a\u4e0d\u540c\u7684\u9ad8\u5ea6\u3002\u8fd9\u53ef\u80fd\u8db3\u591f\u4e86\uff0c\u4f46\u5982\u679c\u7cbe\u5ea6\u4e0d\u591f\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e09\u4e2aRGB\u503c\u4ee5\u6709\u66f4\u591a\u7684\u503c\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9ad8\u5ea6\u8ba1\u7b97\u8303\u56f4\u4e3a0\u5230255^3\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u5c40\u9650\u4e8e\u7070\u5ea6\u56fe\u3002 \u63a5\u4e0b\u6765\u7684\u5e38\u91cf\u662f\uff1a private static final float STARTX = -0.5f; private static final float STARTZ = -0.5f; \u7f51\u683c\u5c06\u7531\u4e00\u7ec4\u9876\u70b9\uff08\u4e00\u4e2a\u9876\u70b9\u5bf9\u5e94\u4e00\u4e2a\u50cf\u7d20\uff09\u6784\u6210\uff0c\u5176X\u548cZ\u5750\u6807\u7684\u8303\u56f4\u5982\u4e0b * X\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTX , -STARTX ]\u3002 * Z\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTZ , -STARTZ ]\u3002 \u4e0d\u7528\u592a\u8fc7\u62c5\u5fc3\u8fd9\u4e9b\u503c\uff0c\u7a0d\u540e\u5f97\u5230\u7684\u7f51\u683c\u53ef\u4ee5\u88ab\u7f29\u653e\u4ee5\u9002\u5e94\u4e16\u754c\u7684\u5927\u5c0f\u3002\u5173\u4e8eY\u8f74\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e minY \u548c maxY \u4e24\u4e2a\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6eY\u5750\u6807\u7684\u6700\u4f4e\u548c\u6700\u9ad8\u503c\u3002\u8fd9\u4e9b\u53c2\u6570\u5e76\u4e0d\u662f\u5e38\u6570\uff0c\u56e0\u4e3a\u6211\u4eec\u53ef\u80fd\u5e0c\u671b\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u5b83\u4eec\uff0c\u800c\u4e0d\u4f7f\u7528\u7f29\u653e\u3002\u6700\u540e\uff0c\u5730\u5f62\u5c06\u5305\u542b\u5728\u8303\u56f4\u4e3a [STARTX, -STARTX] \uff0c [minY, maxY] \uff0c [STARTZ, -STARTZ] \u7684\u7acb\u65b9\u4f53\u5185\u3002 \u7f51\u683c\u5c06\u4f1a\u5728 HeightMapMesh \u7c7b\u7684\u6784\u9020\u51fd\u6570\u4e2d\u521b\u5efa\uff0c\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u3002 public HeightMapMesh(float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { \u5b83\u63a5\u6536Y\u8f74\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\uff0c\u88ab\u7528\u4f5c\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf\u6587\u4ef6\u540d\u548c\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u6587\u4ef6\u540d\u3002\u5b83\u8fd8\u63a5\u53d7\u4e00\u4e2a\u540d\u4e3a textInc \u7684\u6574\u6570\uff0c\u8fd9\u7a0d\u540e\u518d\u8bf4\u660e\u3002 \u6211\u4eec\u5728\u6784\u9020\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5c06\u9ad8\u5ea6\u56fe\u56fe\u50cf\u52a0\u8f7d\u5230 BufferedImage \u5b9e\u4f8b\u4e2d\u3002 this.minY = minY; this.maxY = maxY; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); \u7136\u540e\uff0c\u6211\u4eec\u5c06\u7eb9\u7406\u6587\u4ef6\u8f7d\u5165\u5230\u4e00\u4e2a ByteBuffer \u4e2d\uff0c\u5e76\u8bbe\u7f6e\u6784\u9020 Mesh \u6240\u9700\u7684\u53d8\u91cf\u3002 incx \u548c incz \u53d8\u91cf\u5c06\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684X\u6216Z\u5750\u6807\u4e4b\u95f4\u7684\u6700\u5c0f\u95f4\u9694\uff0c\u56e0\u6b64 Mesh \u5305\u542b\u5728\u4e0a\u8ff0\u533a\u57df\u4e2d\u3002 Texture texture = new Texture(textureFile); float incx = getWidth() / (width - 1); float incz = Math.abs(STARTZ * 2) / (height - 1); List<Float> positions = new ArrayList(); List<Float> textCoords = new ArrayList(); List<Integer> indices = new ArrayList(); \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u904d\u5386\u56fe\u50cf\uff0c\u4e3a\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u8bbe\u7f6e\u5176\u7eb9\u7406\u5750\u6807\u4e0e\u7d22\u5f15\uff0c\u4ee5\u6b63\u786e\u5730\u5b9a\u4e49\u7ec4\u6210 Mesh \u7684\u4e09\u89d2\u5f62\u3002 for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { // \u4e3a\u5f53\u524d\u4f4d\u7f6e\u521b\u5efa\u9876\u70b9 positions.add(STARTX + col * incx); // x positions.add(getHeight(col, row, width, buf)); // y positions.add(STARTZ + row * incz); // z // \u8bbe\u7f6e\u7eb9\u7406\u5750\u6807 textCoords.add((float) textInc * (float) col / (float) width); textCoords.add((float) textInc * (float) row / (float) height); // \u521b\u5efa\u7d22\u5f15 if (col < width - 1 && row < height - 1) { int leftTop = row * width + col; int leftBottom = (row + 1) * width + col; int rightBottom = (row + 1) * width + col + 1; int rightTop = row * width + col + 1; indices.add(rightTop); indices.add(leftBottom); indices.add(leftTop); indices.add(rightBottom); indices.add(leftBottom); indices.add(rightTop); } } } \u521b\u5efa\u9876\u70b9\u5750\u6807\u7684\u8fc7\u7a0b\u662f\u4e0d\u9700\u8981\u89e3\u91ca\u7684\u3002\u73b0\u5728\u5148\u522b\u7ba1\u4e3a\u4ec0\u4e48\u6211\u4eec\u7528\u4e00\u4e2a\u6570\u5b57\u4e58\u4ee5\u7eb9\u7406\u5750\u6807\u4ee5\u53ca\u5982\u4f55\u8ba1\u7b97\u9ad8\u5ea6\u3002\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15(\u9664\u975e\u73b0\u5728\u662f\u6700\u540e\u4e00\u884c\u6216\u6700\u540e\u4e00\u5217)\u3002\u8ba9\u6211\u4eec\u7528\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u6765\u60f3\u8c61\u5b83\u4eec\u662f\u5982\u4f55\u6784\u9020\u7684\u3002\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u5305\u542b9\u4e2a\u9876\u70b9\uff0c\u6bcf\u56e0\u6b64\u6709 2\u00d74 \u4e2a\u4e09\u89d2\u5f62\u7ec4\u62104\u4e2a\u6b63\u65b9\u5f62\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u88ab\u547d\u540d\u4e3a Vrc (r\uff1a\u884c\uff0cc\uff1a\u5217)\u3002 \u5f53\u5904\u7406\u7b2c\u4e00\u4e2a\u9876\u70b9(V00)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002 \u5f53\u5904\u7406\u7b2c\u4e8c\u4e2a\u9876\u70b9(V01)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u53c8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002\u4f46\u5f53\u5904\u7406\u7b2c\u4e09\u4e2a\u9876\u70b9(V02)\u65f6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5b9a\u4e49\u66f4\u591a\u7684\u7d22\u5f15\uff0c\u8be5\u884c\u7684\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5df2\u88ab\u5b9a\u4e49\u3002 \u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u60f3\u5230\u5176\u4ed6\u9876\u70b9\u7684\u5904\u7406\u8fc7\u7a0b\u662f\u5982\u4f55\u8fdb\u884c\u7684\u3002\u73b0\u5728\uff0c\u4e00\u65e6\u521b\u5efa\u4e86\u6240\u6709\u7684\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u7528\u6240\u6709\u8fd9\u4e9b\u6570\u636e\u521b\u5efa Mesh \u548c\u76f8\u5173\u7684 Material \u3002 float[] posArr = Utils.listToArray(positions); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = calcNormals(posArr, width, height); this.mesh = new Mesh(posArr, textCoordsArr, normalsArr, indicesArr); Material material = new Material(texture, 0.0f); mesh.setMaterial(material); \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6839\u636e\u9876\u70b9\u4f4d\u7f6e\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5728\u770b\u5982\u4f55\u8ba1\u7b97\u6cd5\u7ebf\u4e4b\u524d\uff0c\u6765\u770b\u770b\u5982\u4f55\u83b7\u53d6\u9ad8\u5ea6\u5427\u3002\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a getHeight \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u8ba1\u7b97\u9876\u70b9\u7684\u9ad8\u5ea6\u3002 private float getHeight(int x, int z, int width, ByteBuffer buffer) { byte r = buffer.get(x * 4 + 0 + z * 4 * width); byte g = buffer.get(x * 4 + 1 + z * 4 * width); byte b = buffer.get(x * 4 + 2 + z * 4 * width); byte a = buffer.get(x * 4 + 3 + z * 4 * width); int argb = ((0xFF & a) << 24) | ((0xFF & r) << 16) | ((0xFF & g) << 8) | (0xFF & b); return this.minY + Math.abs(this.maxY - this.minY) * ((float) argb / (float) MAX_COLOUR); } \u8be5\u65b9\u6cd5\u63a5\u53d7\u50cf\u7d20\u7684X\u548cY\u5750\u6807\uff0c\u56fe\u50cf\u7684\u5bbd\u5ea6\u4ee5\u53ca\u4e0e\u4e4b\u76f8\u5173\u7684 ByteBuffer \uff0c\u8fd4\u56deRGB\u989c\u8272(R\u3001G\u3001B\u5206\u91cf\u4e4b\u548c)\u5e76\u8ba1\u7b97\u5305\u542b\u5728 minY \u548c maxY \u4e4b\u95f4\u7684\u503c( minY \u4e3a\u9ed1\u8272\uff0c maxY \u4e3a\u767d\u8272)\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528 BufferedImage \u6765\u7f16\u5199\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u5b83\u6709\u66f4\u65b9\u4fbf\u7684\u65b9\u6cd5\u6765\u83b7\u5f97RGB\u503c\uff0c\u4f46\u8fd9\u5c06\u4f7f\u7528AWT\u3002\u8bb0\u4f4fAWT\u4e0d\u80fd\u5f88\u597d\u7684\u517c\u5bb9OSX\uff0c\u6240\u4ee5\u5c3d\u91cf\u907f\u514d\u4f7f\u7528\u5b83\u7684\u7c7b\u3002 \u73b0\u5728\u6765\u770b\u770b\u5982\u4f55\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f\u5c06\u7eb9\u7406\u8986\u76d6\u6574\u4e2a\u7f51\u683c\uff0c\u5de6\u4e0a\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(0, 0)\uff0c\u53f3\u4e0b\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(1, 1)\u3002\u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u7eb9\u7406\u5fc5\u987b\u662f\u5de8\u5927\u7684\uff0c\u4ee5\u4fbf\u83b7\u5f97\u826f\u597d\u7684\u6e32\u67d3\u6548\u679c\uff0c\u5426\u5219\u7eb9\u7406\u5c06\u4f1a\u88ab\u8fc7\u5ea6\u62c9\u4f38\u3002 \u4f46\u6211\u4eec\u4ecd\u7136\u53ef\u4ee5\u4f7f\u7528\u975e\u5e38\u5c0f\u7684\u7eb9\u7406\uff0c\u901a\u8fc7\u4f7f\u7528\u9ad8\u6548\u7684\u6280\u672f\u6765\u83b7\u5f97\u5f88\u597d\u7684\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u8bbe\u7f6e\u8d85\u51fa[1, 1]\u8303\u56f4\u7684\u7eb9\u7406\u5750\u6807\uff0c\u6211\u4eec\u5c06\u56de\u5230\u539f\u70b9\u5e76\u91cd\u65b0\u5f00\u59cb\u8ba1\u7b97\u3002\u4e0b\u56fe\u8868\u793a\u5728\u51e0\u4e2a\u6b63\u65b9\u5f62\u4e2d\u5e73\u94fa\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u5e76\u8d85\u51fa\u4e86[1, 1]\u8303\u56f4\u3002 \u8fd9\u662f\u6211\u4eec\u5728\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\u65f6\u6240\u8981\u505a\u7684\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u53c2\u6570\u4e58\u4ee5\u7eb9\u7406\u5750\u6807(\u8ba1\u7b97\u597d\u50cf\u6574\u4e2a\u7f51\u683c\u88ab\u7eb9\u7406\u5305\u88f9\u7684\u60c5\u51b5)\uff0c\u5373 textInc \u53c2\u6570\uff0c\u4ee5\u589e\u52a0\u5728\u76f8\u90bb\u9876\u70b9\u4e4b\u95f4\u4f7f\u7528\u7684\u7eb9\u7406\u50cf\u7d20\u6570\u3002 \u76ee\u524d\u552f\u4e00\u6ca1\u6709\u89e3\u51b3\u7684\u662f\u6cd5\u7ebf\u8ba1\u7b97\u3002\u8bb0\u4f4f\u6211\u4eec\u9700\u8981\u6cd5\u7ebf\uff0c\u5149\u7167\u624d\u80fd\u6b63\u786e\u5730\u5e94\u7528\u4e8e\u5730\u5f62\u3002\u6ca1\u6709\u6cd5\u7ebf\uff0c\u65e0\u8bba\u5149\u7167\u5982\u4f55\uff0c\u5730\u5f62\u5c06\u4ee5\u76f8\u540c\u7684\u989c\u8272\u6e32\u67d3\u3002\u6211\u4eec\u5728\u8fd9\u91cc\u4f7f\u7528\u7684\u65b9\u6cd5\u4e0d\u4e00\u5b9a\u662f\u6700\u9ad8\u6548\u7684\uff0c\u4f46\u5b83\u5c06\u5e2e\u52a9\u4f60\u7406\u89e3\u5982\u4f55\u81ea\u52a8\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5982\u679c\u4f60\u641c\u7d22\u5176\u4ed6\u89e3\u51b3\u65b9\u6848\uff0c\u53ef\u80fd\u4f1a\u53d1\u73b0\u66f4\u6709\u6548\u7684\u65b9\u6cd5\uff0c\u53ea\u4f7f\u7528\u76f8\u90bb\u70b9\u7684\u9ad8\u5ea6\u800c\u4e0d\u9700\u8981\u505a\u4ea4\u53c9\u76f8\u4e58\u64cd\u4f5c\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u4ec5\u9700\u8981\u5728\u542f\u52a8\u65f6\u5b8c\u6210\uff0c\u8fd9\u91cc\u7684\u65b9\u6cd5\u4e0d\u4f1a\u5bf9\u6027\u80fd\u9020\u6210\u592a\u5927\u7684\u635f\u5bb3\u3002 \u8ba9\u6211\u4eec\u7528\u56fe\u89e3\u7684\u65b9\u5f0f\u89e3\u91ca\u5982\u4f55\u8ba1\u7b97\u4e00\u4e2a\u6cd5\u7ebf\u503c\u3002\u5047\u8bbe\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a P0 \u7684\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5176\u5468\u56f4\u6bcf\u4e2a\u9876\u70b9( P1 , P2 , P3 , P4 )\u548c\u4e0e\u8fde\u63a5\u8fd9\u4e9b\u70b9\u7684\u9762\u76f8\u5207\u7684\u5411\u91cf\u3002\u8fd9\u4e9b\u5411\u91cf( V1 , V2 , V3 , V4 )\u662f\u901a\u8fc7\u5c06\u6bcf\u4e2a\u76f8\u90bb\u70b9\u4e0e P0 \u76f8\u51cf(\u4f8b\u5982 V1 = P1 - P0 )\u5f97\u5230\u7684\u3002 \u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u8fde\u63a5\u6bcf\u4e00\u4e2a\u76f8\u90bb\u70b9\u7684\u5e73\u9762\u7684\u6cd5\u7ebf\u3002\u8fd9\u662f\u4e0e\u4e4b\u524d\u8ba1\u7b97\u5f97\u5230\u7684\u5411\u91cf\u4ea4\u53c9\u76f8\u4e58\u8ba1\u7b97\u7684\u3002\u4f8b\u5982\uff0c\u5411\u91cf V1 \u4e0e V2 \u6240\u5728\u7684\u5e73\u9762(\u84dd\u8272\u9634\u5f71\u90e8\u5206)\u7684\u6cd5\u7ebf\u662f\u7531 V1 \u548c V2 \u4ea4\u53c9\u76f8\u4e58\u5f97\u5230\u7684\uff0c\u5373 V12 = V1 \u00d7 V2 \u3002 \u5982\u679c\u6211\u4eec\u8ba1\u7b97\u5b8c\u6bd5\u5176\u4ed6\u5e73\u9762\u7684\u6cd5\u7ebf( V23 = V2 \u00d7 V3 \uff0c V34 = V3 \u00d7 V4 \uff0c V41 = V4 \u00d7 V1 )\uff0c\u5219\u6cd5\u7ebf P0 \u5c31\u662f\u5468\u56f4\u6240\u6709\u5e73\u9762\u6cd5\u7ebf(\u5f52\u4e00\u5316\u540e)\u4e4b\u548c\uff1a N0 = V12 + V23 + V34 + V41 \u3002 \u6cd5\u7ebf\u8ba1\u7b97\u7684\u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\u6240\u793a\u3002 private float[] calcNormals(float[] posArr, int width, int height) { Vector3f v0 = new Vector3f(); Vector3f v1 = new Vector3f(); Vector3f v2 = new Vector3f(); Vector3f v3 = new Vector3f(); Vector3f v4 = new Vector3f(); Vector3f v12 = new Vector3f(); Vector3f v23 = new Vector3f(); Vector3f v34 = new Vector3f(); Vector3f v41 = new Vector3f(); List<Float> normals = new ArrayList<>(); Vector3f normal = new Vector3f(); for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { if (row > 0 && row < height -1 && col > 0 && col < width -1) { int i0 = row*width*3 + col*3; v0.x = posArr[i0]; v0.y = posArr[i0 + 1]; v0.z = posArr[i0 + 2]; int i1 = row*width*3 + (col-1)*3; v1.x = posArr[i1]; v1.y = posArr[i1 + 1]; v1.z = posArr[i1 + 2]; v1 = v1.sub(v0); int i2 = (row+1)*width*3 + col*3; v2.x = posArr[i2]; v2.y = posArr[i2 + 1]; v2.z = posArr[i2 + 2]; v2 = v2.sub(v0); int i3 = (row)*width*3 + (col+1)*3; v3.x = posArr[i3]; v3.y = posArr[i3 + 1]; v3.z = posArr[i3 + 2]; v3 = v3.sub(v0); int i4 = (row-1)*width*3 + col*3; v4.x = posArr[i4]; v4.y = posArr[i4 + 1]; v4.z = posArr[i4 + 2]; v4 = v4.sub(v0); v1.cross(v2, v12); v12.normalize(); v2.cross(v3, v23); v23.normalize(); v3.cross(v4, v34); v34.normalize(); v4.cross(v1, v41); v41.normalize(); normal = v12.add(v23).add(v34).add(v41); normal.normalize(); } else { normal.x = 0; normal.y = 1; normal.z = 0; } normal.normalize(); normals.add(normal.x); normals.add(normal.y); normals.add(normal.z); } } return Utils.listToArray(normals); } \u6700\u540e\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u5730\u5f62\uff0c\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u62e9\uff1a * \u521b\u5efa\u66f4\u5927\u7684\u9ad8\u5ea6\u56fe * \u91cd\u7528\u9ad8\u5ea6\u56fe\u5e76\u5c06\u5176\u5e73\u94fa\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u9ad8\u5ea6\u56fe\u5c06\u50cf\u4e00\u4e2a\u5730\u5f62\u5757\uff0c\u5728\u4e16\u754c\u4e0a\u50cf\u74f7\u7816\u4e00\u6837\u5e73\u79fb\u3002\u4e3a\u4e86\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u9ad8\u5ea6\u56fe\u8fb9\u7f18\u7684\u50cf\u7d20\u5fc5\u987b\u662f\u76f8\u540c\u7684(\u5de6\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u53f3\u4fa7\u76f8\u540c\uff0c\u4e0a\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u4e0b\u4fa7\u76f8\u540c)\uff0c\u4ee5\u907f\u514d\u5757\u4e4b\u95f4\u7684\u95f4\u9699\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5(\u5e76\u9009\u62e9\u9002\u5f53\u7684\u9ad8\u5ea6\u56fe)\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Terrain \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u521b\u5efa\u4e00\u4e2a\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u56fe\u5757\uff0c\u5b9a\u4e49\u5982\u4e0b\u3002 package org.lwjglb.engine.items; import org.lwjglb.engine.graph.HeightMapMesh; public class Terrain { private final GameItem[] gameItems; public Terrain(int blocksPerRow, float scale, float minY, float maxY, String heightMap, String textureFile, int textInc) throws Exception { gameItems = new GameItem[blocksPerRow * blocksPerRow]; HeightMapMesh heightMapMesh = new HeightMapMesh(minY, maxY, heightMap, textureFile, textInc); for (int row = 0; row < blocksPerRow; row++) { for (int col = 0; col < blocksPerRow; col++) { float xDisplacement = (col - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * blocksPerRow + col] = terrainBlock; } } } public GameItem[] getGameItems() { return gameItems; } } \u8ba9\u6211\u4eec\u8be6\u89e3\u6574\u4e2a\u8fc7\u7a0b\uff0c\u6211\u4eec\u62e5\u6709\u7531\u4ee5\u4e0b\u5750\u6807\u5b9a\u4e49\u7684\u5757(X\u548cZ\u4f7f\u7528\u4e4b\u524d\u5b9a\u4e49\u7684\u5e38\u91cf)\u3002 \u5047\u8bbe\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u75313\u00d73\u5757\u7f51\u683c\u6784\u6210\u7684\u5730\u5f62\u3002\u6211\u4eec\u5047\u8bbe\u6211\u4eec\u4e0d\u4f1a\u7f29\u653e\u5730\u5f62\u5757(\u4e5f\u5c31\u662f\u8bf4\uff0c\u53d8\u91cf blocksPerRow \u662f 3 \u800c\u53d8\u91cf scale \u5c06\u4f1a\u662f 1 )\u3002\u6211\u4eec\u5e0c\u671b\u7f51\u683c\u7684\u4e2d\u592e\u5728\u5750\u6807\u7cfb\u7684(0, 0)\u3002 \u6211\u4eec\u9700\u8981\u79fb\u52a8\u5757\uff0c\u8fd9\u6837\u9876\u70b9\u5c31\u53d8\u6210\u5982\u4e0b\u5750\u6807\u3002 \u79fb\u52a8\u662f\u901a\u8fc7\u8c03\u7528 setPosition \u65b9\u6cd5\u5b9e\u73b0\u7684\uff0c\u4f46\u8bb0\u4f4f\uff0c\u6211\u4eec\u6240\u8bbe\u7f6e\u7684\u662f\u4e00\u4e2a\u4f4d\u79fb\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u5982\u679c\u4f60\u770b\u5230\u4e0a\u56fe\uff0c\u4f60\u4f1a\u53d1\u73b0\u4e2d\u592e\u5757\u4e0d\u9700\u8981\u4efb\u4f55\u79fb\u52a8\uff0c\u5b83\u5df2\u7ecf\u5b9a\u4f4d\u5728\u9002\u5f53\u7684\u5750\u6807\u4e0a\u3002\u7ed8\u5236\u7eff\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb -1 \uff0c\u800c\u7ed8\u5236\u84dd\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb +1 \u3002\u8ba1\u7b97X\u4f4d\u79fb\u7684\u516c\u5f0f\uff0c\u8981\u8003\u8651\u5230\u7f29\u653e\u548c\u5757\u7684\u5bbd\u5ea6\uff0c\u516c\u5f0f\u5982\u4e0b\uff1a xDisplacement=(col - (blocksPerRow -1 ) / 2) \\times scale \\times width Z\u4f4d\u79fb\u7684\u516c\u5f0f\u4e3a\uff1a zDisplacement=(row - (blocksPerRow -1 ) / 2) \\times scale \\times height \u5982\u679c\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a Terrain \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ef\u4ee5\u5f97\u5230\u5982\u56fe\u6240\u793a\u7684\u6548\u679c\u3002 \u4f60\u53ef\u4ee5\u5728\u5730\u5f62\u5468\u56f4\u79fb\u52a8\u76f8\u673a\uff0c\u770b\u770b\u5b83\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002\u7531\u4e8e\u8fd8\u6ca1\u6709\u5b9e\u73b0\u78b0\u649e\u68c0\u6d4b\uff0c\u4f60\u53ef\u4ee5\u7a7f\u8fc7\u5b83\u5e76\u4ece\u4e0a\u9762\u770b\u5b83\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u9762\u5254\u9664\uff0c\u5f53\u4ece\u4e0b\u9762\u89c2\u5bdf\u65f6\uff0c\u5730\u5f62\u7684\u67d0\u4e9b\u90e8\u5206\u4e0d\u4f1a\u6e32\u67d3\u3002","title":"\u9ad8\u5ea6\u56fe"},{"location":"14-height-maps/#height-maps","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u9ad8\u5ea6\u56fe\u521b\u5efa\u590d\u6742\u7684\u5730\u5f62\u3002\u5728\u5f00\u59cb\u524d\uff0c\u4f60\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e9b\u65b0\u7684\u5305\u548c\u79fb\u52a8\u4e86\u4e00\u4e9b\u7c7b\u4ee5\u66f4\u597d\u5730\u7ec4\u7ec7\u5b83\u4eec\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u8fd9\u4e9b\u6539\u53d8\u3002 \u6240\u4ee5\u4ec0\u4e48\u662f\u9ad8\u5ea6\u56fe\uff1f\u9ad8\u5ea6\u56fe\u662f\u7528\u4e8e\u751f\u6210\u4e09\u7ef4\u5730\u5f62\u7684\u56fe\u50cf\uff0c\u5b83\u4f7f\u7528\u50cf\u7d20\u989c\u8272\u6765\u83b7\u53d6\u8868\u9762\u9ad8\u5ea6\u3002\u9ad8\u5ea6\u56fe\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5b83\u53ef\u4ee5\u7531 Terragen \u7b49\u8f6f\u4ef6\u751f\u6210\u3002\u4e00\u5f20\u9ad8\u5ea6\u56fe\u56fe\u50cf\u770b\u8d77\u6765\u5c31\u50cf\u8fd9\u6837\u3002 \u4e0a\u56fe\u5c31\u50cf\u4f60\u4fef\u89c6\u4e00\u7247\u9646\u5730\u4e00\u6837\u3002\u5229\u7528\u4e0a\u56fe\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u7531\u9876\u70b9\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u6240\u7ec4\u6210\u7684\u7f51\u683c\u3002\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u5c06\u6839\u636e\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u3002\u9ed1\u8272\u662f\u6700\u4f4e\uff0c\u767d\u8272\u662f\u6700\u9ad8\u3002 \u6211\u4eec\u5c06\u4e3a\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u7ec4\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5c06\u7ec4\u6210\u4e09\u89d2\u5f62\uff0c\u8fd9\u4e9b\u4e09\u89d2\u5f62\u5c06\u7ec4\u6210\u4e0b\u56fe\u6240\u793a\u7684\u7f51\u683c\u3002 \u7f51\u683c\u5c06\u7ec4\u6210\u4e00\u4e2a\u5de8\u5927\u7684\u56db\u8fb9\u5f62\uff0c\u5b83\u5c06\u4f1a\u5728X\u548cZ\u8f74\u4e0a\u6e32\u67d3\uff0c\u5e76\u6839\u636e\u50cf\u7d20\u989c\u8272\u6765\u6539\u53d8\u5b83\u7684Y\u8f74\u9ad8\u5ea6\u3002 \u7531\u9ad8\u5ea6\u56fe\u521b\u5efa\u4e09\u7ef4\u5730\u5f62\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u6b65\u9aa4\uff1a * \u52a0\u8f7d\u50a8\u5b58\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf(\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a BufferedImage \u5b9e\u4f8b\u4ee5\u83b7\u53d6\u6bcf\u4e2a\u50cf\u7d20)\u3002 * \u4e3a\u6bcf\u4e2a\u56fe\u50cf\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u5176\u9ad8\u5ea6\u57fa\u4e8e\u50cf\u7d20\u989c\u8272\u3002 * \u5c06\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u9876\u70b9\u3002 * \u8bbe\u7f6e\u7d22\u5f15\u4ee5\u7ed8\u5236\u4e0e\u9876\u70b9\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a HeightMapMesh \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u6309\u4ee5\u4e0a\u6b65\u9aa4\u521b\u5efa\u4e00\u4e2a Mesh \u3002\u8ba9\u6211\u4eec\u5148\u770b\u770b\u8be5\u7c7b\u5b9a\u4e49\u7684\u5e38\u91cf\uff1a private static final int MAX_COLOUR = 255 * 255 * 255; \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u3002\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5bf9\u4e8ePNG\u56fe\u50cf\u6765\u8bf4\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u50cf\u7d20\u7684\u6bcf\u4e2aRGB\u503c\u53ef\u4ee5\u57280\u5230255\u4e4b\u95f4\u53d8\u5316\uff0c\u56e0\u6b64\u6211\u4eec\u6709256\u4e2a\u503c\u6765\u8868\u793a\u4e0d\u540c\u7684\u9ad8\u5ea6\u3002\u8fd9\u53ef\u80fd\u8db3\u591f\u4e86\uff0c\u4f46\u5982\u679c\u7cbe\u5ea6\u4e0d\u591f\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e09\u4e2aRGB\u503c\u4ee5\u6709\u66f4\u591a\u7684\u503c\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9ad8\u5ea6\u8ba1\u7b97\u8303\u56f4\u4e3a0\u5230255^3\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u5c40\u9650\u4e8e\u7070\u5ea6\u56fe\u3002 \u63a5\u4e0b\u6765\u7684\u5e38\u91cf\u662f\uff1a private static final float STARTX = -0.5f; private static final float STARTZ = -0.5f; \u7f51\u683c\u5c06\u7531\u4e00\u7ec4\u9876\u70b9\uff08\u4e00\u4e2a\u9876\u70b9\u5bf9\u5e94\u4e00\u4e2a\u50cf\u7d20\uff09\u6784\u6210\uff0c\u5176X\u548cZ\u5750\u6807\u7684\u8303\u56f4\u5982\u4e0b * X\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTX , -STARTX ]\u3002 * Z\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTZ , -STARTZ ]\u3002 \u4e0d\u7528\u592a\u8fc7\u62c5\u5fc3\u8fd9\u4e9b\u503c\uff0c\u7a0d\u540e\u5f97\u5230\u7684\u7f51\u683c\u53ef\u4ee5\u88ab\u7f29\u653e\u4ee5\u9002\u5e94\u4e16\u754c\u7684\u5927\u5c0f\u3002\u5173\u4e8eY\u8f74\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e minY \u548c maxY \u4e24\u4e2a\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6eY\u5750\u6807\u7684\u6700\u4f4e\u548c\u6700\u9ad8\u503c\u3002\u8fd9\u4e9b\u53c2\u6570\u5e76\u4e0d\u662f\u5e38\u6570\uff0c\u56e0\u4e3a\u6211\u4eec\u53ef\u80fd\u5e0c\u671b\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u5b83\u4eec\uff0c\u800c\u4e0d\u4f7f\u7528\u7f29\u653e\u3002\u6700\u540e\uff0c\u5730\u5f62\u5c06\u5305\u542b\u5728\u8303\u56f4\u4e3a [STARTX, -STARTX] \uff0c [minY, maxY] \uff0c [STARTZ, -STARTZ] \u7684\u7acb\u65b9\u4f53\u5185\u3002 \u7f51\u683c\u5c06\u4f1a\u5728 HeightMapMesh \u7c7b\u7684\u6784\u9020\u51fd\u6570\u4e2d\u521b\u5efa\uff0c\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u3002 public HeightMapMesh(float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { \u5b83\u63a5\u6536Y\u8f74\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\uff0c\u88ab\u7528\u4f5c\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf\u6587\u4ef6\u540d\u548c\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u6587\u4ef6\u540d\u3002\u5b83\u8fd8\u63a5\u53d7\u4e00\u4e2a\u540d\u4e3a textInc \u7684\u6574\u6570\uff0c\u8fd9\u7a0d\u540e\u518d\u8bf4\u660e\u3002 \u6211\u4eec\u5728\u6784\u9020\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5c06\u9ad8\u5ea6\u56fe\u56fe\u50cf\u52a0\u8f7d\u5230 BufferedImage \u5b9e\u4f8b\u4e2d\u3002 this.minY = minY; this.maxY = maxY; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); \u7136\u540e\uff0c\u6211\u4eec\u5c06\u7eb9\u7406\u6587\u4ef6\u8f7d\u5165\u5230\u4e00\u4e2a ByteBuffer \u4e2d\uff0c\u5e76\u8bbe\u7f6e\u6784\u9020 Mesh \u6240\u9700\u7684\u53d8\u91cf\u3002 incx \u548c incz \u53d8\u91cf\u5c06\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684X\u6216Z\u5750\u6807\u4e4b\u95f4\u7684\u6700\u5c0f\u95f4\u9694\uff0c\u56e0\u6b64 Mesh \u5305\u542b\u5728\u4e0a\u8ff0\u533a\u57df\u4e2d\u3002 Texture texture = new Texture(textureFile); float incx = getWidth() / (width - 1); float incz = Math.abs(STARTZ * 2) / (height - 1); List<Float> positions = new ArrayList(); List<Float> textCoords = new ArrayList(); List<Integer> indices = new ArrayList(); \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u904d\u5386\u56fe\u50cf\uff0c\u4e3a\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u8bbe\u7f6e\u5176\u7eb9\u7406\u5750\u6807\u4e0e\u7d22\u5f15\uff0c\u4ee5\u6b63\u786e\u5730\u5b9a\u4e49\u7ec4\u6210 Mesh \u7684\u4e09\u89d2\u5f62\u3002 for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { // \u4e3a\u5f53\u524d\u4f4d\u7f6e\u521b\u5efa\u9876\u70b9 positions.add(STARTX + col * incx); // x positions.add(getHeight(col, row, width, buf)); // y positions.add(STARTZ + row * incz); // z // \u8bbe\u7f6e\u7eb9\u7406\u5750\u6807 textCoords.add((float) textInc * (float) col / (float) width); textCoords.add((float) textInc * (float) row / (float) height); // \u521b\u5efa\u7d22\u5f15 if (col < width - 1 && row < height - 1) { int leftTop = row * width + col; int leftBottom = (row + 1) * width + col; int rightBottom = (row + 1) * width + col + 1; int rightTop = row * width + col + 1; indices.add(rightTop); indices.add(leftBottom); indices.add(leftTop); indices.add(rightBottom); indices.add(leftBottom); indices.add(rightTop); } } } \u521b\u5efa\u9876\u70b9\u5750\u6807\u7684\u8fc7\u7a0b\u662f\u4e0d\u9700\u8981\u89e3\u91ca\u7684\u3002\u73b0\u5728\u5148\u522b\u7ba1\u4e3a\u4ec0\u4e48\u6211\u4eec\u7528\u4e00\u4e2a\u6570\u5b57\u4e58\u4ee5\u7eb9\u7406\u5750\u6807\u4ee5\u53ca\u5982\u4f55\u8ba1\u7b97\u9ad8\u5ea6\u3002\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15(\u9664\u975e\u73b0\u5728\u662f\u6700\u540e\u4e00\u884c\u6216\u6700\u540e\u4e00\u5217)\u3002\u8ba9\u6211\u4eec\u7528\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u6765\u60f3\u8c61\u5b83\u4eec\u662f\u5982\u4f55\u6784\u9020\u7684\u3002\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u5305\u542b9\u4e2a\u9876\u70b9\uff0c\u6bcf\u56e0\u6b64\u6709 2\u00d74 \u4e2a\u4e09\u89d2\u5f62\u7ec4\u62104\u4e2a\u6b63\u65b9\u5f62\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u88ab\u547d\u540d\u4e3a Vrc (r\uff1a\u884c\uff0cc\uff1a\u5217)\u3002 \u5f53\u5904\u7406\u7b2c\u4e00\u4e2a\u9876\u70b9(V00)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002 \u5f53\u5904\u7406\u7b2c\u4e8c\u4e2a\u9876\u70b9(V01)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u53c8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002\u4f46\u5f53\u5904\u7406\u7b2c\u4e09\u4e2a\u9876\u70b9(V02)\u65f6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5b9a\u4e49\u66f4\u591a\u7684\u7d22\u5f15\uff0c\u8be5\u884c\u7684\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5df2\u88ab\u5b9a\u4e49\u3002 \u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u60f3\u5230\u5176\u4ed6\u9876\u70b9\u7684\u5904\u7406\u8fc7\u7a0b\u662f\u5982\u4f55\u8fdb\u884c\u7684\u3002\u73b0\u5728\uff0c\u4e00\u65e6\u521b\u5efa\u4e86\u6240\u6709\u7684\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u7528\u6240\u6709\u8fd9\u4e9b\u6570\u636e\u521b\u5efa Mesh \u548c\u76f8\u5173\u7684 Material \u3002 float[] posArr = Utils.listToArray(positions); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = calcNormals(posArr, width, height); this.mesh = new Mesh(posArr, textCoordsArr, normalsArr, indicesArr); Material material = new Material(texture, 0.0f); mesh.setMaterial(material); \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6839\u636e\u9876\u70b9\u4f4d\u7f6e\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5728\u770b\u5982\u4f55\u8ba1\u7b97\u6cd5\u7ebf\u4e4b\u524d\uff0c\u6765\u770b\u770b\u5982\u4f55\u83b7\u53d6\u9ad8\u5ea6\u5427\u3002\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a getHeight \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u8ba1\u7b97\u9876\u70b9\u7684\u9ad8\u5ea6\u3002 private float getHeight(int x, int z, int width, ByteBuffer buffer) { byte r = buffer.get(x * 4 + 0 + z * 4 * width); byte g = buffer.get(x * 4 + 1 + z * 4 * width); byte b = buffer.get(x * 4 + 2 + z * 4 * width); byte a = buffer.get(x * 4 + 3 + z * 4 * width); int argb = ((0xFF & a) << 24) | ((0xFF & r) << 16) | ((0xFF & g) << 8) | (0xFF & b); return this.minY + Math.abs(this.maxY - this.minY) * ((float) argb / (float) MAX_COLOUR); } \u8be5\u65b9\u6cd5\u63a5\u53d7\u50cf\u7d20\u7684X\u548cY\u5750\u6807\uff0c\u56fe\u50cf\u7684\u5bbd\u5ea6\u4ee5\u53ca\u4e0e\u4e4b\u76f8\u5173\u7684 ByteBuffer \uff0c\u8fd4\u56deRGB\u989c\u8272(R\u3001G\u3001B\u5206\u91cf\u4e4b\u548c)\u5e76\u8ba1\u7b97\u5305\u542b\u5728 minY \u548c maxY \u4e4b\u95f4\u7684\u503c( minY \u4e3a\u9ed1\u8272\uff0c maxY \u4e3a\u767d\u8272)\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528 BufferedImage \u6765\u7f16\u5199\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u5b83\u6709\u66f4\u65b9\u4fbf\u7684\u65b9\u6cd5\u6765\u83b7\u5f97RGB\u503c\uff0c\u4f46\u8fd9\u5c06\u4f7f\u7528AWT\u3002\u8bb0\u4f4fAWT\u4e0d\u80fd\u5f88\u597d\u7684\u517c\u5bb9OSX\uff0c\u6240\u4ee5\u5c3d\u91cf\u907f\u514d\u4f7f\u7528\u5b83\u7684\u7c7b\u3002 \u73b0\u5728\u6765\u770b\u770b\u5982\u4f55\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f\u5c06\u7eb9\u7406\u8986\u76d6\u6574\u4e2a\u7f51\u683c\uff0c\u5de6\u4e0a\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(0, 0)\uff0c\u53f3\u4e0b\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(1, 1)\u3002\u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u7eb9\u7406\u5fc5\u987b\u662f\u5de8\u5927\u7684\uff0c\u4ee5\u4fbf\u83b7\u5f97\u826f\u597d\u7684\u6e32\u67d3\u6548\u679c\uff0c\u5426\u5219\u7eb9\u7406\u5c06\u4f1a\u88ab\u8fc7\u5ea6\u62c9\u4f38\u3002 \u4f46\u6211\u4eec\u4ecd\u7136\u53ef\u4ee5\u4f7f\u7528\u975e\u5e38\u5c0f\u7684\u7eb9\u7406\uff0c\u901a\u8fc7\u4f7f\u7528\u9ad8\u6548\u7684\u6280\u672f\u6765\u83b7\u5f97\u5f88\u597d\u7684\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u8bbe\u7f6e\u8d85\u51fa[1, 1]\u8303\u56f4\u7684\u7eb9\u7406\u5750\u6807\uff0c\u6211\u4eec\u5c06\u56de\u5230\u539f\u70b9\u5e76\u91cd\u65b0\u5f00\u59cb\u8ba1\u7b97\u3002\u4e0b\u56fe\u8868\u793a\u5728\u51e0\u4e2a\u6b63\u65b9\u5f62\u4e2d\u5e73\u94fa\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u5e76\u8d85\u51fa\u4e86[1, 1]\u8303\u56f4\u3002 \u8fd9\u662f\u6211\u4eec\u5728\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\u65f6\u6240\u8981\u505a\u7684\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u53c2\u6570\u4e58\u4ee5\u7eb9\u7406\u5750\u6807(\u8ba1\u7b97\u597d\u50cf\u6574\u4e2a\u7f51\u683c\u88ab\u7eb9\u7406\u5305\u88f9\u7684\u60c5\u51b5)\uff0c\u5373 textInc \u53c2\u6570\uff0c\u4ee5\u589e\u52a0\u5728\u76f8\u90bb\u9876\u70b9\u4e4b\u95f4\u4f7f\u7528\u7684\u7eb9\u7406\u50cf\u7d20\u6570\u3002 \u76ee\u524d\u552f\u4e00\u6ca1\u6709\u89e3\u51b3\u7684\u662f\u6cd5\u7ebf\u8ba1\u7b97\u3002\u8bb0\u4f4f\u6211\u4eec\u9700\u8981\u6cd5\u7ebf\uff0c\u5149\u7167\u624d\u80fd\u6b63\u786e\u5730\u5e94\u7528\u4e8e\u5730\u5f62\u3002\u6ca1\u6709\u6cd5\u7ebf\uff0c\u65e0\u8bba\u5149\u7167\u5982\u4f55\uff0c\u5730\u5f62\u5c06\u4ee5\u76f8\u540c\u7684\u989c\u8272\u6e32\u67d3\u3002\u6211\u4eec\u5728\u8fd9\u91cc\u4f7f\u7528\u7684\u65b9\u6cd5\u4e0d\u4e00\u5b9a\u662f\u6700\u9ad8\u6548\u7684\uff0c\u4f46\u5b83\u5c06\u5e2e\u52a9\u4f60\u7406\u89e3\u5982\u4f55\u81ea\u52a8\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5982\u679c\u4f60\u641c\u7d22\u5176\u4ed6\u89e3\u51b3\u65b9\u6848\uff0c\u53ef\u80fd\u4f1a\u53d1\u73b0\u66f4\u6709\u6548\u7684\u65b9\u6cd5\uff0c\u53ea\u4f7f\u7528\u76f8\u90bb\u70b9\u7684\u9ad8\u5ea6\u800c\u4e0d\u9700\u8981\u505a\u4ea4\u53c9\u76f8\u4e58\u64cd\u4f5c\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u4ec5\u9700\u8981\u5728\u542f\u52a8\u65f6\u5b8c\u6210\uff0c\u8fd9\u91cc\u7684\u65b9\u6cd5\u4e0d\u4f1a\u5bf9\u6027\u80fd\u9020\u6210\u592a\u5927\u7684\u635f\u5bb3\u3002 \u8ba9\u6211\u4eec\u7528\u56fe\u89e3\u7684\u65b9\u5f0f\u89e3\u91ca\u5982\u4f55\u8ba1\u7b97\u4e00\u4e2a\u6cd5\u7ebf\u503c\u3002\u5047\u8bbe\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a P0 \u7684\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5176\u5468\u56f4\u6bcf\u4e2a\u9876\u70b9( P1 , P2 , P3 , P4 )\u548c\u4e0e\u8fde\u63a5\u8fd9\u4e9b\u70b9\u7684\u9762\u76f8\u5207\u7684\u5411\u91cf\u3002\u8fd9\u4e9b\u5411\u91cf( V1 , V2 , V3 , V4 )\u662f\u901a\u8fc7\u5c06\u6bcf\u4e2a\u76f8\u90bb\u70b9\u4e0e P0 \u76f8\u51cf(\u4f8b\u5982 V1 = P1 - P0 )\u5f97\u5230\u7684\u3002 \u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u8fde\u63a5\u6bcf\u4e00\u4e2a\u76f8\u90bb\u70b9\u7684\u5e73\u9762\u7684\u6cd5\u7ebf\u3002\u8fd9\u662f\u4e0e\u4e4b\u524d\u8ba1\u7b97\u5f97\u5230\u7684\u5411\u91cf\u4ea4\u53c9\u76f8\u4e58\u8ba1\u7b97\u7684\u3002\u4f8b\u5982\uff0c\u5411\u91cf V1 \u4e0e V2 \u6240\u5728\u7684\u5e73\u9762(\u84dd\u8272\u9634\u5f71\u90e8\u5206)\u7684\u6cd5\u7ebf\u662f\u7531 V1 \u548c V2 \u4ea4\u53c9\u76f8\u4e58\u5f97\u5230\u7684\uff0c\u5373 V12 = V1 \u00d7 V2 \u3002 \u5982\u679c\u6211\u4eec\u8ba1\u7b97\u5b8c\u6bd5\u5176\u4ed6\u5e73\u9762\u7684\u6cd5\u7ebf( V23 = V2 \u00d7 V3 \uff0c V34 = V3 \u00d7 V4 \uff0c V41 = V4 \u00d7 V1 )\uff0c\u5219\u6cd5\u7ebf P0 \u5c31\u662f\u5468\u56f4\u6240\u6709\u5e73\u9762\u6cd5\u7ebf(\u5f52\u4e00\u5316\u540e)\u4e4b\u548c\uff1a N0 = V12 + V23 + V34 + V41 \u3002 \u6cd5\u7ebf\u8ba1\u7b97\u7684\u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\u6240\u793a\u3002 private float[] calcNormals(float[] posArr, int width, int height) { Vector3f v0 = new Vector3f(); Vector3f v1 = new Vector3f(); Vector3f v2 = new Vector3f(); Vector3f v3 = new Vector3f(); Vector3f v4 = new Vector3f(); Vector3f v12 = new Vector3f(); Vector3f v23 = new Vector3f(); Vector3f v34 = new Vector3f(); Vector3f v41 = new Vector3f(); List<Float> normals = new ArrayList<>(); Vector3f normal = new Vector3f(); for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { if (row > 0 && row < height -1 && col > 0 && col < width -1) { int i0 = row*width*3 + col*3; v0.x = posArr[i0]; v0.y = posArr[i0 + 1]; v0.z = posArr[i0 + 2]; int i1 = row*width*3 + (col-1)*3; v1.x = posArr[i1]; v1.y = posArr[i1 + 1]; v1.z = posArr[i1 + 2]; v1 = v1.sub(v0); int i2 = (row+1)*width*3 + col*3; v2.x = posArr[i2]; v2.y = posArr[i2 + 1]; v2.z = posArr[i2 + 2]; v2 = v2.sub(v0); int i3 = (row)*width*3 + (col+1)*3; v3.x = posArr[i3]; v3.y = posArr[i3 + 1]; v3.z = posArr[i3 + 2]; v3 = v3.sub(v0); int i4 = (row-1)*width*3 + col*3; v4.x = posArr[i4]; v4.y = posArr[i4 + 1]; v4.z = posArr[i4 + 2]; v4 = v4.sub(v0); v1.cross(v2, v12); v12.normalize(); v2.cross(v3, v23); v23.normalize(); v3.cross(v4, v34); v34.normalize(); v4.cross(v1, v41); v41.normalize(); normal = v12.add(v23).add(v34).add(v41); normal.normalize(); } else { normal.x = 0; normal.y = 1; normal.z = 0; } normal.normalize(); normals.add(normal.x); normals.add(normal.y); normals.add(normal.z); } } return Utils.listToArray(normals); } \u6700\u540e\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u5730\u5f62\uff0c\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u62e9\uff1a * \u521b\u5efa\u66f4\u5927\u7684\u9ad8\u5ea6\u56fe * \u91cd\u7528\u9ad8\u5ea6\u56fe\u5e76\u5c06\u5176\u5e73\u94fa\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u9ad8\u5ea6\u56fe\u5c06\u50cf\u4e00\u4e2a\u5730\u5f62\u5757\uff0c\u5728\u4e16\u754c\u4e0a\u50cf\u74f7\u7816\u4e00\u6837\u5e73\u79fb\u3002\u4e3a\u4e86\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u9ad8\u5ea6\u56fe\u8fb9\u7f18\u7684\u50cf\u7d20\u5fc5\u987b\u662f\u76f8\u540c\u7684(\u5de6\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u53f3\u4fa7\u76f8\u540c\uff0c\u4e0a\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u4e0b\u4fa7\u76f8\u540c)\uff0c\u4ee5\u907f\u514d\u5757\u4e4b\u95f4\u7684\u95f4\u9699\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5(\u5e76\u9009\u62e9\u9002\u5f53\u7684\u9ad8\u5ea6\u56fe)\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Terrain \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u521b\u5efa\u4e00\u4e2a\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u56fe\u5757\uff0c\u5b9a\u4e49\u5982\u4e0b\u3002 package org.lwjglb.engine.items; import org.lwjglb.engine.graph.HeightMapMesh; public class Terrain { private final GameItem[] gameItems; public Terrain(int blocksPerRow, float scale, float minY, float maxY, String heightMap, String textureFile, int textInc) throws Exception { gameItems = new GameItem[blocksPerRow * blocksPerRow]; HeightMapMesh heightMapMesh = new HeightMapMesh(minY, maxY, heightMap, textureFile, textInc); for (int row = 0; row < blocksPerRow; row++) { for (int col = 0; col < blocksPerRow; col++) { float xDisplacement = (col - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * blocksPerRow + col] = terrainBlock; } } } public GameItem[] getGameItems() { return gameItems; } } \u8ba9\u6211\u4eec\u8be6\u89e3\u6574\u4e2a\u8fc7\u7a0b\uff0c\u6211\u4eec\u62e5\u6709\u7531\u4ee5\u4e0b\u5750\u6807\u5b9a\u4e49\u7684\u5757(X\u548cZ\u4f7f\u7528\u4e4b\u524d\u5b9a\u4e49\u7684\u5e38\u91cf)\u3002 \u5047\u8bbe\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u75313\u00d73\u5757\u7f51\u683c\u6784\u6210\u7684\u5730\u5f62\u3002\u6211\u4eec\u5047\u8bbe\u6211\u4eec\u4e0d\u4f1a\u7f29\u653e\u5730\u5f62\u5757(\u4e5f\u5c31\u662f\u8bf4\uff0c\u53d8\u91cf blocksPerRow \u662f 3 \u800c\u53d8\u91cf scale \u5c06\u4f1a\u662f 1 )\u3002\u6211\u4eec\u5e0c\u671b\u7f51\u683c\u7684\u4e2d\u592e\u5728\u5750\u6807\u7cfb\u7684(0, 0)\u3002 \u6211\u4eec\u9700\u8981\u79fb\u52a8\u5757\uff0c\u8fd9\u6837\u9876\u70b9\u5c31\u53d8\u6210\u5982\u4e0b\u5750\u6807\u3002 \u79fb\u52a8\u662f\u901a\u8fc7\u8c03\u7528 setPosition \u65b9\u6cd5\u5b9e\u73b0\u7684\uff0c\u4f46\u8bb0\u4f4f\uff0c\u6211\u4eec\u6240\u8bbe\u7f6e\u7684\u662f\u4e00\u4e2a\u4f4d\u79fb\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u5982\u679c\u4f60\u770b\u5230\u4e0a\u56fe\uff0c\u4f60\u4f1a\u53d1\u73b0\u4e2d\u592e\u5757\u4e0d\u9700\u8981\u4efb\u4f55\u79fb\u52a8\uff0c\u5b83\u5df2\u7ecf\u5b9a\u4f4d\u5728\u9002\u5f53\u7684\u5750\u6807\u4e0a\u3002\u7ed8\u5236\u7eff\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb -1 \uff0c\u800c\u7ed8\u5236\u84dd\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb +1 \u3002\u8ba1\u7b97X\u4f4d\u79fb\u7684\u516c\u5f0f\uff0c\u8981\u8003\u8651\u5230\u7f29\u653e\u548c\u5757\u7684\u5bbd\u5ea6\uff0c\u516c\u5f0f\u5982\u4e0b\uff1a xDisplacement=(col - (blocksPerRow -1 ) / 2) \\times scale \\times width Z\u4f4d\u79fb\u7684\u516c\u5f0f\u4e3a\uff1a zDisplacement=(row - (blocksPerRow -1 ) / 2) \\times scale \\times height \u5982\u679c\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a Terrain \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ef\u4ee5\u5f97\u5230\u5982\u56fe\u6240\u793a\u7684\u6548\u679c\u3002 \u4f60\u53ef\u4ee5\u5728\u5730\u5f62\u5468\u56f4\u79fb\u52a8\u76f8\u673a\uff0c\u770b\u770b\u5b83\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002\u7531\u4e8e\u8fd8\u6ca1\u6709\u5b9e\u73b0\u78b0\u649e\u68c0\u6d4b\uff0c\u4f60\u53ef\u4ee5\u7a7f\u8fc7\u5b83\u5e76\u4ece\u4e0a\u9762\u770b\u5b83\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u9762\u5254\u9664\uff0c\u5f53\u4ece\u4e0b\u9762\u89c2\u5bdf\u65f6\uff0c\u5730\u5f62\u7684\u67d0\u4e9b\u90e8\u5206\u4e0d\u4f1a\u6e32\u67d3\u3002","title":"\u9ad8\u5ea6\u56fe\uff08Height Maps\uff09"},{"location":"15-terrain-collisions/","text":"\u5730\u5f62\u78b0\u649e\uff08Terrain Collisions\uff09 \u6b64\u524d\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u5730\u5f62\uff0c\u63a5\u4e0b\u6765\u5c31\u662f\u68c0\u6d4b\u78b0\u649e\u4ee5\u907f\u514d\u7a7f\u8fc7\u5b83\u3002\u56de\u5fc6\u4e00\u4e0b\u4e4b\u524d\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u5730\u5f62\u662f\u7531\u5730\u5f62\u5757\u7ec4\u6210\u7684\uff0c\u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u9ad8\u5ea6\u56fe\u751f\u6210\u7684\uff0c\u9ad8\u5ea6\u56fe\u7528\u4e8e\u8bbe\u7f6e\u6784\u6210\u5730\u5f62\u7684\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u9ad8\u5ea6\u3002 \u4e3a\u4e86\u68c0\u6d4b\u78b0\u649e\uff0c\u6211\u4eec\u5fc5\u987b\u5c06\u5f53\u524d\u6240\u5728\u4f4d\u7f6e\u7684 Y \u503c\u4e0e\u5f53\u524d\u5730\u5f62\u70b9\u7684 Y \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u6709\u78b0\u649e\uff0c\u6211\u4eec\u9700\u8981\u56de\u5230\u5730\u5f62\u4e0a\u65b9\u3002\u5f88\u7b80\u5355\u7684\u60f3\u6cd5\uff0c\u662f\u5417\uff1f\u786e\u5b9e\u662f\u8fd9\u6837\uff0c\u4f46\u5728\u6bd4\u8f83\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u51e0\u6b21\u8ba1\u7b97\u3002 \u6211\u4eec\u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u6211\u4eec\u5bf9\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u7406\u89e3\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u7403\u5458\u7684\u6982\u5ff5\uff0c\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5f53\u524d\u7684\u4f4d\u7f6e\u5c06\u662f\u76f8\u673a\u7684\u4f4d\u7f6e\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bd4\u8f83\u7684\u7ec4\u6210\u90e8\u5206\u4e4b\u4e00\uff0c\u56e0\u6b64\uff0c\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u7684\u662f\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u6982\u5ff5\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u201c\u73a9\u5bb6\u201d\u7684\u6982\u5ff5\uff0c\u56e0\u6b64\u5f53\u524d\u4f4d\u7f6e\u5c06\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002\u8fd9\u6837\u6211\u4eec\u5c31\u6709\u4e86\u6bd4\u8f83\u7684\u4e00\u65b9\uff0c\u56e0\u6b64\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u5982\u4e0a\u6240\u662f\uff0c\u5730\u5f62\u7531\u5730\u5f62\u5757\u7ec4\u6210\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u76f8\u540c\u7684\u9ad8\u5ea6\u56fe\u7f51\u683c\u6784\u6210\uff0c\u4f46\u88ab\u7cbe\u786e\u5730\u7f29\u653e\u548c\u4f4d\u79fb\uff0c\u4ee5\u5f62\u6210\u770b\u8d77\u6765\u50cf\u662f\u8fde\u7eed\u7684\u666f\u89c2\u7684\u5730\u5f62\u7f51\u683c\u3002 \u6240\u4ee5\u9996\u5148\u8981\u505a\u7684\u662f\u786e\u5b9a\u5f53\u524d\u4f4d\u7f6e(\u6444\u50cf\u673a\u4f4d\u7f6e)\u5728\u54ea\u4e2a\u5730\u5f62\u5757\u3002\u4e3a\u4e86\u5f97\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4f4d\u79fb\u548c\u7f29\u653e\u6765\u8ba1\u7b97\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2( BoundingBox )\u3002\u56e0\u4e3a\u5730\u5f62\u5728\u8fd0\u884c\u65f6\u4e0d\u4f1a\u79fb\u52a8\u6216\u7f29\u653e\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\u3002\u8fd9\u6837\u5c31\u53ef\u4ee5\u5728\u4efb\u4f55\u65f6\u5019\u8bbf\u95ee\u5b83\u4eec\uff0c\u800c\u4e0d\u9700\u8981\u5728\u6bcf\u4e2a\u6e38\u620f\u5faa\u73af\u5468\u671f\u4e2d\u91cd\u590d\u8fd9\u4e9b\u8ba1\u7b97\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u4e00\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u540d\u4e3a getBoundingBox \u3002 private Box2D getBoundingBox(GameItem terrainBlock) { float scale = terrainBlock.getScale(); Vector3f position = terrainBlock.getPosition(); float topLeftX = HeightMapMesh.STARTX * scale + position.x; float topLeftZ = HeightMapMesh.STARTZ * scale + position.z; float width = Math.abs(HeightMapMesh.STARTX * 2) * scale; float height = Math.abs(HeightMapMesh.STARTZ * 2) * scale; Box2D boundingBox = new Box2D(topLeftX, topLeftZ, width, height); return boundingBox; } Box2D \u662f java.awt.Rectangle2D.Float \u7c7b\u7684\u7b80\u5316\u7248\u672c\uff0c\u4e3a\u4e86\u907f\u514d\u4f7f\u7528AWT\u800c\u521b\u5efa\u3002 \u9650\u5236\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5730\u5f62\u5757\u7684\u4e16\u754c\u5750\u6807\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u4f60\u770b\u5230\u6240\u6709\u7684\u5730\u5f62\u7f51\u683c\u90fd\u662f\u5728\u4e00\u4e2a\u6b63\u65b9\u5f62\u4e2d\u521b\u5efa\u7684\uff0c\u5b83\u7684\u539f\u70b9\u8bbe\u7f6e\u4e3a [STARTX, STARTZ] \u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\uff0c\u8fd9\u8981\u8003\u8651\u4e0b\u56fe\u6240\u793a\u7684\u4f4d\u79fb\u4e0e\u7f29\u653e\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u8fd9\u53ef\u4ee5\u5728 Terrain \u7c7b\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u56e0\u4e3a\u5b83\u4e0d\u4f1a\u5728\u8fd0\u884c\u65f6\u53d1\u751f\u53d8\u5316\uff0c\u6240\u4ee5\u6211\u4eec\u8981\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027\u6765\u4fdd\u5b58\u5305\u56f4\u76d2\uff1a private final Box2D[][] boundingBoxes; \u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u5f53\u6211\u4eec\u521b\u5efa\u5730\u5f62\u5757\u65f6\uff0c\u53ea\u9700\u8c03\u7528\u8ba1\u7b97\u5305\u56f4\u76d2\u7684\u65b9\u6cd5\u3002 public Terrain(int terrainSize, float scale, float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { this.terrainSize = terrainSize; gameItems = new GameItem[terrainSize * terrainSize]; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); // \u6bcf\u884c\u4e0e\u6bcf\u5217\u7684\u9876\u70b9\u6570 verticesPerCol = heightMapImage.getWidth(); verticesPerRow = heightMapImage.getHeight(); heightMapMesh = new HeightMapMesh(minY, maxY, buf, width, textureFile, textInc); boundingBoxes = new Box2D[terrainSize][terrainSize]; for (int row = 0; row < terrainSize; row++) { for (int col = 0; col < terrainSize; col++) { float xDisplacement = (col - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * terrainSize + col] = terrainBlock; boundingBoxes[row][col] = getBoundingBox(terrainBlock); } } } \u56e0\u6b64\uff0c\u6709\u4e86\u6240\u6709\u9884\u5148\u8ba1\u7b97\u7684\u5305\u56f4\u76d2\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u4ee5\u5f53\u524d\u4f4d\u7f6e\u4e3a\u53c2\u6570\uff0c\u8fd4\u56de\u5bf9\u5e94\u5730\u5f62\u9ad8\u5ea6\u3002\u8be5\u65b9\u6cd5\u540d\u4e3a getHeight \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u3002 public float getHeight(Vector3f position) { float result = Float.MIN_VALUE; // \u5bf9\u4e8e\u6bcf\u4e2a\u5730\u5f62\u5757\uff0c\u6211\u4eec\u83b7\u53d6\u5305\u56f4\u76d2\uff0c\u5c06\u5176\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb // \u68c0\u67e5\u5750\u6807\u662f\u5426\u5305\u542b\u5728\u5305\u56f4\u76d2\u4e2d Box2D boundingBox = null; boolean found = false; GameItem terrainBlock = null; for (int row = 0; row < terrainSize && !found; row++) { for (int col = 0; col < terrainSize && !found; col++) { terrainBlock = gameItems[row * terrainSize + col]; boundingBox = boundingBoxes[row][col]; found = boundingBox.contains(position.x, position.z); } } // \u5982\u679c\u6211\u4eec\u627e\u5230\u4e86\u4e00\u4e2a\u5305\u542b\u6211\u4eec\u4f4d\u7f6e\u7684\u5730\u5f62\u5757 // \u8ba1\u7b97\u8be5\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6 if (found) { Vector3f[] triangle = getTriangle(position, boundingBox, terrainBlock); result = interpolateHeight(triangle[0], triangle[1], triangle[2], position.x, position.z); } return result; } \u5728\u6b64\u65b9\u6cd5\u4e2d\u7b2c\u4e00\u4ef6\u4e8b\u662f\u786e\u5b9a\u6211\u4eec\u6240\u5728\u7684\u5730\u5f62\u5757\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u6240\u4ee5\u7b97\u6cd5\u5f88\u7b80\u5355\u3002\u6211\u4eec\u53ea\u9700\u8981\u8fed\u4ee3\u5305\u56f4\u76d2\u6570\u7ec4\uff0c\u5e76\u68c0\u67e5\u5f53\u524d\u4f4d\u7f6e\u662f\u5426\u4f4d\u4e8e\u5176\u4e2d( Box2D \u63d0\u4f9b\u4e86\u8be5\u65b9\u6cd5)\u3002 \u4e00\u65e6\u627e\u5230\u4e86\u5730\u5f62\u5757\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6240\u5904\u7684\u4e09\u89d2\u5f62\uff0c\u8fd9\u662f\u7531\u4e4b\u540e\u7684 getTriangle \u65b9\u6cd5\u8ba1\u7b97\u7684\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6240\u5728\u4e09\u89d2\u5f62\u7684\u5750\u6807\uff0c\u5305\u62ec\u5b83\u7684\u9ad8\u5ea6\u3002\u4f46\u662f\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u4e00\u4e2a\u70b9\u7684\u9ad8\u5ea6\uff0c\u8fd9\u4e2a\u70b9\u4e0d\u4f4d\u4e8e\u8fd9\u4e9b\u9876\u70b9\u4e2d\u7684\u4efb\u4f55\u4e00\u70b9\uff0c\u800c\u4f4d\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u4f4d\u7f6e\u3002\u8fd9\u5c06\u5728 interpolateHeight \u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u6211\u4eec\u4e5f\u5c06\u89e3\u91ca\u8fd9\u662f\u5982\u4f55\u8ba1\u7b97\u7684\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u786e\u5b9a\u6240\u5904\u7684\u4e09\u89d2\u5f62\u5f00\u59cb\u3002\u6784\u6210\u5730\u5f62\u5757\u7684\u6b63\u65b9\u5f62\u53ef\u4ee5\u770b\u4f5c\u4e00\u4e2a\u7f51\u683c\uff0c\u5176\u4e2d\u6bcf\u4e2a\u5355\u5143\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e00\u4e9b\u53d8\u91cf\uff1a boundingBox.x \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f x \u5750\u6807\u3002 boundingBox.y \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f z \u5750\u6807(\u5373\u4f7f\u4f60\u770b\u5230\u4e00\u4e2a y \uff0c\u4f46\u5b83\u662f\u5728 z \u8f74\u7684)\u3002 boundingBox.width \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u5bbd\u5ea6\u3002 boundingBox.height \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u3002 cellWidth \u662f\u4e00\u4e2a\u5355\u5143\u7684\u5bbd\u5ea6\u3002 cellHeight \u662f\u4e00\u4e2a\u5355\u5143\u7684\u9ad8\u5ea6\u3002 \u4e0a\u9762\u5b9a\u4e49\u7684\u6240\u6709\u53d8\u91cf\u90fd\u7528\u4e16\u754c\u5750\u6807\u6765\u8868\u793a\u3002\u4e3a\u4e86\u8ba1\u7b97\u5355\u5143\u7684\u5bbd\u5ea6\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5305\u56f4\u76d2\u5bbd\u5ea6\u9664\u4ee5\u6bcf\u5217\u7684\u9876\u70b9\u6570\uff1a cellWidth = \\frac{boundingBox.width}{verticesPerCol} cellHeight \u7684\u8ba1\u7b97\u4e5f\u76f8\u4f3c\uff1a cellHeight = \\frac{boundingBox.height}{verticesPerRow} \u4e00\u65e6\u6709\u4e86\u8fd9\u4e9b\u53d8\u91cf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6240\u5728\u7684\u5355\u5143\u683c\u7684\u884c\u548c\u5217\u4e86\uff1a col = \\frac{position.x - boundingBox.x}{boundingBox.width} row = \\frac{position.z - boundingBox.y}{boundingBox.height} \u4e0b\u56fe\u5728\u793a\u4f8b\u5730\u5f62\u5757\u5c55\u793a\u4e86\u6b64\u524d\u63cf\u8ff0\u7684\u6240\u6709\u53d8\u91cf\u3002 \u6709\u4e86\u8fd9\u4e9b\u4fe1\u606f\uff0c\u5c31\u53ef\u4ee5\u8ba1\u7b97\u5355\u5143\u683c\u4e2d\u5305\u542b\u7684\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u4f4d\u7f6e\u3002\u6211\u4eec\u600e\u4e48\u624d\u80fd\u505a\u5230\u5462\uff1f\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7ec4\u6210\u4e00\u4e2a\u5355\u5143\u683c\u7684\u4e09\u89d2\u5f62\u3002 \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5355\u5143\u683c\u662f\u88ab\u4e00\u4e2a\u5bf9\u89d2\u7ebf\u5206\u5f00\u4e3a\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u3002\u786e\u5b9a\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u662f\u68c0\u67e5 z \u5750\u6807\u5728\u5bf9\u89d2\u7ebf\u7684\u4e0a\u65b9\u8fd8\u662f\u4e0b\u65b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5c06\u5bf9\u89d2\u7ebf\u7684 x \u503c\u8bbe\u7f6e\u4e3a\u5f53\u524d\u4f4d\u7f6e\u7684 x \u503c\uff0c\u6c42\u51fa\u5bf9\u5e94\u7684\u5bf9\u89d2\u7ebf z \u503c\uff0c\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5c0f\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u90a3\u4e48\u6211\u4eec\u5728 T1 \u4e2d\u3002\u53cd\u4e4b\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5927\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u6211\u4eec\u5c31\u5728 T2 \u4e2d\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u4e0e\u5bf9\u89d2\u7ebf\u76f8\u5339\u914d\u7684\u76f4\u7ebf\u65b9\u7a0b\u6765\u786e\u5b9a\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u5b66\u6821\u7684\u6570\u5b66\u8bfe\uff0c\u4ece\u4e24\u70b9\u901a\u8fc7\u7684\u76f4\u7ebf(\u5728\u4e8c\u7ef4\u4e2d)\u7684\u65b9\u7a0b\u4e3a: y-y1=m\\cdot(x-x1) \u5176\u4e2dm\u662f\u76f4\u7ebf\u7684\u659c\u7387\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5f53\u6cbf x \u8f74\u79fb\u52a8\u65f6\uff0c\u5176\u9ad8\u5ea6\u4f1a\u53d1\u751f\u53d8\u5316\u3002\u8bf7\u6ce8\u610f\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c y \u5750\u6807\u5176\u5b9e\u662f\u4e00\u4e2a z \u3002\u8fd8\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u4e8c\u7ef4\u5750\u6807\uff0c\u56e0\u4e3a\u5728\u8fd9\u91cc\u4e0d\u8ba1\u7b97\u9ad8\u5ea6\uff0c\u53ea\u8981 x \u5750\u6807\u548c z \u5750\u6807\u5c31\u8db3\u591f\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u76f4\u7ebf\u65b9\u7a0b\u5e94\u8be5\u662f\u8fd9\u6837\u3002 z-z1=m\\cdot(x-x1) \u659c\u7387\u53ef\u4ee5\u6309\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a m=\\frac{z1-z2}{x1-x2} \u6240\u4ee5\u7ed9\u5b9a\u4e00\u4e2a x \u5750\u6807\u5f97\u5230\u4e00\u4e2a z \u503c\u7684\u5bf9\u89d2\u7ebf\u65b9\u7a0b\u5c31\u50cf\u8fd9\u6837\uff1a z=m\\cdot(xpos-x1)+z1=\\frac{z1-z2}{x1-x2}\\cdot(zpos-x1)+z1 \u5176\u4e2d x1 \u3001 x2 \u3001 z1 \u548c z2 \u5206\u522b\u662f\u9876\u70b9 V1 \u548c V2 \u7684 x \u548c z \u5750\u6807\u3002 \u56e0\u6b64\uff0c\u901a\u8fc7\u4e0a\u8ff0\u65b9\u5f0f\u6765\u83b7\u5f97\u5f53\u524d\u4f4d\u7f6e\u6240\u5728\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getTriangle \uff0c\u5176\u5b9e\u73b0\u5982\u4e0b\uff1a protected Vector3f[] getTriangle(Vector3f position, Box2D boundingBox, GameItem terrainBlock) { // \u83b7\u5f97\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u9ad8\u5ea6\u56fe\u7684\u884c\u5217 float cellWidth = boundingBox.width / (float) verticesPerCol; float cellHeight = boundingBox.height / (float) verticesPerRow; int col = (int) ((position.x - boundingBox.x) / cellWidth); int row = (int) ((position.z - boundingBox.y) / cellHeight); Vector3f[] triangle = new Vector3f[3]; triangle[1] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row + 1, col, terrainBlock), boundingBox.y + (row + 1) * cellHeight); triangle[2] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row, col + 1, terrainBlock), boundingBox.y + row * cellHeight); if (position.z < getDiagonalZCoord(triangle[1].x, triangle[1].z, triangle[2].x, triangle[2].z, position.x)) { triangle[0] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row, col, terrainBlock), boundingBox.y + row * cellHeight); } else { triangle[0] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row + 2, col + 1, terrainBlock), boundingBox.y + (row + 1) * cellHeight); } return triangle; } protected float getDiagonalZCoord(float x1, float z1, float x2, float z2, float x) { float z = ((z1 - z2) / (x1 - x2)) * (x - x1) + z1; return z; } protected float getWorldHeight(int row, int col, GameItem gameItem) { float y = heightMapMesh.getHeight(row, col); return y * gameItem.getScale() + gameItem.getPosition().y; } \u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6709\u53e6\u5916\u4e24\u4e2a\u53cd\u590d\u3002\u7b2c\u4e00\u4e2a\u540d\u4e3a getDiagonalZCoord \uff0c\u7ed9\u5b9a x \u4f4d\u7f6e\u548c\u4e24\u4e2a\u9876\u70b9\u8ba1\u7b97\u5bf9\u89d2\u7ebf\u7684 z \u5750\u6807\u3002\u53e6\u4e00\u4e2a\u540d\u4e3a getWorldHeight \uff0c\u7528\u6765\u83b7\u5f97\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u9ad8\u5ea6(\u5373 y \u5750\u6807)\u3002\u5f53\u5730\u5f62\u7f51\u683c\u88ab\u521b\u5efa\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u90fd\u88ab\u9884\u5148\u8ba1\u7b97\u548c\u50a8\u5b58\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002 \u597d\uff0c\u6211\u4eec\u6709\u5f53\u524d\u4f4d\u7f6e\u7684\u4e09\u89d2\u5f62\u5750\u6807\u3002\u6700\u540e\uff0c\u6211\u4eec\u51c6\u5907\u5728\u5f53\u524d\u4f4d\u7f6e\u8ba1\u7b97\u5730\u5f62\u9ad8\u5ea6\u3002\u600e\u4e48\u505a\u5462\uff1f\u6211\u4eec\u7684\u4e09\u89d2\u5f62\u5728\u4e00\u4e2a\u5e73\u9762\u4e0a\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u7531\u4e09\u4e2a\u70b9\u5b9a\u4e49\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002 \u5e73\u9762\u65b9\u7a0b\u5982\u4e0b\uff1a a\\cdot x+b\\cdot y+c\\cdot z+d=0 \u4e0a\u8ff0\u65b9\u7a0b\u7684\u5e38\u6570\u503c\u662f\uff1a a=(B_{y}-A_{y}) \\cdot (C_{z} - A_{z}) - (C_{y} - A_{y}) \\cdot (B_{z}-A_{z}) b=(B_{z}-A_{z}) \\cdot (C_{x} - A_{x}) - (C_{z} - A_{z}) \\cdot (B_{z}-A_{z}) c=(B_{x}-A_{x}) \\cdot (C_{y} - A_{y}) - (C_{x} - A_{x}) \\cdot (B_{y}-A_{y}) \u5176\u4e2d A \u3001 B \u548c C \u662f\u5b9a\u4e49\u5e73\u9762\u6240\u9700\u7684\u4e09\u4e2a\u9876\u70b9\u3002 \u7136\u540e\uff0c\u5229\u7528\u4e4b\u524d\u7684\u65b9\u7a0b\u4ee5\u53ca\u5f53\u524d\u4f4d\u7f6e\u7684 x \u548c z \u5750\u6807\u503c\uff0c\u6211\u4eec\u80fd\u591f\u8ba1\u7b97 y \u503c\uff0c\u5373\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\uff1a y = (-d - a \\cdot x - c \\cdot z) / b \u5b9e\u73b0\u4e86\u5982\u4e0a\u8fd0\u7b97\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a protected float interpolateHeight(Vector3f pA, Vector3f pB, Vector3f pC, float x, float z) { // \u5e73\u9762\u65b9\u7a0b ax+by+cz+d=0 float a = (pB.y - pA.y) * (pC.z - pA.z) - (pC.y - pA.y) * (pB.z - pA.z); float b = (pB.z - pA.z) * (pC.x - pA.x) - (pC.z - pA.z) * (pB.x - pA.x); float c = (pB.x - pA.x) * (pC.y - pA.y) - (pC.x - pA.x) * (pB.y - pA.y); float d = -(a * pA.x + b * pA.y + c * pA.z); // y = (-d -ax -cz) / b float y = (-d - a * x - c * z) / b; return y; } \u8fd9\u5c31\u5b8c\u4e86\uff01\u73b0\u5728\u6211\u4eec\u80fd\u591f\u68c0\u6d4b\u78b0\u649e\uff0c\u6240\u4ee5\u5728 DummyGame \u7c7b\u4e2d\uff0c\u5728\u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e\u65f6\uff0c\u4fee\u6539\u5982\u4e0b\u4ee3\u7801\uff1a // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e Vector3f prevPos = new Vector3f(camera.getPosition()); camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u68c0\u67e5\u662f\u5426\u53d1\u751f\u78b0\u649e\u3002\u5982\u679c\u4e3atrue\uff0c\u5c06y\u5750\u6807\u8bbe\u7f6e\u4e3a // \u6700\u5927\u9ad8\u5ea6 float height = terrain.getHeight(camera.getPosition()); if ( camera.getPosition().y <= height ) { camera.setPosition(prevPos.x, prevPos.y, prevPos.z); } \u5982\u4f60\u6240\u89c1\uff0c\u68c0\u6d4b\u5730\u5f62\u78b0\u649e\u7684\u6982\u5ff5\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ed4\u7ec6\u5730\u8fdb\u884c\u8ba1\u7b97\u5e76\u4e86\u89e3\u6b63\u5904\u7406\u7684\u4e0d\u540c\u5750\u6807\u7cfb\u3002 \u6b64\u5916\uff0c\u867d\u7136\u8fd9\u91cc\u7ed9\u51fa\u7684\u7b97\u6cd5\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u662f\u53ef\u7528\u7684\uff0c\u4f46\u4ecd\u5b58\u5728\u9700\u8981\u4ed4\u7ec6\u5904\u7406\u7684\u60c5\u51b5\u3002\u4f60\u53ef\u4ee5\u53d1\u73b0\u7684\u4e00\u4e2a\u95ee\u9898\u662f\u96a7\u9053\u6548\u5e94( Tunnelling )\u3002\u8bbe\u60f3\u4e00\u4e2a\u60c5\u51b5\uff0c\u6211\u4eec\u6b63\u4ee5\u9ad8\u901f\u7a7f\u8fc7\u5730\u5f62\uff0c\u6b63\u56e0\u5982\u6b64\uff0c\u4f4d\u7f6e\u589e\u91cf\u503c\u8f83\u9ad8\u3002\u8fd9\u4e2a\u503c\u53d8\u5f97\u5982\u6b64\u4e4b\u9ad8\uff0c\u4ee5\u81f3\u4e8e\u56e0\u4e3a\u6211\u4eec\u68c0\u6d4b\u7684\u662f\u6700\u7ec8\u4f4d\u7f6e\u7684\u78b0\u649e\uff0c\u6240\u4ee5\u53ef\u80fd\u5df2\u7ecf\u7a7f\u8fc7\u4e86\u4f4d\u4e8e\u4e24\u70b9\u4e4b\u95f4\u7684\u969c\u788d\u3002 \u6709\u8bb8\u591a\u53ef\u884c\u7684\u89e3\u51b3\u65b9\u6848\u53ef\u4ee5\u907f\u514d\u8fd9\u4e2a\u6548\u5e94\uff0c\u6700\u7b80\u5355\u7684\u89e3\u51b3\u65b9\u6cd5\u662f\u5c06\u8981\u8fdb\u884c\u7684\u8ba1\u7b97\u5206\u6210\u589e\u91cf\u8f83\u5c0f\u7684\u591a\u4efd\u3002","title":"\u5730\u5f62\u78b0\u649e"},{"location":"15-terrain-collisions/#terrain-collisions","text":"\u6b64\u524d\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u5730\u5f62\uff0c\u63a5\u4e0b\u6765\u5c31\u662f\u68c0\u6d4b\u78b0\u649e\u4ee5\u907f\u514d\u7a7f\u8fc7\u5b83\u3002\u56de\u5fc6\u4e00\u4e0b\u4e4b\u524d\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u5730\u5f62\u662f\u7531\u5730\u5f62\u5757\u7ec4\u6210\u7684\uff0c\u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u9ad8\u5ea6\u56fe\u751f\u6210\u7684\uff0c\u9ad8\u5ea6\u56fe\u7528\u4e8e\u8bbe\u7f6e\u6784\u6210\u5730\u5f62\u7684\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u9ad8\u5ea6\u3002 \u4e3a\u4e86\u68c0\u6d4b\u78b0\u649e\uff0c\u6211\u4eec\u5fc5\u987b\u5c06\u5f53\u524d\u6240\u5728\u4f4d\u7f6e\u7684 Y \u503c\u4e0e\u5f53\u524d\u5730\u5f62\u70b9\u7684 Y \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u6709\u78b0\u649e\uff0c\u6211\u4eec\u9700\u8981\u56de\u5230\u5730\u5f62\u4e0a\u65b9\u3002\u5f88\u7b80\u5355\u7684\u60f3\u6cd5\uff0c\u662f\u5417\uff1f\u786e\u5b9e\u662f\u8fd9\u6837\uff0c\u4f46\u5728\u6bd4\u8f83\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u51e0\u6b21\u8ba1\u7b97\u3002 \u6211\u4eec\u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u6211\u4eec\u5bf9\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u7406\u89e3\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u7403\u5458\u7684\u6982\u5ff5\uff0c\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5f53\u524d\u7684\u4f4d\u7f6e\u5c06\u662f\u76f8\u673a\u7684\u4f4d\u7f6e\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bd4\u8f83\u7684\u7ec4\u6210\u90e8\u5206\u4e4b\u4e00\uff0c\u56e0\u6b64\uff0c\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u7684\u662f\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u6982\u5ff5\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u201c\u73a9\u5bb6\u201d\u7684\u6982\u5ff5\uff0c\u56e0\u6b64\u5f53\u524d\u4f4d\u7f6e\u5c06\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002\u8fd9\u6837\u6211\u4eec\u5c31\u6709\u4e86\u6bd4\u8f83\u7684\u4e00\u65b9\uff0c\u56e0\u6b64\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u5982\u4e0a\u6240\u662f\uff0c\u5730\u5f62\u7531\u5730\u5f62\u5757\u7ec4\u6210\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u76f8\u540c\u7684\u9ad8\u5ea6\u56fe\u7f51\u683c\u6784\u6210\uff0c\u4f46\u88ab\u7cbe\u786e\u5730\u7f29\u653e\u548c\u4f4d\u79fb\uff0c\u4ee5\u5f62\u6210\u770b\u8d77\u6765\u50cf\u662f\u8fde\u7eed\u7684\u666f\u89c2\u7684\u5730\u5f62\u7f51\u683c\u3002 \u6240\u4ee5\u9996\u5148\u8981\u505a\u7684\u662f\u786e\u5b9a\u5f53\u524d\u4f4d\u7f6e(\u6444\u50cf\u673a\u4f4d\u7f6e)\u5728\u54ea\u4e2a\u5730\u5f62\u5757\u3002\u4e3a\u4e86\u5f97\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4f4d\u79fb\u548c\u7f29\u653e\u6765\u8ba1\u7b97\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2( BoundingBox )\u3002\u56e0\u4e3a\u5730\u5f62\u5728\u8fd0\u884c\u65f6\u4e0d\u4f1a\u79fb\u52a8\u6216\u7f29\u653e\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\u3002\u8fd9\u6837\u5c31\u53ef\u4ee5\u5728\u4efb\u4f55\u65f6\u5019\u8bbf\u95ee\u5b83\u4eec\uff0c\u800c\u4e0d\u9700\u8981\u5728\u6bcf\u4e2a\u6e38\u620f\u5faa\u73af\u5468\u671f\u4e2d\u91cd\u590d\u8fd9\u4e9b\u8ba1\u7b97\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u4e00\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u540d\u4e3a getBoundingBox \u3002 private Box2D getBoundingBox(GameItem terrainBlock) { float scale = terrainBlock.getScale(); Vector3f position = terrainBlock.getPosition(); float topLeftX = HeightMapMesh.STARTX * scale + position.x; float topLeftZ = HeightMapMesh.STARTZ * scale + position.z; float width = Math.abs(HeightMapMesh.STARTX * 2) * scale; float height = Math.abs(HeightMapMesh.STARTZ * 2) * scale; Box2D boundingBox = new Box2D(topLeftX, topLeftZ, width, height); return boundingBox; } Box2D \u662f java.awt.Rectangle2D.Float \u7c7b\u7684\u7b80\u5316\u7248\u672c\uff0c\u4e3a\u4e86\u907f\u514d\u4f7f\u7528AWT\u800c\u521b\u5efa\u3002 \u9650\u5236\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5730\u5f62\u5757\u7684\u4e16\u754c\u5750\u6807\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u4f60\u770b\u5230\u6240\u6709\u7684\u5730\u5f62\u7f51\u683c\u90fd\u662f\u5728\u4e00\u4e2a\u6b63\u65b9\u5f62\u4e2d\u521b\u5efa\u7684\uff0c\u5b83\u7684\u539f\u70b9\u8bbe\u7f6e\u4e3a [STARTX, STARTZ] \u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\uff0c\u8fd9\u8981\u8003\u8651\u4e0b\u56fe\u6240\u793a\u7684\u4f4d\u79fb\u4e0e\u7f29\u653e\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u8fd9\u53ef\u4ee5\u5728 Terrain \u7c7b\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u56e0\u4e3a\u5b83\u4e0d\u4f1a\u5728\u8fd0\u884c\u65f6\u53d1\u751f\u53d8\u5316\uff0c\u6240\u4ee5\u6211\u4eec\u8981\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027\u6765\u4fdd\u5b58\u5305\u56f4\u76d2\uff1a private final Box2D[][] boundingBoxes; \u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u5f53\u6211\u4eec\u521b\u5efa\u5730\u5f62\u5757\u65f6\uff0c\u53ea\u9700\u8c03\u7528\u8ba1\u7b97\u5305\u56f4\u76d2\u7684\u65b9\u6cd5\u3002 public Terrain(int terrainSize, float scale, float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { this.terrainSize = terrainSize; gameItems = new GameItem[terrainSize * terrainSize]; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); // \u6bcf\u884c\u4e0e\u6bcf\u5217\u7684\u9876\u70b9\u6570 verticesPerCol = heightMapImage.getWidth(); verticesPerRow = heightMapImage.getHeight(); heightMapMesh = new HeightMapMesh(minY, maxY, buf, width, textureFile, textInc); boundingBoxes = new Box2D[terrainSize][terrainSize]; for (int row = 0; row < terrainSize; row++) { for (int col = 0; col < terrainSize; col++) { float xDisplacement = (col - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * terrainSize + col] = terrainBlock; boundingBoxes[row][col] = getBoundingBox(terrainBlock); } } } \u56e0\u6b64\uff0c\u6709\u4e86\u6240\u6709\u9884\u5148\u8ba1\u7b97\u7684\u5305\u56f4\u76d2\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u4ee5\u5f53\u524d\u4f4d\u7f6e\u4e3a\u53c2\u6570\uff0c\u8fd4\u56de\u5bf9\u5e94\u5730\u5f62\u9ad8\u5ea6\u3002\u8be5\u65b9\u6cd5\u540d\u4e3a getHeight \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u3002 public float getHeight(Vector3f position) { float result = Float.MIN_VALUE; // \u5bf9\u4e8e\u6bcf\u4e2a\u5730\u5f62\u5757\uff0c\u6211\u4eec\u83b7\u53d6\u5305\u56f4\u76d2\uff0c\u5c06\u5176\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb // \u68c0\u67e5\u5750\u6807\u662f\u5426\u5305\u542b\u5728\u5305\u56f4\u76d2\u4e2d Box2D boundingBox = null; boolean found = false; GameItem terrainBlock = null; for (int row = 0; row < terrainSize && !found; row++) { for (int col = 0; col < terrainSize && !found; col++) { terrainBlock = gameItems[row * terrainSize + col]; boundingBox = boundingBoxes[row][col]; found = boundingBox.contains(position.x, position.z); } } // \u5982\u679c\u6211\u4eec\u627e\u5230\u4e86\u4e00\u4e2a\u5305\u542b\u6211\u4eec\u4f4d\u7f6e\u7684\u5730\u5f62\u5757 // \u8ba1\u7b97\u8be5\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6 if (found) { Vector3f[] triangle = getTriangle(position, boundingBox, terrainBlock); result = interpolateHeight(triangle[0], triangle[1], triangle[2], position.x, position.z); } return result; } \u5728\u6b64\u65b9\u6cd5\u4e2d\u7b2c\u4e00\u4ef6\u4e8b\u662f\u786e\u5b9a\u6211\u4eec\u6240\u5728\u7684\u5730\u5f62\u5757\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u6240\u4ee5\u7b97\u6cd5\u5f88\u7b80\u5355\u3002\u6211\u4eec\u53ea\u9700\u8981\u8fed\u4ee3\u5305\u56f4\u76d2\u6570\u7ec4\uff0c\u5e76\u68c0\u67e5\u5f53\u524d\u4f4d\u7f6e\u662f\u5426\u4f4d\u4e8e\u5176\u4e2d( Box2D \u63d0\u4f9b\u4e86\u8be5\u65b9\u6cd5)\u3002 \u4e00\u65e6\u627e\u5230\u4e86\u5730\u5f62\u5757\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6240\u5904\u7684\u4e09\u89d2\u5f62\uff0c\u8fd9\u662f\u7531\u4e4b\u540e\u7684 getTriangle \u65b9\u6cd5\u8ba1\u7b97\u7684\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6240\u5728\u4e09\u89d2\u5f62\u7684\u5750\u6807\uff0c\u5305\u62ec\u5b83\u7684\u9ad8\u5ea6\u3002\u4f46\u662f\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u4e00\u4e2a\u70b9\u7684\u9ad8\u5ea6\uff0c\u8fd9\u4e2a\u70b9\u4e0d\u4f4d\u4e8e\u8fd9\u4e9b\u9876\u70b9\u4e2d\u7684\u4efb\u4f55\u4e00\u70b9\uff0c\u800c\u4f4d\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u4f4d\u7f6e\u3002\u8fd9\u5c06\u5728 interpolateHeight \u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u6211\u4eec\u4e5f\u5c06\u89e3\u91ca\u8fd9\u662f\u5982\u4f55\u8ba1\u7b97\u7684\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u786e\u5b9a\u6240\u5904\u7684\u4e09\u89d2\u5f62\u5f00\u59cb\u3002\u6784\u6210\u5730\u5f62\u5757\u7684\u6b63\u65b9\u5f62\u53ef\u4ee5\u770b\u4f5c\u4e00\u4e2a\u7f51\u683c\uff0c\u5176\u4e2d\u6bcf\u4e2a\u5355\u5143\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e00\u4e9b\u53d8\u91cf\uff1a boundingBox.x \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f x \u5750\u6807\u3002 boundingBox.y \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f z \u5750\u6807(\u5373\u4f7f\u4f60\u770b\u5230\u4e00\u4e2a y \uff0c\u4f46\u5b83\u662f\u5728 z \u8f74\u7684)\u3002 boundingBox.width \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u5bbd\u5ea6\u3002 boundingBox.height \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u3002 cellWidth \u662f\u4e00\u4e2a\u5355\u5143\u7684\u5bbd\u5ea6\u3002 cellHeight \u662f\u4e00\u4e2a\u5355\u5143\u7684\u9ad8\u5ea6\u3002 \u4e0a\u9762\u5b9a\u4e49\u7684\u6240\u6709\u53d8\u91cf\u90fd\u7528\u4e16\u754c\u5750\u6807\u6765\u8868\u793a\u3002\u4e3a\u4e86\u8ba1\u7b97\u5355\u5143\u7684\u5bbd\u5ea6\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5305\u56f4\u76d2\u5bbd\u5ea6\u9664\u4ee5\u6bcf\u5217\u7684\u9876\u70b9\u6570\uff1a cellWidth = \\frac{boundingBox.width}{verticesPerCol} cellHeight \u7684\u8ba1\u7b97\u4e5f\u76f8\u4f3c\uff1a cellHeight = \\frac{boundingBox.height}{verticesPerRow} \u4e00\u65e6\u6709\u4e86\u8fd9\u4e9b\u53d8\u91cf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6240\u5728\u7684\u5355\u5143\u683c\u7684\u884c\u548c\u5217\u4e86\uff1a col = \\frac{position.x - boundingBox.x}{boundingBox.width} row = \\frac{position.z - boundingBox.y}{boundingBox.height} \u4e0b\u56fe\u5728\u793a\u4f8b\u5730\u5f62\u5757\u5c55\u793a\u4e86\u6b64\u524d\u63cf\u8ff0\u7684\u6240\u6709\u53d8\u91cf\u3002 \u6709\u4e86\u8fd9\u4e9b\u4fe1\u606f\uff0c\u5c31\u53ef\u4ee5\u8ba1\u7b97\u5355\u5143\u683c\u4e2d\u5305\u542b\u7684\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u4f4d\u7f6e\u3002\u6211\u4eec\u600e\u4e48\u624d\u80fd\u505a\u5230\u5462\uff1f\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7ec4\u6210\u4e00\u4e2a\u5355\u5143\u683c\u7684\u4e09\u89d2\u5f62\u3002 \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5355\u5143\u683c\u662f\u88ab\u4e00\u4e2a\u5bf9\u89d2\u7ebf\u5206\u5f00\u4e3a\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u3002\u786e\u5b9a\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u662f\u68c0\u67e5 z \u5750\u6807\u5728\u5bf9\u89d2\u7ebf\u7684\u4e0a\u65b9\u8fd8\u662f\u4e0b\u65b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5c06\u5bf9\u89d2\u7ebf\u7684 x \u503c\u8bbe\u7f6e\u4e3a\u5f53\u524d\u4f4d\u7f6e\u7684 x \u503c\uff0c\u6c42\u51fa\u5bf9\u5e94\u7684\u5bf9\u89d2\u7ebf z \u503c\uff0c\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5c0f\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u90a3\u4e48\u6211\u4eec\u5728 T1 \u4e2d\u3002\u53cd\u4e4b\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5927\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u6211\u4eec\u5c31\u5728 T2 \u4e2d\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u4e0e\u5bf9\u89d2\u7ebf\u76f8\u5339\u914d\u7684\u76f4\u7ebf\u65b9\u7a0b\u6765\u786e\u5b9a\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u5b66\u6821\u7684\u6570\u5b66\u8bfe\uff0c\u4ece\u4e24\u70b9\u901a\u8fc7\u7684\u76f4\u7ebf(\u5728\u4e8c\u7ef4\u4e2d)\u7684\u65b9\u7a0b\u4e3a: y-y1=m\\cdot(x-x1) \u5176\u4e2dm\u662f\u76f4\u7ebf\u7684\u659c\u7387\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5f53\u6cbf x \u8f74\u79fb\u52a8\u65f6\uff0c\u5176\u9ad8\u5ea6\u4f1a\u53d1\u751f\u53d8\u5316\u3002\u8bf7\u6ce8\u610f\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c y \u5750\u6807\u5176\u5b9e\u662f\u4e00\u4e2a z \u3002\u8fd8\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u4e8c\u7ef4\u5750\u6807\uff0c\u56e0\u4e3a\u5728\u8fd9\u91cc\u4e0d\u8ba1\u7b97\u9ad8\u5ea6\uff0c\u53ea\u8981 x \u5750\u6807\u548c z \u5750\u6807\u5c31\u8db3\u591f\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u76f4\u7ebf\u65b9\u7a0b\u5e94\u8be5\u662f\u8fd9\u6837\u3002 z-z1=m\\cdot(x-x1) \u659c\u7387\u53ef\u4ee5\u6309\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a m=\\frac{z1-z2}{x1-x2} \u6240\u4ee5\u7ed9\u5b9a\u4e00\u4e2a x \u5750\u6807\u5f97\u5230\u4e00\u4e2a z \u503c\u7684\u5bf9\u89d2\u7ebf\u65b9\u7a0b\u5c31\u50cf\u8fd9\u6837\uff1a z=m\\cdot(xpos-x1)+z1=\\frac{z1-z2}{x1-x2}\\cdot(zpos-x1)+z1 \u5176\u4e2d x1 \u3001 x2 \u3001 z1 \u548c z2 \u5206\u522b\u662f\u9876\u70b9 V1 \u548c V2 \u7684 x \u548c z \u5750\u6807\u3002 \u56e0\u6b64\uff0c\u901a\u8fc7\u4e0a\u8ff0\u65b9\u5f0f\u6765\u83b7\u5f97\u5f53\u524d\u4f4d\u7f6e\u6240\u5728\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getTriangle \uff0c\u5176\u5b9e\u73b0\u5982\u4e0b\uff1a protected Vector3f[] getTriangle(Vector3f position, Box2D boundingBox, GameItem terrainBlock) { // \u83b7\u5f97\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u9ad8\u5ea6\u56fe\u7684\u884c\u5217 float cellWidth = boundingBox.width / (float) verticesPerCol; float cellHeight = boundingBox.height / (float) verticesPerRow; int col = (int) ((position.x - boundingBox.x) / cellWidth); int row = (int) ((position.z - boundingBox.y) / cellHeight); Vector3f[] triangle = new Vector3f[3]; triangle[1] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row + 1, col, terrainBlock), boundingBox.y + (row + 1) * cellHeight); triangle[2] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row, col + 1, terrainBlock), boundingBox.y + row * cellHeight); if (position.z < getDiagonalZCoord(triangle[1].x, triangle[1].z, triangle[2].x, triangle[2].z, position.x)) { triangle[0] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row, col, terrainBlock), boundingBox.y + row * cellHeight); } else { triangle[0] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row + 2, col + 1, terrainBlock), boundingBox.y + (row + 1) * cellHeight); } return triangle; } protected float getDiagonalZCoord(float x1, float z1, float x2, float z2, float x) { float z = ((z1 - z2) / (x1 - x2)) * (x - x1) + z1; return z; } protected float getWorldHeight(int row, int col, GameItem gameItem) { float y = heightMapMesh.getHeight(row, col); return y * gameItem.getScale() + gameItem.getPosition().y; } \u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6709\u53e6\u5916\u4e24\u4e2a\u53cd\u590d\u3002\u7b2c\u4e00\u4e2a\u540d\u4e3a getDiagonalZCoord \uff0c\u7ed9\u5b9a x \u4f4d\u7f6e\u548c\u4e24\u4e2a\u9876\u70b9\u8ba1\u7b97\u5bf9\u89d2\u7ebf\u7684 z \u5750\u6807\u3002\u53e6\u4e00\u4e2a\u540d\u4e3a getWorldHeight \uff0c\u7528\u6765\u83b7\u5f97\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u9ad8\u5ea6(\u5373 y \u5750\u6807)\u3002\u5f53\u5730\u5f62\u7f51\u683c\u88ab\u521b\u5efa\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u90fd\u88ab\u9884\u5148\u8ba1\u7b97\u548c\u50a8\u5b58\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002 \u597d\uff0c\u6211\u4eec\u6709\u5f53\u524d\u4f4d\u7f6e\u7684\u4e09\u89d2\u5f62\u5750\u6807\u3002\u6700\u540e\uff0c\u6211\u4eec\u51c6\u5907\u5728\u5f53\u524d\u4f4d\u7f6e\u8ba1\u7b97\u5730\u5f62\u9ad8\u5ea6\u3002\u600e\u4e48\u505a\u5462\uff1f\u6211\u4eec\u7684\u4e09\u89d2\u5f62\u5728\u4e00\u4e2a\u5e73\u9762\u4e0a\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u7531\u4e09\u4e2a\u70b9\u5b9a\u4e49\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002 \u5e73\u9762\u65b9\u7a0b\u5982\u4e0b\uff1a a\\cdot x+b\\cdot y+c\\cdot z+d=0 \u4e0a\u8ff0\u65b9\u7a0b\u7684\u5e38\u6570\u503c\u662f\uff1a a=(B_{y}-A_{y}) \\cdot (C_{z} - A_{z}) - (C_{y} - A_{y}) \\cdot (B_{z}-A_{z}) b=(B_{z}-A_{z}) \\cdot (C_{x} - A_{x}) - (C_{z} - A_{z}) \\cdot (B_{z}-A_{z}) c=(B_{x}-A_{x}) \\cdot (C_{y} - A_{y}) - (C_{x} - A_{x}) \\cdot (B_{y}-A_{y}) \u5176\u4e2d A \u3001 B \u548c C \u662f\u5b9a\u4e49\u5e73\u9762\u6240\u9700\u7684\u4e09\u4e2a\u9876\u70b9\u3002 \u7136\u540e\uff0c\u5229\u7528\u4e4b\u524d\u7684\u65b9\u7a0b\u4ee5\u53ca\u5f53\u524d\u4f4d\u7f6e\u7684 x \u548c z \u5750\u6807\u503c\uff0c\u6211\u4eec\u80fd\u591f\u8ba1\u7b97 y \u503c\uff0c\u5373\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\uff1a y = (-d - a \\cdot x - c \\cdot z) / b \u5b9e\u73b0\u4e86\u5982\u4e0a\u8fd0\u7b97\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a protected float interpolateHeight(Vector3f pA, Vector3f pB, Vector3f pC, float x, float z) { // \u5e73\u9762\u65b9\u7a0b ax+by+cz+d=0 float a = (pB.y - pA.y) * (pC.z - pA.z) - (pC.y - pA.y) * (pB.z - pA.z); float b = (pB.z - pA.z) * (pC.x - pA.x) - (pC.z - pA.z) * (pB.x - pA.x); float c = (pB.x - pA.x) * (pC.y - pA.y) - (pC.x - pA.x) * (pB.y - pA.y); float d = -(a * pA.x + b * pA.y + c * pA.z); // y = (-d -ax -cz) / b float y = (-d - a * x - c * z) / b; return y; } \u8fd9\u5c31\u5b8c\u4e86\uff01\u73b0\u5728\u6211\u4eec\u80fd\u591f\u68c0\u6d4b\u78b0\u649e\uff0c\u6240\u4ee5\u5728 DummyGame \u7c7b\u4e2d\uff0c\u5728\u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e\u65f6\uff0c\u4fee\u6539\u5982\u4e0b\u4ee3\u7801\uff1a // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e Vector3f prevPos = new Vector3f(camera.getPosition()); camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u68c0\u67e5\u662f\u5426\u53d1\u751f\u78b0\u649e\u3002\u5982\u679c\u4e3atrue\uff0c\u5c06y\u5750\u6807\u8bbe\u7f6e\u4e3a // \u6700\u5927\u9ad8\u5ea6 float height = terrain.getHeight(camera.getPosition()); if ( camera.getPosition().y <= height ) { camera.setPosition(prevPos.x, prevPos.y, prevPos.z); } \u5982\u4f60\u6240\u89c1\uff0c\u68c0\u6d4b\u5730\u5f62\u78b0\u649e\u7684\u6982\u5ff5\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ed4\u7ec6\u5730\u8fdb\u884c\u8ba1\u7b97\u5e76\u4e86\u89e3\u6b63\u5904\u7406\u7684\u4e0d\u540c\u5750\u6807\u7cfb\u3002 \u6b64\u5916\uff0c\u867d\u7136\u8fd9\u91cc\u7ed9\u51fa\u7684\u7b97\u6cd5\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u662f\u53ef\u7528\u7684\uff0c\u4f46\u4ecd\u5b58\u5728\u9700\u8981\u4ed4\u7ec6\u5904\u7406\u7684\u60c5\u51b5\u3002\u4f60\u53ef\u4ee5\u53d1\u73b0\u7684\u4e00\u4e2a\u95ee\u9898\u662f\u96a7\u9053\u6548\u5e94( Tunnelling )\u3002\u8bbe\u60f3\u4e00\u4e2a\u60c5\u51b5\uff0c\u6211\u4eec\u6b63\u4ee5\u9ad8\u901f\u7a7f\u8fc7\u5730\u5f62\uff0c\u6b63\u56e0\u5982\u6b64\uff0c\u4f4d\u7f6e\u589e\u91cf\u503c\u8f83\u9ad8\u3002\u8fd9\u4e2a\u503c\u53d8\u5f97\u5982\u6b64\u4e4b\u9ad8\uff0c\u4ee5\u81f3\u4e8e\u56e0\u4e3a\u6211\u4eec\u68c0\u6d4b\u7684\u662f\u6700\u7ec8\u4f4d\u7f6e\u7684\u78b0\u649e\uff0c\u6240\u4ee5\u53ef\u80fd\u5df2\u7ecf\u7a7f\u8fc7\u4e86\u4f4d\u4e8e\u4e24\u70b9\u4e4b\u95f4\u7684\u969c\u788d\u3002 \u6709\u8bb8\u591a\u53ef\u884c\u7684\u89e3\u51b3\u65b9\u6848\u53ef\u4ee5\u907f\u514d\u8fd9\u4e2a\u6548\u5e94\uff0c\u6700\u7b80\u5355\u7684\u89e3\u51b3\u65b9\u6cd5\u662f\u5c06\u8981\u8fdb\u884c\u7684\u8ba1\u7b97\u5206\u6210\u589e\u91cf\u8f83\u5c0f\u7684\u591a\u4efd\u3002","title":"\u5730\u5f62\u78b0\u649e\uff08Terrain Collisions\uff09"},{"location":"16-fog/","text":"\u96fe\uff08Fog\uff09 \u5728\u5904\u7406\u66f4\u590d\u6742\u7684\u95ee\u9898\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u521b\u5efa\u96fe\u7279\u6548\u3002\u6709\u4e86\u8fd9\u4e2a\u7279\u6548\uff0c\u5c31\u53ef\u4ee5\u6a21\u62df\u9065\u8fdc\u7684\u7269\u4f53\u53d8\u6697\uff0c\u4f3c\u4e4e\u6d88\u5931\u5728\u6d53\u96fe\u4e2d\u3002 \u8ba9\u6211\u4eec\u6765\u786e\u5b9a\u5b9a\u4e49\u96fe\u7684\u5c5e\u6027\u662f\u4ec0\u4e48\u3002\u7b2c\u4e00\u4e2a\u662f\u96fe\u7684\u989c\u8272\u3002\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\uff0c\u96fe\u662f\u7070\u8272\u7684\uff0c\u4f46\u6211\u4eec\u53ef\u4ee5\u5229\u7528\u8fd9\u4e2a\u7279\u6548\u6765\u6a21\u62df\u4e0d\u540c\u989c\u8272\u7684\u96fe\u8986\u76d6\u7684\u533a\u57df\u3002\u8fd8\u6709\u4e00\u4e2a\u5c5e\u6027\u662f\u96fe\u7684\u6d53\u5ea6\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u4f7f\u7528\u96fe\u7279\u6548\uff0c\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\uff0c\u5f533D\u573a\u666f\u7684\u7269\u4f53\u8fdc\u79bb\u6444\u50cf\u673a\u65f6\uff0c\u4f7f\u5b83\u4eec\u892a\u8272\u5230\u96fe\u7684\u989c\u8272\u3002\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4f46\u8fdc\u5904\u7684\u7269\u4f53\u5c06\u65e0\u6cd5\u5206\u8fa8\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4e00\u4e2a\u53c2\u6570\uff0c\u53ef\u4ee5\u7528\u6765\u6df7\u5408\u96fe\u7684\u989c\u8272\u4e0e\u6bcf\u4e2a\u7247\u5143\u7684\u989c\u8272\uff0c\u4ee5\u6a21\u62df\u96fe\u7279\u6548\u3002\u8fd9\u4e2a\u53c2\u6570\u53d6\u51b3\u4e8e\u4e0e\u6444\u50cf\u673a\u76f8\u8ddd\u7684\u8ddd\u79bb\u3002 \u8ba9\u6211\u4eec\u628a\u8fd9\u4e2a\u53c2\u6570\u547d\u540d\u4e3a fogFactor \uff0c\u5e76\u8bbe\u5b9a\u5b83\u7684\u8303\u56f4\u4e3a0\u52301\u3002\u5f53 fogFactor \u4e3a1\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u662f\u8f83\u8fd1\u7684\u7269\u4f53\u3002\u5f53 fogFactor \u4e3a0\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u9690\u85cf\u5728\u96fe\u4e2d\u3002 \u7136\u540e\uff0c\u8ba1\u7b97\u96fe\u8272\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a finalColour = (1 - fogFactor) \\cdot fogColour + fogFactor \\cdot framentColour finalColour \u662f\u4f7f\u7528\u96fe\u7279\u6548\u7684\u6700\u7ec8\u989c\u8272\u3002 fogFactor \u662f\u63a7\u5236\u96fe\u7684\u989c\u8272\u4e0e\u7247\u5143\u7684\u989c\u8272\u5982\u4f55\u6df7\u5408\u7684\u53c2\u6570\uff0c\u5b83\u57fa\u672c\u4e0a\u63a7\u5236\u7269\u4f53\u7684\u53ef\u89c1\u6027\u3002 fogColour \u662f\u96fe\u7684\u989c\u8272\u3002 fragmentColour \u6ca1\u6709\u4f7f\u7528\u96fe\u7279\u6548\u7684\u7247\u5143\u989c\u8272\u3002 \u73b0\u5728\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\u6765\u57fa\u4e8e\u8ddd\u79bb\u8ba1\u7b97 fogFactor \u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4e0d\u540c\u7684\u6a21\u578b\uff0c\u9996\u5148\u4f7f\u7528\u7ebf\u6027\u6a21\u578b\u3002\u8fd9\u662f\u4e00\u4e2a\u7ed9\u5b9a\u8ddd\u79bb\u4ee5\u7ebf\u6027\u65b9\u5f0f\u6539\u53d8 fogFactor \u7684\u6a21\u578b\u3002 \u7ebf\u6027\u6a21\u578b\u7531\u4ee5\u4e0b\u53c2\u6570\u5b9a\u4e49\uff1a fogStart : \u5f00\u59cb\u4f7f\u7528\u96fe\u7279\u6548\u7684\u8ddd\u79bb\u3002 fogFinish : \u96fe\u7279\u6548\u8fbe\u5230\u6700\u5927\u503c\u7684\u8ddd\u79bb\u3002 distance : \u5230\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u3002 \u6709\u4e86\u8fd9\u4e9b\u53c2\u6570\uff0c\u65b9\u7a0b\u5c31\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\displaystyle fogFactor = \\frac{(fogFinish - distance)}{(fogFinish - fogStart)} \u5bf9\u4e8e\u8ddd\u79bb\u4f4e\u4e8e fogStart \u7684\u7269\u4f53\u6211\u4eec\u7b80\u5355\u5730\u8bbe\u7f6e fogFactor \u4e3a 1 \u3002\u4e0b\u56fe\u8868\u660e\u4e86 fogFactor \u662f\u5982\u4f55\u968f\u7740\u8ddd\u79bb\u53d8\u5316\u800c\u53d8\u5316\u7684\u3002 \u7ebf\u6027\u6a21\u578b\u6613\u4e8e\u8ba1\u7b97\uff0c\u4f46\u4e0d\u592a\u771f\u5b9e\uff0c\u56e0\u4e3a\u5b83\u4e0d\u8003\u8651\u96fe\u6c14\u6d53\u5ea6\u3002\u5b9e\u9645\u4e0a\u96fe\u5f80\u5f80\u4ee5\u66f4\u5e73\u6ed1\u7684\u65b9\u5f0f\u589e\u52a0\u3002\u6240\u4ee5\u4e0b\u4e00\u4e2a\u5408\u9002\u7684\u6a21\u578b\u662f\u6307\u6570\u6a21\u578b\u3002\u8be5\u6a21\u578b\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a \\displaystyle focFactor = e^{-(distance \\cdot fogDensity)^{exponent}} = \\frac{1}{e^{(distance \\cdot fogDensity)^{exponent}}} \u5176\u4e2d\u7684\u65b0\u53d8\u91cf\u5982\u4e0b\u6240\u8ff0\uff1a fogDensity \u662f\u96fe\u7684\u539a\u5ea6\u6216\u6d53\u5ea6\u3002 exponent \u7528\u6765\u63a7\u5236\u96fe\u968f\u7740\u8ddd\u79bb\u7684\u589e\u52a0\u589e\u957f\u7684\u901f\u5ea6\u3002 \u4e0b\u56fe\u663e\u793a\u4e86\u4e24\u4e2a\u56fe\u5f62\uff0c\u5206\u522b\u8bbe\u7f6e\u4e86\u4e0d\u540c\u7684 exponent \u503c\uff08\u84dd\u7ebf\u4e3a 2 \uff0c\u7ea2\u7ebf\u4e3a 4 \uff09\u3002 \u5728\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a\u516c\u5f0f\uff0c\u8ba9\u5b83\u53ef\u4ee5\u4e3a exponent \u8bbe\u7f6e\u4e0d\u540c\u7684\u503c\uff08\u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u4fee\u6539\u793a\u4f8b\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u503c\uff09\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u8fc7\u8fd9\u4e2a\u539f\u7406\u4e86\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u5b83\u3002\u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b9e\u73b0\u96fe\u7279\u6548\uff0c\u56e0\u4e3a\u8fd9\u6709\u6211\u4eec\u9700\u8981\u7684\u6240\u6709\u53d8\u91cf\u3002\u6211\u4eec\u5c06\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u96fe\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u3002 struct Fog { int active; vec3 colour; float density; }; active \u5c5e\u6027\u7528\u4e8e\u6fc0\u6d3b\u6216\u5173\u95ed\u96fe\u7279\u6548\u3002\u96fe\u5c5e\u6027\u5c06\u901a\u8fc7\u53e6\u4e00\u4e2a\u88ab\u79f0\u4f5c fog \u7684Uniform\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002 uniform Fog fog; \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u7740\u96fe\u5c5e\u6027\u7684\u540d\u4e3a Fog \u7684\u65b0\u7c7b\uff0c\u5b83\u662f\u53e6\u4e00\u4e2aPOJO\uff08Plain Ordinary Java Object\uff0c\u7b80\u5355\u7684Java\u5bf9\u8c61\uff09\u3002 package org.lwjglb.engine.graph.weather; import org.joml.Vector3f; public class Fog { private boolean active; private Vector3f colour; private float density; public static Fog NOFOG = new Fog(); public Fog() { active = false; this.colour = new Vector3f(0, 0, 0); this.density = 0; } public Fog(boolean active, Vector3f colour, float density) { this.colour = colour; this.density = density; this.active = active; } // Getters and setters here\u2026. \u6211\u4eec\u5c06\u5728 Scene \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a Fog \u793a\u4f8b\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c Scene \u7c7b\u5c06\u521d\u59cb\u5316\u4e00\u4e2a Fog \u793a\u4f8b\u5230\u5e38\u91cf NOFOG \uff0c\u7528\u4e8e\u6a21\u62df\u5173\u95ed\u96fe\u7279\u6548\u7684\u60c5\u51b5\u3002 \u56e0\u4e3a\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684Uniform\u7c7b\u578b\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539 ShaderProgram \u7c7b\u6765\u521b\u5efa\u548c\u521d\u59cb\u5316\u96fe\u7684Uniform\u3002 public void createFogUniform(String uniformName) throws Exception { createUniform(uniformName + \".active\"); createUniform(uniformName + \".colour\"); createUniform(uniformName + \".density\"); } public void setUniform(String uniformName, Fog fog) { setUniform(uniformName + \".activeFog\", fog.isActive() ? 1 : 0); setUniform(uniformName + \".colour\", fog.getColour() ); setUniform(uniformName + \".density\", fog.getDensity()); } \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 setupSceneShader \u65b9\u6cd5\u4e2d\u521b\u5efaUniform\uff1a sceneShaderProgram.createFogUniform(\"fog\"); \u7136\u540e\u5728 renderScene \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff1a sceneShaderProgram.setUniform(\"fog\", scene.getFog()); \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5728\u6e38\u620f\u4e2d\u5b9a\u4e49\u96fe\u7279\u6548\uff0c\u4f46\u662f\u9700\u8981\u56de\u5230\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u96fe\u7279\u6548\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcFog \u7684\u51fd\u6570\uff0c\u51fd\u6570\u5b9a\u4e49\u5982\u4e0b\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog) { float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fog.colour, colour.xyz, fogFactor); return vec4(resultColour.xyz, colour.w); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5230\u9876\u70b9\u7684\u8ddd\u79bb\u3002\u9876\u70b9\u5750\u6807\u5b9a\u4e49\u5728 pos \u53d8\u91cf\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u957f\u5ea6\u3002\u7136\u540e\u5229\u7528 exponent \u4e3a2\u7684\u6307\u6570\u6a21\u578b\uff08\u76f8\u5f53\u4e8e\u4e58\u4ee5\u4e24\u6b21\uff09\u8ba1\u7b97\u96fe\u53c2\u6570\u3002\u6211\u4eec\u5f97\u5230\u7684 fogFactor \u7684\u8303\u56f4\u5728 0 \u5230 1 \u4e4b\u95f4\uff0c\u5e76\u4f7f\u7528 mix \u51fd\u6570\u3002\u5728GLSL\u4e2d\uff0c min \u51fd\u6570\u88ab\u7528\u4e8e\u6df7\u5408\u96fe\u8272\u548c\u56fe\u5143\u989c\u8272\uff08\u7531\u989c\u8272\u53d8\u91cf\u5b9a\u4e49\uff09\u3002\u76f8\u5f53\u4e8e\u4f7f\u7528\u5982\u4e0b\u65b9\u7a0b\uff1a resultColour = (1 - fogFactor) \\cdot fog.colour + fogFactor \\cdot colour \u6211\u4eec\u8fd8\u4e3a\u989c\u8272\u4fdd\u7559\u4e86 w \u5143\u7d20\uff0c\u5373\u900f\u660e\u5ea6\u3002\u6211\u4eec\u4e0d\u5e0c\u671b\u8fd9\u4e2a\u5143\u7d20\u53d7\u5230\u5f71\u54cd\uff0c\u7247\u5143\u5e94\u8be5\u4fdd\u6301\u5b83\u7684\u900f\u660e\u7a0b\u5ea6\u4e0d\u53d8\u3002 \u5728\u5e94\u7528\u4e86\u6240\u6709\u7684\u5149\u6548\u4e4b\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u6700\u540e\uff0c\u5982\u679c\u96fe\u7279\u6548\u542f\u7528\u7684\u8bdd\uff0c\u6211\u4eec\u5c06\u7b80\u5355\u5730\u628a\u8fd4\u56de\u503c\u8bbe\u7f6e\u4e3a\u7247\u5143\u989c\u8272\u3002 if ( fog.activeFog == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog); } \u6240\u6709\u8fd9\u4e9b\u4ee3\u7801\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u6570\u636e\u8bbe\u7f6e\u4e00\u4e2a\u96fe\u7279\u6548\uff1a scene.setFog(new Fog(true, new Vector3f(0.5f, 0.5f, 0.5f), 0.15f)); \u7136\u540e\u6211\u4eec\u5c06\u83b7\u5f97\u50cf\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f60\u4f1a\u770b\u5230\u8fdc\u5904\u7684\u7269\u4f53\u892a\u8272\uff0c\u5f53\u4f60\u9760\u8fd1\u5b83\u4eec\u65f6\uff0c\u96fe\u5f00\u59cb\u6d88\u5931\u3002\u4f46\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u5730\u5e73\u7ebf\u4e0d\u53d7\u96fe\u7684\u5f71\u54cd\u3002\u6709\u51e0\u79cd\u65b9\u6cd5\u53ef\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1a \u4f7f\u7528\u53ea\u80fd\u770b\u5230\u5929\u7a7a\u7684\u53e6\u4e00\u4e2a\u4e0d\u540c\u7684\u5929\u7a7a\u76d2\u3002 \u5220\u9664\u5929\u7a7a\u76d2\uff0c\u56e0\u4e3a\u6709\u6d53\u96fe\uff0c\u4f60\u4e0d\u5e94\u8be5\u80fd\u591f\u770b\u5230\u4e00\u4e2a\u80cc\u666f\u3002 \u4e5f\u53ef\u80fd\u8fd9\u4e24\u4e2a\u89e3\u51b3\u65b9\u6848\u6ca1\u6709\u9002\u5408\u4f60\u7684\uff0c\u4f60\u53ef\u4ee5\u8bd5\u7740\u5c06\u96fe\u8272\u4e0e\u5929\u7a7a\u76d2\u7684\u80cc\u666f\u76f8\u5339\u914d\uff0c\u4f46\u8fd9\u6837\u4f60\u4f1a\u505a\u590d\u6742\u7684\u8ba1\u7b97\uff0c\u7ed3\u679c\u4e5f\u8bb8\u4e0d\u4f1a\u66f4\u597d\u3002 \u5982\u679c\u4f60\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u611f\u5230\u5e73\u884c\u5149\u53d8\u5f97\u6697\u6de1\uff0c\u573a\u666f\u53d8\u6697\uff0c\u4f46\u96fe\u770b\u8d77\u6765\u6709\u95ee\u9898\uff0c\u56e0\u4e3a\u5b83\u4e0d\u53d7\u5149\u7684\u5f71\u54cd\uff0c\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u8fdc\u5904\u7684\u7269\u4f53\u53d8\u4e3a\u96fe\u8272\uff0c\u8fd9\u662f\u4e00\u4e2a\u4e0d\u53d7\u5149\u5f71\u54cd\u7684\u5e38\u6570\u3002\u8fd9\u9020\u6210\u4e86\u4e00\u4e2a\u5728\u9ed1\u6697\u4e2d\u53d1\u5149\u7684\u6548\u679c\uff08\u8fd9\u53ef\u80fd\u5e76\u4e0d\u597d\uff09\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u8ba1\u7b97\u96fe\u7684\u51fd\u6570\uff0c\u8ba9\u5176\u8003\u8651\u5149\u7167\u3002\u8be5\u51fd\u6570\u5c06\u63a5\u6536\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8c03\u6574\u96fe\u8272\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog, vec3 ambientLight, DirectionalLight dirLight) { vec3 fogColor = fog.colour * (ambientLight + dirLight.colour * dirLight.intensity); float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fogColor, colour.xyz, fogFactor); return vec4(resultColour.xyz, 1); } \u5982\u4f60\u6240\u89c1\uff0c\u5e73\u884c\u5149\u6211\u4eec\u4ec5\u4f7f\u7528\u4e86\u989c\u8272\u548c\u5f3a\u5ea6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5173\u6ce8\u5b83\u7684\u65b9\u5411\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u51fd\u6570\u7684\u8c03\u7528\uff1a if ( fog.active == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog, ambientLight, directionalLight); } \u5728\u591c\u665a\u65f6\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u6548\u679c\u3002 \u4e00\u4e2a\u8981\u5f3a\u8c03\u7684\u91cd\u8981\u7684\u4e8b\u60c5\u662f\uff0c\u6211\u4eec\u5fc5\u987b\u806a\u660e\u5730\u9009\u62e9\u96fe\u8272\u3002\u8fd9\u662f\u5f88\u91cd\u8981\u7684\uff0c\u5f53\u6211\u4eec\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f46\u6709\u56fa\u5b9a\u7684\u989c\u8272\u80cc\u666f\uff0c\u5e94\u8be5\u628a\u96fe\u8272\u8bbe\u7f6e\u4e3a\u80cc\u666f\u8272\u3002\u5982\u679c\u4f60\u5220\u9664\u4e86\u5929\u7a7a\u76d2\u7684\u4ee3\u7801\u5e76\u91cd\u65b0\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\u3002 \u4f46\u5982\u679c\u6211\u4eec\u628a\u80cc\u666f\u8272\u4fee\u6539\u4e3a\uff080.5, 0.5, 0.5\uff09\uff0c\u6700\u7ec8\u7ed3\u679c\u770b\u8d77\u6765\u5c31\u662f\u5982\u4e0b\u6240\u793a\u3002","title":"\u96fe"},{"location":"16-fog/#fog","text":"\u5728\u5904\u7406\u66f4\u590d\u6742\u7684\u95ee\u9898\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u521b\u5efa\u96fe\u7279\u6548\u3002\u6709\u4e86\u8fd9\u4e2a\u7279\u6548\uff0c\u5c31\u53ef\u4ee5\u6a21\u62df\u9065\u8fdc\u7684\u7269\u4f53\u53d8\u6697\uff0c\u4f3c\u4e4e\u6d88\u5931\u5728\u6d53\u96fe\u4e2d\u3002 \u8ba9\u6211\u4eec\u6765\u786e\u5b9a\u5b9a\u4e49\u96fe\u7684\u5c5e\u6027\u662f\u4ec0\u4e48\u3002\u7b2c\u4e00\u4e2a\u662f\u96fe\u7684\u989c\u8272\u3002\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\uff0c\u96fe\u662f\u7070\u8272\u7684\uff0c\u4f46\u6211\u4eec\u53ef\u4ee5\u5229\u7528\u8fd9\u4e2a\u7279\u6548\u6765\u6a21\u62df\u4e0d\u540c\u989c\u8272\u7684\u96fe\u8986\u76d6\u7684\u533a\u57df\u3002\u8fd8\u6709\u4e00\u4e2a\u5c5e\u6027\u662f\u96fe\u7684\u6d53\u5ea6\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u4f7f\u7528\u96fe\u7279\u6548\uff0c\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\uff0c\u5f533D\u573a\u666f\u7684\u7269\u4f53\u8fdc\u79bb\u6444\u50cf\u673a\u65f6\uff0c\u4f7f\u5b83\u4eec\u892a\u8272\u5230\u96fe\u7684\u989c\u8272\u3002\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4f46\u8fdc\u5904\u7684\u7269\u4f53\u5c06\u65e0\u6cd5\u5206\u8fa8\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4e00\u4e2a\u53c2\u6570\uff0c\u53ef\u4ee5\u7528\u6765\u6df7\u5408\u96fe\u7684\u989c\u8272\u4e0e\u6bcf\u4e2a\u7247\u5143\u7684\u989c\u8272\uff0c\u4ee5\u6a21\u62df\u96fe\u7279\u6548\u3002\u8fd9\u4e2a\u53c2\u6570\u53d6\u51b3\u4e8e\u4e0e\u6444\u50cf\u673a\u76f8\u8ddd\u7684\u8ddd\u79bb\u3002 \u8ba9\u6211\u4eec\u628a\u8fd9\u4e2a\u53c2\u6570\u547d\u540d\u4e3a fogFactor \uff0c\u5e76\u8bbe\u5b9a\u5b83\u7684\u8303\u56f4\u4e3a0\u52301\u3002\u5f53 fogFactor \u4e3a1\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u662f\u8f83\u8fd1\u7684\u7269\u4f53\u3002\u5f53 fogFactor \u4e3a0\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u9690\u85cf\u5728\u96fe\u4e2d\u3002 \u7136\u540e\uff0c\u8ba1\u7b97\u96fe\u8272\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a finalColour = (1 - fogFactor) \\cdot fogColour + fogFactor \\cdot framentColour finalColour \u662f\u4f7f\u7528\u96fe\u7279\u6548\u7684\u6700\u7ec8\u989c\u8272\u3002 fogFactor \u662f\u63a7\u5236\u96fe\u7684\u989c\u8272\u4e0e\u7247\u5143\u7684\u989c\u8272\u5982\u4f55\u6df7\u5408\u7684\u53c2\u6570\uff0c\u5b83\u57fa\u672c\u4e0a\u63a7\u5236\u7269\u4f53\u7684\u53ef\u89c1\u6027\u3002 fogColour \u662f\u96fe\u7684\u989c\u8272\u3002 fragmentColour \u6ca1\u6709\u4f7f\u7528\u96fe\u7279\u6548\u7684\u7247\u5143\u989c\u8272\u3002 \u73b0\u5728\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\u6765\u57fa\u4e8e\u8ddd\u79bb\u8ba1\u7b97 fogFactor \u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4e0d\u540c\u7684\u6a21\u578b\uff0c\u9996\u5148\u4f7f\u7528\u7ebf\u6027\u6a21\u578b\u3002\u8fd9\u662f\u4e00\u4e2a\u7ed9\u5b9a\u8ddd\u79bb\u4ee5\u7ebf\u6027\u65b9\u5f0f\u6539\u53d8 fogFactor \u7684\u6a21\u578b\u3002 \u7ebf\u6027\u6a21\u578b\u7531\u4ee5\u4e0b\u53c2\u6570\u5b9a\u4e49\uff1a fogStart : \u5f00\u59cb\u4f7f\u7528\u96fe\u7279\u6548\u7684\u8ddd\u79bb\u3002 fogFinish : \u96fe\u7279\u6548\u8fbe\u5230\u6700\u5927\u503c\u7684\u8ddd\u79bb\u3002 distance : \u5230\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u3002 \u6709\u4e86\u8fd9\u4e9b\u53c2\u6570\uff0c\u65b9\u7a0b\u5c31\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\displaystyle fogFactor = \\frac{(fogFinish - distance)}{(fogFinish - fogStart)} \u5bf9\u4e8e\u8ddd\u79bb\u4f4e\u4e8e fogStart \u7684\u7269\u4f53\u6211\u4eec\u7b80\u5355\u5730\u8bbe\u7f6e fogFactor \u4e3a 1 \u3002\u4e0b\u56fe\u8868\u660e\u4e86 fogFactor \u662f\u5982\u4f55\u968f\u7740\u8ddd\u79bb\u53d8\u5316\u800c\u53d8\u5316\u7684\u3002 \u7ebf\u6027\u6a21\u578b\u6613\u4e8e\u8ba1\u7b97\uff0c\u4f46\u4e0d\u592a\u771f\u5b9e\uff0c\u56e0\u4e3a\u5b83\u4e0d\u8003\u8651\u96fe\u6c14\u6d53\u5ea6\u3002\u5b9e\u9645\u4e0a\u96fe\u5f80\u5f80\u4ee5\u66f4\u5e73\u6ed1\u7684\u65b9\u5f0f\u589e\u52a0\u3002\u6240\u4ee5\u4e0b\u4e00\u4e2a\u5408\u9002\u7684\u6a21\u578b\u662f\u6307\u6570\u6a21\u578b\u3002\u8be5\u6a21\u578b\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a \\displaystyle focFactor = e^{-(distance \\cdot fogDensity)^{exponent}} = \\frac{1}{e^{(distance \\cdot fogDensity)^{exponent}}} \u5176\u4e2d\u7684\u65b0\u53d8\u91cf\u5982\u4e0b\u6240\u8ff0\uff1a fogDensity \u662f\u96fe\u7684\u539a\u5ea6\u6216\u6d53\u5ea6\u3002 exponent \u7528\u6765\u63a7\u5236\u96fe\u968f\u7740\u8ddd\u79bb\u7684\u589e\u52a0\u589e\u957f\u7684\u901f\u5ea6\u3002 \u4e0b\u56fe\u663e\u793a\u4e86\u4e24\u4e2a\u56fe\u5f62\uff0c\u5206\u522b\u8bbe\u7f6e\u4e86\u4e0d\u540c\u7684 exponent \u503c\uff08\u84dd\u7ebf\u4e3a 2 \uff0c\u7ea2\u7ebf\u4e3a 4 \uff09\u3002 \u5728\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a\u516c\u5f0f\uff0c\u8ba9\u5b83\u53ef\u4ee5\u4e3a exponent \u8bbe\u7f6e\u4e0d\u540c\u7684\u503c\uff08\u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u4fee\u6539\u793a\u4f8b\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u503c\uff09\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u8fc7\u8fd9\u4e2a\u539f\u7406\u4e86\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u5b83\u3002\u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b9e\u73b0\u96fe\u7279\u6548\uff0c\u56e0\u4e3a\u8fd9\u6709\u6211\u4eec\u9700\u8981\u7684\u6240\u6709\u53d8\u91cf\u3002\u6211\u4eec\u5c06\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u96fe\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u3002 struct Fog { int active; vec3 colour; float density; }; active \u5c5e\u6027\u7528\u4e8e\u6fc0\u6d3b\u6216\u5173\u95ed\u96fe\u7279\u6548\u3002\u96fe\u5c5e\u6027\u5c06\u901a\u8fc7\u53e6\u4e00\u4e2a\u88ab\u79f0\u4f5c fog \u7684Uniform\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002 uniform Fog fog; \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u7740\u96fe\u5c5e\u6027\u7684\u540d\u4e3a Fog \u7684\u65b0\u7c7b\uff0c\u5b83\u662f\u53e6\u4e00\u4e2aPOJO\uff08Plain Ordinary Java Object\uff0c\u7b80\u5355\u7684Java\u5bf9\u8c61\uff09\u3002 package org.lwjglb.engine.graph.weather; import org.joml.Vector3f; public class Fog { private boolean active; private Vector3f colour; private float density; public static Fog NOFOG = new Fog(); public Fog() { active = false; this.colour = new Vector3f(0, 0, 0); this.density = 0; } public Fog(boolean active, Vector3f colour, float density) { this.colour = colour; this.density = density; this.active = active; } // Getters and setters here\u2026. \u6211\u4eec\u5c06\u5728 Scene \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a Fog \u793a\u4f8b\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c Scene \u7c7b\u5c06\u521d\u59cb\u5316\u4e00\u4e2a Fog \u793a\u4f8b\u5230\u5e38\u91cf NOFOG \uff0c\u7528\u4e8e\u6a21\u62df\u5173\u95ed\u96fe\u7279\u6548\u7684\u60c5\u51b5\u3002 \u56e0\u4e3a\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684Uniform\u7c7b\u578b\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539 ShaderProgram \u7c7b\u6765\u521b\u5efa\u548c\u521d\u59cb\u5316\u96fe\u7684Uniform\u3002 public void createFogUniform(String uniformName) throws Exception { createUniform(uniformName + \".active\"); createUniform(uniformName + \".colour\"); createUniform(uniformName + \".density\"); } public void setUniform(String uniformName, Fog fog) { setUniform(uniformName + \".activeFog\", fog.isActive() ? 1 : 0); setUniform(uniformName + \".colour\", fog.getColour() ); setUniform(uniformName + \".density\", fog.getDensity()); } \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 setupSceneShader \u65b9\u6cd5\u4e2d\u521b\u5efaUniform\uff1a sceneShaderProgram.createFogUniform(\"fog\"); \u7136\u540e\u5728 renderScene \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff1a sceneShaderProgram.setUniform(\"fog\", scene.getFog()); \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5728\u6e38\u620f\u4e2d\u5b9a\u4e49\u96fe\u7279\u6548\uff0c\u4f46\u662f\u9700\u8981\u56de\u5230\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u96fe\u7279\u6548\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcFog \u7684\u51fd\u6570\uff0c\u51fd\u6570\u5b9a\u4e49\u5982\u4e0b\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog) { float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fog.colour, colour.xyz, fogFactor); return vec4(resultColour.xyz, colour.w); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5230\u9876\u70b9\u7684\u8ddd\u79bb\u3002\u9876\u70b9\u5750\u6807\u5b9a\u4e49\u5728 pos \u53d8\u91cf\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u957f\u5ea6\u3002\u7136\u540e\u5229\u7528 exponent \u4e3a2\u7684\u6307\u6570\u6a21\u578b\uff08\u76f8\u5f53\u4e8e\u4e58\u4ee5\u4e24\u6b21\uff09\u8ba1\u7b97\u96fe\u53c2\u6570\u3002\u6211\u4eec\u5f97\u5230\u7684 fogFactor \u7684\u8303\u56f4\u5728 0 \u5230 1 \u4e4b\u95f4\uff0c\u5e76\u4f7f\u7528 mix \u51fd\u6570\u3002\u5728GLSL\u4e2d\uff0c min \u51fd\u6570\u88ab\u7528\u4e8e\u6df7\u5408\u96fe\u8272\u548c\u56fe\u5143\u989c\u8272\uff08\u7531\u989c\u8272\u53d8\u91cf\u5b9a\u4e49\uff09\u3002\u76f8\u5f53\u4e8e\u4f7f\u7528\u5982\u4e0b\u65b9\u7a0b\uff1a resultColour = (1 - fogFactor) \\cdot fog.colour + fogFactor \\cdot colour \u6211\u4eec\u8fd8\u4e3a\u989c\u8272\u4fdd\u7559\u4e86 w \u5143\u7d20\uff0c\u5373\u900f\u660e\u5ea6\u3002\u6211\u4eec\u4e0d\u5e0c\u671b\u8fd9\u4e2a\u5143\u7d20\u53d7\u5230\u5f71\u54cd\uff0c\u7247\u5143\u5e94\u8be5\u4fdd\u6301\u5b83\u7684\u900f\u660e\u7a0b\u5ea6\u4e0d\u53d8\u3002 \u5728\u5e94\u7528\u4e86\u6240\u6709\u7684\u5149\u6548\u4e4b\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u6700\u540e\uff0c\u5982\u679c\u96fe\u7279\u6548\u542f\u7528\u7684\u8bdd\uff0c\u6211\u4eec\u5c06\u7b80\u5355\u5730\u628a\u8fd4\u56de\u503c\u8bbe\u7f6e\u4e3a\u7247\u5143\u989c\u8272\u3002 if ( fog.activeFog == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog); } \u6240\u6709\u8fd9\u4e9b\u4ee3\u7801\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u6570\u636e\u8bbe\u7f6e\u4e00\u4e2a\u96fe\u7279\u6548\uff1a scene.setFog(new Fog(true, new Vector3f(0.5f, 0.5f, 0.5f), 0.15f)); \u7136\u540e\u6211\u4eec\u5c06\u83b7\u5f97\u50cf\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f60\u4f1a\u770b\u5230\u8fdc\u5904\u7684\u7269\u4f53\u892a\u8272\uff0c\u5f53\u4f60\u9760\u8fd1\u5b83\u4eec\u65f6\uff0c\u96fe\u5f00\u59cb\u6d88\u5931\u3002\u4f46\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u5730\u5e73\u7ebf\u4e0d\u53d7\u96fe\u7684\u5f71\u54cd\u3002\u6709\u51e0\u79cd\u65b9\u6cd5\u53ef\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1a \u4f7f\u7528\u53ea\u80fd\u770b\u5230\u5929\u7a7a\u7684\u53e6\u4e00\u4e2a\u4e0d\u540c\u7684\u5929\u7a7a\u76d2\u3002 \u5220\u9664\u5929\u7a7a\u76d2\uff0c\u56e0\u4e3a\u6709\u6d53\u96fe\uff0c\u4f60\u4e0d\u5e94\u8be5\u80fd\u591f\u770b\u5230\u4e00\u4e2a\u80cc\u666f\u3002 \u4e5f\u53ef\u80fd\u8fd9\u4e24\u4e2a\u89e3\u51b3\u65b9\u6848\u6ca1\u6709\u9002\u5408\u4f60\u7684\uff0c\u4f60\u53ef\u4ee5\u8bd5\u7740\u5c06\u96fe\u8272\u4e0e\u5929\u7a7a\u76d2\u7684\u80cc\u666f\u76f8\u5339\u914d\uff0c\u4f46\u8fd9\u6837\u4f60\u4f1a\u505a\u590d\u6742\u7684\u8ba1\u7b97\uff0c\u7ed3\u679c\u4e5f\u8bb8\u4e0d\u4f1a\u66f4\u597d\u3002 \u5982\u679c\u4f60\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u611f\u5230\u5e73\u884c\u5149\u53d8\u5f97\u6697\u6de1\uff0c\u573a\u666f\u53d8\u6697\uff0c\u4f46\u96fe\u770b\u8d77\u6765\u6709\u95ee\u9898\uff0c\u56e0\u4e3a\u5b83\u4e0d\u53d7\u5149\u7684\u5f71\u54cd\uff0c\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u8fdc\u5904\u7684\u7269\u4f53\u53d8\u4e3a\u96fe\u8272\uff0c\u8fd9\u662f\u4e00\u4e2a\u4e0d\u53d7\u5149\u5f71\u54cd\u7684\u5e38\u6570\u3002\u8fd9\u9020\u6210\u4e86\u4e00\u4e2a\u5728\u9ed1\u6697\u4e2d\u53d1\u5149\u7684\u6548\u679c\uff08\u8fd9\u53ef\u80fd\u5e76\u4e0d\u597d\uff09\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u8ba1\u7b97\u96fe\u7684\u51fd\u6570\uff0c\u8ba9\u5176\u8003\u8651\u5149\u7167\u3002\u8be5\u51fd\u6570\u5c06\u63a5\u6536\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8c03\u6574\u96fe\u8272\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog, vec3 ambientLight, DirectionalLight dirLight) { vec3 fogColor = fog.colour * (ambientLight + dirLight.colour * dirLight.intensity); float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fogColor, colour.xyz, fogFactor); return vec4(resultColour.xyz, 1); } \u5982\u4f60\u6240\u89c1\uff0c\u5e73\u884c\u5149\u6211\u4eec\u4ec5\u4f7f\u7528\u4e86\u989c\u8272\u548c\u5f3a\u5ea6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5173\u6ce8\u5b83\u7684\u65b9\u5411\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u51fd\u6570\u7684\u8c03\u7528\uff1a if ( fog.active == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog, ambientLight, directionalLight); } \u5728\u591c\u665a\u65f6\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u6548\u679c\u3002 \u4e00\u4e2a\u8981\u5f3a\u8c03\u7684\u91cd\u8981\u7684\u4e8b\u60c5\u662f\uff0c\u6211\u4eec\u5fc5\u987b\u806a\u660e\u5730\u9009\u62e9\u96fe\u8272\u3002\u8fd9\u662f\u5f88\u91cd\u8981\u7684\uff0c\u5f53\u6211\u4eec\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f46\u6709\u56fa\u5b9a\u7684\u989c\u8272\u80cc\u666f\uff0c\u5e94\u8be5\u628a\u96fe\u8272\u8bbe\u7f6e\u4e3a\u80cc\u666f\u8272\u3002\u5982\u679c\u4f60\u5220\u9664\u4e86\u5929\u7a7a\u76d2\u7684\u4ee3\u7801\u5e76\u91cd\u65b0\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\u3002 \u4f46\u5982\u679c\u6211\u4eec\u628a\u80cc\u666f\u8272\u4fee\u6539\u4e3a\uff080.5, 0.5, 0.5\uff09\uff0c\u6700\u7ec8\u7ed3\u679c\u770b\u8d77\u6765\u5c31\u662f\u5982\u4e0b\u6240\u793a\u3002","title":"\u96fe\uff08Fog\uff09"},{"location":"17-normal-mapping/","text":"\u6cd5\u7ebf\u8d34\u56fe\uff08Normal Mapping\uff09 \u672c\u7ae0\u4e2d\u5c06\u8bb2\u89e3\u4e00\u9879\u6280\u672f\uff0c\u5b83\u5c06\u6781\u5927\u5730\u6539\u5584\u6211\u4eec\u76843D\u6a21\u578b\u7684\u5916\u89c2\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u80fd\u591f\u5c06\u7eb9\u7406\u4f7f\u7528\u5230\u590d\u6742\u76843D\u6a21\u578b\u4e0a\uff0c\u4f46\u8fd9\u8fd8\u79bb\u771f\u5b9e\u7269\u4f53\u7684\u6837\u5b50\u5f88\u8fdc\u3002\u73b0\u5b9e\u4e16\u754c\u4e2d\u7684\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u5149\u6ed1\u7684\uff0c\u5b83\u4eec\u6709\u6211\u4eec\u76843D\u6a21\u578b\u76ee\u524d\u6240\u4e0d\u5177\u6709\u7684\u7455\u75b5\u3002 \u4e3a\u4e86\u6e32\u67d3\u66f4\u771f\u5b9e\u7684\u573a\u666f\uff0c\u6211\u4eec\u5c06\u6e32\u67d3 \u6cd5\u7ebf\u8d34\u56fe(Normal Mapping) \u3002\u5982\u679c\u4f60\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\u770b\u5230\u4e00\u4e2a\u5e73\u9762\uff0c\u4f60\u4f1a\u53d1\u73b0\u90a3\u4e9b\u7455\u75b5\u751a\u81f3\u53ef\u4ee5\u5728\u5f88\u8fdc\u7684\u8ddd\u79bb\u770b\u5230\u3002\u57283D\u573a\u666f\u4e2d\uff0c\u5e73\u9762\u6ca1\u6709\u7455\u75b5\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u7eb9\u7406\u5e94\u7528\u5728\u5b83\u4e4b\u4e0a\uff0c\u4f46\u8fd9\u4e0d\u4f1a\u6539\u53d8\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0e\u73b0\u5b9e\u6709\u533a\u522b\u7684\u539f\u56e0\u3002 \u6211\u4eec\u53ef\u4ee5\u8003\u8651\u901a\u8fc7\u589e\u52a0\u4e09\u89d2\u5f62\u6570\u91cf\u6765\u589e\u52a0\u6a21\u578b\u7684\u7ec6\u8282\u5e76\u53cd\u6620\u51fa\u8fd9\u4e9b\u7455\u75b5\uff0c\u4f46\u6027\u80fd\u4f1a\u4e0b\u964d\u3002\u6211\u4eec\u9700\u8981\u7684\u662f\u6539\u53d8\u8868\u9762\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u6765\u589e\u52a0\u771f\u5b9e\u611f\u3002\u8fd9\u5c31\u662f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6280\u672f\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u5149\u6ed1\u5e73\u9762\u7684\u4f8b\u5b50\uff0c\u4e00\u4e2a\u5e73\u9762\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u4e3a\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002\u56de\u5fc6\u4e4b\u524d\u7684\u5149\u7167\u7ae0\u8282\uff0c\u6a21\u578b\u7684\u5149\u53cd\u5c04\u7684\u8981\u7d20\u662f\u5e73\u9762\u6cd5\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u6574\u4e2a\u5e73\u9762\u4ec5\u6709\u5355\u4e00\u7684\u6cd5\u7ebf\uff0c\u5f53\u8ba1\u7b97\u5149\u5982\u4f55\u5f71\u54cd\u7247\u5143\u65f6\uff0c\u6bcf\u4e2a\u7247\u5143\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u6cd5\u7ebf\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u5982\u679c\u53ef\u4ee5\u6539\u53d8\u5e73\u9762\u7684\u6bcf\u4e2a\u7247\u5143\u7684\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6a21\u62df\u5e73\u9762\u7684\u7455\u75b5\uff0c\u4f7f\u5b83\u4eec\u66f4\u903c\u771f\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u8981\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u6211\u4eec\u8981\u52a0\u8f7d\u53e6\u4e00\u4e2a\u7eb9\u7406\uff0c\u5b83\u50a8\u5b58\u9762\u7684\u6cd5\u7ebf\u3002\u6cd5\u7ebf\u7eb9\u7406\u7684\u6bcf\u4e2a\u50cf\u7d20\u5c06\u4ee5RGB\u503c\u50a8\u5b58\u6cd5\u7ebf\u7684 x \u3001 y \u548c z \u5750\u6807\u503c\u3002 \u8ba9\u6211\u4eec\u7528\u4e0b\u9762\u7684\u7eb9\u7406\u7ed8\u5236\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002 \u4e0a\u56fe\u7684\u6cd5\u7ebf\u7eb9\u7406\u5982\u4e0b\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5982\u679c\u6211\u4eec\u628a\u989c\u8272\u53d8\u6362\u5e94\u7528\u5230\u539f\u59cb\u7eb9\u7406\uff0c\u6bcf\u4e2a\u50cf\u7d20\u4f7f\u7528\u989c\u8272\u5206\u91cf\u50a8\u5b58\u6cd5\u7ebf\u4fe1\u606f\u3002\u5728\u770b\u5230\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u4f60\u5e38\u5e38\u4f1a\u770b\u5230\u4e3b\u8272\u8c03\u503e\u5411\u4e8e\u84dd\u8272\uff0c\u8fd9\u662f\u7531\u4e8e\u5927\u591a\u6570\u6cd5\u7ebf\u6307\u5411\u8f6c\u6362\u6b63 z \u8f74\u6240\u81f4\u3002\u5728\u4e00\u4e2a\u5e73\u9762\u8868\u9762\u7684\u77e2\u91cf\u4e2d\uff0c z \u5206\u91cf\u901a\u5e38\u6bd4 x \u548c y \u5206\u91cf\u7684\u503c\u9ad8\u5f97\u591a\u3002\u7531\u4e8e x \u3001 y \u3001 z \u5750\u6807\u88ab\u6620\u5c04\u5230RGB\uff0c\u5bfc\u81f4\u84dd\u8272\u5206\u91cf\u4e5f\u6709\u7740\u66f4\u9ad8\u7684\u503c\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6e32\u67d3\u5bf9\u8c61\u53ea\u9700\u8981\u4e00\u4e2a\u989d\u5916\u7684\u7eb9\u7406\uff0c\u5e76\u540c\u65f6\u4f7f\u7528\u5b83\u6e32\u67d3\u7247\u5143\u4ee5\u83b7\u5f97\u9002\u5f53\u7684\u6cd5\u7ebf\u503c\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u6cd5\u7ebf\u8d34\u56fe\u3002\u6211\u4eec\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 Texture \u5b9e\u4f8b\u5230 Material \u7c7b\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u628a\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u6dfb\u52a0\u5230\u6e38\u620f\u9879\u76ee\u4e0a\u3002\u6b64\u5b9e\u4f8b\u5c06\u6709\u81ea\u5df1\u7684 get \u548c set \u65b9\u6cd5\uff0c\u5e76\u6709\u65b9\u6cd5\u53ef\u4ee5\u68c0\u67e5 Material \u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002 public class Material { private static final Vector4f DEFAULT_COLOUR = new Vector3f(1.0f, 1.0f, 1.0f, 10.f); private Vector3f ambientColour; private Vector3f diffuseColour; private Vector3f specularColour; private float reflectance; private Texture texture; private Texture normalMap; // \u2026 Previous code here public boolean hasNormalMap() { return this.normalMap != null; } public Texture getNormalMap() { return normalMap; } public void setNormalMap(Texture normalMap) { this.normalMap = normalMap; } } \u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u4f46\u662f\uff0c\u7531\u4e8e\u6211\u4eec\u5728\u89c2\u5bdf\u5750\u6807\u7a7a\u95f4\u64cd\u4f5c\uff0c\u6240\u4ee5\u9700\u8981\u901a\u8fc7\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6765\u8fdb\u884c\u9002\u5f53\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; outModelViewMatrix = modelViewMatrix; } \u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u8f93\u5165\u53c2\u6570\u3002 in mat4 outModelViewMatrix; \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u91c7\u6837\u5668\u4f20\u9012\u4e00\u4e2a\u65b0\u7684Uniform\uff1a uniform sampler2D texture_sampler; \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u8ba1\u7b97\u5f53\u524d\u7247\u5143\u7684\u6cd5\u7ebf\u3002 vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelViewMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(modelViewMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } \u8be5\u51fd\u6570\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * Material \u5b9e\u4f8b\u3002 * \u9876\u70b9\u6cd5\u7ebf\u3002 * \u7eb9\u7406\u5750\u6807\u3002 * \u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002 \u6211\u4eec\u5728\u6b64\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u68c0\u67e5\u8fd9\u4e2a Material \u5b9e\u4f8b\u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u6ca1\u6709\uff0c\u6211\u4eec\u5c31\u50cf\u5e73\u5e38\u4e00\u6837\u7b80\u5355\u5730\u4f7f\u7528\u9876\u70b9\u6cd5\u7ebf\u3002\u5982\u679c\u5b83\u6709\u6cd5\u7ebf\u8d34\u56fe\uff0c\u6211\u4eec\u4f7f\u7528\u50a8\u5b58\u7740\u6cd5\u7ebf\u6570\u636e\u7684\u6cd5\u7ebf\u7eb9\u7406\u5173\u8054\u5230\u5f53\u524d\u7eb9\u7406\u5750\u6807\u3002 \u8bb0\u4f4f\u6211\u4eec\u53d6\u5f97\u7684\u989c\u8272\u662f\u6cd5\u7ebf\u5750\u6807\uff0c\u4f46\u56e0\u4e3a\u5b83\u4eec\u88ab\u50a8\u5b58\u4e3aRGB\u503c\uff0c\u6240\u4ee5\u5b83\u4eec\u7684\u503c\u5728\u8303\u56f4 0, 1 \u4e2d\u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8303\u56f4\u8f6c\u6362\u4e3a -1, 1 \uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u5176\u4e58\u4ee52\u7136\u540e\u51cf\u53bb1\u3002\u7136\u540e\uff0c\u6211\u4eec\u5c06\u5b83\u5f52\u4e00\u5316\uff0c\u5e76\u5c06\u5176\u8f6c\u6362\u5230\u6a21\u578b\u89c2\u5bdf\u5750\u6807\u7cfb\uff08\u5c31\u50cf\u9876\u70b9\u6cd5\u7ebf\u90a3\u6837\uff09\u3002 \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd4\u56de\u503c\u4f5c\u4e3a\u7247\u5143\u6240\u6709\u5149\u7167\u8ba1\u7b97\u4e2d\u7684\u6cd5\u7ebf\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u6cd5\u7ebf\u8d34\u56fe\uff0c\u5728 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u505a\u5982\u4e0b\u8bbe\u7f6e\uff1a //... sceneShaderProgram.setUniform(\"fog\", scene.getFog()); sceneShaderProgram.setUniform(\"texture_sampler\", 0); sceneShaderProgram.setUniform(\"normalMap\", 1); //... \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e00\u4e9b\u6709\u8da3\u7684\u4e8b\u60c5\u3002\u6211\u4eec\u5c06\u6750\u8d28\u7eb9\u7406Uniform\uff08 texture_sampler \uff09\u8bbe\u7f6e\u4e3a 0 \uff0c\u7136\u540e\u5c06\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\uff08 normalMap \uff09\u8bbe\u7f6e\u4e3a 1 \u3002\u5982\u679c\u4f60\u56de\u60f3\u7eb9\u7406\u7ae0\u8282\uff0c\u6211\u4eec\u4e0d\u6b62\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u4e3a\u6bcf\u4e2a\u5355\u72ec\u7684\u7eb9\u7406\u8bbe\u7f6e\u7eb9\u7406\u5355\u5143\u3002 \u5f53\u6211\u4eec\u6e32\u67d3 Mesh \u65f6\uff0c\u4e5f\u9700\u8981\u8003\u8651\u8fd9\u4e00\u70b9\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } Texture normalMap = material.getNormalMap(); if ( normalMap != null ) { // \u6fc0\u6d3b\u7b2c\u4e8c\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE1); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, normalMap.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u6bcf\u4e2a\u53ef\u7528\u7684\u7eb9\u7406\uff0c\u5e76\u6fc0\u6d3b\u76f8\u5173\u7684\u7eb9\u7406\u5355\u5143\uff0c\u4ee5\u4fbf\u591a\u4e2a\u7eb9\u7406\u80fd\u591f\u540c\u65f6\u5de5\u4f5c\u3002\u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u663e\u5f0f\u8bbe\u7f6e\u7eb9\u7406\u7684Uniform\uff0c\u56e0\u4e3a\u5b83\u5df2\u7ecf\u5305\u542b\u5728 Material \u4e2d\u3002 \u4e3a\u4e86\u5c55\u793a\u6cd5\u7ebf\u8d34\u56fe\u5e26\u6765\u7684\u63d0\u5347\uff0c\u6211\u5df2\u7ecf\u521b\u5efa\u4e86\u4e24\u4e2a\u5e76\u6392\u663e\u793a\u7684\u56db\u8fb9\u5f62\u793a\u4f8b\u3002\u53f3\u8fb9\u7684\u6709\u4e00\u5f20\u6cd5\u7ebf\u8d34\u56fe\uff0c\u800c\u5de6\u8fb9\u6ca1\u6709\u3002\u6211\u4eec\u8fd8\u5220\u9664\u4e86\u5730\u5f62\u3001\u5929\u7a7a\u76d2\u548cHUD\uff0c\u5e76\u8bbe\u7f6e\u4e86\u5e73\u884c\u5149\u7167\uff0c\u53ef\u4ee5\u7528\u9f20\u6807\u5de6\u53f3\u952e\u6539\u53d8\u65b9\u5411\uff0c\u8fd9\u6837\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\u4e86\u3002\u6211\u5df2\u7ecf\u4fee\u6539\u4e86\u57fa\u672c\u6e90\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u5173\u95ed\u5929\u7a7a\u76d2\u548c\u5730\u5f62\u3002\u6211\u4eec\u8fd8\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u8bbe\u7f6e\u4e86\u5149\u6548\u679c\u7684\u8303\u56f4\u4e3a 0, 1 \uff0c\u4ee5\u907f\u514d\u56fe\u50cf\u8fc7\u5ea6\u66dd\u5149\u3002 \u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5177\u6709\u6cd5\u7ebf\u8d34\u56fe\u7684\u56db\u8fb9\u5f62\u611f\u89c9\u66f4\u5927\u3002\u867d\u7136\u5b83\u672c\u8d28\u4e0a\u662f\u4e00\u4e2a\u50cf\u5176\u4ed6\u56db\u8fb9\u5f62\u4e00\u6837\u7684\u5e73\u9762\uff0c\u4f46\u4f60\u53ef\u4ee5\u770b\u5230\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002 \u5c3d\u7ba1\u6211\u4eec\u5df2\u7ecf\u7f16\u5199\u7684\u4ee3\u7801\u5b8c\u5168\u7b26\u5408\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f46\u4f60\u9700\u8981\u77e5\u9053\u5b83\u7684\u5c40\u9650\u6027\u3002\u8be5\u4ee3\u7801\u4ec5\u9002\u7528\u4e0e\u4f7f\u7528\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u521b\u5efa\u7684\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u5982\u679c\u662f\u8fd9\u79cd\u60c5\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u6765\u5c06\u6cd5\u7ebf\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002 \u4f46\u901a\u5e38\u6cd5\u7ebf\u8d34\u56fe\u4e0d\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\u3002\u5b83\u4eec\u901a\u5e38\u88ab\u5b9a\u4e49\u5728\u6240\u8c13\u7684 \u5207\u7ebf\u7a7a\u95f4\uff08 Tangent Space \uff09 \u4e2d\u3002\u5207\u7ebf\u7a7a\u95f4\u662f\u4e00\u4e2a\u5750\u6807\u7cfb\uff0c\u5b83\u5b9a\u4f4d\u5728\u6a21\u578b\u7684\u6bcf\u4e2a\u4e09\u89d2\u5f62\uff0c\u5176\u5750\u6807\u7cfb\u7684 z \u8f74\u603b\u662f\u5782\u76f4\u4e8e\u8868\u9762\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5f53\u4f60\u770b\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u5b83\u901a\u5e38\u662f\u84dd\u8272\u7684\uff0c\u751a\u81f3\u5bf9\u4e8e\u9762\u76f8\u5bf9\u590d\u6742\u7684\u6a21\u578b\u4e5f\u662f\u5982\u6b64\u3002 \u6211\u4eec\u73b0\u5728\u4ecd\u4f7f\u7528\u8fd9\u4e2a\u7b80\u5355\u7684\u5b9e\u73b0\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5fc5\u987b\u603b\u662f\u4f7f\u7528\u5728\u6a21\u578b\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u4f7f\u7528\u5207\u7ebf\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u8d34\u56fe\uff0c\u5c31\u4f1a\u53d8\u5f97\u5f88\u5947\u602a\u3002\u4e3a\u4e86\u80fd\u591f\u8ba9\u5b83\u4eec\u4e00\u540c\u5de5\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u7279\u5b9a\u7684\u77e9\u9635\u6765\u5c06\u5750\u6807\u53d8\u6362\u5230\u5207\u7ebf\u7a7a\u95f4\u3002","title":"\u6cd5\u7ebf\u8d34\u56fe"},{"location":"17-normal-mapping/#normal-mapping","text":"\u672c\u7ae0\u4e2d\u5c06\u8bb2\u89e3\u4e00\u9879\u6280\u672f\uff0c\u5b83\u5c06\u6781\u5927\u5730\u6539\u5584\u6211\u4eec\u76843D\u6a21\u578b\u7684\u5916\u89c2\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u80fd\u591f\u5c06\u7eb9\u7406\u4f7f\u7528\u5230\u590d\u6742\u76843D\u6a21\u578b\u4e0a\uff0c\u4f46\u8fd9\u8fd8\u79bb\u771f\u5b9e\u7269\u4f53\u7684\u6837\u5b50\u5f88\u8fdc\u3002\u73b0\u5b9e\u4e16\u754c\u4e2d\u7684\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u5149\u6ed1\u7684\uff0c\u5b83\u4eec\u6709\u6211\u4eec\u76843D\u6a21\u578b\u76ee\u524d\u6240\u4e0d\u5177\u6709\u7684\u7455\u75b5\u3002 \u4e3a\u4e86\u6e32\u67d3\u66f4\u771f\u5b9e\u7684\u573a\u666f\uff0c\u6211\u4eec\u5c06\u6e32\u67d3 \u6cd5\u7ebf\u8d34\u56fe(Normal Mapping) \u3002\u5982\u679c\u4f60\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\u770b\u5230\u4e00\u4e2a\u5e73\u9762\uff0c\u4f60\u4f1a\u53d1\u73b0\u90a3\u4e9b\u7455\u75b5\u751a\u81f3\u53ef\u4ee5\u5728\u5f88\u8fdc\u7684\u8ddd\u79bb\u770b\u5230\u3002\u57283D\u573a\u666f\u4e2d\uff0c\u5e73\u9762\u6ca1\u6709\u7455\u75b5\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u7eb9\u7406\u5e94\u7528\u5728\u5b83\u4e4b\u4e0a\uff0c\u4f46\u8fd9\u4e0d\u4f1a\u6539\u53d8\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0e\u73b0\u5b9e\u6709\u533a\u522b\u7684\u539f\u56e0\u3002 \u6211\u4eec\u53ef\u4ee5\u8003\u8651\u901a\u8fc7\u589e\u52a0\u4e09\u89d2\u5f62\u6570\u91cf\u6765\u589e\u52a0\u6a21\u578b\u7684\u7ec6\u8282\u5e76\u53cd\u6620\u51fa\u8fd9\u4e9b\u7455\u75b5\uff0c\u4f46\u6027\u80fd\u4f1a\u4e0b\u964d\u3002\u6211\u4eec\u9700\u8981\u7684\u662f\u6539\u53d8\u8868\u9762\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u6765\u589e\u52a0\u771f\u5b9e\u611f\u3002\u8fd9\u5c31\u662f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6280\u672f\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u5149\u6ed1\u5e73\u9762\u7684\u4f8b\u5b50\uff0c\u4e00\u4e2a\u5e73\u9762\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u4e3a\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002\u56de\u5fc6\u4e4b\u524d\u7684\u5149\u7167\u7ae0\u8282\uff0c\u6a21\u578b\u7684\u5149\u53cd\u5c04\u7684\u8981\u7d20\u662f\u5e73\u9762\u6cd5\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u6574\u4e2a\u5e73\u9762\u4ec5\u6709\u5355\u4e00\u7684\u6cd5\u7ebf\uff0c\u5f53\u8ba1\u7b97\u5149\u5982\u4f55\u5f71\u54cd\u7247\u5143\u65f6\uff0c\u6bcf\u4e2a\u7247\u5143\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u6cd5\u7ebf\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u5982\u679c\u53ef\u4ee5\u6539\u53d8\u5e73\u9762\u7684\u6bcf\u4e2a\u7247\u5143\u7684\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6a21\u62df\u5e73\u9762\u7684\u7455\u75b5\uff0c\u4f7f\u5b83\u4eec\u66f4\u903c\u771f\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u8981\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u6211\u4eec\u8981\u52a0\u8f7d\u53e6\u4e00\u4e2a\u7eb9\u7406\uff0c\u5b83\u50a8\u5b58\u9762\u7684\u6cd5\u7ebf\u3002\u6cd5\u7ebf\u7eb9\u7406\u7684\u6bcf\u4e2a\u50cf\u7d20\u5c06\u4ee5RGB\u503c\u50a8\u5b58\u6cd5\u7ebf\u7684 x \u3001 y \u548c z \u5750\u6807\u503c\u3002 \u8ba9\u6211\u4eec\u7528\u4e0b\u9762\u7684\u7eb9\u7406\u7ed8\u5236\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002 \u4e0a\u56fe\u7684\u6cd5\u7ebf\u7eb9\u7406\u5982\u4e0b\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5982\u679c\u6211\u4eec\u628a\u989c\u8272\u53d8\u6362\u5e94\u7528\u5230\u539f\u59cb\u7eb9\u7406\uff0c\u6bcf\u4e2a\u50cf\u7d20\u4f7f\u7528\u989c\u8272\u5206\u91cf\u50a8\u5b58\u6cd5\u7ebf\u4fe1\u606f\u3002\u5728\u770b\u5230\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u4f60\u5e38\u5e38\u4f1a\u770b\u5230\u4e3b\u8272\u8c03\u503e\u5411\u4e8e\u84dd\u8272\uff0c\u8fd9\u662f\u7531\u4e8e\u5927\u591a\u6570\u6cd5\u7ebf\u6307\u5411\u8f6c\u6362\u6b63 z \u8f74\u6240\u81f4\u3002\u5728\u4e00\u4e2a\u5e73\u9762\u8868\u9762\u7684\u77e2\u91cf\u4e2d\uff0c z \u5206\u91cf\u901a\u5e38\u6bd4 x \u548c y \u5206\u91cf\u7684\u503c\u9ad8\u5f97\u591a\u3002\u7531\u4e8e x \u3001 y \u3001 z \u5750\u6807\u88ab\u6620\u5c04\u5230RGB\uff0c\u5bfc\u81f4\u84dd\u8272\u5206\u91cf\u4e5f\u6709\u7740\u66f4\u9ad8\u7684\u503c\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6e32\u67d3\u5bf9\u8c61\u53ea\u9700\u8981\u4e00\u4e2a\u989d\u5916\u7684\u7eb9\u7406\uff0c\u5e76\u540c\u65f6\u4f7f\u7528\u5b83\u6e32\u67d3\u7247\u5143\u4ee5\u83b7\u5f97\u9002\u5f53\u7684\u6cd5\u7ebf\u503c\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u6cd5\u7ebf\u8d34\u56fe\u3002\u6211\u4eec\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 Texture \u5b9e\u4f8b\u5230 Material \u7c7b\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u628a\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u6dfb\u52a0\u5230\u6e38\u620f\u9879\u76ee\u4e0a\u3002\u6b64\u5b9e\u4f8b\u5c06\u6709\u81ea\u5df1\u7684 get \u548c set \u65b9\u6cd5\uff0c\u5e76\u6709\u65b9\u6cd5\u53ef\u4ee5\u68c0\u67e5 Material \u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002 public class Material { private static final Vector4f DEFAULT_COLOUR = new Vector3f(1.0f, 1.0f, 1.0f, 10.f); private Vector3f ambientColour; private Vector3f diffuseColour; private Vector3f specularColour; private float reflectance; private Texture texture; private Texture normalMap; // \u2026 Previous code here public boolean hasNormalMap() { return this.normalMap != null; } public Texture getNormalMap() { return normalMap; } public void setNormalMap(Texture normalMap) { this.normalMap = normalMap; } } \u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u4f46\u662f\uff0c\u7531\u4e8e\u6211\u4eec\u5728\u89c2\u5bdf\u5750\u6807\u7a7a\u95f4\u64cd\u4f5c\uff0c\u6240\u4ee5\u9700\u8981\u901a\u8fc7\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6765\u8fdb\u884c\u9002\u5f53\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; outModelViewMatrix = modelViewMatrix; } \u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u8f93\u5165\u53c2\u6570\u3002 in mat4 outModelViewMatrix; \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u91c7\u6837\u5668\u4f20\u9012\u4e00\u4e2a\u65b0\u7684Uniform\uff1a uniform sampler2D texture_sampler; \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u8ba1\u7b97\u5f53\u524d\u7247\u5143\u7684\u6cd5\u7ebf\u3002 vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelViewMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(modelViewMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } \u8be5\u51fd\u6570\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * Material \u5b9e\u4f8b\u3002 * \u9876\u70b9\u6cd5\u7ebf\u3002 * \u7eb9\u7406\u5750\u6807\u3002 * \u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002 \u6211\u4eec\u5728\u6b64\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u68c0\u67e5\u8fd9\u4e2a Material \u5b9e\u4f8b\u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u6ca1\u6709\uff0c\u6211\u4eec\u5c31\u50cf\u5e73\u5e38\u4e00\u6837\u7b80\u5355\u5730\u4f7f\u7528\u9876\u70b9\u6cd5\u7ebf\u3002\u5982\u679c\u5b83\u6709\u6cd5\u7ebf\u8d34\u56fe\uff0c\u6211\u4eec\u4f7f\u7528\u50a8\u5b58\u7740\u6cd5\u7ebf\u6570\u636e\u7684\u6cd5\u7ebf\u7eb9\u7406\u5173\u8054\u5230\u5f53\u524d\u7eb9\u7406\u5750\u6807\u3002 \u8bb0\u4f4f\u6211\u4eec\u53d6\u5f97\u7684\u989c\u8272\u662f\u6cd5\u7ebf\u5750\u6807\uff0c\u4f46\u56e0\u4e3a\u5b83\u4eec\u88ab\u50a8\u5b58\u4e3aRGB\u503c\uff0c\u6240\u4ee5\u5b83\u4eec\u7684\u503c\u5728\u8303\u56f4 0, 1 \u4e2d\u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8303\u56f4\u8f6c\u6362\u4e3a -1, 1 \uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u5176\u4e58\u4ee52\u7136\u540e\u51cf\u53bb1\u3002\u7136\u540e\uff0c\u6211\u4eec\u5c06\u5b83\u5f52\u4e00\u5316\uff0c\u5e76\u5c06\u5176\u8f6c\u6362\u5230\u6a21\u578b\u89c2\u5bdf\u5750\u6807\u7cfb\uff08\u5c31\u50cf\u9876\u70b9\u6cd5\u7ebf\u90a3\u6837\uff09\u3002 \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd4\u56de\u503c\u4f5c\u4e3a\u7247\u5143\u6240\u6709\u5149\u7167\u8ba1\u7b97\u4e2d\u7684\u6cd5\u7ebf\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u6cd5\u7ebf\u8d34\u56fe\uff0c\u5728 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u505a\u5982\u4e0b\u8bbe\u7f6e\uff1a //... sceneShaderProgram.setUniform(\"fog\", scene.getFog()); sceneShaderProgram.setUniform(\"texture_sampler\", 0); sceneShaderProgram.setUniform(\"normalMap\", 1); //... \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e00\u4e9b\u6709\u8da3\u7684\u4e8b\u60c5\u3002\u6211\u4eec\u5c06\u6750\u8d28\u7eb9\u7406Uniform\uff08 texture_sampler \uff09\u8bbe\u7f6e\u4e3a 0 \uff0c\u7136\u540e\u5c06\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\uff08 normalMap \uff09\u8bbe\u7f6e\u4e3a 1 \u3002\u5982\u679c\u4f60\u56de\u60f3\u7eb9\u7406\u7ae0\u8282\uff0c\u6211\u4eec\u4e0d\u6b62\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u4e3a\u6bcf\u4e2a\u5355\u72ec\u7684\u7eb9\u7406\u8bbe\u7f6e\u7eb9\u7406\u5355\u5143\u3002 \u5f53\u6211\u4eec\u6e32\u67d3 Mesh \u65f6\uff0c\u4e5f\u9700\u8981\u8003\u8651\u8fd9\u4e00\u70b9\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } Texture normalMap = material.getNormalMap(); if ( normalMap != null ) { // \u6fc0\u6d3b\u7b2c\u4e8c\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE1); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, normalMap.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u6bcf\u4e2a\u53ef\u7528\u7684\u7eb9\u7406\uff0c\u5e76\u6fc0\u6d3b\u76f8\u5173\u7684\u7eb9\u7406\u5355\u5143\uff0c\u4ee5\u4fbf\u591a\u4e2a\u7eb9\u7406\u80fd\u591f\u540c\u65f6\u5de5\u4f5c\u3002\u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u663e\u5f0f\u8bbe\u7f6e\u7eb9\u7406\u7684Uniform\uff0c\u56e0\u4e3a\u5b83\u5df2\u7ecf\u5305\u542b\u5728 Material \u4e2d\u3002 \u4e3a\u4e86\u5c55\u793a\u6cd5\u7ebf\u8d34\u56fe\u5e26\u6765\u7684\u63d0\u5347\uff0c\u6211\u5df2\u7ecf\u521b\u5efa\u4e86\u4e24\u4e2a\u5e76\u6392\u663e\u793a\u7684\u56db\u8fb9\u5f62\u793a\u4f8b\u3002\u53f3\u8fb9\u7684\u6709\u4e00\u5f20\u6cd5\u7ebf\u8d34\u56fe\uff0c\u800c\u5de6\u8fb9\u6ca1\u6709\u3002\u6211\u4eec\u8fd8\u5220\u9664\u4e86\u5730\u5f62\u3001\u5929\u7a7a\u76d2\u548cHUD\uff0c\u5e76\u8bbe\u7f6e\u4e86\u5e73\u884c\u5149\u7167\uff0c\u53ef\u4ee5\u7528\u9f20\u6807\u5de6\u53f3\u952e\u6539\u53d8\u65b9\u5411\uff0c\u8fd9\u6837\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\u4e86\u3002\u6211\u5df2\u7ecf\u4fee\u6539\u4e86\u57fa\u672c\u6e90\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u5173\u95ed\u5929\u7a7a\u76d2\u548c\u5730\u5f62\u3002\u6211\u4eec\u8fd8\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u8bbe\u7f6e\u4e86\u5149\u6548\u679c\u7684\u8303\u56f4\u4e3a 0, 1 \uff0c\u4ee5\u907f\u514d\u56fe\u50cf\u8fc7\u5ea6\u66dd\u5149\u3002 \u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5177\u6709\u6cd5\u7ebf\u8d34\u56fe\u7684\u56db\u8fb9\u5f62\u611f\u89c9\u66f4\u5927\u3002\u867d\u7136\u5b83\u672c\u8d28\u4e0a\u662f\u4e00\u4e2a\u50cf\u5176\u4ed6\u56db\u8fb9\u5f62\u4e00\u6837\u7684\u5e73\u9762\uff0c\u4f46\u4f60\u53ef\u4ee5\u770b\u5230\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002 \u5c3d\u7ba1\u6211\u4eec\u5df2\u7ecf\u7f16\u5199\u7684\u4ee3\u7801\u5b8c\u5168\u7b26\u5408\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f46\u4f60\u9700\u8981\u77e5\u9053\u5b83\u7684\u5c40\u9650\u6027\u3002\u8be5\u4ee3\u7801\u4ec5\u9002\u7528\u4e0e\u4f7f\u7528\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u521b\u5efa\u7684\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u5982\u679c\u662f\u8fd9\u79cd\u60c5\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u6765\u5c06\u6cd5\u7ebf\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002 \u4f46\u901a\u5e38\u6cd5\u7ebf\u8d34\u56fe\u4e0d\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\u3002\u5b83\u4eec\u901a\u5e38\u88ab\u5b9a\u4e49\u5728\u6240\u8c13\u7684 \u5207\u7ebf\u7a7a\u95f4\uff08 Tangent Space \uff09 \u4e2d\u3002\u5207\u7ebf\u7a7a\u95f4\u662f\u4e00\u4e2a\u5750\u6807\u7cfb\uff0c\u5b83\u5b9a\u4f4d\u5728\u6a21\u578b\u7684\u6bcf\u4e2a\u4e09\u89d2\u5f62\uff0c\u5176\u5750\u6807\u7cfb\u7684 z \u8f74\u603b\u662f\u5782\u76f4\u4e8e\u8868\u9762\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5f53\u4f60\u770b\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u5b83\u901a\u5e38\u662f\u84dd\u8272\u7684\uff0c\u751a\u81f3\u5bf9\u4e8e\u9762\u76f8\u5bf9\u590d\u6742\u7684\u6a21\u578b\u4e5f\u662f\u5982\u6b64\u3002 \u6211\u4eec\u73b0\u5728\u4ecd\u4f7f\u7528\u8fd9\u4e2a\u7b80\u5355\u7684\u5b9e\u73b0\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5fc5\u987b\u603b\u662f\u4f7f\u7528\u5728\u6a21\u578b\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u4f7f\u7528\u5207\u7ebf\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u8d34\u56fe\uff0c\u5c31\u4f1a\u53d8\u5f97\u5f88\u5947\u602a\u3002\u4e3a\u4e86\u80fd\u591f\u8ba9\u5b83\u4eec\u4e00\u540c\u5de5\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u7279\u5b9a\u7684\u77e9\u9635\u6765\u5c06\u5750\u6807\u53d8\u6362\u5230\u5207\u7ebf\u7a7a\u95f4\u3002","title":"\u6cd5\u7ebf\u8d34\u56fe\uff08Normal Mapping\uff09"},{"location":"18-shadows/","text":"\u9634\u5f71\uff08Shadows\uff09 \u9634\u5f71\u6620\u5c04 \u76ee\u524d\uff0c\u6211\u4eec\u80fd\u591f\u8868\u73b0\u5149\u7ebf\u5982\u4f55\u5f71\u54cd\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5bf9\u8c61\u3002\u63a5\u6536\u5230\u66f4\u591a\u5149\u7684\u7269\u4f53\u6bd4\u6ca1\u6709\u63a5\u6536\u5149\u7684\u7269\u4f53\u66f4\u4eae\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u65e0\u6cd5\u6295\u5c04\u9634\u5f71\u3002\u9634\u5f71\u80fd\u589e\u52a03D\u573a\u666f\u7684\u771f\u5b9e\u5ea6\uff0c\u56e0\u6b64\u6211\u4eec\u5c06\u5728\u672c\u7ae0\u4e2d\u6dfb\u52a0\u5bf9\u5b83\u7684\u652f\u6301\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u88ab\u79f0\u4e3a\u9634\u5f71\u6620\u5c04\uff08Shadow Mapping\uff09\u7684\u6280\u672f\uff0c\u8fd9\u79cd\u6280\u672f\u88ab\u5e7f\u6cdb\u4f7f\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u4e14\u4e0d\u4f1a\u4e25\u91cd\u5f71\u54cd\u5f15\u64ce\u6027\u80fd\u3002\u9634\u5f71\u6620\u5c04\u770b\u8d77\u6765\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u5f88\u96be\u6b63\u786e\u5730\u5b9e\u73b0\u5b83\u3002\u6216\u8005\u66f4\u51c6\u786e\u5730\u8bf4\uff0c\u5f88\u96be\u7528\u4e00\u79cd\u901a\u7528\u7684\uff0c\u6db5\u76d6\u4e86\u4e00\u5207\u53ef\u80fd\u5e76\u4ea7\u751f\u4e00\u81f4\u7684\u6548\u679c\u7684\u65b9\u6cd5\u53bb\u5b9e\u73b0\u5b83\u3002 \u6211\u4eec\u5c06\u5728\u6b64\u8bf4\u660e\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ef\u4ee5\u4e3a\u4f60\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u6dfb\u52a0\u9634\u5f71\uff0c\u4f46\u66f4\u91cd\u8981\u7684\u662f\uff0c\u5b83\u5c06\u5e2e\u52a9\u4f60\u4e86\u89e3\u5176\u5c40\u9650\u6027\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u4ee3\u7801\u8fdc\u4e0d\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5f88\u5bb9\u6613\u7406\u89e3\u3002\u5b83\u8fd8\u88ab\u8bbe\u8ba1\u7528\u4e8e\u652f\u6301\u6709\u5411\u5149\uff08\u8fd9\u6211\u8ba4\u4e3a\u662f\u66f4\u590d\u6742\u7684\u60c5\u51b5\uff09\uff0c\u4f46\u4f60\u5c06\u4e86\u89e3\u5982\u4f55\u5c06\u5176\u6269\u5c55\u4ee5\u652f\u6301\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u7167\uff08\u4f8b\u5982\u70b9\u5149\u6e90\uff09\u3002\u5982\u679c\u60f3\u83b7\u5f97\u66f4\u9ad8\u7ea7\u7684\u6548\u679c\uff0c\u4f60\u5e94\u8be5\u4f7f\u7528\u66f4\u9ad8\u7ea7\u7684\u6280\u672f\uff0c\u4f8b\u5982\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u8fd9\u91cc\u89e3\u91ca\u7684\u6982\u5ff5\u90fd\u4ec5\u4ec5\u4f5c\u4e3a\u57fa\u7840\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u4ece\u601d\u8003\u5982\u4f55\u68c0\u67e5\u7279\u5b9a\u533a\u57df\uff08\u5b9e\u9645\u4e0a\u662f\u7247\u5143\uff09\u662f\u5426\u5728\u9634\u5f71\u4e2d\u5f00\u59cb\u3002\u5728\u7ed8\u5236\u8fd9\u4e2a\u533a\u57df\u7684\u65f6\u5019\uff0c\u6211\u4eec\u53ef\u4ee5\u53d1\u51fa\u5c04\u7ebf\u6295\u5c04\u5230\u5149\u6e90\u4e0a\uff0c\u5982\u679c\u6211\u4eec\u53ef\u4ee5\u5728\u4e0d\u53d1\u751f\u4efb\u4f55\u78b0\u649e\u7684\u60c5\u51b5\u4e0b\u5230\u8fbe\u5149\u6e90\uff0c\u90a3\u4e48\u50cf\u7d20\u5c31\u5728\u5149\u7167\u4e2d\uff0c\u53cd\u4e4b\uff0c\u50cf\u7d20\u5904\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u70b9\u5149\u6e90\u7684\u60c5\u51b5\uff0c\u70b9PA\u53ef\u4ee5\u5230\u8fbe\u5149\u6e90\uff0c\u4f46\u70b9PB\u548cPC\u4e0d\u884c\uff0c\u56e0\u6b64\u5b83\u4eec\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5982\u4f55\u624d\u80fd\u68c0\u67e5\u662f\u5426\u80fd\u4ee5\u4e00\u79cd\u6709\u6548\u7684\u65b9\u5f0f\u53d1\u5c04\u51fa\u4e0d\u53d1\u751f\u78b0\u649e\u7684\u5c04\u7ebf\u5462\uff1f\u7406\u8bba\u4e0a\uff0c\u5149\u6e90\u53ef\u4ee5\u6295\u5c04\u51fa\u65e0\u9650\u7684\u5149\u7ebf\uff0cName\u6211\u4eec\u5982\u4f55\u68c0\u67e5\u5149\u7ebf\u662f\u5426\u88ab\u906e\u6321\uff1f \u6211\u4eec\u80fd\u505a\u7684\u4e0d\u662f\u6295\u5c04\u5149\u7ebf\uff0c\u800c\u662f\u4ece\u5149\u7ebf\u900f\u89c6\u56fe\u4e2d\u89c2\u5bdf3D\u573a\u666f\uff0c\u5e76\u4ece\u8be5\u4f4d\u7f6e\u6e32\u67d3\u573a\u666f\u3002\u6211\u4eec\u53ef\u4ee5\u5c06\u76f8\u673a\u8bbe\u7f6e\u5728\u5149\u6e90\u4f4d\u7f6e\u5e76\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u50a8\u5b58\u6bcf\u4e2a\u7247\u5143\u7684\u6df1\u5ea6\u3002\u8fd9\u76f8\u5f53\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u6700\u540e\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u5c06\u5149\u7167\u6240\u53ca\u7684\u6700\u5c0f\u8ddd\u79bb\u50a8\u5b58\u4e3a\u9634\u5f71\u56fe\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u60ac\u6d6e\u5728\u5e73\u9762\u4e0a\u5e76\u5782\u76f4\u4e8e\u5149\u7ebf\u7684\u7acb\u65b9\u4f53\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u770b\uff0c\u60c5\u51b5\u662f\u8fd9\u6837\u7684\uff08\u989c\u8272\u8d8a\u6df1\uff0c\u8d8a\u63a5\u8fd1\u5149\u6e90\uff09\u3002 \u5229\u7528\u8fd9\u4e9b\u4fe1\u606f\u3002\u6211\u4eec\u53ef\u4ee5\u50cf\u5f80\u5e38\u4e00\u6837\u6e32\u67d33D\u573a\u666f\uff0c\u5e76\u4ee5\u6700\u5c0f\u50a8\u5b58\u8ddd\u79bb\u68c0\u67e5\u6bcf\u4e2a\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u5982\u679c\u8ddd\u79bb\u5c0f\u4e8e\u9634\u5f71\u8d34\u56fe\u4e2d\u50a8\u5b58\u7684\u503c\uff0c\u5219\u5bf9\u8c61\u4f4d\u4e8e\u5149\u7167\u4e2d\uff0c\u5426\u5219\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002\u6211\u4eec\u53ef\u4ee5\u8ba9\u51e0\u4e2a\u7269\u4f53\u88ab\u540c\u4e00\u5149\u7167\u7167\u5c04\uff0c\u4f46\u6211\u4eec\u50a8\u5b58\u6700\u5c0f\u8ddd\u79bb\u3002 \u56e0\u6b64\uff0c\u9634\u5f71\u6620\u5c04\u5206\u4e3a\u4e24\u6b65\uff1a \u9996\u5148\uff0c\u6211\u4eec\u5c06\u573a\u666f\u4ece\u5149\u7167\u7a7a\u95f4\u6e32\u67d3\u4e3a\u9634\u5f71\u56fe\uff0c\u4ee5\u83b7\u5f97\u6700\u5c0f\u8ddd\u79bb\u3002 \u5176\u6b21\uff0c\u6211\u4eec\u4ece\u6444\u50cf\u673a\u7684\u89c6\u89d2\u6e32\u67d3\u573a\u666f\u3002\u5e76\u4f7f\u7528\u6df1\u5ea6\u56fe\u8ba1\u7b97\u5bf9\u8c61\u662f\u5426\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e3a\u4e86\u6e32\u67d3\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u9700\u8981\u8bf4\u8bf4\u6df1\u5ea6\u7f13\u51b2\u533a\uff08Depth-buffer\uff09\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u65f6\uff0c\u6240\u6709\u6df1\u5ea6\u4fe1\u606f\u90fd\u50a8\u5b58\u5728\u4e00\u4e2a\u540d\u4e3a\u201c\u6df1\u5ea6\u7f13\u51b2\u533a\u201d\uff08\u53c8\u79f0\u201cZ\u7f13\u51b2\u533a\uff08Z-buffer\uff09\u201d\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u6df1\u5ea6\u4fe1\u606f\u662f\u6e32\u67d3\u7684\u6bcf\u4e2a\u7247\u5143\u7684 z \u503c\u3002\u5982\u679c\u4f60\u4ece\u7b2c\u4e00\u7ae0\u56de\u5fc6\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u5c06\u6b63\u5728\u6e32\u67d3\u7684\u573a\u666f\u4ece\u4e16\u754c\u5750\u6807\u8f6c\u6362\u4e3a\u5c4f\u5e55\u5750\u6807\u3002\u6211\u4eec\u6240\u7ed8\u5236\u7684\u5750\u6807\u7a7a\u95f4\uff0c\u5bf9\u4e8e x \u548c y \u8f74\u6765\u8bf4\uff0c\u5750\u6807\u7684\u8303\u56f4\u4e3a 0 \u5230 1 \u3002\u5982\u679c\u4e00\u4e2a\u7269\u4f53\u6bd4\u5176\u4ed6\u5bf9\u8c61\u539f\uff0c\u6211\u4eec\u5fc5\u987b\u901a\u8fc7\u900f\u89c6\u6295\u5f71\u77e9\u9635\u8ba1\u7b97\u5b83\u5982\u4f55\u5f71\u54cd\u5176 x \u548c y \u5750\u6807\u3002\u8fd9\u4e0d\u662f\u6839\u636e z \u503c\u81ea\u52a8\u8ba1\u7b97\u7684\uff0c\u5b83\u5fc5\u987b\u7531\u6211\u4eec\u6765\u505a\u3002\u5b9e\u9645\u50a8\u5b58\u5728 z \u5750\u6807\u4e2d\u7684\u662f\u5b83\u5728\u7247\u5143\u7684\u6df1\u5ea6\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6b64\u5916\uff0c\u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u5982\u4e0b\u884c\uff1a glEnable(GL_DEPTH_TEST); \u901a\u8fc7\u6dfb\u52a0\u8fd9\u884c\uff0c\u6211\u4eec\u53ef\u4ee5\u9632\u6b62\u65e0\u6cd5\u770b\u5230\u7684\u7247\u5143\u88ab\u7ed8\u5236\u51fa\u6765\uff0c\u56e0\u4e3a\u4ed6\u4eec\u4f4d\u4e8e\u5176\u4ed6\u5bf9\u8c61\u4e4b\u540e\u3002\u5728\u7ed8\u5236\u7247\u5143\u4e4b\u524d\uff0c\u5b83\u7684 z \u503c\u5c06\u4e0eZ\u7f13\u51b2\u533a\u4e2d\u7684 z \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u5b83\u7684 z \u503c\uff08\u5b83\u7684\u8ddd\u79bb\uff09\u5927\u4e8e\u7f13\u51b2\u533a\u7684 z \u503c\uff0c\u5219\u4f1a\u88ab\u4e22\u5f03\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u5728\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u5b8c\u6210\u7684\uff0c\u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u5bf9\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u8303\u56f4\u4e3a [0, 1] \u7684 x \u548c y \u5750\u6807\uff0c\u6211\u4eec\u6bd4\u8f83\u5176\u7247\u5143\u7684 z \u503c\u3002\u540c\u6837\uff0c z \u503c\u4e5f\u5728\u6b64\u8303\u56f4\u5185\u3002 \u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u5b58\u5728\u662f\u6211\u4eec\u5728\u6267\u884c\u4efb\u4f55\u6e32\u67d3\u64cd\u4f5c\u4e4b\u524d\u9700\u8981\u6e05\u9664\u5c4f\u5e55\u7684\u539f\u56e0\u3002\u6211\u4eec\u4e0d\u4ec5\u9700\u8981\u6e05\u9664\u989c\u8272\uff0c\u8fd8\u8981\u6e05\u9664\u6df1\u5ea6\u4fe1\u606f\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u4e3a\u4e86\u5f00\u59cb\u6784\u5efa\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5e0c\u671b\u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u83b7\u5f97\u6df1\u5ea6\u4fe1\u606f\u3002\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u4f4d\u7f6e\u8bbe\u7f6e\u4e00\u4e2a\u6444\u50cf\u5934\uff0c\u6e32\u67d3\u573a\u666f\u5e76\u5c06\u6df1\u5ea6\u4fe1\u606f\u50a8\u5b58\u5230\u7eb9\u7406\u4e2d\uff0c\u4ee5\u4fbf\u7a0d\u540e\u8bbf\u95ee\u5b83\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u7684\u662f\u6dfb\u52a0\u5bf9\u521b\u5efa\u8fd9\u4e9b\u7eb9\u7406\u7684\u652f\u6301\u3002\u6211\u4eec\u5c06\u4fee\u6539 Texture \u7c7b\uff0c\u901a\u8fc7\u6dfb\u52a0\u65b0\u7684\u6784\u9020\u51fd\u6570\u6765\u652f\u6301\u521b\u5efa\u7a7a\u7eb9\u7406\u3002\u6b64\u6784\u9020\u51fd\u6570\u9700\u8981\u7eb9\u7406\u7684\u5c3a\u5bf8\u4ee5\u53ca\u5b83\u50a8\u5b58\u7684\u50cf\u7d20\u7684\u683c\u5f0f\u3002 public Texture(int width, int height, int pixelFormat) throws Exception { this.id = glGenTextures(); this.width = width; this.height = height; glBindTexture(GL_TEXTURE_2D, this.id); glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT, this.width, this.height, 0, pixelFormat, GL_FLOAT, (ByteBuffer) null); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); } \u6211\u4eec\u5c06\u7eb9\u7406\u73af\u7ed5\u65b9\u5f0f\u8bbe\u7f6e\u4e3a GL_CLAMP_TO_EDGE \uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u5e0c\u671b\u5728\u8d85\u51fa [0, 1] \u8303\u56f4\u65f6\u91cd\u590d\u7eb9\u7406\u3002 \u6240\u4ee5\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u7a7a\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u5176\u4e2d\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5e27\u7f13\u51b2\u533a\u5bf9\u8c61\uff08Frame Buffers Objects\uff0c\u6216\u79f0FBOs\uff09\u3002\u5e27\u7f13\u51b2\u533a\u662f\u53ef\u4ee5\u4f5c\u4e3a\u6e32\u67d3\u7ec8\u70b9\u7684\u7f13\u51b2\u533a\u96c6\u5408\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL\u7684\u9ed8\u8ba4\u7f13\u51b2\u533a\u3002OpenGL\u5141\u8bb8\u6211\u4eec\u4f7f\u7528FBO\u6e32\u67d3\u5230\u7528\u6237\u5b9a\u4e49\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a ShadowMap \u7684\u65b0\u7c7b\uff0c\u6765\u9694\u79bb\u4e3a\u9634\u5f71\u6620\u5c04\u521b\u5efaFBO\u8fc7\u7a0b\u7684\u5176\u4f59\u4ee3\u7801\u3002\u5982\u4e0b\u5c31\u662f\u90a3\u4e2a\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class ShadowMap { public static final int SHADOW_MAP_WIDTH = 1024; public static final int SHADOW_MAP_HEIGHT = 1024; private final int depthMapFBO; private final Texture depthMap; public ShadowMap() throws Exception { // \u521b\u5efaFBO\u4ee5\u6e32\u67d3\u6df1\u5ea6\u56fe depthMapFBO = glGenFramebuffers(); // \u521b\u5efa\u6df1\u5ea6\u56fe\u7eb9\u7406 depthMap = new Texture(SHADOW_MAP_WIDTH, SHADOW_MAP_HEIGHT, GL_DEPTH_COMPONENT); // \u7ed1\u5b9a\u6df1\u5ea6\u56fe\u7eb9\u7406\u5230FBO glBindFramebuffer(GL_FRAMEBUFFER, depthMapFBO); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthMap.getId(), 0); // \u4ec5\u8bbe\u7f6e\u6df1\u5ea6 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) { throw new Exception(\"Could not create FrameBuffer\"); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public Texture getDepthMapTexture() { return depthMap; } public int getDepthMapFBO() { return depthMapFBO; } public void cleanup() { glDeleteFramebuffers(depthMapFBO); depthMap.cleanup(); } } ShadowMap \u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff0c\u7528\u4e8e\u786e\u5b9a\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5927\u5c0f\u3002\u5b83\u8fd8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5c5e\u6027\uff0c\u4e00\u4e2a\u7528\u4e8eFBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u7eb9\u7406\u3002\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u7684FBO\u548c\u4e00\u4e2a\u65b0\u7684 Texture \u3002\u5bf9\u4e8eFBO\uff0c\u5c06\u4f7f\u7528\u5e38\u91cf GL_DEPTH_COMPONENT \u4f5c\u4e3a\u50cf\u7d20\u683c\u5f0f\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u50a8\u5b58\u6df1\u5ea6\u503c\u611f\u5174\u8da3\uff0c\u7136\u540e\u5c06FBO\u7ed1\u5b9a\u5230\u7eb9\u7406\u5b9e\u4f8b\u3002 \u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\u663e\u5f0f\u5730\u5c06FBO\u8bbe\u7f6e\u4e3a\u4e0d\u6e32\u67d3\u4efb\u4f55\u989c\u8272\u3002FBO\u9700\u8981\u989c\u8272\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u4e0d\u9700\u8981\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u5c06\u989c\u8272\u7f13\u51b2\u533a\u8bbe\u7f6e\u4e3a GL_NONE \u3002 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); \u73b0\u5728\uff0c\u6211\u4eec\u51c6\u5907\u5728 Renderer \u7c7b\u4e2d\u5c06\u573a\u666f\u4ece\u706f\u5149\u900f\u89c6\u6e32\u67d3\u4e3aFBO\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u7ec4\u7279\u6b8a\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u3002 \u540d\u4e3a depth_vertex.vs \u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { gl_Position = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0f); } \u6211\u4eec\u5e0c\u671b\u63a5\u6536\u4e0e\u573a\u666f\u7740\u8272\u5668\u76f8\u540c\u7684\u8f93\u5165\u6570\u636e\u3002\u4f46\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5750\u6807\uff0c\u4f46\u662f\u4e3a\u4e86\u5c3d\u53ef\u80fd\u591a\u5730\u91cd\u7528\u4ee3\u7801\uff0c\u6211\u4eec\u8fd8\u662f\u8981\u4f20\u9001\u5176\u4ed6\u6570\u636e\u3002\u6211\u4eec\u8fd8\u9700\u8981\u4e00\u5bf9\u77e9\u9635\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u4ee5\u5149\u6e90\u7684\u89d2\u5ea6\u6e32\u67d3\u573a\u666f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u6a21\u578b\u8f6c\u6362\u5230\u5149\u6e90\u7684\u5750\u6807\u7a7a\u95f4\u3002\u8fd9\u662f\u901a\u8fc7 modelLightViewMatrix \u77e9\u9635\u5b8c\u6210\u7684\uff0c\u8be5\u77e9\u9635\u7c7b\u4f3c\u4e8e\u7528\u4e8e\u6444\u50cf\u673a\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u73b0\u5728\u5149\u6e90\u662f\u6211\u4eec\u7684\u6444\u50cf\u673a\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u5230\u5c4f\u5e55\u7a7a\u95f4\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u9700\u8981\u6295\u5f71\u5b83\u4eec\u3002\u8fd9\u662f\u8ba1\u7b97\u5e73\u884c\u5149\u4e0e\u70b9\u5149\u6e90\u7684\u9634\u5f71\u56fe\u65f6\u7684\u533a\u522b\u4e4b\u4e00\u3002\u5bf9\u4e8e\u5730\u6602\u626c\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u900f\u89c6\u6295\u5f71\uff08Perspective Projection\uff09\u77e9\u9635\uff0c\u5c31\u50cf\u6211\u4eec\u6b63\u5e38\u6e32\u67d3\u573a\u666f\u4e00\u6837\u3002\u76f8\u53cd\uff0c\u5e73\u884c\u5149\u4ee5\u76f8\u540c\u65b9\u5f0f\u5f71\u54cd\u6240\u6709\u5bf9\u8c61\uff0c\u800c\u4e0e\u8ddd\u79bb\u65e0\u5173\u3002\u5e73\u884c\u5149\u6e90\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u7684\u70b9\u4e0a\uff0c\u6ca1\u6709\u4f4d\u7f6e\uff0c\u53ea\u6709\u65b9\u5411\u3002\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u4e0d\u4f1a\u4f7f\u8fdc\u5904\u7684\u7269\u4f53\u53d8\u5c0f\uff0c\u56e0\u6b64\uff0c\u6b63\u4ea4\u6295\u5f71\u6700\u9002\u5408\u5e73\u884c\u5149\u3002 \u7247\u5143\u7740\u8272\u5668\u66f4\u7b80\u5355\u3002\u5b83\u53ea\u8f93\u51fa z \u5750\u6807\u4f5c\u4e3a\u6df1\u5ea6\u503c\u3002 #version 330 void main() { gl_FragDepth = gl_FragCoord.z; } \u5b9e\u9645\u4e0a\uff0c\u4f60\u53ef\u4ee5\u5220\u6389\u8be5\u884c\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u751f\u6210\u6df1\u5ea6\u503c\uff0c\u6df1\u5ea6\u503c\u5c06\u81ea\u52a8\u8fd4\u56de\u3002 \u4e00\u65e6\u6211\u4eec\u4e3a\u6df1\u5ea6\u6e32\u67d3\u5b9a\u4e49\u4e86\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u4e3a\u521d\u59cb\u5316\u8fd9\u4e9b\u7740\u8272\u5668\u5b9a\u4e49\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u540d\u4e3a setupDepthShader \uff0c\u5b83\u5c06\u5728\u5176\u4ed6\u7740\u8272\u5668\u88ab\u521d\u59cb\u5316\u65f6\u8c03\u7528\u3002 private void setupDepthShader() throws Exception { depthShaderProgram = new ShaderProgram(); depthShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/depth_vertex.vs\")); depthShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/depth_fragment.fs\")); depthShaderProgram.link(); depthShaderProgram.createUniform(\"orthoProjectionMatrix\"); depthShaderProgram.createUniform(\"modelLightViewMatrix\"); } \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528\u90a3\u4e9b\u540d\u4e3a renderDepthMap \u7684\u7740\u8272\u5668\u3002\u8be5\u65b9\u6cd5\u5c06\u5728\u4e3b\u6e32\u67d3\u65b9\u6cd5\u4e2d\u8c03\u7528\u3002 public void render(Window window, Camera camera, Scene scene, IHud hud) { clear(); // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe renderDepthMap(window, camera, scene); glViewport(0, 0, window.getWidth(), window.getHeight()); // \u5176\u4f59\u7684\u4ee3\u7801\u5728\u8fd9... \u5982\u679c\u4f60\u6d4f\u89c8\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\uff0c\u65b0\u65b9\u6cd5\u5c31\u5df2\u7ecf\u88ab\u8c03\u7528\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u65b0\u65b9\u6cd5\u5c06\u66f4\u9ad8\u89c6\u53e3\u4ee5\u5339\u914d\u4fdd\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5c3a\u5bf8\u3002\u56e0\u6b64\uff0c\u5728\u5b8c\u6210 renderDepthMap \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u59cb\u7ec8\u9700\u8981\u8bbe\u7f6e\u5c4f\u5e55\u5c3a\u5bf8\u7684\u89c6\u53e3\uff08\u4e0d\u68c0\u67e5\u7a97\u53e3\u662f\u5426\u5df2\u8c03\u6574\u5927\u5c0f\uff09\u3002 \u73b0\u5728\u8ba9\u6211\u4eec\u5b9a\u4e49\u4e00\u4e0b renderDepthMap \u65b9\u6cd5\u3002\u7b2c\u4e00\u4ef6\u4e8b\u662f\u7ed1\u5b9a\u5728 ShadowMap \u7c7b\u4e2d\u521b\u5efa\u7684FBO\uff0c\u5e76\u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5c3a\u5bf8\u3002 glBindFramebuffer(GL_FRAMEBUFFER, shadowMap.getDepthMapFBO()); glViewport(0, 0, ShadowMap.SHADOW_MAP_WIDTH, ShadowMap.SHADOW_MAP_HEIGHT); \u7136\u540e\uff0c\u6e05\u9664\u6df1\u5ea6\u7f13\u51b2\u533a\u5185\u5bb9\u5e76\u7ed1\u5b9a\u6df1\u5ea6\u7740\u8272\u5668\u3002\u56e0\u4e3a\u6211\u4eec\u53ea\u5904\u7406\u6df1\u5ea6\u503c\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6e05\u9664\u989c\u8272\u4fe1\u606f\u3002 glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); \u73b0\u5728\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u77e9\u9635\uff0c\u63a5\u4e0b\u6765\u662f\u68d8\u624b\u7684\u90e8\u5206\u3002\u6211\u4eec\u4f7f\u7528\u5149\u6e90\u4f5c\u4e3a\u6444\u50cf\u673a\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u9700\u8981\u4e00\u4e2a\u5750\u6807\u548c\u4e09\u4e2a\u89d2\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6b63\u5982\u672c\u7ae0\u5f00\u5934\u6240\u8bf4\uff0c\u6211\u4eec\u53ea\u5b9e\u73b0\u5e73\u884c\u5149\uff0c\u8fd9\u79cd\u7c7b\u578b\u7684\u5149\u4e0d\u5b9a\u4e49\u4f4d\u7f6e\uff0c\u800c\u662f\u5b9a\u4e49\u65b9\u5411\u3002\u5982\u679c\u6211\u4eec\u4f7f\u7528\u70b9\u5149\u6e90\uff0c\u8fd9\u5f88\u5bb9\u6613\uff0c\u5149\u6e90\u7684\u4f4d\u7f6e\u5c31\u662f\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u7f6e\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u4f4d\u7f6e\u3002 \u6211\u4eec\u5c06\u91c7\u7528\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u5149\u7684\u4f4d\u7f6e\u3002\u5e73\u884c\u5149\u662f\u7531\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u7684\uff0c\u901a\u5e38\u662f\u5f52\u4e00\u5316\u7684\uff0c\u5b83\u6307\u5411\u5149\u6e90\u6240\u5728\u7684\u65b9\u5411\u3002\u6211\u4eec\u628a\u8fd9\u4e2a\u65b9\u5411\u5411\u91cf\u4e58\u4ee5\u4e00\u4e2a\u53ef\u914d\u7f6e\u7684\u56e0\u5b50\uff0c\u5728\u8fd9\u6837\u5b83\u5c31\u4e3a\u8981\u7ed8\u5236\u7684\u573a\u666f\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5408\u7406\u8ddd\u79bb\u7684\u70b9\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u65b9\u5411\u6765\u8ba1\u7b97\u8be5\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u8fd9\u662f\u8ba1\u7b97\u706f\u5149\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u89d2\u5ea6\u7684\u4ee3\u7801\u7247\u6bb5\uff1a float lightAngleX = (float)Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float)Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Matrix4f lightViewMatrix = transformation.updateLightViewMatrix(new Vector3f(lightDirection).mul(light.getShadowPosMult()), new Vector3f(lightAngleX, lightAngleY, lightAngleZ)); \u63a5\u4e0b\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff1a Matrix4f orthoProjMatrix = transformation.updateOrthoProjectionMatrix(orthCoords.left, orthCoords.right, orthCoords.bottom, orthCoords.top, orthCoords.near, orthCoords.far); \u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86 Transformation \u7c7b\uff0c\u4ee5\u56ca\u62ec\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6b64\u4eec\u6709\u4e00\u4e2a\u6b63\u4ea4\u7684\u4e8c\u7ef4\u6295\u5f71\u77e9\u9635\uff0c\u6240\u4ee5\u6211\u4eec\u91cd\u547d\u540d\u4e86\u6b64\u524d\u7684\u65b9\u6cd5\u548c\u5c5e\u6027\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u5b9a\u4e49\u3002 \u7136\u540e\uff0c\u6211\u4eec\u6309\u7167 renderScene \u65b9\u6cd5\u6e32\u67d3\u573a\u666f\u5bf9\u8c61\uff0c\u4f46\u5728\u5149\u7167\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u4f7f\u7528\u4e0a\u8ff0\u77e9\u9635\u5de5\u4f5c\u3002 depthShaderProgram.setUniform(\"orthoProjectionMatrix\", orthoProjMatrix); Map<Mesh, List<GameItem>> mapMeshes = scene.getGameMeshes(); for (Mesh mesh : mapMeshes.keySet()) { mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelLightViewMatrix = transformation.buildModelViewMatrix(gameItem, lightViewMatrix); depthShaderProgram.setUniform(\"modelLightViewMatrix\", modelLightViewMatrix); } ); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); \u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u662f\u5728\u5e73\u884c\u5149\u4e2d\u5b9a\u4e49\u7684\u3002\u5c06\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u4e3a\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5176\u4e2d\u5305\u542b\u6211\u4eec\u8981\u6e32\u67d3\u7684\u6240\u6709\u5bf9\u8c61\u3002\u5f53\u53ea\u6295\u5f71\u9002\u5408\u8be5\u8fb9\u754c\u6846\u7684\u5bf9\u8c61\u65f6\uff0c\u5bf9\u8c61\u5c06\u53ef\u89c6\u3002\u8be5\u8fb9\u754c\u6846\u75316\u4e2a\u53c2\u6570\u5b9a\u4e49\uff1a\u5de6\u3001\u53f3\u3001\u4e0a\u3001\u4e0b\u3001\u8fd1\u3001\u8fdc\u3002\u7531\u4e8e\u5149\u6e90\u4f4d\u7f6e\u73b0\u5728\u662f\u539f\u70b9\uff0c\u56e0\u6b64\u8fd9\u4e9b\u53c2\u6570\u5b9a\u4e49\u4e3a\u539f\u70b9\u5230\u5de6\u6216\u53f3\uff08x\u8f74\uff09\u6216\u4e0a\u6216\u4e0b\uff08y\u8f74\uff09\u6216\u8fdc\u6216\u8fd1\uff08z\u8f74\uff09\u7684\u8ddd\u79bb\u3002 \u8981\u4f7f\u9634\u5f71\u56fe\u6b63\u5e38\u5de5\u4f5c\uff0c\u6700\u68d8\u624b\u7684\u4e00\u70b9\u662f\u786e\u5b9a\u706f\u5149\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u3002\u8fd9\u5c31\u662f\u6240\u6709\u8fd9\u4e9b\u53c2\u6570\u73b0\u5728\u5728 DirectionalLight \u7c7b\u4e2d\u5b9a\u4e49\u7684\u65b9\u5f0f\uff0c\u56e0\u6b64\u53ef\u4ee5\u6839\u636e\u6bcf\u4e2a\u573a\u666f\u6b63\u786e\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002 \u4f60\u53ef\u4ee5\u5b9e\u73b0\u4e00\u4e2a\u66f4\u81ea\u52a8\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u8ba1\u7b97\u6444\u50cf\u673a\u622a\u9525\uff08Frustum\uff09\u7684\u4e2d\u5fc3\uff0c\u56de\u5230\u5149\u7684\u65b9\u5411\uff0c\u5efa\u7acb\u4e00\u4e2a\u5305\u542b\u573a\u666f\u4e2d\u6240\u6709\u5bf9\u8c61\u7684\u6b63\u4ea4\u6295\u5f71\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5982\u4e0a\u6240\u8ff0\u7684\u4e09\u7ef4\u573a\u666f\u3001\u76f8\u673a\u4f4d\u7f6e\u3001\u622a\u9525\uff08\u84dd\u8272\uff09\u3001\u6700\u4f73\u5149\u6e90\u4f4d\u7f6e\u4ee5\u53ca\u7ea2\u8272\u7684\u8fb9\u754c\u6846\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5f88\u96be\u8ba1\u7b97\uff0c\u5982\u679c\u4f60\u6709\u5f88\u5c0f\u7684\u7269\u4f53\uff0c\u5e76\u4e14\u8fb9\u754c\u6846\u5f88\u5927\uff0c\u4f60\u53ef\u4ee5\u4f1a\u5f97\u5230\u5947\u602a\u7684\u7ed3\u679c\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u65b9\u6cd5\u5bf9\u4e8e\u5c0f\u573a\u666f\u66f4\u7b80\u5355\uff0c\u4f60\u53ef\u4ee5\u8c03\u6574\u5b83\u4ee5\u5339\u914d\u4f60\u7684\u6a21\u578b\uff08\u5373\u4f7f\u4f60\u53ef\u4ee5\u9009\u62e9\u663e\u5f0f\u8bbe\u7f6e\u706f\u5149\u7684\u4f4d\u7f6e\uff0c\u4ee5\u907f\u514d\u76f8\u673a\u8fdc\u79bb\u539f\u70b9\u79fb\u52a8\u65f6\u4ea7\u751f\u5947\u602a\u7684\u6548\u679c\uff09\u3002\u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u901a\u7528\u7684\u6a21\u677f\uff0c\u53ef\u4ee5\u5e94\u7528\u5230\u4efb\u4f55\u573a\u666f\uff0c\u4f60\u5e94\u8be5\u6269\u5c55\u5b83\uff0c\u4ee5\u652f\u6301\u5c42\u53e0\u9634\u5f71\u56fe\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u3002\u5728\u4f7f\u7528\u6df1\u5ea6\u56fe\u5b9e\u9645\u8ba1\u7b97\u9634\u5f71\u4e4b\u524d\uff0c\u53ef\u4ee5\u4f7f\u7528\u751f\u6210\u7684\u7eb9\u7406\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4ee5\u89c2\u5bdf\u6df1\u5ea6\u56fe\u7684\u5b9e\u9645\u5916\u89c2\u3002\u5728\u6709\u4e00\u4e2a\u65cb\u8f6c\u7acb\u65b9\u4f53\u6f02\u6d6e\u5728\u4e00\u4e2a\u6709\u5782\u76f4\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u7684\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u989c\u8272\u8d8a\u6df1\uff0c\u79bb\u5149\u6e90\u7684\u4f4d\u7f6e\u8d8a\u8fd1\u3002\u6df1\u5ea6\u56fe\u4e2d\u5149\u6e90\u4f4d\u7f6e\u7684\u5f71\u54cd\u662f\u4ec0\u4e48\uff1f\u4f60\u53ef\u4ee5\u4fee\u6539\u5e73\u884c\u5149\u7167\u7684\u500d\u589e\u56e0\u5b50\uff0c\u5c06\u770b\u5230\u5728\u7eb9\u7406\u4e2d\u6e32\u67d3\u7684\u5bf9\u8c61\u7684\u5927\u5c0f\u4e0d\u4f1a\u53d8\u5c0f\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u7269\u4f53\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u589e\u5927\u800c\u53d8\u5c0f\u3002\u4f60\u5c06\u770b\u5230\u7684\u662f\uff0c\u6240\u6709\u7684\u989c\u8272\u90fd\u4f1a\u53d8\u5f97\u66f4\u4eae\uff0c\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u662f\u5426\u610f\u5473\u7740\u6211\u4eec\u53ef\u4ee5\u4e3a\u5149\u6e90\u9009\u62e9\u4e00\u4e2a\u8f83\u8fdc\u7684\u4f4d\u7f6e\u800c\u4e0d\u9020\u6210\u4efb\u4f55\u540e\u679c\u5462\uff1f\u7b54\u6848\u662f\u4e0d\u884c\u3002\u5982\u679c\u5149\u6e90\u79bb\u6211\u4eec\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u592a\u8fdc\uff0c\u8fd9\u4e9b\u5bf9\u8c61\u4f1a\u8d85\u51fa\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u767d\u8272\u7eb9\u7406\uff0c\u4f46\u8fd9\u662f\u6ca1\u7528\u7684\u9634\u5f71\u56fe\u3002\u597d\u7684\uff0c\u90a3\u4e48\u6211\u4eec\u53ea\u9700\u589e\u52a0\u8fb9\u754c\u6846\u7684\u5927\u5c0f\uff0c\u4e00\u5207\u90fd\u4f1a\u597d\u7684\uff0c\u5bf9\u5417\uff1f\u7b54\u6848\u4e5f\u662f\u4e0d\u884c\u3002\u5982\u679c\u4f60\u4e3a\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u9009\u7528\u4e86\u5de8\u5927\u7684\u5c3a\u5bf8\uff0c\u4f60\u7684\u7269\u4f53\u5728\u7eb9\u7406\u4e2d\u4f1a\u88ab\u7ed8\u5236\u5f97\u5f88\u5c0f\uff0c\u6df1\u5ea6\u503c\u751a\u81f3\u4f1a\u91cd\u53e0\uff0c\u9020\u6210\u5947\u602a\u7684\u7ed3\u679c\u3002\u597d\u5427\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u8003\u8651\u589e\u52a0\u7eb9\u7406\u5927\u5c0f\uff0c\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u662f\u6709\u9650\u5236\u7684\uff0c\u7eb9\u7406\u4e0d\u80fd\u56e0\u4f7f\u7528\u5de8\u5927\u7684\u7f16\u8f91\u6846\u800c\u65e0\u9650\u589e\u5927\u3002 \u56e0\u6b64\uff0c\u53ef\u4ee5\u770b\u5230\uff0c\u9009\u62e9\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u7684\u53c2\u6570\u662f\u4e00\u4e2a\u590d\u6742\u7684\u5e73\u8861\uff0c\u8fd9\u4f7f\u5f97\u4f7f\u7528\u9634\u5f71\u56fe\u5f88\u96be\u5f97\u5230\u6b63\u786e\u7684\u6548\u679c\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u6e32\u67d3\u8fc7\u7a0b\uff0c\u4e00\u65e6\u8ba1\u7b97\u4e86\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728\u6e32\u67d3\u573a\u666f\u65f6\u4f7f\u7528\u5b83\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528\u900f\u89c6\u77e9\u9635\u5c06\u9876\u70b9\u5750\u6807\u4ece\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u3002\u73b0\u5728\u8fd8\u9700\u8981\u4f7f\u7528\u6295\u5f71\u77e9\u9635\u4ece\u5149\u7167\u7a7a\u95f4\u5750\u6807\u6295\u5f71\u9876\u70b9\u5750\u6807\uff0c\u4ee5\u7528\u4e8e\u7247\u5143\u7740\u8272\u5668\u4e2d\u8ba1\u7b97\u9634\u5f71\u3002 \u9876\u70b9\u7740\u8272\u5668\u662f\u8fd9\u6837\u4fee\u6539\u7684\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6211\u4eec\u4e3a\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4f7f\u7528\u4e86\u65b0\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u9634\u5f71\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a float calcShadow(vec4 position) { float shadowFactor = 1.0; vec3 projCoords = position.xyz; // \u4ece\u5c4f\u5e55\u5750\u6807\u53d8\u6362\u5230\u7eb9\u7406\u5750\u6807 projCoords = projCoords * 0.5 + 0.5; if ( projCoords.z < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } return 1 - shadowFactor; } \u8be5\u51fd\u6570\u63a5\u6536\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u6295\u5f71\u7684\u5149\u7167\u89c2\u5bdf\u7a7a\u95f4\u7684\u5750\u6807\u3002\u5982\u679c\u5750\u6807\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 0 \uff0c\u5982\u679c\u4e0d\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 1 \u3002\u9996\u5148\uff0c\u5c06\u5750\u6807\u8f6c\u6362\u4e3a\u7eb9\u7406\u5750\u6807\u3002\u5c4f\u5e55\u5750\u6807\u5728 [-1, 1] \u8303\u56f4\u5185\uff0c\u4f46\u7eb9\u7406\u5750\u6807\u5728 [0, 1] \u8303\u56f4\u5185\u3002\u6211\u4eec\u901a\u8fc7\u5750\u6807\u4ece\u7eb9\u7406\u4e2d\u83b7\u53d6\u6df1\u5ea6\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u7247\u5143\u5750\u6807\u7684 z \u503c\u6bd4\u8f83\u3002\u5982\u679c z \u503c\u4f4e\u4e8e\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\u7684\u503c\uff0c\u5219\u8868\u793a\u7247\u5143\u4e0d\u518d\u9634\u5f71\u4e2d\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c calcShadow \u51fd\u6570\u7684\u8fd4\u56de\u503c\uff0c\u7528\u4e8e\u8c03\u8282\u70b9\u5149\u6e90\u3001\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\u5bf9\u5149\u7167\u989c\u8272\u7684\u5171\u4eab\u3002\u73af\u5883\u5149\u4e0d\u53d7\u9634\u5f71\u7684\u5f71\u54cd\u3002 float shadow = calcShadow(mlightviewVertexPos); fragColor = clamp(ambientC * vec4(ambientLight, 1) + diffuseSpecularComp * shadow, 0, 1); \u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u6b63\u4ea4\u6295\u5f71\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5230Uniform\uff08\u6211\u4eec\u8fd8\u9700\u8981\u4fee\u6539\u7740\u8272\u5668\u7684\u521d\u59cb\u5316\u65b9\u6cd5\u4ee5\u521b\u5efa\u65b0\u7684Uniform\uff09\u3002\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u3002 \u5982\u679c\u8fd0\u884c DummyGame \u7c7b\uff0c\u8be5\u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u5728\u5e26\u6709\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u8bbe\u7f6e\u6709\u60ac\u6d6e\u7684\u7acb\u65b9\u4f53\uff0c\u5e76\u53ef\u4f7f\u7528\u4e0a\u4e0b\u952e\u4fee\u6539\u89d2\u5ea6\uff0c\u5219\u5e94\u8be5\u770b\u5230\u5982\u4e0b\u60c5\u51b5\u3002 \u867d\u7136\u9634\u5f71\u5df2\u7ecf\u5de5\u4f5c\u4e86\uff08\u4f60\u53ef\u4ee5\u901a\u8fc7\u79fb\u52a8\u5149\u7167\u65b9\u5411\u6765\u68c0\u67e5\uff09\uff0c\u4f46\u662f\u5b9e\u9645\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u88ab\u7167\u4eae\u7684\u7269\u4f53\u4e2d\u6709\u5947\u602a\u7684\u7ebf\u6761\u3002\u8fd9\u79cd\u60c5\u51b5\u88ab\u79f0\u4e3a\u9634\u5f71\u5931\u771f\uff08Shadow Acne\uff09\uff0c\u5b83\u662f\u7531\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5206\u8fa8\u7387\u6709\u9650\u9020\u6210\u7684\u3002\u7b2c\u4e8c\u4e2a\u95ee\u9898\u662f\uff0c\u9634\u5f71\u7684\u8fb9\u754c\u4e0d\u5e73\u6ed1\uff0c\u770b\u8d77\u6765\u5f88\u7c97\u7cd9\u3002\u539f\u56e0\u540c\u6837\uff0c\u7eb9\u7406\u5206\u8fa8\u7387\u3002\u6211\u4eec\u5c06\u89e3\u51b3\u8fd9\u4e9b\u95ee\u9898\uff0c\u4ee5\u63d0\u9ad8\u9634\u5f71\u8d28\u91cf\u3002 \u6539\u8fdb\u9634\u5f71\u6620\u5c04 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u9634\u5f71\u6620\u5c04\u673a\u5236\uff0c\u90a3\u4e48\u8ba9\u6211\u4eec\u6765\u89e3\u51b3\u73b0\u6709\u7684\u95ee\u9898\u3002\u6211\u4eec\u5148\u4ece\u5931\u771f\u95ee\u9898\u5f00\u59cb\u3002\u6df1\u5ea6\u56fe\u7eb9\u7406\u5927\u5c0f\u6709\u9650\uff0c\u56e0\u6b64\uff0c\u53ef\u4ee5\u5c06\u591a\u4e2a\u7247\u5143\u6620\u5c04\u5230\u8be5\u7eb9\u7406\u6df1\u5ea6\u4e2d\u7684\u540c\u4e00\u50cf\u7d20\u3002\u7eb9\u7406\u6df1\u5ea6\u50a8\u5b58\u6700\u5c0f\u6df1\u5ea6\uff0c\u56e0\u6b64\u5230\u6700\u540e\uff0c\u6211\u4eec\u6709\u51e0\u4e2a\u7247\u5143\u5171\u4eab\u76f8\u540c\u7684\u6df1\u5ea6\uff0c\u5c3d\u7ba1\u5b83\u4eec\u7684\u8ddd\u79bb\u4e0d\u540c\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u7247\u5143\u7740\u8272\u5668\u4e2d\u7684\u6df1\u5ea6\u6bd4\u8f83\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u504f\u79fb\u3002 float bias = 0.05; if ( projCoords.z - bias < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } \u73b0\u5728\uff0c\u9634\u5f71\u5931\u771f\u6d88\u5931\u4e86\u3002 \u8bd1\u8005\u6ce8\uff1a\u4f7f\u7528\u504f\u79fb\u6765\u6d88\u9664\u9634\u5f71\u5931\u771f\u53c8\u4f1a\u9020\u6210\u60ac\u6d6e\uff08Peter Panning\uff09\u95ee\u9898\uff0c\u53e6\u8bf7\u53c2\u9605 LearnOpenGL\u9634\u5f71\u6620\u5c04 \u4e00\u6587\u3002 \u73b0\u5728\u6211\u4eec\u8981\u89e3\u51b3\u7684\u662f\u53bb\u9634\u5f71\u8fb9\u7f18\u95ee\u9898\uff0c\u8fd9\u4e5f\u662f\u7531\u7eb9\u7406\u5206\u8fa8\u7387\u5f15\u8d77\u7684\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7247\u5143\u7684\u5750\u6807\u503c\u548c\u5468\u56f4\u7684\u503c\u5bf9\u6df1\u5ea6\u56fe\u8fdb\u884c\u91c7\u6837\u3002\u7136\u540e\u6211\u4eec\u5c06\u8ba1\u7b97\u5e73\u5747\u503c\u5e76\u5c06\u8be5\u503c\u6307\u5b9a\u4e3a\u9634\u5f71\u503c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5b83\u7684\u503c\u4e0d\u4f1a\u662f 0 \u548c 1 \u4f46\u53ef\u4ee5\u5728\u4e24\u8005\u95f4\u53d6\u503c\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u8fb9\u7f18\u3002 \u5728\u7eb9\u7406\u5750\u6807\u4e2d\uff0c\u5468\u56f4\u503c\u5fc5\u987b\u4e0e\u5f53\u524d\u7247\u5143\u4f4d\u7f6e\u4fdd\u6301\u4e00\u4e2a\u50cf\u7d20\u8ddd\u79bb\u3002\u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u4e2d\u4e00\u4e2a\u50cf\u7d20\u7684\u589e\u91cf\uff0c\u5b83\u7b49\u4e8e 1 / \u7eb9\u7406\u5927\u5c0f \u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u9634\u5f71\u94f6\u5b50\u7684\u8ba1\u7b97\u6765\u5f97\u5230\u4e00\u4e2a\u5e73\u5747\u503c\u3002 float shadowFactor = 0.0; vec2 inc = 1.0 / textureSize(shadowMap, 0); for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth = texture(shadowMap, projCoords.xy + vec2(row, col) * inc).r; shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; \u73b0\u5728\u7ed3\u679c\u770b\u8d77\u6765\u66f4\u5e73\u6ed1\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u7684\u793a\u4f8b\u770b\u8d77\u6765\u597d\u591a\u4e86\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u91cc\u4ecb\u7ecd\u7684\u9634\u5f71\u6620\u5c04\u6280\u672f\u4ecd\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u89e3\u51b3\u60ac\u6d6e\uff08Peter Panning\uff09\u6548\u679c\uff08\u56e0\u504f\u79fb\u5f15\u8d77\uff09\u548c\u5176\u4ed6\u6539\u8fdb\u9634\u5f71\u8fb9\u7f18\u7684\u8ba1\u7b97\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u6709\u4e86\u8fd9\u91cc\u6240\u8bb2\u89e3\u7684\u6982\u5ff5\uff0c\u4f60\u5c31\u6709\u4e86\u5f00\u59cb\u4fee\u6539\u793a\u4f8b\u7684\u826f\u597d\u57fa\u7840\u3002 \u4e3a\u4e86\u6e32\u67d3\u591a\u4e2a\u5149\u6e90\uff0c\u4f60\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u5149\u6e90\u6e32\u67d3\u4e00\u4e2a\u6df1\u5ea6\u56fe\u3002\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u4f60\u9700\u8981\u91c7\u6837\u6240\u6709\u7684\u6df1\u5ea6\u56fe\u6765\u8ba1\u7b97\u5408\u9002\u7684\u9634\u5f71\u7cfb\u6570\u3002","title":"\u9634\u5f71"},{"location":"18-shadows/#shadows","text":"","title":"\u9634\u5f71\uff08Shadows\uff09"},{"location":"18-shadows/#_1","text":"\u76ee\u524d\uff0c\u6211\u4eec\u80fd\u591f\u8868\u73b0\u5149\u7ebf\u5982\u4f55\u5f71\u54cd\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5bf9\u8c61\u3002\u63a5\u6536\u5230\u66f4\u591a\u5149\u7684\u7269\u4f53\u6bd4\u6ca1\u6709\u63a5\u6536\u5149\u7684\u7269\u4f53\u66f4\u4eae\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u65e0\u6cd5\u6295\u5c04\u9634\u5f71\u3002\u9634\u5f71\u80fd\u589e\u52a03D\u573a\u666f\u7684\u771f\u5b9e\u5ea6\uff0c\u56e0\u6b64\u6211\u4eec\u5c06\u5728\u672c\u7ae0\u4e2d\u6dfb\u52a0\u5bf9\u5b83\u7684\u652f\u6301\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u88ab\u79f0\u4e3a\u9634\u5f71\u6620\u5c04\uff08Shadow Mapping\uff09\u7684\u6280\u672f\uff0c\u8fd9\u79cd\u6280\u672f\u88ab\u5e7f\u6cdb\u4f7f\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u4e14\u4e0d\u4f1a\u4e25\u91cd\u5f71\u54cd\u5f15\u64ce\u6027\u80fd\u3002\u9634\u5f71\u6620\u5c04\u770b\u8d77\u6765\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u5f88\u96be\u6b63\u786e\u5730\u5b9e\u73b0\u5b83\u3002\u6216\u8005\u66f4\u51c6\u786e\u5730\u8bf4\uff0c\u5f88\u96be\u7528\u4e00\u79cd\u901a\u7528\u7684\uff0c\u6db5\u76d6\u4e86\u4e00\u5207\u53ef\u80fd\u5e76\u4ea7\u751f\u4e00\u81f4\u7684\u6548\u679c\u7684\u65b9\u6cd5\u53bb\u5b9e\u73b0\u5b83\u3002 \u6211\u4eec\u5c06\u5728\u6b64\u8bf4\u660e\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ef\u4ee5\u4e3a\u4f60\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u6dfb\u52a0\u9634\u5f71\uff0c\u4f46\u66f4\u91cd\u8981\u7684\u662f\uff0c\u5b83\u5c06\u5e2e\u52a9\u4f60\u4e86\u89e3\u5176\u5c40\u9650\u6027\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u4ee3\u7801\u8fdc\u4e0d\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5f88\u5bb9\u6613\u7406\u89e3\u3002\u5b83\u8fd8\u88ab\u8bbe\u8ba1\u7528\u4e8e\u652f\u6301\u6709\u5411\u5149\uff08\u8fd9\u6211\u8ba4\u4e3a\u662f\u66f4\u590d\u6742\u7684\u60c5\u51b5\uff09\uff0c\u4f46\u4f60\u5c06\u4e86\u89e3\u5982\u4f55\u5c06\u5176\u6269\u5c55\u4ee5\u652f\u6301\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u7167\uff08\u4f8b\u5982\u70b9\u5149\u6e90\uff09\u3002\u5982\u679c\u60f3\u83b7\u5f97\u66f4\u9ad8\u7ea7\u7684\u6548\u679c\uff0c\u4f60\u5e94\u8be5\u4f7f\u7528\u66f4\u9ad8\u7ea7\u7684\u6280\u672f\uff0c\u4f8b\u5982\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u8fd9\u91cc\u89e3\u91ca\u7684\u6982\u5ff5\u90fd\u4ec5\u4ec5\u4f5c\u4e3a\u57fa\u7840\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u4ece\u601d\u8003\u5982\u4f55\u68c0\u67e5\u7279\u5b9a\u533a\u57df\uff08\u5b9e\u9645\u4e0a\u662f\u7247\u5143\uff09\u662f\u5426\u5728\u9634\u5f71\u4e2d\u5f00\u59cb\u3002\u5728\u7ed8\u5236\u8fd9\u4e2a\u533a\u57df\u7684\u65f6\u5019\uff0c\u6211\u4eec\u53ef\u4ee5\u53d1\u51fa\u5c04\u7ebf\u6295\u5c04\u5230\u5149\u6e90\u4e0a\uff0c\u5982\u679c\u6211\u4eec\u53ef\u4ee5\u5728\u4e0d\u53d1\u751f\u4efb\u4f55\u78b0\u649e\u7684\u60c5\u51b5\u4e0b\u5230\u8fbe\u5149\u6e90\uff0c\u90a3\u4e48\u50cf\u7d20\u5c31\u5728\u5149\u7167\u4e2d\uff0c\u53cd\u4e4b\uff0c\u50cf\u7d20\u5904\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u70b9\u5149\u6e90\u7684\u60c5\u51b5\uff0c\u70b9PA\u53ef\u4ee5\u5230\u8fbe\u5149\u6e90\uff0c\u4f46\u70b9PB\u548cPC\u4e0d\u884c\uff0c\u56e0\u6b64\u5b83\u4eec\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5982\u4f55\u624d\u80fd\u68c0\u67e5\u662f\u5426\u80fd\u4ee5\u4e00\u79cd\u6709\u6548\u7684\u65b9\u5f0f\u53d1\u5c04\u51fa\u4e0d\u53d1\u751f\u78b0\u649e\u7684\u5c04\u7ebf\u5462\uff1f\u7406\u8bba\u4e0a\uff0c\u5149\u6e90\u53ef\u4ee5\u6295\u5c04\u51fa\u65e0\u9650\u7684\u5149\u7ebf\uff0cName\u6211\u4eec\u5982\u4f55\u68c0\u67e5\u5149\u7ebf\u662f\u5426\u88ab\u906e\u6321\uff1f \u6211\u4eec\u80fd\u505a\u7684\u4e0d\u662f\u6295\u5c04\u5149\u7ebf\uff0c\u800c\u662f\u4ece\u5149\u7ebf\u900f\u89c6\u56fe\u4e2d\u89c2\u5bdf3D\u573a\u666f\uff0c\u5e76\u4ece\u8be5\u4f4d\u7f6e\u6e32\u67d3\u573a\u666f\u3002\u6211\u4eec\u53ef\u4ee5\u5c06\u76f8\u673a\u8bbe\u7f6e\u5728\u5149\u6e90\u4f4d\u7f6e\u5e76\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u50a8\u5b58\u6bcf\u4e2a\u7247\u5143\u7684\u6df1\u5ea6\u3002\u8fd9\u76f8\u5f53\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u6700\u540e\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u5c06\u5149\u7167\u6240\u53ca\u7684\u6700\u5c0f\u8ddd\u79bb\u50a8\u5b58\u4e3a\u9634\u5f71\u56fe\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u60ac\u6d6e\u5728\u5e73\u9762\u4e0a\u5e76\u5782\u76f4\u4e8e\u5149\u7ebf\u7684\u7acb\u65b9\u4f53\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u770b\uff0c\u60c5\u51b5\u662f\u8fd9\u6837\u7684\uff08\u989c\u8272\u8d8a\u6df1\uff0c\u8d8a\u63a5\u8fd1\u5149\u6e90\uff09\u3002 \u5229\u7528\u8fd9\u4e9b\u4fe1\u606f\u3002\u6211\u4eec\u53ef\u4ee5\u50cf\u5f80\u5e38\u4e00\u6837\u6e32\u67d33D\u573a\u666f\uff0c\u5e76\u4ee5\u6700\u5c0f\u50a8\u5b58\u8ddd\u79bb\u68c0\u67e5\u6bcf\u4e2a\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u5982\u679c\u8ddd\u79bb\u5c0f\u4e8e\u9634\u5f71\u8d34\u56fe\u4e2d\u50a8\u5b58\u7684\u503c\uff0c\u5219\u5bf9\u8c61\u4f4d\u4e8e\u5149\u7167\u4e2d\uff0c\u5426\u5219\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002\u6211\u4eec\u53ef\u4ee5\u8ba9\u51e0\u4e2a\u7269\u4f53\u88ab\u540c\u4e00\u5149\u7167\u7167\u5c04\uff0c\u4f46\u6211\u4eec\u50a8\u5b58\u6700\u5c0f\u8ddd\u79bb\u3002 \u56e0\u6b64\uff0c\u9634\u5f71\u6620\u5c04\u5206\u4e3a\u4e24\u6b65\uff1a \u9996\u5148\uff0c\u6211\u4eec\u5c06\u573a\u666f\u4ece\u5149\u7167\u7a7a\u95f4\u6e32\u67d3\u4e3a\u9634\u5f71\u56fe\uff0c\u4ee5\u83b7\u5f97\u6700\u5c0f\u8ddd\u79bb\u3002 \u5176\u6b21\uff0c\u6211\u4eec\u4ece\u6444\u50cf\u673a\u7684\u89c6\u89d2\u6e32\u67d3\u573a\u666f\u3002\u5e76\u4f7f\u7528\u6df1\u5ea6\u56fe\u8ba1\u7b97\u5bf9\u8c61\u662f\u5426\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e3a\u4e86\u6e32\u67d3\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u9700\u8981\u8bf4\u8bf4\u6df1\u5ea6\u7f13\u51b2\u533a\uff08Depth-buffer\uff09\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u65f6\uff0c\u6240\u6709\u6df1\u5ea6\u4fe1\u606f\u90fd\u50a8\u5b58\u5728\u4e00\u4e2a\u540d\u4e3a\u201c\u6df1\u5ea6\u7f13\u51b2\u533a\u201d\uff08\u53c8\u79f0\u201cZ\u7f13\u51b2\u533a\uff08Z-buffer\uff09\u201d\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u6df1\u5ea6\u4fe1\u606f\u662f\u6e32\u67d3\u7684\u6bcf\u4e2a\u7247\u5143\u7684 z \u503c\u3002\u5982\u679c\u4f60\u4ece\u7b2c\u4e00\u7ae0\u56de\u5fc6\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u5c06\u6b63\u5728\u6e32\u67d3\u7684\u573a\u666f\u4ece\u4e16\u754c\u5750\u6807\u8f6c\u6362\u4e3a\u5c4f\u5e55\u5750\u6807\u3002\u6211\u4eec\u6240\u7ed8\u5236\u7684\u5750\u6807\u7a7a\u95f4\uff0c\u5bf9\u4e8e x \u548c y \u8f74\u6765\u8bf4\uff0c\u5750\u6807\u7684\u8303\u56f4\u4e3a 0 \u5230 1 \u3002\u5982\u679c\u4e00\u4e2a\u7269\u4f53\u6bd4\u5176\u4ed6\u5bf9\u8c61\u539f\uff0c\u6211\u4eec\u5fc5\u987b\u901a\u8fc7\u900f\u89c6\u6295\u5f71\u77e9\u9635\u8ba1\u7b97\u5b83\u5982\u4f55\u5f71\u54cd\u5176 x \u548c y \u5750\u6807\u3002\u8fd9\u4e0d\u662f\u6839\u636e z \u503c\u81ea\u52a8\u8ba1\u7b97\u7684\uff0c\u5b83\u5fc5\u987b\u7531\u6211\u4eec\u6765\u505a\u3002\u5b9e\u9645\u50a8\u5b58\u5728 z \u5750\u6807\u4e2d\u7684\u662f\u5b83\u5728\u7247\u5143\u7684\u6df1\u5ea6\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6b64\u5916\uff0c\u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u5982\u4e0b\u884c\uff1a glEnable(GL_DEPTH_TEST); \u901a\u8fc7\u6dfb\u52a0\u8fd9\u884c\uff0c\u6211\u4eec\u53ef\u4ee5\u9632\u6b62\u65e0\u6cd5\u770b\u5230\u7684\u7247\u5143\u88ab\u7ed8\u5236\u51fa\u6765\uff0c\u56e0\u4e3a\u4ed6\u4eec\u4f4d\u4e8e\u5176\u4ed6\u5bf9\u8c61\u4e4b\u540e\u3002\u5728\u7ed8\u5236\u7247\u5143\u4e4b\u524d\uff0c\u5b83\u7684 z \u503c\u5c06\u4e0eZ\u7f13\u51b2\u533a\u4e2d\u7684 z \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u5b83\u7684 z \u503c\uff08\u5b83\u7684\u8ddd\u79bb\uff09\u5927\u4e8e\u7f13\u51b2\u533a\u7684 z \u503c\uff0c\u5219\u4f1a\u88ab\u4e22\u5f03\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u5728\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u5b8c\u6210\u7684\uff0c\u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u5bf9\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u8303\u56f4\u4e3a [0, 1] \u7684 x \u548c y \u5750\u6807\uff0c\u6211\u4eec\u6bd4\u8f83\u5176\u7247\u5143\u7684 z \u503c\u3002\u540c\u6837\uff0c z \u503c\u4e5f\u5728\u6b64\u8303\u56f4\u5185\u3002 \u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u5b58\u5728\u662f\u6211\u4eec\u5728\u6267\u884c\u4efb\u4f55\u6e32\u67d3\u64cd\u4f5c\u4e4b\u524d\u9700\u8981\u6e05\u9664\u5c4f\u5e55\u7684\u539f\u56e0\u3002\u6211\u4eec\u4e0d\u4ec5\u9700\u8981\u6e05\u9664\u989c\u8272\uff0c\u8fd8\u8981\u6e05\u9664\u6df1\u5ea6\u4fe1\u606f\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u4e3a\u4e86\u5f00\u59cb\u6784\u5efa\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5e0c\u671b\u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u83b7\u5f97\u6df1\u5ea6\u4fe1\u606f\u3002\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u4f4d\u7f6e\u8bbe\u7f6e\u4e00\u4e2a\u6444\u50cf\u5934\uff0c\u6e32\u67d3\u573a\u666f\u5e76\u5c06\u6df1\u5ea6\u4fe1\u606f\u50a8\u5b58\u5230\u7eb9\u7406\u4e2d\uff0c\u4ee5\u4fbf\u7a0d\u540e\u8bbf\u95ee\u5b83\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u7684\u662f\u6dfb\u52a0\u5bf9\u521b\u5efa\u8fd9\u4e9b\u7eb9\u7406\u7684\u652f\u6301\u3002\u6211\u4eec\u5c06\u4fee\u6539 Texture \u7c7b\uff0c\u901a\u8fc7\u6dfb\u52a0\u65b0\u7684\u6784\u9020\u51fd\u6570\u6765\u652f\u6301\u521b\u5efa\u7a7a\u7eb9\u7406\u3002\u6b64\u6784\u9020\u51fd\u6570\u9700\u8981\u7eb9\u7406\u7684\u5c3a\u5bf8\u4ee5\u53ca\u5b83\u50a8\u5b58\u7684\u50cf\u7d20\u7684\u683c\u5f0f\u3002 public Texture(int width, int height, int pixelFormat) throws Exception { this.id = glGenTextures(); this.width = width; this.height = height; glBindTexture(GL_TEXTURE_2D, this.id); glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT, this.width, this.height, 0, pixelFormat, GL_FLOAT, (ByteBuffer) null); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); } \u6211\u4eec\u5c06\u7eb9\u7406\u73af\u7ed5\u65b9\u5f0f\u8bbe\u7f6e\u4e3a GL_CLAMP_TO_EDGE \uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u5e0c\u671b\u5728\u8d85\u51fa [0, 1] \u8303\u56f4\u65f6\u91cd\u590d\u7eb9\u7406\u3002 \u6240\u4ee5\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u7a7a\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u5176\u4e2d\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5e27\u7f13\u51b2\u533a\u5bf9\u8c61\uff08Frame Buffers Objects\uff0c\u6216\u79f0FBOs\uff09\u3002\u5e27\u7f13\u51b2\u533a\u662f\u53ef\u4ee5\u4f5c\u4e3a\u6e32\u67d3\u7ec8\u70b9\u7684\u7f13\u51b2\u533a\u96c6\u5408\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL\u7684\u9ed8\u8ba4\u7f13\u51b2\u533a\u3002OpenGL\u5141\u8bb8\u6211\u4eec\u4f7f\u7528FBO\u6e32\u67d3\u5230\u7528\u6237\u5b9a\u4e49\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a ShadowMap \u7684\u65b0\u7c7b\uff0c\u6765\u9694\u79bb\u4e3a\u9634\u5f71\u6620\u5c04\u521b\u5efaFBO\u8fc7\u7a0b\u7684\u5176\u4f59\u4ee3\u7801\u3002\u5982\u4e0b\u5c31\u662f\u90a3\u4e2a\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class ShadowMap { public static final int SHADOW_MAP_WIDTH = 1024; public static final int SHADOW_MAP_HEIGHT = 1024; private final int depthMapFBO; private final Texture depthMap; public ShadowMap() throws Exception { // \u521b\u5efaFBO\u4ee5\u6e32\u67d3\u6df1\u5ea6\u56fe depthMapFBO = glGenFramebuffers(); // \u521b\u5efa\u6df1\u5ea6\u56fe\u7eb9\u7406 depthMap = new Texture(SHADOW_MAP_WIDTH, SHADOW_MAP_HEIGHT, GL_DEPTH_COMPONENT); // \u7ed1\u5b9a\u6df1\u5ea6\u56fe\u7eb9\u7406\u5230FBO glBindFramebuffer(GL_FRAMEBUFFER, depthMapFBO); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthMap.getId(), 0); // \u4ec5\u8bbe\u7f6e\u6df1\u5ea6 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) { throw new Exception(\"Could not create FrameBuffer\"); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public Texture getDepthMapTexture() { return depthMap; } public int getDepthMapFBO() { return depthMapFBO; } public void cleanup() { glDeleteFramebuffers(depthMapFBO); depthMap.cleanup(); } } ShadowMap \u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff0c\u7528\u4e8e\u786e\u5b9a\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5927\u5c0f\u3002\u5b83\u8fd8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5c5e\u6027\uff0c\u4e00\u4e2a\u7528\u4e8eFBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u7eb9\u7406\u3002\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u7684FBO\u548c\u4e00\u4e2a\u65b0\u7684 Texture \u3002\u5bf9\u4e8eFBO\uff0c\u5c06\u4f7f\u7528\u5e38\u91cf GL_DEPTH_COMPONENT \u4f5c\u4e3a\u50cf\u7d20\u683c\u5f0f\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u50a8\u5b58\u6df1\u5ea6\u503c\u611f\u5174\u8da3\uff0c\u7136\u540e\u5c06FBO\u7ed1\u5b9a\u5230\u7eb9\u7406\u5b9e\u4f8b\u3002 \u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\u663e\u5f0f\u5730\u5c06FBO\u8bbe\u7f6e\u4e3a\u4e0d\u6e32\u67d3\u4efb\u4f55\u989c\u8272\u3002FBO\u9700\u8981\u989c\u8272\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u4e0d\u9700\u8981\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u5c06\u989c\u8272\u7f13\u51b2\u533a\u8bbe\u7f6e\u4e3a GL_NONE \u3002 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); \u73b0\u5728\uff0c\u6211\u4eec\u51c6\u5907\u5728 Renderer \u7c7b\u4e2d\u5c06\u573a\u666f\u4ece\u706f\u5149\u900f\u89c6\u6e32\u67d3\u4e3aFBO\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u7ec4\u7279\u6b8a\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u3002 \u540d\u4e3a depth_vertex.vs \u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { gl_Position = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0f); } \u6211\u4eec\u5e0c\u671b\u63a5\u6536\u4e0e\u573a\u666f\u7740\u8272\u5668\u76f8\u540c\u7684\u8f93\u5165\u6570\u636e\u3002\u4f46\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5750\u6807\uff0c\u4f46\u662f\u4e3a\u4e86\u5c3d\u53ef\u80fd\u591a\u5730\u91cd\u7528\u4ee3\u7801\uff0c\u6211\u4eec\u8fd8\u662f\u8981\u4f20\u9001\u5176\u4ed6\u6570\u636e\u3002\u6211\u4eec\u8fd8\u9700\u8981\u4e00\u5bf9\u77e9\u9635\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u4ee5\u5149\u6e90\u7684\u89d2\u5ea6\u6e32\u67d3\u573a\u666f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u6a21\u578b\u8f6c\u6362\u5230\u5149\u6e90\u7684\u5750\u6807\u7a7a\u95f4\u3002\u8fd9\u662f\u901a\u8fc7 modelLightViewMatrix \u77e9\u9635\u5b8c\u6210\u7684\uff0c\u8be5\u77e9\u9635\u7c7b\u4f3c\u4e8e\u7528\u4e8e\u6444\u50cf\u673a\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u73b0\u5728\u5149\u6e90\u662f\u6211\u4eec\u7684\u6444\u50cf\u673a\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u5230\u5c4f\u5e55\u7a7a\u95f4\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u9700\u8981\u6295\u5f71\u5b83\u4eec\u3002\u8fd9\u662f\u8ba1\u7b97\u5e73\u884c\u5149\u4e0e\u70b9\u5149\u6e90\u7684\u9634\u5f71\u56fe\u65f6\u7684\u533a\u522b\u4e4b\u4e00\u3002\u5bf9\u4e8e\u5730\u6602\u626c\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u900f\u89c6\u6295\u5f71\uff08Perspective Projection\uff09\u77e9\u9635\uff0c\u5c31\u50cf\u6211\u4eec\u6b63\u5e38\u6e32\u67d3\u573a\u666f\u4e00\u6837\u3002\u76f8\u53cd\uff0c\u5e73\u884c\u5149\u4ee5\u76f8\u540c\u65b9\u5f0f\u5f71\u54cd\u6240\u6709\u5bf9\u8c61\uff0c\u800c\u4e0e\u8ddd\u79bb\u65e0\u5173\u3002\u5e73\u884c\u5149\u6e90\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u7684\u70b9\u4e0a\uff0c\u6ca1\u6709\u4f4d\u7f6e\uff0c\u53ea\u6709\u65b9\u5411\u3002\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u4e0d\u4f1a\u4f7f\u8fdc\u5904\u7684\u7269\u4f53\u53d8\u5c0f\uff0c\u56e0\u6b64\uff0c\u6b63\u4ea4\u6295\u5f71\u6700\u9002\u5408\u5e73\u884c\u5149\u3002 \u7247\u5143\u7740\u8272\u5668\u66f4\u7b80\u5355\u3002\u5b83\u53ea\u8f93\u51fa z \u5750\u6807\u4f5c\u4e3a\u6df1\u5ea6\u503c\u3002 #version 330 void main() { gl_FragDepth = gl_FragCoord.z; } \u5b9e\u9645\u4e0a\uff0c\u4f60\u53ef\u4ee5\u5220\u6389\u8be5\u884c\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u751f\u6210\u6df1\u5ea6\u503c\uff0c\u6df1\u5ea6\u503c\u5c06\u81ea\u52a8\u8fd4\u56de\u3002 \u4e00\u65e6\u6211\u4eec\u4e3a\u6df1\u5ea6\u6e32\u67d3\u5b9a\u4e49\u4e86\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u4e3a\u521d\u59cb\u5316\u8fd9\u4e9b\u7740\u8272\u5668\u5b9a\u4e49\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u540d\u4e3a setupDepthShader \uff0c\u5b83\u5c06\u5728\u5176\u4ed6\u7740\u8272\u5668\u88ab\u521d\u59cb\u5316\u65f6\u8c03\u7528\u3002 private void setupDepthShader() throws Exception { depthShaderProgram = new ShaderProgram(); depthShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/depth_vertex.vs\")); depthShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/depth_fragment.fs\")); depthShaderProgram.link(); depthShaderProgram.createUniform(\"orthoProjectionMatrix\"); depthShaderProgram.createUniform(\"modelLightViewMatrix\"); } \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528\u90a3\u4e9b\u540d\u4e3a renderDepthMap \u7684\u7740\u8272\u5668\u3002\u8be5\u65b9\u6cd5\u5c06\u5728\u4e3b\u6e32\u67d3\u65b9\u6cd5\u4e2d\u8c03\u7528\u3002 public void render(Window window, Camera camera, Scene scene, IHud hud) { clear(); // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe renderDepthMap(window, camera, scene); glViewport(0, 0, window.getWidth(), window.getHeight()); // \u5176\u4f59\u7684\u4ee3\u7801\u5728\u8fd9... \u5982\u679c\u4f60\u6d4f\u89c8\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\uff0c\u65b0\u65b9\u6cd5\u5c31\u5df2\u7ecf\u88ab\u8c03\u7528\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u65b0\u65b9\u6cd5\u5c06\u66f4\u9ad8\u89c6\u53e3\u4ee5\u5339\u914d\u4fdd\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5c3a\u5bf8\u3002\u56e0\u6b64\uff0c\u5728\u5b8c\u6210 renderDepthMap \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u59cb\u7ec8\u9700\u8981\u8bbe\u7f6e\u5c4f\u5e55\u5c3a\u5bf8\u7684\u89c6\u53e3\uff08\u4e0d\u68c0\u67e5\u7a97\u53e3\u662f\u5426\u5df2\u8c03\u6574\u5927\u5c0f\uff09\u3002 \u73b0\u5728\u8ba9\u6211\u4eec\u5b9a\u4e49\u4e00\u4e0b renderDepthMap \u65b9\u6cd5\u3002\u7b2c\u4e00\u4ef6\u4e8b\u662f\u7ed1\u5b9a\u5728 ShadowMap \u7c7b\u4e2d\u521b\u5efa\u7684FBO\uff0c\u5e76\u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5c3a\u5bf8\u3002 glBindFramebuffer(GL_FRAMEBUFFER, shadowMap.getDepthMapFBO()); glViewport(0, 0, ShadowMap.SHADOW_MAP_WIDTH, ShadowMap.SHADOW_MAP_HEIGHT); \u7136\u540e\uff0c\u6e05\u9664\u6df1\u5ea6\u7f13\u51b2\u533a\u5185\u5bb9\u5e76\u7ed1\u5b9a\u6df1\u5ea6\u7740\u8272\u5668\u3002\u56e0\u4e3a\u6211\u4eec\u53ea\u5904\u7406\u6df1\u5ea6\u503c\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6e05\u9664\u989c\u8272\u4fe1\u606f\u3002 glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); \u73b0\u5728\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u77e9\u9635\uff0c\u63a5\u4e0b\u6765\u662f\u68d8\u624b\u7684\u90e8\u5206\u3002\u6211\u4eec\u4f7f\u7528\u5149\u6e90\u4f5c\u4e3a\u6444\u50cf\u673a\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u9700\u8981\u4e00\u4e2a\u5750\u6807\u548c\u4e09\u4e2a\u89d2\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6b63\u5982\u672c\u7ae0\u5f00\u5934\u6240\u8bf4\uff0c\u6211\u4eec\u53ea\u5b9e\u73b0\u5e73\u884c\u5149\uff0c\u8fd9\u79cd\u7c7b\u578b\u7684\u5149\u4e0d\u5b9a\u4e49\u4f4d\u7f6e\uff0c\u800c\u662f\u5b9a\u4e49\u65b9\u5411\u3002\u5982\u679c\u6211\u4eec\u4f7f\u7528\u70b9\u5149\u6e90\uff0c\u8fd9\u5f88\u5bb9\u6613\uff0c\u5149\u6e90\u7684\u4f4d\u7f6e\u5c31\u662f\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u7f6e\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u4f4d\u7f6e\u3002 \u6211\u4eec\u5c06\u91c7\u7528\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u5149\u7684\u4f4d\u7f6e\u3002\u5e73\u884c\u5149\u662f\u7531\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u7684\uff0c\u901a\u5e38\u662f\u5f52\u4e00\u5316\u7684\uff0c\u5b83\u6307\u5411\u5149\u6e90\u6240\u5728\u7684\u65b9\u5411\u3002\u6211\u4eec\u628a\u8fd9\u4e2a\u65b9\u5411\u5411\u91cf\u4e58\u4ee5\u4e00\u4e2a\u53ef\u914d\u7f6e\u7684\u56e0\u5b50\uff0c\u5728\u8fd9\u6837\u5b83\u5c31\u4e3a\u8981\u7ed8\u5236\u7684\u573a\u666f\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5408\u7406\u8ddd\u79bb\u7684\u70b9\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u65b9\u5411\u6765\u8ba1\u7b97\u8be5\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u8fd9\u662f\u8ba1\u7b97\u706f\u5149\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u89d2\u5ea6\u7684\u4ee3\u7801\u7247\u6bb5\uff1a float lightAngleX = (float)Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float)Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Matrix4f lightViewMatrix = transformation.updateLightViewMatrix(new Vector3f(lightDirection).mul(light.getShadowPosMult()), new Vector3f(lightAngleX, lightAngleY, lightAngleZ)); \u63a5\u4e0b\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff1a Matrix4f orthoProjMatrix = transformation.updateOrthoProjectionMatrix(orthCoords.left, orthCoords.right, orthCoords.bottom, orthCoords.top, orthCoords.near, orthCoords.far); \u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86 Transformation \u7c7b\uff0c\u4ee5\u56ca\u62ec\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6b64\u4eec\u6709\u4e00\u4e2a\u6b63\u4ea4\u7684\u4e8c\u7ef4\u6295\u5f71\u77e9\u9635\uff0c\u6240\u4ee5\u6211\u4eec\u91cd\u547d\u540d\u4e86\u6b64\u524d\u7684\u65b9\u6cd5\u548c\u5c5e\u6027\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u5b9a\u4e49\u3002 \u7136\u540e\uff0c\u6211\u4eec\u6309\u7167 renderScene \u65b9\u6cd5\u6e32\u67d3\u573a\u666f\u5bf9\u8c61\uff0c\u4f46\u5728\u5149\u7167\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u4f7f\u7528\u4e0a\u8ff0\u77e9\u9635\u5de5\u4f5c\u3002 depthShaderProgram.setUniform(\"orthoProjectionMatrix\", orthoProjMatrix); Map<Mesh, List<GameItem>> mapMeshes = scene.getGameMeshes(); for (Mesh mesh : mapMeshes.keySet()) { mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelLightViewMatrix = transformation.buildModelViewMatrix(gameItem, lightViewMatrix); depthShaderProgram.setUniform(\"modelLightViewMatrix\", modelLightViewMatrix); } ); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); \u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u662f\u5728\u5e73\u884c\u5149\u4e2d\u5b9a\u4e49\u7684\u3002\u5c06\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u4e3a\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5176\u4e2d\u5305\u542b\u6211\u4eec\u8981\u6e32\u67d3\u7684\u6240\u6709\u5bf9\u8c61\u3002\u5f53\u53ea\u6295\u5f71\u9002\u5408\u8be5\u8fb9\u754c\u6846\u7684\u5bf9\u8c61\u65f6\uff0c\u5bf9\u8c61\u5c06\u53ef\u89c6\u3002\u8be5\u8fb9\u754c\u6846\u75316\u4e2a\u53c2\u6570\u5b9a\u4e49\uff1a\u5de6\u3001\u53f3\u3001\u4e0a\u3001\u4e0b\u3001\u8fd1\u3001\u8fdc\u3002\u7531\u4e8e\u5149\u6e90\u4f4d\u7f6e\u73b0\u5728\u662f\u539f\u70b9\uff0c\u56e0\u6b64\u8fd9\u4e9b\u53c2\u6570\u5b9a\u4e49\u4e3a\u539f\u70b9\u5230\u5de6\u6216\u53f3\uff08x\u8f74\uff09\u6216\u4e0a\u6216\u4e0b\uff08y\u8f74\uff09\u6216\u8fdc\u6216\u8fd1\uff08z\u8f74\uff09\u7684\u8ddd\u79bb\u3002 \u8981\u4f7f\u9634\u5f71\u56fe\u6b63\u5e38\u5de5\u4f5c\uff0c\u6700\u68d8\u624b\u7684\u4e00\u70b9\u662f\u786e\u5b9a\u706f\u5149\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u3002\u8fd9\u5c31\u662f\u6240\u6709\u8fd9\u4e9b\u53c2\u6570\u73b0\u5728\u5728 DirectionalLight \u7c7b\u4e2d\u5b9a\u4e49\u7684\u65b9\u5f0f\uff0c\u56e0\u6b64\u53ef\u4ee5\u6839\u636e\u6bcf\u4e2a\u573a\u666f\u6b63\u786e\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002 \u4f60\u53ef\u4ee5\u5b9e\u73b0\u4e00\u4e2a\u66f4\u81ea\u52a8\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u8ba1\u7b97\u6444\u50cf\u673a\u622a\u9525\uff08Frustum\uff09\u7684\u4e2d\u5fc3\uff0c\u56de\u5230\u5149\u7684\u65b9\u5411\uff0c\u5efa\u7acb\u4e00\u4e2a\u5305\u542b\u573a\u666f\u4e2d\u6240\u6709\u5bf9\u8c61\u7684\u6b63\u4ea4\u6295\u5f71\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5982\u4e0a\u6240\u8ff0\u7684\u4e09\u7ef4\u573a\u666f\u3001\u76f8\u673a\u4f4d\u7f6e\u3001\u622a\u9525\uff08\u84dd\u8272\uff09\u3001\u6700\u4f73\u5149\u6e90\u4f4d\u7f6e\u4ee5\u53ca\u7ea2\u8272\u7684\u8fb9\u754c\u6846\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5f88\u96be\u8ba1\u7b97\uff0c\u5982\u679c\u4f60\u6709\u5f88\u5c0f\u7684\u7269\u4f53\uff0c\u5e76\u4e14\u8fb9\u754c\u6846\u5f88\u5927\uff0c\u4f60\u53ef\u4ee5\u4f1a\u5f97\u5230\u5947\u602a\u7684\u7ed3\u679c\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u65b9\u6cd5\u5bf9\u4e8e\u5c0f\u573a\u666f\u66f4\u7b80\u5355\uff0c\u4f60\u53ef\u4ee5\u8c03\u6574\u5b83\u4ee5\u5339\u914d\u4f60\u7684\u6a21\u578b\uff08\u5373\u4f7f\u4f60\u53ef\u4ee5\u9009\u62e9\u663e\u5f0f\u8bbe\u7f6e\u706f\u5149\u7684\u4f4d\u7f6e\uff0c\u4ee5\u907f\u514d\u76f8\u673a\u8fdc\u79bb\u539f\u70b9\u79fb\u52a8\u65f6\u4ea7\u751f\u5947\u602a\u7684\u6548\u679c\uff09\u3002\u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u901a\u7528\u7684\u6a21\u677f\uff0c\u53ef\u4ee5\u5e94\u7528\u5230\u4efb\u4f55\u573a\u666f\uff0c\u4f60\u5e94\u8be5\u6269\u5c55\u5b83\uff0c\u4ee5\u652f\u6301\u5c42\u53e0\u9634\u5f71\u56fe\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u3002\u5728\u4f7f\u7528\u6df1\u5ea6\u56fe\u5b9e\u9645\u8ba1\u7b97\u9634\u5f71\u4e4b\u524d\uff0c\u53ef\u4ee5\u4f7f\u7528\u751f\u6210\u7684\u7eb9\u7406\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4ee5\u89c2\u5bdf\u6df1\u5ea6\u56fe\u7684\u5b9e\u9645\u5916\u89c2\u3002\u5728\u6709\u4e00\u4e2a\u65cb\u8f6c\u7acb\u65b9\u4f53\u6f02\u6d6e\u5728\u4e00\u4e2a\u6709\u5782\u76f4\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u7684\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u989c\u8272\u8d8a\u6df1\uff0c\u79bb\u5149\u6e90\u7684\u4f4d\u7f6e\u8d8a\u8fd1\u3002\u6df1\u5ea6\u56fe\u4e2d\u5149\u6e90\u4f4d\u7f6e\u7684\u5f71\u54cd\u662f\u4ec0\u4e48\uff1f\u4f60\u53ef\u4ee5\u4fee\u6539\u5e73\u884c\u5149\u7167\u7684\u500d\u589e\u56e0\u5b50\uff0c\u5c06\u770b\u5230\u5728\u7eb9\u7406\u4e2d\u6e32\u67d3\u7684\u5bf9\u8c61\u7684\u5927\u5c0f\u4e0d\u4f1a\u53d8\u5c0f\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u7269\u4f53\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u589e\u5927\u800c\u53d8\u5c0f\u3002\u4f60\u5c06\u770b\u5230\u7684\u662f\uff0c\u6240\u6709\u7684\u989c\u8272\u90fd\u4f1a\u53d8\u5f97\u66f4\u4eae\uff0c\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u662f\u5426\u610f\u5473\u7740\u6211\u4eec\u53ef\u4ee5\u4e3a\u5149\u6e90\u9009\u62e9\u4e00\u4e2a\u8f83\u8fdc\u7684\u4f4d\u7f6e\u800c\u4e0d\u9020\u6210\u4efb\u4f55\u540e\u679c\u5462\uff1f\u7b54\u6848\u662f\u4e0d\u884c\u3002\u5982\u679c\u5149\u6e90\u79bb\u6211\u4eec\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u592a\u8fdc\uff0c\u8fd9\u4e9b\u5bf9\u8c61\u4f1a\u8d85\u51fa\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u767d\u8272\u7eb9\u7406\uff0c\u4f46\u8fd9\u662f\u6ca1\u7528\u7684\u9634\u5f71\u56fe\u3002\u597d\u7684\uff0c\u90a3\u4e48\u6211\u4eec\u53ea\u9700\u589e\u52a0\u8fb9\u754c\u6846\u7684\u5927\u5c0f\uff0c\u4e00\u5207\u90fd\u4f1a\u597d\u7684\uff0c\u5bf9\u5417\uff1f\u7b54\u6848\u4e5f\u662f\u4e0d\u884c\u3002\u5982\u679c\u4f60\u4e3a\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u9009\u7528\u4e86\u5de8\u5927\u7684\u5c3a\u5bf8\uff0c\u4f60\u7684\u7269\u4f53\u5728\u7eb9\u7406\u4e2d\u4f1a\u88ab\u7ed8\u5236\u5f97\u5f88\u5c0f\uff0c\u6df1\u5ea6\u503c\u751a\u81f3\u4f1a\u91cd\u53e0\uff0c\u9020\u6210\u5947\u602a\u7684\u7ed3\u679c\u3002\u597d\u5427\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u8003\u8651\u589e\u52a0\u7eb9\u7406\u5927\u5c0f\uff0c\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u662f\u6709\u9650\u5236\u7684\uff0c\u7eb9\u7406\u4e0d\u80fd\u56e0\u4f7f\u7528\u5de8\u5927\u7684\u7f16\u8f91\u6846\u800c\u65e0\u9650\u589e\u5927\u3002 \u56e0\u6b64\uff0c\u53ef\u4ee5\u770b\u5230\uff0c\u9009\u62e9\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u7684\u53c2\u6570\u662f\u4e00\u4e2a\u590d\u6742\u7684\u5e73\u8861\uff0c\u8fd9\u4f7f\u5f97\u4f7f\u7528\u9634\u5f71\u56fe\u5f88\u96be\u5f97\u5230\u6b63\u786e\u7684\u6548\u679c\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u6e32\u67d3\u8fc7\u7a0b\uff0c\u4e00\u65e6\u8ba1\u7b97\u4e86\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728\u6e32\u67d3\u573a\u666f\u65f6\u4f7f\u7528\u5b83\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528\u900f\u89c6\u77e9\u9635\u5c06\u9876\u70b9\u5750\u6807\u4ece\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u3002\u73b0\u5728\u8fd8\u9700\u8981\u4f7f\u7528\u6295\u5f71\u77e9\u9635\u4ece\u5149\u7167\u7a7a\u95f4\u5750\u6807\u6295\u5f71\u9876\u70b9\u5750\u6807\uff0c\u4ee5\u7528\u4e8e\u7247\u5143\u7740\u8272\u5668\u4e2d\u8ba1\u7b97\u9634\u5f71\u3002 \u9876\u70b9\u7740\u8272\u5668\u662f\u8fd9\u6837\u4fee\u6539\u7684\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6211\u4eec\u4e3a\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4f7f\u7528\u4e86\u65b0\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u9634\u5f71\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a float calcShadow(vec4 position) { float shadowFactor = 1.0; vec3 projCoords = position.xyz; // \u4ece\u5c4f\u5e55\u5750\u6807\u53d8\u6362\u5230\u7eb9\u7406\u5750\u6807 projCoords = projCoords * 0.5 + 0.5; if ( projCoords.z < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } return 1 - shadowFactor; } \u8be5\u51fd\u6570\u63a5\u6536\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u6295\u5f71\u7684\u5149\u7167\u89c2\u5bdf\u7a7a\u95f4\u7684\u5750\u6807\u3002\u5982\u679c\u5750\u6807\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 0 \uff0c\u5982\u679c\u4e0d\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 1 \u3002\u9996\u5148\uff0c\u5c06\u5750\u6807\u8f6c\u6362\u4e3a\u7eb9\u7406\u5750\u6807\u3002\u5c4f\u5e55\u5750\u6807\u5728 [-1, 1] \u8303\u56f4\u5185\uff0c\u4f46\u7eb9\u7406\u5750\u6807\u5728 [0, 1] \u8303\u56f4\u5185\u3002\u6211\u4eec\u901a\u8fc7\u5750\u6807\u4ece\u7eb9\u7406\u4e2d\u83b7\u53d6\u6df1\u5ea6\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u7247\u5143\u5750\u6807\u7684 z \u503c\u6bd4\u8f83\u3002\u5982\u679c z \u503c\u4f4e\u4e8e\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\u7684\u503c\uff0c\u5219\u8868\u793a\u7247\u5143\u4e0d\u518d\u9634\u5f71\u4e2d\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c calcShadow \u51fd\u6570\u7684\u8fd4\u56de\u503c\uff0c\u7528\u4e8e\u8c03\u8282\u70b9\u5149\u6e90\u3001\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\u5bf9\u5149\u7167\u989c\u8272\u7684\u5171\u4eab\u3002\u73af\u5883\u5149\u4e0d\u53d7\u9634\u5f71\u7684\u5f71\u54cd\u3002 float shadow = calcShadow(mlightviewVertexPos); fragColor = clamp(ambientC * vec4(ambientLight, 1) + diffuseSpecularComp * shadow, 0, 1); \u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u6b63\u4ea4\u6295\u5f71\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5230Uniform\uff08\u6211\u4eec\u8fd8\u9700\u8981\u4fee\u6539\u7740\u8272\u5668\u7684\u521d\u59cb\u5316\u65b9\u6cd5\u4ee5\u521b\u5efa\u65b0\u7684Uniform\uff09\u3002\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u3002 \u5982\u679c\u8fd0\u884c DummyGame \u7c7b\uff0c\u8be5\u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u5728\u5e26\u6709\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u8bbe\u7f6e\u6709\u60ac\u6d6e\u7684\u7acb\u65b9\u4f53\uff0c\u5e76\u53ef\u4f7f\u7528\u4e0a\u4e0b\u952e\u4fee\u6539\u89d2\u5ea6\uff0c\u5219\u5e94\u8be5\u770b\u5230\u5982\u4e0b\u60c5\u51b5\u3002 \u867d\u7136\u9634\u5f71\u5df2\u7ecf\u5de5\u4f5c\u4e86\uff08\u4f60\u53ef\u4ee5\u901a\u8fc7\u79fb\u52a8\u5149\u7167\u65b9\u5411\u6765\u68c0\u67e5\uff09\uff0c\u4f46\u662f\u5b9e\u9645\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u88ab\u7167\u4eae\u7684\u7269\u4f53\u4e2d\u6709\u5947\u602a\u7684\u7ebf\u6761\u3002\u8fd9\u79cd\u60c5\u51b5\u88ab\u79f0\u4e3a\u9634\u5f71\u5931\u771f\uff08Shadow Acne\uff09\uff0c\u5b83\u662f\u7531\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5206\u8fa8\u7387\u6709\u9650\u9020\u6210\u7684\u3002\u7b2c\u4e8c\u4e2a\u95ee\u9898\u662f\uff0c\u9634\u5f71\u7684\u8fb9\u754c\u4e0d\u5e73\u6ed1\uff0c\u770b\u8d77\u6765\u5f88\u7c97\u7cd9\u3002\u539f\u56e0\u540c\u6837\uff0c\u7eb9\u7406\u5206\u8fa8\u7387\u3002\u6211\u4eec\u5c06\u89e3\u51b3\u8fd9\u4e9b\u95ee\u9898\uff0c\u4ee5\u63d0\u9ad8\u9634\u5f71\u8d28\u91cf\u3002","title":"\u9634\u5f71\u6620\u5c04"},{"location":"18-shadows/#_2","text":"\u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u9634\u5f71\u6620\u5c04\u673a\u5236\uff0c\u90a3\u4e48\u8ba9\u6211\u4eec\u6765\u89e3\u51b3\u73b0\u6709\u7684\u95ee\u9898\u3002\u6211\u4eec\u5148\u4ece\u5931\u771f\u95ee\u9898\u5f00\u59cb\u3002\u6df1\u5ea6\u56fe\u7eb9\u7406\u5927\u5c0f\u6709\u9650\uff0c\u56e0\u6b64\uff0c\u53ef\u4ee5\u5c06\u591a\u4e2a\u7247\u5143\u6620\u5c04\u5230\u8be5\u7eb9\u7406\u6df1\u5ea6\u4e2d\u7684\u540c\u4e00\u50cf\u7d20\u3002\u7eb9\u7406\u6df1\u5ea6\u50a8\u5b58\u6700\u5c0f\u6df1\u5ea6\uff0c\u56e0\u6b64\u5230\u6700\u540e\uff0c\u6211\u4eec\u6709\u51e0\u4e2a\u7247\u5143\u5171\u4eab\u76f8\u540c\u7684\u6df1\u5ea6\uff0c\u5c3d\u7ba1\u5b83\u4eec\u7684\u8ddd\u79bb\u4e0d\u540c\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u7247\u5143\u7740\u8272\u5668\u4e2d\u7684\u6df1\u5ea6\u6bd4\u8f83\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u504f\u79fb\u3002 float bias = 0.05; if ( projCoords.z - bias < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } \u73b0\u5728\uff0c\u9634\u5f71\u5931\u771f\u6d88\u5931\u4e86\u3002 \u8bd1\u8005\u6ce8\uff1a\u4f7f\u7528\u504f\u79fb\u6765\u6d88\u9664\u9634\u5f71\u5931\u771f\u53c8\u4f1a\u9020\u6210\u60ac\u6d6e\uff08Peter Panning\uff09\u95ee\u9898\uff0c\u53e6\u8bf7\u53c2\u9605 LearnOpenGL\u9634\u5f71\u6620\u5c04 \u4e00\u6587\u3002 \u73b0\u5728\u6211\u4eec\u8981\u89e3\u51b3\u7684\u662f\u53bb\u9634\u5f71\u8fb9\u7f18\u95ee\u9898\uff0c\u8fd9\u4e5f\u662f\u7531\u7eb9\u7406\u5206\u8fa8\u7387\u5f15\u8d77\u7684\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7247\u5143\u7684\u5750\u6807\u503c\u548c\u5468\u56f4\u7684\u503c\u5bf9\u6df1\u5ea6\u56fe\u8fdb\u884c\u91c7\u6837\u3002\u7136\u540e\u6211\u4eec\u5c06\u8ba1\u7b97\u5e73\u5747\u503c\u5e76\u5c06\u8be5\u503c\u6307\u5b9a\u4e3a\u9634\u5f71\u503c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5b83\u7684\u503c\u4e0d\u4f1a\u662f 0 \u548c 1 \u4f46\u53ef\u4ee5\u5728\u4e24\u8005\u95f4\u53d6\u503c\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u8fb9\u7f18\u3002 \u5728\u7eb9\u7406\u5750\u6807\u4e2d\uff0c\u5468\u56f4\u503c\u5fc5\u987b\u4e0e\u5f53\u524d\u7247\u5143\u4f4d\u7f6e\u4fdd\u6301\u4e00\u4e2a\u50cf\u7d20\u8ddd\u79bb\u3002\u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u4e2d\u4e00\u4e2a\u50cf\u7d20\u7684\u589e\u91cf\uff0c\u5b83\u7b49\u4e8e 1 / \u7eb9\u7406\u5927\u5c0f \u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u9634\u5f71\u94f6\u5b50\u7684\u8ba1\u7b97\u6765\u5f97\u5230\u4e00\u4e2a\u5e73\u5747\u503c\u3002 float shadowFactor = 0.0; vec2 inc = 1.0 / textureSize(shadowMap, 0); for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth = texture(shadowMap, projCoords.xy + vec2(row, col) * inc).r; shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; \u73b0\u5728\u7ed3\u679c\u770b\u8d77\u6765\u66f4\u5e73\u6ed1\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u7684\u793a\u4f8b\u770b\u8d77\u6765\u597d\u591a\u4e86\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u91cc\u4ecb\u7ecd\u7684\u9634\u5f71\u6620\u5c04\u6280\u672f\u4ecd\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u89e3\u51b3\u60ac\u6d6e\uff08Peter Panning\uff09\u6548\u679c\uff08\u56e0\u504f\u79fb\u5f15\u8d77\uff09\u548c\u5176\u4ed6\u6539\u8fdb\u9634\u5f71\u8fb9\u7f18\u7684\u8ba1\u7b97\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u6709\u4e86\u8fd9\u91cc\u6240\u8bb2\u89e3\u7684\u6982\u5ff5\uff0c\u4f60\u5c31\u6709\u4e86\u5f00\u59cb\u4fee\u6539\u793a\u4f8b\u7684\u826f\u597d\u57fa\u7840\u3002 \u4e3a\u4e86\u6e32\u67d3\u591a\u4e2a\u5149\u6e90\uff0c\u4f60\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u5149\u6e90\u6e32\u67d3\u4e00\u4e2a\u6df1\u5ea6\u56fe\u3002\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u4f60\u9700\u8981\u91c7\u6837\u6240\u6709\u7684\u6df1\u5ea6\u56fe\u6765\u8ba1\u7b97\u5408\u9002\u7684\u9634\u5f71\u7cfb\u6570\u3002","title":"\u6539\u8fdb\u9634\u5f71\u6620\u5c04"},{"location":"19-animations/","text":"\u52a8\u753b\uff08Animations\uff09 \u5f15\u8a00 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u52a0\u8f7d\u4e86\u9759\u60013D\u6a21\u578b\uff0c\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4e3a\u5b83\u4eec\u8bbe\u7f6e\u52a8\u753b\u3002\u5728\u601d\u8003\u52a8\u753b\u65f6\uff0c\u9996\u5148\u60f3\u5230\u7684\u65b9\u6cd5\u662f\u4e3a\u6bcf\u4e2a\u6a21\u578b\u72b6\u6001\u521b\u5efa\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u5c06\u5b83\u4eec\u52a0\u8f7d\u5230GPU\u4e2d\uff0c\u7136\u540e\u6309\u987a\u5e8f\u7ed8\u5236\uff0c\u4ee5\u6b64\u9020\u6210\u52a8\u753b\u7684\u5047\u8c61\u3002\u867d\u7136\u8fd9\u79cd\u65b9\u6cd5\u5bf9\u4e8e\u67d0\u4e9b\u6e38\u620f\u6765\u8bf4\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u662f\u5b83\u7684\u6548\u7387\u4e0d\u662f\u5f88\u9ad8\uff08\u5c31\u5185\u5b58\u6d88\u8017\u6765\u8bf4\uff09\u3002 \u8fd9\u5c31\u662f\u9aa8\u9abc\u52a8\u753b\uff08Skeletal Animation\uff09\u7684\u7528\u6b66\u4e4b\u5730\u3002\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u6a21\u578b\u7684\u52a8\u753b\u65b9\u5f0f\u7531\u5176\u5e95\u5c42\u9aa8\u67b6\uff08Skeletal\uff09\u5b9a\u4e49\uff0c\u9aa8\u67b6\u662f\u7531\u88ab\u79f0\u4e3a\u5173\u8282\uff08Joints\uff09\u7684\u7279\u6b8a\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u5b9a\u4e49\u7684\uff0c\u8fd9\u4e9b\u5173\u8282\u53c8\u7531\u5b83\u4eec\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u6765\u5b9a\u4e49\u3002\u6211\u4eec\u4e5f\u8bf4\u8fc7\u8fd9\u662f\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u5173\u952e\u7684\u6700\u7ec8\u4f4d\u7f6e\u90fd\u6536\u5230\u5b83\u4eec\u7684\u7236\u5c42\u6b21\u7684\u5f71\u54cd\u3002\u4ee5\u624b\u8155\u4e3a\u4f8b\uff0c\u5982\u679c\u89d2\u8272\u79fb\u52a8\u8098\u90e8\u548c\u80a9\u8180\uff0c\u624b\u8155\u7684\u4f4d\u7f6e\u5c31\u4f1a\u53d1\u751f\u6539\u53d8\u3002 \u5173\u8282\u4e0d\u9700\u8981\u8868\u793a\u4e00\u4e2a\u5408\u4e4e\u73b0\u5b9e\u7684\u9aa8\u9abc\u6216\u5173\u8282\uff0c\u5b83\u4eec\u662f\u4eba\u5de5\u8bbe\u7f6e\u7684\uff0c\u5141\u8bb8\u521b\u4f5c\u8005\u5efa\u6a21\u52a8\u753b\u3002\u9664\u4e86\u5173\u8282\uff0c\u6211\u4eec\u8fd8\u6709\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u9876\u70b9\u662f\u6839\u636e\u4e0e\u4e4b\u76f8\u5173\u7684\u5173\u8282\u7684\u4f4d\u7f6e\u7ed8\u5236\u7684\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528MD5\u683c\u5f0f\u6765\u52a0\u8f7d\u6709\u52a8\u753b\u7684\u6a21\u578b\u3002MD5\u683c\u5f0f\u662f\u7531\u300a\u6bc1\u706d\u6218\u58eb\u300b\u7684\u5f00\u53d1\u5546ID Software\u5236\u5b9a\u7684\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u79cd\u57fa\u4e8e\u6587\u672c\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u6613\u4e8e\u7406\u89e3\u3002\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u4f7f\u7528 Collada \u683c\u5f0f\uff0c\u8fd9\u662f\u8bb8\u591a\u5de5\u5177\u652f\u6301\u7684\u516c\u5171\u6807\u51c6\u3002Collada\u662f\u4e00\u79cd\u57fa\u4e8eXML\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u4f46\u5b83\u7684\u7f3a\u70b9\u662f\u975e\u5e38\u590d\u6742\uff081.5\u7248\u672c\u7684\u89c4\u8303\u5c31\u6709500\u591a\u9875\uff09\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u575a\u6301\u4f7f\u7528\u4e00\u79cd\u66f4\u7b80\u5355\u7684\u683c\u5f0f\uff0cMD5\uff0c\u5b83\u4f7f\u6211\u4eec\u4e13\u6ce8\u4e8e\u9aa8\u9abc\u52a8\u753b\u7684\u6982\u5ff5\u5e76\u521b\u5efa\u4e00\u4e2a\u53ef\u5de5\u4f5c\u7684\u793a\u4f8b\u3002 \u4f60\u8fd8\u53ef\u4ee5\u901a\u8fc7\u5728\u4e92\u8054\u7f51\u4e0a\u627e\u5230 \u7279\u5b9a\u63d2\u4ef6 \u5c06\u4e00\u4e9b\u6a21\u578b\u4eceBlender\u5bfc\u51fa\u4e3aMD5\u683c\u5f0f\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u53c2\u8003\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u8d44\u6599\uff0c\u4f46\u662f\u6211\u53d1\u73b0\u6709\u4e24\u4e2a\u8d44\u6599\u53ef\u4ee5\u5f88\u597d\u5730\u89e3\u91ca\u5982\u4f55\u4f7f\u7528MD5\u6587\u4ef6\u521b\u5efa\u52a8\u753b\u6a21\u578b\u3002\u8fd9\u4e9b\u8d44\u6599\u7684\u6765\u6e90\u5982\u4e0b\uff1a http://www.3dgep.com/gpu-skinning-of-md5-models-in-opengl-and-cg/ http://ogldev.atspace.co.uk/www/tutorial38/tutorial38.html \u8ba9\u6211\u4eec\u4ece\u7f16\u5199\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5f00\u59cb\uff0cMD5\u683c\u5f0f\u5b9a\u4e49\u4e86\u4e24\u79cd\u7c7b\u578b\u7684\u6587\u4ef6\uff1a \u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b83\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u7f51\u683c\u96c6\u7684\u5173\u8282\u3001\u9876\u70b9\u548c\u7eb9\u7406\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5mesh \u7684\u6269\u5c55\u540d\u3002 \u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b9a\u4e49\u53ef\u4f7f\u7528\u4e8e\u6a21\u578b\u7684\u52a8\u753b\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5anim \u7684\u6269\u5c55\u540d\u3002 MD5\u6587\u4ef6\u7531\u5934\uff08Header\uff09\u548c\u5927\u62ec\u53f7\u4e4b\u95f4\u5305\u542b\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u67e5\u770b\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u3002\u5728\u53c2\u8003\u8d44\u6599\u6587\u4ef6\u5939\u4e2d\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u79cdMD5\u683c\u5f0f\u7684\u6a21\u578b\u3002\u5982\u679c\u4f60\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u6784\u3002 \u5728\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e2d\u53ef\u4ee5\u770b\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u5728\u4e0b\u8ff0\u63d0\u4f9b\u7684\u793a\u4f8b\u4e2d\uff0c\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numJoints 33 numMeshes 6 \u5934\u5b9a\u4e49\u4e86\u5982\u4e0b\u5c5e\u6027\uff1a \u5b83\u6240\u9075\u5faa\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\uff08\u4ece3D\u5efa\u6a21\u5de5\u5177\uff09\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\u3002 \u5728\u5173\u8282\u90e8\u5206\u5b9a\u4e49\u7684\u5173\u8282\u6570\u3002 \u7f51\u683c\u6570\uff08\u9700\u8981\u7684\u7f51\u683c\u8282\u6570\uff09\u3002 \u5173\u952e\u90e8\u5206\u5b9a\u4e49\u5173\u8282\u7684\u540d\u79f0\u3001\u72b6\u6001\u3001\u4f4d\u7f6e\u53ca\u5176\u5173\u7cfb\u3002\u4e0b\u9762\u5c55\u793a\u4e86\u4e00\u4e2a\u793a\u4f8b\u6a21\u578b\u7684\u5173\u8282\u90e8\u5206\u7684\u7247\u6bb5\uff1a joints { \"origin\" -1 ( -0.000000 0.016430 -0.006044 ) ( 0.707107 0.000000 0.707107 ) // \"sheath\" 0 ( 11.004813 -3.177138 31.702473 ) ( 0.307041 -0.578614 0.354181 ) // origin \"sword\" 1 ( 9.809593 -9.361549 40.753730 ) ( 0.305557 -0.578155 0.353505 ) // sheath \"pubis\" 0 ( 0.014076 2.064442 26.144581 ) ( -0.466932 -0.531013 -0.466932 ) // origin \u2026\u2026 } \u5173\u8282\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\u79f0\uff0c\u5f15\u53f7\u4e2d\u7684\u6587\u672c\u5c5e\u6027\u3002 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u7236\u5173\u8282\u5728\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u5173\u8282\u7b49\u4e8e-1\u3002 \u5173\u8282\u4f4d\u7f6e\uff0c\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u3002 \u5173\u8282\u65b9\u5411\uff0c\u4e5f\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\uff0c\u65b9\u5411\u5b9e\u9645\u4e0a\u662f\u4e00\u4e2a\u56db\u5143\u6570\uff0c\u4f46\u5176w\u5206\u91cf\u4e0d\u5305\u62ec\u5728\u6b64\u3002 \u5728\u7ee7\u7eed\u89e3\u91ca\u6587\u4ef6\u7684\u5176\u4f59\u90e8\u5206\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u6765\u8c08\u8c08\u56db\u5143\u6570\uff08Quaternions\uff09\u3002\u56db\u5143\u6570\u662f\u7528\u4e8e\u8868\u793a\u65cb\u8f6c\u7684\u56db\u4e2a\u6784\u6210\u5143\u7d20\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e00\u76f4\u5728\u4f7f\u7528\u6b27\u62c9\u89d2\uff08\u504f\u822a\u3001\u4fef\u4ef0\u548c\u6eda\u8f6c\uff09\u6765\u5b9a\u4e49\u65cb\u8f6c\uff0c\u8fd9\u57fa\u672c\u4e0a\u5b9a\u4e49\u4e86\u56f4\u7ed5x\u3001y\u548cz\u53eb\u7684\u65cb\u8f6c\u3002\u4f46\u662f\uff0c\u6b27\u62c9\u89d2\u5728\u5904\u7406\u65cb\u8f6c\u65f6\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\uff0c\u7279\u522b\u662f\u4f60\u5fc5\u987b\u77e5\u9053\u6b63\u786e\u7684\u65cb\u8f6c\u987a\u5e8f\uff0c\u5e76\u4e14\u4e00\u4e9b\u64cd\u4f5c\u4f1a\u53d8\u5f97\u975e\u5e38\u590d\u6742\u3002 \u56db\u5143\u6570\u6709\u52a9\u4e8e\u89e3\u51b3\u8fd9\u79cd\u590d\u6742\u60c5\u51b5\u3002\u6b63\u5982\u4e4b\u524d\u6240\u8bf4\uff0c\u56db\u5143\u6570\u88ab\u5b9a\u4e49\u4e3a4\u4e2a\u6570\u5b57\uff08x\uff0cy\uff0cz\uff0cw\uff09\u4e00\u7ec4\u3002\u56db\u5143\u6570\u5b9a\u4e49\u65cb\u8f6c\u8f74\u548c\u56f4\u7ed5\u8be5\u8f74\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u4f60\u53ef\u4ee5\u5728\u7f51\u7edc\u4e2d\u786e\u8ba4\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b66\u5b9a\u4e49\uff0c\u4f46\u597d\u6d88\u606f\u662f\u6211\u4eec\u4f7f\u7528\u7684\u6570\u5b66\u5e93JOML\u4e3a\u5176\u63d0\u4f9b\u4e86\u652f\u6301\u3002\u6211\u4eec\u53ef\u4ee5\u57fa\u4e8e\u56db\u5143\u6570\u6784\u9020\u65cb\u8f6c\u77e9\u9635\uff0c\u5e76\u7528\u5b83\u4eec\u5bf9\u5411\u91cf\u8fdb\u884c\u53d8\u6362\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u5173\u8282\u7684\u5b9a\u4e49\uff0c\u5176\u7f3a\u5c11 w \u5143\u7d20\uff0c\u4f46\u53ef\u4ee5\u5728\u5176\u4ed6\u503c\u7684\u5e2e\u52a9\u4e0b\u8f7b\u677e\u5730\u8ba1\u7b97\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u770b\u770b\u8fd9\u662f\u5982\u4f55\u505a\u5230\u7684\u3002 \u5728\u5173\u8282\u5b9a\u4e49\u4e4b\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u7ec4\u6210\u6a21\u578b\u7684\u4e0d\u540c\u7f51\u683c\u7684\u5b9a\u4e49\u3002\u63a5\u4e0b\u6765\u4f60\u53ef\u4ee5\u4ece\u5176\u4e2d\u4e00\u4e2a\u793a\u4f8b\u4e2d\u770b\u5230\u7f51\u683c\u5b9a\u4e49\u7684\u7247\u6bb5\uff1a mesh { shader \"/textures/bob/guard1_body.png\" numverts 494 vert 0 ( 0.394531 0.513672 ) 0 1 vert 1 ( 0.447266 0.449219 ) 1 2 ... vert 493 ( 0.683594 0.455078 ) 864 3 numtris 628 tri 0 0 2 1 tri 1 0 1 3 ... tri 627 471 479 493 numweights 867 weight 0 5 1.000000 ( 6.175774 8.105262 -0.023020 ) weight 1 5 0.500000 ( 4.880173 12.805251 4.196980 ) ... weight 866 6 0.333333 ( 1.266308 -0.302701 8.949338 ) } \u8ba9\u6211\u4eec\u770b\u770b\u4e0a\u8ff0\u5c55\u73b0\u7684\u7ed3\u6784\uff1a \u7f51\u683c\u4ece\u5b9a\u4e49\u7eb9\u7406\u6587\u4ef6\u5f00\u59cb\u3002\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5728\u6b64\u5904\u627e\u5230\u7684\u8def\u5f84\u662f\u521b\u5efa\u8be5\u6a21\u578b\u7684\u5de5\u5177\u6240\u4f7f\u7528\u7684\u8def\u5f84\u3002\u8be5\u8def\u5f84\u53ef\u80fd\u4e0e\u7528\u4e8e\u52a0\u8f7d\u8fd9\u4e9b\u6587\u4ef6\u7684\u8def\u5f84\u4e0d\u5339\u914d\u3002\u8fd9\u91cc\u6709\u4e24\u79cd\u65b9\u6cd5\u89e3\u51b3\uff0c\u8981\u4e48\u52a8\u6001\u4fee\u6539\u57fa\u672c\u8def\u5f84\uff0c\u8981\u4e48\u624b\u52a8\u4fee\u6539\u8be5\u8def\u5f84\u3002\u6211\u9009\u62e9\u4e86\u540e\u8005\uff0c\u6bd4\u8f83\u7b80\u5355\u7684\u4e00\u79cd\u3002 \u63a5\u4e0b\u6765\u53ef\u4ee5\u627e\u5230\u9876\u70b9\u5b9a\u4e49\u3002\u9876\u70b9\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u9876\u70b9\u7d22\u5f15\u3002 \u7eb9\u7406\u5750\u6807\u3002 \u5f71\u54cd\u6b64\u9876\u70b9\u7684\u7b2c\u4e00\u4e2a\u6743\u91cd\u5b9a\u4e49\u7684\u7d22\u5f15\u3002 \u8981\u8003\u8651\u7684\u6743\u91cd\u6570\u3002 \u5728\u9876\u70b9\u4e4b\u540e\uff0c\u5c06\u5b9a\u4e49\u6784\u6210\u6b64\u7f51\u683c\u7684\u4e09\u89d2\u5f62\u3002\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e86\u4f7f\u7528\u9876\u70b9\u7d22\u5f15\u7ec4\u7ec7\u9876\u70b9\u7684\u65b9\u5f0f\u3002 \u6700\u540e\uff0c\u5b9a\u4e49\u4e86\u6743\u91cd\u3002\u6743\u91cd\u5b9a\u4e49\u7531\u4ee5\u4e0b\u90e8\u5206\u7ec4\u6210\uff1a \u6743\u91cd\u6307\u6570\u3002 \u5173\u8282\u6307\u6570\uff0c\u6307\u4e0e\u8be5\u6743\u91cd\u76f8\u5173\u7684\u5173\u8282 \u504f\u501a\u7cfb\u6570\uff0c\u7528\u4e8e\u8c03\u8282\u8be5\u6743\u91cd\u7684\u5f71\u54cd\u3002 \u8be5\u6743\u91cd\u7684\u4f4d\u7f6e\u3002 \u4e0b\u56fe\u7528\u793a\u4f8b\u6570\u636e\u8bf4\u660e\u4e86\u4e0a\u8ff0\u7ec4\u5206\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u597d\u4e86\uff0c\u73b0\u5728\u4e86\u89e3\u4e86\u7f51\u683c\u6a21\u578b\u6587\u4ef6\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u6790\u5b83\u4e86\u3002\u5982\u679c\u4f60\u770b\u4e86\u6e90\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5df2\u7ecf\u521b\u5efa\u4e86\u65b0\u7684\u5305\u6765\u5bb9\u7eb3\u6a21\u578b\u683c\u5f0f\u7684\u89e3\u6790\u5668\u3002\u5728 org.lwjglb.engine.loaders.obj \u5305\u4e0b\u6709\u4e00\u4e2a\u89e3\u6790OBJ\u6587\u4ef6\u7684\u4ee3\u7801\uff0c\u800c\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5728 org.lwjglb.engine.loaders.md5 \u5305\u4e0b\u3002 \u6240\u6709\u7684\u89e3\u6790\u4ee3\u7801\u90fd\u57fa\u4e8e\u6b63\u5219\u8868\u8fbe\u5f0f\u4eceMD5\u6587\u672c\u6587\u4ef6\u4e2d\u63d0\u53d6\u4fe1\u606f\u3002\u89e3\u6790\u5668\u5c06\u521b\u5efa\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\u5bf9\u8c61\uff0c\u4ee5\u6a21\u62dfMD5\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u4fe1\u606f\u7ec4\u4ef6\u7684\u7ed3\u6784\u3002\u5b83\u53ef\u80fd\u4e0d\u662f\u4e16\u754c\u4e0a\u6700\u9ad8\u6548\u7684\u89e3\u6790\u5668\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5c06\u6709\u52a9\u4e8e\u66f4\u597d\u5730\u7406\u89e3\u8fd9\u4e2a\u8fc7\u7a0b\u3002 \u89e3\u6790MD5\u6a21\u578b\u6587\u4ef6\u7684\u8d77\u59cb\u7c7b\u662f MD5Model \u7c7b\uff0c\u8be5\u7c7b\u5728\u5176\u89e3\u6790\u65b9\u6cd5\u4e2d\u4f5c\u4e3a\u53c2\u6570\u88ab\u63a5\u6536\u3002MD5\u6587\u4ef6\u7684\u5185\u5bb9\u662f\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u5934\u3001\u8282\u70b9\u5217\u8868\u548c\u6240\u6709\u5b50\u5143\u7d20\u7684\u7f51\u683c\u5217\u8868\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6240\u4ee5\u4e0d\u5305\u542b\u5728\u672c\u6587\u4e2d\u4e86\u3002 \u5173\u4e8e\u89e3\u6790\u4ee3\u7801\u7684\u4e00\u4e9b\u6ce8\u91ca\uff1a \u7f51\u683c\u7684\u5b50\u5143\u7d20\u88ab\u5b9a\u4e49\u4e3a MD5Mesh \u7c7b\u7684\u5185\u90e8\u7c7b\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u5728 MD5Utils \u7c7b\u7684 calculateQuaternion \u65b9\u6cd5\u4e2d\u8ba1\u7b97\u5173\u8282\u65b9\u5411\u7684\u7b2c\u56db\u4e2a\u5206\u91cf\u3002 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u89e3\u6790\u4e86\u4e00\u4e2a\u6587\u4ef6\uff0c\u6211\u4eec\u5fc5\u987b\u8bb2\u8fd9\u4e2a\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u6e38\u620f\u5f15\u64ce\u5904\u7406\u7684\u4e1c\u897f\uff0c\u6211\u4eec\u5fc5\u987b\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MD5Loader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u4f7f\u7528\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u6765\u6784\u9020\u4e00\u4e2a GameItem \u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5982\u4f60\u6240\u6ce8\u610f\u5230\u7684\uff0cMD5\u6a21\u578b\u6709\u597d\u51e0\u4e2a\u7f51\u683c\uff0c\u4f46\u6211\u4eec\u7684 GameItem \u7c7b\u53ea\u652f\u6301\u5355\u4e2a\u7f51\u683c\u3002\u6240\u4ee5\u9996\u5148\u6211\u4eec\u8981\u4fee\u6539\u5b83\uff0c GameItem \u7c7b\u73b0\u5728\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private Mesh[] meshes; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem() { position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public GameItem(Mesh mesh) { this(); this.meshes = new Mesh[]{mesh}; } public GameItem(Mesh[] meshes) { this(); this.meshes = meshes; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return meshes[0]; } public Mesh[] getMeshes() { return meshes; } public void setMeshes(Mesh[] meshes) { this.meshes = meshes; } public void setMesh(Mesh mesh) { if (this.meshes != null) { for (Mesh currMesh : meshes) { currMesh.cleanUp(); } } this.meshes = new Mesh[]{mesh}; } } \u901a\u8fc7\u4e0a\u8ff0\u4fee\u6539\uff0c\u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7f16\u5199 MD5Loader \u7c7b\u7684\u5185\u5bb9\u3002\u8be5\u7c7b\u5c06\u6709\u4e00\u4e2a\u540d\u4e3a process \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u53d7\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u548c\u4e00\u4e2a\u9ed8\u8ba4\u989c\u8272\uff08\u5bf9\u4e8e\u4e0d\u5b9a\u4e49\u7eb9\u7406\u7684\u7f51\u683c\uff09\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u8be5\u65b9\u6cd5\u7684\u65b9\u6cd5\u4f53\u5982\u4e0b\uff1a public static GameItem process(MD5Model md5Model, Vector4f defaultColour) throws Exception { List<MD5Mesh> md5MeshList = md5Model.getMeshes(); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh, defaultColour); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); GameItem gameItem = new GameItem(meshes); return gameItem; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b9a\u4e49\u5728 MD5Model \u7c7b\u4e4b\u5185\u7684\u7f51\u683c\u8fdb\u884c\u904d\u5386\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528 generateMesh \u65b9\u6cd5\uff0c\u5c06\u5176\u8f6c\u6362\u4e3a org.lwjglb.engine.graph.Mesh \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u67e5\u770b\u8be5\u65b9\u6cd5\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u4e3a\u6211\u4eec\u6784\u5efa\u5750\u6807\u548c\u6cd5\u7ebf\u6570\u7ec4\u3002 private static class VertexInfo { public Vector3f position; public Vector3f normal; public VertexInfo(Vector3f position) { this.position = position; normal = new Vector3f(0, 0, 0); } public VertexInfo() { position = new Vector3f(); normal = new Vector3f(); } public static float[] toPositionsArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.position.x; result[i + 1] = v.position.y; result[i + 2] = v.position.z; i += 3; } return result; } public static float[] toNormalArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.normal.x; result[i + 1] = v.normal.y; result[i + 2] = v.normal.z; i += 3; } return result; } } \u56de\u5230 generateMesh \u65b9\u6cd5\uff0c\u9996\u5148\u6211\u4eec\u5f97\u5230\u5173\u8282\u7684\u7f51\u683c\u9876\u70b9\u4fe1\u606f\u3001\u6743\u91cd\u548c\u7ed3\u6784\u3002 private static Mesh generateMesh(MD5Model md5Model, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { List<VertexInfo> vertexInfoList = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); List<Integer> indices = new ArrayList<>(); List<MD5Mesh.MD5Vertex> vertices = md5Mesh.getVertices(); List<MD5Mesh.MD5Weight> weights = md5Mesh.getWeights(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); \u63a5\u4e0b\u6765\u6211\u4eec\u9700\u8981\u6839\u636e\u5305\u542b\u5728\u6743\u91cd\u548c\u5173\u8282\u4e2d\u7684\u4fe1\u606f\u6765\u8ba1\u7b97\u9876\u70b9\u4f4d\u7f6e\u3002\u8fd9\u662f\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\u7684\uff1a for (MD5Mesh.MD5Vertex vertex : vertices) { Vector3f vertexPos = new Vector3f(); Vector2f vertexTextCoords = vertex.getTextCoords(); textCoords.add(vertexTextCoords.x); textCoords.add(vertexTextCoords.y); int startWeight = vertex.getStartWeight(); int numWeights = vertex.getWeightCount(); for (int i = startWeight; i < startWeight + numWeights; i++) { MD5Mesh.MD5Weight weight = weights.get(i); MD5JointInfo.MD5JointData joint = joints.get(weight.getJointIndex()); Vector3f rotatedPos = new Vector3f(weight.getPosition()).rotate(joint.getOrientation()); Vector3f acumPos = new Vector3f(joint.getPosition()).add(rotatedPos); acumPos.mul(weight.getBias()); vertexPos.add(acumPos); } vertexInfoList.add(new VertexInfo(vertexPos)); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5728\u8fd9\u91cc\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u904d\u5386\u4e86\u9876\u70b9\u4fe1\u606f\u5e76\u5c06\u7eb9\u7406\u5750\u6807\u50a8\u5b58\u5728\u5217\u8868\u4e2d\uff0c\u4e0d\u9700\u8981\u5728\u8fd9\u91cc\u5e94\u7528\u4efb\u4f55\u53d8\u6362\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230\u4e86\u8ba1\u7b97\u9876\u70b9\u5750\u6807\u6240\u9700\u8003\u8651\u7684\u8d77\u59cb\u6743\u91cd\u548c\u603b\u6743\u91cd\u3002 \u9876\u70b9\u5750\u6807\u662f\u901a\u8fc7\u4f7f\u7528\u6240\u6709\u4e0e\u4e4b\u76f8\u5173\u7684\u6743\u91cd\u6765\u8ba1\u7b97\u7684\u3002\u6bcf\u4e2a\u6743\u91cd\u90fd\u6709\u4e00\u4e2a\u5750\u6807\u548c\u4e00\u4e2a\u504f\u501a\u3002\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u6240\u6709\u504f\u501a\u4e4b\u548c\u5fc5\u987b\u4e3a1.0\u3002\u6bcf\u4e2a\u6743\u91cd\u4e5f\u6709\u4e00\u4e2a\u5728\u5173\u8282\u7684\u5c40\u90e8\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5173\u8282\u7684\u65b9\u5411\u548c\u5750\u6807\uff08\u5c31\u50cf\u5b83\u662f\u4e00\u4e2a\u8f6c\u6362\u77e9\u9635\u90a3\u6837\uff09\u5c06\u5176\u8f6c\u6362\u4e3a\u5b83\u6240\u5f15\u7528\u7684\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u3002 \u7efc\u4e0a\u6240\u8ff0\uff0c\u9876\u70b9\u5750\u6807\u53ef\u4ee5\u7528\u5982\u4e0b\u516c\u5f0f\u8868\u793a\uff1a Vpos = \\sum\\limits_{i=ws}^{ws + wc} (Jt_{i} \\times Wp_{i}) \\dot Wb_{i} \u53c2\u6570\uff1a \u4ece ws \uff08\u8d77\u59cb\u6743\u91cd\uff09\u5230 wc \uff08\u6743\u91cd\u6570\uff09\u6743\u91cd\u603b\u548c\u3002 Jt_{i} \u662f\u4e0e\u6743\u91cd W_{i} \u76f8\u5173\u7684\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Wp_{i} \u662f\u6743\u91cd\u5750\u6807\u3002 Wb_{i} \u662f\u6743\u91cd\u504f\u501a\u3002 \u8be5\u65b9\u7a0b\u662f\u5728\u5faa\u73af\u4f53\u4e2d\u5b9e\u73b0\u7684\uff08\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u77e9\u9635\uff0c\u4f46\u7ed3\u679c\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u6709\u5355\u72ec\u7684\u5173\u8282\u5750\u6807\u548c\u65cb\u8f6c\uff09\u3002 \u4f7f\u7528\u4e0a\u8ff0\u4ee3\u7801\uff0c\u6211\u4eec\u5c31\u80fd\u591f\u6784\u9020\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u6570\u636e\uff0c\u4f46\u662f\u4ecd\u7136\u9700\u8981\u5efa\u7acb\u7d22\u5f15\u548c\u6cd5\u7ebf\u3002\u7d22\u5f15\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e09\u89d2\u5f62\u7684\u4fe1\u606f\u8ba1\u7b97\uff0c\u53ea\u9700\u904d\u5386\u5305\u542b\u8fd9\u4e9b\u4e09\u89d2\u5f62\u7684\u5217\u8868\u5373\u53ef\u3002 \u6cd5\u7ebf\u4e5f\u53ef\u4ee5\u7528\u4e09\u89d2\u5f62\u4fe1\u606f\u6765\u8ba1\u7b97\uff0c\u4ee4 V_{0} \u3001 V_{1} \u548c V_{2} \u4e3a\u4e09\u89d2\u5f62\u9876\u70b9\uff08\u5728\u7269\u4f53\u7684\u6a21\u578b\u7a7a\u95f4\u4e2d\uff09\u3002\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u53ef\u4ee5\u6839\u636e\u5982\u4e0b\u516c\u5f0f\u8ba1\u7b97\uff1a N=(V_{2}-V_{0})\\times(V_{1}-V_{0}) \u5176\u4e2dN\u5e94\u8be5\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u662f\u4e0a\u8ff0\u516c\u5f0f\u7684\u51e0\u4f55\u89e3\u91ca\uff1a \u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u901a\u8fc7\u5b83\u6240\u5c5e\u7684\u4e09\u89d2\u5f62\u7684\u6240\u6709\u6cd5\u7ebf\u7684\u5f52\u4e00\u5316\u4e4b\u548c\u6765\u8ba1\u7b97\u5b83\u7684\u6cd5\u7ebf\u3002\u8fdb\u884c\u8ba1\u7b97\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a for (MD5Mesh.MD5Triangle tri : md5Mesh.getTriangles()) { indices.add(tri.getVertex0()); indices.add(tri.getVertex1()); indices.add(tri.getVertex2()); // \u6cd5\u7ebf VertexInfo v0 = vertexInfoList.get(tri.getVertex0()); VertexInfo v1 = vertexInfoList.get(tri.getVertex1()); VertexInfo v2 = vertexInfoList.get(tri.getVertex2()); Vector3f pos0 = v0.position; Vector3f pos1 = v1.position; Vector3f pos2 = v2.position; Vector3f normal = (new Vector3f(pos2).sub(pos0)).cross(new Vector3f(pos1).sub(pos0)); v0.normal.add(normal); v1.normal.add(normal); v2.normal.add(normal); } // \u4e00\u65e6\u5b8c\u6210\u4e86\u8ba1\u7b97\uff0c\u5c31\u5c06\u7ed3\u679c\u5f52\u4e00\u5316 for(VertexInfo v : vertexInfoList) { v.normal.normalize(); } \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5217\u8868\u8f6c\u6362\u4e3a\u6570\u7ec4\u5e76\u5904\u7406\u7eb9\u7406\u4fe1\u606f\u3002 float[] positionsArr = VertexInfo.toPositionsArr(vertexInfoList); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = VertexInfo.toNormalArr(vertexInfoList); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); Mesh mesh = new Mesh(positionsArr, textCoordsArr, normalsArr, indicesArr); return mesh; } \u56de\u5230 process \u65b9\u6cd5\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6709\u4e2a\u540d\u4e3a handleTexture \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u52a0\u8f7d\u7eb9\u7406\u3002\u8fd9\u5c31\u662f\u8be5\u65b9\u6cd5\u7684\u5b9a\u4e49\uff1a private static void handleTexture(Mesh mesh, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { String texturePath = md5Mesh.getTexture(); if (texturePath != null && texturePath.length() > 0) { Texture texture = new Texture(texturePath); Material material = new Material(texture); // \u5904\u7406\u6cd5\u7ebf\u56fe int pos = texturePath.lastIndexOf(\".\"); if (pos > 0) { String basePath = texturePath.substring(0, pos); String extension = texturePath.substring(pos, texturePath.length()); String normalMapFileName = basePath + NORMAL_FILE_SUFFIX + extension; if (Utils.existsResourceFile(normalMapFileName)) { Texture normalMap = new Texture(normalMapFileName); material.setNormalMap(normalMap); } } mesh.setMaterial(material); } else { mesh.setMaterial(new Material(defaultColour, 1)); } } \u975e\u5e38\u76f4\u63a5\u7684\u5b9e\u73b0\u3002\u552f\u4e00\u7684\u72ec\u7279\u4e4b\u5904\u5728\u4e8e\u5982\u679c\u4e00\u4e2a\u7f51\u683c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a\u201ctexture.png\u201d\u7684\u7eb9\u7406\uff0c\u5b83\u7684\u6cd5\u7ebf\u7eb9\u7406\u56fe\u5c06\u5728\u6587\u4ef6\u201ctexture_normal.png\u201d\u4e2d\u5b9a\u4e49\u3002\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8be5\u6587\u4ef6\u662f\u5426\u5b58\u5728\u5e76\u76f8\u5e94\u5730\u52a0\u8f7d\u5b83\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u52a0\u8f7d\u4e00\u4e2aMD5\u6587\u4ef6\u5e76\u50cf\u6e32\u67d3\u5176\u4ed6\u6e38\u620f\u9879\u4e00\u6837\u6e32\u67d3\u5b83\uff0c\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u7981\u7528\u9762\u5254\u9664\u6765\u6b63\u786e\u6e32\u67d3\u5b83\uff0c\u56e0\u4e3a\u4e0d\u662f\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5c06\u7ed8\u5236\u5728\u6b63\u786e\u7684\u65b9\u5411\u4e0a\u3002\u6211\u4eec\u5c06\u5411 Window \u7c7b\u6dfb\u52a0\u652f\u6301\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff08\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5176\u53d8\u66f4\uff09\u3002 \u5982\u679c\u52a0\u8f7d\u4e00\u4e9b\u5b9e\u4f8b\u6a21\u578b\uff0c\u5c31\u4f1a\u5f97\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u679c\uff1a \u4f60\u5728\u6b64\u5904\u770b\u5230\u7684\u662f\u7ed1\u5b9a\u7684\u59ff\u52bf\uff0c\u5b83\u662fMD5\u6a21\u578b\u7684\u9759\u6001\u5c55\u793a\uff0c\u4f7f\u52a8\u753b\u5e08\u8f7b\u677e\u5730\u5bf9\u5b83\u4eec\u5efa\u6a21\u3002\u4e3a\u4e86\u8ba9\u52a8\u753b\u5de5\u4f5c\uff0c\u6211\u4eec\u5fc5\u987b\u5904\u7406\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u3002 \u6a21\u578b\u52a8\u753b MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff0c\u5c31\u50cf\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u90a3\u6837\uff0c\u7531\u4e00\u4e2a\u5934\u548c\u4e00\u4e2a\u5305\u542b\u5728\u5927\u62ec\u53f7\u4e4b\u95f4\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u5982\u679c\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\u6587\u4ef6\uff0c\u53ef\u4ee5\u770b\u5230\u7c7b\u4f3c\u7684\u7ed3\u6784\u3002 \u53ef\u4ee5\u5728\u52a8\u753b\u6587\u4ef6\u4e2d\u627e\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\uff08\u5c31\u50cf\u662f\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e00\u6837\uff09\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u4ece\u63a5\u4e0b\u6765\u63d0\u4f9b\u7684\u4e00\u4e2a\u4f8b\u5b50\u4e2d\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numFrames 140 numJoints 33 frameRate 24 numAnimatedComponents 198 \u5934\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u6240\u7b26\u5408\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\uff08\u6765\u81ea3D\u5efa\u6a21\u5de5\u5177\uff09 \u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u5e27\u6570\u3002 \u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u6570\u91cf\u3002 \u5e27\u901f\u7387\uff0c\u6bcf\u79d2\u5e27\u6570\uff0c\u7528\u4e8e\u521b\u5efa\u52a8\u753b\u3002\u8fd9\u4e2a\u53c2\u6570\u53ef\u4ee5\u7528\u6765\u8ba1\u7b97\u5e27\u4e0e\u5e27\u4e4b\u95f4\u7684\u65f6\u95f4\u3002 \u6bcf\u4e2a\u5e27\u5b9a\u4e49\u7684\u5206\u91cf\u6570\u91cf\u3002\uff08\u8bd1\u6ce8\uff1a\u901a\u5e38\u60c5\u51b5\u4e0b\u7b49\u4e8e\u5173\u8282\u6570\u4e58\u4ee5\u516d\uff09 \u9996\u5148\u51fa\u73b0\u7684\u662f\u5c42\u6b21\u7ed3\u6784\uff08Hierarchy\uff09\u90e8\u5206\uff0c\u5b83\u5b9a\u4e49\u4e86\u8be5\u52a8\u753b\u7684\u5173\u8282\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4ee5\u4e0b\u7247\u6bb5\uff1a hierarchy { \"origin\" -1 0 0 // \"body\" 0 63 0 // origin ( Tx Ty Tz Qx Qy Qz ) \"body2\" 1 0 0 // body \"SPINNER\" 2 56 6 // body2 ( Qx Qy Qz ) .... } \u4e00\u4e2a\u5173\u8282\uff0c\u5728\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\uff0c\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\uff0c\u5f15\u53f7\u4e4b\u95f4\u7684\u4e00\u4e2a\u6587\u672c\u5c5e\u6027 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u4e00\u4e2a\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u5176\u5728\u5173\u8282\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u8282\u70b9\u7b49\u4e8e-1\u3002 \u5173\u8282\u6807\u5fd7\uff0c\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\uff0c\u8bbe\u7f6e\u8be5\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u5c06\u5982\u4f55\u6539\u53d8\u3002 \u8d77\u59cb\u7d22\u5f15\uff0c\u5f53\u5e94\u7528\u6807\u5fd7\u65f6\uff0c\u7528\u4e8e\u6bcf\u5e27\u7684\u52a8\u753b\u6570\u636e\u5185\u3002 \u4e0b\u4e00\u8282\u662f\u8fb9\u754c\uff08Bounds\uff09\u3002\u672c\u8282\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u6a21\u578b\u7684\u8fb9\u754c\u6846\u3002\u5b83\u5c06\u4e3a\u6bcf\u4e00\u5e27\u52a8\u753b\u50a8\u5b58\u4e00\u884c\u6570\u636e\uff0c\u770b\u8d77\u6765\u5c31\u50cf\u662f\u8fd9\u6837\uff1a bounds { ( -24.3102264404 -44.2608566284 -0.181215778 ) ( 31.0861988068 38.7131576538 117.7417449951 ) ( -24.3102283478 -44.1887664795 -0.1794649214 ) ( 31.1800289154 38.7173080444 117.7729110718 ) ( -24.3102359772 -44.1144447327 -0.1794776917 ) ( 31.2042789459 38.7091217041 117.8352737427 ) .... } \u6bcf\u4e2a\u8fb9\u754c\u6846\u7531\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u4e24\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5c0f\u503c\uff0c\u7b2c\u4e8c\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5927\u503c\u3002 \u4e0b\u4e00\u8282\u662f\u57fa\u672c\u5e27\uff08Base Frame\uff09\u6570\u636e\u3002\u5728\u672c\u8282\u4e2d\uff0c\u5728\u5e94\u7528\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u5f62\u53d8\u4e4b\u524d\uff0c\u8bbe\u7f6e\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4e0b\u9762\u7684\u7247\u6bb5\uff1a baseframe { ( 0 0 0 ) ( -0.5 -0.5 -0.5 ) ( -0.8947336078 70.7142486572 -6.5027675629 ) ( -0.3258574307 -0.0083037354 0.0313780755 ) ( 0.0000001462 0.0539700091 -0.0137935728 ) ( 0 0 0 ) .... } \u6bcf\u4e00\u884c\u90fd\u4e0e\u4e00\u4e2a\u5173\u8282\u76f8\u5173\u8054\uff0c\u5e76\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u5173\u8282\u7684\u5750\u6807\uff0c\u662f\u4e00\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u3002 \u5173\u8282\u7684\u65b9\u5411\uff0c\u662f\u4e00\u4e2a\u56db\u5143\u6570\u7684\u4e09\u4e2a\u5206\u91cf\uff08\u6b63\u5982\u6a21\u578b\u6587\u4ef6\u91cc\u7684\u90a3\u6837\uff09\u3002 \u5728\u6b64\u4e4b\u540e\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u4e2a\u5e27\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5206\u914d\u7ed9 numFrames \u5934\u5c5e\u6027\u7684\u503c\u3002\u6bcf\u4e2a\u5e27\u7684\u8282\u5c31\u50cf\u662f\u4e00\u4e2a\u5de8\u5927\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u5f53\u5bf9\u6bcf\u4e2a\u5e27\u5e94\u7528\u53d8\u6362\u65f6\uff0c\u8282\u70b9\u5c06\u4f7f\u7528\u8fd9\u4e2a\u6d6e\u70b9\u6570\u7ec4\u3002\u4f60\u53ef\u4ee5\u5728\u63a5\u4e0b\u6765\u770b\u5230\u4e00\u4e2a\u7247\u6bb5\uff1a frame 1 { -0.9279100895 70.682762146 -6.3709330559 -0.3259022534 -0.0100501738 0.0320306309 0.3259022534 0.0100501738 -0.0320306309 -0.1038384438 -0.1639953405 -0.0152553488 0.0299418624 .... } \u89e3\u6790MD5\u52a8\u753b\u6587\u4ef6\u7684\u57fa\u7c7b\u540d\u4e3a MD5AnimModel \u3002\u8be5\u7c7b\u521b\u5efa\u7531\u8be5\u6587\u4ef6\u5185\u5bb9\u6620\u5c04\u7684\u6240\u6709\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4ee5\u83b7\u5f97\u8be6\u7ec6\u4fe1\u606f\u3002\u7ed3\u6784\u7c7b\u4f3c\u4e8eMD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u3002\u73b0\u5728\u6211\u4eec\u80fd\u591f\u52a0\u8f7d\u8fd9\u4e9b\u6570\u636e\uff0c\u5e76\u5c06\u4f7f\u7528\u5b83\u6765\u751f\u6210\u52a8\u753b\u3002 \u6211\u4eec\u5c06\u5728\u7740\u8272\u5668\u4e2d\u751f\u6210\u52a8\u753b\uff0c\u6240\u4ee5\u4e0d\u662f\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6240\u6709\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u51c6\u5907\u6240\u9700\u7684\u6570\u636e\uff0c\u8fd9\u6837\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\u4e2d\u7684 process \u65b9\u6cd5\uff0c\u9700\u8981\u4fee\u6539\u5b83\u4ee5\u8003\u8651\u52a8\u753b\u6570\u636e\u3002\u65b0\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public static AnimGameItem process(MD5Model md5Model, MD5AnimModel animModel, Vector4f defaultColour) throws Exception { List<Matrix4f> invJointMatrices = calcInJointMatrices(md5Model); List<AnimatedFrame> animatedFrames = processAnimationFrames(md5Model, animModel, invJointMatrices); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); AnimGameItem result = new AnimGameItem(meshes, animatedFrames, invJointMatrices); return result; } \u8fd9\u91cc\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u6700\u660e\u663e\u7684\u662f\u8be5\u65b9\u6cd5\u73b0\u5728\u63a5\u6536\u4e00\u4e2a MD5AnimModel \u5b9e\u4f8b\u3002\u6b64\u5916\uff0c\u6211\u4eec\u4e0d\u8fd4\u56de GameItem \u5b9e\u4f8b\uff0c\u800c\u662f\u8fd4\u56de AnimGameItem \u5b9e\u4f8b\u3002\u8be5\u7c7b\u7ee7\u627f\u81ea GameItem \u7c7b\uff0c\u4f46\u6dfb\u52a0\u4e86\u5bf9\u52a8\u753b\u7684\u652f\u6301\u3002\u7a0d\u540e\u6211\u4eec\u5c06\u770b\u5230\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002 \u5982\u679c\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb\u8be5\u5904\u7406\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u8c03\u7528 calcInJointMatrices \u65b9\u6cd5\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private static List<Matrix4f> calcInJointMatrices(MD5Model md5Model) { List<Matrix4f> result = new ArrayList<>(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); for(MD5JointInfo.MD5JointData joint : joints) { Matrix4f translateMat = new Matrix4f().translate(joint.getPosition()); Matrix4f rotationMat = new Matrix4f().rotate(joint.getOrientation()); Matrix4f mat = translateMat.mul(rotationMat); mat.invert(); result.add(mat); } return result; } \u8be5\u65b9\u6cd5\u904d\u5386MD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u8282\u70b9\uff0c\u8ba1\u7b97\u4e0e\u6bcf\u4e2a\u8282\u70b9\u76f8\u5173\u8054\u7684\u8f6c\u6362\u77e9\u9635\uff0c\u7136\u540e\u5f97\u5230\u8fd9\u4e9b\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u6b64\u6570\u636e\u7528\u4e8e\u6784\u9020 AnimGameItem \u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb process \u65b9\u6cd5\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u8c03\u7528 processAnimationFrames \u65b9\u6cd5\u6765\u5904\u7406\u52a8\u753b\u5e27\uff1a private static List<AnimatedFrame> processAnimationFrames(MD5Model md5Model, MD5AnimModel animModel, List<Matrix4f> invJointMatrices) { List<AnimatedFrame> animatedFrames = new ArrayList<>(); List<MD5Frame> frames = animModel.getFrames(); for(MD5Frame frame : frames) { AnimatedFrame data = processAnimationFrame(md5Model, animModel, frame, invJointMatrices); animatedFrames.add(data); } return animatedFrames; } \u8be5\u65b9\u6cd5\u5904\u7406MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\u3002\u771f\u6b63\u7684\u5de5\u4f5c\u662f\u5728 processAnimationFrame \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8ba9\u6211\u6765\u89e3\u91ca\u4e00\u4e0b\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4f5c\u7528\u3002 \u9996\u5148\uff0c\u904d\u5386MD5\u52a8\u753b\u6587\u4ef6\u7684\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u3002 private static AnimatedFrame processAnimationFrame(MD5Model md5Model, MD5AnimModel animModel, MD5Frame frame, List<Matrix4f> invJointMatrices) { AnimatedFrame result = new AnimatedFrame(); MD5BaseFrame baseFrame = animModel.getBaseFrame(); List<MD5Hierarchy.MD5HierarchyData> hierarchyList = animModel.getHierarchy().getHierarchyDataList(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); int numJoints = joints.size(); float[] frameData = frame.getFrameData(); for (int i = 0; i < numJoints; i++) { MD5JointInfo.MD5JointData joint = joints.get(i); \u6211\u4eec\u5f97\u5230\u4e0e\u6bcf\u4e2a\u5173\u8282\u76f8\u5173\u8054\u7684\u57fa\u672c\u5e27\u5143\u7d20\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002 MD5BaseFrame.MD5BaseFrameData baseFrameData = baseFrame.getFrameDataList().get(i); Vector3f position = baseFrameData.getPosition(); Quaternionf orientation = baseFrameData.getOrientation(); \u539f\u5219\u4e0a\uff0c\u8be5\u6570\u636e\u5e94\u5206\u914d\u7ed9\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u4f46\u5b83\u9700\u8981\u6839\u636e\u5173\u8282\u7684\u6807\u5fd7\u8fdb\u884c\u8f6c\u6362\u3002\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\uff0c\u5728\u5c55\u793a\u52a8\u753b\u6587\u4ef6\u7684\u7ed3\u6784\u65f6\uff0c\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u7684\u6bcf\u4e2a\u8282\u70b9\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6807\u5fd7\u3002\u8be5\u6807\u5fd7\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u4fe1\u606f\u51b3\u5b9a\u5efa\u6a21\u4f4d\u7f6e\u548c\u65b9\u5411\u5e94\u8be5\u5982\u4f55\u66f4\u6539\u3002 \u5982\u679c\u6807\u5fd7\u5b57\u6bb5\u7684\u7b2c\u4e00\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u4f7f\u7528\u6b63\u5728\u5904\u7406\u7684\u52a8\u753b\u5e27\u4e2d\u5305\u542b\u7684\u6570\u636e\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684x\u5206\u91cf\u3002\u52a8\u753b\u5e27\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u53d6\u54ea\u4e2a\u5143\u7d20\u5462\uff1f\u7b54\u6848\u4e5f\u5728\u5173\u8282\u5b9a\u4e49\u4e2d\uff0c\u5176\u4e2d\u5305\u542b startIndex \u5c5e\u6027\u3002\u5982\u679c\u6807\u5fd7\u7684\u7b2c\u4e8c\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u7528 startIndex + 1 \u7684\u503c\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684y\u5206\u91cf\uff0c\u4ee5\u6b64\u7c7b\u63a8\uff0c\u63a5\u4e0b\u6765\u7684\u662f\u5750\u6807\u7684z\u5206\u91cf\uff0c\u4ee5\u53ca\u65b9\u5411\u7684x\u3001y\u548cz\u5206\u91cf\u3002 int flags = hierarchyList.get(i).getFlags(); int startIndex = hierarchyList.get(i).getStartIndex(); if ( (flags & 1 ) > 0) { position.x = frameData[startIndex++]; } if ( (flags & 2) > 0) { position.y = frameData[startIndex++]; } if ( (flags & 4) > 0) { position.z = frameData[startIndex++]; } if ( (flags & 8) > 0) { orientation.x = frameData[startIndex++]; } if ( (flags & 16) > 0) { orientation.y = frameData[startIndex++]; } if ( (flags & 32) > 0) { orientation.z = frameData[startIndex++]; } // \u66f4\u65b0\u56db\u5143\u6570\u7684w\u5206\u91cf orientation = MD5Utils.calculateQuaternion(orientation.x, orientation.y, orientation.z); \u73b0\u5728\u6211\u4eec\u6709\u4e86\u8ba1\u7b97\u53d8\u6362\u77e9\u9635\u6240\u9700\u7684\u6240\u6709\u6570\u636e\uff0c\u4ece\u800c\u5f97\u5230\u5f53\u524d\u52a8\u753b\u5e27\u7684\u6bcf\u4e2a\u5173\u8282\u7684\u6700\u7ec8\u4f4d\u7f6e\u3002\u4f46\u662f\u6211\u4eec\u5fc5\u987b\u8003\u8651\u53e6\u4e00\u4ef6\u4e8b\uff0c\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5b83\u7684\u7236\u5173\u8282\u7684\u4f4d\u7f6e\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5f97\u5230\u4e0e\u6bcf\u4e2a\u7236\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u5e76\u7528\u5b83\u6765\u5f97\u5230\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u53d8\u6362\u77e9\u9635\u3002 // \u8ba1\u7b97\u8fd9\u4e2a\u5173\u8282\u7684\u5e73\u79fb\u548c\u65cb\u8f6c\u77e9\u9635 Matrix4f translateMat = new Matrix4f().translate(position); Matrix4f rotationMat = new Matrix4f().rotate(orientation); Matrix4f jointMat = translateMat.mul(rotationMat); // \u5173\u8282\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5173\u8282\u7684\u7236\u7d22\u5f15\u7684\u4f4d\u7f6e\u3002 // \u4f7f\u7528\u7236\u77e9\u9635\u5c06\u5176\u8f6c\u6362\u4e3a\u6a21\u578b\u7a7a\u95f4\u3002 if ( joint.getParentIndex() > -1 ) { Matrix4f parentMatrix = result.getLocalJointMatrices()[joint.getParentIndex()]; jointMat = new Matrix4f(parentMatrix).mul(jointMat); } result.setMatrix(i, jointMat, invJointMatrices.get(i)); } return result; } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u521b\u5efa\u4e86 AnimatedFrame \u7c7b\u7684\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u8be5\u7c7b\u5305\u542b\u5c06\u5728\u52a8\u753b\u671f\u95f4\u4f7f\u7528\u7684\u6570\u636e\u3002\u8fd9\u4e2a\u7c7b\u4e5f\u4f7f\u7528\u9006\u77e9\u9635\uff0c\u7a0d\u540e\u6211\u4eec\u4f1a\u77e5\u9053\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c AnimatedFrame \u7684 setMatrix \u65b9\u6cd5\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a public void setMatrix(int pos, Matrix4f localJointMatrix, Matrix4f invJointMatrix) { localJointMatrices[pos] = localJointMatrix; Matrix4f mat = new Matrix4f(localJointMatrix); mat.mul(invJointMatrix); jointMatrices[pos] = mat; } \u53d8\u91cf localJointMatrix \u50a8\u5b58\u5f53\u524d\u5e27\u4e2d\u5360\u636e\u4f4d\u7f6e\u201ci\u201d\u7684\u5173\u8282\u7684\u65cb\u8f6c\u77e9\u9635\uff0c invJointMatrix \u6301\u6709\u5360\u636e\u7ed1\u5b9a\u59ff\u52bf\u4f4d\u7f6e\u201ci\u201d\u4f4d\u7f6e\u7684\u5173\u8282\u7684\u9006\u53d8\u6362\u77e9\u9635\u3002\u6211\u4eec\u50a8\u5b58\u4e86 localJointMatrix \u4e0e invJointMatrix \u77e9\u9635\u76f8\u4e58\u7684\u7ed3\u679c\u3002\u8fd9\u4e2a\u7ed3\u679c\u5c06\u5728\u7a0d\u540e\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002\u6211\u4eec\u8fd8\u50a8\u5b58\u4e86\u539f\u59cb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\uff0c\u53d8\u91cf localJointMatrix \uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u7528\u5b83\u6765\u8ba1\u7b97\u5b50\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\uff0c generateMesh \u65b9\u6cd5\u4e5f\u53d1\u751f\u4e86\u53d8\u5316\uff0c\u5982\u6211\u4eec\u4e4b\u524d\u8bf4\u660e\u7684\u90a3\u6837\u8ba1\u7b97\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u4f46\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u50a8\u5b58\u4e24\u4e2a\u6570\u7ec4\uff1a \u4e00\u4e2a\u6570\u7ec4\uff0c\u50a8\u5b58\u7740\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u504f\u501a\u3002 \u4e00\u4e2a\u8f93\u51fa\uff0c\u50a8\u5b58\u8fd9\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u5173\u8282\u7d22\u5f15\uff08\u901a\u8fc7\u6743\u91cd\uff09\u3002 \u6211\u4eec\u5c06\u8fd9\u4e9b\u6570\u7ec4\u7684\u5927\u5c0f\u9650\u5236\u4e3a4\u3002 Mesh \u7c7b\u4e5f\u88ab\u4fee\u6539\u4e3a\u63a5\u6536\u8fd9\u4e9b\u53c2\u6570\uff0c\u5e76\u5c06\u5176\u5305\u542b\u5728\u7740\u8272\u5668\u5904\u7406\u7684VAO\u6570\u636e\u4e2d\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u8be6\u7ec6\u5185\u5bb9\uff0c\u4f46\u6765\u56de\u987e\u4e00\u4e0b\u6211\u4eec\u6240\u505a\u7684\uff1a \u6211\u4eec\u4ecd\u5728\u52a0\u8f7d\u7ed1\u5b9a\u59ff\u52bf\uff0c\u901a\u8fc7\u6743\u91cd\u6570\u636e\u8ba1\u7b97\u51fa\u5b83\u4eec\u7684\u6700\u7ec8\u4f4d\u7f6e\uff0c\u5373\u5173\u8282\u5750\u6807\u548c\u65b9\u5411\u7684\u603b\u548c\u3002 \u8fd9\u4e9b\u6570\u636e\u4ee5VBO\u7684\u5f62\u5f0f\u52a0\u8f7d\u5230\u7740\u8272\u5668\u4e2d\uff0c\u4f46\u662f\u5b83\u7531\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u504f\u501a\u548c\u5f71\u54cd\u5b83\u7684\u5173\u8282\u7684\u7d22\u5f15\u6765\u8865\u5145\u3002\u8fd9\u4e2a\u6570\u636e\u5bf9\u6240\u6709\u52a8\u753b\u5e27\u90fd\u662f\u901a\u7528\u7684\uff0c\u56e0\u4e3a\u5b83\u662f\u5728MD5\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9650\u5236\u504f\u501a\u548c\u5173\u8282\u7d22\u5f15\u6570\u7ec4\u5927\u5c0f\u7684\u539f\u56e0\uff0c\u5f53\u6a21\u578b\u88ab\u53d1\u9001\u5230GPU\u65f6\uff0c\u5b83\u4eec\u5c06\u88ab\u52a0\u8f7d\u4e3aVBO\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u6211\u4eec\u6839\u636e\u57fa\u7840\u5e27\u4e2d\u5b9a\u4e49\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u50a8\u5b58\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u5b9a\u4e49\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u77e5\u9053\u5982\u4f55\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u5b8c\u6210\u7684\u53d8\u6362\uff0c\u7a0d\u540e\u5c06\u770b\u5230\u5982\u4f55\u5e94\u7528\u5b83\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u62fc\u56fe\u7684\u6240\u6709\u788e\u7247\uff0c\u53ea\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u9996\u5148\u9700\u8981\u4fee\u6539\u8f93\u5165\u6570\u636e\u6765\u63a5\u6536\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u3002 #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; \u6211\u4eec\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff1a MAX_WEIGHTS \uff0c\u5b9a\u4e49\u6743\u91cdVBO\uff08\u4e00\u4e2a\u5355\u72ec\u7684\u5173\u8282\u7d22\u5f15\uff09\u4e2d\u7684\u6743\u91cd\u7684\u6700\u5927\u6570\u91cf\u3002 MAX_JOINTS \uff0c\u5b9a\u4e49\u4e86\u6211\u4eec\u5c06\u652f\u6301\u7684\u6700\u5927\u5173\u8282\u6570\u91cf\uff08\u7a0d\u540e\u5c06\u8be6\u7ec6\u4ecb\u7ecd\uff09\u3002 \u7136\u540e\u6211\u4eec\u5b9a\u4e49\u8f93\u51fa\u6570\u636e\u548cUniform\u3002 out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a jointsMatrix \u7684\u65b0Uniform\uff0c\u5b83\u662f\u4e00\u4e2a\u77e9\u9635\u6570\u7ec4\uff08\u6700\u5927\u957f\u5ea6\u7531 MAX_JOINTS \u5e38\u91cf\u8bbe\u7f6e\uff09\u3002\u8be5\u77e9\u9635\u6570\u7ec4\u5305\u542b\u5f53\u524d\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u5173\u8282\u77e9\u9635\uff0c\u5e76\u5728\u5904\u7406\u5e27\u65f6\u5728 MD5Loader \u7c7b\u4e2d\u8ba1\u7b97\u3002\u56e0\u6b64\uff0c\u8be5\u6570\u7ec4\u5305\u542b\u9700\u8981\u5e94\u7528\u4e8e\u5f53\u524d\u52a8\u753b\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u53d8\u6362\uff0c\u5e76\u5c06\u4f5c\u4e3a\u8ba1\u7b97\u9876\u70b9\u6700\u7ec8\u5750\u6807\u7684\u57fa\u7840\u3002 \u4f7f\u7528VBO\u4e2d\u7684\u65b0\u6570\u636e\u548c\u8be5Uniform\uff0c\u6211\u4eec\u5c06\u53d8\u6362\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\u3002\u8fd9\u5c06\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\uff1a vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } \u9996\u5148\uff0c\u6211\u4eec\u5f97\u5230\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u904d\u5386\u4e0e\u8fd9\u4e2a\u9876\u70b9\u5173\u8054\u7684\u6743\u91cd\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528\u50a8\u5b58\u5728\u8f93\u5165\u4e2d\u7684\u7d22\u5f15\uff0c\u4f7f\u7528\u8be5\u5e27\uff08\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\uff09\u7684\u6743\u91cd\u548c\u5173\u8282\u77e9\u9635\u4fee\u6539\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u4e2a\u9876\u70b9\u5750\u6807\uff0c\u6211\u4eec\u8ba1\u7b97\u5b83\u7684\u5e27\u5750\u6807\uff1a Vfp = \\sum\\limits_{i=0}^{MAX WEIGTHS} Wb_{i} \\dot (Jfp_{i} \\times Jt^{-1}_{i}) \\times Vpos \u53c2\u6570\uff1a Wfvp \u662f\u9876\u70b9\u7684\u6700\u7ec8\u5750\u6807\u3002 Wb \u662f\u9876\u70b9\u7684\u6743\u91cd\u3002 Jfp \u662f\u8fd9\u4e2a\u5750\u6807\u7cfb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u3002 Jt^{-1} \u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u8fd9\u4e2a\u77e9\u9635\u4e0e Jfp \u7684\u6210\u7ee9\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\u3002 Vpos \u662f\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u7684\u9876\u70b9\u5750\u6807\u3002 Vpos \u7531 Jt \u77e9\u9635\u8ba1\u7b97\uff0c\u8fd9\u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u77e9\u9635\u3002\u6240\u4ee5\uff0c\u6700\u540e\u6211\u4eec\u8981\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u7684\u4fee\u6539\u6765\u5e94\u7528\u8be5\u5750\u6807\u7cfb\u7684\u53d8\u6362\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9700\u8981\u9006\u7ed1\u5b9a\u59ff\u52bf\u77e9\u9635\u7684\u539f\u56e0\u3002 \u7740\u8272\u5668\u652f\u6301\u6743\u91cd\u53ef\u53d8\u7684\u9876\u70b9\uff0c\u6700\u591a\u53ef\u8fbe4\u4e2a\uff0c\u8fd8\u53ef\u4ee5\u6e32\u67d3\u975e\u52a8\u753b\u9879\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6743\u91cd\u7b49\u4e8e0\u6211\u4eec\u5c06\u5f97\u5230\u539f\u59cb\u5750\u6807\u3002 \u7740\u8272\u5668\u7684\u5176\u4f59\u90e8\u5206\u6216\u591a\u6216\u5c11\u4fdd\u6301\u4e0d\u53d8\uff0c\u6211\u4eec\u53ea\u662f\u4f7f\u7528\u66f4\u65b0\u540e\u7684\u5750\u6807\u5e76\u4f20\u9012\u7247\u5143\u7740\u8272\u5668\u8981\u4f7f\u7528\u7684\u6b63\u786e\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6240\u4ee5\uff0c\u4e3a\u4e86\u6d4b\u8bd5\u52a8\u753b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06 jointsMatrix \u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u7531\u4e8e\u6b64\u4fe1\u606f\u4ec5\u50a8\u5b58\u5728 AnimGameItem \u5b9e\u4f8b\u4e2d\uff0c\u56e0\u6b64\u4ee3\u7801\u975e\u5e38\u7b80\u5355\u3002\u5728\u6e32\u67d3\u7f51\u683c\u7684\u5faa\u73af\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u5982\u4e0b\u4ee3\u7801\u7247\u6bb5\uff1a if ( gameItem instanceof AnimGameItem ) { AnimGameItem animGameItem = (AnimGameItem)gameItem; AnimatedFrame frame = animGameItem.getCurrentFrame(); sceneShaderProgram.setUniform(\"jointsMatrix\", frame.getJointMatrices()); } \u5f53\u7136\uff0c\u5728\u4f7f\u7528\u5b83\u4e4b\u524d\uff0c\u4f60\u9700\u8981\u521b\u5efaUniform\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u8be5\u7c7b\u7684\u6e90\u4ee3\u7801\u3002\u5982\u679c\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u5c06\u80fd\u591f\u901a\u8fc7\u6309\u4e0b\u7a7a\u683c\u952e\u6765\u67e5\u770b\u6a21\u578b\u662f\u5982\u4f55\u52a8\u8d77\u6765\u7684\uff08\u6bcf\u6b21\u6309\u4e0b\u8fd9\u4e2a\u952e\uff0c\u90fd\u4f1a\u8bbe\u7f6e\u4e00\u4e2a\u65b0\u7684\u5e27\uff0c\u5e76\u4e14 jointsMatrix Uniform\u4f1a\u53d1\u751f\u53d8\u5316\uff09\u3002 \u4f60\u5c06\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u867d\u7136\u52a8\u753b\u5f88\u6d41\u7545\uff0c\u4f46\u793a\u4f8b\u8fd8\u662f\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u5149\u7167\u6ca1\u6709\u6b63\u5e38\u7684\u5de5\u4f5c\uff0c\u9634\u5f71\u8868\u73b0\u7684\u662f\u7ed1\u5b9a\u59ff\u52bf\uff0c\u800c\u4e0d\u662f\u5f53\u524d\u5e27\u3002\u6211\u4eec\u73b0\u5728\u5c06\u89e3\u51b3\u6240\u6709\u8fd9\u4e9b\u95ee\u9898\u3002 \u4fee\u6b63\u52a8\u753b\u95ee\u9898 \u7b2c\u4e00\u4e2a\u8981\u89e3\u51b3\u7684\u95ee\u9898\u662f\u5149\u7167\u95ee\u9898\u3002\u4f60\u53ef\u80fd\u5df2\u7ecf\u6ce8\u610f\u5230\u8fd9\u79cd\u60c5\u51b5\u4e86\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u6cd5\u7ebf\u3002\u56e0\u6b64\uff0c\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u6cd5\u7ebf\u4e0e\u7ed1\u5b9a\u59ff\u52bf\u76f8\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u50cf\u53d8\u6362\u4f4d\u7f6e\u4e00\u6837\u53d8\u6362\u5b83\u4eec\u3002 \u8fd9\u4e2a\u95ee\u9898\u5f88\u597d\u89e3\u51b3\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728\u5faa\u73af\u4e2d\u5c06\u6cd5\u7ebf\u4e5f\u56ca\u62ec\u5230\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u6743\u91cd\u904d\u5386\u3002 vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u7136\u540e\u6211\u4eec\u50cf\u5f80\u5e38\u4e00\u6837\u8ba1\u7b97\u8f93\u51fa\u9876\u70b9\u6cd5\u7ebf\u5411\u91cf\uff1a mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; \u63a5\u4e0b\u6765\u7684\u95ee\u9898\u662f\u9634\u5f71\u95ee\u9898\u3002\u5982\u679c\u4f60\u8bb0\u5f97\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u9634\u5f71\u56fe\u7ed8\u5236\u9634\u5f71\u3002\u6211\u4eec\u73b0\u5728\u6b63\u4ece\u5149\u7167\u900f\u89c6\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u521b\u5efa\u4e00\u4e2a\u6df1\u5ea6\u56fe\uff0c\u5b83\u544a\u8bc9\u6211\u4eec\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u9634\u5f71\u4e2d\u3002\u4f46\u662f\uff0c\u5728\u6cd5\u7ebf\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u6839\u636e\u5f53\u524d\u5e27\u6765\u6539\u53d8\u5b83\u4eec\u3002\u8fd9\u5c31\u662f\u9634\u5f71\u4e0e\u5f53\u524d\u5750\u6807\u4e0d\u4e00\u81f4\u7684\u539f\u56e0\u3002 \u89e3\u51b3\u65b9\u6cd5\u4e5f\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528 jointsMatrix \u3001\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u6765\u53d8\u6362\u5750\u6807\u3002\u8fd9\u5c31\u662f\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } gl_Position = orthoProjectionMatrix * modelLightViewMatrix * initPos; } \u4f60\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u6765\u4e3a\u8fd9\u4e2a\u7740\u8272\u5668\u8bbe\u7f6e\u65b0\u7684Uniform\uff0c\u6700\u7ec8\u7684\u6548\u679c\u4f1a\u66f4\u597d\u3002\u5149\u7167\u5c06\u88ab\u6b63\u786e\u7684\u5e94\u7528\uff0c\u9634\u5f71\u5c06\u968f\u6bcf\u4e2a\u52a8\u753b\u5e27\u6539\u53d8\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\u4e86\uff0c\u73b0\u5728\u4f60\u5df2\u7ecf\u6709\u4e86\u4e00\u4e2a\u7528\u4e8e\u52a8\u753bMD5\u6a21\u578b\u7684\u53ef\u5de5\u4f5c\u793a\u4f8b\u3002\u6e90\u4ee3\u7801\u4ecd\u80fd\u6539\u8fdb\uff0c\u4f60\u53ef\u4ee5\u4fee\u6539\u5728\u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u4e2d\u52a0\u8f7d\u7684\u77e9\u9635\uff0c\u4ee5\u4fbf\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u4e2d\u4f7f\u7528\u7684\u8d44\u6e90\uff0c\u4e86\u89e3\u5982\u4f55\u5b9e\u73b0\u8be5\u529f\u80fd\u3002","title":"\u52a8\u753b"},{"location":"19-animations/#animations","text":"","title":"\u52a8\u753b\uff08Animations\uff09"},{"location":"19-animations/#_1","text":"\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u52a0\u8f7d\u4e86\u9759\u60013D\u6a21\u578b\uff0c\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4e3a\u5b83\u4eec\u8bbe\u7f6e\u52a8\u753b\u3002\u5728\u601d\u8003\u52a8\u753b\u65f6\uff0c\u9996\u5148\u60f3\u5230\u7684\u65b9\u6cd5\u662f\u4e3a\u6bcf\u4e2a\u6a21\u578b\u72b6\u6001\u521b\u5efa\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u5c06\u5b83\u4eec\u52a0\u8f7d\u5230GPU\u4e2d\uff0c\u7136\u540e\u6309\u987a\u5e8f\u7ed8\u5236\uff0c\u4ee5\u6b64\u9020\u6210\u52a8\u753b\u7684\u5047\u8c61\u3002\u867d\u7136\u8fd9\u79cd\u65b9\u6cd5\u5bf9\u4e8e\u67d0\u4e9b\u6e38\u620f\u6765\u8bf4\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u662f\u5b83\u7684\u6548\u7387\u4e0d\u662f\u5f88\u9ad8\uff08\u5c31\u5185\u5b58\u6d88\u8017\u6765\u8bf4\uff09\u3002 \u8fd9\u5c31\u662f\u9aa8\u9abc\u52a8\u753b\uff08Skeletal Animation\uff09\u7684\u7528\u6b66\u4e4b\u5730\u3002\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u6a21\u578b\u7684\u52a8\u753b\u65b9\u5f0f\u7531\u5176\u5e95\u5c42\u9aa8\u67b6\uff08Skeletal\uff09\u5b9a\u4e49\uff0c\u9aa8\u67b6\u662f\u7531\u88ab\u79f0\u4e3a\u5173\u8282\uff08Joints\uff09\u7684\u7279\u6b8a\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u5b9a\u4e49\u7684\uff0c\u8fd9\u4e9b\u5173\u8282\u53c8\u7531\u5b83\u4eec\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u6765\u5b9a\u4e49\u3002\u6211\u4eec\u4e5f\u8bf4\u8fc7\u8fd9\u662f\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u5173\u952e\u7684\u6700\u7ec8\u4f4d\u7f6e\u90fd\u6536\u5230\u5b83\u4eec\u7684\u7236\u5c42\u6b21\u7684\u5f71\u54cd\u3002\u4ee5\u624b\u8155\u4e3a\u4f8b\uff0c\u5982\u679c\u89d2\u8272\u79fb\u52a8\u8098\u90e8\u548c\u80a9\u8180\uff0c\u624b\u8155\u7684\u4f4d\u7f6e\u5c31\u4f1a\u53d1\u751f\u6539\u53d8\u3002 \u5173\u8282\u4e0d\u9700\u8981\u8868\u793a\u4e00\u4e2a\u5408\u4e4e\u73b0\u5b9e\u7684\u9aa8\u9abc\u6216\u5173\u8282\uff0c\u5b83\u4eec\u662f\u4eba\u5de5\u8bbe\u7f6e\u7684\uff0c\u5141\u8bb8\u521b\u4f5c\u8005\u5efa\u6a21\u52a8\u753b\u3002\u9664\u4e86\u5173\u8282\uff0c\u6211\u4eec\u8fd8\u6709\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u9876\u70b9\u662f\u6839\u636e\u4e0e\u4e4b\u76f8\u5173\u7684\u5173\u8282\u7684\u4f4d\u7f6e\u7ed8\u5236\u7684\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528MD5\u683c\u5f0f\u6765\u52a0\u8f7d\u6709\u52a8\u753b\u7684\u6a21\u578b\u3002MD5\u683c\u5f0f\u662f\u7531\u300a\u6bc1\u706d\u6218\u58eb\u300b\u7684\u5f00\u53d1\u5546ID Software\u5236\u5b9a\u7684\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u79cd\u57fa\u4e8e\u6587\u672c\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u6613\u4e8e\u7406\u89e3\u3002\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u4f7f\u7528 Collada \u683c\u5f0f\uff0c\u8fd9\u662f\u8bb8\u591a\u5de5\u5177\u652f\u6301\u7684\u516c\u5171\u6807\u51c6\u3002Collada\u662f\u4e00\u79cd\u57fa\u4e8eXML\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u4f46\u5b83\u7684\u7f3a\u70b9\u662f\u975e\u5e38\u590d\u6742\uff081.5\u7248\u672c\u7684\u89c4\u8303\u5c31\u6709500\u591a\u9875\uff09\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u575a\u6301\u4f7f\u7528\u4e00\u79cd\u66f4\u7b80\u5355\u7684\u683c\u5f0f\uff0cMD5\uff0c\u5b83\u4f7f\u6211\u4eec\u4e13\u6ce8\u4e8e\u9aa8\u9abc\u52a8\u753b\u7684\u6982\u5ff5\u5e76\u521b\u5efa\u4e00\u4e2a\u53ef\u5de5\u4f5c\u7684\u793a\u4f8b\u3002 \u4f60\u8fd8\u53ef\u4ee5\u901a\u8fc7\u5728\u4e92\u8054\u7f51\u4e0a\u627e\u5230 \u7279\u5b9a\u63d2\u4ef6 \u5c06\u4e00\u4e9b\u6a21\u578b\u4eceBlender\u5bfc\u51fa\u4e3aMD5\u683c\u5f0f\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u53c2\u8003\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u8d44\u6599\uff0c\u4f46\u662f\u6211\u53d1\u73b0\u6709\u4e24\u4e2a\u8d44\u6599\u53ef\u4ee5\u5f88\u597d\u5730\u89e3\u91ca\u5982\u4f55\u4f7f\u7528MD5\u6587\u4ef6\u521b\u5efa\u52a8\u753b\u6a21\u578b\u3002\u8fd9\u4e9b\u8d44\u6599\u7684\u6765\u6e90\u5982\u4e0b\uff1a http://www.3dgep.com/gpu-skinning-of-md5-models-in-opengl-and-cg/ http://ogldev.atspace.co.uk/www/tutorial38/tutorial38.html \u8ba9\u6211\u4eec\u4ece\u7f16\u5199\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5f00\u59cb\uff0cMD5\u683c\u5f0f\u5b9a\u4e49\u4e86\u4e24\u79cd\u7c7b\u578b\u7684\u6587\u4ef6\uff1a \u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b83\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u7f51\u683c\u96c6\u7684\u5173\u8282\u3001\u9876\u70b9\u548c\u7eb9\u7406\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5mesh \u7684\u6269\u5c55\u540d\u3002 \u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b9a\u4e49\u53ef\u4f7f\u7528\u4e8e\u6a21\u578b\u7684\u52a8\u753b\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5anim \u7684\u6269\u5c55\u540d\u3002 MD5\u6587\u4ef6\u7531\u5934\uff08Header\uff09\u548c\u5927\u62ec\u53f7\u4e4b\u95f4\u5305\u542b\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u67e5\u770b\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u3002\u5728\u53c2\u8003\u8d44\u6599\u6587\u4ef6\u5939\u4e2d\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u79cdMD5\u683c\u5f0f\u7684\u6a21\u578b\u3002\u5982\u679c\u4f60\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u6784\u3002 \u5728\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e2d\u53ef\u4ee5\u770b\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u5728\u4e0b\u8ff0\u63d0\u4f9b\u7684\u793a\u4f8b\u4e2d\uff0c\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numJoints 33 numMeshes 6 \u5934\u5b9a\u4e49\u4e86\u5982\u4e0b\u5c5e\u6027\uff1a \u5b83\u6240\u9075\u5faa\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\uff08\u4ece3D\u5efa\u6a21\u5de5\u5177\uff09\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\u3002 \u5728\u5173\u8282\u90e8\u5206\u5b9a\u4e49\u7684\u5173\u8282\u6570\u3002 \u7f51\u683c\u6570\uff08\u9700\u8981\u7684\u7f51\u683c\u8282\u6570\uff09\u3002 \u5173\u952e\u90e8\u5206\u5b9a\u4e49\u5173\u8282\u7684\u540d\u79f0\u3001\u72b6\u6001\u3001\u4f4d\u7f6e\u53ca\u5176\u5173\u7cfb\u3002\u4e0b\u9762\u5c55\u793a\u4e86\u4e00\u4e2a\u793a\u4f8b\u6a21\u578b\u7684\u5173\u8282\u90e8\u5206\u7684\u7247\u6bb5\uff1a joints { \"origin\" -1 ( -0.000000 0.016430 -0.006044 ) ( 0.707107 0.000000 0.707107 ) // \"sheath\" 0 ( 11.004813 -3.177138 31.702473 ) ( 0.307041 -0.578614 0.354181 ) // origin \"sword\" 1 ( 9.809593 -9.361549 40.753730 ) ( 0.305557 -0.578155 0.353505 ) // sheath \"pubis\" 0 ( 0.014076 2.064442 26.144581 ) ( -0.466932 -0.531013 -0.466932 ) // origin \u2026\u2026 } \u5173\u8282\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\u79f0\uff0c\u5f15\u53f7\u4e2d\u7684\u6587\u672c\u5c5e\u6027\u3002 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u7236\u5173\u8282\u5728\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u5173\u8282\u7b49\u4e8e-1\u3002 \u5173\u8282\u4f4d\u7f6e\uff0c\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u3002 \u5173\u8282\u65b9\u5411\uff0c\u4e5f\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\uff0c\u65b9\u5411\u5b9e\u9645\u4e0a\u662f\u4e00\u4e2a\u56db\u5143\u6570\uff0c\u4f46\u5176w\u5206\u91cf\u4e0d\u5305\u62ec\u5728\u6b64\u3002 \u5728\u7ee7\u7eed\u89e3\u91ca\u6587\u4ef6\u7684\u5176\u4f59\u90e8\u5206\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u6765\u8c08\u8c08\u56db\u5143\u6570\uff08Quaternions\uff09\u3002\u56db\u5143\u6570\u662f\u7528\u4e8e\u8868\u793a\u65cb\u8f6c\u7684\u56db\u4e2a\u6784\u6210\u5143\u7d20\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e00\u76f4\u5728\u4f7f\u7528\u6b27\u62c9\u89d2\uff08\u504f\u822a\u3001\u4fef\u4ef0\u548c\u6eda\u8f6c\uff09\u6765\u5b9a\u4e49\u65cb\u8f6c\uff0c\u8fd9\u57fa\u672c\u4e0a\u5b9a\u4e49\u4e86\u56f4\u7ed5x\u3001y\u548cz\u53eb\u7684\u65cb\u8f6c\u3002\u4f46\u662f\uff0c\u6b27\u62c9\u89d2\u5728\u5904\u7406\u65cb\u8f6c\u65f6\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\uff0c\u7279\u522b\u662f\u4f60\u5fc5\u987b\u77e5\u9053\u6b63\u786e\u7684\u65cb\u8f6c\u987a\u5e8f\uff0c\u5e76\u4e14\u4e00\u4e9b\u64cd\u4f5c\u4f1a\u53d8\u5f97\u975e\u5e38\u590d\u6742\u3002 \u56db\u5143\u6570\u6709\u52a9\u4e8e\u89e3\u51b3\u8fd9\u79cd\u590d\u6742\u60c5\u51b5\u3002\u6b63\u5982\u4e4b\u524d\u6240\u8bf4\uff0c\u56db\u5143\u6570\u88ab\u5b9a\u4e49\u4e3a4\u4e2a\u6570\u5b57\uff08x\uff0cy\uff0cz\uff0cw\uff09\u4e00\u7ec4\u3002\u56db\u5143\u6570\u5b9a\u4e49\u65cb\u8f6c\u8f74\u548c\u56f4\u7ed5\u8be5\u8f74\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u4f60\u53ef\u4ee5\u5728\u7f51\u7edc\u4e2d\u786e\u8ba4\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b66\u5b9a\u4e49\uff0c\u4f46\u597d\u6d88\u606f\u662f\u6211\u4eec\u4f7f\u7528\u7684\u6570\u5b66\u5e93JOML\u4e3a\u5176\u63d0\u4f9b\u4e86\u652f\u6301\u3002\u6211\u4eec\u53ef\u4ee5\u57fa\u4e8e\u56db\u5143\u6570\u6784\u9020\u65cb\u8f6c\u77e9\u9635\uff0c\u5e76\u7528\u5b83\u4eec\u5bf9\u5411\u91cf\u8fdb\u884c\u53d8\u6362\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u5173\u8282\u7684\u5b9a\u4e49\uff0c\u5176\u7f3a\u5c11 w \u5143\u7d20\uff0c\u4f46\u53ef\u4ee5\u5728\u5176\u4ed6\u503c\u7684\u5e2e\u52a9\u4e0b\u8f7b\u677e\u5730\u8ba1\u7b97\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u770b\u770b\u8fd9\u662f\u5982\u4f55\u505a\u5230\u7684\u3002 \u5728\u5173\u8282\u5b9a\u4e49\u4e4b\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u7ec4\u6210\u6a21\u578b\u7684\u4e0d\u540c\u7f51\u683c\u7684\u5b9a\u4e49\u3002\u63a5\u4e0b\u6765\u4f60\u53ef\u4ee5\u4ece\u5176\u4e2d\u4e00\u4e2a\u793a\u4f8b\u4e2d\u770b\u5230\u7f51\u683c\u5b9a\u4e49\u7684\u7247\u6bb5\uff1a mesh { shader \"/textures/bob/guard1_body.png\" numverts 494 vert 0 ( 0.394531 0.513672 ) 0 1 vert 1 ( 0.447266 0.449219 ) 1 2 ... vert 493 ( 0.683594 0.455078 ) 864 3 numtris 628 tri 0 0 2 1 tri 1 0 1 3 ... tri 627 471 479 493 numweights 867 weight 0 5 1.000000 ( 6.175774 8.105262 -0.023020 ) weight 1 5 0.500000 ( 4.880173 12.805251 4.196980 ) ... weight 866 6 0.333333 ( 1.266308 -0.302701 8.949338 ) } \u8ba9\u6211\u4eec\u770b\u770b\u4e0a\u8ff0\u5c55\u73b0\u7684\u7ed3\u6784\uff1a \u7f51\u683c\u4ece\u5b9a\u4e49\u7eb9\u7406\u6587\u4ef6\u5f00\u59cb\u3002\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5728\u6b64\u5904\u627e\u5230\u7684\u8def\u5f84\u662f\u521b\u5efa\u8be5\u6a21\u578b\u7684\u5de5\u5177\u6240\u4f7f\u7528\u7684\u8def\u5f84\u3002\u8be5\u8def\u5f84\u53ef\u80fd\u4e0e\u7528\u4e8e\u52a0\u8f7d\u8fd9\u4e9b\u6587\u4ef6\u7684\u8def\u5f84\u4e0d\u5339\u914d\u3002\u8fd9\u91cc\u6709\u4e24\u79cd\u65b9\u6cd5\u89e3\u51b3\uff0c\u8981\u4e48\u52a8\u6001\u4fee\u6539\u57fa\u672c\u8def\u5f84\uff0c\u8981\u4e48\u624b\u52a8\u4fee\u6539\u8be5\u8def\u5f84\u3002\u6211\u9009\u62e9\u4e86\u540e\u8005\uff0c\u6bd4\u8f83\u7b80\u5355\u7684\u4e00\u79cd\u3002 \u63a5\u4e0b\u6765\u53ef\u4ee5\u627e\u5230\u9876\u70b9\u5b9a\u4e49\u3002\u9876\u70b9\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u9876\u70b9\u7d22\u5f15\u3002 \u7eb9\u7406\u5750\u6807\u3002 \u5f71\u54cd\u6b64\u9876\u70b9\u7684\u7b2c\u4e00\u4e2a\u6743\u91cd\u5b9a\u4e49\u7684\u7d22\u5f15\u3002 \u8981\u8003\u8651\u7684\u6743\u91cd\u6570\u3002 \u5728\u9876\u70b9\u4e4b\u540e\uff0c\u5c06\u5b9a\u4e49\u6784\u6210\u6b64\u7f51\u683c\u7684\u4e09\u89d2\u5f62\u3002\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e86\u4f7f\u7528\u9876\u70b9\u7d22\u5f15\u7ec4\u7ec7\u9876\u70b9\u7684\u65b9\u5f0f\u3002 \u6700\u540e\uff0c\u5b9a\u4e49\u4e86\u6743\u91cd\u3002\u6743\u91cd\u5b9a\u4e49\u7531\u4ee5\u4e0b\u90e8\u5206\u7ec4\u6210\uff1a \u6743\u91cd\u6307\u6570\u3002 \u5173\u8282\u6307\u6570\uff0c\u6307\u4e0e\u8be5\u6743\u91cd\u76f8\u5173\u7684\u5173\u8282 \u504f\u501a\u7cfb\u6570\uff0c\u7528\u4e8e\u8c03\u8282\u8be5\u6743\u91cd\u7684\u5f71\u54cd\u3002 \u8be5\u6743\u91cd\u7684\u4f4d\u7f6e\u3002 \u4e0b\u56fe\u7528\u793a\u4f8b\u6570\u636e\u8bf4\u660e\u4e86\u4e0a\u8ff0\u7ec4\u5206\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u597d\u4e86\uff0c\u73b0\u5728\u4e86\u89e3\u4e86\u7f51\u683c\u6a21\u578b\u6587\u4ef6\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u6790\u5b83\u4e86\u3002\u5982\u679c\u4f60\u770b\u4e86\u6e90\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5df2\u7ecf\u521b\u5efa\u4e86\u65b0\u7684\u5305\u6765\u5bb9\u7eb3\u6a21\u578b\u683c\u5f0f\u7684\u89e3\u6790\u5668\u3002\u5728 org.lwjglb.engine.loaders.obj \u5305\u4e0b\u6709\u4e00\u4e2a\u89e3\u6790OBJ\u6587\u4ef6\u7684\u4ee3\u7801\uff0c\u800c\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5728 org.lwjglb.engine.loaders.md5 \u5305\u4e0b\u3002 \u6240\u6709\u7684\u89e3\u6790\u4ee3\u7801\u90fd\u57fa\u4e8e\u6b63\u5219\u8868\u8fbe\u5f0f\u4eceMD5\u6587\u672c\u6587\u4ef6\u4e2d\u63d0\u53d6\u4fe1\u606f\u3002\u89e3\u6790\u5668\u5c06\u521b\u5efa\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\u5bf9\u8c61\uff0c\u4ee5\u6a21\u62dfMD5\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u4fe1\u606f\u7ec4\u4ef6\u7684\u7ed3\u6784\u3002\u5b83\u53ef\u80fd\u4e0d\u662f\u4e16\u754c\u4e0a\u6700\u9ad8\u6548\u7684\u89e3\u6790\u5668\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5c06\u6709\u52a9\u4e8e\u66f4\u597d\u5730\u7406\u89e3\u8fd9\u4e2a\u8fc7\u7a0b\u3002 \u89e3\u6790MD5\u6a21\u578b\u6587\u4ef6\u7684\u8d77\u59cb\u7c7b\u662f MD5Model \u7c7b\uff0c\u8be5\u7c7b\u5728\u5176\u89e3\u6790\u65b9\u6cd5\u4e2d\u4f5c\u4e3a\u53c2\u6570\u88ab\u63a5\u6536\u3002MD5\u6587\u4ef6\u7684\u5185\u5bb9\u662f\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u5934\u3001\u8282\u70b9\u5217\u8868\u548c\u6240\u6709\u5b50\u5143\u7d20\u7684\u7f51\u683c\u5217\u8868\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6240\u4ee5\u4e0d\u5305\u542b\u5728\u672c\u6587\u4e2d\u4e86\u3002 \u5173\u4e8e\u89e3\u6790\u4ee3\u7801\u7684\u4e00\u4e9b\u6ce8\u91ca\uff1a \u7f51\u683c\u7684\u5b50\u5143\u7d20\u88ab\u5b9a\u4e49\u4e3a MD5Mesh \u7c7b\u7684\u5185\u90e8\u7c7b\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u5728 MD5Utils \u7c7b\u7684 calculateQuaternion \u65b9\u6cd5\u4e2d\u8ba1\u7b97\u5173\u8282\u65b9\u5411\u7684\u7b2c\u56db\u4e2a\u5206\u91cf\u3002 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u89e3\u6790\u4e86\u4e00\u4e2a\u6587\u4ef6\uff0c\u6211\u4eec\u5fc5\u987b\u8bb2\u8fd9\u4e2a\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u6e38\u620f\u5f15\u64ce\u5904\u7406\u7684\u4e1c\u897f\uff0c\u6211\u4eec\u5fc5\u987b\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MD5Loader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u4f7f\u7528\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u6765\u6784\u9020\u4e00\u4e2a GameItem \u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5982\u4f60\u6240\u6ce8\u610f\u5230\u7684\uff0cMD5\u6a21\u578b\u6709\u597d\u51e0\u4e2a\u7f51\u683c\uff0c\u4f46\u6211\u4eec\u7684 GameItem \u7c7b\u53ea\u652f\u6301\u5355\u4e2a\u7f51\u683c\u3002\u6240\u4ee5\u9996\u5148\u6211\u4eec\u8981\u4fee\u6539\u5b83\uff0c GameItem \u7c7b\u73b0\u5728\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private Mesh[] meshes; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem() { position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public GameItem(Mesh mesh) { this(); this.meshes = new Mesh[]{mesh}; } public GameItem(Mesh[] meshes) { this(); this.meshes = meshes; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return meshes[0]; } public Mesh[] getMeshes() { return meshes; } public void setMeshes(Mesh[] meshes) { this.meshes = meshes; } public void setMesh(Mesh mesh) { if (this.meshes != null) { for (Mesh currMesh : meshes) { currMesh.cleanUp(); } } this.meshes = new Mesh[]{mesh}; } } \u901a\u8fc7\u4e0a\u8ff0\u4fee\u6539\uff0c\u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7f16\u5199 MD5Loader \u7c7b\u7684\u5185\u5bb9\u3002\u8be5\u7c7b\u5c06\u6709\u4e00\u4e2a\u540d\u4e3a process \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u53d7\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u548c\u4e00\u4e2a\u9ed8\u8ba4\u989c\u8272\uff08\u5bf9\u4e8e\u4e0d\u5b9a\u4e49\u7eb9\u7406\u7684\u7f51\u683c\uff09\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u8be5\u65b9\u6cd5\u7684\u65b9\u6cd5\u4f53\u5982\u4e0b\uff1a public static GameItem process(MD5Model md5Model, Vector4f defaultColour) throws Exception { List<MD5Mesh> md5MeshList = md5Model.getMeshes(); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh, defaultColour); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); GameItem gameItem = new GameItem(meshes); return gameItem; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b9a\u4e49\u5728 MD5Model \u7c7b\u4e4b\u5185\u7684\u7f51\u683c\u8fdb\u884c\u904d\u5386\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528 generateMesh \u65b9\u6cd5\uff0c\u5c06\u5176\u8f6c\u6362\u4e3a org.lwjglb.engine.graph.Mesh \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u67e5\u770b\u8be5\u65b9\u6cd5\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u4e3a\u6211\u4eec\u6784\u5efa\u5750\u6807\u548c\u6cd5\u7ebf\u6570\u7ec4\u3002 private static class VertexInfo { public Vector3f position; public Vector3f normal; public VertexInfo(Vector3f position) { this.position = position; normal = new Vector3f(0, 0, 0); } public VertexInfo() { position = new Vector3f(); normal = new Vector3f(); } public static float[] toPositionsArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.position.x; result[i + 1] = v.position.y; result[i + 2] = v.position.z; i += 3; } return result; } public static float[] toNormalArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.normal.x; result[i + 1] = v.normal.y; result[i + 2] = v.normal.z; i += 3; } return result; } } \u56de\u5230 generateMesh \u65b9\u6cd5\uff0c\u9996\u5148\u6211\u4eec\u5f97\u5230\u5173\u8282\u7684\u7f51\u683c\u9876\u70b9\u4fe1\u606f\u3001\u6743\u91cd\u548c\u7ed3\u6784\u3002 private static Mesh generateMesh(MD5Model md5Model, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { List<VertexInfo> vertexInfoList = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); List<Integer> indices = new ArrayList<>(); List<MD5Mesh.MD5Vertex> vertices = md5Mesh.getVertices(); List<MD5Mesh.MD5Weight> weights = md5Mesh.getWeights(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); \u63a5\u4e0b\u6765\u6211\u4eec\u9700\u8981\u6839\u636e\u5305\u542b\u5728\u6743\u91cd\u548c\u5173\u8282\u4e2d\u7684\u4fe1\u606f\u6765\u8ba1\u7b97\u9876\u70b9\u4f4d\u7f6e\u3002\u8fd9\u662f\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\u7684\uff1a for (MD5Mesh.MD5Vertex vertex : vertices) { Vector3f vertexPos = new Vector3f(); Vector2f vertexTextCoords = vertex.getTextCoords(); textCoords.add(vertexTextCoords.x); textCoords.add(vertexTextCoords.y); int startWeight = vertex.getStartWeight(); int numWeights = vertex.getWeightCount(); for (int i = startWeight; i < startWeight + numWeights; i++) { MD5Mesh.MD5Weight weight = weights.get(i); MD5JointInfo.MD5JointData joint = joints.get(weight.getJointIndex()); Vector3f rotatedPos = new Vector3f(weight.getPosition()).rotate(joint.getOrientation()); Vector3f acumPos = new Vector3f(joint.getPosition()).add(rotatedPos); acumPos.mul(weight.getBias()); vertexPos.add(acumPos); } vertexInfoList.add(new VertexInfo(vertexPos)); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5728\u8fd9\u91cc\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u904d\u5386\u4e86\u9876\u70b9\u4fe1\u606f\u5e76\u5c06\u7eb9\u7406\u5750\u6807\u50a8\u5b58\u5728\u5217\u8868\u4e2d\uff0c\u4e0d\u9700\u8981\u5728\u8fd9\u91cc\u5e94\u7528\u4efb\u4f55\u53d8\u6362\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230\u4e86\u8ba1\u7b97\u9876\u70b9\u5750\u6807\u6240\u9700\u8003\u8651\u7684\u8d77\u59cb\u6743\u91cd\u548c\u603b\u6743\u91cd\u3002 \u9876\u70b9\u5750\u6807\u662f\u901a\u8fc7\u4f7f\u7528\u6240\u6709\u4e0e\u4e4b\u76f8\u5173\u7684\u6743\u91cd\u6765\u8ba1\u7b97\u7684\u3002\u6bcf\u4e2a\u6743\u91cd\u90fd\u6709\u4e00\u4e2a\u5750\u6807\u548c\u4e00\u4e2a\u504f\u501a\u3002\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u6240\u6709\u504f\u501a\u4e4b\u548c\u5fc5\u987b\u4e3a1.0\u3002\u6bcf\u4e2a\u6743\u91cd\u4e5f\u6709\u4e00\u4e2a\u5728\u5173\u8282\u7684\u5c40\u90e8\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5173\u8282\u7684\u65b9\u5411\u548c\u5750\u6807\uff08\u5c31\u50cf\u5b83\u662f\u4e00\u4e2a\u8f6c\u6362\u77e9\u9635\u90a3\u6837\uff09\u5c06\u5176\u8f6c\u6362\u4e3a\u5b83\u6240\u5f15\u7528\u7684\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u3002 \u7efc\u4e0a\u6240\u8ff0\uff0c\u9876\u70b9\u5750\u6807\u53ef\u4ee5\u7528\u5982\u4e0b\u516c\u5f0f\u8868\u793a\uff1a Vpos = \\sum\\limits_{i=ws}^{ws + wc} (Jt_{i} \\times Wp_{i}) \\dot Wb_{i} \u53c2\u6570\uff1a \u4ece ws \uff08\u8d77\u59cb\u6743\u91cd\uff09\u5230 wc \uff08\u6743\u91cd\u6570\uff09\u6743\u91cd\u603b\u548c\u3002 Jt_{i} \u662f\u4e0e\u6743\u91cd W_{i} \u76f8\u5173\u7684\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Wp_{i} \u662f\u6743\u91cd\u5750\u6807\u3002 Wb_{i} \u662f\u6743\u91cd\u504f\u501a\u3002 \u8be5\u65b9\u7a0b\u662f\u5728\u5faa\u73af\u4f53\u4e2d\u5b9e\u73b0\u7684\uff08\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u77e9\u9635\uff0c\u4f46\u7ed3\u679c\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u6709\u5355\u72ec\u7684\u5173\u8282\u5750\u6807\u548c\u65cb\u8f6c\uff09\u3002 \u4f7f\u7528\u4e0a\u8ff0\u4ee3\u7801\uff0c\u6211\u4eec\u5c31\u80fd\u591f\u6784\u9020\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u6570\u636e\uff0c\u4f46\u662f\u4ecd\u7136\u9700\u8981\u5efa\u7acb\u7d22\u5f15\u548c\u6cd5\u7ebf\u3002\u7d22\u5f15\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e09\u89d2\u5f62\u7684\u4fe1\u606f\u8ba1\u7b97\uff0c\u53ea\u9700\u904d\u5386\u5305\u542b\u8fd9\u4e9b\u4e09\u89d2\u5f62\u7684\u5217\u8868\u5373\u53ef\u3002 \u6cd5\u7ebf\u4e5f\u53ef\u4ee5\u7528\u4e09\u89d2\u5f62\u4fe1\u606f\u6765\u8ba1\u7b97\uff0c\u4ee4 V_{0} \u3001 V_{1} \u548c V_{2} \u4e3a\u4e09\u89d2\u5f62\u9876\u70b9\uff08\u5728\u7269\u4f53\u7684\u6a21\u578b\u7a7a\u95f4\u4e2d\uff09\u3002\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u53ef\u4ee5\u6839\u636e\u5982\u4e0b\u516c\u5f0f\u8ba1\u7b97\uff1a N=(V_{2}-V_{0})\\times(V_{1}-V_{0}) \u5176\u4e2dN\u5e94\u8be5\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u662f\u4e0a\u8ff0\u516c\u5f0f\u7684\u51e0\u4f55\u89e3\u91ca\uff1a \u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u901a\u8fc7\u5b83\u6240\u5c5e\u7684\u4e09\u89d2\u5f62\u7684\u6240\u6709\u6cd5\u7ebf\u7684\u5f52\u4e00\u5316\u4e4b\u548c\u6765\u8ba1\u7b97\u5b83\u7684\u6cd5\u7ebf\u3002\u8fdb\u884c\u8ba1\u7b97\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a for (MD5Mesh.MD5Triangle tri : md5Mesh.getTriangles()) { indices.add(tri.getVertex0()); indices.add(tri.getVertex1()); indices.add(tri.getVertex2()); // \u6cd5\u7ebf VertexInfo v0 = vertexInfoList.get(tri.getVertex0()); VertexInfo v1 = vertexInfoList.get(tri.getVertex1()); VertexInfo v2 = vertexInfoList.get(tri.getVertex2()); Vector3f pos0 = v0.position; Vector3f pos1 = v1.position; Vector3f pos2 = v2.position; Vector3f normal = (new Vector3f(pos2).sub(pos0)).cross(new Vector3f(pos1).sub(pos0)); v0.normal.add(normal); v1.normal.add(normal); v2.normal.add(normal); } // \u4e00\u65e6\u5b8c\u6210\u4e86\u8ba1\u7b97\uff0c\u5c31\u5c06\u7ed3\u679c\u5f52\u4e00\u5316 for(VertexInfo v : vertexInfoList) { v.normal.normalize(); } \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5217\u8868\u8f6c\u6362\u4e3a\u6570\u7ec4\u5e76\u5904\u7406\u7eb9\u7406\u4fe1\u606f\u3002 float[] positionsArr = VertexInfo.toPositionsArr(vertexInfoList); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = VertexInfo.toNormalArr(vertexInfoList); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); Mesh mesh = new Mesh(positionsArr, textCoordsArr, normalsArr, indicesArr); return mesh; } \u56de\u5230 process \u65b9\u6cd5\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6709\u4e2a\u540d\u4e3a handleTexture \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u52a0\u8f7d\u7eb9\u7406\u3002\u8fd9\u5c31\u662f\u8be5\u65b9\u6cd5\u7684\u5b9a\u4e49\uff1a private static void handleTexture(Mesh mesh, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { String texturePath = md5Mesh.getTexture(); if (texturePath != null && texturePath.length() > 0) { Texture texture = new Texture(texturePath); Material material = new Material(texture); // \u5904\u7406\u6cd5\u7ebf\u56fe int pos = texturePath.lastIndexOf(\".\"); if (pos > 0) { String basePath = texturePath.substring(0, pos); String extension = texturePath.substring(pos, texturePath.length()); String normalMapFileName = basePath + NORMAL_FILE_SUFFIX + extension; if (Utils.existsResourceFile(normalMapFileName)) { Texture normalMap = new Texture(normalMapFileName); material.setNormalMap(normalMap); } } mesh.setMaterial(material); } else { mesh.setMaterial(new Material(defaultColour, 1)); } } \u975e\u5e38\u76f4\u63a5\u7684\u5b9e\u73b0\u3002\u552f\u4e00\u7684\u72ec\u7279\u4e4b\u5904\u5728\u4e8e\u5982\u679c\u4e00\u4e2a\u7f51\u683c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a\u201ctexture.png\u201d\u7684\u7eb9\u7406\uff0c\u5b83\u7684\u6cd5\u7ebf\u7eb9\u7406\u56fe\u5c06\u5728\u6587\u4ef6\u201ctexture_normal.png\u201d\u4e2d\u5b9a\u4e49\u3002\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8be5\u6587\u4ef6\u662f\u5426\u5b58\u5728\u5e76\u76f8\u5e94\u5730\u52a0\u8f7d\u5b83\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u52a0\u8f7d\u4e00\u4e2aMD5\u6587\u4ef6\u5e76\u50cf\u6e32\u67d3\u5176\u4ed6\u6e38\u620f\u9879\u4e00\u6837\u6e32\u67d3\u5b83\uff0c\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u7981\u7528\u9762\u5254\u9664\u6765\u6b63\u786e\u6e32\u67d3\u5b83\uff0c\u56e0\u4e3a\u4e0d\u662f\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5c06\u7ed8\u5236\u5728\u6b63\u786e\u7684\u65b9\u5411\u4e0a\u3002\u6211\u4eec\u5c06\u5411 Window \u7c7b\u6dfb\u52a0\u652f\u6301\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff08\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5176\u53d8\u66f4\uff09\u3002 \u5982\u679c\u52a0\u8f7d\u4e00\u4e9b\u5b9e\u4f8b\u6a21\u578b\uff0c\u5c31\u4f1a\u5f97\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u679c\uff1a \u4f60\u5728\u6b64\u5904\u770b\u5230\u7684\u662f\u7ed1\u5b9a\u7684\u59ff\u52bf\uff0c\u5b83\u662fMD5\u6a21\u578b\u7684\u9759\u6001\u5c55\u793a\uff0c\u4f7f\u52a8\u753b\u5e08\u8f7b\u677e\u5730\u5bf9\u5b83\u4eec\u5efa\u6a21\u3002\u4e3a\u4e86\u8ba9\u52a8\u753b\u5de5\u4f5c\uff0c\u6211\u4eec\u5fc5\u987b\u5904\u7406\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u3002","title":"\u5f15\u8a00"},{"location":"19-animations/#_2","text":"MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff0c\u5c31\u50cf\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u90a3\u6837\uff0c\u7531\u4e00\u4e2a\u5934\u548c\u4e00\u4e2a\u5305\u542b\u5728\u5927\u62ec\u53f7\u4e4b\u95f4\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u5982\u679c\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\u6587\u4ef6\uff0c\u53ef\u4ee5\u770b\u5230\u7c7b\u4f3c\u7684\u7ed3\u6784\u3002 \u53ef\u4ee5\u5728\u52a8\u753b\u6587\u4ef6\u4e2d\u627e\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\uff08\u5c31\u50cf\u662f\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e00\u6837\uff09\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u4ece\u63a5\u4e0b\u6765\u63d0\u4f9b\u7684\u4e00\u4e2a\u4f8b\u5b50\u4e2d\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numFrames 140 numJoints 33 frameRate 24 numAnimatedComponents 198 \u5934\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u6240\u7b26\u5408\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\uff08\u6765\u81ea3D\u5efa\u6a21\u5de5\u5177\uff09 \u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u5e27\u6570\u3002 \u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u6570\u91cf\u3002 \u5e27\u901f\u7387\uff0c\u6bcf\u79d2\u5e27\u6570\uff0c\u7528\u4e8e\u521b\u5efa\u52a8\u753b\u3002\u8fd9\u4e2a\u53c2\u6570\u53ef\u4ee5\u7528\u6765\u8ba1\u7b97\u5e27\u4e0e\u5e27\u4e4b\u95f4\u7684\u65f6\u95f4\u3002 \u6bcf\u4e2a\u5e27\u5b9a\u4e49\u7684\u5206\u91cf\u6570\u91cf\u3002\uff08\u8bd1\u6ce8\uff1a\u901a\u5e38\u60c5\u51b5\u4e0b\u7b49\u4e8e\u5173\u8282\u6570\u4e58\u4ee5\u516d\uff09 \u9996\u5148\u51fa\u73b0\u7684\u662f\u5c42\u6b21\u7ed3\u6784\uff08Hierarchy\uff09\u90e8\u5206\uff0c\u5b83\u5b9a\u4e49\u4e86\u8be5\u52a8\u753b\u7684\u5173\u8282\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4ee5\u4e0b\u7247\u6bb5\uff1a hierarchy { \"origin\" -1 0 0 // \"body\" 0 63 0 // origin ( Tx Ty Tz Qx Qy Qz ) \"body2\" 1 0 0 // body \"SPINNER\" 2 56 6 // body2 ( Qx Qy Qz ) .... } \u4e00\u4e2a\u5173\u8282\uff0c\u5728\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\uff0c\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\uff0c\u5f15\u53f7\u4e4b\u95f4\u7684\u4e00\u4e2a\u6587\u672c\u5c5e\u6027 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u4e00\u4e2a\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u5176\u5728\u5173\u8282\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u8282\u70b9\u7b49\u4e8e-1\u3002 \u5173\u8282\u6807\u5fd7\uff0c\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\uff0c\u8bbe\u7f6e\u8be5\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u5c06\u5982\u4f55\u6539\u53d8\u3002 \u8d77\u59cb\u7d22\u5f15\uff0c\u5f53\u5e94\u7528\u6807\u5fd7\u65f6\uff0c\u7528\u4e8e\u6bcf\u5e27\u7684\u52a8\u753b\u6570\u636e\u5185\u3002 \u4e0b\u4e00\u8282\u662f\u8fb9\u754c\uff08Bounds\uff09\u3002\u672c\u8282\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u6a21\u578b\u7684\u8fb9\u754c\u6846\u3002\u5b83\u5c06\u4e3a\u6bcf\u4e00\u5e27\u52a8\u753b\u50a8\u5b58\u4e00\u884c\u6570\u636e\uff0c\u770b\u8d77\u6765\u5c31\u50cf\u662f\u8fd9\u6837\uff1a bounds { ( -24.3102264404 -44.2608566284 -0.181215778 ) ( 31.0861988068 38.7131576538 117.7417449951 ) ( -24.3102283478 -44.1887664795 -0.1794649214 ) ( 31.1800289154 38.7173080444 117.7729110718 ) ( -24.3102359772 -44.1144447327 -0.1794776917 ) ( 31.2042789459 38.7091217041 117.8352737427 ) .... } \u6bcf\u4e2a\u8fb9\u754c\u6846\u7531\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u4e24\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5c0f\u503c\uff0c\u7b2c\u4e8c\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5927\u503c\u3002 \u4e0b\u4e00\u8282\u662f\u57fa\u672c\u5e27\uff08Base Frame\uff09\u6570\u636e\u3002\u5728\u672c\u8282\u4e2d\uff0c\u5728\u5e94\u7528\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u5f62\u53d8\u4e4b\u524d\uff0c\u8bbe\u7f6e\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4e0b\u9762\u7684\u7247\u6bb5\uff1a baseframe { ( 0 0 0 ) ( -0.5 -0.5 -0.5 ) ( -0.8947336078 70.7142486572 -6.5027675629 ) ( -0.3258574307 -0.0083037354 0.0313780755 ) ( 0.0000001462 0.0539700091 -0.0137935728 ) ( 0 0 0 ) .... } \u6bcf\u4e00\u884c\u90fd\u4e0e\u4e00\u4e2a\u5173\u8282\u76f8\u5173\u8054\uff0c\u5e76\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u5173\u8282\u7684\u5750\u6807\uff0c\u662f\u4e00\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u3002 \u5173\u8282\u7684\u65b9\u5411\uff0c\u662f\u4e00\u4e2a\u56db\u5143\u6570\u7684\u4e09\u4e2a\u5206\u91cf\uff08\u6b63\u5982\u6a21\u578b\u6587\u4ef6\u91cc\u7684\u90a3\u6837\uff09\u3002 \u5728\u6b64\u4e4b\u540e\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u4e2a\u5e27\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5206\u914d\u7ed9 numFrames \u5934\u5c5e\u6027\u7684\u503c\u3002\u6bcf\u4e2a\u5e27\u7684\u8282\u5c31\u50cf\u662f\u4e00\u4e2a\u5de8\u5927\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u5f53\u5bf9\u6bcf\u4e2a\u5e27\u5e94\u7528\u53d8\u6362\u65f6\uff0c\u8282\u70b9\u5c06\u4f7f\u7528\u8fd9\u4e2a\u6d6e\u70b9\u6570\u7ec4\u3002\u4f60\u53ef\u4ee5\u5728\u63a5\u4e0b\u6765\u770b\u5230\u4e00\u4e2a\u7247\u6bb5\uff1a frame 1 { -0.9279100895 70.682762146 -6.3709330559 -0.3259022534 -0.0100501738 0.0320306309 0.3259022534 0.0100501738 -0.0320306309 -0.1038384438 -0.1639953405 -0.0152553488 0.0299418624 .... } \u89e3\u6790MD5\u52a8\u753b\u6587\u4ef6\u7684\u57fa\u7c7b\u540d\u4e3a MD5AnimModel \u3002\u8be5\u7c7b\u521b\u5efa\u7531\u8be5\u6587\u4ef6\u5185\u5bb9\u6620\u5c04\u7684\u6240\u6709\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4ee5\u83b7\u5f97\u8be6\u7ec6\u4fe1\u606f\u3002\u7ed3\u6784\u7c7b\u4f3c\u4e8eMD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u3002\u73b0\u5728\u6211\u4eec\u80fd\u591f\u52a0\u8f7d\u8fd9\u4e9b\u6570\u636e\uff0c\u5e76\u5c06\u4f7f\u7528\u5b83\u6765\u751f\u6210\u52a8\u753b\u3002 \u6211\u4eec\u5c06\u5728\u7740\u8272\u5668\u4e2d\u751f\u6210\u52a8\u753b\uff0c\u6240\u4ee5\u4e0d\u662f\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6240\u6709\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u51c6\u5907\u6240\u9700\u7684\u6570\u636e\uff0c\u8fd9\u6837\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\u4e2d\u7684 process \u65b9\u6cd5\uff0c\u9700\u8981\u4fee\u6539\u5b83\u4ee5\u8003\u8651\u52a8\u753b\u6570\u636e\u3002\u65b0\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public static AnimGameItem process(MD5Model md5Model, MD5AnimModel animModel, Vector4f defaultColour) throws Exception { List<Matrix4f> invJointMatrices = calcInJointMatrices(md5Model); List<AnimatedFrame> animatedFrames = processAnimationFrames(md5Model, animModel, invJointMatrices); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); AnimGameItem result = new AnimGameItem(meshes, animatedFrames, invJointMatrices); return result; } \u8fd9\u91cc\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u6700\u660e\u663e\u7684\u662f\u8be5\u65b9\u6cd5\u73b0\u5728\u63a5\u6536\u4e00\u4e2a MD5AnimModel \u5b9e\u4f8b\u3002\u6b64\u5916\uff0c\u6211\u4eec\u4e0d\u8fd4\u56de GameItem \u5b9e\u4f8b\uff0c\u800c\u662f\u8fd4\u56de AnimGameItem \u5b9e\u4f8b\u3002\u8be5\u7c7b\u7ee7\u627f\u81ea GameItem \u7c7b\uff0c\u4f46\u6dfb\u52a0\u4e86\u5bf9\u52a8\u753b\u7684\u652f\u6301\u3002\u7a0d\u540e\u6211\u4eec\u5c06\u770b\u5230\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002 \u5982\u679c\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb\u8be5\u5904\u7406\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u8c03\u7528 calcInJointMatrices \u65b9\u6cd5\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private static List<Matrix4f> calcInJointMatrices(MD5Model md5Model) { List<Matrix4f> result = new ArrayList<>(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); for(MD5JointInfo.MD5JointData joint : joints) { Matrix4f translateMat = new Matrix4f().translate(joint.getPosition()); Matrix4f rotationMat = new Matrix4f().rotate(joint.getOrientation()); Matrix4f mat = translateMat.mul(rotationMat); mat.invert(); result.add(mat); } return result; } \u8be5\u65b9\u6cd5\u904d\u5386MD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u8282\u70b9\uff0c\u8ba1\u7b97\u4e0e\u6bcf\u4e2a\u8282\u70b9\u76f8\u5173\u8054\u7684\u8f6c\u6362\u77e9\u9635\uff0c\u7136\u540e\u5f97\u5230\u8fd9\u4e9b\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u6b64\u6570\u636e\u7528\u4e8e\u6784\u9020 AnimGameItem \u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb process \u65b9\u6cd5\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u8c03\u7528 processAnimationFrames \u65b9\u6cd5\u6765\u5904\u7406\u52a8\u753b\u5e27\uff1a private static List<AnimatedFrame> processAnimationFrames(MD5Model md5Model, MD5AnimModel animModel, List<Matrix4f> invJointMatrices) { List<AnimatedFrame> animatedFrames = new ArrayList<>(); List<MD5Frame> frames = animModel.getFrames(); for(MD5Frame frame : frames) { AnimatedFrame data = processAnimationFrame(md5Model, animModel, frame, invJointMatrices); animatedFrames.add(data); } return animatedFrames; } \u8be5\u65b9\u6cd5\u5904\u7406MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\u3002\u771f\u6b63\u7684\u5de5\u4f5c\u662f\u5728 processAnimationFrame \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8ba9\u6211\u6765\u89e3\u91ca\u4e00\u4e0b\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4f5c\u7528\u3002 \u9996\u5148\uff0c\u904d\u5386MD5\u52a8\u753b\u6587\u4ef6\u7684\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u3002 private static AnimatedFrame processAnimationFrame(MD5Model md5Model, MD5AnimModel animModel, MD5Frame frame, List<Matrix4f> invJointMatrices) { AnimatedFrame result = new AnimatedFrame(); MD5BaseFrame baseFrame = animModel.getBaseFrame(); List<MD5Hierarchy.MD5HierarchyData> hierarchyList = animModel.getHierarchy().getHierarchyDataList(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); int numJoints = joints.size(); float[] frameData = frame.getFrameData(); for (int i = 0; i < numJoints; i++) { MD5JointInfo.MD5JointData joint = joints.get(i); \u6211\u4eec\u5f97\u5230\u4e0e\u6bcf\u4e2a\u5173\u8282\u76f8\u5173\u8054\u7684\u57fa\u672c\u5e27\u5143\u7d20\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002 MD5BaseFrame.MD5BaseFrameData baseFrameData = baseFrame.getFrameDataList().get(i); Vector3f position = baseFrameData.getPosition(); Quaternionf orientation = baseFrameData.getOrientation(); \u539f\u5219\u4e0a\uff0c\u8be5\u6570\u636e\u5e94\u5206\u914d\u7ed9\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u4f46\u5b83\u9700\u8981\u6839\u636e\u5173\u8282\u7684\u6807\u5fd7\u8fdb\u884c\u8f6c\u6362\u3002\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\uff0c\u5728\u5c55\u793a\u52a8\u753b\u6587\u4ef6\u7684\u7ed3\u6784\u65f6\uff0c\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u7684\u6bcf\u4e2a\u8282\u70b9\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6807\u5fd7\u3002\u8be5\u6807\u5fd7\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u4fe1\u606f\u51b3\u5b9a\u5efa\u6a21\u4f4d\u7f6e\u548c\u65b9\u5411\u5e94\u8be5\u5982\u4f55\u66f4\u6539\u3002 \u5982\u679c\u6807\u5fd7\u5b57\u6bb5\u7684\u7b2c\u4e00\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u4f7f\u7528\u6b63\u5728\u5904\u7406\u7684\u52a8\u753b\u5e27\u4e2d\u5305\u542b\u7684\u6570\u636e\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684x\u5206\u91cf\u3002\u52a8\u753b\u5e27\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u53d6\u54ea\u4e2a\u5143\u7d20\u5462\uff1f\u7b54\u6848\u4e5f\u5728\u5173\u8282\u5b9a\u4e49\u4e2d\uff0c\u5176\u4e2d\u5305\u542b startIndex \u5c5e\u6027\u3002\u5982\u679c\u6807\u5fd7\u7684\u7b2c\u4e8c\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u7528 startIndex + 1 \u7684\u503c\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684y\u5206\u91cf\uff0c\u4ee5\u6b64\u7c7b\u63a8\uff0c\u63a5\u4e0b\u6765\u7684\u662f\u5750\u6807\u7684z\u5206\u91cf\uff0c\u4ee5\u53ca\u65b9\u5411\u7684x\u3001y\u548cz\u5206\u91cf\u3002 int flags = hierarchyList.get(i).getFlags(); int startIndex = hierarchyList.get(i).getStartIndex(); if ( (flags & 1 ) > 0) { position.x = frameData[startIndex++]; } if ( (flags & 2) > 0) { position.y = frameData[startIndex++]; } if ( (flags & 4) > 0) { position.z = frameData[startIndex++]; } if ( (flags & 8) > 0) { orientation.x = frameData[startIndex++]; } if ( (flags & 16) > 0) { orientation.y = frameData[startIndex++]; } if ( (flags & 32) > 0) { orientation.z = frameData[startIndex++]; } // \u66f4\u65b0\u56db\u5143\u6570\u7684w\u5206\u91cf orientation = MD5Utils.calculateQuaternion(orientation.x, orientation.y, orientation.z); \u73b0\u5728\u6211\u4eec\u6709\u4e86\u8ba1\u7b97\u53d8\u6362\u77e9\u9635\u6240\u9700\u7684\u6240\u6709\u6570\u636e\uff0c\u4ece\u800c\u5f97\u5230\u5f53\u524d\u52a8\u753b\u5e27\u7684\u6bcf\u4e2a\u5173\u8282\u7684\u6700\u7ec8\u4f4d\u7f6e\u3002\u4f46\u662f\u6211\u4eec\u5fc5\u987b\u8003\u8651\u53e6\u4e00\u4ef6\u4e8b\uff0c\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5b83\u7684\u7236\u5173\u8282\u7684\u4f4d\u7f6e\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5f97\u5230\u4e0e\u6bcf\u4e2a\u7236\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u5e76\u7528\u5b83\u6765\u5f97\u5230\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u53d8\u6362\u77e9\u9635\u3002 // \u8ba1\u7b97\u8fd9\u4e2a\u5173\u8282\u7684\u5e73\u79fb\u548c\u65cb\u8f6c\u77e9\u9635 Matrix4f translateMat = new Matrix4f().translate(position); Matrix4f rotationMat = new Matrix4f().rotate(orientation); Matrix4f jointMat = translateMat.mul(rotationMat); // \u5173\u8282\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5173\u8282\u7684\u7236\u7d22\u5f15\u7684\u4f4d\u7f6e\u3002 // \u4f7f\u7528\u7236\u77e9\u9635\u5c06\u5176\u8f6c\u6362\u4e3a\u6a21\u578b\u7a7a\u95f4\u3002 if ( joint.getParentIndex() > -1 ) { Matrix4f parentMatrix = result.getLocalJointMatrices()[joint.getParentIndex()]; jointMat = new Matrix4f(parentMatrix).mul(jointMat); } result.setMatrix(i, jointMat, invJointMatrices.get(i)); } return result; } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u521b\u5efa\u4e86 AnimatedFrame \u7c7b\u7684\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u8be5\u7c7b\u5305\u542b\u5c06\u5728\u52a8\u753b\u671f\u95f4\u4f7f\u7528\u7684\u6570\u636e\u3002\u8fd9\u4e2a\u7c7b\u4e5f\u4f7f\u7528\u9006\u77e9\u9635\uff0c\u7a0d\u540e\u6211\u4eec\u4f1a\u77e5\u9053\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c AnimatedFrame \u7684 setMatrix \u65b9\u6cd5\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a public void setMatrix(int pos, Matrix4f localJointMatrix, Matrix4f invJointMatrix) { localJointMatrices[pos] = localJointMatrix; Matrix4f mat = new Matrix4f(localJointMatrix); mat.mul(invJointMatrix); jointMatrices[pos] = mat; } \u53d8\u91cf localJointMatrix \u50a8\u5b58\u5f53\u524d\u5e27\u4e2d\u5360\u636e\u4f4d\u7f6e\u201ci\u201d\u7684\u5173\u8282\u7684\u65cb\u8f6c\u77e9\u9635\uff0c invJointMatrix \u6301\u6709\u5360\u636e\u7ed1\u5b9a\u59ff\u52bf\u4f4d\u7f6e\u201ci\u201d\u4f4d\u7f6e\u7684\u5173\u8282\u7684\u9006\u53d8\u6362\u77e9\u9635\u3002\u6211\u4eec\u50a8\u5b58\u4e86 localJointMatrix \u4e0e invJointMatrix \u77e9\u9635\u76f8\u4e58\u7684\u7ed3\u679c\u3002\u8fd9\u4e2a\u7ed3\u679c\u5c06\u5728\u7a0d\u540e\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002\u6211\u4eec\u8fd8\u50a8\u5b58\u4e86\u539f\u59cb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\uff0c\u53d8\u91cf localJointMatrix \uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u7528\u5b83\u6765\u8ba1\u7b97\u5b50\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\uff0c generateMesh \u65b9\u6cd5\u4e5f\u53d1\u751f\u4e86\u53d8\u5316\uff0c\u5982\u6211\u4eec\u4e4b\u524d\u8bf4\u660e\u7684\u90a3\u6837\u8ba1\u7b97\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u4f46\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u50a8\u5b58\u4e24\u4e2a\u6570\u7ec4\uff1a \u4e00\u4e2a\u6570\u7ec4\uff0c\u50a8\u5b58\u7740\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u504f\u501a\u3002 \u4e00\u4e2a\u8f93\u51fa\uff0c\u50a8\u5b58\u8fd9\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u5173\u8282\u7d22\u5f15\uff08\u901a\u8fc7\u6743\u91cd\uff09\u3002 \u6211\u4eec\u5c06\u8fd9\u4e9b\u6570\u7ec4\u7684\u5927\u5c0f\u9650\u5236\u4e3a4\u3002 Mesh \u7c7b\u4e5f\u88ab\u4fee\u6539\u4e3a\u63a5\u6536\u8fd9\u4e9b\u53c2\u6570\uff0c\u5e76\u5c06\u5176\u5305\u542b\u5728\u7740\u8272\u5668\u5904\u7406\u7684VAO\u6570\u636e\u4e2d\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u8be6\u7ec6\u5185\u5bb9\uff0c\u4f46\u6765\u56de\u987e\u4e00\u4e0b\u6211\u4eec\u6240\u505a\u7684\uff1a \u6211\u4eec\u4ecd\u5728\u52a0\u8f7d\u7ed1\u5b9a\u59ff\u52bf\uff0c\u901a\u8fc7\u6743\u91cd\u6570\u636e\u8ba1\u7b97\u51fa\u5b83\u4eec\u7684\u6700\u7ec8\u4f4d\u7f6e\uff0c\u5373\u5173\u8282\u5750\u6807\u548c\u65b9\u5411\u7684\u603b\u548c\u3002 \u8fd9\u4e9b\u6570\u636e\u4ee5VBO\u7684\u5f62\u5f0f\u52a0\u8f7d\u5230\u7740\u8272\u5668\u4e2d\uff0c\u4f46\u662f\u5b83\u7531\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u504f\u501a\u548c\u5f71\u54cd\u5b83\u7684\u5173\u8282\u7684\u7d22\u5f15\u6765\u8865\u5145\u3002\u8fd9\u4e2a\u6570\u636e\u5bf9\u6240\u6709\u52a8\u753b\u5e27\u90fd\u662f\u901a\u7528\u7684\uff0c\u56e0\u4e3a\u5b83\u662f\u5728MD5\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9650\u5236\u504f\u501a\u548c\u5173\u8282\u7d22\u5f15\u6570\u7ec4\u5927\u5c0f\u7684\u539f\u56e0\uff0c\u5f53\u6a21\u578b\u88ab\u53d1\u9001\u5230GPU\u65f6\uff0c\u5b83\u4eec\u5c06\u88ab\u52a0\u8f7d\u4e3aVBO\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u6211\u4eec\u6839\u636e\u57fa\u7840\u5e27\u4e2d\u5b9a\u4e49\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u50a8\u5b58\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u5b9a\u4e49\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u77e5\u9053\u5982\u4f55\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u5b8c\u6210\u7684\u53d8\u6362\uff0c\u7a0d\u540e\u5c06\u770b\u5230\u5982\u4f55\u5e94\u7528\u5b83\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u62fc\u56fe\u7684\u6240\u6709\u788e\u7247\uff0c\u53ea\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u9996\u5148\u9700\u8981\u4fee\u6539\u8f93\u5165\u6570\u636e\u6765\u63a5\u6536\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u3002 #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; \u6211\u4eec\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff1a MAX_WEIGHTS \uff0c\u5b9a\u4e49\u6743\u91cdVBO\uff08\u4e00\u4e2a\u5355\u72ec\u7684\u5173\u8282\u7d22\u5f15\uff09\u4e2d\u7684\u6743\u91cd\u7684\u6700\u5927\u6570\u91cf\u3002 MAX_JOINTS \uff0c\u5b9a\u4e49\u4e86\u6211\u4eec\u5c06\u652f\u6301\u7684\u6700\u5927\u5173\u8282\u6570\u91cf\uff08\u7a0d\u540e\u5c06\u8be6\u7ec6\u4ecb\u7ecd\uff09\u3002 \u7136\u540e\u6211\u4eec\u5b9a\u4e49\u8f93\u51fa\u6570\u636e\u548cUniform\u3002 out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a jointsMatrix \u7684\u65b0Uniform\uff0c\u5b83\u662f\u4e00\u4e2a\u77e9\u9635\u6570\u7ec4\uff08\u6700\u5927\u957f\u5ea6\u7531 MAX_JOINTS \u5e38\u91cf\u8bbe\u7f6e\uff09\u3002\u8be5\u77e9\u9635\u6570\u7ec4\u5305\u542b\u5f53\u524d\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u5173\u8282\u77e9\u9635\uff0c\u5e76\u5728\u5904\u7406\u5e27\u65f6\u5728 MD5Loader \u7c7b\u4e2d\u8ba1\u7b97\u3002\u56e0\u6b64\uff0c\u8be5\u6570\u7ec4\u5305\u542b\u9700\u8981\u5e94\u7528\u4e8e\u5f53\u524d\u52a8\u753b\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u53d8\u6362\uff0c\u5e76\u5c06\u4f5c\u4e3a\u8ba1\u7b97\u9876\u70b9\u6700\u7ec8\u5750\u6807\u7684\u57fa\u7840\u3002 \u4f7f\u7528VBO\u4e2d\u7684\u65b0\u6570\u636e\u548c\u8be5Uniform\uff0c\u6211\u4eec\u5c06\u53d8\u6362\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\u3002\u8fd9\u5c06\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\uff1a vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } \u9996\u5148\uff0c\u6211\u4eec\u5f97\u5230\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u904d\u5386\u4e0e\u8fd9\u4e2a\u9876\u70b9\u5173\u8054\u7684\u6743\u91cd\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528\u50a8\u5b58\u5728\u8f93\u5165\u4e2d\u7684\u7d22\u5f15\uff0c\u4f7f\u7528\u8be5\u5e27\uff08\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\uff09\u7684\u6743\u91cd\u548c\u5173\u8282\u77e9\u9635\u4fee\u6539\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u4e2a\u9876\u70b9\u5750\u6807\uff0c\u6211\u4eec\u8ba1\u7b97\u5b83\u7684\u5e27\u5750\u6807\uff1a Vfp = \\sum\\limits_{i=0}^{MAX WEIGTHS} Wb_{i} \\dot (Jfp_{i} \\times Jt^{-1}_{i}) \\times Vpos \u53c2\u6570\uff1a Wfvp \u662f\u9876\u70b9\u7684\u6700\u7ec8\u5750\u6807\u3002 Wb \u662f\u9876\u70b9\u7684\u6743\u91cd\u3002 Jfp \u662f\u8fd9\u4e2a\u5750\u6807\u7cfb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u3002 Jt^{-1} \u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u8fd9\u4e2a\u77e9\u9635\u4e0e Jfp \u7684\u6210\u7ee9\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\u3002 Vpos \u662f\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u7684\u9876\u70b9\u5750\u6807\u3002 Vpos \u7531 Jt \u77e9\u9635\u8ba1\u7b97\uff0c\u8fd9\u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u77e9\u9635\u3002\u6240\u4ee5\uff0c\u6700\u540e\u6211\u4eec\u8981\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u7684\u4fee\u6539\u6765\u5e94\u7528\u8be5\u5750\u6807\u7cfb\u7684\u53d8\u6362\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9700\u8981\u9006\u7ed1\u5b9a\u59ff\u52bf\u77e9\u9635\u7684\u539f\u56e0\u3002 \u7740\u8272\u5668\u652f\u6301\u6743\u91cd\u53ef\u53d8\u7684\u9876\u70b9\uff0c\u6700\u591a\u53ef\u8fbe4\u4e2a\uff0c\u8fd8\u53ef\u4ee5\u6e32\u67d3\u975e\u52a8\u753b\u9879\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6743\u91cd\u7b49\u4e8e0\u6211\u4eec\u5c06\u5f97\u5230\u539f\u59cb\u5750\u6807\u3002 \u7740\u8272\u5668\u7684\u5176\u4f59\u90e8\u5206\u6216\u591a\u6216\u5c11\u4fdd\u6301\u4e0d\u53d8\uff0c\u6211\u4eec\u53ea\u662f\u4f7f\u7528\u66f4\u65b0\u540e\u7684\u5750\u6807\u5e76\u4f20\u9012\u7247\u5143\u7740\u8272\u5668\u8981\u4f7f\u7528\u7684\u6b63\u786e\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6240\u4ee5\uff0c\u4e3a\u4e86\u6d4b\u8bd5\u52a8\u753b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06 jointsMatrix \u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u7531\u4e8e\u6b64\u4fe1\u606f\u4ec5\u50a8\u5b58\u5728 AnimGameItem \u5b9e\u4f8b\u4e2d\uff0c\u56e0\u6b64\u4ee3\u7801\u975e\u5e38\u7b80\u5355\u3002\u5728\u6e32\u67d3\u7f51\u683c\u7684\u5faa\u73af\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u5982\u4e0b\u4ee3\u7801\u7247\u6bb5\uff1a if ( gameItem instanceof AnimGameItem ) { AnimGameItem animGameItem = (AnimGameItem)gameItem; AnimatedFrame frame = animGameItem.getCurrentFrame(); sceneShaderProgram.setUniform(\"jointsMatrix\", frame.getJointMatrices()); } \u5f53\u7136\uff0c\u5728\u4f7f\u7528\u5b83\u4e4b\u524d\uff0c\u4f60\u9700\u8981\u521b\u5efaUniform\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u8be5\u7c7b\u7684\u6e90\u4ee3\u7801\u3002\u5982\u679c\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u5c06\u80fd\u591f\u901a\u8fc7\u6309\u4e0b\u7a7a\u683c\u952e\u6765\u67e5\u770b\u6a21\u578b\u662f\u5982\u4f55\u52a8\u8d77\u6765\u7684\uff08\u6bcf\u6b21\u6309\u4e0b\u8fd9\u4e2a\u952e\uff0c\u90fd\u4f1a\u8bbe\u7f6e\u4e00\u4e2a\u65b0\u7684\u5e27\uff0c\u5e76\u4e14 jointsMatrix Uniform\u4f1a\u53d1\u751f\u53d8\u5316\uff09\u3002 \u4f60\u5c06\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u867d\u7136\u52a8\u753b\u5f88\u6d41\u7545\uff0c\u4f46\u793a\u4f8b\u8fd8\u662f\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u5149\u7167\u6ca1\u6709\u6b63\u5e38\u7684\u5de5\u4f5c\uff0c\u9634\u5f71\u8868\u73b0\u7684\u662f\u7ed1\u5b9a\u59ff\u52bf\uff0c\u800c\u4e0d\u662f\u5f53\u524d\u5e27\u3002\u6211\u4eec\u73b0\u5728\u5c06\u89e3\u51b3\u6240\u6709\u8fd9\u4e9b\u95ee\u9898\u3002","title":"\u6a21\u578b\u52a8\u753b"},{"location":"19-animations/#_3","text":"\u7b2c\u4e00\u4e2a\u8981\u89e3\u51b3\u7684\u95ee\u9898\u662f\u5149\u7167\u95ee\u9898\u3002\u4f60\u53ef\u80fd\u5df2\u7ecf\u6ce8\u610f\u5230\u8fd9\u79cd\u60c5\u51b5\u4e86\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u6cd5\u7ebf\u3002\u56e0\u6b64\uff0c\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u6cd5\u7ebf\u4e0e\u7ed1\u5b9a\u59ff\u52bf\u76f8\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u50cf\u53d8\u6362\u4f4d\u7f6e\u4e00\u6837\u53d8\u6362\u5b83\u4eec\u3002 \u8fd9\u4e2a\u95ee\u9898\u5f88\u597d\u89e3\u51b3\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728\u5faa\u73af\u4e2d\u5c06\u6cd5\u7ebf\u4e5f\u56ca\u62ec\u5230\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u6743\u91cd\u904d\u5386\u3002 vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u7136\u540e\u6211\u4eec\u50cf\u5f80\u5e38\u4e00\u6837\u8ba1\u7b97\u8f93\u51fa\u9876\u70b9\u6cd5\u7ebf\u5411\u91cf\uff1a mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; \u63a5\u4e0b\u6765\u7684\u95ee\u9898\u662f\u9634\u5f71\u95ee\u9898\u3002\u5982\u679c\u4f60\u8bb0\u5f97\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u9634\u5f71\u56fe\u7ed8\u5236\u9634\u5f71\u3002\u6211\u4eec\u73b0\u5728\u6b63\u4ece\u5149\u7167\u900f\u89c6\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u521b\u5efa\u4e00\u4e2a\u6df1\u5ea6\u56fe\uff0c\u5b83\u544a\u8bc9\u6211\u4eec\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u9634\u5f71\u4e2d\u3002\u4f46\u662f\uff0c\u5728\u6cd5\u7ebf\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u6839\u636e\u5f53\u524d\u5e27\u6765\u6539\u53d8\u5b83\u4eec\u3002\u8fd9\u5c31\u662f\u9634\u5f71\u4e0e\u5f53\u524d\u5750\u6807\u4e0d\u4e00\u81f4\u7684\u539f\u56e0\u3002 \u89e3\u51b3\u65b9\u6cd5\u4e5f\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528 jointsMatrix \u3001\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u6765\u53d8\u6362\u5750\u6807\u3002\u8fd9\u5c31\u662f\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } gl_Position = orthoProjectionMatrix * modelLightViewMatrix * initPos; } \u4f60\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u6765\u4e3a\u8fd9\u4e2a\u7740\u8272\u5668\u8bbe\u7f6e\u65b0\u7684Uniform\uff0c\u6700\u7ec8\u7684\u6548\u679c\u4f1a\u66f4\u597d\u3002\u5149\u7167\u5c06\u88ab\u6b63\u786e\u7684\u5e94\u7528\uff0c\u9634\u5f71\u5c06\u968f\u6bcf\u4e2a\u52a8\u753b\u5e27\u6539\u53d8\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\u4e86\uff0c\u73b0\u5728\u4f60\u5df2\u7ecf\u6709\u4e86\u4e00\u4e2a\u7528\u4e8e\u52a8\u753bMD5\u6a21\u578b\u7684\u53ef\u5de5\u4f5c\u793a\u4f8b\u3002\u6e90\u4ee3\u7801\u4ecd\u80fd\u6539\u8fdb\uff0c\u4f60\u53ef\u4ee5\u4fee\u6539\u5728\u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u4e2d\u52a0\u8f7d\u7684\u77e9\u9635\uff0c\u4ee5\u4fbf\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u4e2d\u4f7f\u7528\u7684\u8d44\u6e90\uff0c\u4e86\u89e3\u5982\u4f55\u5b9e\u73b0\u8be5\u529f\u80fd\u3002","title":"\u4fee\u6b63\u52a8\u753b\u95ee\u9898"},{"location":"20-particles/","text":"\u7c92\u5b50\uff08Particles\uff09 \u57fa\u7840 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u7c92\u5b50\u6548\u679c\u5230\u6e38\u620f\u5f15\u64ce\u4e2d\u3002\u6709\u4e86\u8fd9\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5c31\u80fd\u6a21\u62df\u5173\u7cfb\u3001\u706b\u3001\u7070\u5c18\u548c\u4e91\u3002\u8fd9\u662f\u4e00\u79cd\u7b80\u5355\u7684\u6548\u679c\uff0c\u5c06\u6539\u5584\u5bf9\u4efb\u4f55\u6e38\u620f\u7684\u56fe\u5f62\u65b9\u9762\u3002 \u5728\u6b64\u4e4b\u524d\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u6709\u5f88\u591a\u65b9\u6cd5\u53ef\u4ee5\u5b9e\u73b0\u4e0d\u540c\u6548\u679c\u7684\u7c92\u5b50\u6548\u679c\u3002\u5f53\u524d\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u677f\u7c92\u5b50\uff08Billboard Particle\uff09\u3002\u8be5\u6280\u672f\u4f7f\u7528\u79fb\u52a8\u7684\u7eb9\u7406\u56db\u8fb9\u5f62\u6765\u8868\u793a\u4e00\u4e2a\u7c92\u5b50\uff0c\u5b83\u4eec\u603b\u662f\u9762\u5411\u89c2\u5bdf\u8005\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u5c31\u662f\u6444\u50cf\u673a\u3002\u4f60\u8fd8\u53ef\u4ee5\u4f7f\u7528\u9762\u677f\u6280\u672f\u5728\u6e38\u620f\u9879\u4e0a\u663e\u793a\u4fe1\u606f\u9762\u677f\uff0c\u6bd4\u5982\u8ff7\u4f60HUD\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5b9a\u4e49\u7c92\u5b50\uff0c\u7c92\u5b50\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u7528\u4e8e\u8868\u793a\u56db\u8fb9\u5f62\u9876\u70b9\u7684\u7f51\u683c\u3002 \u4e00\u5f20\u7eb9\u7406\u3002 \u67d0\u4e00\u65f6\u523b\u7684\u5750\u6807\u3002 \u7f29\u653e\u7cfb\u6570\u3002 \u901f\u5ea6\u3002 \u79fb\u52a8\u65b9\u5411\u3002 \u751f\u5b58\u65f6\u95f4\u6216\u5b58\u6d3b\u65f6\u95f4\u3002\u4e00\u65e6\u8be5\u65f6\u95f4\u8fc7\u53bb\uff0c\u7c92\u5b50\u5c31\u4e0d\u518d\u5b58\u5728\u3002 \u524d\u56db\u9879\u662f GameItem \u7c7b\u7684\u4e00\u90e8\u5206\uff0c\u4f46\u540e\u4e09\u9879\u4e0d\u662f\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Particle \u7684\u65b0\u7c7b\uff0c\u5b83\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private Vector3f speed; /** * \u7c92\u5b50\u5b58\u6d3b\u7684\u65f6\u95f4\uff0c\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d */ private long ttl; public Particle(Mesh mesh, Vector3f speed, long ttl) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; } public Particle(Particle baseParticle) { super(baseParticle.getMesh()); Vector3f aux = baseParticle.getPosition(); setPosition(aux.x, aux.y, aux.z); aux = baseParticle.getRotation(); setRotation(aux.x, aux.y, aux.z); setScale(baseParticle.getScale()); this.speed = new Vector3f(baseParticle.speed); this.ttl = baseParticle.geTtl(); } public Vector3f getSpeed() { return speed; } public void setSpeed(Vector3f speed) { this.speed = speed; } public long geTtl() { return ttl; } public void setTtl(long ttl) { this.ttl = ttl; } /** * \u66f4\u65b0\u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 * @param elapsedTime \u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 * @return \u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 */ public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; return this.ttl; } } \u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u51fa\uff0c\u7c92\u5b50\u7684\u901f\u5ea6\u548c\u8fd0\u52a8\u65b9\u5411\u53ef\u4ee5\u8868\u793a\u4e3a\u4e00\u4e2a\u5411\u91cf\u3002\u8be5\u5411\u91cf\u7684\u65b9\u5411\u51b3\u5b9a\u4e86\u7c92\u5b50\u7684\u8fd0\u52a8\u65b9\u5411\u548c\u901f\u5ea6\u3002\u7c92\u5b50\u5b58\u6d3b\u65f6\u95f4\uff08TTL\uff09\u88ab\u8bbe\u5b9a\u4e3a\u6beb\u79d2\u8ba1\u6570\u5668\uff0c\u6bcf\u5f53\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u65f6\uff0c\u5b83\u90fd\u4f1a\u51cf\u5c11\u3002\u8be5\u7c7b\u8fd8\u6709\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u53e6\u4e00\u4e2a\u7c92\u5b50\u5b9e\u4f8b\u6765\u8fdb\u884c\u590d\u5236\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7c92\u5b50\u751f\u6210\u5668\u6216\u7c92\u5b50\u53d1\u5c04\u5668\uff0c\u5373\u4e00\u4e2a\u52a8\u6001\u751f\u6210\u7c92\u5b50\u3001\u63a7\u5236\u5176\u751f\u547d\u5468\u671f\u5e76\u6839\u636e\u7279\u5b9a\u7684\u6a21\u5f0f\u66f4\u65b0\u5176\u4f4d\u7f6e\u7684\u7c7b\u3002\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u5f88\u591a\u5b9e\u73b0\uff0c\u5b83\u4eec\u5728\u7c92\u5b50\u7684\u521b\u5efa\u65b9\u5f0f\u548c\u4f4d\u7f6e\u7684\u66f4\u65b0\u65b9\u5f0f\uff08\u4f8b\u5982\uff0c\u662f\u5426\u8003\u8651\u91cd\u529b\uff09\u65b9\u9762\u5404\u4e0d\u76f8\u540c\u3002\u56e0\u6b64\uff0c\u4e3a\u4e86\u4fdd\u6301\u6e38\u620f\u5f15\u64ce\u7684\u901a\u7528\u6027\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u6240\u6709\u7c92\u5b50\u53d1\u5c04\u5668\u5fc5\u987b\u8981\u5b9e\u73b0\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u540d\u4e3a IParticleEmitter \u7684\u63a5\u53e3\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.List; import org.lwjglb.engine.items.GameItem; public interface IParticleEmitter { void cleanup(); Particle getBaseParticle(); List<GameItem> getParticles(); } IParticleEmitter \u63a5\u53e3\u6709\u4e00\u4e2a\u6e05\u7406\u8d44\u6e90\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a cleanup \uff0c\u8fd8\u6709\u4e00\u4e2a\u83b7\u53d6\u7c92\u5b50\u5217\u8868\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getParticles \u3002\u8fd8\u6709\u4e00\u4e2a\u540d\u4e3a getBaseParticle \u7684\u65b9\u6cd5\uff0c\u4f46\u662f\u8fd9\u4e2a\u65b9\u6cd5\u662f\u505a\u4ec0\u4e48\u7684\u5462\uff1f\u4e00\u4e2a\u7c92\u5b50\u53d1\u5c04\u5668\u5c06\u52a8\u6001\u5730\u4ea7\u751f\u8bb8\u591a\u4f8b\u5b50\u3002\u6bcf\u5f53\u4e00\u4e2a\u7c92\u5b50\u8fc7\u671f\uff0c\u5c31\u4f1a\u521b\u5efa\u65b0\u7684\u7c92\u5b50\u3002\u8be5\u7c92\u5b50\u66f4\u65b0\u5468\u671f\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u4f5c\u4e3a\u6a21\u677f\u521b\u5efa\u65b0\u7684\u52bf\u529b\u3002\u8fd9\u5c31\u662f\u57fa\u7840\u7c92\u5b50\u7684\u7528\u9014\uff0c\u8fd9\u4e5f\u662f\u4e3a\u4ec0\u4e48 Particle \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\u3002 \u5728\u6e38\u620f\u5f15\u64ce\u7684\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u5f15\u7528 IParticleEmitter \u63a5\u53e3\uff0c\u56e0\u6b64\u57fa\u7840\u4ee3\u7801\u5c06\u4e0d\u4f9d\u8d56\u4e8e\u7279\u5b9a\u7684\u5b9e\u73b0\u3002\u4e0d\u8fc7\uff0c\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u5b9e\u73b0\u6765\u6a21\u62df\u4e0d\u53d7\u91cd\u529b\u5f71\u54cd\u7684\u7c92\u5b50\u6d41\u3002\u8fd9\u4e2a\u5b9e\u73b0\u53ef\u4ee5\u7528\u6765\u6a21\u62df\u5149\u7ebf\u6216\u706b\u7130\uff0c\u540d\u4e3a FlowParticleEmitter \u3002 \u8fd9\u4e2a\u7c7b\u7684\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u8fdb\u884c\u8c03\u6574\uff1a \u4e00\u6b21\u80fd\u5b58\u5728\u7684\u6700\u5927\u7c92\u5b50\u6570\u91cf \u521b\u5efa\u7c92\u5b50\u7684\u6700\u77ed\u5468\u671f\u3002\u7c92\u5b50\u5c06\u5728\u6700\u77ed\u7684\u65f6\u95f4\u5185\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5730\u521b\u5efa\uff0c\u4ee5\u907f\u514d\u7c92\u5b50\u7206\u53d1\u6027\u521b\u5efa\u3002 \u4e00\u7ec4\u8303\u56f4\uff0c\u4ee5\u968f\u673a\u7c92\u5b50\u901f\u5ea6\u548c\u4f4d\u7f6e\u3002\u65b0\u7c92\u5b50\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u7684\u4f4d\u7f6e\u548c\u901f\u5ea6\uff0c\u53ef\u4ee5\u5728\u76f8\u5e94\u8303\u56f4\u5185\u53d6\u503c\uff0c\u4ee5\u5206\u6563\u5149\u7ebf\u3002 \u8be5\u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.joml.Vector3f; import org.lwjglb.engine.items.GameItem; public class FlowParticleEmitter implements IParticleEmitter { private int maxParticles; private boolean active; private final List<GameItem> particles; private final Particle baseParticle; private long creationPeriodMillis; private long lastCreationTime; private float speedRndRange; private float positionRndRange; private float scaleRndRange; public FlowParticleEmitter(Particle baseParticle, int maxParticles, long creationPeriodMillis) { particles = new ArrayList<>(); this.baseParticle = baseParticle; this.maxParticles = maxParticles; this.active = false; this.lastCreationTime = 0; this.creationPeriodMillis = creationPeriodMillis; } @Override public Particle getBaseParticle() { return baseParticle; } public long getCreationPeriodMillis() { return creationPeriodMillis; } public int getMaxParticles() { return maxParticles; } @Override public List<GameItem> getParticles() { return particles; } public float getPositionRndRange() { return positionRndRange; } public float getScaleRndRange() { return scaleRndRange; } public float getSpeedRndRange() { return speedRndRange; } public void setCreationPeriodMillis(long creationPeriodMillis) { this.creationPeriodMillis = creationPeriodMillis; } public void setMaxParticles(int maxParticles) { this.maxParticles = maxParticles; } public void setPositionRndRange(float positionRndRange) { this.positionRndRange = positionRndRange; } public void setScaleRndRange(float scaleRndRange) { this.scaleRndRange = scaleRndRange; } public boolean isActive() { return active; } public void setActive(boolean active) { this.active = active; } public void setSpeedRndRange(float speedRndRange) { this.speedRndRange = speedRndRange; } public void update(long ellapsedTime) { long now = System.currentTimeMillis(); if (lastCreationTime == 0) { lastCreationTime = now; } Iterator<? extends GameItem> it = particles.iterator(); while (it.hasNext()) { Particle particle = (Particle) it.next(); if (particle.updateTtl(ellapsedTime) < 0) { it.remove(); } else { updatePosition(particle, ellapsedTime); } } int length = this.getParticles().size(); if (now - lastCreationTime >= this.creationPeriodMillis && length < maxParticles) { createParticle(); this.lastCreationTime = now; } } private void createParticle() { Particle particle = new Particle(this.getBaseParticle()); // \u6dfb\u52a0\u4e00\u4e9b\u968f\u673a\u7684\u7c92\u5b50 float sign = Math.random() > 0.5d ? -1.0f : 1.0f; float speedInc = sign * (float)Math.random() * this.speedRndRange; float posInc = sign * (float)Math.random() * this.positionRndRange; float scaleInc = sign * (float)Math.random() * this.scaleRndRange; particle.getPosition().add(posInc, posInc, posInc); particle.getSpeed().add(speedInc, speedInc, speedInc); particle.setScale(particle.getScale() + scaleInc); particles.add(particle); } /** * \u66f4\u65b0\u4e00\u4e2a\u7c92\u5b50\u7684\u4f4d\u7f6e * @param particle \u9700\u8981\u66f4\u65b0\u7684\u7c92\u5b50 * @param elapsedTime \u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 */ public void updatePosition(Particle particle, long elapsedTime) { Vector3f speed = particle.getSpeed(); float delta = elapsedTime / 1000.0f; float dx = speed.x * delta; float dy = speed.y * delta; float dz = speed.z * delta; Vector3f pos = particle.getPosition(); particle.setPosition(pos.x + dx, pos.y + dy, pos.z + dz); } @Override public void cleanup() { for (GameItem particle : getParticles()) { particle.cleanup(); } } } \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u62d3\u5c55 Scene \u7c7b\u4e2d\u5305\u542b\u7684\u6570\u636e\uff0c\u4f7f\u5176\u5305\u542b\u4e00\u4e2a ParticleEmitter \u7684\u5b9e\u4f8b\u6570\u7ec4\u3002 package org.lwjglb.engine; // \u8fd9\u662f\u5bfc\u5165\u2026\u2026 public class Scene { // \u8fd9\u6709\u66f4\u591a\u5c5e\u6027\u2026\u2026 private IParticleEmitter[] particleEmitters; \u5728\u8be5\u9636\u6bb5\uff0c\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u6e32\u67d3\u7c92\u5b50\u3002\u7c92\u5b50\u4e0d\u4f1a\u53d7\u5230\u5149\u7684\u5f71\u54cd\uff0c\u4e5f\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u97f3\u4e50\u3002\u5b83\u4eec\u4e0d\u4f1a\u6709\u4efb\u4f55\u9aa8\u9abc\u52a8\u753b\uff0c\u6240\u4ee5\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6e32\u67d3\u5b83\u4eec\u662f\u6ca1\u6709\u610f\u4e49\u7684\u3002\u7740\u8272\u5668\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u4f1a\u4f7f\u7528\u6295\u5f71\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6e32\u67d3\u9876\u70b9\uff0c\u5e76\u4f7f\u7528\u7eb9\u7406\u8bbe\u7f6e\u989c\u8272\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u7247\u5143\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u975e\u5e38\u7b80\u5355\uff0c\u5c31\u50cf\u6e32\u67d3\u4e00\u7ae0\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u3002\u73b0\u5728\uff0c\u548c\u5176\u4ed6\u7ae0\u8282\u4e00\u6837\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u8bbe\u7f6e\u548c\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u3002\u7740\u8272\u5668\u7684\u8bbe\u7f6e\u5c06\u5728\u4e00\u4e2a\u540d\u4e3a setupParticlesShader \u7684\u65b9\u6cd5\u4e2d\u5b8c\u6210\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private void setupParticlesShader() throws Exception { particlesShaderProgram = new ShaderProgram(); particlesShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/particles_vertex.vs\")); particlesShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/particles_fragment.fs\")); particlesShaderProgram.link(); particlesShaderProgram.createUniform(\"projectionMatrix\"); particlesShaderProgram.createUniform(\"modelViewMatrix\"); particlesShaderProgram.createUniform(\"texture_sampler\"); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728Renderer\u7c7b\u4e2d\u521b\u5efa\u6e32\u67d3\u65b9\u6cd5 renderParticles \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderParticles(Window window, Camera camera, Scene scene) { particlesShaderProgram.bind(); particlesShaderProgram.setUniform(\"texture_sampler\", 0); Matrix4f projectionMatrix = transformation.getProjectionMatrix(); particlesShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); Matrix4f viewMatrix = transformation.getViewMatrix(); IParticleEmitter[] emitters = scene.getParticleEmitters(); int numEmitters = emitters != null ? emitters.length : 0; for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } particlesShaderProgram.unbind(); } \u5982\u679c\u4f60\u52aa\u529b\u9605\u8bfb\uff0c\u4e0a\u8ff0\u4ee3\u7801\u5e94\u8be5\u662f\u4e0d\u8a00\u81ea\u660e\u7684\uff0c\u5b83\u53ea\u662f\u8bbe\u7f6e\u5fc5\u8981\u7684Uniform\uff0c\u5e76\u6e32\u67d3\u6bcf\u4e2a\u7c92\u5b50\u3002\u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u6d4b\u8bd5\u7c92\u5b50\u6548\u679c\u5b9e\u73b0\u6240\u9700\u7684\u6240\u6709\u65b9\u6cd5\uff0c\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u521b\u5efa\u7c92\u5b50\u53d1\u5c04\u5668\u548c\u57fa\u672c\u7c92\u5b50\u7684\u7279\u6027\u3002 Vector3f particleSpeed = new Vector3f(0, 1, 0); particleSpeed.mul(2.5f); long ttl = 4000; int maxParticles = 200; long creationPeriodMillis = 300; float range = 0.2f; float scale = 0.5f; Mesh partMesh = OBJLoader.loadMesh(\"/models/particle.obj\"); Texture texture = new Texture(\"/textures/particle_tmp.png\"); Material partMaterial = new Material(texture, reflectance); partMesh.setMaterial(partMaterial); Particle particle = new Particle(partMesh, particleSpeed, ttl); particle.setScale(scale); particleEmitter = new FlowParticleEmitter(particle, maxParticles, creationPeriodMillis); particleEmitter.setActive(true); particleEmitter.setPositionRndRange(range); particleEmitter.setSpeedRndRange(range); this.scene.setParticleEmitters(new FlowParticleEmitter[] {particleEmitter}); \u6211\u4eec\u73b0\u5728\u4f7f\u7528\u4e00\u4e2a\u666e\u901a\u586b\u5145\u5706\u4f5c\u4e3a\u7c92\u5b50\u7684\u7eb9\u7406\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u5982\u679c\u4f60\u8fd0\u884c\u5b83\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u4e3a\u4ec0\u4e48\u4e00\u4e9b\u7c92\u5b50\u4f3c\u4e4e\u88ab\u5207\u65ad\u4e86\uff1f\u4e3a\u4ec0\u4e48\u900f\u660e\u7684\u80cc\u666f\u4e0d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1f\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\u3002\u7c92\u5b50\u7684\u4e00\u4e9b\u7247\u5143\u88ab\u4e22\u5f03\uff0c\u56e0\u4e3a\u5b83\u4eec\u5177\u6709\u6bd4\u8be5\u533a\u57df\u7684\u6df1\u5ea6\u7f13\u51b2\u7684\u5f53\u524d\u503c\u9ad8\u7684\u6df1\u5ea6\u503c\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5c06\u5176\u4e0e\u6444\u50cf\u673a\u4e4b\u95f4\u7684\u8ddd\u79bb\u6765\u6392\u5e8f\u7c92\u5b50\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6216\u8005\u6211\u4eec\u53ef\u4ee5\u7981\u7528\u6df1\u5ea6\u5199\u5165\u3002 \u5728\u7ed8\u5236\u7c92\u5b50\u4e4b\u524d\u6211\u4eec\u9700\u8981\u63d2\u5165\u8fd9\u4e00\u884c\u4ee3\u7801\uff1a glDepthMask(false); \u7136\u540e\u5728\u6211\u4eec\u5b8c\u6210\u6e32\u67d3\u4e4b\u540e\u8fd8\u539f\u4e3a\u5148\u524d\u503c\uff1a glDepthMask(true); \u7136\u540e\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u597d\u4e86\uff0c\u95ee\u9898\u89e3\u51b3\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u60f3\u5e94\u7528\u53e6\u4e00\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5e0c\u671b\u989c\u8272\u88ab\u6df7\u5408\uff0c\u56e0\u6b64\u989c\u8272\u5c06\u88ab\u6dfb\u52a0\uff0c\u4ee5\u8fbe\u6210\u66f4\u597d\u7684\u6548\u679c\u3002\u8fd9\u662f\u5728\u6e32\u67d3\u524d\u589e\u52a0\u5982\u4e0b\u4e00\u884c\u4ee3\u7801\u6765\u5b9e\u73b0\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE); \u4e0e\u6df1\u5ea6\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u6e32\u67d3\u5b8c\u6240\u6709\u7c92\u5b50\u540e\uff0c\u6211\u4eec\u5c06\u6df7\u5408\u51fd\u6570\u6062\u590d\u4e3a\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u6211\u4eec\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f46\u6211\u4eec\u8fd8\u6ca1\u6709\u5b8c\u6210\u5b83\u3002\u5982\u679c\u4f60\u628a\u6444\u50cf\u673a\u79fb\u5230\u84dd\u8272\u6b63\u65b9\u5f62\u7684\u4e0a\u65b9\u5f80\u4e0b\u770b\uff0c\u4f60\u53ef\u80fd\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u4e1c\u897f\uff1a \u8fd9\u4e9b\u7c92\u5b50\u770b\u8d77\u6765\u4e0d\u592a\u597d\uff0c\u5b83\u4eec\u5e94\u8be5\u662f\u5706\u7684\uff0c\u4f46\u73b0\u5728\u770b\u8d77\u6765\u50cf\u4e00\u5f20\u7eb8\u3002\u5728\u6b64\u4e4b\u4e0a\uff0c\u6211\u4eec\u5e94\u8be5\u5e94\u7528\u9762\u677f\u6280\u672f\u3002\u7528\u4e8e\u6e32\u67d3\u7c92\u5b50\u7684\u56db\u8fb9\u5f62\u5e94\u8be5\u59cb\u7ec8\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e0e\u6444\u50cf\u673a\u65b9\u5411\u5b8c\u5168\u5782\u76f4\uff0c\u5c31\u597d\u50cf\u6839\u672c\u6ca1\u6709\u65cb\u8f6c\u4e00\u6837\u3002\u6444\u50cf\u673a\u7684\u77e9\u9635\u5c06\u4f4d\u79fb\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u573a\u666f\u4e2d\u7684\u6bcf\u4e00\u4e2a\u5bf9\u8c61\uff0c\u6211\u4eec\u60f3\u8df3\u8fc7\u5c06\u8981\u5e94\u7528\u7684\u65cb\u8f6c\u3002 \u8b66\u544a\uff1a\u5728\u8bb2\u6570\u5b66\u77e5\u8bc6\u65f6\uff0c\u5982\u679c\u4f60\u89c9\u5f97\u4e0d\u8212\u670d\uff0c\u4f60\u53ef\u4ee5\u8df3\u8fc7\u5b83\u3002\u8ba9\u6211\u4eec\u518d\u6b21\u56de\u987e\u90a3\u4e2a\u89c2\u5bdf\u77e9\u9635\u3002\u8be5\u77e9\u9635\u53ef\u4ee5\u50cf\u8fd9\u6837\u8868\u793a\uff08\u6ca1\u6709\u5e94\u7528\u4efb\u4f55\u7f29\u653e\uff09\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{r_{00}} & \\color{red}{r_{10}} & \\color{red}{r_{20}} & \\color{blue}{dx} \\\\ \\color{red}{r_{01}} & \\color{red}{r_{11}} & \\color{red}{r_{21}} & \\color{blue}{dy} \\\\ \\color{red}{r_{02}} & \\color{red}{r_{12}} & \\color{red}{r_{22}} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7ea2\u8272\u7684\u5143\u7d20\u4ee3\u8868\u6444\u50cf\u673a\u7684\u65cb\u8f6c\uff0c\u84dd\u8272\u7684\u5143\u7d20\u4ee3\u8868\u4f4d\u79fb\u3002\u6211\u4eec\u9700\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u4e2d\u7684\u5de6\u4e0a\u89d23x3\u77e9\u9635\u7684\u65cb\u8f6c\u6548\u679c\uff0c\u6240\u4ee5\u5b83\u4f1a\u53d8\u6210\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & \\color{blue}{dx} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & \\color{blue}{dy} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u5728\u5de6\u4e0a\u89d2\u7684\u7ea2\u8272\u90e8\u5206\uff0c\u6211\u4eec\u6709\u4e00\u4e2a3x3\u77e9\u9635\uff0c\u628a\u5b83\u547d\u540d\u4e3a M_{r} \u5e76\u4e14\u6211\u4eec\u60f3\u628a\u5b83\u8f6c\u6362\u6210\u5355\u4f4d\u77e9\u9635\uff1a I \u3002\u4efb\u4f55\u77e9\u9635\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\u90fd\u4f1a\u5f97\u5230\u5355\u4f4d\u77e9\u9635\uff1a M_{r} \\times M_{r}^{-1} = I \u3002\u6211\u4eec\u53ea\u9700\u8981\u4ece\u89c2\u5bdf\u77e9\u9635\u4e2d\u53d6\u5de6\u4e0a\u89d2\u76843x3\u77e9\u9635\uff0c\u7136\u540e\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u8fd8\u53ef\u4ee5\u4f18\u5316\u4ed6\u3002\u4e00\u4e2a\u65cb\u8f6c\u77e9\u9635\u6709\u4e00\u4e2a\u6709\u8da3\u7684\u5b9a\u7406\uff0c\u5b83\u7684\u9006\u77e9\u9635\u4e0e\u5176\u8f6c\u7f6e\u77e9\u9635\u76f8\u7b49\u3002\u5373\uff1a M_{r} \\times M_{r}^{-1} = M_{r} \\times M_{r}^{T} = I \u3002\u8f6c\u7f6e\u77e9\u9635\u6bd4\u9006\u77e9\u9635\u66f4\u5bb9\u6613\u8ba1\u7b97\u3002\u77e9\u9635\u7684\u8f6c\u7f6e\u5c31\u50cf\u5c06\u5176\u53cd\u8f6c\u8fc7\u6765\uff0c\u5c06\u6bcf\u4e00\u5217\u4e0e\u6bcf\u4e00\u884c\u66ff\u6362\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} r_{00} & r_{10} & r_{20} \\\\ r_{01} & r_{11} & r_{21} \\\\ r_{02} & r_{12} & r_{22} \\end{bmatrix} ^{T} = \\begin{bmatrix} r_{00} & r_{01} & r_{02} \\\\ r_{10} & r_{11} & r_{12} \\\\ r_{20} & r_{21} & r_{22} \\end{bmatrix} \u597d\u7684\uff0c\u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\u3002\u6211\u4eec\u6709\u8be5\u53d8\u6362\uff1a V \\times M \uff0c\u5176\u4e2d V \u662f\u89c2\u5bdf\u77e9\u9635\uff0c M \u662f\u6a21\u578b\u77e9\u9635\u3002\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u8868\u8fbe\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{m_{00}} & \\color{red}{m_{10}} & \\color{red}{m_{20}} & m_{30} \\\\ \\color{red}{m_{01}} & \\color{red}{m_{11}} & \\color{red}{m_{21}} & m_{31} \\\\ \\color{red}{m_{02}} & \\color{red}{m_{12}} & \\color{red}{m_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u6211\u4eec\u60f3\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\uff0c\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u4e3a\u89c2\u5bdf\u77e9\u9635\u4e0a3x3\u90e8\u5206\u7684\u8f6c\u7f6e\u77e9\u9635\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{01}} & \\color{red}{v_{02}} & m_{30} \\\\ \\color{red}{v_{10}} & \\color{red}{v_{11}} & \\color{red}{v_{12}} & m_{31} \\\\ \\color{red}{v_{20}} & \\color{red}{v_{21}} & \\color{red}{v_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u4f46\u5728\u8fd9\u4e4b\u540e\uff0c\u6211\u4eec\u53bb\u6389\u4e86\u7f29\u653e\uff0c\u5b9e\u9645\u4e0a\u771f\u6b63\u60f3\u8981\u8fbe\u5230\u7684\u7ed3\u679c\u662f\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{sx} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{sy} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{sz} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u5176\u4e2dsx\uff0csy\u548csz\u5c31\u662f\u7f29\u653e\u7cfb\u6570\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u7f6e\u4e3a\u89c2\u5bdf\u77e9\u9635\u7684\u8f6c\u7f6e\u77e9\u9635\u540e\uff0c\u6211\u4eec\u9700\u8981\u518d\u6b21\u5e94\u7528\u7f29\u653e\u3002 \u5c31\u8fd9\u4e9b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 renderParticlesMethod \u4e2d\u50cf\u8fd9\u6837\u4fee\u6539\uff1a for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); viewMatrix.transpose3x3(modelMatrix); Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.scale(gameItem.getScale()); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u6211\u4eec\u8fd8\u5728 Transformation \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u4f7f\u7528\u4e24\u4e2a\u77e9\u9635\u6765\u6784\u9020\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u800c\u4e0d\u662f\u4f7f\u7528 GameItem \u548c\u89c2\u5bdf\u77e9\u9635\u3002 \u6709\u4e86\u5982\u4e0a\u66f4\u6539\uff0c\u5f53\u4ece\u4e0a\u65b9\u89c2\u5bdf\u7c92\u5b50\u65f6\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a \u73b0\u5728\u96c6\u9f50\u4e86\u521b\u5efa\u4e00\u4e2a\u66f4\u771f\u5b9e\u7684\u7c92\u5b50\u6548\u679c\u6240\u9700\u8981\u7684\u6240\u6709\u8981\u7d20\uff0c\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u6539\u4e3a\u66f4\u7cbe\u7ec6\u7684\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5982\u4e0b\u56fe\u7247\uff08\u5b83\u662f\u7531 GIMP \u521b\u4f5c\u7684\uff0c\u5e26\u6709\u5149\u7167\u548c\u9634\u5f71\u8fc7\u6ee4\u5668\uff09\uff1a \u6709\u4e86\u5982\u4e0a\u7eb9\u7406\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7c92\u5b50\uff1a \u73b0\u5728\u66f4\u597d\u4e86\uff01\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u9700\u8981\u8c03\u6574\u7f29\u653e\uff0c\u56e0\u4e3a\u7c92\u5b50\u73b0\u5728\u603b\u662f\u5bf9\u7740\u6444\u50cf\u673a\uff0c\u663e\u793a\u7684\u9762\u79ef\u603b\u662f\u6700\u5927\u7684\u3002 \u6700\u540e\uff0c\u518d\u63d0\u4e00\u70b9\uff0c\u4e3a\u4e86\u5f97\u5230\u53ef\u4ee5\u5728\u4efb\u4f55\u573a\u666f\u4f7f\u7528\u7684\u5b8c\u7f8e\u7684\u6548\u679c\uff0c\u4f60\u9700\u8981\u5b9e\u73b0\u7c92\u5b50\u6392\u5e8f\u548c\u542f\u7528\u6df1\u5ea6\u7f13\u51b2\u533a\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u8fd9\u91cc\u6709\u4e00\u4e2a\u793a\u4f8b\u53ef\u4ee5\u5c06\u8fd9\u79cd\u6548\u679c\u56ca\u62ec\u5230\u4f60\u7684\u6e38\u620f\u4e2d\u3002 \u7eb9\u7406\u96c6\uff08Texture Atlas\uff09 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u505a\u597d\u4e86\u7c92\u5b50\u6548\u679c\u7684\u57fa\u7840\u5efa\u8bbe\uff0c\u73b0\u5728\u53ef\u4ee5\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e9b\u52a8\u753b\u6548\u679c\u4e86\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u652f\u6301\u7eb9\u7406\u96c6\u3002\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09\u662f\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5c06\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u7684\u5927\u578b\u56fe\u7247\u3002\u4f7f\u7528\u7eb9\u7406\u96c6\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u52a0\u8f7d\u4e00\u4e2a\u5927\u7684\u56fe\u7247\uff0c\u7136\u540e\u518d\u7ed8\u5236\u6e38\u620f\u9879\u65f6\uff0c\u9009\u62e9\u8be5\u56fe\u50cf\u7684\u4e00\u90e8\u5206\u4f5c\u4e3a\u7eb9\u7406\u3002\u4f8b\u5982\uff0c\u5f53\u6211\u4eec\u60f3\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u591a\u6b21\u6e32\u67d3\u76f8\u540c\u7684\u6a21\u578b\u65f6\uff08\u4f8b\u5982\u6811\u6216\u5ca9\u77f3\uff09\uff0c\u53ef\u4ee5\u4f7f\u7528\u8fd9\u79cd\u6280\u672f\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\u96c6\u5e76\u9009\u62e9\u9002\u5f53\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u4f7f\u7528\u5f88\u591a\u7eb9\u7406\u5b9e\u4f8b\u5e76\u5728\u5b83\u4eec\u4e4b\u95f4\u5207\u6362\uff08\u8bb0\u4f4f\uff0c\u5207\u6362\u72b6\u6001\u603b\u662f\u5f88\u6162\u7684\uff09\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6765\u6dfb\u52a0\u7c92\u5b50\u52a8\u753b\u3002\u6211\u4eec\u904d\u5386\u4e0d\u540c\u7684\u7eb9\u7406\u6765\u4e3a\u7c92\u5b50\u52a8\u753b\u5efa\u6a21\uff0c\u6240\u6709\u8fd9\u4e9b\u7eb9\u7406\u5c06\u88ab\u5206\u5230\u4e00\u4e2a\u50cf\u8fd9\u6837\u7684\u7eb9\u7406\u96c6\uff1a \u7eb9\u7406\u96c6\u53ef\u4ee5\u88ab\u5212\u5206\u4e3a\u591a\u4e2a\u65b9\u5f62\u7247\u6bb5\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u65b9\u5f62\u7247\u6bb5\u5750\u6807\u5206\u914d\u5230\u4e00\u4e2a\u7c92\u5b50\u4e0a\uff0c\u5e76\u968f\u7740\u65f6\u95f4\u63a8\u79fb\u6539\u53d8\u5b83\u4ee5\u8868\u793a\u52a8\u753b\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u5427\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u4fee\u6539 Texture \u7c7b\u6765\u6307\u5b9a\u7eb9\u7406\u96c6\u53ef\u4ee5\u62e5\u6709\u7684\u884c\u6570\u548c\u5217\u6570\u3002 package org.lwjglb.engine.graph; // .. \u8fd9\u91cc\u662f\u5bfc\u5165 public class Texture { // \u65e0\u5173\u5c5e\u6027\u7701\u7565 private int numRows = 1; private int numCols = 1; // \u65e0\u5173\u4ee3\u7801\u7701\u7565 public Texture(String fileName, int numCols, int numRows) throws Exception { this(fileName); this.numCols = numCols; this.numRows = numRows; } \u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5904\u7406\u7684\u7eb9\u7406\u7684\u5217\u6570\u548c\u884c\u6570\u7b49\u4e8e1\u3002\u6211\u4eec\u8fd8\u6dfb\u52a0\u4e86\u53e6\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u6765\u6307\u5b9a\u884c\u548c\u5217\u3002 \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ffd\u8e2a\u4e00\u4e2a GameItem \u5728\u7eb9\u7406\u96c6\u4e2d\u7684\u5750\u6807\uff0c\u56e0\u6b64\u53ea\u9700\u5411\u8be5\u7c7b\u6dfb\u52a0\u53e6\u4e00\u4e2a\u5c5e\u6027\uff0c\u9ed8\u8ba4\u503c\u4e3a0\u3002 package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { // \u66f4\u591a\u5c5e\u6027\u7701\u7565 private int textPos; \u7136\u540e\u6211\u4eec\u4fee\u6539 Particle \u7c7b\uff0c\u4ee5\u4fbf\u80fd\u591f\u901a\u8fc7\u7eb9\u7406\u96c6\u81ea\u52a8\u8fed\u4ee3\u3002 package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private long updateTextureMillis; private long currentAnimTimeMillis; \u5c5e\u6027 updateTextureMillis \u5b9a\u4e49\u79fb\u52a8\u5230\u7eb9\u7406\u96c6\u4e2d\u4e0b\u4e00\u4e2a\u5750\u6807\u7684\u65f6\u95f4\uff08\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d\uff09\u3002\u6570\u503c\u6708\u5e95\uff0c\u7c92\u5b50\u5728\u7eb9\u7406\u4e0a\u53d8\u5316\u7684\u901f\u5ea6\u5c31\u8d8a\u5feb\u3002\u5c5e\u6027 currentAnimTimeMillis \u53ea\u662f\u8ddf\u8e2a\u7eb9\u7406\u6301\u7eed\u5f53\u524d\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Particle \u7c7b\u6784\u9020\u51fd\u6570\u6765\u8bbe\u7f6e\u8fd9\u4e9b\u503c\u3002\u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u7eb9\u7406\u96c6\u7684\u7247\u6bb5\u6570\u91cf\uff0c\u5b83\u662f\u7531\u5c5e\u6027 animFrames \u5b9a\u4e49\u7684\u3002 public Particle(Mesh mesh, Vector3f speed, long ttl, long updateTextureMillis) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; this.updateTextureMills = updateTextureMills; this.currentAnimTimeMillis = 0; Texture texture = this.getMesh().getMaterial().getTexture(); this.animFrames = texture.getNumCols() * texture.getNumRows(); } \u73b0\u5728\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u68c0\u67e5\u7c92\u5b50\u662f\u5426\u5df2\u7ecf\u8fc7\u671f\u7684\u65b9\u6cd5\uff0c\u6765\u68c0\u67e5\u662f\u5426\u9700\u8981\u66f4\u65b0\u7eb9\u7406\u5750\u6807\u3002 public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; this.currentAnimTimeMillis += elapsedTime; if ( this.currentAnimTimeMillis >= this.getUpdateTextureMillis() && this.animFrames > 0 ) { this.currentAnimTimeMillis = 0; int pos = this.getTextPos(); pos++; if ( pos < this.animFrames ) { this.setTextPos(pos); } else { this.setTextPos(0); } } return this.ttl; } \u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 FlowRangeEmitter \u7c7b\uff0c\u5728\u5e94\u8be5\u6539\u53d8\u7c92\u5b50\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u5468\u671f\u4e0a\u589e\u52a0\u4e86\u4e00\u4e9b\u968f\u673a\u6027\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e9b\u6570\u636e\u6765\u8bbe\u7f6e\u5408\u9002\u7684\u7eb9\u7406\u5750\u6807\u3002\u6211\u4eec\u5c06\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u8fdb\u884c\u8fd9\u4e00\u64cd\u4f5c\uff0c\u56e0\u4e3a\u5b83\u8f93\u51fa\u4e86\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u90a3\u4e9b\u503c\u3002\u8fd9\u4e2a\u65b0\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform float texXOffset; uniform float texYOffset; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texXOffset); float y = (texCoord.y / numRows + texYOffset); outTexCoord = vec2(x, y); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u73b0\u5728\u6709\u4e09\u4e2a\u65b0Uniform\u3002Uniform numCols \u548c numRows \u53ea\u50a8\u5b58\u7eb9\u7406\u96c6\u7684\u5217\u548c\u884c\u6570\u3002\u4e3a\u4e86\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\uff0c\u9996\u5148\u5fc5\u987b\u7f29\u5c0f\u8fd9\u4e9b\u53c2\u6570\u3002\u6bcf\u4e2a\u7247\u6bb5\u7684\u5bbd\u5ea6\u4e3a 1 / numCols \uff0c\u9ad8\u5ea6\u4e3a 1 / numRows \uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u884c\u548c\u5217\u5e94\u7528\u548c\u504f\u79fb\uff0c\u8fd9\u662f\u7531 texXOffset \u548c texYOffset Uniform\u5b9a\u4e49\u7684\u3002 \u6211\u4eec\u5c06\u5728 Renderer \u7c7b\u4e2d\u8ba1\u7b97\u8fd9\u4e9b\u504f\u79fb\u91cf\uff0c\u5982\u4e0b\u8ff0\u4ee3\u7801\u6240\u793a\u3002\u6211\u4eec\u6839\u636e\u6bcf\u4e2a\u7c92\u5b50\u7684\u5750\u6807\u8ba1\u7b97\u5b83\u4eec\u6240\u5904\u7684\u884c\u548c\u5217\uff0c\u5e76\u5c06\u504f\u79fb\u91cf\u8ba1\u7b97\u4e3a\u7247\u6bb5\u9ad8\u5ea6\u548c\u5bbd\u5ea6\u7684\u500d\u6570\u3002 mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { int col = gameItem.getTextPos() % text.getNumCols(); int row = gameItem.getTextPos() / text.getNumCols(); float textXOffset = (float) col / text.getNumCols(); float textYOffset = (float) row / text.getNumRows(); particlesShaderProgram.setUniform(\"texXOffset\", textXOffset); particlesShaderProgram.setUniform(\"texYOffset\", textYOffset); \u6ce8\u610f\uff0c\u5982\u679c\u4f60\u53ea\u9700\u8981\u652f\u6301\u6b63\u65b9\u5f62\u7eb9\u7406\u96c6\uff0c\u4f60\u53ea\u9700\u8981\u4e24\u4e2aUniform\u3002\u6700\u7ec8\u7684\u6548\u679c\u662f\u8fd9\u6837\u7684\uff1a \u73b0\u5728\uff0c\u6211\u4eec\u6709\u4e86\u7c92\u5b50\u52a8\u753b\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4f18\u5316\u6e32\u67d3\u6d41\u7a0b\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u5177\u6709\u76f8\u540c\u7f51\u683c\u7684\u591a\u4e2a\u5143\u7d20\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u5143\u7d20\u8fdb\u884c\u7ed8\u5236\u8c03\u7528\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u5728\u5355\u4e2a\u8c03\u7528\u4e2d\u6e32\u67d3\u5b83\u4eec\u3002\u8fd9\u79cd\u6280\u672f\u4e0d\u4ec5\u9002\u7528\u4e8e\u7c92\u5b50\uff0c\u4e5f\u9002\u7528\u4e8e\u6e32\u67d3\u5171\u4eab\u540c\u4e00\u6a21\u578b\uff0c\u4f46\u88ab\u653e\u5728\u4e0d\u540c\u4f4d\u7f6e\u6216\u5177\u6709\u4e0d\u540c\u7eb9\u7406\u7684\u591a\u4e2a\u5143\u7d20\u7684\u573a\u666f\u3002","title":"\u7c92\u5b50"},{"location":"20-particles/#particles","text":"","title":"\u7c92\u5b50\uff08Particles\uff09"},{"location":"20-particles/#_1","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u7c92\u5b50\u6548\u679c\u5230\u6e38\u620f\u5f15\u64ce\u4e2d\u3002\u6709\u4e86\u8fd9\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5c31\u80fd\u6a21\u62df\u5173\u7cfb\u3001\u706b\u3001\u7070\u5c18\u548c\u4e91\u3002\u8fd9\u662f\u4e00\u79cd\u7b80\u5355\u7684\u6548\u679c\uff0c\u5c06\u6539\u5584\u5bf9\u4efb\u4f55\u6e38\u620f\u7684\u56fe\u5f62\u65b9\u9762\u3002 \u5728\u6b64\u4e4b\u524d\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u6709\u5f88\u591a\u65b9\u6cd5\u53ef\u4ee5\u5b9e\u73b0\u4e0d\u540c\u6548\u679c\u7684\u7c92\u5b50\u6548\u679c\u3002\u5f53\u524d\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u677f\u7c92\u5b50\uff08Billboard Particle\uff09\u3002\u8be5\u6280\u672f\u4f7f\u7528\u79fb\u52a8\u7684\u7eb9\u7406\u56db\u8fb9\u5f62\u6765\u8868\u793a\u4e00\u4e2a\u7c92\u5b50\uff0c\u5b83\u4eec\u603b\u662f\u9762\u5411\u89c2\u5bdf\u8005\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u5c31\u662f\u6444\u50cf\u673a\u3002\u4f60\u8fd8\u53ef\u4ee5\u4f7f\u7528\u9762\u677f\u6280\u672f\u5728\u6e38\u620f\u9879\u4e0a\u663e\u793a\u4fe1\u606f\u9762\u677f\uff0c\u6bd4\u5982\u8ff7\u4f60HUD\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5b9a\u4e49\u7c92\u5b50\uff0c\u7c92\u5b50\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u7528\u4e8e\u8868\u793a\u56db\u8fb9\u5f62\u9876\u70b9\u7684\u7f51\u683c\u3002 \u4e00\u5f20\u7eb9\u7406\u3002 \u67d0\u4e00\u65f6\u523b\u7684\u5750\u6807\u3002 \u7f29\u653e\u7cfb\u6570\u3002 \u901f\u5ea6\u3002 \u79fb\u52a8\u65b9\u5411\u3002 \u751f\u5b58\u65f6\u95f4\u6216\u5b58\u6d3b\u65f6\u95f4\u3002\u4e00\u65e6\u8be5\u65f6\u95f4\u8fc7\u53bb\uff0c\u7c92\u5b50\u5c31\u4e0d\u518d\u5b58\u5728\u3002 \u524d\u56db\u9879\u662f GameItem \u7c7b\u7684\u4e00\u90e8\u5206\uff0c\u4f46\u540e\u4e09\u9879\u4e0d\u662f\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Particle \u7684\u65b0\u7c7b\uff0c\u5b83\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private Vector3f speed; /** * \u7c92\u5b50\u5b58\u6d3b\u7684\u65f6\u95f4\uff0c\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d */ private long ttl; public Particle(Mesh mesh, Vector3f speed, long ttl) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; } public Particle(Particle baseParticle) { super(baseParticle.getMesh()); Vector3f aux = baseParticle.getPosition(); setPosition(aux.x, aux.y, aux.z); aux = baseParticle.getRotation(); setRotation(aux.x, aux.y, aux.z); setScale(baseParticle.getScale()); this.speed = new Vector3f(baseParticle.speed); this.ttl = baseParticle.geTtl(); } public Vector3f getSpeed() { return speed; } public void setSpeed(Vector3f speed) { this.speed = speed; } public long geTtl() { return ttl; } public void setTtl(long ttl) { this.ttl = ttl; } /** * \u66f4\u65b0\u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 * @param elapsedTime \u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 * @return \u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 */ public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; return this.ttl; } } \u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u51fa\uff0c\u7c92\u5b50\u7684\u901f\u5ea6\u548c\u8fd0\u52a8\u65b9\u5411\u53ef\u4ee5\u8868\u793a\u4e3a\u4e00\u4e2a\u5411\u91cf\u3002\u8be5\u5411\u91cf\u7684\u65b9\u5411\u51b3\u5b9a\u4e86\u7c92\u5b50\u7684\u8fd0\u52a8\u65b9\u5411\u548c\u901f\u5ea6\u3002\u7c92\u5b50\u5b58\u6d3b\u65f6\u95f4\uff08TTL\uff09\u88ab\u8bbe\u5b9a\u4e3a\u6beb\u79d2\u8ba1\u6570\u5668\uff0c\u6bcf\u5f53\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u65f6\uff0c\u5b83\u90fd\u4f1a\u51cf\u5c11\u3002\u8be5\u7c7b\u8fd8\u6709\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u53e6\u4e00\u4e2a\u7c92\u5b50\u5b9e\u4f8b\u6765\u8fdb\u884c\u590d\u5236\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7c92\u5b50\u751f\u6210\u5668\u6216\u7c92\u5b50\u53d1\u5c04\u5668\uff0c\u5373\u4e00\u4e2a\u52a8\u6001\u751f\u6210\u7c92\u5b50\u3001\u63a7\u5236\u5176\u751f\u547d\u5468\u671f\u5e76\u6839\u636e\u7279\u5b9a\u7684\u6a21\u5f0f\u66f4\u65b0\u5176\u4f4d\u7f6e\u7684\u7c7b\u3002\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u5f88\u591a\u5b9e\u73b0\uff0c\u5b83\u4eec\u5728\u7c92\u5b50\u7684\u521b\u5efa\u65b9\u5f0f\u548c\u4f4d\u7f6e\u7684\u66f4\u65b0\u65b9\u5f0f\uff08\u4f8b\u5982\uff0c\u662f\u5426\u8003\u8651\u91cd\u529b\uff09\u65b9\u9762\u5404\u4e0d\u76f8\u540c\u3002\u56e0\u6b64\uff0c\u4e3a\u4e86\u4fdd\u6301\u6e38\u620f\u5f15\u64ce\u7684\u901a\u7528\u6027\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u6240\u6709\u7c92\u5b50\u53d1\u5c04\u5668\u5fc5\u987b\u8981\u5b9e\u73b0\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u540d\u4e3a IParticleEmitter \u7684\u63a5\u53e3\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.List; import org.lwjglb.engine.items.GameItem; public interface IParticleEmitter { void cleanup(); Particle getBaseParticle(); List<GameItem> getParticles(); } IParticleEmitter \u63a5\u53e3\u6709\u4e00\u4e2a\u6e05\u7406\u8d44\u6e90\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a cleanup \uff0c\u8fd8\u6709\u4e00\u4e2a\u83b7\u53d6\u7c92\u5b50\u5217\u8868\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getParticles \u3002\u8fd8\u6709\u4e00\u4e2a\u540d\u4e3a getBaseParticle \u7684\u65b9\u6cd5\uff0c\u4f46\u662f\u8fd9\u4e2a\u65b9\u6cd5\u662f\u505a\u4ec0\u4e48\u7684\u5462\uff1f\u4e00\u4e2a\u7c92\u5b50\u53d1\u5c04\u5668\u5c06\u52a8\u6001\u5730\u4ea7\u751f\u8bb8\u591a\u4f8b\u5b50\u3002\u6bcf\u5f53\u4e00\u4e2a\u7c92\u5b50\u8fc7\u671f\uff0c\u5c31\u4f1a\u521b\u5efa\u65b0\u7684\u7c92\u5b50\u3002\u8be5\u7c92\u5b50\u66f4\u65b0\u5468\u671f\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u4f5c\u4e3a\u6a21\u677f\u521b\u5efa\u65b0\u7684\u52bf\u529b\u3002\u8fd9\u5c31\u662f\u57fa\u7840\u7c92\u5b50\u7684\u7528\u9014\uff0c\u8fd9\u4e5f\u662f\u4e3a\u4ec0\u4e48 Particle \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\u3002 \u5728\u6e38\u620f\u5f15\u64ce\u7684\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u5f15\u7528 IParticleEmitter \u63a5\u53e3\uff0c\u56e0\u6b64\u57fa\u7840\u4ee3\u7801\u5c06\u4e0d\u4f9d\u8d56\u4e8e\u7279\u5b9a\u7684\u5b9e\u73b0\u3002\u4e0d\u8fc7\uff0c\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u5b9e\u73b0\u6765\u6a21\u62df\u4e0d\u53d7\u91cd\u529b\u5f71\u54cd\u7684\u7c92\u5b50\u6d41\u3002\u8fd9\u4e2a\u5b9e\u73b0\u53ef\u4ee5\u7528\u6765\u6a21\u62df\u5149\u7ebf\u6216\u706b\u7130\uff0c\u540d\u4e3a FlowParticleEmitter \u3002 \u8fd9\u4e2a\u7c7b\u7684\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u8fdb\u884c\u8c03\u6574\uff1a \u4e00\u6b21\u80fd\u5b58\u5728\u7684\u6700\u5927\u7c92\u5b50\u6570\u91cf \u521b\u5efa\u7c92\u5b50\u7684\u6700\u77ed\u5468\u671f\u3002\u7c92\u5b50\u5c06\u5728\u6700\u77ed\u7684\u65f6\u95f4\u5185\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5730\u521b\u5efa\uff0c\u4ee5\u907f\u514d\u7c92\u5b50\u7206\u53d1\u6027\u521b\u5efa\u3002 \u4e00\u7ec4\u8303\u56f4\uff0c\u4ee5\u968f\u673a\u7c92\u5b50\u901f\u5ea6\u548c\u4f4d\u7f6e\u3002\u65b0\u7c92\u5b50\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u7684\u4f4d\u7f6e\u548c\u901f\u5ea6\uff0c\u53ef\u4ee5\u5728\u76f8\u5e94\u8303\u56f4\u5185\u53d6\u503c\uff0c\u4ee5\u5206\u6563\u5149\u7ebf\u3002 \u8be5\u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.joml.Vector3f; import org.lwjglb.engine.items.GameItem; public class FlowParticleEmitter implements IParticleEmitter { private int maxParticles; private boolean active; private final List<GameItem> particles; private final Particle baseParticle; private long creationPeriodMillis; private long lastCreationTime; private float speedRndRange; private float positionRndRange; private float scaleRndRange; public FlowParticleEmitter(Particle baseParticle, int maxParticles, long creationPeriodMillis) { particles = new ArrayList<>(); this.baseParticle = baseParticle; this.maxParticles = maxParticles; this.active = false; this.lastCreationTime = 0; this.creationPeriodMillis = creationPeriodMillis; } @Override public Particle getBaseParticle() { return baseParticle; } public long getCreationPeriodMillis() { return creationPeriodMillis; } public int getMaxParticles() { return maxParticles; } @Override public List<GameItem> getParticles() { return particles; } public float getPositionRndRange() { return positionRndRange; } public float getScaleRndRange() { return scaleRndRange; } public float getSpeedRndRange() { return speedRndRange; } public void setCreationPeriodMillis(long creationPeriodMillis) { this.creationPeriodMillis = creationPeriodMillis; } public void setMaxParticles(int maxParticles) { this.maxParticles = maxParticles; } public void setPositionRndRange(float positionRndRange) { this.positionRndRange = positionRndRange; } public void setScaleRndRange(float scaleRndRange) { this.scaleRndRange = scaleRndRange; } public boolean isActive() { return active; } public void setActive(boolean active) { this.active = active; } public void setSpeedRndRange(float speedRndRange) { this.speedRndRange = speedRndRange; } public void update(long ellapsedTime) { long now = System.currentTimeMillis(); if (lastCreationTime == 0) { lastCreationTime = now; } Iterator<? extends GameItem> it = particles.iterator(); while (it.hasNext()) { Particle particle = (Particle) it.next(); if (particle.updateTtl(ellapsedTime) < 0) { it.remove(); } else { updatePosition(particle, ellapsedTime); } } int length = this.getParticles().size(); if (now - lastCreationTime >= this.creationPeriodMillis && length < maxParticles) { createParticle(); this.lastCreationTime = now; } } private void createParticle() { Particle particle = new Particle(this.getBaseParticle()); // \u6dfb\u52a0\u4e00\u4e9b\u968f\u673a\u7684\u7c92\u5b50 float sign = Math.random() > 0.5d ? -1.0f : 1.0f; float speedInc = sign * (float)Math.random() * this.speedRndRange; float posInc = sign * (float)Math.random() * this.positionRndRange; float scaleInc = sign * (float)Math.random() * this.scaleRndRange; particle.getPosition().add(posInc, posInc, posInc); particle.getSpeed().add(speedInc, speedInc, speedInc); particle.setScale(particle.getScale() + scaleInc); particles.add(particle); } /** * \u66f4\u65b0\u4e00\u4e2a\u7c92\u5b50\u7684\u4f4d\u7f6e * @param particle \u9700\u8981\u66f4\u65b0\u7684\u7c92\u5b50 * @param elapsedTime \u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 */ public void updatePosition(Particle particle, long elapsedTime) { Vector3f speed = particle.getSpeed(); float delta = elapsedTime / 1000.0f; float dx = speed.x * delta; float dy = speed.y * delta; float dz = speed.z * delta; Vector3f pos = particle.getPosition(); particle.setPosition(pos.x + dx, pos.y + dy, pos.z + dz); } @Override public void cleanup() { for (GameItem particle : getParticles()) { particle.cleanup(); } } } \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u62d3\u5c55 Scene \u7c7b\u4e2d\u5305\u542b\u7684\u6570\u636e\uff0c\u4f7f\u5176\u5305\u542b\u4e00\u4e2a ParticleEmitter \u7684\u5b9e\u4f8b\u6570\u7ec4\u3002 package org.lwjglb.engine; // \u8fd9\u662f\u5bfc\u5165\u2026\u2026 public class Scene { // \u8fd9\u6709\u66f4\u591a\u5c5e\u6027\u2026\u2026 private IParticleEmitter[] particleEmitters; \u5728\u8be5\u9636\u6bb5\uff0c\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u6e32\u67d3\u7c92\u5b50\u3002\u7c92\u5b50\u4e0d\u4f1a\u53d7\u5230\u5149\u7684\u5f71\u54cd\uff0c\u4e5f\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u97f3\u4e50\u3002\u5b83\u4eec\u4e0d\u4f1a\u6709\u4efb\u4f55\u9aa8\u9abc\u52a8\u753b\uff0c\u6240\u4ee5\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6e32\u67d3\u5b83\u4eec\u662f\u6ca1\u6709\u610f\u4e49\u7684\u3002\u7740\u8272\u5668\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u4f1a\u4f7f\u7528\u6295\u5f71\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6e32\u67d3\u9876\u70b9\uff0c\u5e76\u4f7f\u7528\u7eb9\u7406\u8bbe\u7f6e\u989c\u8272\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u7247\u5143\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u975e\u5e38\u7b80\u5355\uff0c\u5c31\u50cf\u6e32\u67d3\u4e00\u7ae0\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u3002\u73b0\u5728\uff0c\u548c\u5176\u4ed6\u7ae0\u8282\u4e00\u6837\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u8bbe\u7f6e\u548c\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u3002\u7740\u8272\u5668\u7684\u8bbe\u7f6e\u5c06\u5728\u4e00\u4e2a\u540d\u4e3a setupParticlesShader \u7684\u65b9\u6cd5\u4e2d\u5b8c\u6210\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private void setupParticlesShader() throws Exception { particlesShaderProgram = new ShaderProgram(); particlesShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/particles_vertex.vs\")); particlesShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/particles_fragment.fs\")); particlesShaderProgram.link(); particlesShaderProgram.createUniform(\"projectionMatrix\"); particlesShaderProgram.createUniform(\"modelViewMatrix\"); particlesShaderProgram.createUniform(\"texture_sampler\"); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728Renderer\u7c7b\u4e2d\u521b\u5efa\u6e32\u67d3\u65b9\u6cd5 renderParticles \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderParticles(Window window, Camera camera, Scene scene) { particlesShaderProgram.bind(); particlesShaderProgram.setUniform(\"texture_sampler\", 0); Matrix4f projectionMatrix = transformation.getProjectionMatrix(); particlesShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); Matrix4f viewMatrix = transformation.getViewMatrix(); IParticleEmitter[] emitters = scene.getParticleEmitters(); int numEmitters = emitters != null ? emitters.length : 0; for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } particlesShaderProgram.unbind(); } \u5982\u679c\u4f60\u52aa\u529b\u9605\u8bfb\uff0c\u4e0a\u8ff0\u4ee3\u7801\u5e94\u8be5\u662f\u4e0d\u8a00\u81ea\u660e\u7684\uff0c\u5b83\u53ea\u662f\u8bbe\u7f6e\u5fc5\u8981\u7684Uniform\uff0c\u5e76\u6e32\u67d3\u6bcf\u4e2a\u7c92\u5b50\u3002\u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u6d4b\u8bd5\u7c92\u5b50\u6548\u679c\u5b9e\u73b0\u6240\u9700\u7684\u6240\u6709\u65b9\u6cd5\uff0c\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u521b\u5efa\u7c92\u5b50\u53d1\u5c04\u5668\u548c\u57fa\u672c\u7c92\u5b50\u7684\u7279\u6027\u3002 Vector3f particleSpeed = new Vector3f(0, 1, 0); particleSpeed.mul(2.5f); long ttl = 4000; int maxParticles = 200; long creationPeriodMillis = 300; float range = 0.2f; float scale = 0.5f; Mesh partMesh = OBJLoader.loadMesh(\"/models/particle.obj\"); Texture texture = new Texture(\"/textures/particle_tmp.png\"); Material partMaterial = new Material(texture, reflectance); partMesh.setMaterial(partMaterial); Particle particle = new Particle(partMesh, particleSpeed, ttl); particle.setScale(scale); particleEmitter = new FlowParticleEmitter(particle, maxParticles, creationPeriodMillis); particleEmitter.setActive(true); particleEmitter.setPositionRndRange(range); particleEmitter.setSpeedRndRange(range); this.scene.setParticleEmitters(new FlowParticleEmitter[] {particleEmitter}); \u6211\u4eec\u73b0\u5728\u4f7f\u7528\u4e00\u4e2a\u666e\u901a\u586b\u5145\u5706\u4f5c\u4e3a\u7c92\u5b50\u7684\u7eb9\u7406\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u5982\u679c\u4f60\u8fd0\u884c\u5b83\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u4e3a\u4ec0\u4e48\u4e00\u4e9b\u7c92\u5b50\u4f3c\u4e4e\u88ab\u5207\u65ad\u4e86\uff1f\u4e3a\u4ec0\u4e48\u900f\u660e\u7684\u80cc\u666f\u4e0d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1f\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\u3002\u7c92\u5b50\u7684\u4e00\u4e9b\u7247\u5143\u88ab\u4e22\u5f03\uff0c\u56e0\u4e3a\u5b83\u4eec\u5177\u6709\u6bd4\u8be5\u533a\u57df\u7684\u6df1\u5ea6\u7f13\u51b2\u7684\u5f53\u524d\u503c\u9ad8\u7684\u6df1\u5ea6\u503c\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5c06\u5176\u4e0e\u6444\u50cf\u673a\u4e4b\u95f4\u7684\u8ddd\u79bb\u6765\u6392\u5e8f\u7c92\u5b50\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6216\u8005\u6211\u4eec\u53ef\u4ee5\u7981\u7528\u6df1\u5ea6\u5199\u5165\u3002 \u5728\u7ed8\u5236\u7c92\u5b50\u4e4b\u524d\u6211\u4eec\u9700\u8981\u63d2\u5165\u8fd9\u4e00\u884c\u4ee3\u7801\uff1a glDepthMask(false); \u7136\u540e\u5728\u6211\u4eec\u5b8c\u6210\u6e32\u67d3\u4e4b\u540e\u8fd8\u539f\u4e3a\u5148\u524d\u503c\uff1a glDepthMask(true); \u7136\u540e\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u597d\u4e86\uff0c\u95ee\u9898\u89e3\u51b3\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u60f3\u5e94\u7528\u53e6\u4e00\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5e0c\u671b\u989c\u8272\u88ab\u6df7\u5408\uff0c\u56e0\u6b64\u989c\u8272\u5c06\u88ab\u6dfb\u52a0\uff0c\u4ee5\u8fbe\u6210\u66f4\u597d\u7684\u6548\u679c\u3002\u8fd9\u662f\u5728\u6e32\u67d3\u524d\u589e\u52a0\u5982\u4e0b\u4e00\u884c\u4ee3\u7801\u6765\u5b9e\u73b0\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE); \u4e0e\u6df1\u5ea6\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u6e32\u67d3\u5b8c\u6240\u6709\u7c92\u5b50\u540e\uff0c\u6211\u4eec\u5c06\u6df7\u5408\u51fd\u6570\u6062\u590d\u4e3a\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u6211\u4eec\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f46\u6211\u4eec\u8fd8\u6ca1\u6709\u5b8c\u6210\u5b83\u3002\u5982\u679c\u4f60\u628a\u6444\u50cf\u673a\u79fb\u5230\u84dd\u8272\u6b63\u65b9\u5f62\u7684\u4e0a\u65b9\u5f80\u4e0b\u770b\uff0c\u4f60\u53ef\u80fd\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u4e1c\u897f\uff1a \u8fd9\u4e9b\u7c92\u5b50\u770b\u8d77\u6765\u4e0d\u592a\u597d\uff0c\u5b83\u4eec\u5e94\u8be5\u662f\u5706\u7684\uff0c\u4f46\u73b0\u5728\u770b\u8d77\u6765\u50cf\u4e00\u5f20\u7eb8\u3002\u5728\u6b64\u4e4b\u4e0a\uff0c\u6211\u4eec\u5e94\u8be5\u5e94\u7528\u9762\u677f\u6280\u672f\u3002\u7528\u4e8e\u6e32\u67d3\u7c92\u5b50\u7684\u56db\u8fb9\u5f62\u5e94\u8be5\u59cb\u7ec8\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e0e\u6444\u50cf\u673a\u65b9\u5411\u5b8c\u5168\u5782\u76f4\uff0c\u5c31\u597d\u50cf\u6839\u672c\u6ca1\u6709\u65cb\u8f6c\u4e00\u6837\u3002\u6444\u50cf\u673a\u7684\u77e9\u9635\u5c06\u4f4d\u79fb\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u573a\u666f\u4e2d\u7684\u6bcf\u4e00\u4e2a\u5bf9\u8c61\uff0c\u6211\u4eec\u60f3\u8df3\u8fc7\u5c06\u8981\u5e94\u7528\u7684\u65cb\u8f6c\u3002 \u8b66\u544a\uff1a\u5728\u8bb2\u6570\u5b66\u77e5\u8bc6\u65f6\uff0c\u5982\u679c\u4f60\u89c9\u5f97\u4e0d\u8212\u670d\uff0c\u4f60\u53ef\u4ee5\u8df3\u8fc7\u5b83\u3002\u8ba9\u6211\u4eec\u518d\u6b21\u56de\u987e\u90a3\u4e2a\u89c2\u5bdf\u77e9\u9635\u3002\u8be5\u77e9\u9635\u53ef\u4ee5\u50cf\u8fd9\u6837\u8868\u793a\uff08\u6ca1\u6709\u5e94\u7528\u4efb\u4f55\u7f29\u653e\uff09\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{r_{00}} & \\color{red}{r_{10}} & \\color{red}{r_{20}} & \\color{blue}{dx} \\\\ \\color{red}{r_{01}} & \\color{red}{r_{11}} & \\color{red}{r_{21}} & \\color{blue}{dy} \\\\ \\color{red}{r_{02}} & \\color{red}{r_{12}} & \\color{red}{r_{22}} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7ea2\u8272\u7684\u5143\u7d20\u4ee3\u8868\u6444\u50cf\u673a\u7684\u65cb\u8f6c\uff0c\u84dd\u8272\u7684\u5143\u7d20\u4ee3\u8868\u4f4d\u79fb\u3002\u6211\u4eec\u9700\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u4e2d\u7684\u5de6\u4e0a\u89d23x3\u77e9\u9635\u7684\u65cb\u8f6c\u6548\u679c\uff0c\u6240\u4ee5\u5b83\u4f1a\u53d8\u6210\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & \\color{blue}{dx} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & \\color{blue}{dy} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u5728\u5de6\u4e0a\u89d2\u7684\u7ea2\u8272\u90e8\u5206\uff0c\u6211\u4eec\u6709\u4e00\u4e2a3x3\u77e9\u9635\uff0c\u628a\u5b83\u547d\u540d\u4e3a M_{r} \u5e76\u4e14\u6211\u4eec\u60f3\u628a\u5b83\u8f6c\u6362\u6210\u5355\u4f4d\u77e9\u9635\uff1a I \u3002\u4efb\u4f55\u77e9\u9635\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\u90fd\u4f1a\u5f97\u5230\u5355\u4f4d\u77e9\u9635\uff1a M_{r} \\times M_{r}^{-1} = I \u3002\u6211\u4eec\u53ea\u9700\u8981\u4ece\u89c2\u5bdf\u77e9\u9635\u4e2d\u53d6\u5de6\u4e0a\u89d2\u76843x3\u77e9\u9635\uff0c\u7136\u540e\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u8fd8\u53ef\u4ee5\u4f18\u5316\u4ed6\u3002\u4e00\u4e2a\u65cb\u8f6c\u77e9\u9635\u6709\u4e00\u4e2a\u6709\u8da3\u7684\u5b9a\u7406\uff0c\u5b83\u7684\u9006\u77e9\u9635\u4e0e\u5176\u8f6c\u7f6e\u77e9\u9635\u76f8\u7b49\u3002\u5373\uff1a M_{r} \\times M_{r}^{-1} = M_{r} \\times M_{r}^{T} = I \u3002\u8f6c\u7f6e\u77e9\u9635\u6bd4\u9006\u77e9\u9635\u66f4\u5bb9\u6613\u8ba1\u7b97\u3002\u77e9\u9635\u7684\u8f6c\u7f6e\u5c31\u50cf\u5c06\u5176\u53cd\u8f6c\u8fc7\u6765\uff0c\u5c06\u6bcf\u4e00\u5217\u4e0e\u6bcf\u4e00\u884c\u66ff\u6362\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} r_{00} & r_{10} & r_{20} \\\\ r_{01} & r_{11} & r_{21} \\\\ r_{02} & r_{12} & r_{22} \\end{bmatrix} ^{T} = \\begin{bmatrix} r_{00} & r_{01} & r_{02} \\\\ r_{10} & r_{11} & r_{12} \\\\ r_{20} & r_{21} & r_{22} \\end{bmatrix} \u597d\u7684\uff0c\u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\u3002\u6211\u4eec\u6709\u8be5\u53d8\u6362\uff1a V \\times M \uff0c\u5176\u4e2d V \u662f\u89c2\u5bdf\u77e9\u9635\uff0c M \u662f\u6a21\u578b\u77e9\u9635\u3002\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u8868\u8fbe\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{m_{00}} & \\color{red}{m_{10}} & \\color{red}{m_{20}} & m_{30} \\\\ \\color{red}{m_{01}} & \\color{red}{m_{11}} & \\color{red}{m_{21}} & m_{31} \\\\ \\color{red}{m_{02}} & \\color{red}{m_{12}} & \\color{red}{m_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u6211\u4eec\u60f3\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\uff0c\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u4e3a\u89c2\u5bdf\u77e9\u9635\u4e0a3x3\u90e8\u5206\u7684\u8f6c\u7f6e\u77e9\u9635\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{01}} & \\color{red}{v_{02}} & m_{30} \\\\ \\color{red}{v_{10}} & \\color{red}{v_{11}} & \\color{red}{v_{12}} & m_{31} \\\\ \\color{red}{v_{20}} & \\color{red}{v_{21}} & \\color{red}{v_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u4f46\u5728\u8fd9\u4e4b\u540e\uff0c\u6211\u4eec\u53bb\u6389\u4e86\u7f29\u653e\uff0c\u5b9e\u9645\u4e0a\u771f\u6b63\u60f3\u8981\u8fbe\u5230\u7684\u7ed3\u679c\u662f\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{sx} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{sy} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{sz} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u5176\u4e2dsx\uff0csy\u548csz\u5c31\u662f\u7f29\u653e\u7cfb\u6570\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u7f6e\u4e3a\u89c2\u5bdf\u77e9\u9635\u7684\u8f6c\u7f6e\u77e9\u9635\u540e\uff0c\u6211\u4eec\u9700\u8981\u518d\u6b21\u5e94\u7528\u7f29\u653e\u3002 \u5c31\u8fd9\u4e9b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 renderParticlesMethod \u4e2d\u50cf\u8fd9\u6837\u4fee\u6539\uff1a for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); viewMatrix.transpose3x3(modelMatrix); Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.scale(gameItem.getScale()); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u6211\u4eec\u8fd8\u5728 Transformation \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u4f7f\u7528\u4e24\u4e2a\u77e9\u9635\u6765\u6784\u9020\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u800c\u4e0d\u662f\u4f7f\u7528 GameItem \u548c\u89c2\u5bdf\u77e9\u9635\u3002 \u6709\u4e86\u5982\u4e0a\u66f4\u6539\uff0c\u5f53\u4ece\u4e0a\u65b9\u89c2\u5bdf\u7c92\u5b50\u65f6\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a \u73b0\u5728\u96c6\u9f50\u4e86\u521b\u5efa\u4e00\u4e2a\u66f4\u771f\u5b9e\u7684\u7c92\u5b50\u6548\u679c\u6240\u9700\u8981\u7684\u6240\u6709\u8981\u7d20\uff0c\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u6539\u4e3a\u66f4\u7cbe\u7ec6\u7684\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5982\u4e0b\u56fe\u7247\uff08\u5b83\u662f\u7531 GIMP \u521b\u4f5c\u7684\uff0c\u5e26\u6709\u5149\u7167\u548c\u9634\u5f71\u8fc7\u6ee4\u5668\uff09\uff1a \u6709\u4e86\u5982\u4e0a\u7eb9\u7406\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7c92\u5b50\uff1a \u73b0\u5728\u66f4\u597d\u4e86\uff01\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u9700\u8981\u8c03\u6574\u7f29\u653e\uff0c\u56e0\u4e3a\u7c92\u5b50\u73b0\u5728\u603b\u662f\u5bf9\u7740\u6444\u50cf\u673a\uff0c\u663e\u793a\u7684\u9762\u79ef\u603b\u662f\u6700\u5927\u7684\u3002 \u6700\u540e\uff0c\u518d\u63d0\u4e00\u70b9\uff0c\u4e3a\u4e86\u5f97\u5230\u53ef\u4ee5\u5728\u4efb\u4f55\u573a\u666f\u4f7f\u7528\u7684\u5b8c\u7f8e\u7684\u6548\u679c\uff0c\u4f60\u9700\u8981\u5b9e\u73b0\u7c92\u5b50\u6392\u5e8f\u548c\u542f\u7528\u6df1\u5ea6\u7f13\u51b2\u533a\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u8fd9\u91cc\u6709\u4e00\u4e2a\u793a\u4f8b\u53ef\u4ee5\u5c06\u8fd9\u79cd\u6548\u679c\u56ca\u62ec\u5230\u4f60\u7684\u6e38\u620f\u4e2d\u3002","title":"\u57fa\u7840"},{"location":"20-particles/#texture-atlas","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u505a\u597d\u4e86\u7c92\u5b50\u6548\u679c\u7684\u57fa\u7840\u5efa\u8bbe\uff0c\u73b0\u5728\u53ef\u4ee5\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e9b\u52a8\u753b\u6548\u679c\u4e86\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u652f\u6301\u7eb9\u7406\u96c6\u3002\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09\u662f\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5c06\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u7684\u5927\u578b\u56fe\u7247\u3002\u4f7f\u7528\u7eb9\u7406\u96c6\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u52a0\u8f7d\u4e00\u4e2a\u5927\u7684\u56fe\u7247\uff0c\u7136\u540e\u518d\u7ed8\u5236\u6e38\u620f\u9879\u65f6\uff0c\u9009\u62e9\u8be5\u56fe\u50cf\u7684\u4e00\u90e8\u5206\u4f5c\u4e3a\u7eb9\u7406\u3002\u4f8b\u5982\uff0c\u5f53\u6211\u4eec\u60f3\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u591a\u6b21\u6e32\u67d3\u76f8\u540c\u7684\u6a21\u578b\u65f6\uff08\u4f8b\u5982\u6811\u6216\u5ca9\u77f3\uff09\uff0c\u53ef\u4ee5\u4f7f\u7528\u8fd9\u79cd\u6280\u672f\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\u96c6\u5e76\u9009\u62e9\u9002\u5f53\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u4f7f\u7528\u5f88\u591a\u7eb9\u7406\u5b9e\u4f8b\u5e76\u5728\u5b83\u4eec\u4e4b\u95f4\u5207\u6362\uff08\u8bb0\u4f4f\uff0c\u5207\u6362\u72b6\u6001\u603b\u662f\u5f88\u6162\u7684\uff09\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6765\u6dfb\u52a0\u7c92\u5b50\u52a8\u753b\u3002\u6211\u4eec\u904d\u5386\u4e0d\u540c\u7684\u7eb9\u7406\u6765\u4e3a\u7c92\u5b50\u52a8\u753b\u5efa\u6a21\uff0c\u6240\u6709\u8fd9\u4e9b\u7eb9\u7406\u5c06\u88ab\u5206\u5230\u4e00\u4e2a\u50cf\u8fd9\u6837\u7684\u7eb9\u7406\u96c6\uff1a \u7eb9\u7406\u96c6\u53ef\u4ee5\u88ab\u5212\u5206\u4e3a\u591a\u4e2a\u65b9\u5f62\u7247\u6bb5\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u65b9\u5f62\u7247\u6bb5\u5750\u6807\u5206\u914d\u5230\u4e00\u4e2a\u7c92\u5b50\u4e0a\uff0c\u5e76\u968f\u7740\u65f6\u95f4\u63a8\u79fb\u6539\u53d8\u5b83\u4ee5\u8868\u793a\u52a8\u753b\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u5427\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u4fee\u6539 Texture \u7c7b\u6765\u6307\u5b9a\u7eb9\u7406\u96c6\u53ef\u4ee5\u62e5\u6709\u7684\u884c\u6570\u548c\u5217\u6570\u3002 package org.lwjglb.engine.graph; // .. \u8fd9\u91cc\u662f\u5bfc\u5165 public class Texture { // \u65e0\u5173\u5c5e\u6027\u7701\u7565 private int numRows = 1; private int numCols = 1; // \u65e0\u5173\u4ee3\u7801\u7701\u7565 public Texture(String fileName, int numCols, int numRows) throws Exception { this(fileName); this.numCols = numCols; this.numRows = numRows; } \u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5904\u7406\u7684\u7eb9\u7406\u7684\u5217\u6570\u548c\u884c\u6570\u7b49\u4e8e1\u3002\u6211\u4eec\u8fd8\u6dfb\u52a0\u4e86\u53e6\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u6765\u6307\u5b9a\u884c\u548c\u5217\u3002 \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ffd\u8e2a\u4e00\u4e2a GameItem \u5728\u7eb9\u7406\u96c6\u4e2d\u7684\u5750\u6807\uff0c\u56e0\u6b64\u53ea\u9700\u5411\u8be5\u7c7b\u6dfb\u52a0\u53e6\u4e00\u4e2a\u5c5e\u6027\uff0c\u9ed8\u8ba4\u503c\u4e3a0\u3002 package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { // \u66f4\u591a\u5c5e\u6027\u7701\u7565 private int textPos; \u7136\u540e\u6211\u4eec\u4fee\u6539 Particle \u7c7b\uff0c\u4ee5\u4fbf\u80fd\u591f\u901a\u8fc7\u7eb9\u7406\u96c6\u81ea\u52a8\u8fed\u4ee3\u3002 package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private long updateTextureMillis; private long currentAnimTimeMillis; \u5c5e\u6027 updateTextureMillis \u5b9a\u4e49\u79fb\u52a8\u5230\u7eb9\u7406\u96c6\u4e2d\u4e0b\u4e00\u4e2a\u5750\u6807\u7684\u65f6\u95f4\uff08\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d\uff09\u3002\u6570\u503c\u6708\u5e95\uff0c\u7c92\u5b50\u5728\u7eb9\u7406\u4e0a\u53d8\u5316\u7684\u901f\u5ea6\u5c31\u8d8a\u5feb\u3002\u5c5e\u6027 currentAnimTimeMillis \u53ea\u662f\u8ddf\u8e2a\u7eb9\u7406\u6301\u7eed\u5f53\u524d\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Particle \u7c7b\u6784\u9020\u51fd\u6570\u6765\u8bbe\u7f6e\u8fd9\u4e9b\u503c\u3002\u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u7eb9\u7406\u96c6\u7684\u7247\u6bb5\u6570\u91cf\uff0c\u5b83\u662f\u7531\u5c5e\u6027 animFrames \u5b9a\u4e49\u7684\u3002 public Particle(Mesh mesh, Vector3f speed, long ttl, long updateTextureMillis) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; this.updateTextureMills = updateTextureMills; this.currentAnimTimeMillis = 0; Texture texture = this.getMesh().getMaterial().getTexture(); this.animFrames = texture.getNumCols() * texture.getNumRows(); } \u73b0\u5728\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u68c0\u67e5\u7c92\u5b50\u662f\u5426\u5df2\u7ecf\u8fc7\u671f\u7684\u65b9\u6cd5\uff0c\u6765\u68c0\u67e5\u662f\u5426\u9700\u8981\u66f4\u65b0\u7eb9\u7406\u5750\u6807\u3002 public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; this.currentAnimTimeMillis += elapsedTime; if ( this.currentAnimTimeMillis >= this.getUpdateTextureMillis() && this.animFrames > 0 ) { this.currentAnimTimeMillis = 0; int pos = this.getTextPos(); pos++; if ( pos < this.animFrames ) { this.setTextPos(pos); } else { this.setTextPos(0); } } return this.ttl; } \u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 FlowRangeEmitter \u7c7b\uff0c\u5728\u5e94\u8be5\u6539\u53d8\u7c92\u5b50\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u5468\u671f\u4e0a\u589e\u52a0\u4e86\u4e00\u4e9b\u968f\u673a\u6027\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e9b\u6570\u636e\u6765\u8bbe\u7f6e\u5408\u9002\u7684\u7eb9\u7406\u5750\u6807\u3002\u6211\u4eec\u5c06\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u8fdb\u884c\u8fd9\u4e00\u64cd\u4f5c\uff0c\u56e0\u4e3a\u5b83\u8f93\u51fa\u4e86\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u90a3\u4e9b\u503c\u3002\u8fd9\u4e2a\u65b0\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform float texXOffset; uniform float texYOffset; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texXOffset); float y = (texCoord.y / numRows + texYOffset); outTexCoord = vec2(x, y); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u73b0\u5728\u6709\u4e09\u4e2a\u65b0Uniform\u3002Uniform numCols \u548c numRows \u53ea\u50a8\u5b58\u7eb9\u7406\u96c6\u7684\u5217\u548c\u884c\u6570\u3002\u4e3a\u4e86\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\uff0c\u9996\u5148\u5fc5\u987b\u7f29\u5c0f\u8fd9\u4e9b\u53c2\u6570\u3002\u6bcf\u4e2a\u7247\u6bb5\u7684\u5bbd\u5ea6\u4e3a 1 / numCols \uff0c\u9ad8\u5ea6\u4e3a 1 / numRows \uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u884c\u548c\u5217\u5e94\u7528\u548c\u504f\u79fb\uff0c\u8fd9\u662f\u7531 texXOffset \u548c texYOffset Uniform\u5b9a\u4e49\u7684\u3002 \u6211\u4eec\u5c06\u5728 Renderer \u7c7b\u4e2d\u8ba1\u7b97\u8fd9\u4e9b\u504f\u79fb\u91cf\uff0c\u5982\u4e0b\u8ff0\u4ee3\u7801\u6240\u793a\u3002\u6211\u4eec\u6839\u636e\u6bcf\u4e2a\u7c92\u5b50\u7684\u5750\u6807\u8ba1\u7b97\u5b83\u4eec\u6240\u5904\u7684\u884c\u548c\u5217\uff0c\u5e76\u5c06\u504f\u79fb\u91cf\u8ba1\u7b97\u4e3a\u7247\u6bb5\u9ad8\u5ea6\u548c\u5bbd\u5ea6\u7684\u500d\u6570\u3002 mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { int col = gameItem.getTextPos() % text.getNumCols(); int row = gameItem.getTextPos() / text.getNumCols(); float textXOffset = (float) col / text.getNumCols(); float textYOffset = (float) row / text.getNumRows(); particlesShaderProgram.setUniform(\"texXOffset\", textXOffset); particlesShaderProgram.setUniform(\"texYOffset\", textYOffset); \u6ce8\u610f\uff0c\u5982\u679c\u4f60\u53ea\u9700\u8981\u652f\u6301\u6b63\u65b9\u5f62\u7eb9\u7406\u96c6\uff0c\u4f60\u53ea\u9700\u8981\u4e24\u4e2aUniform\u3002\u6700\u7ec8\u7684\u6548\u679c\u662f\u8fd9\u6837\u7684\uff1a \u73b0\u5728\uff0c\u6211\u4eec\u6709\u4e86\u7c92\u5b50\u52a8\u753b\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4f18\u5316\u6e32\u67d3\u6d41\u7a0b\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u5177\u6709\u76f8\u540c\u7f51\u683c\u7684\u591a\u4e2a\u5143\u7d20\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u5143\u7d20\u8fdb\u884c\u7ed8\u5236\u8c03\u7528\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u5728\u5355\u4e2a\u8c03\u7528\u4e2d\u6e32\u67d3\u5b83\u4eec\u3002\u8fd9\u79cd\u6280\u672f\u4e0d\u4ec5\u9002\u7528\u4e8e\u7c92\u5b50\uff0c\u4e5f\u9002\u7528\u4e8e\u6e32\u67d3\u5171\u4eab\u540c\u4e00\u6a21\u578b\uff0c\u4f46\u88ab\u653e\u5728\u4e0d\u540c\u4f4d\u7f6e\u6216\u5177\u6709\u4e0d\u540c\u7eb9\u7406\u7684\u591a\u4e2a\u5143\u7d20\u7684\u573a\u666f\u3002","title":"\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09"},{"location":"21-instanced-rendering/","text":"\u5b9e\u4f8b\u5316\u6e32\u67d3\uff08Instanced Rendering\uff09 \u5f88\u591a\u5b9e\u4f8b \u5728\u7ed8\u5236\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u7ecf\u5e38\u4f1a\u6709\u8bb8\u591a\u6a21\u578b\u7528\u76f8\u540c\u7684\u7f51\u683c\u8868\u793a\uff0c\u4f46\u5b83\u4eec\u5177\u6709\u4e0d\u540c\u7684\u53d8\u6362\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5c3d\u7ba1\u5b83\u4eec\u53ef\u80fd\u662f\u53ea\u6709\u51e0\u4e2a\u4e09\u89d2\u5f62\u7684\u7b80\u5355\u7269\u4f53\uff0c\u4f46\u6027\u80fd\u4ecd\u53ef\u80fd\u4f1a\u53d7\u5230\u5f71\u54cd\uff0c\u8fd9\u80cc\u540e\u7684\u539f\u56e0\u5c31\u662f\u6211\u4eec\u6e32\u67d3\u5b83\u4eec\u7684\u65b9\u5f0f\u3002 \u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5faa\u73af\u4e2d\u904d\u5386\u6240\u6709\u6e38\u620f\u9879\uff0c\u5e76\u5bf9\u51fd\u6570 glDrawElements \u8fdb\u884c\u8c03\u7528\u3002\u5982\u524d\u51e0\u7ae0\u6240\u8bf4\u7684\uff0c\u5bf9OpenGL\u5e93\u7684\u8c03\u7528\u5e94\u8be5\u6700\u5c0f\u5316\u3002\u5bf9\u51fd\u6570 glDrawElements \u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u9020\u6210\u4e00\u5b9a\u5f00\u9500\u3002\u8fd9\u5bf9\u4e8e\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u4f1a\u53cd\u590d\u4ea7\u751f\u5f00\u9500\u3002 \u5728\u5904\u7406\u5927\u91cf\u76f8\u4f3c\u7269\u4f53\u65f6\uff0c\u4f7f\u7528\u4e00\u6b21\u8c03\u7528\u6e32\u67d3\u6240\u6709\u8fd9\u4e9b\u7269\u4f53\u4f1a\u66f4\u6709\u6548\u3002\u8fd9\u79cd\u6280\u672f\u88ab\u79f0\u4e3a\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u4e3a\u4e86\u5b9e\u73b0\u540c\u65f6\u6e32\u67d3\u4e00\u7ec4\u5143\u7d20\uff0cOpenGL\u63d0\u4f9b\u4e86\u4e00\u7ec4\u540d\u4e3a glDrawXXXInstanced \u7684\u51fd\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u6b63\u5728\u7ed8\u5236\u5143\u7d20\uff0c\u6240\u4ee5\u5c06\u4f7f\u7528\u540d\u4e3a glDrawElementsInstanced \u7684\u51fd\u6570\u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e0e glDrawElements \u76f8\u540c\u7684\u53c2\u6570\uff0c\u5916\u52a0\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6e\u8981\u7ed8\u5236\u7684\u5b9e\u4f8b\u6570\u3002 \u8fd9\u662f\u4e00\u4e2a\u5982\u4f55\u4f7f\u7528 glDrawElements \u7684\u793a\u4f8b\uff1a glDrawElements(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0) \u4ee5\u4e0b\u662f\u5b9e\u4f8b\u5316\u7248\u672c\u7684\u7528\u6cd5: glDrawElementsInstanced(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0, numInstances); \u4f46\u662f\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\uff0c\u5982\u4f55\u4e3a\u6bcf\u4e2a\u5b9e\u4f8b\u8bbe\u7f6e\u4e0d\u540c\u7684\u53d8\u6362\u3002\u73b0\u5728\uff0c\u5728\u7ed8\u5236\u6bcf\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Uniform\u6765\u4f20\u9012\u4e0d\u540c\u7684\u53d8\u6362\u548c\u5b9e\u4f8b\u76f8\u5173\u7684\u6570\u636e\u3002\u5728\u8fdb\u884c\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u9879\u8bbe\u7f6e\u7279\u5b9a\u7684\u6570\u636e\u3002\u5f53\u5b83\u4eec\u5f00\u59cb\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u5982\u4f55\u505a\u5230\u8fd9\u4e00\u70b9\u5462\uff1f \u5f53\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\uff0c\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e2a\u8f93\u5165\u53d8\u91cf\u6765\u50a8\u5b58\u5f53\u524d\u7ed8\u5236\u5b9e\u4f8b\u7684\u7d22\u5f15\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u8fd9\u4e2a\u5185\u7f6e\u53d8\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u4f20\u9012\u4e00\u4e2a\u5305\u542b\u8981\u5e94\u7528\u5230\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u53d8\u6362\u7684Uniform\u6570\u7ec4\uff0c\u5e76\u4ec5\u505a\u4e00\u6b21\u6e32\u67d3\u8c03\u7528\u3002 \u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u5b83\u4ecd\u7136\u4f1a\u5e26\u6765\u592a\u591a\u7684\u5f00\u9500\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u80fd\u591f\u4f20\u9012\u7684Uniform\u6570\u91cf\u662f\u6709\u9650\u7684\u3002\u56e0\u6b64\uff0c\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u800c\u4e0d\u662f\u4f7f\u7528Uniform\u6570\u7ec4\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u524d\u51e0\u7ae0\uff0c\u6bcf\u4e2a\u7f51\u683c\u7684\u6570\u636e\u90fd\u662f\u7531\u4e00\u7ec4\u540d\u4e3aVBO\u7684\u6570\u636e\u6570\u7ec4\u5b9a\u4e49\u7684\u3002\u8fd9\u4e9bVBO\u4e2d\u7684\u6570\u636e\u50a8\u5b58\u5728\u6bcf\u4e2a\u552f\u4e00\u7684 Mesh \u5b9e\u4f8b\u4e2d\u3002 \u4f7f\u7528\u6807\u51c6\u7684VBO\uff0c\u5728\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u4e0e\u6bcf\u4e2a\u9876\u70b9\uff08\u5176\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\uff09\u76f8\u5173\u7684\u6570\u636e\u3002\u65e0\u8bba\u4f55\u65f6\u8fd0\u884c\u7740\u8272\u5668\uff0c\u8f93\u5165\u53d8\u91cf\u90fd\u88ab\u8bbe\u7f6e\u4e3a\u6307\u5411\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6307\u5b9a\u6570\u636e\u3002\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbe\u7f6e\u6bcf\u4e2a\u5b9e\u4f8b\u800c\u4e0d\u662f\u6bcf\u4e2a\u9876\u70b9\u6240\u66f4\u6539\u7684\u6570\u636e\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e24\u79cd\u7c7b\u578b\u7ed3\u5408\u8d77\u6765\uff0c\u5c31\u53ef\u4ee5\u4f7f\u7528\u5e38\u89c4\u7684VBO\u6765\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684\u4fe1\u606f\uff08\u5750\u6807\uff0c\u7eb9\u7406\u5750\u6807\uff09\u548c\u7528VBO\u50a8\u5b58\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u6570\u636e\uff08\u5982\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u7684\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u4e0e\u6cd5\u7ebf\u3002\u6bcf\u4e2a\u5143\u7d20\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u662f\u5b83\u6240\u5c5e\u7684\u5b9e\u4f8b\uff08\u84dd\u8272\uff09\u3002\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u8868\u793a\u5b9e\u4f8b\u4e2d\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u7f51\u683c\u4e5f\u7531\u4e24\u4e2a\u5b9e\u4f8bVBO\u5b9a\u4e49\u3002\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u4e3a\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u6e32\u67d3\u9876\u70b9\uff08\u7b2c1X\u4e2a\uff09\u65f6\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u662f\u76f8\u540c\u7684\uff08\u7b2c1\u4e2a\uff09\u3002\u5f53\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u7684\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002 \u56e0\u6b64\uff0c\u5728\u6e32\u67d3\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e00\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V11\u3001T11\u548cN11\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u5e76\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u6e32\u67d3\u540c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e8c\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V12\u3001T12\u548cN12\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u4ecd\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5728\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u4e0d\u4f1a\u4f7f\u7528MV2\u548cLV2\u3002 \u4e3a\u4e86\u5b9a\u4e49\u6bcf\u4e2a\u5b9e\u4f8b\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\u8c03\u7528\u51fd\u6570 glVertexAttribDivisor \u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e24\u4e2a\u53c2\u6570\uff1a index\uff1a\u9876\u70b9\u5c5e\u6027\u7684\u7d22\u5f15\uff08\u5728 glVertexAttribPointer \u51fd\u6570\u4e2d\u8bbe\u7f6e\u7684\uff09\u3002 divisor: \u5982\u679c\u8fd9\u4e2a\u503c\u4e3a0\uff0c\u90a3\u4e48\u5728\u6e32\u67d3\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u6570\u636e\u90fd\u4f1a\u6539\u53d8\u3002\u5982\u679c\u5c06\u5176\u8bbe\u7f6e\u4e3a1\uff0c\u5219\u6bcf\u6e32\u67d3\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u6570\u636e\u66f4\u6539\u4e00\u6b21\u3002\u5982\u679c\u5b83\u88ab\u8bbe\u7f6e\u4e3a2\uff0c\u5219\u6bcf\u6e32\u67d3\u4e24\u4e2a\u5b9e\u4f8b\u5c31\u4f1a\u66f4\u6539\u4e00\u6b21\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8bbe\u7f6e\u5b9e\u4f8b\u7684\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u6bcf\u4e2a\u5c5e\u6027\u5b9a\u4e49\u4e4b\u540e\u8fdb\u884c\u5982\u4e0b\u8c03\u7528\uff1a glVertexAttribDivisor(index, 1); \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u5e93\uff0c\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u7b2c\u4e00\u6b65\u662f\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a InstancedMesh \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u7ee7\u627f\u81ea Mesh \u7c7b\u3002\u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u7c7b\u4f3c\u4e8e Mesh \u7684\u6784\u9020\u51fd\u6570\uff0c\u4f46\u6709\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u5373\u5b9e\u4f8b\u6570\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u9664\u4e86\u4f9d\u8d56\u8d85\u7c7b\u7684\u6784\u9020\u51fd\u6570\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e24\u4e2a\u65b0\u7684VBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u521b\u5efa\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a modelViewVBO = glGenBuffers(); vboIdList.add(modelViewVBO); this.modelViewBuffer = MemoryUtil.memAllocFloat(numInstances * MATRIX_SIZE_FLOATS); glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); int start = 5; for (int i = 0; i < 4; i++) { glVertexAttribPointer(start, 4, GL_FLOAT, false, MATRIX_SIZE_BYTES, i * VECTOR4F_SIZE_BYTES); glVertexAttribDivisor(start, 1); start++; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VBO\u548c\u4e00\u4e2a\u65b0\u7684 FloatBuffer \u4ee5\u5728\u5176\u5185\u50a8\u5b58\u6570\u636e\u3002\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u662f\u7528\u6d6e\u70b9\u6570\u6570\u91cf\u8ba1\u7b97\u7684\uff0c\u6240\u4ee5\u5b83\u7b49\u4e8e\u5b9e\u4f8b\u6570\u4e58\u4ee54x4\u77e9\u9635\u7684\u6d6e\u70b9\u6570\u5927\u5c0f\uff08\u7b49\u4e8e16\uff09\u3002 \u4e00\u65e6VBO\u88ab\u7ed1\u5b9a\uff0c\u6211\u4eec\u5c31\u5f00\u59cb\u4e3a\u5b83\u5b9a\u4e49\u5c5e\u6027\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u8fd9\u662f\u5728 for \u5faa\u73af\u4e2d\u5b8c\u6210\u7684\uff0c\u5faa\u73af\u8fdb\u884c\u4e86\u56db\u6b21\u3002\u6bcf\u8f6e\u5faa\u73af\u5b9a\u4e49\u4e00\u4e2a\u77e9\u9635\u5411\u91cf\u3002\u4e3a\u4ec0\u4e48\u4e0d\u7b80\u5355\u5730\u4e3a\u6574\u4e2a\u77e9\u9635\u5b9a\u4e49\u4e00\u4e2a\u5c5e\u6027\u5462\uff1f\u539f\u56e0\u662f\u9876\u70b9\u5c5e\u6027\u4e0d\u80fd\u50a8\u5b58\u8d85\u8fc7\u56db\u4e2a\u6d6e\u70b9\u6570\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u77e9\u9635\u5b9a\u4e49\u5206\u4e3a\u56db\u90e8\u5206\u3002\u8ba9\u6211\u4eec\u91cd\u65b0\u8ba4\u8bc6\u4e00\u4e0b glVertexAttribPointer \u7684\u53c2\u6570\uff1a Index: \u8981\u5b9a\u4e49\u7684\u5143\u7d20\u7684\u7d22\u5f15\u3002 Size: \u8be5\u5c5e\u6027\u7684\u5206\u91cf\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5b83\u662f\u56db\u4e2a\u6d6e\u70b9\u6570\uff0c\u8fd9\u662f\u53ef\u63a5\u53d7\u7684\u6700\u5927\u503c\u3002 Type: \u6570\u636e\u7c7b\u578b\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u6d6e\u70b9\u578b\uff09\u3002 Normalize: \u662f\u5426\u5e94\u8be5\u5f52\u4e00\u5316\u6307\u5b9a\u6570\u636e\u3002 Stride\uff08\u6b65\u957f\uff09: \u7406\u89e3\u8fd9\u91cc\u7684\u6982\u5ff5\u5f88\u91cd\u8981\uff0c\u5b83\u8bbe\u7f6e\u4e86\u8fde\u7eed\u5c5e\u6027\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u8bbe\u7f6e\u4e3a\u6574\u4e2a\u77e9\u9635\u7684\u5b57\u8282\u5927\u5c0f\u3002\u8fd9\u5c31\u50cf\u4e00\u4e2a\u7528\u4e8e\u5305\u88c5\u6570\u636e\u7684\u6807\u8bb0\uff0c\u4ece\u800c\u53ef\u4ee5\u5728\u9876\u70b9\u6216\u5b9e\u4f8b\u4e4b\u95f4\u8fdb\u884c\u66f4\u6539\u3002 Pointer: \u6b64\u5c5e\u6027\u5b9a\u4e49\u5e94\u7528\u7684\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u77e9\u9635\u5b9a\u4e49\u62c6\u5206\u4e3a\u56db\u6b21\u8c03\u7528\u3002\u4f9d\u77e9\u9635\u7684\u6bcf\u4e2a\u5411\u91cf\u589e\u52a0\u504f\u79fb\u91cf\u3002 \u5b9a\u4e49\u4e86\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u76f8\u540c\u7684\u7d22\u5f15\u8c03\u7528 glVertexAttribDivisor \u3002 \u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684\u5b9a\u4e49\u4e0e\u4e0a\u8ff0\u8fc7\u7a0b\u7c7b\u4f3c\uff0c\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u3002\u7ee7\u7eed\u8fdb\u884c InstancedMesh \u7c7b\u7684\u5b9a\u4e49\uff0c\u91cd\u5199\u65b9\u6cd5\u4ee5\u5728\u6e32\u67d3\u4e4b\u524d\u542f\u7528\u9876\u70b9\u5c5e\u6027\uff08\u4ee5\u53ca\u5728\u6e32\u67d3\u4e4b\u540e\u8981\u7981\u7528\u5b83\u4eec\uff09\u662f\u5f88\u91cd\u8981\u7684\u3002 @Override protected void initRender() { super.initRender(); int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glEnableVertexAttribArray(start + i); } } @Override protected void endRender() { int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glDisableVertexAttribArray(start + i); } super.endRender(); } InstancedMesh \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a renderListInstanced \u7684\u516c\u5171\u65b9\u6cd5\uff0c\u5b83\u6e32\u67d3\u4e00\u7cfb\u5217\u7684\u6e38\u620f\u9879\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u6e38\u620f\u9879\u5217\u8868\u5206\u5272\u4e3a\u5927\u5c0f\u4e0e\u521b\u5efa InstancedMesh \u6240\u8bbe\u5b9e\u4f8b\u6570\u91cf\u76f8\u7b49\u7684\u5757\u3002\u771f\u6b63\u7684\u6e32\u67d3\u65b9\u6cd5\u662f renderChunkInstanced \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderChunkInstanced(List<GameItem> gameItems, boolean depthMap, Transformation transformation, Matrix4f viewMatrix, Matrix4f lightViewMatrix) { this.modelViewBuffer.clear(); this.modelLightViewBuffer.clear(); int i = 0; for (GameItem gameItem : gameItems) { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); if (!depthMap) { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.get(MATRIX_SIZE_FLOATS * i, modelViewBuffer); } Matrix4f modelLightViewMatrix = transformation.buildModelLightViewMatrix(modelMatrix, lightViewMatrix); modelLightViewMatrix.get(MATRIX_SIZE_FLOATS * i, this.modelLightViewBuffer); i++; } glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); glBufferData(GL_ARRAY_BUFFER, modelViewBuffer, GL_DYNAMIC_DRAW); glBindBuffer(GL_ARRAY_BUFFER, modelLightViewVBO); glBufferData(GL_ARRAY_BUFFER, modelLightViewBuffer, GL_DYNAMIC_DRAW); glDrawElementsInstanced(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0, gameItems.size()); glBindBuffer(GL_ARRAY_BUFFER, 0); } \u8be5\u65b9\u6cd5\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u904d\u5386\u6e38\u620f\u9879\uff0c\u8ba1\u7b97\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u8fd9\u4e9b\u77e9\u9635\u88ab\u8f6c\u50a8\u5230\u5b83\u4eec\u5404\u81ea\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u7684\u5185\u5bb9\u88ab\u53d1\u9001\u5230GPU\uff0c\u6700\u540e\u901a\u8fc7\u5bf9\u65b9\u6cd5 glDrawElementsInstanced \u7684\u8c03\u7528\u6765\u6e32\u67d3\u5b83\u4eec\u3002 \u56de\u5230\u7740\u8272\u5668\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u9996\u5148\u6211\u4eec\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6dfb\u52a0\u65b0\u7684\u8f93\u5165\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u5c06\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\u4f20\u9012\u3002 layout (location=5) in mat4 modelViewInstancedMatrix; layout (location=9) in mat4 modelLightViewInstancedMatrix; \u5982\u4f60\u6240\u89c1\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e5\u5f00\u59cb\u3002\u7531\u4e8e\u77e9\u9635\u662f\u7531\u4e00\u7ec4\u5171\u56db\u4e2a\u5c5e\u6027\uff08\u6bcf\u4e2a\u5c5e\u6027\u50a8\u5b58\u4e00\u4e2a\u5411\u91cf\uff09\u5b9a\u4e49\u7684\uff0c\u6240\u4ee5\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e9\u5f00\u59cb\u3002\u56e0\u4e3a\u6211\u4eec\u60f3\u5728\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u5b9e\u4f8b\u5316\u6e32\u67d3\u4e2d\u4f7f\u7528\u540c\u4e00\u7740\u8272\u5668\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u7ef4\u62a4\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002\u6211\u4eec\u53ea\u9700\u66f4\u6539\u5b83\u4eec\u7684\u540d\u5b57\u3002 uniform int isInstanced; uniform mat4 modelViewNonInstancedMatrix; \u2026 uniform mat4 modelLightViewNonInstancedMatrix; \u6211\u4eec\u521b\u5efa\u4e86\u53e6\u4e00\u4e2aUniform\u6765\u6307\u5b9a\u662f\u5426\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u60c5\u51b5\u4e0b\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8f93\u5165\u53c2\u6570\u4e2d\u7684\u77e9\u9635\u3002 void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelViewMatrix; mat4 lightViewMatrix; if ( isInstanced > 0 ) { modelViewMatrix = modelViewInstancedMatrix; lightViewMatrix = modelLightViewInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u6211\u4eec\u6682\u65f6\u4e0d\u652f\u6301\u52a8\u753b\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u7b80\u5316\u793a\u4f8b\uff0c\u4f46\u662f\u8be5\u6280\u672f\u53ef\u4ee5\u5b8c\u7f8e\u5730\u7528\u4e8e\u6b64\u5904\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u50cf\u5f80\u5e38\u4e00\u6837\u8bbe\u7f6e\u6070\u5f53\u7684\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * lightViewMatrix * initPos; outModelViewMatrix = modelViewMatrix; } \u5f53\u7136\uff0c Renderer \u7c7b\u5df2\u7ecf\u88ab\u4fee\u6539\uff0c\u4ee5\u652f\u6301Uniform\u7684\u4fee\u6539\uff0c\u5e76\u5c06\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u7684\u6e32\u67d3\u4ece\u5b9e\u4f8b\u5316\u7f51\u683c\u4e2d\u5206\u79bb\u51fa\u6765\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u4fee\u6539\u3002 \u6b64\u5916\uff0cJOML\u7684\u4f5c\u8005 Kai Burjack \u8fd8\u5411\u6e90\u4ee3\u7801\u6dfb\u52a0\u4e86\u4e00\u4e9b\u4f18\u5316\u3002\u8fd9\u4e9b\u4f18\u5316\u5df2\u7ecf\u7528\u4e8e Transformation \u7c7b\uff0c\u5e76\u603b\u7ed3\u4e3a\u5982\u4e0b\u51e0\u6761\uff1a \u5220\u9664\u5197\u4f59\u8c03\u7528\uff0c\u4ee5\u8bbe\u7f6e\u5177\u6709\u5355\u4f4d\u503c\u7684\u77e9\u9635\u3002 \u4f7f\u7528\u56db\u5143\u6570\u8fdb\u884c\u66f4\u6709\u6548\u7684\u65cb\u8f6c\u3002 \u4f7f\u7528\u7279\u5b9a\u7684\u65cb\u8f6c\u548c\u5e73\u79fb\u77e9\u9635\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e9b\u65b9\u6cd5\u662f\u9488\u5bf9\u8fd9\u4e9b\u64cd\u4f5c\u4f18\u5316\u7684\u3002 \u56de\u987e\u7c92\u5b50 \u5728\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u652f\u6301\u4e0b\uff0c\u6211\u4eec\u8fd8\u53ef\u4ee5\u63d0\u9ad8\u7c92\u5b50\u6e32\u67d3\u7684\u6027\u80fd\u3002\u7c92\u5b50\u5c31\u662f\u6700\u597d\u7684\u7528\u4f8b\u3002 \u4e3a\u4e86\u5c06\u5b9e\u4f8b\u5316\u6e32\u67d3\u5e94\u7528\u5230\u7c92\u5b50\u4e0a\u6211\u4eec\u5fc5\u987b\u63d0\u4f9b\u5bf9\u7eb9\u7406\u96c6\u7684\u652f\u6301\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u5e26\u6709\u7eb9\u7406\u504f\u79fb\u91cf\u7684VBO\u6765\u5b9e\u73b0\u3002\u7eb9\u7406\u504f\u79fb\u91cf\u53ef\u4ee5\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u7684\u5355\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u50cf\u77e9\u9635\u90a3\u6837\u62c6\u5206\u5b9a\u4e49\u3002 // \u7eb9\u7406\u504f\u79fb\u91cf glVertexAttribPointer(start, 2, GL_FLOAT, false, INSTANCE_SIZE_BYTES, strideStart); glVertexAttribDivisor(start, 1); \u4f46\u662f\uff0c\u6211\u4eec\u5c06\u5728\u5355\u4e2aVBO\u4e2d\u8bbe\u7f6e\u6240\u6709\u5b9e\u4f8b\u5c5e\u6027\uff0c\u800c\u4e0d\u662f\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684VBO\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8fd9\u4e2a\u6982\u5ff5\u3002\u6211\u4eec\u5c06\u6240\u6709\u5c5e\u6027\u6253\u5305\u5728\u4e00\u4e2aVBO\u4e2d\uff0c\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u503c\u90fd\u4f1a\u53d1\u751f\u53d8\u5316\u3002 \u4e3a\u4e86\u4f7f\u7528\u5355\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5b9e\u4f8b\u4e2d\u6240\u6709\u5c5e\u6027\u7684\u5c5e\u6027\u5927\u5c0f\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u53ef\u4ee5\u770b\u5230\uff0c\u7eb9\u7406\u504f\u79fb\u91cf\u7684\u5b9a\u4e49\u4f7f\u7528\u4e86\u4e00\u4e2a\u540d\u4e3a INSTANCE_SIZE_BYTES \u7684\u5e38\u91cf\u3002\u8fd9\u4e2a\u5e38\u91cf\u7b49\u4e8e\u4e24\u4e2a\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff09\u7684\u5b57\u8282\u5927\u5c0f\u518d\u52a0\u4e0a\u4e24\u4e2a\u6d6e\u70b9\u6570\uff08\u7eb9\u7406\u504f\u79fb\u91cf\uff09\u7684\u5b57\u8282\u5927\u5c0f\uff0c\u603b\u5171\u662f136\u3002\u6b65\u957f\u4e5f\u9700\u8981\u9002\u5f53\u5730\u8c03\u6574\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u4fee\u6539\u3002 Renderer \u7c7b\u4e5f\u9700\u8981\u4fee\u6539\uff0c\u4ee5\u5b9e\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7c92\u5b50\u548c\u652f\u6301\u7eb9\u7406\u96c6\u5728\u573a\u666f\u4e2d\u6e32\u67d3\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u652f\u6301\u8fd9\u4e24\u79cd\u7c7b\u578b\uff08\u975e\u5b9e\u4f8b\u5316\u548c\u5b9e\u4f8b\u5316\uff09\u7684\u6e32\u67d3\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6240\u4ee5\u4fee\u6539\u66f4\u7b80\u5355\u3002 \u7c92\u5b50\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=5) in mat4 modelViewMatrix; layout (location=13) in vec2 texOffset; out vec2 outTexCoord; uniform mat4 projectionMatrix; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // \u652f\u6301\u7eb9\u7406\u96c6\uff0c\u66f4\u65b0\u7eb9\u7406\u5750\u6807 float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); outTexCoord = vec2(x, y);} \u4e0a\u8ff0\u4fee\u6539\u7684\u6548\u679c\uff0c\u770b\u8d77\u6765\u548c\u975e\u5b9e\u4f8b\u5316\u7c92\u5b50\u6e32\u67d3\u65f6\u5b8c\u5168\u4e00\u6837\uff0c\u4f46\u6027\u80fd\u66f4\u9ad8\u3002FPS\u8ba1\u6570\u5668\u5df2\u4f5c\u4e3a\u9009\u9879\u6dfb\u52a0\u5230\u7a97\u53e3\u6807\u9898\u4e2d\u3002\u4f60\u53ef\u4ee5\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u6765\u770b\u770b\u81ea\u8eab\u7684\u6027\u80fd\u63d0\u5347\u3002 \u6269\u5c55 \u7ed3\u5408\u6211\u4eec\u73b0\u5728\u6240\u62e5\u6709\u7684\u6240\u6709\u57fa\u7840\u6784\u9020\uff0c\u6211\u5df2\u7ecf\u57fa\u4e8e\u4f7f\u7528\u9ad8\u5ea6\u56fe\u4fee\u6539\u4e86\u6e32\u67d3\u65b9\u5757\u6570\u636e\u7684\u4ee3\u7801\uff0c\u8fd8\u4f7f\u7528\u4e86\u7eb9\u7406\u96c6\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u5b83\u8fd8\u878d\u5408\u4e86\u7c92\u5b50\u6e32\u67d3\u3002\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a \u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u8fd8\u6709\u5f88\u5927\u7684\u4f18\u5316\u7a7a\u95f4\uff0c\u4f46\u8fd9\u672c\u4e66\u7684\u76ee\u7684\u662f\u6307\u5bfc\u4f60\u5b66\u4e60LWJGL\u548cOpenGL\u7684\u6982\u5ff5\u548c\u6280\u672f\u3002\u6211\u4eec\u7684\u76ee\u6807\u4e0d\u662f\u521b\u5efa\u4e00\u4e2a\u5b8c\u6574\u7684\u6e38\u620f\u5f15\u64ce\uff08\u7edd\u5bf9\u4e0d\u662f\u4e00\u4e2a\u4f53\u7d20\u5f15\u64ce\uff0c\u5b83\u9700\u8981\u4e0d\u540c\u7684\u65b9\u6cd5\u548c\u66f4\u591a\u7684\u4f18\u5316\uff09\u3002","title":"\u5b9e\u4f8b\u5316\u6e32\u67d3"},{"location":"21-instanced-rendering/#instanced-rendering","text":"","title":"\u5b9e\u4f8b\u5316\u6e32\u67d3\uff08Instanced Rendering\uff09"},{"location":"21-instanced-rendering/#_1","text":"\u5728\u7ed8\u5236\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u7ecf\u5e38\u4f1a\u6709\u8bb8\u591a\u6a21\u578b\u7528\u76f8\u540c\u7684\u7f51\u683c\u8868\u793a\uff0c\u4f46\u5b83\u4eec\u5177\u6709\u4e0d\u540c\u7684\u53d8\u6362\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5c3d\u7ba1\u5b83\u4eec\u53ef\u80fd\u662f\u53ea\u6709\u51e0\u4e2a\u4e09\u89d2\u5f62\u7684\u7b80\u5355\u7269\u4f53\uff0c\u4f46\u6027\u80fd\u4ecd\u53ef\u80fd\u4f1a\u53d7\u5230\u5f71\u54cd\uff0c\u8fd9\u80cc\u540e\u7684\u539f\u56e0\u5c31\u662f\u6211\u4eec\u6e32\u67d3\u5b83\u4eec\u7684\u65b9\u5f0f\u3002 \u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5faa\u73af\u4e2d\u904d\u5386\u6240\u6709\u6e38\u620f\u9879\uff0c\u5e76\u5bf9\u51fd\u6570 glDrawElements \u8fdb\u884c\u8c03\u7528\u3002\u5982\u524d\u51e0\u7ae0\u6240\u8bf4\u7684\uff0c\u5bf9OpenGL\u5e93\u7684\u8c03\u7528\u5e94\u8be5\u6700\u5c0f\u5316\u3002\u5bf9\u51fd\u6570 glDrawElements \u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u9020\u6210\u4e00\u5b9a\u5f00\u9500\u3002\u8fd9\u5bf9\u4e8e\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u4f1a\u53cd\u590d\u4ea7\u751f\u5f00\u9500\u3002 \u5728\u5904\u7406\u5927\u91cf\u76f8\u4f3c\u7269\u4f53\u65f6\uff0c\u4f7f\u7528\u4e00\u6b21\u8c03\u7528\u6e32\u67d3\u6240\u6709\u8fd9\u4e9b\u7269\u4f53\u4f1a\u66f4\u6709\u6548\u3002\u8fd9\u79cd\u6280\u672f\u88ab\u79f0\u4e3a\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u4e3a\u4e86\u5b9e\u73b0\u540c\u65f6\u6e32\u67d3\u4e00\u7ec4\u5143\u7d20\uff0cOpenGL\u63d0\u4f9b\u4e86\u4e00\u7ec4\u540d\u4e3a glDrawXXXInstanced \u7684\u51fd\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u6b63\u5728\u7ed8\u5236\u5143\u7d20\uff0c\u6240\u4ee5\u5c06\u4f7f\u7528\u540d\u4e3a glDrawElementsInstanced \u7684\u51fd\u6570\u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e0e glDrawElements \u76f8\u540c\u7684\u53c2\u6570\uff0c\u5916\u52a0\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6e\u8981\u7ed8\u5236\u7684\u5b9e\u4f8b\u6570\u3002 \u8fd9\u662f\u4e00\u4e2a\u5982\u4f55\u4f7f\u7528 glDrawElements \u7684\u793a\u4f8b\uff1a glDrawElements(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0) \u4ee5\u4e0b\u662f\u5b9e\u4f8b\u5316\u7248\u672c\u7684\u7528\u6cd5: glDrawElementsInstanced(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0, numInstances); \u4f46\u662f\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\uff0c\u5982\u4f55\u4e3a\u6bcf\u4e2a\u5b9e\u4f8b\u8bbe\u7f6e\u4e0d\u540c\u7684\u53d8\u6362\u3002\u73b0\u5728\uff0c\u5728\u7ed8\u5236\u6bcf\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Uniform\u6765\u4f20\u9012\u4e0d\u540c\u7684\u53d8\u6362\u548c\u5b9e\u4f8b\u76f8\u5173\u7684\u6570\u636e\u3002\u5728\u8fdb\u884c\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u9879\u8bbe\u7f6e\u7279\u5b9a\u7684\u6570\u636e\u3002\u5f53\u5b83\u4eec\u5f00\u59cb\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u5982\u4f55\u505a\u5230\u8fd9\u4e00\u70b9\u5462\uff1f \u5f53\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\uff0c\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e2a\u8f93\u5165\u53d8\u91cf\u6765\u50a8\u5b58\u5f53\u524d\u7ed8\u5236\u5b9e\u4f8b\u7684\u7d22\u5f15\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u8fd9\u4e2a\u5185\u7f6e\u53d8\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u4f20\u9012\u4e00\u4e2a\u5305\u542b\u8981\u5e94\u7528\u5230\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u53d8\u6362\u7684Uniform\u6570\u7ec4\uff0c\u5e76\u4ec5\u505a\u4e00\u6b21\u6e32\u67d3\u8c03\u7528\u3002 \u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u5b83\u4ecd\u7136\u4f1a\u5e26\u6765\u592a\u591a\u7684\u5f00\u9500\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u80fd\u591f\u4f20\u9012\u7684Uniform\u6570\u91cf\u662f\u6709\u9650\u7684\u3002\u56e0\u6b64\uff0c\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u800c\u4e0d\u662f\u4f7f\u7528Uniform\u6570\u7ec4\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u524d\u51e0\u7ae0\uff0c\u6bcf\u4e2a\u7f51\u683c\u7684\u6570\u636e\u90fd\u662f\u7531\u4e00\u7ec4\u540d\u4e3aVBO\u7684\u6570\u636e\u6570\u7ec4\u5b9a\u4e49\u7684\u3002\u8fd9\u4e9bVBO\u4e2d\u7684\u6570\u636e\u50a8\u5b58\u5728\u6bcf\u4e2a\u552f\u4e00\u7684 Mesh \u5b9e\u4f8b\u4e2d\u3002 \u4f7f\u7528\u6807\u51c6\u7684VBO\uff0c\u5728\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u4e0e\u6bcf\u4e2a\u9876\u70b9\uff08\u5176\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\uff09\u76f8\u5173\u7684\u6570\u636e\u3002\u65e0\u8bba\u4f55\u65f6\u8fd0\u884c\u7740\u8272\u5668\uff0c\u8f93\u5165\u53d8\u91cf\u90fd\u88ab\u8bbe\u7f6e\u4e3a\u6307\u5411\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6307\u5b9a\u6570\u636e\u3002\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbe\u7f6e\u6bcf\u4e2a\u5b9e\u4f8b\u800c\u4e0d\u662f\u6bcf\u4e2a\u9876\u70b9\u6240\u66f4\u6539\u7684\u6570\u636e\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e24\u79cd\u7c7b\u578b\u7ed3\u5408\u8d77\u6765\uff0c\u5c31\u53ef\u4ee5\u4f7f\u7528\u5e38\u89c4\u7684VBO\u6765\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684\u4fe1\u606f\uff08\u5750\u6807\uff0c\u7eb9\u7406\u5750\u6807\uff09\u548c\u7528VBO\u50a8\u5b58\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u6570\u636e\uff08\u5982\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u7684\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u4e0e\u6cd5\u7ebf\u3002\u6bcf\u4e2a\u5143\u7d20\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u662f\u5b83\u6240\u5c5e\u7684\u5b9e\u4f8b\uff08\u84dd\u8272\uff09\u3002\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u8868\u793a\u5b9e\u4f8b\u4e2d\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u7f51\u683c\u4e5f\u7531\u4e24\u4e2a\u5b9e\u4f8bVBO\u5b9a\u4e49\u3002\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u4e3a\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u6e32\u67d3\u9876\u70b9\uff08\u7b2c1X\u4e2a\uff09\u65f6\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u662f\u76f8\u540c\u7684\uff08\u7b2c1\u4e2a\uff09\u3002\u5f53\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u7684\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002 \u56e0\u6b64\uff0c\u5728\u6e32\u67d3\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e00\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V11\u3001T11\u548cN11\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u5e76\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u6e32\u67d3\u540c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e8c\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V12\u3001T12\u548cN12\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u4ecd\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5728\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u4e0d\u4f1a\u4f7f\u7528MV2\u548cLV2\u3002 \u4e3a\u4e86\u5b9a\u4e49\u6bcf\u4e2a\u5b9e\u4f8b\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\u8c03\u7528\u51fd\u6570 glVertexAttribDivisor \u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e24\u4e2a\u53c2\u6570\uff1a index\uff1a\u9876\u70b9\u5c5e\u6027\u7684\u7d22\u5f15\uff08\u5728 glVertexAttribPointer \u51fd\u6570\u4e2d\u8bbe\u7f6e\u7684\uff09\u3002 divisor: \u5982\u679c\u8fd9\u4e2a\u503c\u4e3a0\uff0c\u90a3\u4e48\u5728\u6e32\u67d3\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u6570\u636e\u90fd\u4f1a\u6539\u53d8\u3002\u5982\u679c\u5c06\u5176\u8bbe\u7f6e\u4e3a1\uff0c\u5219\u6bcf\u6e32\u67d3\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u6570\u636e\u66f4\u6539\u4e00\u6b21\u3002\u5982\u679c\u5b83\u88ab\u8bbe\u7f6e\u4e3a2\uff0c\u5219\u6bcf\u6e32\u67d3\u4e24\u4e2a\u5b9e\u4f8b\u5c31\u4f1a\u66f4\u6539\u4e00\u6b21\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8bbe\u7f6e\u5b9e\u4f8b\u7684\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u6bcf\u4e2a\u5c5e\u6027\u5b9a\u4e49\u4e4b\u540e\u8fdb\u884c\u5982\u4e0b\u8c03\u7528\uff1a glVertexAttribDivisor(index, 1); \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u5e93\uff0c\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u7b2c\u4e00\u6b65\u662f\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a InstancedMesh \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u7ee7\u627f\u81ea Mesh \u7c7b\u3002\u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u7c7b\u4f3c\u4e8e Mesh \u7684\u6784\u9020\u51fd\u6570\uff0c\u4f46\u6709\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u5373\u5b9e\u4f8b\u6570\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u9664\u4e86\u4f9d\u8d56\u8d85\u7c7b\u7684\u6784\u9020\u51fd\u6570\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e24\u4e2a\u65b0\u7684VBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u521b\u5efa\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a modelViewVBO = glGenBuffers(); vboIdList.add(modelViewVBO); this.modelViewBuffer = MemoryUtil.memAllocFloat(numInstances * MATRIX_SIZE_FLOATS); glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); int start = 5; for (int i = 0; i < 4; i++) { glVertexAttribPointer(start, 4, GL_FLOAT, false, MATRIX_SIZE_BYTES, i * VECTOR4F_SIZE_BYTES); glVertexAttribDivisor(start, 1); start++; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VBO\u548c\u4e00\u4e2a\u65b0\u7684 FloatBuffer \u4ee5\u5728\u5176\u5185\u50a8\u5b58\u6570\u636e\u3002\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u662f\u7528\u6d6e\u70b9\u6570\u6570\u91cf\u8ba1\u7b97\u7684\uff0c\u6240\u4ee5\u5b83\u7b49\u4e8e\u5b9e\u4f8b\u6570\u4e58\u4ee54x4\u77e9\u9635\u7684\u6d6e\u70b9\u6570\u5927\u5c0f\uff08\u7b49\u4e8e16\uff09\u3002 \u4e00\u65e6VBO\u88ab\u7ed1\u5b9a\uff0c\u6211\u4eec\u5c31\u5f00\u59cb\u4e3a\u5b83\u5b9a\u4e49\u5c5e\u6027\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u8fd9\u662f\u5728 for \u5faa\u73af\u4e2d\u5b8c\u6210\u7684\uff0c\u5faa\u73af\u8fdb\u884c\u4e86\u56db\u6b21\u3002\u6bcf\u8f6e\u5faa\u73af\u5b9a\u4e49\u4e00\u4e2a\u77e9\u9635\u5411\u91cf\u3002\u4e3a\u4ec0\u4e48\u4e0d\u7b80\u5355\u5730\u4e3a\u6574\u4e2a\u77e9\u9635\u5b9a\u4e49\u4e00\u4e2a\u5c5e\u6027\u5462\uff1f\u539f\u56e0\u662f\u9876\u70b9\u5c5e\u6027\u4e0d\u80fd\u50a8\u5b58\u8d85\u8fc7\u56db\u4e2a\u6d6e\u70b9\u6570\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u77e9\u9635\u5b9a\u4e49\u5206\u4e3a\u56db\u90e8\u5206\u3002\u8ba9\u6211\u4eec\u91cd\u65b0\u8ba4\u8bc6\u4e00\u4e0b glVertexAttribPointer \u7684\u53c2\u6570\uff1a Index: \u8981\u5b9a\u4e49\u7684\u5143\u7d20\u7684\u7d22\u5f15\u3002 Size: \u8be5\u5c5e\u6027\u7684\u5206\u91cf\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5b83\u662f\u56db\u4e2a\u6d6e\u70b9\u6570\uff0c\u8fd9\u662f\u53ef\u63a5\u53d7\u7684\u6700\u5927\u503c\u3002 Type: \u6570\u636e\u7c7b\u578b\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u6d6e\u70b9\u578b\uff09\u3002 Normalize: \u662f\u5426\u5e94\u8be5\u5f52\u4e00\u5316\u6307\u5b9a\u6570\u636e\u3002 Stride\uff08\u6b65\u957f\uff09: \u7406\u89e3\u8fd9\u91cc\u7684\u6982\u5ff5\u5f88\u91cd\u8981\uff0c\u5b83\u8bbe\u7f6e\u4e86\u8fde\u7eed\u5c5e\u6027\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u8bbe\u7f6e\u4e3a\u6574\u4e2a\u77e9\u9635\u7684\u5b57\u8282\u5927\u5c0f\u3002\u8fd9\u5c31\u50cf\u4e00\u4e2a\u7528\u4e8e\u5305\u88c5\u6570\u636e\u7684\u6807\u8bb0\uff0c\u4ece\u800c\u53ef\u4ee5\u5728\u9876\u70b9\u6216\u5b9e\u4f8b\u4e4b\u95f4\u8fdb\u884c\u66f4\u6539\u3002 Pointer: \u6b64\u5c5e\u6027\u5b9a\u4e49\u5e94\u7528\u7684\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u77e9\u9635\u5b9a\u4e49\u62c6\u5206\u4e3a\u56db\u6b21\u8c03\u7528\u3002\u4f9d\u77e9\u9635\u7684\u6bcf\u4e2a\u5411\u91cf\u589e\u52a0\u504f\u79fb\u91cf\u3002 \u5b9a\u4e49\u4e86\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u76f8\u540c\u7684\u7d22\u5f15\u8c03\u7528 glVertexAttribDivisor \u3002 \u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684\u5b9a\u4e49\u4e0e\u4e0a\u8ff0\u8fc7\u7a0b\u7c7b\u4f3c\uff0c\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u3002\u7ee7\u7eed\u8fdb\u884c InstancedMesh \u7c7b\u7684\u5b9a\u4e49\uff0c\u91cd\u5199\u65b9\u6cd5\u4ee5\u5728\u6e32\u67d3\u4e4b\u524d\u542f\u7528\u9876\u70b9\u5c5e\u6027\uff08\u4ee5\u53ca\u5728\u6e32\u67d3\u4e4b\u540e\u8981\u7981\u7528\u5b83\u4eec\uff09\u662f\u5f88\u91cd\u8981\u7684\u3002 @Override protected void initRender() { super.initRender(); int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glEnableVertexAttribArray(start + i); } } @Override protected void endRender() { int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glDisableVertexAttribArray(start + i); } super.endRender(); } InstancedMesh \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a renderListInstanced \u7684\u516c\u5171\u65b9\u6cd5\uff0c\u5b83\u6e32\u67d3\u4e00\u7cfb\u5217\u7684\u6e38\u620f\u9879\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u6e38\u620f\u9879\u5217\u8868\u5206\u5272\u4e3a\u5927\u5c0f\u4e0e\u521b\u5efa InstancedMesh \u6240\u8bbe\u5b9e\u4f8b\u6570\u91cf\u76f8\u7b49\u7684\u5757\u3002\u771f\u6b63\u7684\u6e32\u67d3\u65b9\u6cd5\u662f renderChunkInstanced \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderChunkInstanced(List<GameItem> gameItems, boolean depthMap, Transformation transformation, Matrix4f viewMatrix, Matrix4f lightViewMatrix) { this.modelViewBuffer.clear(); this.modelLightViewBuffer.clear(); int i = 0; for (GameItem gameItem : gameItems) { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); if (!depthMap) { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.get(MATRIX_SIZE_FLOATS * i, modelViewBuffer); } Matrix4f modelLightViewMatrix = transformation.buildModelLightViewMatrix(modelMatrix, lightViewMatrix); modelLightViewMatrix.get(MATRIX_SIZE_FLOATS * i, this.modelLightViewBuffer); i++; } glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); glBufferData(GL_ARRAY_BUFFER, modelViewBuffer, GL_DYNAMIC_DRAW); glBindBuffer(GL_ARRAY_BUFFER, modelLightViewVBO); glBufferData(GL_ARRAY_BUFFER, modelLightViewBuffer, GL_DYNAMIC_DRAW); glDrawElementsInstanced(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0, gameItems.size()); glBindBuffer(GL_ARRAY_BUFFER, 0); } \u8be5\u65b9\u6cd5\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u904d\u5386\u6e38\u620f\u9879\uff0c\u8ba1\u7b97\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u8fd9\u4e9b\u77e9\u9635\u88ab\u8f6c\u50a8\u5230\u5b83\u4eec\u5404\u81ea\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u7684\u5185\u5bb9\u88ab\u53d1\u9001\u5230GPU\uff0c\u6700\u540e\u901a\u8fc7\u5bf9\u65b9\u6cd5 glDrawElementsInstanced \u7684\u8c03\u7528\u6765\u6e32\u67d3\u5b83\u4eec\u3002 \u56de\u5230\u7740\u8272\u5668\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u9996\u5148\u6211\u4eec\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6dfb\u52a0\u65b0\u7684\u8f93\u5165\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u5c06\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\u4f20\u9012\u3002 layout (location=5) in mat4 modelViewInstancedMatrix; layout (location=9) in mat4 modelLightViewInstancedMatrix; \u5982\u4f60\u6240\u89c1\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e5\u5f00\u59cb\u3002\u7531\u4e8e\u77e9\u9635\u662f\u7531\u4e00\u7ec4\u5171\u56db\u4e2a\u5c5e\u6027\uff08\u6bcf\u4e2a\u5c5e\u6027\u50a8\u5b58\u4e00\u4e2a\u5411\u91cf\uff09\u5b9a\u4e49\u7684\uff0c\u6240\u4ee5\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e9\u5f00\u59cb\u3002\u56e0\u4e3a\u6211\u4eec\u60f3\u5728\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u5b9e\u4f8b\u5316\u6e32\u67d3\u4e2d\u4f7f\u7528\u540c\u4e00\u7740\u8272\u5668\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u7ef4\u62a4\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002\u6211\u4eec\u53ea\u9700\u66f4\u6539\u5b83\u4eec\u7684\u540d\u5b57\u3002 uniform int isInstanced; uniform mat4 modelViewNonInstancedMatrix; \u2026 uniform mat4 modelLightViewNonInstancedMatrix; \u6211\u4eec\u521b\u5efa\u4e86\u53e6\u4e00\u4e2aUniform\u6765\u6307\u5b9a\u662f\u5426\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u60c5\u51b5\u4e0b\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8f93\u5165\u53c2\u6570\u4e2d\u7684\u77e9\u9635\u3002 void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelViewMatrix; mat4 lightViewMatrix; if ( isInstanced > 0 ) { modelViewMatrix = modelViewInstancedMatrix; lightViewMatrix = modelLightViewInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u6211\u4eec\u6682\u65f6\u4e0d\u652f\u6301\u52a8\u753b\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u7b80\u5316\u793a\u4f8b\uff0c\u4f46\u662f\u8be5\u6280\u672f\u53ef\u4ee5\u5b8c\u7f8e\u5730\u7528\u4e8e\u6b64\u5904\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u50cf\u5f80\u5e38\u4e00\u6837\u8bbe\u7f6e\u6070\u5f53\u7684\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * lightViewMatrix * initPos; outModelViewMatrix = modelViewMatrix; } \u5f53\u7136\uff0c Renderer \u7c7b\u5df2\u7ecf\u88ab\u4fee\u6539\uff0c\u4ee5\u652f\u6301Uniform\u7684\u4fee\u6539\uff0c\u5e76\u5c06\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u7684\u6e32\u67d3\u4ece\u5b9e\u4f8b\u5316\u7f51\u683c\u4e2d\u5206\u79bb\u51fa\u6765\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u4fee\u6539\u3002 \u6b64\u5916\uff0cJOML\u7684\u4f5c\u8005 Kai Burjack \u8fd8\u5411\u6e90\u4ee3\u7801\u6dfb\u52a0\u4e86\u4e00\u4e9b\u4f18\u5316\u3002\u8fd9\u4e9b\u4f18\u5316\u5df2\u7ecf\u7528\u4e8e Transformation \u7c7b\uff0c\u5e76\u603b\u7ed3\u4e3a\u5982\u4e0b\u51e0\u6761\uff1a \u5220\u9664\u5197\u4f59\u8c03\u7528\uff0c\u4ee5\u8bbe\u7f6e\u5177\u6709\u5355\u4f4d\u503c\u7684\u77e9\u9635\u3002 \u4f7f\u7528\u56db\u5143\u6570\u8fdb\u884c\u66f4\u6709\u6548\u7684\u65cb\u8f6c\u3002 \u4f7f\u7528\u7279\u5b9a\u7684\u65cb\u8f6c\u548c\u5e73\u79fb\u77e9\u9635\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e9b\u65b9\u6cd5\u662f\u9488\u5bf9\u8fd9\u4e9b\u64cd\u4f5c\u4f18\u5316\u7684\u3002","title":"\u5f88\u591a\u5b9e\u4f8b"},{"location":"21-instanced-rendering/#_2","text":"\u5728\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u652f\u6301\u4e0b\uff0c\u6211\u4eec\u8fd8\u53ef\u4ee5\u63d0\u9ad8\u7c92\u5b50\u6e32\u67d3\u7684\u6027\u80fd\u3002\u7c92\u5b50\u5c31\u662f\u6700\u597d\u7684\u7528\u4f8b\u3002 \u4e3a\u4e86\u5c06\u5b9e\u4f8b\u5316\u6e32\u67d3\u5e94\u7528\u5230\u7c92\u5b50\u4e0a\u6211\u4eec\u5fc5\u987b\u63d0\u4f9b\u5bf9\u7eb9\u7406\u96c6\u7684\u652f\u6301\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u5e26\u6709\u7eb9\u7406\u504f\u79fb\u91cf\u7684VBO\u6765\u5b9e\u73b0\u3002\u7eb9\u7406\u504f\u79fb\u91cf\u53ef\u4ee5\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u7684\u5355\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u50cf\u77e9\u9635\u90a3\u6837\u62c6\u5206\u5b9a\u4e49\u3002 // \u7eb9\u7406\u504f\u79fb\u91cf glVertexAttribPointer(start, 2, GL_FLOAT, false, INSTANCE_SIZE_BYTES, strideStart); glVertexAttribDivisor(start, 1); \u4f46\u662f\uff0c\u6211\u4eec\u5c06\u5728\u5355\u4e2aVBO\u4e2d\u8bbe\u7f6e\u6240\u6709\u5b9e\u4f8b\u5c5e\u6027\uff0c\u800c\u4e0d\u662f\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684VBO\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8fd9\u4e2a\u6982\u5ff5\u3002\u6211\u4eec\u5c06\u6240\u6709\u5c5e\u6027\u6253\u5305\u5728\u4e00\u4e2aVBO\u4e2d\uff0c\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u503c\u90fd\u4f1a\u53d1\u751f\u53d8\u5316\u3002 \u4e3a\u4e86\u4f7f\u7528\u5355\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5b9e\u4f8b\u4e2d\u6240\u6709\u5c5e\u6027\u7684\u5c5e\u6027\u5927\u5c0f\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u53ef\u4ee5\u770b\u5230\uff0c\u7eb9\u7406\u504f\u79fb\u91cf\u7684\u5b9a\u4e49\u4f7f\u7528\u4e86\u4e00\u4e2a\u540d\u4e3a INSTANCE_SIZE_BYTES \u7684\u5e38\u91cf\u3002\u8fd9\u4e2a\u5e38\u91cf\u7b49\u4e8e\u4e24\u4e2a\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff09\u7684\u5b57\u8282\u5927\u5c0f\u518d\u52a0\u4e0a\u4e24\u4e2a\u6d6e\u70b9\u6570\uff08\u7eb9\u7406\u504f\u79fb\u91cf\uff09\u7684\u5b57\u8282\u5927\u5c0f\uff0c\u603b\u5171\u662f136\u3002\u6b65\u957f\u4e5f\u9700\u8981\u9002\u5f53\u5730\u8c03\u6574\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u4fee\u6539\u3002 Renderer \u7c7b\u4e5f\u9700\u8981\u4fee\u6539\uff0c\u4ee5\u5b9e\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7c92\u5b50\u548c\u652f\u6301\u7eb9\u7406\u96c6\u5728\u573a\u666f\u4e2d\u6e32\u67d3\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u652f\u6301\u8fd9\u4e24\u79cd\u7c7b\u578b\uff08\u975e\u5b9e\u4f8b\u5316\u548c\u5b9e\u4f8b\u5316\uff09\u7684\u6e32\u67d3\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6240\u4ee5\u4fee\u6539\u66f4\u7b80\u5355\u3002 \u7c92\u5b50\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=5) in mat4 modelViewMatrix; layout (location=13) in vec2 texOffset; out vec2 outTexCoord; uniform mat4 projectionMatrix; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // \u652f\u6301\u7eb9\u7406\u96c6\uff0c\u66f4\u65b0\u7eb9\u7406\u5750\u6807 float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); outTexCoord = vec2(x, y);} \u4e0a\u8ff0\u4fee\u6539\u7684\u6548\u679c\uff0c\u770b\u8d77\u6765\u548c\u975e\u5b9e\u4f8b\u5316\u7c92\u5b50\u6e32\u67d3\u65f6\u5b8c\u5168\u4e00\u6837\uff0c\u4f46\u6027\u80fd\u66f4\u9ad8\u3002FPS\u8ba1\u6570\u5668\u5df2\u4f5c\u4e3a\u9009\u9879\u6dfb\u52a0\u5230\u7a97\u53e3\u6807\u9898\u4e2d\u3002\u4f60\u53ef\u4ee5\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u6765\u770b\u770b\u81ea\u8eab\u7684\u6027\u80fd\u63d0\u5347\u3002","title":"\u56de\u987e\u7c92\u5b50"},{"location":"21-instanced-rendering/#_3","text":"\u7ed3\u5408\u6211\u4eec\u73b0\u5728\u6240\u62e5\u6709\u7684\u6240\u6709\u57fa\u7840\u6784\u9020\uff0c\u6211\u5df2\u7ecf\u57fa\u4e8e\u4f7f\u7528\u9ad8\u5ea6\u56fe\u4fee\u6539\u4e86\u6e32\u67d3\u65b9\u5757\u6570\u636e\u7684\u4ee3\u7801\uff0c\u8fd8\u4f7f\u7528\u4e86\u7eb9\u7406\u96c6\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u5b83\u8fd8\u878d\u5408\u4e86\u7c92\u5b50\u6e32\u67d3\u3002\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a \u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u8fd8\u6709\u5f88\u5927\u7684\u4f18\u5316\u7a7a\u95f4\uff0c\u4f46\u8fd9\u672c\u4e66\u7684\u76ee\u7684\u662f\u6307\u5bfc\u4f60\u5b66\u4e60LWJGL\u548cOpenGL\u7684\u6982\u5ff5\u548c\u6280\u672f\u3002\u6211\u4eec\u7684\u76ee\u6807\u4e0d\u662f\u521b\u5efa\u4e00\u4e2a\u5b8c\u6574\u7684\u6e38\u620f\u5f15\u64ce\uff08\u7edd\u5bf9\u4e0d\u662f\u4e00\u4e2a\u4f53\u7d20\u5f15\u64ce\uff0c\u5b83\u9700\u8981\u4e0d\u540c\u7684\u65b9\u6cd5\u548c\u66f4\u591a\u7684\u4f18\u5316\uff09\u3002","title":"\u6269\u5c55"},{"location":"22-audio/","text":"\u97f3\u9891\uff08Audio\uff09 \u5728\u6b64\u4e4b\u524d\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u56fe\u50cf\uff0c\u4f46\u6bcf\u4e2a\u6e38\u620f\u7684\u53e6\u4e00\u4e2a\u5173\u952e\u9762\u662f\u97f3\u9891\u3002\u672c\u7ae0\u5c06\u5728 OpenAL \uff08Open Audio Library\uff0c\u5f00\u653e\u97f3\u9891\u5e93\uff09\u7684\u5e2e\u52a9\u4e0b\u5b9e\u73b0\u8fd9\u4e2a\u529f\u80fd\u3002OpenAL\u5c31\u50cf\u662fOpenGL\u5728\u97f3\u9891\u7684\u76f8\u4f3c\u7269\uff0c\u5b83\u5141\u8bb8\u6211\u4eec\u901a\u8fc7\u62bd\u8c61\u5c42\u64ad\u653e\u58f0\u97f3\u3002\u8be5\u5c42\u5c06\u6211\u4eec\u4e0e\u97f3\u9891\u5b50\u7cfb\u7edf\u7684\u590d\u6742\u5e95\u5c42\u9694\u79bb\u5f00\u6765\u3002\u6b64\u5916\uff0c\u5b83\u8fd8\u5141\u8bb8\u6211\u4eec\u53ef\u4ee5\u4e09\u7ef4\u573a\u666f\u4e2d\u7279\u5b9a\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u58f0\u97f3\uff0c\u201c\u6e32\u67d3\u201d\u58f0\u97f3\uff0c\u968f\u7740\u8ddd\u79bb\u8870\u51cf\u5e76\u6839\u636e\u5b83\u4eec\u7684\u901f\u5ea6\u8fdb\u884c\u4fee\u6539\uff08\u6a21\u62df \u591a\u666e\u52d2\u6548\u5e94 \uff09\u3002 LWJGL\u652f\u6301OpenGL\uff0c\u4e0d\u9700\u8981\u4efb\u4f55\u989d\u5916\u7684\u4e0b\u8f7d\uff0c\u5b83\u5c31\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528\u4e86\u3002\u4f46\u662f\u5728\u5f00\u59cb\u5199\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4ecb\u7ecd\u5904\u7406OpenGL\u65f6\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u5143\u7d20\uff0c\u5b83\u4eec\u662f\uff1a \u7f13\u51b2\u533a\uff08Buffer\uff09\u3002 \u58f0\u6e90\uff08Source\uff09\u3002 \u4fa6\u542c\u8005\uff08Listener\uff09\u3002 \u7f13\u51b2\u533a\u50a8\u5b58\u97f3\u9891\u6570\u636e\uff0c\u5373\u97f3\u4e50\u6216\u97f3\u6548\u3002\u5b83\u4eec\u7c7b\u4f3c\u4e8eOpenGL\u4e2d\u7684\u7eb9\u7406\u3002OpenAL\u5e0c\u671b\u97f3\u9891\u6570\u636e\u91c7\u7528PCM\uff08Pulse Coded Modulation\uff0c\u8109\u51b2\u7f16\u7801\u8c03\u5236\uff09\u683c\u5f0f\uff08\u5355\u58f0\u9053\u6216\u591a\u58f0\u9053\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u80fd\u53ea\u8f6c\u50a8MP3\u6216OGG\u6587\u4ef6\u800c\u4e0d\u9996\u5148\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3aPCM\u3002 \u4e0b\u4e00\u4e2a\u5143\u7d20\u662f\u58f0\u6e90\uff0c\u5b83\u8868\u793a\u53d1\u51fa\u58f0\u97f3\u7684\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\uff08\u4e00\u4e2a\u70b9\uff09\u3002\u58f0\u6e90\u4e0e\u7f13\u51b2\u533a\u5173\u8054\uff08\u4e00\u6b21\u53ea\u80fd\u6709\u4e00\u4e2a\uff09\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4f4d\u7f6e\uff0c\u58f0\u6e90\u7684\u4f4d\u7f6e\uff08 x \uff0c y \u548c z \u5750\u6807\uff09\u3002\u987a\u4fbf\u4e00\u63d0\uff0cOpenAL\u548cOpenGL\u4e00\u6837\u4f7f\u7528\u53f3\u624b\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5047\u8bbe\uff08\u4e3a\u4e86\u7b80\u5316\uff09\u4f60\u7684\u4e16\u754c\u5750\u6807\u7b49\u4e8e\u58f0\u97f3\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5750\u6807\u3002 \u901f\u5ea6\uff0c\u5b83\u6307\u5b9a\u58f0\u6e90\u79fb\u52a8\u7684\u901f\u5ea6\u3002\u8fd9\u662f\u7528\u6765\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u7684\u3002 \u589e\u76ca\uff0c\u7528\u6765\u6539\u53d8\u58f0\u97f3\u7684\u5927\u5c0f\uff08\u5c31\u50cf\u662f\u4e00\u4e2a\u653e\u5927\u56e0\u6570\uff09\u3002 \u6e90\u4ee3\u7801\u4e2d\u6709\u989d\u5916\u7684\u5c5e\u6027\uff0c\u7a0d\u540e\u5728\u8bb2\u89e3\u6e90\u4ee3\u7801\u65f6\u5c06\u63cf\u8ff0\u8fd9\u4e9b\u5c5e\u6027\u3002 \u6700\u540e\u4f46\u5e76\u4e0d\u91cd\u8981\u7684\u662f\uff0c\u4fa6\u542c\u8005\u662f\u662f\u4ea7\u751f\u7684\u58f0\u97f3\u5e94\u8be5\u88ab\u542c\u5230\u7684\u5730\u65b9\u3002\u4fa6\u542c\u5668\u5c31\u50cf\u662f\u88ab\u8bbe\u7f6e\u5728\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u4e2d\u7528\u6765\u63a5\u6536\u58f0\u97f3\u7684\u9ea6\u514b\u98ce\u3002\u73b0\u5728\u53ea\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\u3002\u56e0\u6b64\uff0c\u4eba\u4eec\u5e38\u8bf4\u7684\u97f3\u9891\u6e32\u67d3\u662f\u4ee5\u542c\u4f17\u7684\u89d2\u5ea6\u5b8c\u6210\u7684\u3002\u4fa6\u542c\u5668\u5171\u4eab\u4e00\u4e9b\u5c5e\u6027\uff0c\u4f46\u5b83\u8fd8\u6709\u4e00\u4e9b\u9644\u52a0\u5c5e\u6027\uff0c\u6bd4\u5982\u65b9\u5411\u3002\u65b9\u5411\u8868\u793a\u4fa6\u542c\u5668\u6240\u9762\u671d\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u6709\u4e00\u7ec4\u53d1\u51fa\u58f0\u97f3\u7684\u58f0\u6e90\u548c\u63a5\u6536\u58f0\u97f3\u7684\u4fa6\u542c\u5668\u7ec4\u6210\u3002\u6700\u7ec8\u542c\u5230\u7684\u58f0\u97f3\u53d6\u51b3\u4e8e\u542c\u8005\u5230\u4e0d\u540c\u58f0\u6e90\u7684\u8ddd\u79bb\u3001\u76f8\u5bf9\u901f\u5ea6\u548c\u9009\u62e9\u7684\u4f20\u64ad\u6a21\u578b\uff08Propagation Model\uff09\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u5305\u542b\u4e0d\u540c\u5143\u7d20\u7c7b\u578b\u7684\u4e09\u7ef4\u573a\u666f\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.sound \u7684\u65b0\u5305\uff0c\u5b83\u5c06\u8d1f\u8d23\u7ba1\u7406\u6240\u6709\u8d1f\u8d23\u5904\u7406\u97f3\u9891\u7684\u7c7b\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u4e00\u4e2a\u540d\u4e3a SoundBuffer \u7684\u7c7b\u5f00\u59cb\uff0c\u5b83\u5c06\u8868\u793a\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u7684\u4e00\u4e2a\u4ee3\u7801\u7247\u6bb5\u6240\u793a\uff1a package org.lwjglb.engine.sound; // import ... public class SoundBuffer { private final int bufferId; public SoundBuffer(String file) throws Exception { this.bufferId = alGenBuffers(); try (STBVorbisInfo info = STBVorbisInfo.malloc()) { ShortBuffer pcm = readVorbis(file, 32 * 1024, info); // \u590d\u5236\u5230\u7f13\u51b2\u533a alBufferData(buffer, info.channels() == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, pcm, info.sample_rate()); } } public int getBufferId() { return this.bufferId; } public void cleanup() { alDeleteBuffers(this.bufferId); } // ... } \u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u9700\u8981\u4e00\u4e2a\u58f0\u97f3\u6587\u4ef6\uff08\u5b83\u53ef\u80fd\u4e0e\u5176\u4ed6\u8d44\u6e90\u4e00\u6837\u4f4d\u4e8e\u7c7b\u8def\u5f84\u4e2d\uff09\uff0c\u5e76\u4ece\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenBuffers \u521b\u5efa\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u6700\u540e\uff0c\u6211\u4eec\u7684\u58f0\u97f3\u7f13\u51b2\u533a\u5c06\u7528\u4e00\u4e2a\u6574\u6570\u6765\u8868\u793a\uff0c\u5c31\u50cf\u4e00\u4e2a\u6307\u5411\u5b83\u6240\u6301\u6709\u7684\u6570\u636e\u7684\u6307\u9488\u3002\u4e00\u65e6\u521b\u5efa\u4e86\u7f13\u51b2\u533a\uff0c\u6211\u4eec\u5c31\u5c06\u97f3\u9891\u6570\u636e\u8f6c\u50a8\u5230\u5176\u4e2d\u3002\u6784\u9020\u51fd\u6570\u9700\u8981OGG\u683c\u5f0f\u7684\u6587\u4ef6\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3aPCM\u683c\u5f0f\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u8fd9\u5982\u4f55\u5728\u6e90\u4ee3\u7801\u4e2d\u5b8c\u6210\u7684\uff0c\u65e0\u8bba\u5982\u4f55\uff0c\u6e90\u4ee3\u7801\u662f\u4eceLWJGL\u7684OpenAL\u6d4b\u8bd5\u4e2d\u63d0\u53d6\u7684\u3002 \u6b64\u524d\u7248\u672c\u7684LWJGL\u6709\u4e00\u4e2a\u540d\u4e3a WaveData \u7684\u5e2e\u52a9\u7c7b\uff0c\u7528\u4e8e\u52a0\u8f7dWAV\u683c\u5f0f\u7684\u97f3\u9891\u6587\u4ef6\u3002\u8fd9\u4e2a\u7c7b\u4e0d\u518d\u51fa\u73b0\u5728LWJGL3\u4e2d\u3002\u4e0d\u8fc7\uff0c\u4f60\u53ef\u4ee5\u4ece\u8be5\u7c7b\u83b7\u5f97\u6e90\u4ee3\u7801\u5e76\u5728\u6e38\u620f\u4e2d\u4f7f\u7528\u5b83\uff08\u53ef\u80fd\u4e0d\u9700\u8981\u4efb\u4f55\u4fee\u6539\uff09\u3002 SoundBuffer \u7c7b\u8fd8\u63d0\u4f9b\u4e86 cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u8d44\u6e90\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u4e3aOpenAL\u5efa\u6a21\uff0c\u5b83\u5c06\u7531\u4e00\u4e2a\u540d\u4e3a SoundSource \u7684\u7c7b\u5b9e\u73b0\u3002\u7c7b\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundSource { private final int sourceId; public SoundSource(boolean loop, boolean relative) { this.sourceId = alGenSources(); if (loop) { alSourcei(sourceId, AL_LOOPING, AL_TRUE); } if (relative) { alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE); } } public void setBuffer(int bufferId) { stop(); alSourcei(sourceId, AL_BUFFER, bufferId); } public void setPosition(Vector3f position) { alSource3f(sourceId, AL_POSITION, position.x, position.y, position.z); } public void setSpeed(Vector3f speed) { alSource3f(sourceId, AL_VELOCITY, speed.x, speed.y, speed.z); } public void setGain(float gain) { alSourcef(sourceId, AL_GAIN, gain); } public void setProperty(int param, float value) { alSourcef(sourceId, param, value); } public void play() { alSourcePlay(sourceId); } public boolean isPlaying() { return alGetSourcei(sourceId, AL_SOURCE_STATE) == AL_PLAYING; } public void pause() { alSourcePause(sourceId); } public void stop() { alSourceStop(sourceId); } public void cleanup() { stop(); alDeleteSources(sourceId); } } \u58f0\u6e90\u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e9b\u65b9\u6cd5\u6765\u8bbe\u7f6e\u5b83\u7684\u4f4d\u7f6e\u3001\u589e\u76ca\u548c\u63a7\u5236\u65b9\u6cd5\u6765\u505c\u6b62\u548c\u6682\u505c\u64ad\u653e\u3002\u8bf7\u8bb0\u4f4f\uff0c\u58f0\u97f3\u63a7\u5236\u64cd\u4f5c\u662f\u5bf9\u4e00\u4e2a\u58f0\u6e90\uff08\u800c\u4e0d\u662f\u5bf9\u7f13\u51b2\u533a\uff09\u6267\u884c\u7684\u3002\u8bf7\u8bb0\u4f4f\uff0c\u591a\u4e2a\u6e90\u53ef\u4ee5\u5171\u4eab\u540c\u4e00\u4e2a\u7f13\u51b2\u533a\u3002\u4e0e SoundBuffer \u7c7b\u4e2d\u4e00\u6837\uff0c SoundBuffer \u7531\u4e00\u4e2a\u6807\u8bc6\u7b26\u6807\u8bb0\uff0c\u8be5\u6807\u8bc6\u7b26\u5728\u6bcf\u4e2a\u64cd\u4f5c\u4e2d\u4f7f\u7528\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u4fdd\u7559\u7684\u8d44\u6e90\u3002\u4f46\u662f\u8ba9\u6211\u4eec\u770b\u770b\u6784\u9020\u51fd\u6570\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenSources \u521b\u5efa\u58f0\u6e90\uff0c\u7136\u540e\u4f7f\u7528\u6784\u9020\u51fd\u6570\u53c2\u6570\u8bbe\u7f6e\u4e00\u4e9b\u6709\u8da3\u7684\u5c5e\u6027\u3002 \u7b2c\u4e00\u4e2a\u53c2\u6570 loop \uff0c\u8868\u793a\u8981\u64ad\u653e\u7684\u58f0\u97f3\u662f\u5426\u5e94\u8be5\u5904\u4e8e\u5faa\u73af\u6a21\u5f0f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5f53\u901a\u8fc7\u58f0\u6e90\u8c03\u7528\u64ad\u653e\u64cd\u4f5c\u65f6\uff0c\u5f53\u58f0\u97f3\u64ad\u653e\u5230\u6700\u540e\u65f6\u5c06\u505c\u6b62\u3002\u8fd9\u5bf9\u4e8e\u4e00\u4e9b\u58f0\u97f3\u6765\u8bf4\u662f\u53ef\u4ee5\u7684\uff0c\u4f46\u662f\u5bf9\u4e8e\u5176\u4ed6\u4e00\u4e9b\u58f0\u97f3\uff0c\u6bd4\u5982\u80cc\u666f\u97f3\u4e50\uff0c\u5c31\u9700\u8981\u53cd\u590d\u64ad\u653e\u3002\u5f53\u58f0\u97f3\u505c\u6b62\u65f6\u4e0d\u9700\u8981\u624b\u52a8\u63a7\u5236\u5e76\u91cd\u65b0\u64ad\u653e\u58f0\u97f3\uff0c\u6211\u4eec\u5c31\u53ea\u7528\u5c06\u5faa\u73af\u5c5e\u6027\u8bbe\u7f6e\u4e3a true \uff1a alSourcei(sourceId, AL_LOOPING, AL_TRUE); \u3002 \u53e6\u4e00\u4e2a\u53c2\u6570 relative \uff0c\u63a7\u5236\u58f0\u6e90\u7684\u4f4d\u7f6e\u662f\u5426\u76f8\u5bf9\u4e8e\u4fa6\u542c\u5668\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5f53\u4e3a\u58f0\u6e90\u8bbe\u7f6e\u4f4d\u7f6e\u65f6\uff0c\u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5b9a\u4e49\u5230\u4fa6\u542c\u5668\u7684\u8ddd\u79bb\uff08\u4f7f\u7528\u60f3\u60f3\uff09\uff0c\u800c\u4e0d\u662fOpenAL\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5750\u6807\uff0c\u4e5f\u4e0d\u662f\u4e16\u754c\u5750\u6807\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE);\u201d \u542f\u7528\u7684\u3002\u4f46\u662f\uff0c\u6211\u4eec\u80fd\u7528\u5b83\u505a\u4ec0\u4e48\u5462\uff1f\u8fd9\u4e2a\u5c5e\u6027\u5f88\u6709\u8da3\uff0c\u4f8b\u5982\uff0c\u7528\u4e8e\u4e0d\u5e94\u8be5\u53d7\u5230\u4fa6\u542c\u5668\u8ddd\u79bb\u5f71\u54cd\uff08\u51cf\u5f31\uff09\u7684\u80cc\u666f\u58f0\u97f3\u3002\u4f8b\u5982\uff0c\u5728\u80cc\u666f\u97f3\u4e50\u6216\u4e0e\u64ad\u653e\u5668\u63a7\u4ef6\u76f8\u5173\u7684\u97f3\u6548\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e9b\u58f0\u6e90\u8bbe\u7f6e\u4e3a\u76f8\u5bf9\u7684\uff0c\u5e76\u5c06\u5b83\u4eec\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u4e3a (0, 0, 0) \uff0c\u5b83\u4eec\u5c06\u4e0d\u4f1a\u88ab\u51cf\u5f31\u3002 \u73b0\u5728\u8f6e\u5230\u4fa6\u542c\u5668\u4e86\uff0c\u5b83\u662f\u7531\u4e00\u4e2a\u540d\u4e3a SoundListener \u5b9a\u4e49\u7684\u3002\u4ee5\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundListener { public SoundListener() { this(new Vector3f(0, 0, 0)); } public SoundListener(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); alListener3f(AL_VELOCITY, 0, 0, 0); } public void setSpeed(Vector3f speed) { alListener3f(AL_VELOCITY, speed.x, speed.y, speed.z); } public void setPosition(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); } public void setOrientation(Vector3f at, Vector3f up) { float[] data = new float[6]; data[0] = at.x; data[1] = at.y; data[2] = at.z; data[3] = up.x; data[4] = up.y; data[5] = up.z; alListenerfv(AL_ORIENTATION, data); } } \u4e0e\u524d\u9762\u7684\u7c7b\u4e0d\u540c\uff0c\u4f60\u5c06\u6ce8\u610f\u5230\u4e0d\u9700\u8981\u521b\u5efa\u4fa6\u542c\u5668\u3002\u603b\u4f1a\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u521b\u5efa\u4e00\u4e2a\uff0c\u5b83\u5df2\u7ecf\u4e3a\u6211\u4eec\u51c6\u5907\u597d\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u662f\u7b80\u5355\u5730\u8bbe\u7f6e\u5b83\u7684\u521d\u59cb\u4f4d\u7f6e\u3002\u57fa\u4e8e\u540c\u6837\u7684\u539f\u56e0\uff0c\u6ca1\u6709\u5fc5\u8981\u4f7f\u7528 cleanup \u65b9\u6cd5\u3002\u7c7b\u4e5f\u6709\u8bbe\u7f6e\u4fa6\u542c\u5668\u4f4d\u7f6e\u548c\u901f\u5ea6\u7684\u65b9\u6cd5\uff0c\u5c31\u50cf\u5728 SoundSource \u7c7b\u4e2d\u4e00\u6837\uff0c\u4f46\u662f\u6211\u4eec\u6709\u4e00\u4e2a\u989d\u5916\u7684\u65b9\u6cd5\u6765\u4fee\u6539\u4fa6\u542c\u5668\u7684\u65b9\u5411\u3002\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u65b9\u5411\u662f\u4ec0\u4e48\u3002\u4fa6\u542c\u5668\u65b9\u5411\u7531\u4e24\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c at \u5411\u91cf\u548c up \u5411\u91cf\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a at \u5411\u91cf\u57fa\u672c\u4e0a\u6307\u5411\u4fa6\u542c\u5668\u6240\u671d\u5411\u7684\u4f4d\u7f6e\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u7684\u503c\u4e3a (0, 0, -1) \u3002 up \u5411\u91cf\u786e\u5b9a\u4fa6\u542c\u5668\u5411\u4e0a\u7684\u65b9\u5411\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u6307\u5411 (0, 1, 0) \u3002\u8fd9\u4e24\u4e2a\u5411\u91cf\u7684\u4e09\u4e2a\u5206\u91cf\u90fd\u662f\u5728 alListenerfv \u65b9\u6cd5\u8c03\u7528\u4e2d\u8bbe\u7f6e\u7684\u3002\u6b64\u65b9\u6cd5\u7528\u4e8e\u5c06\u4e00\u7ec4\u6d6e\u70b9\u6570\uff08\u6d6e\u70b9\u6570\u53d8\u91cf\uff09\u4f20\u9012\u5230\u5c5e\u6027\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u65b9\u5411\uff09\u3002 \u5728\u7ee7\u7eed\u8bb2\u89e3\u4e4b\u524d\uff0c\u6709\u5fc5\u8981\u5f3a\u8c03\u4e00\u4e9b\u4e0e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\u76f8\u5173\u7684\u6982\u5ff5\u3002\u58f0\u6e90\u4e0e\u4fa6\u542c\u5668\u4e4b\u95f4\u7684\u76f8\u5bf9\u901f\u5ea6\u4f1a\u5bfc\u81f4OpenAL\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u3002\u5982\u679c\u4f60\u4e0d\u77e5\u9053\u591a\u666e\u52d2\u6548\u5e94\u662f\u4ec0\u4e48\uff0c\u591a\u666e\u52d2\u6548\u5e94\u5c06\u5bfc\u81f4\u4e00\u4e2a\u79bb\u4f60\u8d8a\u6765\u8d8a\u8fd1\u7684\u7269\u4f53\u53d1\u51fa\u7684\u9891\u7387\u4f3c\u4e4e\u6bd4\u5b83\u79bb\u5f00\u65f6\u53d1\u51fa\u7684\u9891\u7387\u8981\u9ad8\u7684\u6548\u5e94\u3002\u95ee\u9898\u662f\uff0c\u4ec5\u4ec5\u901a\u8fc7\u8bbe\u7f6e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\uff0cOpenAL\u4e0d\u4f1a\u4e3a\u4f60\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002\u5b83\u5c06\u4f7f\u7528\u76f8\u5bf9\u901f\u5ea6\u6765\u8ba1\u7b97\u591a\u666e\u52d2\u6548\u5e94\uff0c\u4f46\u4f4d\u7f6e\u4e0d\u4f1a\u6539\u53d8\u3002\u56e0\u6b64\uff0c\u5982\u679c\u4f60\u60f3\u8981\u6a21\u62df\u4e00\u4e2a\u79fb\u52a8\u7684\u58f0\u6e90\u6216\u8005\u4fa6\u542c\u5668\uff0c\u4f60\u5fc5\u987b\u6ce8\u610f\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b9a\u4e49\u4e86\u5173\u952e\u5143\u7d20\uff0c\u4e3a\u4e86\u8ba9\u5b83\u4eec\u5de5\u4f5c\uff0c\u9700\u8981\u521d\u59cb\u5316OpenAL\u5e93\uff0c\u56e0\u6b64\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SoundManager \u7684\u65b0\u7c7b\u6765\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u3002\u4e0b\u9762\u662f\u5b9a\u4e49\u8be5\u7c7b\u7684\u4ee3\u7801\u7247\u6bb5\uff1a package org.lwjglb.engine.sound; // import ... public class SoundManager { private long device; private long context; private SoundListener listener; private final List<SoundBuffer> soundBufferList; private final Map<String, SoundSource> soundSourceMap; private final Matrix4f cameraMatrix; public SoundManager() { soundBufferList = new ArrayList<>(); soundSourceMap = new HashMap<>(); cameraMatrix = new Matrix4f(); } public void init() throws Exception { this.device = alcOpenDevice((ByteBuffer) null); if (device == NULL) { throw new IllegalStateException(\"Failed to open the default OpenAL device.\"); } ALCCapabilities deviceCaps = ALC.createCapabilities(device); this.context = alcCreateContext(device, (IntBuffer) null); if (context == NULL) { throw new IllegalStateException(\"Failed to create OpenAL context.\"); } alcMakeContextCurrent(context); AL.createCapabilities(deviceCaps); } \u8be5\u7c7b\u4fdd\u5b58\u5bf9 SoundBuffer \u548c SoundSource \u7684\u5b9e\u4f8b\u7684\u5f15\u7528\uff0c\u4ee5\u4fbf\u8ddf\u8e2a\u548c\u5728\u6b64\u4e4b\u540e\u6b63\u786e\u5730\u6e05\u7406\u5b83\u4eec\u3002 SoundBuffer \u50a8\u5b58\u5728\u4e00\u4e2a\u5217\u8868\u4e2d\uff0c\u4f46 SoundSource \u50a8\u5b58\u5728\u4e00\u4e2a Map \u4e2d\uff0c\u56e0\u6b64\u53ef\u4ee5\u901a\u8fc7\u540d\u79f0\u641c\u7d22\u5b83\u4eec\u3002 init \u65b9\u6cd5\u521d\u59cb\u5316OpenAL\u5b50\u7cfb\u7edf\uff1a \u5f00\u542f\u9ed8\u8ba4\u8bbe\u5907\u3002 \u4e3a\u8be5\u8bbe\u5907\u521b\u5efa\u529f\u80fd\u3002 \u521b\u5efa\u4e00\u4e2a\u58f0\u97f3\u73af\u5883\uff0c\u5c31\u50cf\u662fOpenGL\u90a3\u6837\uff0c\u5e76\u5c06\u5176\u8bbe\u7f6e\u4e3a\u5f53\u524d\u73af\u5883\u3002 SoundManager \u7c7b\u8fd8\u5177\u6709\u66f4\u65b0\u7ed9\u5b9a\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u4fa6\u542c\u5668\u671d\u5411\u7684\u65b9\u6cd5\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u4fa6\u542c\u5668\u5c06\u88ab\u8bbe\u7f6e\u5728\u6444\u50cf\u673a\u6240\u5728\u7684\u4f4d\u7f6e\u3002\u90a3\u4e48\uff0c\u7ed9\u5b9a\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4fe1\u606f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 at \u548c up \u5411\u91cf\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u76f8\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6211\u4eec\u9700\u8981\u5c06 at (0, 0, -1) \u4e0e up (0, 1, 0) \u5411\u91cf\u8f6c\u6362\u4e3a\u8003\u8651\u6444\u50cf\u673a\u65cb\u8f6c\u7684\u5411\u91cf\u3002\u8ba9 cameraMatrix \u4e3a\u4e0e\u6444\u50cf\u673a\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u5b9e\u73b0\u7684\u4ee3\u7801\u5982\u4e0b\uff1a Matrix4f invCam = new Matrix4f(cameraMatrix).invert(); Vector3f at = new Vector3f(0, 0, -1); invCam.transformDirection(at); Vector3f up = new Vector3f(0, 1, 0); invCam.transformDirection(up); \u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u9006\u8f6c\u6444\u50cf\u673a\u89c2\u5bdf\u77e9\u9635\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u8fd9\u6837\u60f3\uff0c\u89c2\u5bdf\u77e9\u9635\u4ece\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u6211\u4eec\u60f3\u8981\u7684\u6b63\u597d\u76f8\u53cd\uff0c\u6211\u4eec\u60f3\u8981\u4ece\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\uff08\u89c2\u5bdf\u77e9\u9635\uff09\u8f6c\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5750\u6807\uff0c\u8fd9\u662f\u4fa6\u542c\u5668\u5e94\u8be5\u88ab\u653e\u7f6e\u7684\u4f4d\u7f6e\u3002\u5bf9\u4e8e\u77e9\u9635\uff0c\u53cd\u6bd4\u901a\u5e38\u5c31\u610f\u5473\u7740\u9006\u8f6c\u3002\u4e00\u65e6\u6211\u4eec\u6709\u4e86\u8fd9\u4e2a\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8f6c\u6362 at \u548c up \u5411\u91cf\uff0c\u4f7f\u7528\u8fd9\u4e2a\u77e9\u9635\u8ba1\u7b97\u65b0\u7684\u65b9\u5411\u3002 \u4f46\u662f\uff0c\u5982\u679c\u4f60\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u770b\u5230\u5b9e\u73b0\u7565\u6709\u4e0d\u540c\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\uff1a Vector3f at = new Vector3f(); cameraMatrix.positiveZ(at).negate(); Vector3f up = new Vector3f(); cameraMatrix.positiveY(up); listener.setOrientation(at, up); \u4e0a\u8ff0\u4ee3\u7801\u7b49\u4ef7\u4e8e\u7b2c\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ea\u662f\u4e00\u79cd\u66f4\u9ad8\u6548\u7684\u65b9\u6cd5\u3002\u5b83\u4f7f\u7528\u4e86\u4e00\u79cd\u66f4\u5feb\u7684\u65b9\u6cd5\uff0c\u53ef\u4ee5\u5728 JOML \u5e93\u4e2d\u627e\u5230\uff0c\u8fd9\u79cd\u65b9\u6cd5\u4e0d\u9700\u8981\u8ba1\u7b97\u5b8c\u6574\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u53ef\u4ee5\u5f97\u5230\u76f8\u540c\u7684\u7ed3\u679c\u3002\u8fd9\u65b9\u6cd5\u662f\u7531LWJGL\u8bba\u575b\u4e2d\u7684 JOML\u4f5c\u8005 \u63d0\u4f9b\u7684\uff0c\u56e0\u6b64\u4f60\u53ef\u4ee5\u5728[\u90a3\u91cc]((http://forum.lwjgl.org/index.php?topic=6080.0)\u67e5\u770b\u66f4\u591a\u7ec6\u8282\u3002\u5982\u679c\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u5c06\u770b\u5230 SoundManager \u7c7b\u8ba1\u7b97\u5b83\u81ea\u5df1\u7684\u89c2\u5bdf\u77e9\u9635\u526f\u672c\u3002\u8fd9\u5df2\u7ecf\u5728 Renderer \u7c7b\u4e2d\u5b8c\u6210\u4e86\u3002\u4e3a\u4e86\u4fdd\u6301\u4ee3\u7801\u7b80\u5355\uff0c\u5e76\u907f\u514d\u91cd\u6784\uff0c\u6211\u503e\u5411\u4e8e\u4f7f\u7528\u8fd9\u79cd\u65b9\u5f0f\u3002 \u8fd9\u5c31\u5b8c\u4e86\u3002\u6211\u4eec\u62e5\u6709\u64ad\u653e\u58f0\u97f3\u6240\u9700\u7684\u6240\u6709\u57fa\u7840\u7ed3\u6784\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4e86\u89e3\u5982\u4f55\u4f7f\u7528\u6240\u6709\u4ee3\u7801\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u97f3\u4e50\u662f\u5982\u4f55\u64ad\u653e\u7684\uff0c\u4ee5\u53ca\u4e0d\u540c\u6548\u679c\u7684\u58f0\u97f3\uff08\u8fd9\u4e9b\u6587\u4ef6\u662f\u4ece Freesound \u4e2d\u83b7\u5f97\u7684\uff0c\u8d21\u732e\u8005\u90fd\u50a8\u5b58\u5728\u540d\u4e3aCREDITS.txt\u7684\u4e00\u4e2a\u6587\u4ef6\u4e2d\uff09\u3002\u5982\u679c\u4f60\u83b7\u5f97\u4e00\u4e9b\u5176\u4ed6\u6587\u4ef6\uff0c\u4f60\u53ef\u4ee5\u4f1a\u6ce8\u610f\u5230\u58f0\u97f3\u8870\u51cf\u4e0e\u8ddd\u79bb\u6216\u4fa6\u542c\u5668\u7684\u65b9\u5411\u65e0\u5173\u3002\u8bf7\u68c0\u67e5\u8fd9\u4e9b\u58f0\u97f3\u662f\u5426\u662f\u5355\u58f0\u9053\uff0c\u662f\u5426\u4e0d\u662f\u7acb\u4f53\u58f0\u3002OpenGL\u4ec5\u80fd\u4f7f\u7528\u5355\u58f0\u9053\u58f0\u97f3\u8fdb\u884c\u8ba1\u7b97\u3002 \u540e\u8bb0\uff0cOpenAL\u8fd8\u5141\u8bb8\u4f60\u901a\u8fc7\u4f7f\u7528 alDistanceModel \u5e76\u4f20\u9012\u4f60\u60f3\u4f7f\u7528\u7684\u6a21\u578b\uff08 AL11.AL_EXPONENT_DISTANCE \uff0c AL_EXPONENT_DISTANCE_CLAMP \uff0c\u7b49\u7b49\uff09\u3002\u4f60\u53ef\u4ee5\u7528\u5b83\u4eec\u6765\u64ad\u653e\u5e76\u68c0\u67e5\u6548\u679c\u3002","title":"\u97f3\u6548"},{"location":"22-audio/#audio","text":"\u5728\u6b64\u4e4b\u524d\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u56fe\u50cf\uff0c\u4f46\u6bcf\u4e2a\u6e38\u620f\u7684\u53e6\u4e00\u4e2a\u5173\u952e\u9762\u662f\u97f3\u9891\u3002\u672c\u7ae0\u5c06\u5728 OpenAL \uff08Open Audio Library\uff0c\u5f00\u653e\u97f3\u9891\u5e93\uff09\u7684\u5e2e\u52a9\u4e0b\u5b9e\u73b0\u8fd9\u4e2a\u529f\u80fd\u3002OpenAL\u5c31\u50cf\u662fOpenGL\u5728\u97f3\u9891\u7684\u76f8\u4f3c\u7269\uff0c\u5b83\u5141\u8bb8\u6211\u4eec\u901a\u8fc7\u62bd\u8c61\u5c42\u64ad\u653e\u58f0\u97f3\u3002\u8be5\u5c42\u5c06\u6211\u4eec\u4e0e\u97f3\u9891\u5b50\u7cfb\u7edf\u7684\u590d\u6742\u5e95\u5c42\u9694\u79bb\u5f00\u6765\u3002\u6b64\u5916\uff0c\u5b83\u8fd8\u5141\u8bb8\u6211\u4eec\u53ef\u4ee5\u4e09\u7ef4\u573a\u666f\u4e2d\u7279\u5b9a\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u58f0\u97f3\uff0c\u201c\u6e32\u67d3\u201d\u58f0\u97f3\uff0c\u968f\u7740\u8ddd\u79bb\u8870\u51cf\u5e76\u6839\u636e\u5b83\u4eec\u7684\u901f\u5ea6\u8fdb\u884c\u4fee\u6539\uff08\u6a21\u62df \u591a\u666e\u52d2\u6548\u5e94 \uff09\u3002 LWJGL\u652f\u6301OpenGL\uff0c\u4e0d\u9700\u8981\u4efb\u4f55\u989d\u5916\u7684\u4e0b\u8f7d\uff0c\u5b83\u5c31\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528\u4e86\u3002\u4f46\u662f\u5728\u5f00\u59cb\u5199\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4ecb\u7ecd\u5904\u7406OpenGL\u65f6\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u5143\u7d20\uff0c\u5b83\u4eec\u662f\uff1a \u7f13\u51b2\u533a\uff08Buffer\uff09\u3002 \u58f0\u6e90\uff08Source\uff09\u3002 \u4fa6\u542c\u8005\uff08Listener\uff09\u3002 \u7f13\u51b2\u533a\u50a8\u5b58\u97f3\u9891\u6570\u636e\uff0c\u5373\u97f3\u4e50\u6216\u97f3\u6548\u3002\u5b83\u4eec\u7c7b\u4f3c\u4e8eOpenGL\u4e2d\u7684\u7eb9\u7406\u3002OpenAL\u5e0c\u671b\u97f3\u9891\u6570\u636e\u91c7\u7528PCM\uff08Pulse Coded Modulation\uff0c\u8109\u51b2\u7f16\u7801\u8c03\u5236\uff09\u683c\u5f0f\uff08\u5355\u58f0\u9053\u6216\u591a\u58f0\u9053\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u80fd\u53ea\u8f6c\u50a8MP3\u6216OGG\u6587\u4ef6\u800c\u4e0d\u9996\u5148\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3aPCM\u3002 \u4e0b\u4e00\u4e2a\u5143\u7d20\u662f\u58f0\u6e90\uff0c\u5b83\u8868\u793a\u53d1\u51fa\u58f0\u97f3\u7684\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\uff08\u4e00\u4e2a\u70b9\uff09\u3002\u58f0\u6e90\u4e0e\u7f13\u51b2\u533a\u5173\u8054\uff08\u4e00\u6b21\u53ea\u80fd\u6709\u4e00\u4e2a\uff09\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4f4d\u7f6e\uff0c\u58f0\u6e90\u7684\u4f4d\u7f6e\uff08 x \uff0c y \u548c z \u5750\u6807\uff09\u3002\u987a\u4fbf\u4e00\u63d0\uff0cOpenAL\u548cOpenGL\u4e00\u6837\u4f7f\u7528\u53f3\u624b\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5047\u8bbe\uff08\u4e3a\u4e86\u7b80\u5316\uff09\u4f60\u7684\u4e16\u754c\u5750\u6807\u7b49\u4e8e\u58f0\u97f3\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5750\u6807\u3002 \u901f\u5ea6\uff0c\u5b83\u6307\u5b9a\u58f0\u6e90\u79fb\u52a8\u7684\u901f\u5ea6\u3002\u8fd9\u662f\u7528\u6765\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u7684\u3002 \u589e\u76ca\uff0c\u7528\u6765\u6539\u53d8\u58f0\u97f3\u7684\u5927\u5c0f\uff08\u5c31\u50cf\u662f\u4e00\u4e2a\u653e\u5927\u56e0\u6570\uff09\u3002 \u6e90\u4ee3\u7801\u4e2d\u6709\u989d\u5916\u7684\u5c5e\u6027\uff0c\u7a0d\u540e\u5728\u8bb2\u89e3\u6e90\u4ee3\u7801\u65f6\u5c06\u63cf\u8ff0\u8fd9\u4e9b\u5c5e\u6027\u3002 \u6700\u540e\u4f46\u5e76\u4e0d\u91cd\u8981\u7684\u662f\uff0c\u4fa6\u542c\u8005\u662f\u662f\u4ea7\u751f\u7684\u58f0\u97f3\u5e94\u8be5\u88ab\u542c\u5230\u7684\u5730\u65b9\u3002\u4fa6\u542c\u5668\u5c31\u50cf\u662f\u88ab\u8bbe\u7f6e\u5728\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u4e2d\u7528\u6765\u63a5\u6536\u58f0\u97f3\u7684\u9ea6\u514b\u98ce\u3002\u73b0\u5728\u53ea\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\u3002\u56e0\u6b64\uff0c\u4eba\u4eec\u5e38\u8bf4\u7684\u97f3\u9891\u6e32\u67d3\u662f\u4ee5\u542c\u4f17\u7684\u89d2\u5ea6\u5b8c\u6210\u7684\u3002\u4fa6\u542c\u5668\u5171\u4eab\u4e00\u4e9b\u5c5e\u6027\uff0c\u4f46\u5b83\u8fd8\u6709\u4e00\u4e9b\u9644\u52a0\u5c5e\u6027\uff0c\u6bd4\u5982\u65b9\u5411\u3002\u65b9\u5411\u8868\u793a\u4fa6\u542c\u5668\u6240\u9762\u671d\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u6709\u4e00\u7ec4\u53d1\u51fa\u58f0\u97f3\u7684\u58f0\u6e90\u548c\u63a5\u6536\u58f0\u97f3\u7684\u4fa6\u542c\u5668\u7ec4\u6210\u3002\u6700\u7ec8\u542c\u5230\u7684\u58f0\u97f3\u53d6\u51b3\u4e8e\u542c\u8005\u5230\u4e0d\u540c\u58f0\u6e90\u7684\u8ddd\u79bb\u3001\u76f8\u5bf9\u901f\u5ea6\u548c\u9009\u62e9\u7684\u4f20\u64ad\u6a21\u578b\uff08Propagation Model\uff09\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u5305\u542b\u4e0d\u540c\u5143\u7d20\u7c7b\u578b\u7684\u4e09\u7ef4\u573a\u666f\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.sound \u7684\u65b0\u5305\uff0c\u5b83\u5c06\u8d1f\u8d23\u7ba1\u7406\u6240\u6709\u8d1f\u8d23\u5904\u7406\u97f3\u9891\u7684\u7c7b\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u4e00\u4e2a\u540d\u4e3a SoundBuffer \u7684\u7c7b\u5f00\u59cb\uff0c\u5b83\u5c06\u8868\u793a\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u7684\u4e00\u4e2a\u4ee3\u7801\u7247\u6bb5\u6240\u793a\uff1a package org.lwjglb.engine.sound; // import ... public class SoundBuffer { private final int bufferId; public SoundBuffer(String file) throws Exception { this.bufferId = alGenBuffers(); try (STBVorbisInfo info = STBVorbisInfo.malloc()) { ShortBuffer pcm = readVorbis(file, 32 * 1024, info); // \u590d\u5236\u5230\u7f13\u51b2\u533a alBufferData(buffer, info.channels() == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, pcm, info.sample_rate()); } } public int getBufferId() { return this.bufferId; } public void cleanup() { alDeleteBuffers(this.bufferId); } // ... } \u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u9700\u8981\u4e00\u4e2a\u58f0\u97f3\u6587\u4ef6\uff08\u5b83\u53ef\u80fd\u4e0e\u5176\u4ed6\u8d44\u6e90\u4e00\u6837\u4f4d\u4e8e\u7c7b\u8def\u5f84\u4e2d\uff09\uff0c\u5e76\u4ece\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenBuffers \u521b\u5efa\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u6700\u540e\uff0c\u6211\u4eec\u7684\u58f0\u97f3\u7f13\u51b2\u533a\u5c06\u7528\u4e00\u4e2a\u6574\u6570\u6765\u8868\u793a\uff0c\u5c31\u50cf\u4e00\u4e2a\u6307\u5411\u5b83\u6240\u6301\u6709\u7684\u6570\u636e\u7684\u6307\u9488\u3002\u4e00\u65e6\u521b\u5efa\u4e86\u7f13\u51b2\u533a\uff0c\u6211\u4eec\u5c31\u5c06\u97f3\u9891\u6570\u636e\u8f6c\u50a8\u5230\u5176\u4e2d\u3002\u6784\u9020\u51fd\u6570\u9700\u8981OGG\u683c\u5f0f\u7684\u6587\u4ef6\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3aPCM\u683c\u5f0f\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u8fd9\u5982\u4f55\u5728\u6e90\u4ee3\u7801\u4e2d\u5b8c\u6210\u7684\uff0c\u65e0\u8bba\u5982\u4f55\uff0c\u6e90\u4ee3\u7801\u662f\u4eceLWJGL\u7684OpenAL\u6d4b\u8bd5\u4e2d\u63d0\u53d6\u7684\u3002 \u6b64\u524d\u7248\u672c\u7684LWJGL\u6709\u4e00\u4e2a\u540d\u4e3a WaveData \u7684\u5e2e\u52a9\u7c7b\uff0c\u7528\u4e8e\u52a0\u8f7dWAV\u683c\u5f0f\u7684\u97f3\u9891\u6587\u4ef6\u3002\u8fd9\u4e2a\u7c7b\u4e0d\u518d\u51fa\u73b0\u5728LWJGL3\u4e2d\u3002\u4e0d\u8fc7\uff0c\u4f60\u53ef\u4ee5\u4ece\u8be5\u7c7b\u83b7\u5f97\u6e90\u4ee3\u7801\u5e76\u5728\u6e38\u620f\u4e2d\u4f7f\u7528\u5b83\uff08\u53ef\u80fd\u4e0d\u9700\u8981\u4efb\u4f55\u4fee\u6539\uff09\u3002 SoundBuffer \u7c7b\u8fd8\u63d0\u4f9b\u4e86 cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u8d44\u6e90\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u4e3aOpenAL\u5efa\u6a21\uff0c\u5b83\u5c06\u7531\u4e00\u4e2a\u540d\u4e3a SoundSource \u7684\u7c7b\u5b9e\u73b0\u3002\u7c7b\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundSource { private final int sourceId; public SoundSource(boolean loop, boolean relative) { this.sourceId = alGenSources(); if (loop) { alSourcei(sourceId, AL_LOOPING, AL_TRUE); } if (relative) { alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE); } } public void setBuffer(int bufferId) { stop(); alSourcei(sourceId, AL_BUFFER, bufferId); } public void setPosition(Vector3f position) { alSource3f(sourceId, AL_POSITION, position.x, position.y, position.z); } public void setSpeed(Vector3f speed) { alSource3f(sourceId, AL_VELOCITY, speed.x, speed.y, speed.z); } public void setGain(float gain) { alSourcef(sourceId, AL_GAIN, gain); } public void setProperty(int param, float value) { alSourcef(sourceId, param, value); } public void play() { alSourcePlay(sourceId); } public boolean isPlaying() { return alGetSourcei(sourceId, AL_SOURCE_STATE) == AL_PLAYING; } public void pause() { alSourcePause(sourceId); } public void stop() { alSourceStop(sourceId); } public void cleanup() { stop(); alDeleteSources(sourceId); } } \u58f0\u6e90\u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e9b\u65b9\u6cd5\u6765\u8bbe\u7f6e\u5b83\u7684\u4f4d\u7f6e\u3001\u589e\u76ca\u548c\u63a7\u5236\u65b9\u6cd5\u6765\u505c\u6b62\u548c\u6682\u505c\u64ad\u653e\u3002\u8bf7\u8bb0\u4f4f\uff0c\u58f0\u97f3\u63a7\u5236\u64cd\u4f5c\u662f\u5bf9\u4e00\u4e2a\u58f0\u6e90\uff08\u800c\u4e0d\u662f\u5bf9\u7f13\u51b2\u533a\uff09\u6267\u884c\u7684\u3002\u8bf7\u8bb0\u4f4f\uff0c\u591a\u4e2a\u6e90\u53ef\u4ee5\u5171\u4eab\u540c\u4e00\u4e2a\u7f13\u51b2\u533a\u3002\u4e0e SoundBuffer \u7c7b\u4e2d\u4e00\u6837\uff0c SoundBuffer \u7531\u4e00\u4e2a\u6807\u8bc6\u7b26\u6807\u8bb0\uff0c\u8be5\u6807\u8bc6\u7b26\u5728\u6bcf\u4e2a\u64cd\u4f5c\u4e2d\u4f7f\u7528\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u4fdd\u7559\u7684\u8d44\u6e90\u3002\u4f46\u662f\u8ba9\u6211\u4eec\u770b\u770b\u6784\u9020\u51fd\u6570\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenSources \u521b\u5efa\u58f0\u6e90\uff0c\u7136\u540e\u4f7f\u7528\u6784\u9020\u51fd\u6570\u53c2\u6570\u8bbe\u7f6e\u4e00\u4e9b\u6709\u8da3\u7684\u5c5e\u6027\u3002 \u7b2c\u4e00\u4e2a\u53c2\u6570 loop \uff0c\u8868\u793a\u8981\u64ad\u653e\u7684\u58f0\u97f3\u662f\u5426\u5e94\u8be5\u5904\u4e8e\u5faa\u73af\u6a21\u5f0f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5f53\u901a\u8fc7\u58f0\u6e90\u8c03\u7528\u64ad\u653e\u64cd\u4f5c\u65f6\uff0c\u5f53\u58f0\u97f3\u64ad\u653e\u5230\u6700\u540e\u65f6\u5c06\u505c\u6b62\u3002\u8fd9\u5bf9\u4e8e\u4e00\u4e9b\u58f0\u97f3\u6765\u8bf4\u662f\u53ef\u4ee5\u7684\uff0c\u4f46\u662f\u5bf9\u4e8e\u5176\u4ed6\u4e00\u4e9b\u58f0\u97f3\uff0c\u6bd4\u5982\u80cc\u666f\u97f3\u4e50\uff0c\u5c31\u9700\u8981\u53cd\u590d\u64ad\u653e\u3002\u5f53\u58f0\u97f3\u505c\u6b62\u65f6\u4e0d\u9700\u8981\u624b\u52a8\u63a7\u5236\u5e76\u91cd\u65b0\u64ad\u653e\u58f0\u97f3\uff0c\u6211\u4eec\u5c31\u53ea\u7528\u5c06\u5faa\u73af\u5c5e\u6027\u8bbe\u7f6e\u4e3a true \uff1a alSourcei(sourceId, AL_LOOPING, AL_TRUE); \u3002 \u53e6\u4e00\u4e2a\u53c2\u6570 relative \uff0c\u63a7\u5236\u58f0\u6e90\u7684\u4f4d\u7f6e\u662f\u5426\u76f8\u5bf9\u4e8e\u4fa6\u542c\u5668\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5f53\u4e3a\u58f0\u6e90\u8bbe\u7f6e\u4f4d\u7f6e\u65f6\uff0c\u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5b9a\u4e49\u5230\u4fa6\u542c\u5668\u7684\u8ddd\u79bb\uff08\u4f7f\u7528\u60f3\u60f3\uff09\uff0c\u800c\u4e0d\u662fOpenAL\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5750\u6807\uff0c\u4e5f\u4e0d\u662f\u4e16\u754c\u5750\u6807\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE);\u201d \u542f\u7528\u7684\u3002\u4f46\u662f\uff0c\u6211\u4eec\u80fd\u7528\u5b83\u505a\u4ec0\u4e48\u5462\uff1f\u8fd9\u4e2a\u5c5e\u6027\u5f88\u6709\u8da3\uff0c\u4f8b\u5982\uff0c\u7528\u4e8e\u4e0d\u5e94\u8be5\u53d7\u5230\u4fa6\u542c\u5668\u8ddd\u79bb\u5f71\u54cd\uff08\u51cf\u5f31\uff09\u7684\u80cc\u666f\u58f0\u97f3\u3002\u4f8b\u5982\uff0c\u5728\u80cc\u666f\u97f3\u4e50\u6216\u4e0e\u64ad\u653e\u5668\u63a7\u4ef6\u76f8\u5173\u7684\u97f3\u6548\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e9b\u58f0\u6e90\u8bbe\u7f6e\u4e3a\u76f8\u5bf9\u7684\uff0c\u5e76\u5c06\u5b83\u4eec\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u4e3a (0, 0, 0) \uff0c\u5b83\u4eec\u5c06\u4e0d\u4f1a\u88ab\u51cf\u5f31\u3002 \u73b0\u5728\u8f6e\u5230\u4fa6\u542c\u5668\u4e86\uff0c\u5b83\u662f\u7531\u4e00\u4e2a\u540d\u4e3a SoundListener \u5b9a\u4e49\u7684\u3002\u4ee5\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundListener { public SoundListener() { this(new Vector3f(0, 0, 0)); } public SoundListener(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); alListener3f(AL_VELOCITY, 0, 0, 0); } public void setSpeed(Vector3f speed) { alListener3f(AL_VELOCITY, speed.x, speed.y, speed.z); } public void setPosition(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); } public void setOrientation(Vector3f at, Vector3f up) { float[] data = new float[6]; data[0] = at.x; data[1] = at.y; data[2] = at.z; data[3] = up.x; data[4] = up.y; data[5] = up.z; alListenerfv(AL_ORIENTATION, data); } } \u4e0e\u524d\u9762\u7684\u7c7b\u4e0d\u540c\uff0c\u4f60\u5c06\u6ce8\u610f\u5230\u4e0d\u9700\u8981\u521b\u5efa\u4fa6\u542c\u5668\u3002\u603b\u4f1a\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u521b\u5efa\u4e00\u4e2a\uff0c\u5b83\u5df2\u7ecf\u4e3a\u6211\u4eec\u51c6\u5907\u597d\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u662f\u7b80\u5355\u5730\u8bbe\u7f6e\u5b83\u7684\u521d\u59cb\u4f4d\u7f6e\u3002\u57fa\u4e8e\u540c\u6837\u7684\u539f\u56e0\uff0c\u6ca1\u6709\u5fc5\u8981\u4f7f\u7528 cleanup \u65b9\u6cd5\u3002\u7c7b\u4e5f\u6709\u8bbe\u7f6e\u4fa6\u542c\u5668\u4f4d\u7f6e\u548c\u901f\u5ea6\u7684\u65b9\u6cd5\uff0c\u5c31\u50cf\u5728 SoundSource \u7c7b\u4e2d\u4e00\u6837\uff0c\u4f46\u662f\u6211\u4eec\u6709\u4e00\u4e2a\u989d\u5916\u7684\u65b9\u6cd5\u6765\u4fee\u6539\u4fa6\u542c\u5668\u7684\u65b9\u5411\u3002\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u65b9\u5411\u662f\u4ec0\u4e48\u3002\u4fa6\u542c\u5668\u65b9\u5411\u7531\u4e24\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c at \u5411\u91cf\u548c up \u5411\u91cf\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a at \u5411\u91cf\u57fa\u672c\u4e0a\u6307\u5411\u4fa6\u542c\u5668\u6240\u671d\u5411\u7684\u4f4d\u7f6e\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u7684\u503c\u4e3a (0, 0, -1) \u3002 up \u5411\u91cf\u786e\u5b9a\u4fa6\u542c\u5668\u5411\u4e0a\u7684\u65b9\u5411\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u6307\u5411 (0, 1, 0) \u3002\u8fd9\u4e24\u4e2a\u5411\u91cf\u7684\u4e09\u4e2a\u5206\u91cf\u90fd\u662f\u5728 alListenerfv \u65b9\u6cd5\u8c03\u7528\u4e2d\u8bbe\u7f6e\u7684\u3002\u6b64\u65b9\u6cd5\u7528\u4e8e\u5c06\u4e00\u7ec4\u6d6e\u70b9\u6570\uff08\u6d6e\u70b9\u6570\u53d8\u91cf\uff09\u4f20\u9012\u5230\u5c5e\u6027\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u65b9\u5411\uff09\u3002 \u5728\u7ee7\u7eed\u8bb2\u89e3\u4e4b\u524d\uff0c\u6709\u5fc5\u8981\u5f3a\u8c03\u4e00\u4e9b\u4e0e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\u76f8\u5173\u7684\u6982\u5ff5\u3002\u58f0\u6e90\u4e0e\u4fa6\u542c\u5668\u4e4b\u95f4\u7684\u76f8\u5bf9\u901f\u5ea6\u4f1a\u5bfc\u81f4OpenAL\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u3002\u5982\u679c\u4f60\u4e0d\u77e5\u9053\u591a\u666e\u52d2\u6548\u5e94\u662f\u4ec0\u4e48\uff0c\u591a\u666e\u52d2\u6548\u5e94\u5c06\u5bfc\u81f4\u4e00\u4e2a\u79bb\u4f60\u8d8a\u6765\u8d8a\u8fd1\u7684\u7269\u4f53\u53d1\u51fa\u7684\u9891\u7387\u4f3c\u4e4e\u6bd4\u5b83\u79bb\u5f00\u65f6\u53d1\u51fa\u7684\u9891\u7387\u8981\u9ad8\u7684\u6548\u5e94\u3002\u95ee\u9898\u662f\uff0c\u4ec5\u4ec5\u901a\u8fc7\u8bbe\u7f6e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\uff0cOpenAL\u4e0d\u4f1a\u4e3a\u4f60\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002\u5b83\u5c06\u4f7f\u7528\u76f8\u5bf9\u901f\u5ea6\u6765\u8ba1\u7b97\u591a\u666e\u52d2\u6548\u5e94\uff0c\u4f46\u4f4d\u7f6e\u4e0d\u4f1a\u6539\u53d8\u3002\u56e0\u6b64\uff0c\u5982\u679c\u4f60\u60f3\u8981\u6a21\u62df\u4e00\u4e2a\u79fb\u52a8\u7684\u58f0\u6e90\u6216\u8005\u4fa6\u542c\u5668\uff0c\u4f60\u5fc5\u987b\u6ce8\u610f\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b9a\u4e49\u4e86\u5173\u952e\u5143\u7d20\uff0c\u4e3a\u4e86\u8ba9\u5b83\u4eec\u5de5\u4f5c\uff0c\u9700\u8981\u521d\u59cb\u5316OpenAL\u5e93\uff0c\u56e0\u6b64\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SoundManager \u7684\u65b0\u7c7b\u6765\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u3002\u4e0b\u9762\u662f\u5b9a\u4e49\u8be5\u7c7b\u7684\u4ee3\u7801\u7247\u6bb5\uff1a package org.lwjglb.engine.sound; // import ... public class SoundManager { private long device; private long context; private SoundListener listener; private final List<SoundBuffer> soundBufferList; private final Map<String, SoundSource> soundSourceMap; private final Matrix4f cameraMatrix; public SoundManager() { soundBufferList = new ArrayList<>(); soundSourceMap = new HashMap<>(); cameraMatrix = new Matrix4f(); } public void init() throws Exception { this.device = alcOpenDevice((ByteBuffer) null); if (device == NULL) { throw new IllegalStateException(\"Failed to open the default OpenAL device.\"); } ALCCapabilities deviceCaps = ALC.createCapabilities(device); this.context = alcCreateContext(device, (IntBuffer) null); if (context == NULL) { throw new IllegalStateException(\"Failed to create OpenAL context.\"); } alcMakeContextCurrent(context); AL.createCapabilities(deviceCaps); } \u8be5\u7c7b\u4fdd\u5b58\u5bf9 SoundBuffer \u548c SoundSource \u7684\u5b9e\u4f8b\u7684\u5f15\u7528\uff0c\u4ee5\u4fbf\u8ddf\u8e2a\u548c\u5728\u6b64\u4e4b\u540e\u6b63\u786e\u5730\u6e05\u7406\u5b83\u4eec\u3002 SoundBuffer \u50a8\u5b58\u5728\u4e00\u4e2a\u5217\u8868\u4e2d\uff0c\u4f46 SoundSource \u50a8\u5b58\u5728\u4e00\u4e2a Map \u4e2d\uff0c\u56e0\u6b64\u53ef\u4ee5\u901a\u8fc7\u540d\u79f0\u641c\u7d22\u5b83\u4eec\u3002 init \u65b9\u6cd5\u521d\u59cb\u5316OpenAL\u5b50\u7cfb\u7edf\uff1a \u5f00\u542f\u9ed8\u8ba4\u8bbe\u5907\u3002 \u4e3a\u8be5\u8bbe\u5907\u521b\u5efa\u529f\u80fd\u3002 \u521b\u5efa\u4e00\u4e2a\u58f0\u97f3\u73af\u5883\uff0c\u5c31\u50cf\u662fOpenGL\u90a3\u6837\uff0c\u5e76\u5c06\u5176\u8bbe\u7f6e\u4e3a\u5f53\u524d\u73af\u5883\u3002 SoundManager \u7c7b\u8fd8\u5177\u6709\u66f4\u65b0\u7ed9\u5b9a\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u4fa6\u542c\u5668\u671d\u5411\u7684\u65b9\u6cd5\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u4fa6\u542c\u5668\u5c06\u88ab\u8bbe\u7f6e\u5728\u6444\u50cf\u673a\u6240\u5728\u7684\u4f4d\u7f6e\u3002\u90a3\u4e48\uff0c\u7ed9\u5b9a\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4fe1\u606f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 at \u548c up \u5411\u91cf\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u76f8\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6211\u4eec\u9700\u8981\u5c06 at (0, 0, -1) \u4e0e up (0, 1, 0) \u5411\u91cf\u8f6c\u6362\u4e3a\u8003\u8651\u6444\u50cf\u673a\u65cb\u8f6c\u7684\u5411\u91cf\u3002\u8ba9 cameraMatrix \u4e3a\u4e0e\u6444\u50cf\u673a\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u5b9e\u73b0\u7684\u4ee3\u7801\u5982\u4e0b\uff1a Matrix4f invCam = new Matrix4f(cameraMatrix).invert(); Vector3f at = new Vector3f(0, 0, -1); invCam.transformDirection(at); Vector3f up = new Vector3f(0, 1, 0); invCam.transformDirection(up); \u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u9006\u8f6c\u6444\u50cf\u673a\u89c2\u5bdf\u77e9\u9635\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u8fd9\u6837\u60f3\uff0c\u89c2\u5bdf\u77e9\u9635\u4ece\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u6211\u4eec\u60f3\u8981\u7684\u6b63\u597d\u76f8\u53cd\uff0c\u6211\u4eec\u60f3\u8981\u4ece\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\uff08\u89c2\u5bdf\u77e9\u9635\uff09\u8f6c\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5750\u6807\uff0c\u8fd9\u662f\u4fa6\u542c\u5668\u5e94\u8be5\u88ab\u653e\u7f6e\u7684\u4f4d\u7f6e\u3002\u5bf9\u4e8e\u77e9\u9635\uff0c\u53cd\u6bd4\u901a\u5e38\u5c31\u610f\u5473\u7740\u9006\u8f6c\u3002\u4e00\u65e6\u6211\u4eec\u6709\u4e86\u8fd9\u4e2a\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8f6c\u6362 at \u548c up \u5411\u91cf\uff0c\u4f7f\u7528\u8fd9\u4e2a\u77e9\u9635\u8ba1\u7b97\u65b0\u7684\u65b9\u5411\u3002 \u4f46\u662f\uff0c\u5982\u679c\u4f60\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u770b\u5230\u5b9e\u73b0\u7565\u6709\u4e0d\u540c\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\uff1a Vector3f at = new Vector3f(); cameraMatrix.positiveZ(at).negate(); Vector3f up = new Vector3f(); cameraMatrix.positiveY(up); listener.setOrientation(at, up); \u4e0a\u8ff0\u4ee3\u7801\u7b49\u4ef7\u4e8e\u7b2c\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ea\u662f\u4e00\u79cd\u66f4\u9ad8\u6548\u7684\u65b9\u6cd5\u3002\u5b83\u4f7f\u7528\u4e86\u4e00\u79cd\u66f4\u5feb\u7684\u65b9\u6cd5\uff0c\u53ef\u4ee5\u5728 JOML \u5e93\u4e2d\u627e\u5230\uff0c\u8fd9\u79cd\u65b9\u6cd5\u4e0d\u9700\u8981\u8ba1\u7b97\u5b8c\u6574\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u53ef\u4ee5\u5f97\u5230\u76f8\u540c\u7684\u7ed3\u679c\u3002\u8fd9\u65b9\u6cd5\u662f\u7531LWJGL\u8bba\u575b\u4e2d\u7684 JOML\u4f5c\u8005 \u63d0\u4f9b\u7684\uff0c\u56e0\u6b64\u4f60\u53ef\u4ee5\u5728[\u90a3\u91cc]((http://forum.lwjgl.org/index.php?topic=6080.0)\u67e5\u770b\u66f4\u591a\u7ec6\u8282\u3002\u5982\u679c\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u5c06\u770b\u5230 SoundManager \u7c7b\u8ba1\u7b97\u5b83\u81ea\u5df1\u7684\u89c2\u5bdf\u77e9\u9635\u526f\u672c\u3002\u8fd9\u5df2\u7ecf\u5728 Renderer \u7c7b\u4e2d\u5b8c\u6210\u4e86\u3002\u4e3a\u4e86\u4fdd\u6301\u4ee3\u7801\u7b80\u5355\uff0c\u5e76\u907f\u514d\u91cd\u6784\uff0c\u6211\u503e\u5411\u4e8e\u4f7f\u7528\u8fd9\u79cd\u65b9\u5f0f\u3002 \u8fd9\u5c31\u5b8c\u4e86\u3002\u6211\u4eec\u62e5\u6709\u64ad\u653e\u58f0\u97f3\u6240\u9700\u7684\u6240\u6709\u57fa\u7840\u7ed3\u6784\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4e86\u89e3\u5982\u4f55\u4f7f\u7528\u6240\u6709\u4ee3\u7801\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u97f3\u4e50\u662f\u5982\u4f55\u64ad\u653e\u7684\uff0c\u4ee5\u53ca\u4e0d\u540c\u6548\u679c\u7684\u58f0\u97f3\uff08\u8fd9\u4e9b\u6587\u4ef6\u662f\u4ece Freesound \u4e2d\u83b7\u5f97\u7684\uff0c\u8d21\u732e\u8005\u90fd\u50a8\u5b58\u5728\u540d\u4e3aCREDITS.txt\u7684\u4e00\u4e2a\u6587\u4ef6\u4e2d\uff09\u3002\u5982\u679c\u4f60\u83b7\u5f97\u4e00\u4e9b\u5176\u4ed6\u6587\u4ef6\uff0c\u4f60\u53ef\u4ee5\u4f1a\u6ce8\u610f\u5230\u58f0\u97f3\u8870\u51cf\u4e0e\u8ddd\u79bb\u6216\u4fa6\u542c\u5668\u7684\u65b9\u5411\u65e0\u5173\u3002\u8bf7\u68c0\u67e5\u8fd9\u4e9b\u58f0\u97f3\u662f\u5426\u662f\u5355\u58f0\u9053\uff0c\u662f\u5426\u4e0d\u662f\u7acb\u4f53\u58f0\u3002OpenGL\u4ec5\u80fd\u4f7f\u7528\u5355\u58f0\u9053\u58f0\u97f3\u8fdb\u884c\u8ba1\u7b97\u3002 \u540e\u8bb0\uff0cOpenAL\u8fd8\u5141\u8bb8\u4f60\u901a\u8fc7\u4f7f\u7528 alDistanceModel \u5e76\u4f20\u9012\u4f60\u60f3\u4f7f\u7528\u7684\u6a21\u578b\uff08 AL11.AL_EXPONENT_DISTANCE \uff0c AL_EXPONENT_DISTANCE_CLAMP \uff0c\u7b49\u7b49\uff09\u3002\u4f60\u53ef\u4ee5\u7528\u5b83\u4eec\u6765\u64ad\u653e\u5e76\u68c0\u67e5\u6548\u679c\u3002","title":"\u97f3\u9891\uff08Audio\uff09"},{"location":"23-3d-object-picking/","text":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6\uff083D Object Picking\uff09 \u6444\u50cf\u673a\u9009\u53d6 \u6bcf\u4e00\u4e2a\u6e38\u620f\u7684\u5173\u952e\u4e4b\u4e00\u662f\u80fd\u4e0e\u73af\u5883\u4ea4\u4e92\uff0c\u8be5\u529f\u80fd\u8981\u6c42\u80fd\u591f\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u9009\u53d6\u7269\u4f53\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u63a2\u8ba8\u5982\u4f55\u5b9e\u73b0\u8fd9\u4e00\u529f\u80fd\u3002 \u4f46\u662f\uff0c\u5728\u5f00\u59cb\u8bb2\u8ff0\u9009\u53d6\u7269\u4f53\u7684\u6b65\u9aa4\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e00\u79cd\u8868\u793a\u6240\u9009\u7269\u4f53\u7684\u65b9\u6cd5\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6dfb\u52a0\u4e00\u4e2a\u5c5e\u6027\u5230 GameItem \u7c7b\uff0c\u8fd9\u5141\u8bb8\u6211\u4eec\u6807\u8bb0\u9009\u5b9a\u7684\u5bf9\u8c61\uff1a private boolean selected; \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8be5\u503c\u3002\u8ba9\u6211\u4eec\u4ece\u7247\u5143\u7740\u8272\u5668\uff08 scene_fragment.fs \uff09\u5f00\u59cb\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u4ece\u9876\u70b9\u7740\u8272\u5668\u63a5\u6536\u4e00\u4e2a\u6807\u8bb0\uff0c\u8be5\u6807\u8bb0\u5c06\u786e\u5b9a\u8981\u6e32\u67d3\u7684\u7247\u5143\u662f\u5426\u662f\u9009\u5b9a\u7684\u7269\u4f53\u3002 in float outSelected; \u7136\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u7ed3\u5c3e\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u6700\u7ec8\u7684\u7247\u5143\u989c\u8272\uff0c\u5982\u679c\u9009\u4e2d\uff0c\u5219\u5c06\u84dd\u8272\u5206\u91cf\u8bbe\u7f6e\u4e3a 1 . if ( outSelected > 0 ) { fragColor = vec4(fragColor.x, fragColor.y, 1, 1); } \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8be5\u503c\u3002\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\u524d\u9762\u7684\u7ae0\u8282\uff0c\u6211\u4eec\u6709\u4e24\u79cd\u60c5\u51b5\uff1a \u6e32\u67d3\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u6e32\u67d3\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u5728\u7b2c\u4e00\u79cd\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a GameItem \u7684\u6570\u636e\u901a\u8fc7Uniform\u4f20\u9012\uff0c\u56e0\u6b64\u6211\u4eec\u53ea\u9700\u8981\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684Uniform\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b9e\u4f8b\u5316\u5c5e\u6027\u3002\u53ef\u4ee5\u770b\u5230\u4e0b\u8ff0\u4ee3\u7801\u4e2d\u96c6\u6210\u4e86\u4e24\u79cd\u60c5\u51b5\u5230\u9876\u70b9\u7740\u8272\u5668\u3002 layout (location=14) in float selectedInstanced; ... uniform float selectedNonInstanced; ... if ( isInstanced > 0 ) { outSelected = selectedInstanced; ... } else { outSelected = selectedNonInstanced; ... \u65e2\u7136\u5df2\u7ecf\u505a\u597d\u4e86\u57fa\u672c\u51c6\u5907\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u5982\u4f55\u9009\u62e9\u5bf9\u8c61\u3002\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u89c2\u5bdf\u77e9\u9635\u73b0\u5728\u50a8\u5b58\u5728 Camera \u7c7b\u4e2d\u3002\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u6e90\u4ee3\u7801\u4e2d\u7684\u51e0\u4e2a\u7c7b\u91cd\u65b0\u8ba1\u7b97\u4e86\u89c2\u5bdf\u77e9\u9635\uff0c\u6b64\u524d\u5b83\u50a8\u5b58\u5728 Transformation \u548c SoundManager \u7c7b\u4e2d\u3002\u4e3a\u4e86\u8ba1\u7b97\u4ea4\u70b9\uff0c\u6211\u4eec\u5c31\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\u3002\u4e0e\u5176\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\uff0c\u6211\u4eec\u4e0d\u5982\u628a\u5b83\u96c6\u4e2d\u5230 Camera \u7c7b\u4e2d\u3002\u8fd9\u4e00\u66f4\u6539\u8fd8\u9700\u8981\u89c2\u5bdf\u77e9\u9635\u5728\u6e38\u620f\u4e3b\u5faa\u73af\u4e2d\u66f4\u65b0\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7269\u4f53\u9009\u53d6\u7684\u8ba8\u8bba\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4e00\u4e2a\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u9009\u53d6\u5c06\u7531\u6444\u50cf\u673a\u81ea\u52a8\u5730\u5b8c\u6210\uff0c\u5c06\u9009\u62e9\u6444\u50cf\u673a\u6240\u9762\u5bf9\u7684\u6700\u8fd1\u7684\u7269\u4f53\u3002\u8ba9\u6211\u4eec\u8ba8\u8bba\u4e00\u4e0b\u5982\u4f55\u505a\u5230\u5b83\u3002 \u4e0b\u56fe\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u60c5\u51b5\uff1a \u6211\u4eec\u628a\u6444\u50cf\u673a\u653e\u5728\u4e16\u754c\u7a7a\u95f4\u7684\u67d0\u4e2a\u5750\u6807\u4e2d\uff0c\u9762\u671d\u4e00\u4e2a\u7279\u5b9a\u65b9\u5411\u3002\u4efb\u4f55\u4e00\u4e2a\u7269\u4f53\uff0c\u5982\u679c\u5b83\u4e0e\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u524d\u5411\u7684\u5149\u7ebf\u6295\u5c04\uff08Ray Cast\uff09\u76f8\u4ea4\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5019\u9009\u7269\u4f53\u3002\u5728\u6240\u6709\u5019\u9009\u7269\u4f53\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9009\u62e9\u6700\u8fd1\u7684\u4e00\u4e2a\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6e38\u620f\u9879\u662f\u7acb\u65b9\u4f53\uff0c\u56e0\u6b64\u9700\u8981\u8ba1\u7b97\u6444\u50cf\u673a\u7684\u524d\u5411\u5411\u91cf\u4e0e\u7acb\u65b9\u4f53\u7684\u4ea4\u70b9\u3002\u8fd9\u4f3c\u4e4e\u662f\u4e00\u4e2a\u975e\u5e38\u7279\u6b8a\u7684\u60c5\u51b5\uff0c\u4f46\u5b9e\u9645\u4e0a\u662f\u975e\u5e38\u5e38\u89c1\u7684\u3002\u5728\u8bb8\u591a\u6e38\u620f\u4e2d\uff0c\u6e38\u620f\u9879\u90fd\u4e0e\u6240\u8c13\u7684\u8fb9\u754c\u6846\uff08Bounding Box\uff09\u76f8\u5173\u8fde\u3002\u8fb9\u754c\u6846\u662f\u4e00\u4e2a\u77e9\u5f62\u6846\uff0c\u5b83\u56ca\u62ec\u4e86\u8be5\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u3002\u4f8b\u5982\uff0c\u8fb9\u754c\u6846\u4e5f\u7528\u4e8e\u78b0\u649e\u68c0\u6d4b\u3002\u5b9e\u9645\u4e0a\uff0c\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\uff0c\u4f60\u770b\u5230\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u8fd9\u6709\u52a9\u4e8e\u5728\u4efb\u610f\u7ed9\u5b9a\u65f6\u95f4\u8bbe\u7f6e\u8fb9\u754c\u3002 \u63a5\u4e0b\u6765\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a CameraBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u6709\u4e00\u4e2a\u540d\u4e3a selectGameItem \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u6536\u6e38\u620f\u9879\u5217\u8868\u548c\u6444\u50cf\u673a\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void selectGameItem(GameItem[] gameItems, Camera camera) { GameItem selectedGameItem = null; float closestDistance = Float.POSITIVE_INFINITY; dir = camera.getViewMatrix().positiveZ(dir).negate(); for (GameItem gameItem : gameItems) { gameItem.setSelected(false); min.set(gameItem.getPosition()); max.set(gameItem.getPosition()); min.add(-gameItem.getScale(), -gameItem.getScale(), -gameItem.getScale()); max.add(gameItem.getScale(), gameItem.getScale(), gameItem.getScale()); if (Intersectionf.intersectRayAab(camera.getPosition(), dir, min, max, nearFar) && nearFar.x < closestDistance) { closestDistance = nearFar.x; selectedGameItem = gameItem; } } if (selectedGameItem != null) { selectedGameItem.setSelected(true); } } \u8be5\u65b9\u6cd5\u5c06\u8fed\u4ee3\u6e38\u620f\u9879\uff0c\u5c1d\u8bd5\u4ece\u4e2d\u83b7\u53d6\u4e0e\u6444\u50cf\u673a\u5149\u7ebf\u6295\u5c04\u76f8\u4ea4\u7684\u9879\u3002\u5b83\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a closestDistance \u7684\u53d8\u91cf\uff0c\u8be5\u53d8\u91cf\u5c06\u50a8\u5b58\u6700\u8fd1\u7684\u8ddd\u79bb\u3002\u5bf9\u4e8e\u76f8\u4ea4\u7684\u6e38\u620f\u9879\uff0c\u5c06\u8ba1\u7b97\u6444\u50cf\u673a\u5230\u4ea4\u70b9\u7684\u8ddd\u79bb\uff0c\u5982\u679c\u8be5\u8ddd\u79bb\u5c0f\u4e8e\u50a8\u5b58\u5728 closestDistance \u4e2d\u7684\u503c\uff0c\u5219\u8be5\u9879\u5c06\u6210\u4e3a\u65b0\u7684\u5019\u9009\u9879\u3002 \u5728\u8fdb\u5165\u5faa\u73af\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u6444\u50cf\u673a\u6240\u9762\u5411\u7684\u65b9\u5411\u5411\u91cf\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u53ea\u9700\u4f7f\u7528\u89c6\u56fe\u77e9\u9635\u53bb\u83b7\u5f97\u8003\u8651\u76f8\u673a\u65cb\u8f6c\u7684Z\u65b9\u5411\u3002\u8bb0\u4f4f\uff0c\u6b63Z\u6307\u5411\u5c4f\u5e55\u5916\uff0c\u6240\u4ee5\u9700\u8981\u76f8\u53cd\u7684\u65b9\u5411\u5411\u91cf\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u8981\u53cd\u65b9\u5411\uff08 negate \uff09\u3002 \u5728\u6e38\u620f\u5faa\u73af\u4e2d\uff0c\u6bcf\u4e2a GameItem \u90fd\u8981\u8fdb\u884c\u76f8\u4ea4\u8ba1\u7b97\u3002\u4f46\u662f\uff0c\u6211\u4eec\u8be5\u600e\u4e48\u505a\u5462\uff1f\u8fd9\u5c31\u662f JOML \u5e93\u6765\u5e2e\u5fd9\u7684\u5730\u65b9\u4e86\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f JOML \u7684 Intersectionf \u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u51e0\u79cd\u8ba1\u7b97\u4e8c\u7ef4\u548c\u4e09\u7ef4\u4ea4\u70b9\u7684\u65b9\u6cd5\u3002\u5177\u4f53\u6765\u8bf4\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f intersectRayAab \u65b9\u6cd5\u3002 \u8be5\u65b9\u6cd5\u5b9e\u73b0\u4e86\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\uff08Axis Aligned Bounding Box\uff0c\u7b80\u79f0AABB\uff09\u4ea4\u70b9\u68c0\u6d4b\u7b97\u6cd5\u3002\u4f60\u53ef\u4ee5\u67e5\u770bJOML\u6587\u6863\u4e2d\u6307\u51fa\u7684 \u8be6\u7ec6\u4fe1\u606f \u3002 \u8be5\u65b9\u6cd5\u6d4b\u8bd5\u7531\u539f\u70b9\u548c\u65b9\u5411\u5b9a\u4e49\u7684\u5c04\u7ebf\u662f\u5426\u4e0e\u7531\u6700\u5c0f\u548c\u6700\u5927\u5750\u6807\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u76f8\u4ea4\u3002\u8fd9\u4e2a\u7b97\u6cd5\u662f\u6709\u6548\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7acb\u65b9\u4f53\u662f\u8f74\u5bf9\u9f50\u7684\uff0c\u5982\u679c\u65cb\u8f6c\u5b83\u4eec\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c31\u4e0d\u8d77\u4f5c\u7528\u3002\u56e0\u6b64\uff0c\u8be5\u65b9\u6cd5\u63a5\u6536\u4ee5\u4e0b\u53c2\u6570\uff1a \u4e00\u4e2a\u539f\u70b9\uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002 \u4e00\u4e2a\u65b9\u5411\uff1a\u5728\u8fd9\u91cc\u662f\u6444\u50cf\u673a\u7684\u671d\u5411\uff0c\u524d\u5411\u5411\u91cf\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5c0f\u5750\u6807\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7acb\u65b9\u4f53\u4ee5 GameItem \u5750\u6807\u4e3a\u4e2d\u5fc3\uff0c\u6700\u5c0f\u5750\u6807\u662f\u8be5\u5750\u6807\u51cf\u53bb\u6bd4\u4f8b\u3002\uff08\u5728\u5176\u539f\u59cb\u5927\u5c0f\u4e2d\uff0c\u7acb\u65b9\u4f53\u7684\u957f\u5ea6\u4e3a2\uff0c\u6bd4\u4f8b\u4e3a1\uff09\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5927\u5750\u6807\u3002\u4e0d\u8a00\u800c\u55bb\u3002 \u4e00\u4e2a\u7ed3\u679c\u5411\u91cf\u3002\u5b83\u5c06\u50a8\u5b58\u5230\u8fdc\u8fd1\u4ea4\u70b9\u7684\u8ddd\u79bb\uff08\u5bf9\u4e8e\u4e00\u4e2a\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\u548c\u4e00\u6761\u5c04\u7ebf\uff0c\u6700\u591a\u6709\u4e24\u4e2a\u4ea4\u70b9\uff09\u3002 \u5982\u679c\u6709\u4ea4\u70b9\uff0c\u8be5\u65b9\u6cd5\u5c06\u8fd4\u56de true \u3002\u5982\u679c\u4e3a true \uff0c\u6211\u4eec\u5c06\u68c0\u67e5\u6700\u8fd1\u8ddd\u79bb\u5e76\u5728\u5fc5\u8981\u65f6\u66f4\u65b0\u5b83\uff0c\u5e76\u50a8\u5b58\u6240\u9009\u5019\u9009 GameItem \u7684\u5f15\u7528\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8be5\u65b9\u6cd5\u4e2d\u6d89\u53ca\u7684\u6240\u6709\u8981\u7d20\u3002 \u4e00\u65e6\u5faa\u73af\u5b8c\u6210\uff0c\u5019\u9009 GamItem \u5c06\u88ab\u6807\u8bb0\u4e3a\u5df2\u9009\u5b9a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u4e86\u3002 selectGameItem \u5c06\u5728 DummyGame \u7c7b\u7684\u66f4\u65b0\u65b9\u6cd5\u4e2d\u8c03\u7528\uff0c\u540c\u65f6\u8c03\u7528\u7684\u8fd8\u6709\u89c2\u5bdf\u77e9\u9635\u66f4\u65b0\u3002 // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 camera.updateViewMatrix(); // \u66f4\u65b0\u58f0\u97f3\u76d1\u542c\u5668\u4f4d\u7f6e soundMgr.updateListenerPosition(camera); this.selectDetector.selectGameItem(gameItems, camera); \u6b64\u5916\uff0c\u4e00\u4e2a\u5341\u5b57\u7784\u51c6\u7ebf\uff08Cross-hair\uff09\u5df2\u6dfb\u52a0\u5230\u6e32\u67d3\u4e2d\uff0c\u4ee5\u68c0\u67e5\u4e00\u5207\u5de5\u4f5c\u6b63\u5e38\u3002\u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u663e\u7136\uff0c\u8fd9\u91cc\u7ed9\u51fa\u7684\u65b9\u6cd5\u8fdc\u8fdc\u4e0d\u662f\u6700\u4f73\u7684\uff0c\u4f46\u5b83\u5c06\u4e3a\u4f60\u63d0\u4f9b\u57fa\u7840\u77e5\u8bc6\uff0c\u662f\u4f60\u80fd\u591f\u81ea\u5df1\u5f00\u53d1\u66f4\u590d\u6742\u7684\u65b9\u6cd5\u3002\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u5f88\u5bb9\u6613\u88ab\u4e22\u5f03\uff0c\u6bd4\u5982\u6444\u50cf\u673a\u540e\u9762\u7684\u7269\u4f53\uff0c\u56e0\u4e3a\u5b83\u4eec\u4e0d\u4f1a\u76f8\u4ea4\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u4f60\u6362\u53ef\u4ee5\u6839\u636e\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u6765\u786e\u5b9a\u7269\u4f53\uff0c\u4ee5\u52a0\u5feb\u8ba1\u7b97\u901f\u5ea6\u3002\u6b64\u5916\uff0c\u53ea\u6709\u5728\u6444\u50cf\u673a\u79fb\u52a8\u6216\u65cb\u8f6c\u540e\uff0c\u624d\u9700\u8981\u8fdb\u884c\u8ba1\u7b97\u3002 \u9f20\u6807\u9009\u53d6 \u7528\u6444\u50cf\u673a\u9009\u53d6\u7269\u4f53\u5b8c\u6210\u4e86\uff0c\u4f46\u5f53\u6211\u4eec\u60f3\u7528\u9f20\u6807\u81ea\u7531\u9009\u62e9\u7269\u4f53\u600e\u4e48\u529e\uff1f\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5e0c\u671b\u6bcf\u5f53\u7528\u6237\u5355\u51fb\u5c4f\u5e55\u65f6\uff0c\u81ea\u52a8\u9009\u62e9\u6700\u8fd1\u7684\u5bf9\u8c61\u3002 \u5b9e\u73b0\u5b83\u7684\u65b9\u6cd5\u7c7b\u4f3c\u4e8e\u4e0a\u8ff0\u65b9\u6cd5\u3002\u5728\u4e4b\u524d\u7684\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u5e76\u6839\u636e\u6444\u50cf\u673a\u5f53\u524d\u7684\u65b9\u5411\u4f7f\u7528\u201c\u524d\u5411\u201d\u65b9\u5411\u4ece\u6444\u50cf\u673a\u751f\u6210\u5c04\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u4ecd\u9700\u8981\u6295\u5c04\u5e7f\u897f\uff0c\u4f46\u65b9\u5411\u6307\u5411\u4e00\u4e2a\u8fdc\u79bb\u6444\u50cf\u673a\u7684\u70b9\uff0c\u4e5f\u5c31\u662f\u70b9\u51fb\u7684\u70b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u70b9\u51fb\u7684\u5750\u6807\u6765\u8ba1\u7b97\u65b9\u5411\u5411\u91cf\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u5c06\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5462\uff1f\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u5982\u4f55\u4ece\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u4e3a\u4e86\u8fbe\u5230\u8fd9\u4e2a\u76ee\u7684\uff0c\u6240\u5e94\u7528\u7684\u4e0d\u540c\u5750\u6807\u53d8\u6362\u662f\uff1a \u6211\u4eec\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u5c06\u6a21\u578b\u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u3002 \u6211\u4eec\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff08\u63d0\u4f9b\u6444\u50cf\u673a\u529f\u80fd\uff09\u5c06\u4e16\u754c\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u3002 \u6211\u4eec\u901a\u8fc7\u5e94\u7528\u900f\u89c6\u6295\u5f71\u77e9\u9635\u5c06\u89c2\u5bdf\u5750\u6807\u53d8\u6362\u5230\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\uff08Homogeneous Clip Space\uff09\u3002 \u6700\u7ec8\u7684\u5c4f\u5e55\u5750\u6807\u7531OpenGL\u4e3a\u6211\u4eec\u81ea\u52a8\u8ba1\u7b97\u3002\u5728\u6b64\u4e4b\u524d\uff0c\u5b83\u4f20\u9012\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\uff08\u901a\u8fc7\u5c06 x,y,z \u5750\u6807\u9664\u4ee5 w \u5206\u91cf\uff09\uff0c\u7136\u540e\u4f20\u9012\u5230 x,y \u5c4f\u5e55\u5750\u6807\u3002 \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4ece\u5c4f\u5e55\u5750\u6807 (x,y) \u5230\u4e16\u754c\u5750\u6807\uff0c\u9006\u8def\u5f84\u904d\u5386\u3002 \u7b2c\u4e00\u6b65\u662f\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\u3002\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u7684\u8303\u56f4\u662f [0, \u5c4f\u5e55\u5bbd\u5ea6] [0, \u5c4f\u5e55\u9ad8\u5ea6] \u3002\u5c4f\u5e55\u5de6\u4e0a\u89d2\u7684\u5750\u6807\u4e3a (0, 0) \u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3a [-1, 1] \u8303\u56f4\u5185\u7684\u5750\u6807\u3002 \u5f88\u7b80\u5355\u7684\u6570\u5b66\uff1a x = 2 \\cdot screen_x / screenwidth - 1 y = 1 - 2 * screen_y / screenheight \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 z \u5206\u91cf\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u7ed9\u5b83\u5206\u914d -1 \u503c\uff0c\u8fd9\u6837\u5e7f\u897f\u5c31\u53ef\u4ee5\u6307\u5411\u6700\u8fdc\u7684\u53ef\u89c1\u8ddd\u79bb\uff08\u8bf7\u8bb0\u4f4f\uff0c\u5728OpenGL\u4e2d\uff0c -1 \u6307\u5411\u9891\u5e55\uff09\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e86\u5f52\u4e00\u5316\u7ec8\u7aef\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\u3002 \u4e3a\u4e86\u7ee7\u7eed\u53d8\u6362\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u9f50\u6b21\u526a\u5207\u7a7a\u95f4\u3002\u6211\u4eec\u9700\u8981\u6709\u4e00\u4e2a w \u5206\u91cf\uff0c\u5b83\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u3002\u867d\u7136\u8fd9\u4e2a\u6982\u5ff5\u5728\u524d\u51e0\u7ae0\u5df2\u7ecf\u4ecb\u7ecd\u8fc7\u4e86\uff0c\u4f46\u8ba9\u6211\u4eec\u518d\u56de\u987e\u5b83\u3002\u4e3a\u4e86\u8868\u793a\u4e00\u4e2a\u4e09\u7ef4\u70b9\uff0c\u6211\u4eec\u9700\u8981 x \uff0c y \u548c z \u5206\u91cf\uff0c\u4f46\u662f\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u4e00\u4e2a\u989d\u5916\u7684 w \u5206\u91cf\u3002\u6211\u4eec\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\u6765\u4f7f\u7528\u77e9\u9635\u6267\u884c\u4e0d\u540c\u7684\u53d8\u6362\u3002\u6709\u4e9b\u53d8\u5316\u4e0d\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\uff0c\u4f46\u6709\u4e9b\u53d8\u6362\u9700\u8981\u3002\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u53ea\u6709 x \uff0c y \u548c z \u5206\u91cf\uff0c\u90a3\u4e48\u53d8\u6362\u77e9\u9635\u5c31\u4e0d\u80fd\u5de5\u4f5c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86 w \u5206\u91cf\uff0c\u5e76\u4e3a\u5b83\u4eec\u8d4b\u503c\u4e3a 1 \uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u5904\u74064x4\u77e9\u9635\u4e86\u3002 \u6b64\u5916\uff0c\u5927\u591a\u6570\u53d8\u6362\uff0c\u6216\u8005\u66f4\u7cbe\u786e\u5730\u8bf4\uff0c\u5927\u591a\u6570\u53d8\u6362\u77e9\u9635\u90fd\u4e0d\u4f1a\u66f4\u6539 w \u5206\u91cf\u3002\u6295\u5f71\u77e9\u9635\u662f\u4e00\u4e2a\u4f8b\u5916\uff0c\u8be5\u77e9\u9635\u5c06 w \u5206\u91cf\u66f4\u6539\u4e3a\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\u3002 \u901a\u8fc7\u5c06 x \uff0c y \u548c z \u5206\u91cf\u5904\u4ee5 w \uff0c\u5c31\u53ef\u4ee5\u5b9e\u73b0\u4ece\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u5750\u6807\u7684\u8f6c\u6362\u3002\u7531\u4e8e\u8fd9\u4e2a\u5206\u91cf\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\uff0c\u610f\u5473\u7740\u8fdc\u5904\u7684\u7269\u4f53\u88ab\u753b\u5f97\u66f4\u5c0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u9700\u8981\u53cd\u5176\u9053\u800c\u884c\u4e4b\uff0c\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e00\u6b65\uff0c\u53ea\u9700\u8981\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 1 \uff0c\u5e76\u4fdd\u7559\u5176\u5b83\u7ec4\u4ef6\u7684\u539f\u59cb\u503c\u3002 \u6211\u4eec\u73b0\u5728\u9700\u8981\u56de\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u6295\u5f71\u77e9\u9635\u7684\u9006\u77e9\u9635\u5e76\u5c06\u5b83\u4e0e4\u4e2a\u5206\u91cf\u5411\u91cf\u76f8\u4e58\u3002\u5b8c\u6210\u4e4b\u540e\uff0c\u6211\u4eec\u5c31\u9700\u8981\u628a\u5b83\u4eec\u8f6c\u6362\u6210\u4e16\u754c\u7a7a\u95f4\u3002\u540c\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u8ba1\u7b97\u5b83\u7684\u9006\u77e9\u9635\u7136\u540e\u4e58\u4ee5\u5411\u91cf\u3002 \u8bb0\u4f4f\uff0c\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\uff0c\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002\u6211\u4eec\u8fd8\u53ef\u4ee5\u5c06 z \u7ec4\u4ef6\u518d\u6b21\u8bbe\u7f6e\u4e3a -1 \uff0c\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u5b83\u6307\u5411\u9891\u5e55\u3002\u4e00\u65e6\u8fd9\u6837\u505a\u5e76\u5e94\u7528\u9006\u77e9\u9635\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u4e86\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u5411\u91cf\u3002\u6211\u4eec\u8ba1\u7b97\u4e86\u5c04\u7ebf\uff0c\u53ef\u4ee5\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u9009\u53d6\u76f8\u540c\u7684\u7b97\u6cd5\u3002 \u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a MouseBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86\u4e0a\u8ff0\u6b65\u9aa4\u3002\u6b64\u5916\uff0c\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u79fb\u52a8\u5230 Window \u7c7b\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728\u51e0\u4e2a\u5730\u65b9\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u8fd8\u91cd\u6784\u4e86\u4e00\u70b9 CameraBoxSelectionDetector \uff0c\u6240\u4ee5 MouseBoxSelectionDetector \u53ef\u4ee5\u7ee7\u627f\u548c\u4f7f\u7528\u78b0\u649e\u68c0\u6d4b\u65b9\u6cd5\u3002\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5b9e\u73b0\u975e\u5e38\u7b80\u5355\u3002 \u7ed3\u679c\u5982\u4e0b\u6240\u793a\uff1a \u4f60\u53ea\u9700\u7528\u9f20\u6807\u5355\u51fb\u8be5\u65b9\u5757\u5373\u53ef\u8fdb\u884c\u9009\u53d6\u3002 \u4e4b\u540e\u4f60\u53ef\u4ee5\u53c2\u8003\u4e00\u7bc7 \u4f18\u79c0\u6587\u7ae0 \u4e2d\u80cc\u5b8c\u6240\u89e3\u91ca\u7684\u6b65\u9aa4\u7684\u7ec6\u8282\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6d89\u53ca\u4e0d\u540c\u65b9\u6848\u7684\u975e\u5e38\u8be6\u7ec6\u7684\u8bf4\u660e\u3002","title":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6"},{"location":"23-3d-object-picking/#3d-object-picking","text":"","title":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6\uff083D Object Picking\uff09"},{"location":"23-3d-object-picking/#_1","text":"\u6bcf\u4e00\u4e2a\u6e38\u620f\u7684\u5173\u952e\u4e4b\u4e00\u662f\u80fd\u4e0e\u73af\u5883\u4ea4\u4e92\uff0c\u8be5\u529f\u80fd\u8981\u6c42\u80fd\u591f\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u9009\u53d6\u7269\u4f53\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u63a2\u8ba8\u5982\u4f55\u5b9e\u73b0\u8fd9\u4e00\u529f\u80fd\u3002 \u4f46\u662f\uff0c\u5728\u5f00\u59cb\u8bb2\u8ff0\u9009\u53d6\u7269\u4f53\u7684\u6b65\u9aa4\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e00\u79cd\u8868\u793a\u6240\u9009\u7269\u4f53\u7684\u65b9\u6cd5\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6dfb\u52a0\u4e00\u4e2a\u5c5e\u6027\u5230 GameItem \u7c7b\uff0c\u8fd9\u5141\u8bb8\u6211\u4eec\u6807\u8bb0\u9009\u5b9a\u7684\u5bf9\u8c61\uff1a private boolean selected; \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8be5\u503c\u3002\u8ba9\u6211\u4eec\u4ece\u7247\u5143\u7740\u8272\u5668\uff08 scene_fragment.fs \uff09\u5f00\u59cb\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u4ece\u9876\u70b9\u7740\u8272\u5668\u63a5\u6536\u4e00\u4e2a\u6807\u8bb0\uff0c\u8be5\u6807\u8bb0\u5c06\u786e\u5b9a\u8981\u6e32\u67d3\u7684\u7247\u5143\u662f\u5426\u662f\u9009\u5b9a\u7684\u7269\u4f53\u3002 in float outSelected; \u7136\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u7ed3\u5c3e\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u6700\u7ec8\u7684\u7247\u5143\u989c\u8272\uff0c\u5982\u679c\u9009\u4e2d\uff0c\u5219\u5c06\u84dd\u8272\u5206\u91cf\u8bbe\u7f6e\u4e3a 1 . if ( outSelected > 0 ) { fragColor = vec4(fragColor.x, fragColor.y, 1, 1); } \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8be5\u503c\u3002\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\u524d\u9762\u7684\u7ae0\u8282\uff0c\u6211\u4eec\u6709\u4e24\u79cd\u60c5\u51b5\uff1a \u6e32\u67d3\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u6e32\u67d3\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u5728\u7b2c\u4e00\u79cd\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a GameItem \u7684\u6570\u636e\u901a\u8fc7Uniform\u4f20\u9012\uff0c\u56e0\u6b64\u6211\u4eec\u53ea\u9700\u8981\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684Uniform\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b9e\u4f8b\u5316\u5c5e\u6027\u3002\u53ef\u4ee5\u770b\u5230\u4e0b\u8ff0\u4ee3\u7801\u4e2d\u96c6\u6210\u4e86\u4e24\u79cd\u60c5\u51b5\u5230\u9876\u70b9\u7740\u8272\u5668\u3002 layout (location=14) in float selectedInstanced; ... uniform float selectedNonInstanced; ... if ( isInstanced > 0 ) { outSelected = selectedInstanced; ... } else { outSelected = selectedNonInstanced; ... \u65e2\u7136\u5df2\u7ecf\u505a\u597d\u4e86\u57fa\u672c\u51c6\u5907\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u5982\u4f55\u9009\u62e9\u5bf9\u8c61\u3002\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u89c2\u5bdf\u77e9\u9635\u73b0\u5728\u50a8\u5b58\u5728 Camera \u7c7b\u4e2d\u3002\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u6e90\u4ee3\u7801\u4e2d\u7684\u51e0\u4e2a\u7c7b\u91cd\u65b0\u8ba1\u7b97\u4e86\u89c2\u5bdf\u77e9\u9635\uff0c\u6b64\u524d\u5b83\u50a8\u5b58\u5728 Transformation \u548c SoundManager \u7c7b\u4e2d\u3002\u4e3a\u4e86\u8ba1\u7b97\u4ea4\u70b9\uff0c\u6211\u4eec\u5c31\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\u3002\u4e0e\u5176\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\uff0c\u6211\u4eec\u4e0d\u5982\u628a\u5b83\u96c6\u4e2d\u5230 Camera \u7c7b\u4e2d\u3002\u8fd9\u4e00\u66f4\u6539\u8fd8\u9700\u8981\u89c2\u5bdf\u77e9\u9635\u5728\u6e38\u620f\u4e3b\u5faa\u73af\u4e2d\u66f4\u65b0\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7269\u4f53\u9009\u53d6\u7684\u8ba8\u8bba\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4e00\u4e2a\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u9009\u53d6\u5c06\u7531\u6444\u50cf\u673a\u81ea\u52a8\u5730\u5b8c\u6210\uff0c\u5c06\u9009\u62e9\u6444\u50cf\u673a\u6240\u9762\u5bf9\u7684\u6700\u8fd1\u7684\u7269\u4f53\u3002\u8ba9\u6211\u4eec\u8ba8\u8bba\u4e00\u4e0b\u5982\u4f55\u505a\u5230\u5b83\u3002 \u4e0b\u56fe\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u60c5\u51b5\uff1a \u6211\u4eec\u628a\u6444\u50cf\u673a\u653e\u5728\u4e16\u754c\u7a7a\u95f4\u7684\u67d0\u4e2a\u5750\u6807\u4e2d\uff0c\u9762\u671d\u4e00\u4e2a\u7279\u5b9a\u65b9\u5411\u3002\u4efb\u4f55\u4e00\u4e2a\u7269\u4f53\uff0c\u5982\u679c\u5b83\u4e0e\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u524d\u5411\u7684\u5149\u7ebf\u6295\u5c04\uff08Ray Cast\uff09\u76f8\u4ea4\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5019\u9009\u7269\u4f53\u3002\u5728\u6240\u6709\u5019\u9009\u7269\u4f53\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9009\u62e9\u6700\u8fd1\u7684\u4e00\u4e2a\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6e38\u620f\u9879\u662f\u7acb\u65b9\u4f53\uff0c\u56e0\u6b64\u9700\u8981\u8ba1\u7b97\u6444\u50cf\u673a\u7684\u524d\u5411\u5411\u91cf\u4e0e\u7acb\u65b9\u4f53\u7684\u4ea4\u70b9\u3002\u8fd9\u4f3c\u4e4e\u662f\u4e00\u4e2a\u975e\u5e38\u7279\u6b8a\u7684\u60c5\u51b5\uff0c\u4f46\u5b9e\u9645\u4e0a\u662f\u975e\u5e38\u5e38\u89c1\u7684\u3002\u5728\u8bb8\u591a\u6e38\u620f\u4e2d\uff0c\u6e38\u620f\u9879\u90fd\u4e0e\u6240\u8c13\u7684\u8fb9\u754c\u6846\uff08Bounding Box\uff09\u76f8\u5173\u8fde\u3002\u8fb9\u754c\u6846\u662f\u4e00\u4e2a\u77e9\u5f62\u6846\uff0c\u5b83\u56ca\u62ec\u4e86\u8be5\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u3002\u4f8b\u5982\uff0c\u8fb9\u754c\u6846\u4e5f\u7528\u4e8e\u78b0\u649e\u68c0\u6d4b\u3002\u5b9e\u9645\u4e0a\uff0c\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\uff0c\u4f60\u770b\u5230\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u8fd9\u6709\u52a9\u4e8e\u5728\u4efb\u610f\u7ed9\u5b9a\u65f6\u95f4\u8bbe\u7f6e\u8fb9\u754c\u3002 \u63a5\u4e0b\u6765\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a CameraBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u6709\u4e00\u4e2a\u540d\u4e3a selectGameItem \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u6536\u6e38\u620f\u9879\u5217\u8868\u548c\u6444\u50cf\u673a\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void selectGameItem(GameItem[] gameItems, Camera camera) { GameItem selectedGameItem = null; float closestDistance = Float.POSITIVE_INFINITY; dir = camera.getViewMatrix().positiveZ(dir).negate(); for (GameItem gameItem : gameItems) { gameItem.setSelected(false); min.set(gameItem.getPosition()); max.set(gameItem.getPosition()); min.add(-gameItem.getScale(), -gameItem.getScale(), -gameItem.getScale()); max.add(gameItem.getScale(), gameItem.getScale(), gameItem.getScale()); if (Intersectionf.intersectRayAab(camera.getPosition(), dir, min, max, nearFar) && nearFar.x < closestDistance) { closestDistance = nearFar.x; selectedGameItem = gameItem; } } if (selectedGameItem != null) { selectedGameItem.setSelected(true); } } \u8be5\u65b9\u6cd5\u5c06\u8fed\u4ee3\u6e38\u620f\u9879\uff0c\u5c1d\u8bd5\u4ece\u4e2d\u83b7\u53d6\u4e0e\u6444\u50cf\u673a\u5149\u7ebf\u6295\u5c04\u76f8\u4ea4\u7684\u9879\u3002\u5b83\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a closestDistance \u7684\u53d8\u91cf\uff0c\u8be5\u53d8\u91cf\u5c06\u50a8\u5b58\u6700\u8fd1\u7684\u8ddd\u79bb\u3002\u5bf9\u4e8e\u76f8\u4ea4\u7684\u6e38\u620f\u9879\uff0c\u5c06\u8ba1\u7b97\u6444\u50cf\u673a\u5230\u4ea4\u70b9\u7684\u8ddd\u79bb\uff0c\u5982\u679c\u8be5\u8ddd\u79bb\u5c0f\u4e8e\u50a8\u5b58\u5728 closestDistance \u4e2d\u7684\u503c\uff0c\u5219\u8be5\u9879\u5c06\u6210\u4e3a\u65b0\u7684\u5019\u9009\u9879\u3002 \u5728\u8fdb\u5165\u5faa\u73af\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u6444\u50cf\u673a\u6240\u9762\u5411\u7684\u65b9\u5411\u5411\u91cf\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u53ea\u9700\u4f7f\u7528\u89c6\u56fe\u77e9\u9635\u53bb\u83b7\u5f97\u8003\u8651\u76f8\u673a\u65cb\u8f6c\u7684Z\u65b9\u5411\u3002\u8bb0\u4f4f\uff0c\u6b63Z\u6307\u5411\u5c4f\u5e55\u5916\uff0c\u6240\u4ee5\u9700\u8981\u76f8\u53cd\u7684\u65b9\u5411\u5411\u91cf\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u8981\u53cd\u65b9\u5411\uff08 negate \uff09\u3002 \u5728\u6e38\u620f\u5faa\u73af\u4e2d\uff0c\u6bcf\u4e2a GameItem \u90fd\u8981\u8fdb\u884c\u76f8\u4ea4\u8ba1\u7b97\u3002\u4f46\u662f\uff0c\u6211\u4eec\u8be5\u600e\u4e48\u505a\u5462\uff1f\u8fd9\u5c31\u662f JOML \u5e93\u6765\u5e2e\u5fd9\u7684\u5730\u65b9\u4e86\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f JOML \u7684 Intersectionf \u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u51e0\u79cd\u8ba1\u7b97\u4e8c\u7ef4\u548c\u4e09\u7ef4\u4ea4\u70b9\u7684\u65b9\u6cd5\u3002\u5177\u4f53\u6765\u8bf4\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f intersectRayAab \u65b9\u6cd5\u3002 \u8be5\u65b9\u6cd5\u5b9e\u73b0\u4e86\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\uff08Axis Aligned Bounding Box\uff0c\u7b80\u79f0AABB\uff09\u4ea4\u70b9\u68c0\u6d4b\u7b97\u6cd5\u3002\u4f60\u53ef\u4ee5\u67e5\u770bJOML\u6587\u6863\u4e2d\u6307\u51fa\u7684 \u8be6\u7ec6\u4fe1\u606f \u3002 \u8be5\u65b9\u6cd5\u6d4b\u8bd5\u7531\u539f\u70b9\u548c\u65b9\u5411\u5b9a\u4e49\u7684\u5c04\u7ebf\u662f\u5426\u4e0e\u7531\u6700\u5c0f\u548c\u6700\u5927\u5750\u6807\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u76f8\u4ea4\u3002\u8fd9\u4e2a\u7b97\u6cd5\u662f\u6709\u6548\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7acb\u65b9\u4f53\u662f\u8f74\u5bf9\u9f50\u7684\uff0c\u5982\u679c\u65cb\u8f6c\u5b83\u4eec\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c31\u4e0d\u8d77\u4f5c\u7528\u3002\u56e0\u6b64\uff0c\u8be5\u65b9\u6cd5\u63a5\u6536\u4ee5\u4e0b\u53c2\u6570\uff1a \u4e00\u4e2a\u539f\u70b9\uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002 \u4e00\u4e2a\u65b9\u5411\uff1a\u5728\u8fd9\u91cc\u662f\u6444\u50cf\u673a\u7684\u671d\u5411\uff0c\u524d\u5411\u5411\u91cf\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5c0f\u5750\u6807\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7acb\u65b9\u4f53\u4ee5 GameItem \u5750\u6807\u4e3a\u4e2d\u5fc3\uff0c\u6700\u5c0f\u5750\u6807\u662f\u8be5\u5750\u6807\u51cf\u53bb\u6bd4\u4f8b\u3002\uff08\u5728\u5176\u539f\u59cb\u5927\u5c0f\u4e2d\uff0c\u7acb\u65b9\u4f53\u7684\u957f\u5ea6\u4e3a2\uff0c\u6bd4\u4f8b\u4e3a1\uff09\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5927\u5750\u6807\u3002\u4e0d\u8a00\u800c\u55bb\u3002 \u4e00\u4e2a\u7ed3\u679c\u5411\u91cf\u3002\u5b83\u5c06\u50a8\u5b58\u5230\u8fdc\u8fd1\u4ea4\u70b9\u7684\u8ddd\u79bb\uff08\u5bf9\u4e8e\u4e00\u4e2a\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\u548c\u4e00\u6761\u5c04\u7ebf\uff0c\u6700\u591a\u6709\u4e24\u4e2a\u4ea4\u70b9\uff09\u3002 \u5982\u679c\u6709\u4ea4\u70b9\uff0c\u8be5\u65b9\u6cd5\u5c06\u8fd4\u56de true \u3002\u5982\u679c\u4e3a true \uff0c\u6211\u4eec\u5c06\u68c0\u67e5\u6700\u8fd1\u8ddd\u79bb\u5e76\u5728\u5fc5\u8981\u65f6\u66f4\u65b0\u5b83\uff0c\u5e76\u50a8\u5b58\u6240\u9009\u5019\u9009 GameItem \u7684\u5f15\u7528\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8be5\u65b9\u6cd5\u4e2d\u6d89\u53ca\u7684\u6240\u6709\u8981\u7d20\u3002 \u4e00\u65e6\u5faa\u73af\u5b8c\u6210\uff0c\u5019\u9009 GamItem \u5c06\u88ab\u6807\u8bb0\u4e3a\u5df2\u9009\u5b9a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u4e86\u3002 selectGameItem \u5c06\u5728 DummyGame \u7c7b\u7684\u66f4\u65b0\u65b9\u6cd5\u4e2d\u8c03\u7528\uff0c\u540c\u65f6\u8c03\u7528\u7684\u8fd8\u6709\u89c2\u5bdf\u77e9\u9635\u66f4\u65b0\u3002 // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 camera.updateViewMatrix(); // \u66f4\u65b0\u58f0\u97f3\u76d1\u542c\u5668\u4f4d\u7f6e soundMgr.updateListenerPosition(camera); this.selectDetector.selectGameItem(gameItems, camera); \u6b64\u5916\uff0c\u4e00\u4e2a\u5341\u5b57\u7784\u51c6\u7ebf\uff08Cross-hair\uff09\u5df2\u6dfb\u52a0\u5230\u6e32\u67d3\u4e2d\uff0c\u4ee5\u68c0\u67e5\u4e00\u5207\u5de5\u4f5c\u6b63\u5e38\u3002\u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u663e\u7136\uff0c\u8fd9\u91cc\u7ed9\u51fa\u7684\u65b9\u6cd5\u8fdc\u8fdc\u4e0d\u662f\u6700\u4f73\u7684\uff0c\u4f46\u5b83\u5c06\u4e3a\u4f60\u63d0\u4f9b\u57fa\u7840\u77e5\u8bc6\uff0c\u662f\u4f60\u80fd\u591f\u81ea\u5df1\u5f00\u53d1\u66f4\u590d\u6742\u7684\u65b9\u6cd5\u3002\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u5f88\u5bb9\u6613\u88ab\u4e22\u5f03\uff0c\u6bd4\u5982\u6444\u50cf\u673a\u540e\u9762\u7684\u7269\u4f53\uff0c\u56e0\u4e3a\u5b83\u4eec\u4e0d\u4f1a\u76f8\u4ea4\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u4f60\u6362\u53ef\u4ee5\u6839\u636e\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u6765\u786e\u5b9a\u7269\u4f53\uff0c\u4ee5\u52a0\u5feb\u8ba1\u7b97\u901f\u5ea6\u3002\u6b64\u5916\uff0c\u53ea\u6709\u5728\u6444\u50cf\u673a\u79fb\u52a8\u6216\u65cb\u8f6c\u540e\uff0c\u624d\u9700\u8981\u8fdb\u884c\u8ba1\u7b97\u3002","title":"\u6444\u50cf\u673a\u9009\u53d6"},{"location":"23-3d-object-picking/#_2","text":"\u7528\u6444\u50cf\u673a\u9009\u53d6\u7269\u4f53\u5b8c\u6210\u4e86\uff0c\u4f46\u5f53\u6211\u4eec\u60f3\u7528\u9f20\u6807\u81ea\u7531\u9009\u62e9\u7269\u4f53\u600e\u4e48\u529e\uff1f\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5e0c\u671b\u6bcf\u5f53\u7528\u6237\u5355\u51fb\u5c4f\u5e55\u65f6\uff0c\u81ea\u52a8\u9009\u62e9\u6700\u8fd1\u7684\u5bf9\u8c61\u3002 \u5b9e\u73b0\u5b83\u7684\u65b9\u6cd5\u7c7b\u4f3c\u4e8e\u4e0a\u8ff0\u65b9\u6cd5\u3002\u5728\u4e4b\u524d\u7684\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u5e76\u6839\u636e\u6444\u50cf\u673a\u5f53\u524d\u7684\u65b9\u5411\u4f7f\u7528\u201c\u524d\u5411\u201d\u65b9\u5411\u4ece\u6444\u50cf\u673a\u751f\u6210\u5c04\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u4ecd\u9700\u8981\u6295\u5c04\u5e7f\u897f\uff0c\u4f46\u65b9\u5411\u6307\u5411\u4e00\u4e2a\u8fdc\u79bb\u6444\u50cf\u673a\u7684\u70b9\uff0c\u4e5f\u5c31\u662f\u70b9\u51fb\u7684\u70b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u70b9\u51fb\u7684\u5750\u6807\u6765\u8ba1\u7b97\u65b9\u5411\u5411\u91cf\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u5c06\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5462\uff1f\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u5982\u4f55\u4ece\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u4e3a\u4e86\u8fbe\u5230\u8fd9\u4e2a\u76ee\u7684\uff0c\u6240\u5e94\u7528\u7684\u4e0d\u540c\u5750\u6807\u53d8\u6362\u662f\uff1a \u6211\u4eec\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u5c06\u6a21\u578b\u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u3002 \u6211\u4eec\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff08\u63d0\u4f9b\u6444\u50cf\u673a\u529f\u80fd\uff09\u5c06\u4e16\u754c\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u3002 \u6211\u4eec\u901a\u8fc7\u5e94\u7528\u900f\u89c6\u6295\u5f71\u77e9\u9635\u5c06\u89c2\u5bdf\u5750\u6807\u53d8\u6362\u5230\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\uff08Homogeneous Clip Space\uff09\u3002 \u6700\u7ec8\u7684\u5c4f\u5e55\u5750\u6807\u7531OpenGL\u4e3a\u6211\u4eec\u81ea\u52a8\u8ba1\u7b97\u3002\u5728\u6b64\u4e4b\u524d\uff0c\u5b83\u4f20\u9012\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\uff08\u901a\u8fc7\u5c06 x,y,z \u5750\u6807\u9664\u4ee5 w \u5206\u91cf\uff09\uff0c\u7136\u540e\u4f20\u9012\u5230 x,y \u5c4f\u5e55\u5750\u6807\u3002 \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4ece\u5c4f\u5e55\u5750\u6807 (x,y) \u5230\u4e16\u754c\u5750\u6807\uff0c\u9006\u8def\u5f84\u904d\u5386\u3002 \u7b2c\u4e00\u6b65\u662f\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\u3002\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u7684\u8303\u56f4\u662f [0, \u5c4f\u5e55\u5bbd\u5ea6] [0, \u5c4f\u5e55\u9ad8\u5ea6] \u3002\u5c4f\u5e55\u5de6\u4e0a\u89d2\u7684\u5750\u6807\u4e3a (0, 0) \u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3a [-1, 1] \u8303\u56f4\u5185\u7684\u5750\u6807\u3002 \u5f88\u7b80\u5355\u7684\u6570\u5b66\uff1a x = 2 \\cdot screen_x / screenwidth - 1 y = 1 - 2 * screen_y / screenheight \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 z \u5206\u91cf\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u7ed9\u5b83\u5206\u914d -1 \u503c\uff0c\u8fd9\u6837\u5e7f\u897f\u5c31\u53ef\u4ee5\u6307\u5411\u6700\u8fdc\u7684\u53ef\u89c1\u8ddd\u79bb\uff08\u8bf7\u8bb0\u4f4f\uff0c\u5728OpenGL\u4e2d\uff0c -1 \u6307\u5411\u9891\u5e55\uff09\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e86\u5f52\u4e00\u5316\u7ec8\u7aef\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\u3002 \u4e3a\u4e86\u7ee7\u7eed\u53d8\u6362\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u9f50\u6b21\u526a\u5207\u7a7a\u95f4\u3002\u6211\u4eec\u9700\u8981\u6709\u4e00\u4e2a w \u5206\u91cf\uff0c\u5b83\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u3002\u867d\u7136\u8fd9\u4e2a\u6982\u5ff5\u5728\u524d\u51e0\u7ae0\u5df2\u7ecf\u4ecb\u7ecd\u8fc7\u4e86\uff0c\u4f46\u8ba9\u6211\u4eec\u518d\u56de\u987e\u5b83\u3002\u4e3a\u4e86\u8868\u793a\u4e00\u4e2a\u4e09\u7ef4\u70b9\uff0c\u6211\u4eec\u9700\u8981 x \uff0c y \u548c z \u5206\u91cf\uff0c\u4f46\u662f\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u4e00\u4e2a\u989d\u5916\u7684 w \u5206\u91cf\u3002\u6211\u4eec\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\u6765\u4f7f\u7528\u77e9\u9635\u6267\u884c\u4e0d\u540c\u7684\u53d8\u6362\u3002\u6709\u4e9b\u53d8\u5316\u4e0d\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\uff0c\u4f46\u6709\u4e9b\u53d8\u6362\u9700\u8981\u3002\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u53ea\u6709 x \uff0c y \u548c z \u5206\u91cf\uff0c\u90a3\u4e48\u53d8\u6362\u77e9\u9635\u5c31\u4e0d\u80fd\u5de5\u4f5c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86 w \u5206\u91cf\uff0c\u5e76\u4e3a\u5b83\u4eec\u8d4b\u503c\u4e3a 1 \uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u5904\u74064x4\u77e9\u9635\u4e86\u3002 \u6b64\u5916\uff0c\u5927\u591a\u6570\u53d8\u6362\uff0c\u6216\u8005\u66f4\u7cbe\u786e\u5730\u8bf4\uff0c\u5927\u591a\u6570\u53d8\u6362\u77e9\u9635\u90fd\u4e0d\u4f1a\u66f4\u6539 w \u5206\u91cf\u3002\u6295\u5f71\u77e9\u9635\u662f\u4e00\u4e2a\u4f8b\u5916\uff0c\u8be5\u77e9\u9635\u5c06 w \u5206\u91cf\u66f4\u6539\u4e3a\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\u3002 \u901a\u8fc7\u5c06 x \uff0c y \u548c z \u5206\u91cf\u5904\u4ee5 w \uff0c\u5c31\u53ef\u4ee5\u5b9e\u73b0\u4ece\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u5750\u6807\u7684\u8f6c\u6362\u3002\u7531\u4e8e\u8fd9\u4e2a\u5206\u91cf\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\uff0c\u610f\u5473\u7740\u8fdc\u5904\u7684\u7269\u4f53\u88ab\u753b\u5f97\u66f4\u5c0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u9700\u8981\u53cd\u5176\u9053\u800c\u884c\u4e4b\uff0c\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e00\u6b65\uff0c\u53ea\u9700\u8981\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 1 \uff0c\u5e76\u4fdd\u7559\u5176\u5b83\u7ec4\u4ef6\u7684\u539f\u59cb\u503c\u3002 \u6211\u4eec\u73b0\u5728\u9700\u8981\u56de\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u6295\u5f71\u77e9\u9635\u7684\u9006\u77e9\u9635\u5e76\u5c06\u5b83\u4e0e4\u4e2a\u5206\u91cf\u5411\u91cf\u76f8\u4e58\u3002\u5b8c\u6210\u4e4b\u540e\uff0c\u6211\u4eec\u5c31\u9700\u8981\u628a\u5b83\u4eec\u8f6c\u6362\u6210\u4e16\u754c\u7a7a\u95f4\u3002\u540c\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u8ba1\u7b97\u5b83\u7684\u9006\u77e9\u9635\u7136\u540e\u4e58\u4ee5\u5411\u91cf\u3002 \u8bb0\u4f4f\uff0c\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\uff0c\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002\u6211\u4eec\u8fd8\u53ef\u4ee5\u5c06 z \u7ec4\u4ef6\u518d\u6b21\u8bbe\u7f6e\u4e3a -1 \uff0c\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u5b83\u6307\u5411\u9891\u5e55\u3002\u4e00\u65e6\u8fd9\u6837\u505a\u5e76\u5e94\u7528\u9006\u77e9\u9635\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u4e86\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u5411\u91cf\u3002\u6211\u4eec\u8ba1\u7b97\u4e86\u5c04\u7ebf\uff0c\u53ef\u4ee5\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u9009\u53d6\u76f8\u540c\u7684\u7b97\u6cd5\u3002 \u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a MouseBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86\u4e0a\u8ff0\u6b65\u9aa4\u3002\u6b64\u5916\uff0c\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u79fb\u52a8\u5230 Window \u7c7b\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728\u51e0\u4e2a\u5730\u65b9\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u8fd8\u91cd\u6784\u4e86\u4e00\u70b9 CameraBoxSelectionDetector \uff0c\u6240\u4ee5 MouseBoxSelectionDetector \u53ef\u4ee5\u7ee7\u627f\u548c\u4f7f\u7528\u78b0\u649e\u68c0\u6d4b\u65b9\u6cd5\u3002\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5b9e\u73b0\u975e\u5e38\u7b80\u5355\u3002 \u7ed3\u679c\u5982\u4e0b\u6240\u793a\uff1a \u4f60\u53ea\u9700\u7528\u9f20\u6807\u5355\u51fb\u8be5\u65b9\u5757\u5373\u53ef\u8fdb\u884c\u9009\u53d6\u3002 \u4e4b\u540e\u4f60\u53ef\u4ee5\u53c2\u8003\u4e00\u7bc7 \u4f18\u79c0\u6587\u7ae0 \u4e2d\u80cc\u5b8c\u6240\u89e3\u91ca\u7684\u6b65\u9aa4\u7684\u7ec6\u8282\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6d89\u53ca\u4e0d\u540c\u65b9\u6848\u7684\u975e\u5e38\u8be6\u7ec6\u7684\u8bf4\u660e\u3002","title":"\u9f20\u6807\u9009\u53d6"},{"location":"24-hud-revisited/","text":"\u56de\u987eHUD - NanoVG\uff08HUD Revisited - NanoVG\uff09 \u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u8bb2\u89e3\u4e86\u5982\u4f55\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u5728\u573a\u666f\u9876\u90e8\u521b\u5efa\u4e00\u4e2aHUD\u4ee5\u6e32\u67d3\u56fe\u5f62\u548c\u7eb9\u7406\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 NanoVG \u5e93\u6765\u6e32\u67d3\u6297\u952f\u9f7f\u77e2\u91cf\u56fe\u5f62\uff0c\u4ece\u800c\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u521b\u5efa\u66f4\u590d\u6742\u7684HUD\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528\u8bb8\u591a\u5176\u4ed6\u5e93\u6765\u5b8c\u6210\u6b64\u4e8b\uff0c\u4f8b\u5982 Nifty GUI \uff0c Nuklear \u7b49\u3002\u5728\u672c\u7ae0\u662f\uff0c\u6211\u4eec\u5c06\u91cd\u70b9\u4ecb\u7ecdNanoVG\uff0c\u56e0\u4e3a\u5b83\u4f7f\u7528\u8d77\u6765\u975e\u5e38\u7b80\u5355\uff0c\u4f46\u662f\u5982\u679c\u4f60\u5e0c\u671b\u5f00\u53d1\u53ef\u4e0e\u6309\u94ae\u3001\u83dc\u5355\u548c\u7a97\u53e3\u4ea4\u4e92\u7684\u590d\u6742GUI\uff0c\u90a3\u4f60\u53ef\u80fd\u9700\u8981\u7684\u662f Nifty GUI \u3002 \u4f7f\u7528 NanoVG \u9996\u5148\u662f\u8981\u5728 pom.xml \u6587\u4ef6\u4e2d\u6dfb\u52a0\u4f9d\u8d56\u9879\uff08\u4e00\u4e2a\u662f\u7528\u4e8e\u7f16\u8bd1\u65f6\u6240\u9700\u7684\u4f9d\u8d56\u9879\uff0c\u53e6\u4e00\u4e2a\u662f\u7528\u4e8e\u8fd0\u884c\u65f6\u6240\u9700\u7684\u672c\u5730\u4ee3\u7801\uff09\uff1a ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> </dependency> ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u5f00\u59cb\u4f7f\u7528 NanoVG \u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u5728OpenGL\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u4ee5\u4fbf\u793a\u4f8b\u80fd\u591f\u6b63\u5e38\u5de5\u4f5c\u3002\u6211\u4eec\u9700\u8981\u542f\u7528\u5bf9\u6a21\u677f\u6d4b\u8bd5\uff08Stencil Test\uff09\u7684\u652f\u6301\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u8bb2\u89e3\u4e86\u989c\u8272\u548c\u6df1\u5ea6\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u63d0\u5230\u6a21\u677f\u7f13\u51b2\u533a\u3002\u8be5\u7f13\u51b2\u533a\u4e3a\u7528\u4e8e\u63a7\u5236\u5e94\u7ed8\u5236\u54ea\u4e9b\u50cf\u7d20\u7684\u6bcf\u4e2a\u50cf\u7d20\u50a8\u5b58\u4e00\u4e2a\u503c\uff08\u6574\u6570\uff09\uff0c\u7528\u4e8e\u6839\u636e\u50a8\u5b58\u7684\u503c\u4ee5\u5c4f\u853d\u6216\u653e\u5f03\u7ed8\u56fe\u533a\u57df\u3002\u4f8b\u5982\uff0c\u5b83\u53ef\u4ee5\u7528\u6765\u4ee5\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u5f0f\u5207\u5272\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u6b64\u884c\u6dfb\u52a0\u5230 Window \u7c7b\u4e2d\u6765\u542f\u7528\u6a21\u677f\u6d4b\u8bd5\uff08\u5728\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4e4b\u540e\uff09\uff1a glEnable(GL_STENCIL_TEST); \u56e0\u4e3a\u6211\u4eec\u4f7f\u7528\u7684\u662f\u53e6\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u6240\u4ee5\u5728\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u6ce8\u610f\u5220\u9664\u5b83\u7684\u503c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u7684 clear \u65b9\u6cd5\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT); } \u6211\u4eec\u8fd8\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u7a97\u53e3\u9009\u9879\u6765\u6fc0\u6d3b\u6297\u952f\u9f7f\uff08Anti-aliasing\uff09\u3002\u56e0\u6b64\uff0c\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u542f\u7528\u5b83\uff1a if (opts.antialiasing) { glfwWindowHint(GLFW_SAMPLES, 4); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 NanoVG \u5e93\u4e86\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5220\u6389\u6211\u4eec\u521b\u5efa\u7684HUD\u4ee3\u7801\uff0c\u5373\u7740\u8272\u5668\uff0c IHud \u63a5\u53e3\uff0c Renderer \u7c7b\u4e2d\u7684HUD\u6e32\u67d3\u65b9\u6cd5\u7b49\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u65b0\u7684 Hud \u7c7b\u5c06\u8d1f\u8d23\u5176\u6e32\u67d3\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u9700\u8981\u5c06\u5176\u59d4\u6258\u7ed9 Renderer \u7c7b\u3002\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u8fd9\u4e2a\u7c7b\uff0c\u5b83\u5c06\u6709\u4e00\u4e2a init \u65b9\u6cd5\u6765\u8bbe\u7f6e\u5e93\u548c\u6784\u5efaHUD\u6240\u9700\u8981\u7684\u8d44\u6e90\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void init(Window window) throws Exception { this.vg = window.getOptions().antialiasing ? nvgCreate(NVG_ANTIALIAS | NVG_STENCIL_STROKES) : nvgCreate(NVG_STENCIL_STROKES); if (this.vg == NULL) { throw new Exception(\"Could not init nanovg\"); } fontBuffer = Utils.ioResourceToByteBuffer(\"/fonts/OpenSans-Bold.ttf\", 150 * 1024); int font = nvgCreateFontMem(vg, FONT_NAME, fontBuffer, 0); if (font == -1) { throw new Exception(\"Could not add font\"); } colour = NVGColor.create(); posx = MemoryUtil.memAllocDouble(1); posy = MemoryUtil.memAllocDouble(1); counter = 0; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2aNanoVG\u4e0a\u4e0b\u6587\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL3.0\u540e\u7aef\uff0c\u56e0\u6b64\u6211\u4eec\u5f15\u7528\u7684\u662f org.lwjgl.nanovg.NanoVGGL3 \u547d\u540d\u7a7a\u95f4\u3002\u5982\u679c\u6297\u952f\u9f7f\u88ab\u542f\u7528\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e NVG_ANTIALIAS \u6807\u5fd7\u3002 \u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u4f7f\u7528\u6b64\u524d\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\u7684TrueType\u5b57\u4f53\u6765\u521b\u5efa\u5b57\u4f53\u3002\u6211\u4eec\u4e3a\u5b83\u6307\u5b9a\u4e00\u4e2a\u540d\u8bcd\uff0c\u4ee5\u4fbf\u7a0d\u540e\u5728\u6e32\u67d3\u6587\u672c\u65f6\u4f7f\u7528\u5b83\u3002\u5173\u4e8e\u8fd9\u70b9\uff0c\u4e00\u4ef6\u5f88\u91cd\u8981\u7684\u4e8b\u60c5\u662f\u7528\u4e8e\u52a0\u8f7d\u5b57\u4f53\u7684 ByteBuffer \u5fc5\u987b\u5728\u4f7f\u7528\u5b57\u4f53\u65f6\u50a8\u5b58\u5728\u5185\u5b58\u4e2d\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u4e0d\u80fd\u88ab\u56de\u6536\uff0c\u5426\u5219\u4f60\u5c06\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u6838\u5fc3\u5d29\u6e83\u3002\u8fd9\u5c31\u662f\u5c06\u5b83\u50a8\u5b58\u4e3a\u7c7b\u5c5e\u6027\u7684\u539f\u56e0\u3002 \u7136\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e00\u4e2a\u989c\u8272\u5b9e\u4f8b\u548c\u4e00\u4e9b\u6709\u7528\u7684\u53d8\u91cf\uff0c\u8fd9\u4e9b\u53d8\u91cf\u5c06\u5728\u6e32\u67d3\u65f6\u4f7f\u7528\u3002\u5728\u521d\u59cb\u5316\u6e32\u67d3\u4e4b\u524d\uff0c\u5728\u6e38\u620f\u521d\u59cb\u5316\u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a @Override public void init(Window window) throws Exception { hud.init(window); renderer.init(window); ... Hud \u7c7b\u8fd8\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5e94\u5728\u6e32\u67d3\u573a\u666f\u540e\u8c03\u7528\uff0c\u4ee5\u4fbf\u5728\u5176\u4e0a\u7ed8\u5236Hud\u3002 @Override public void render(Window window) { renderer.render(window, camera, scene); hud.render(window); } Hud\u7c7b\u7684 render \u65b9\u6cd5\u7684\u5f00\u5934\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window) { nvgBeginFrame(vg, window.getWidth(), window.getHeight(), 1); \u9996\u5148\u5fc5\u987b\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 nvgBeginFrame \u65b9\u6cd5\u3002\u6240\u6709NanoVG\u6e32\u67d3\u64cd\u4f5c\u90fd\u5fc5\u987b\u4fdd\u62a4\u5728 nvgBeginFrame \u548c nvgEndFrame \u8c03\u7528\u4e4b\u95f4\u3002 nvgBeginFrame \u63a5\u53d7\u4ee5\u4e0b\u53c2\u6570\uff1a NanoVG\u73af\u5883 \u8981\u6e32\u67d3\u7684\u7a97\u53e3\u7684\u5927\u5c0f\uff08\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff09\u3002 \u50cf\u7d20\u6bd4\u3002\u5982\u679c\u9700\u8981\u652f\u6301Hi-DPI\uff0c\u53ef\u4ee5\u4fee\u6539\u6b64\u503c\u3002\u5bf9\u4e8e\u672c\u4f8b\uff0c\u6211\u4eec\u53ea\u5c06\u5176\u8bbe\u7f6e\u4e3a1\u3002 \u7136\u540e\u6211\u4eec\u521b\u5efa\u4e86\u51e0\u4e2a\u5360\u636e\u6574\u4e2a\u5c4f\u5e55\u7684\u8272\u5e26\u3002\u7b2c\u4e00\u6761\u662f\u8fd9\u6837\u7ed8\u5236\u7684\uff1a // \u4e0a\u8272\u5e26 nvgBeginPath(vg); nvgRect(vg, 0, window.getHeight() - 100, window.getWidth(), 50); nvgFillColor(vg, rgba(0x23, 0xa1, 0xf1, 200, colour)); nvgFill(vg); \u6e32\u67d3\u56fe\u5f62\u65f6\uff0c\u5e94\u8c03\u7528\u7684\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f nvgBeginPath \uff0c\u5b83\u6307\u793aNanoVG\u5f00\u59cb\u7ed8\u5236\u65b0\u56fe\u5f62\u3002\u7136\u540e\u5b9a\u4e49\u8981\u7ed8\u5236\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u77e9\u5f62\uff0c\u586b\u5145\u989c\u8272\u5e76\u901a\u8fc7\u8c03\u7528 nvgFill \u7ed8\u5236\u5b83\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u7684\u5176\u4ed6\u90e8\u5206\uff0c\u4ee5\u4e86\u89e3\u5176\u4f59\u56fe\u5f62\u662f\u5982\u4f55\u7ed8\u5236\u7684\u3002\u5f53\u6e32\u67d3\u6587\u672c\u662f\uff0c\u4e0d\u9700\u8981\u5728\u6e32\u67d3\u524d\u8c03\u7528 nvgBeginPath \u3002 \u5b8c\u6210\u6240\u6709\u56fe\u5f62\u7684\u7ed8\u5236\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8c03\u7528 nvgEndFrame \u6765\u7ed3\u675f\u6e32\u67d3\uff0c\u4f46\u5728\u79bb\u5f00\u65b9\u6cd5\u4e4b\u524d\u8fd8\u6709\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u60c5\u8981\u505a\u3002\u6211\u4eec\u5fc5\u987b\u6062\u590dOpenGL\u72b6\u6001\uff0cNanoVG\u4fee\u6539OpenGL\u4ee5\u6267\u884c\u5176\u64cd\u4f5c\uff0c\u5982\u679c\u72b6\u6001\u672a\u6b63\u786e\u8fd8\u539f\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u573a\u666f\u6ca1\u6709\u6b63\u786e\u6e32\u67d3\uff0c\u751a\u81f3\u88ab\u64e6\u9664\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6062\u590d\u6e32\u67d3\u6240\u9700\u7684\u76f8\u5173OpenGL\u72b6\u6001\u3002\u8fd9\u662f\u59d4\u6d3e\u5230 Window \u7c7b\u4e2d\u7684\uff1a // \u8fd8\u539f\u72b6\u6001 window.restoreState(); \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void restoreState() { glEnable(GL_DEPTH_TEST); glEnable(GL_STENCIL_TEST); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); if (opts.cullFace) { glEnable(GL_CULL_FACE); glCullFace(GL_BACK); } } \u8fd9\u5c31\u5b8c\u4e8b\u4e86\uff08\u9664\u4e86\u4e00\u4e9b\u5176\u5b83\u7684\u6e05\u7406\u65b9\u6cd5\uff09\uff0c\u4ee3\u7801\u5b8c\u6210\u4e86\u3002\u5f53\u4f60\u8fd0\u884c\u793a\u4f8b\u65f6\uff0c\u4f60\u5c06\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a","title":"\u56de\u987eHUD - NanoVG"},{"location":"24-hud-revisited/#hud-nanovghud-revisited-nanovg","text":"\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u8bb2\u89e3\u4e86\u5982\u4f55\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u5728\u573a\u666f\u9876\u90e8\u521b\u5efa\u4e00\u4e2aHUD\u4ee5\u6e32\u67d3\u56fe\u5f62\u548c\u7eb9\u7406\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 NanoVG \u5e93\u6765\u6e32\u67d3\u6297\u952f\u9f7f\u77e2\u91cf\u56fe\u5f62\uff0c\u4ece\u800c\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u521b\u5efa\u66f4\u590d\u6742\u7684HUD\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528\u8bb8\u591a\u5176\u4ed6\u5e93\u6765\u5b8c\u6210\u6b64\u4e8b\uff0c\u4f8b\u5982 Nifty GUI \uff0c Nuklear \u7b49\u3002\u5728\u672c\u7ae0\u662f\uff0c\u6211\u4eec\u5c06\u91cd\u70b9\u4ecb\u7ecdNanoVG\uff0c\u56e0\u4e3a\u5b83\u4f7f\u7528\u8d77\u6765\u975e\u5e38\u7b80\u5355\uff0c\u4f46\u662f\u5982\u679c\u4f60\u5e0c\u671b\u5f00\u53d1\u53ef\u4e0e\u6309\u94ae\u3001\u83dc\u5355\u548c\u7a97\u53e3\u4ea4\u4e92\u7684\u590d\u6742GUI\uff0c\u90a3\u4f60\u53ef\u80fd\u9700\u8981\u7684\u662f Nifty GUI \u3002 \u4f7f\u7528 NanoVG \u9996\u5148\u662f\u8981\u5728 pom.xml \u6587\u4ef6\u4e2d\u6dfb\u52a0\u4f9d\u8d56\u9879\uff08\u4e00\u4e2a\u662f\u7528\u4e8e\u7f16\u8bd1\u65f6\u6240\u9700\u7684\u4f9d\u8d56\u9879\uff0c\u53e6\u4e00\u4e2a\u662f\u7528\u4e8e\u8fd0\u884c\u65f6\u6240\u9700\u7684\u672c\u5730\u4ee3\u7801\uff09\uff1a ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> </dependency> ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u5f00\u59cb\u4f7f\u7528 NanoVG \u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u5728OpenGL\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u4ee5\u4fbf\u793a\u4f8b\u80fd\u591f\u6b63\u5e38\u5de5\u4f5c\u3002\u6211\u4eec\u9700\u8981\u542f\u7528\u5bf9\u6a21\u677f\u6d4b\u8bd5\uff08Stencil Test\uff09\u7684\u652f\u6301\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u8bb2\u89e3\u4e86\u989c\u8272\u548c\u6df1\u5ea6\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u63d0\u5230\u6a21\u677f\u7f13\u51b2\u533a\u3002\u8be5\u7f13\u51b2\u533a\u4e3a\u7528\u4e8e\u63a7\u5236\u5e94\u7ed8\u5236\u54ea\u4e9b\u50cf\u7d20\u7684\u6bcf\u4e2a\u50cf\u7d20\u50a8\u5b58\u4e00\u4e2a\u503c\uff08\u6574\u6570\uff09\uff0c\u7528\u4e8e\u6839\u636e\u50a8\u5b58\u7684\u503c\u4ee5\u5c4f\u853d\u6216\u653e\u5f03\u7ed8\u56fe\u533a\u57df\u3002\u4f8b\u5982\uff0c\u5b83\u53ef\u4ee5\u7528\u6765\u4ee5\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u5f0f\u5207\u5272\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u6b64\u884c\u6dfb\u52a0\u5230 Window \u7c7b\u4e2d\u6765\u542f\u7528\u6a21\u677f\u6d4b\u8bd5\uff08\u5728\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4e4b\u540e\uff09\uff1a glEnable(GL_STENCIL_TEST); \u56e0\u4e3a\u6211\u4eec\u4f7f\u7528\u7684\u662f\u53e6\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u6240\u4ee5\u5728\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u6ce8\u610f\u5220\u9664\u5b83\u7684\u503c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u7684 clear \u65b9\u6cd5\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT); } \u6211\u4eec\u8fd8\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u7a97\u53e3\u9009\u9879\u6765\u6fc0\u6d3b\u6297\u952f\u9f7f\uff08Anti-aliasing\uff09\u3002\u56e0\u6b64\uff0c\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u542f\u7528\u5b83\uff1a if (opts.antialiasing) { glfwWindowHint(GLFW_SAMPLES, 4); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 NanoVG \u5e93\u4e86\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5220\u6389\u6211\u4eec\u521b\u5efa\u7684HUD\u4ee3\u7801\uff0c\u5373\u7740\u8272\u5668\uff0c IHud \u63a5\u53e3\uff0c Renderer \u7c7b\u4e2d\u7684HUD\u6e32\u67d3\u65b9\u6cd5\u7b49\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u65b0\u7684 Hud \u7c7b\u5c06\u8d1f\u8d23\u5176\u6e32\u67d3\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u9700\u8981\u5c06\u5176\u59d4\u6258\u7ed9 Renderer \u7c7b\u3002\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u8fd9\u4e2a\u7c7b\uff0c\u5b83\u5c06\u6709\u4e00\u4e2a init \u65b9\u6cd5\u6765\u8bbe\u7f6e\u5e93\u548c\u6784\u5efaHUD\u6240\u9700\u8981\u7684\u8d44\u6e90\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void init(Window window) throws Exception { this.vg = window.getOptions().antialiasing ? nvgCreate(NVG_ANTIALIAS | NVG_STENCIL_STROKES) : nvgCreate(NVG_STENCIL_STROKES); if (this.vg == NULL) { throw new Exception(\"Could not init nanovg\"); } fontBuffer = Utils.ioResourceToByteBuffer(\"/fonts/OpenSans-Bold.ttf\", 150 * 1024); int font = nvgCreateFontMem(vg, FONT_NAME, fontBuffer, 0); if (font == -1) { throw new Exception(\"Could not add font\"); } colour = NVGColor.create(); posx = MemoryUtil.memAllocDouble(1); posy = MemoryUtil.memAllocDouble(1); counter = 0; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2aNanoVG\u4e0a\u4e0b\u6587\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL3.0\u540e\u7aef\uff0c\u56e0\u6b64\u6211\u4eec\u5f15\u7528\u7684\u662f org.lwjgl.nanovg.NanoVGGL3 \u547d\u540d\u7a7a\u95f4\u3002\u5982\u679c\u6297\u952f\u9f7f\u88ab\u542f\u7528\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e NVG_ANTIALIAS \u6807\u5fd7\u3002 \u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u4f7f\u7528\u6b64\u524d\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\u7684TrueType\u5b57\u4f53\u6765\u521b\u5efa\u5b57\u4f53\u3002\u6211\u4eec\u4e3a\u5b83\u6307\u5b9a\u4e00\u4e2a\u540d\u8bcd\uff0c\u4ee5\u4fbf\u7a0d\u540e\u5728\u6e32\u67d3\u6587\u672c\u65f6\u4f7f\u7528\u5b83\u3002\u5173\u4e8e\u8fd9\u70b9\uff0c\u4e00\u4ef6\u5f88\u91cd\u8981\u7684\u4e8b\u60c5\u662f\u7528\u4e8e\u52a0\u8f7d\u5b57\u4f53\u7684 ByteBuffer \u5fc5\u987b\u5728\u4f7f\u7528\u5b57\u4f53\u65f6\u50a8\u5b58\u5728\u5185\u5b58\u4e2d\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u4e0d\u80fd\u88ab\u56de\u6536\uff0c\u5426\u5219\u4f60\u5c06\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u6838\u5fc3\u5d29\u6e83\u3002\u8fd9\u5c31\u662f\u5c06\u5b83\u50a8\u5b58\u4e3a\u7c7b\u5c5e\u6027\u7684\u539f\u56e0\u3002 \u7136\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e00\u4e2a\u989c\u8272\u5b9e\u4f8b\u548c\u4e00\u4e9b\u6709\u7528\u7684\u53d8\u91cf\uff0c\u8fd9\u4e9b\u53d8\u91cf\u5c06\u5728\u6e32\u67d3\u65f6\u4f7f\u7528\u3002\u5728\u521d\u59cb\u5316\u6e32\u67d3\u4e4b\u524d\uff0c\u5728\u6e38\u620f\u521d\u59cb\u5316\u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a @Override public void init(Window window) throws Exception { hud.init(window); renderer.init(window); ... Hud \u7c7b\u8fd8\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5e94\u5728\u6e32\u67d3\u573a\u666f\u540e\u8c03\u7528\uff0c\u4ee5\u4fbf\u5728\u5176\u4e0a\u7ed8\u5236Hud\u3002 @Override public void render(Window window) { renderer.render(window, camera, scene); hud.render(window); } Hud\u7c7b\u7684 render \u65b9\u6cd5\u7684\u5f00\u5934\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window) { nvgBeginFrame(vg, window.getWidth(), window.getHeight(), 1); \u9996\u5148\u5fc5\u987b\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 nvgBeginFrame \u65b9\u6cd5\u3002\u6240\u6709NanoVG\u6e32\u67d3\u64cd\u4f5c\u90fd\u5fc5\u987b\u4fdd\u62a4\u5728 nvgBeginFrame \u548c nvgEndFrame \u8c03\u7528\u4e4b\u95f4\u3002 nvgBeginFrame \u63a5\u53d7\u4ee5\u4e0b\u53c2\u6570\uff1a NanoVG\u73af\u5883 \u8981\u6e32\u67d3\u7684\u7a97\u53e3\u7684\u5927\u5c0f\uff08\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff09\u3002 \u50cf\u7d20\u6bd4\u3002\u5982\u679c\u9700\u8981\u652f\u6301Hi-DPI\uff0c\u53ef\u4ee5\u4fee\u6539\u6b64\u503c\u3002\u5bf9\u4e8e\u672c\u4f8b\uff0c\u6211\u4eec\u53ea\u5c06\u5176\u8bbe\u7f6e\u4e3a1\u3002 \u7136\u540e\u6211\u4eec\u521b\u5efa\u4e86\u51e0\u4e2a\u5360\u636e\u6574\u4e2a\u5c4f\u5e55\u7684\u8272\u5e26\u3002\u7b2c\u4e00\u6761\u662f\u8fd9\u6837\u7ed8\u5236\u7684\uff1a // \u4e0a\u8272\u5e26 nvgBeginPath(vg); nvgRect(vg, 0, window.getHeight() - 100, window.getWidth(), 50); nvgFillColor(vg, rgba(0x23, 0xa1, 0xf1, 200, colour)); nvgFill(vg); \u6e32\u67d3\u56fe\u5f62\u65f6\uff0c\u5e94\u8c03\u7528\u7684\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f nvgBeginPath \uff0c\u5b83\u6307\u793aNanoVG\u5f00\u59cb\u7ed8\u5236\u65b0\u56fe\u5f62\u3002\u7136\u540e\u5b9a\u4e49\u8981\u7ed8\u5236\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u77e9\u5f62\uff0c\u586b\u5145\u989c\u8272\u5e76\u901a\u8fc7\u8c03\u7528 nvgFill \u7ed8\u5236\u5b83\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u7684\u5176\u4ed6\u90e8\u5206\uff0c\u4ee5\u4e86\u89e3\u5176\u4f59\u56fe\u5f62\u662f\u5982\u4f55\u7ed8\u5236\u7684\u3002\u5f53\u6e32\u67d3\u6587\u672c\u662f\uff0c\u4e0d\u9700\u8981\u5728\u6e32\u67d3\u524d\u8c03\u7528 nvgBeginPath \u3002 \u5b8c\u6210\u6240\u6709\u56fe\u5f62\u7684\u7ed8\u5236\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8c03\u7528 nvgEndFrame \u6765\u7ed3\u675f\u6e32\u67d3\uff0c\u4f46\u5728\u79bb\u5f00\u65b9\u6cd5\u4e4b\u524d\u8fd8\u6709\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u60c5\u8981\u505a\u3002\u6211\u4eec\u5fc5\u987b\u6062\u590dOpenGL\u72b6\u6001\uff0cNanoVG\u4fee\u6539OpenGL\u4ee5\u6267\u884c\u5176\u64cd\u4f5c\uff0c\u5982\u679c\u72b6\u6001\u672a\u6b63\u786e\u8fd8\u539f\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u573a\u666f\u6ca1\u6709\u6b63\u786e\u6e32\u67d3\uff0c\u751a\u81f3\u88ab\u64e6\u9664\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6062\u590d\u6e32\u67d3\u6240\u9700\u7684\u76f8\u5173OpenGL\u72b6\u6001\u3002\u8fd9\u662f\u59d4\u6d3e\u5230 Window \u7c7b\u4e2d\u7684\uff1a // \u8fd8\u539f\u72b6\u6001 window.restoreState(); \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void restoreState() { glEnable(GL_DEPTH_TEST); glEnable(GL_STENCIL_TEST); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); if (opts.cullFace) { glEnable(GL_CULL_FACE); glCullFace(GL_BACK); } } \u8fd9\u5c31\u5b8c\u4e8b\u4e86\uff08\u9664\u4e86\u4e00\u4e9b\u5176\u5b83\u7684\u6e05\u7406\u65b9\u6cd5\uff09\uff0c\u4ee3\u7801\u5b8c\u6210\u4e86\u3002\u5f53\u4f60\u8fd0\u884c\u793a\u4f8b\u65f6\uff0c\u4f60\u5c06\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a","title":"\u56de\u987eHUD - NanoVG\uff08HUD Revisited - NanoVG\uff09"},{"location":"25-optimizations-frustum-culling/","text":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\uff08Optimizations - Frustum Culling\uff09 \u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e00 \u73b0\u5728\u6211\u4eec\u4f7f\u7528\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u56fe\u5f62\u6548\u679c\uff0c\u4f8b\u5982\u5149\u7167\u3001\u7c92\u5b50\u7b49\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5b66\u4e60\u4e86\u5982\u4f55\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u51cf\u5c11\u7ed8\u5236\u8bb8\u591a\u76f8\u4f3c\u5bf9\u8c61\u7684\u5f00\u9500\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u6709\u8db3\u591f\u7684\u7a7a\u95f4\u8fdb\u884c\u4e00\u4e9b\u7b80\u5355\u7684\u4f18\u5316\uff0c\u8fd9\u5c06\u589e\u52a0\u53ef\u4ee5\u8fbe\u5230\u7684\u5e27\u7387\uff08FPS\uff09\u3002 \u4f60\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u6211\u4eec\u4f1a\u5728\u6bcf\u4e00\u5e27\u4e2d\u7ed8\u5236\u6574\u4e2a\u6e38\u620f\u9879\u5217\u8868\uff0c\u5373\u4f7f\u5176\u4e2d\u4e00\u4e9b\u9879\u4e0d\u53ef\u89c1\uff08\u56e0\u4e3a\u5b83\u4eec\u5728\u6444\u50cf\u673a\u540e\u9762\u6216\u8ddd\u79bb\u6444\u50cf\u673a\u592a\u8fdc\uff09\u3002\u4f60\u751a\u81f3\u53ef\u80fd\u8ba4\u4e3a\u8fd9\u662f\u7531OpenGL\u81ea\u52a8\u5904\u7406\u7684\uff0c\u8fd9\u5728\u67d0\u79cd\u7a0b\u5ea6\u4e0a\u662f\u6b63\u786e\u7684\u3002OpenGL\u5c06\u653e\u5f03\u4f4d\u4e8e\u53ef\u89c1\u533a\u57df\u4e4b\u5916\u7684\u9876\u70b9\u7684\u6e32\u67d3\uff0c\u8fd9\u79f0\u4f5c\u88c1\u526a\uff08Clipping\uff09\u3002\u88c1\u526a\u7684\u95ee\u9898\u662f\uff0c\u5728\u6267\u884c\u9876\u70b9\u7740\u8272\u4e4b\u540e\uff0c\u6309\u9876\u70b9\u8fdb\u884c\u5904\u7406\u7684\u3002\u56e0\u6b64\uff0c\u5373\u4f7f\u6b64\u64cd\u4f5c\u8282\u7701\u4e86\u8d44\u6e90\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u901a\u8fc7\u4e0d\u5c1d\u8bd5\u6e32\u67d3\u4e0d\u53ef\u89c1\u7684\u5bf9\u8c61\u6765\u63d0\u9ad8\u6548\u7387\u3002\u6211\u4eec\u4e0d\u4f1a\u901a\u8fc7\u5c06\u6570\u636e\u53d1\u9001\u5230GPU\u4ee5\u53ca\u5bf9\u8fd9\u4e9b\u5bf9\u8c61\u7684\u6bcf\u4e2a\u9876\u70b9\u8fdb\u884c\u53d8\u6362\u6765\u6d6a\u8d39\u8d44\u6e90\u3002\u6211\u4eec\u9700\u8981\u79fb\u9664\u4e0d\u5305\u542b\u5728\u89c6\u9525\u4f53\uff08View Frustum\uff09\u4e2d\u7684\u5bf9\u8c61\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u622a\u9525\u5254\u9664\u3002 \u4f46\u662f\uff0c\u9996\u5148\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u4ec0\u4e48\u662f\u89c6\u9525\u4f53\u3002\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u7ed3\u5408\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4ee5\u53ca\u4f7f\u7528\u7684\u6295\u5f71\uff0c\u5305\u542b\u6240\u6709\u53ef\u89c1\u7269\u4f53\u7684\u4f53\u79ef\u3002\u901a\u5e38\uff0c\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u56db\u68f1\u53f0\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u89c6\u9525\u4f53\u7531\u516d\u4e2a\u5e73\u9762\u5b9a\u4e49\uff0c\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u4efb\u4f55\u5185\u5bb9\u90fd\u4e0d\u4f1a\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u622a\u9525\u5254\u9664\u662f\u79fb\u9664\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u5bf9\u8c61\u7684\u8fc7\u7a0b\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8fdb\u884c\u622a\u9525\u5254\u9664\uff0c\u6211\u4eec\u9700\u8981\uff1a \u4f7f\u7528\u89c2\u5bdf\u548c\u6295\u5f71\u77e9\u9635\u4e2d\u5305\u542b\u7684\u6570\u636e\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u3002 \u5bf9\u6bcf\u4e2a\u6e38\u620f\u9879\u68c0\u67e5\u5b83\u662f\u5426\u5305\u542b\u5728\u89c6\u9525\u4f53\u4e2d\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5728\u5927\u5c0f\u622a\u9525\u5e73\u9762\u4e4b\u95f4\u3002\u5e76\u4ece\u6e32\u67d3\u6d41\u7a0b\u4e2d\u5220\u9664\u90a3\u4e9b\u4e0d\u5305\u542b\u5728\u5176\u4e2d\u7684\u3002 \u90a3\u4e48\u8ba9\u6211\u4eec\u4ece\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u5f00\u59cb\u3002\u5e73\u9762\u7531\u5305\u542b\u5728\u5176\u4e2d\u7684\u70b9\u548c\u4e0e\u8be5\u5e73\u9762\u6b63\u4ea4\u7684\u5411\u91cf\u5b9a\u4e49\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5e73\u9762\u65b9\u7a0b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a Ax+By+Cz+D=0 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u89c6\u9525\u4f53\u7684\u516d\u4e2a\u4fa7\u9762\u7684\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u3002\u4e3a\u4e86\u8fbe\u6210\u8fd9\u4e2a\u76ee\u6807\uff0c\u4f60\u57fa\u672c\u4e0a\u6709\u4e24\u4e2a\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u8fdb\u884c\u7e41\u7410\u7684\u8ba1\u7b97\uff0c\u5f97\u5230\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u7684\u6765\u81ea\u4e0a\u8ff0\u65b9\u7a0b\u7684\u56db\u4e2a\u5e38\u6570\uff08A\u3001B\u3001C\u548cD\uff09\u3002\u53e6\u4e00\u4e2a\u9009\u9879\u662f\u8ba9 JOML \u5e93\u4e3a\u4f60\u8ba1\u7b97\u8fd9\u4e2a\u503c\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9009\u62e9\u540e\u4e00\u4e2a\u9009\u9879\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FrustumCullingFilter \u7684\u65b0\u7c7b\uff0c\u8ddf\u5b83\u7684\u540d\u5b57\u76f8\u540c\uff0c\u5b83\u5c06\u6839\u636e\u89c6\u9525\u4f53\u6267\u884c\u7b5b\u9009\u64cd\u4f5c\u3002 public class FrustumCullingFilter { private static final int NUM_PLANES = 6; private final Matrix4f prjViewMatrix; private final Vector4f[] frustumPlanes; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumPlanes = new Vector4f[NUM_PLANES]; for (int i = 0; i < NUM_PLANES; i++) { frustumPlanes[i] = new Vector4f(); } } FrustumCullingFilter \u7c7b\u4e5f\u5c06\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u8ba1\u7b97\u5e73\u9762\u65b9\u7a0b\uff0c\u540d\u4e3a updateFrustum \uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u4e4b\u524d\u8c03\u7528\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u89c2\u5bdf\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u83b7\u53d6\u89c6\u9525\u4f53\u5e73\u9762 for (int i = 0; i < NUM_PLANES; i++) { prjViewMatrix.frustumPlane(i, frustumPlanes[i]); } } \u9996\u5148\uff0c\u6211\u4eec\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u7684\u526f\u672c\uff0c\u5e76\u5c06\u5176\u4e0e\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\uff0c\u5f97\u5230\u6295\u5f71\u89c2\u5bdf\u77e9\u9635\u3002\u7136\u540e\uff0c\u4f7f\u7528\u8fd9\u4e2a\u53d8\u6362\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u622a\u9525\u5e73\u9762\u8c03\u7528 frustumPlane \u65b9\u6cd5\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8fd9\u4e9b\u5e73\u9762\u65b9\u7a0b\u662f\u7528\u4e16\u754c\u5750\u6807\u8868\u793a\u7684\uff0c\u6240\u4ee5\u6240\u6709\u7684\u8ba1\u7b97\u90fd\u8981\u5728\u8fd9\u4e2a\u7a7a\u95f4\u4e2d\u8fdb\u884c\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u8ba1\u7b97\u4e86\u6240\u6709\u5e73\u9762\uff0c\u6211\u4eec\u53ea\u9700\u8981\u68c0\u67e5 GameItem \u5b9e\u4f8b\u662f\u5426\u5728\u622a\u9525\u4f53\u4e2d\u3002\u8be5\u600e\u4e48\u505a\uff1f\u8ba9\u6211\u4eec\u9996\u5148\u786e\u8ba4\u4e00\u4e0b\u5982\u4f55\u68c0\u67e5\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\uff0c\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u70b9\u5230\u6bcf\u4e2a\u5e73\u9762\u7684\u6709\u7b26\u53f7\u7684\u8ddd\u79bb\u6765\u5b9e\u73b0\u8fd9\u4e00\u70b9\u3002\u5982\u679c\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u662f\u6b63\u7684\uff0c\u8fd9\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u524d\u9762\uff08\u6839\u636e\u5176\u6cd5\u7ebf\uff09\u3002\u5982\u679c\u662f\u8d1f\u7684\uff0c\u5219\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u56e0\u6b64\uff0c\u5982\u679c\u5230\u622a\u9525\u7684\u6240\u6709\u5e73\u9762\u7684\u8ddd\u79bb\u4e3a\u6b63\uff0c\u5219\u4e00\u4e2a\u70b9\u4f4d\u4e8e\u89c6\u9525\u4f53\u7684\u5185\u90e8\u3002\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u5b9a\u4e49\u5982\u4e0b\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0}+D \uff0c\u5176\u4e2d x_{0} \u3001 y_{0} \u548c z_{0} \u662f\u70b9\u7684\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u5982\u679c Ax_{0}+By_{0}+Cz_{0}+D <= 0 \u5219\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u6ca1\u6709\u70b9\uff0c\u53ea\u6709\u590d\u6742\u7684\u7f51\u683c\uff0c\u6211\u4eec\u4e0d\u80fd\u4ec5\u4ec5\u7528\u70b9\u6765\u68c0\u67e5\u4e00\u4e2a\u7269\u54c1\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u4f60\u53ef\u4ee5\u8003\u8651\u68c0\u67e5 GameItem \u7684\u6bcf\u4e2a\u9876\u70b9\uff0c\u770b\u770b\u5b83\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u5982\u679c\u4efb\u4f55\u4e00\u4e2a\u70b9\u5728\u91cc\u9762\uff0c\u6e38\u620f\u9879\u5e94\u8be5\u88ab\u7ed8\u5236\u51fa\u6765\u3002\u4f46\u8fd9\u5c31\u662fOpenGL\u5728\u88c1\u526a\u65f6\u6240\u505a\u7684\uff0c\u4e5f\u662f\u6211\u4eec\u8981\u907f\u514d\u7684\u3002\u8bb0\u4f4f\uff0c\u7f51\u683c\u8d8a\u590d\u6742\uff0c\u622a\u9525\u5254\u9664\u7684\u597d\u5904\u8d8a\u660e\u663e\u3002 \u6211\u4eec\u9700\u8981\u628a\u6bcf\u4e00\u4e2a GameItem \u653e\u5230\u4e00\u4e2a\u7b80\u5355\u7684\u4f53\u4e2d\uff0c\u8fd9\u4e2a\u4f53\u5f88\u5bb9\u6613\u68c0\u67e5\u3002\u8fd9\u91cc\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u9879\uff1a \u8fb9\u754c\u76d2\uff08Bounding Box\uff09\u3002 \u8fb9\u754c\u7403\uff08Bounding Sphere\uff09\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7403\u4f53\uff0c\u56e0\u4e3a\u8fd9\u662f\u6700\u7b80\u5355\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u628a\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879\u653e\u5728\u4e00\u4e2a\u7403\u4f53\u4e2d\uff0c\u5e76\u68c0\u67e5\u7403\u4f53\u662f\u5426\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e2d\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7403\u4f53\u7684\u4e2d\u5fc3\u548c\u534a\u5f84\u3002\u68c0\u67e5\u5b83\u51e0\u4e4e\u7b49\u540c\u4e8e\u68c0\u67e5\u70b9\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u8003\u8651\u677f\u7532\u3002\u5982\u679c\u6ee1\u8db3\u4ee5\u4e0b\u6761\u4ef6\uff0c\u5219\u7403\u4f53\u5c06\u4f4d\u4e8e\u622a\u9525\u4e4b\u5916\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0} <= -\u534a\u5f84 \u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728 FrustumCullingFilter \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u68c0\u67e5\u7403\u4f53\u662f\u5426\u5728\u622a\u9525\u4e2d\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { boolean result = true; for (int i = 0; i < NUM_PLANES; i++) { Vector4f plane = frustumPlanes[i]; if (plane.x * x0 + plane.y * y0 + plane.z * z0 + plane.w <= -boundingRadius) { result = false; return result; } } return result; } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u8fc7\u6ee4\u89c6\u9525\u4f53\u5916\u7684\u6e38\u620f\u9879\u7684\u65b9\u6cd5\uff1a public void filter(List<GameItem> gameItems, float meshBoundingRadius) { float boundingRadius; Vector3f pos; for (GameItem gameItem : gameItems) { boundingRadius = gameItem.getScale() * meshBoundingRadius; pos = gameItem.getPosition(); gameItem.setInsideFrustum(insideFrustum(pos.x, pos.y, pos.z, boundingRadius)); } } \u6211\u4eec\u5728 GameItem \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 insideFrustum \u6765\u8ddf\u8e2a\u53ef\u89c1\u6027\u3002\u5982\u4f60\u6240\u89c1\uff0c\u8fb9\u754c\u7403\u7684\u677f\u7532\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u3002\u8fd9\u662f\u7531\u4e8e\u8fb9\u754c\u7403\u4e0e Mesh \u7ba1\u7406\uff0c\u5b83\u4e0d\u662f GameItem \u7684\u5c5e\u6027\u3002\u4f46\u662f\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u5728\u4e16\u754c\u5750\u6807\u4e2d\u64cd\u4f5c\uff0c\u5e76\u4e14\u8fb9\u754c\u7403\u7684\u534a\u5f84\u5c06\u5728\u6a21\u578b\u7a7a\u95f4\u9707\u3002\u6211\u4eec\u5c06\u5e94\u7528\u4e3a GameItem \u8bbe\u7f6e\u7684\u6bd4\u4f8b\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u7a7a\u95f4\uff0c\u6211\u4eec\u8fd8\u5047\u8bbe GameItem \u7684\u4f4d\u7f6e\u662f\u7403\u4f53\u7684\u4e2d\u5fc3\uff08\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6700\u540e\u4e00\u4e2a\u65b9\u6cd5\u53ea\u662f\u4e00\u4e2a\u5b9e\u7528\u65b9\u6cd5\uff0c\u5b83\u63a5\u53d7\u7f51\u683c\u8868\u5e76\u8fc7\u6ee4\u5176\u4e2d\u5305\u542b\u7684\u6240\u6709 GameItem \u5b9e\u4f8b\uff1a public void filter(Map<? extends Mesh, List<GameItem>> mapMesh) { for (Map.Entry<? extends Mesh, List<GameItem>> entry : mapMesh.entrySet()) { List<GameItem> gameItems = entry.getValue(); filter(gameItems, entry.getKey().getBoundingRadius()); } } \u5c31\u8fd9\u6837\u3002\u6211\u4eec\u53ef\u4ee5\u5728\u6e32\u67d3\u6d41\u7a0b\u4e2d\u4f7f\u7528\u8be5\u7c7b\uff0c\u53ea\u9700\u8981\u66f4\u65b0\u622a\u9525\u5e73\u9762\uff0c\u8ba1\u7b97\u51fa\u54ea\u4e9b\u6e38\u620f\u9879\u662f\u53ef\u89c1\u7684\uff0c\u5e76\u5728\u7ed8\u5236\u5b9e\u4f8b\u7f51\u683c\u548c\u975e\u5b9e\u4f8b\u7f51\u683c\u65f6\u8fc7\u6ee4\u6389\u5b83\u4eec\uff1a frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); \u4f60\u53ef\u4ee5\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u529f\u80fd\uff0c\u5e76\u53ef\u4ee5\u68c0\u67e5\u4f60\u53ef\u4ee5\u8fbe\u5230\u7684FPS\u7684\u589e\u52a0\u548c\u51cf\u5c11\u3002\u5728\u8fc7\u6ee4\u65f6\u4e0d\u8003\u8651\u7c92\u5b50\uff0c\u4f46\u662f\u6dfb\u52a0\u5b83\u662f\u5f88\u7b80\u5355\u7684\u3002\u5bf9\u4e8e\u7c92\u5b50\uff0c\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\u6700\u597d\u68c0\u67e5\u53d1\u5c04\u5668\u7684\u4f4d\u7f6e\uff0c\u800c\u4e0d\u662f\u68c0\u67e5\u6bcf\u4e2a\u7c92\u5b50\u3002 \u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e8c \u89e3\u91ca\u4e86\u622a\u9525\u5254\u9664\u7684\u57fa\u7840\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 JOML \u5e93\u4e2d\u63d0\u4f9b\u7684\u66f4\u7cbe\u7ec6\u7684\u65b9\u6cd5\u3002\u5b83\u7279\u522b\u5730\u63d0\u4f9b\u4e86\u4e00\u4e2a\u540d\u4e3a FrustumIntersection \u7684\u7c7b\uff0c\u8be5\u7c7b\u4ee5\u6309\u6b64 \u6587\u7ae0 \u6240\u8ff0\u7684\u4e00\u79cd\u66f4\u6709\u6548\u7684\u65b9\u5f0f\u83b7\u53d6\u89c6\u9525\u4f53\u7684\u5e73\u9762\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u6d4b\u8bd5\u8fb9\u754c\u76d2\u3001\u70b9\u548c\u7403\u4f53\u7684\u65b9\u6cd5\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u4fee\u6539 FrustumCullingFilter \u7c7b\u3002\u5c5e\u6027\u548c\u6784\u9020\u51fd\u6570\u7b80\u5316\u5982\u4e0b\uff1a public class FrustumCullingFilter { private final Matrix4f prjViewMatrix; private FrustumIntersection frustumInt; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumInt = new FrustumIntersection(); } updateFrustum \u65b9\u6cd5\u53ea\u662f\u5c06\u5e73\u9762\u83b7\u53d6\u59d4\u6258\u7ed9 FrustumIntersection \u5b9e\u4f8b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u66f4\u65b0\u622a\u9525\u76f8\u4ea4\u7c7b frustumInt.set(prjViewMatrix); } insideFrustum \u65b9\u6cd5\u66f4\u7b80\u5355\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { return frustumInt.testSphere(x0, y0, z0, boundingRadius); } \u4f7f\u7528\u8be5\u65b9\u6cd5\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u8fbe\u5230\u66f4\u9ad8\u7684FPS\u3002\u6b64\u5916\uff0c\u8fd8\u5411 Window \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u5168\u5c40\u6807\u8bb0\uff0c\u4ee5\u542f\u7528\u6216\u7981\u7528\u622a\u9525\u5254\u9664\u3002 GameItem \u7c7b\u4e5f\u6709\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u7684\u6807\u8bb0\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u67d0\u4e9b\u9879\uff0c\u622a\u9525\u5254\u9664\u8fc7\u6ee4\u53ef\u80fd\u6ca1\u6709\u610f\u4e49\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664"},{"location":"25-optimizations-frustum-culling/#-optimizations-frustum-culling","text":"","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\uff08Optimizations - Frustum Culling\uff09"},{"location":"25-optimizations-frustum-culling/#-","text":"\u73b0\u5728\u6211\u4eec\u4f7f\u7528\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u56fe\u5f62\u6548\u679c\uff0c\u4f8b\u5982\u5149\u7167\u3001\u7c92\u5b50\u7b49\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5b66\u4e60\u4e86\u5982\u4f55\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u51cf\u5c11\u7ed8\u5236\u8bb8\u591a\u76f8\u4f3c\u5bf9\u8c61\u7684\u5f00\u9500\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u6709\u8db3\u591f\u7684\u7a7a\u95f4\u8fdb\u884c\u4e00\u4e9b\u7b80\u5355\u7684\u4f18\u5316\uff0c\u8fd9\u5c06\u589e\u52a0\u53ef\u4ee5\u8fbe\u5230\u7684\u5e27\u7387\uff08FPS\uff09\u3002 \u4f60\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u6211\u4eec\u4f1a\u5728\u6bcf\u4e00\u5e27\u4e2d\u7ed8\u5236\u6574\u4e2a\u6e38\u620f\u9879\u5217\u8868\uff0c\u5373\u4f7f\u5176\u4e2d\u4e00\u4e9b\u9879\u4e0d\u53ef\u89c1\uff08\u56e0\u4e3a\u5b83\u4eec\u5728\u6444\u50cf\u673a\u540e\u9762\u6216\u8ddd\u79bb\u6444\u50cf\u673a\u592a\u8fdc\uff09\u3002\u4f60\u751a\u81f3\u53ef\u80fd\u8ba4\u4e3a\u8fd9\u662f\u7531OpenGL\u81ea\u52a8\u5904\u7406\u7684\uff0c\u8fd9\u5728\u67d0\u79cd\u7a0b\u5ea6\u4e0a\u662f\u6b63\u786e\u7684\u3002OpenGL\u5c06\u653e\u5f03\u4f4d\u4e8e\u53ef\u89c1\u533a\u57df\u4e4b\u5916\u7684\u9876\u70b9\u7684\u6e32\u67d3\uff0c\u8fd9\u79f0\u4f5c\u88c1\u526a\uff08Clipping\uff09\u3002\u88c1\u526a\u7684\u95ee\u9898\u662f\uff0c\u5728\u6267\u884c\u9876\u70b9\u7740\u8272\u4e4b\u540e\uff0c\u6309\u9876\u70b9\u8fdb\u884c\u5904\u7406\u7684\u3002\u56e0\u6b64\uff0c\u5373\u4f7f\u6b64\u64cd\u4f5c\u8282\u7701\u4e86\u8d44\u6e90\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u901a\u8fc7\u4e0d\u5c1d\u8bd5\u6e32\u67d3\u4e0d\u53ef\u89c1\u7684\u5bf9\u8c61\u6765\u63d0\u9ad8\u6548\u7387\u3002\u6211\u4eec\u4e0d\u4f1a\u901a\u8fc7\u5c06\u6570\u636e\u53d1\u9001\u5230GPU\u4ee5\u53ca\u5bf9\u8fd9\u4e9b\u5bf9\u8c61\u7684\u6bcf\u4e2a\u9876\u70b9\u8fdb\u884c\u53d8\u6362\u6765\u6d6a\u8d39\u8d44\u6e90\u3002\u6211\u4eec\u9700\u8981\u79fb\u9664\u4e0d\u5305\u542b\u5728\u89c6\u9525\u4f53\uff08View Frustum\uff09\u4e2d\u7684\u5bf9\u8c61\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u622a\u9525\u5254\u9664\u3002 \u4f46\u662f\uff0c\u9996\u5148\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u4ec0\u4e48\u662f\u89c6\u9525\u4f53\u3002\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u7ed3\u5408\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4ee5\u53ca\u4f7f\u7528\u7684\u6295\u5f71\uff0c\u5305\u542b\u6240\u6709\u53ef\u89c1\u7269\u4f53\u7684\u4f53\u79ef\u3002\u901a\u5e38\uff0c\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u56db\u68f1\u53f0\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u89c6\u9525\u4f53\u7531\u516d\u4e2a\u5e73\u9762\u5b9a\u4e49\uff0c\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u4efb\u4f55\u5185\u5bb9\u90fd\u4e0d\u4f1a\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u622a\u9525\u5254\u9664\u662f\u79fb\u9664\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u5bf9\u8c61\u7684\u8fc7\u7a0b\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8fdb\u884c\u622a\u9525\u5254\u9664\uff0c\u6211\u4eec\u9700\u8981\uff1a \u4f7f\u7528\u89c2\u5bdf\u548c\u6295\u5f71\u77e9\u9635\u4e2d\u5305\u542b\u7684\u6570\u636e\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u3002 \u5bf9\u6bcf\u4e2a\u6e38\u620f\u9879\u68c0\u67e5\u5b83\u662f\u5426\u5305\u542b\u5728\u89c6\u9525\u4f53\u4e2d\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5728\u5927\u5c0f\u622a\u9525\u5e73\u9762\u4e4b\u95f4\u3002\u5e76\u4ece\u6e32\u67d3\u6d41\u7a0b\u4e2d\u5220\u9664\u90a3\u4e9b\u4e0d\u5305\u542b\u5728\u5176\u4e2d\u7684\u3002 \u90a3\u4e48\u8ba9\u6211\u4eec\u4ece\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u5f00\u59cb\u3002\u5e73\u9762\u7531\u5305\u542b\u5728\u5176\u4e2d\u7684\u70b9\u548c\u4e0e\u8be5\u5e73\u9762\u6b63\u4ea4\u7684\u5411\u91cf\u5b9a\u4e49\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5e73\u9762\u65b9\u7a0b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a Ax+By+Cz+D=0 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u89c6\u9525\u4f53\u7684\u516d\u4e2a\u4fa7\u9762\u7684\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u3002\u4e3a\u4e86\u8fbe\u6210\u8fd9\u4e2a\u76ee\u6807\uff0c\u4f60\u57fa\u672c\u4e0a\u6709\u4e24\u4e2a\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u8fdb\u884c\u7e41\u7410\u7684\u8ba1\u7b97\uff0c\u5f97\u5230\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u7684\u6765\u81ea\u4e0a\u8ff0\u65b9\u7a0b\u7684\u56db\u4e2a\u5e38\u6570\uff08A\u3001B\u3001C\u548cD\uff09\u3002\u53e6\u4e00\u4e2a\u9009\u9879\u662f\u8ba9 JOML \u5e93\u4e3a\u4f60\u8ba1\u7b97\u8fd9\u4e2a\u503c\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9009\u62e9\u540e\u4e00\u4e2a\u9009\u9879\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FrustumCullingFilter \u7684\u65b0\u7c7b\uff0c\u8ddf\u5b83\u7684\u540d\u5b57\u76f8\u540c\uff0c\u5b83\u5c06\u6839\u636e\u89c6\u9525\u4f53\u6267\u884c\u7b5b\u9009\u64cd\u4f5c\u3002 public class FrustumCullingFilter { private static final int NUM_PLANES = 6; private final Matrix4f prjViewMatrix; private final Vector4f[] frustumPlanes; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumPlanes = new Vector4f[NUM_PLANES]; for (int i = 0; i < NUM_PLANES; i++) { frustumPlanes[i] = new Vector4f(); } } FrustumCullingFilter \u7c7b\u4e5f\u5c06\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u8ba1\u7b97\u5e73\u9762\u65b9\u7a0b\uff0c\u540d\u4e3a updateFrustum \uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u4e4b\u524d\u8c03\u7528\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u89c2\u5bdf\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u83b7\u53d6\u89c6\u9525\u4f53\u5e73\u9762 for (int i = 0; i < NUM_PLANES; i++) { prjViewMatrix.frustumPlane(i, frustumPlanes[i]); } } \u9996\u5148\uff0c\u6211\u4eec\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u7684\u526f\u672c\uff0c\u5e76\u5c06\u5176\u4e0e\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\uff0c\u5f97\u5230\u6295\u5f71\u89c2\u5bdf\u77e9\u9635\u3002\u7136\u540e\uff0c\u4f7f\u7528\u8fd9\u4e2a\u53d8\u6362\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u622a\u9525\u5e73\u9762\u8c03\u7528 frustumPlane \u65b9\u6cd5\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8fd9\u4e9b\u5e73\u9762\u65b9\u7a0b\u662f\u7528\u4e16\u754c\u5750\u6807\u8868\u793a\u7684\uff0c\u6240\u4ee5\u6240\u6709\u7684\u8ba1\u7b97\u90fd\u8981\u5728\u8fd9\u4e2a\u7a7a\u95f4\u4e2d\u8fdb\u884c\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u8ba1\u7b97\u4e86\u6240\u6709\u5e73\u9762\uff0c\u6211\u4eec\u53ea\u9700\u8981\u68c0\u67e5 GameItem \u5b9e\u4f8b\u662f\u5426\u5728\u622a\u9525\u4f53\u4e2d\u3002\u8be5\u600e\u4e48\u505a\uff1f\u8ba9\u6211\u4eec\u9996\u5148\u786e\u8ba4\u4e00\u4e0b\u5982\u4f55\u68c0\u67e5\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\uff0c\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u70b9\u5230\u6bcf\u4e2a\u5e73\u9762\u7684\u6709\u7b26\u53f7\u7684\u8ddd\u79bb\u6765\u5b9e\u73b0\u8fd9\u4e00\u70b9\u3002\u5982\u679c\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u662f\u6b63\u7684\uff0c\u8fd9\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u524d\u9762\uff08\u6839\u636e\u5176\u6cd5\u7ebf\uff09\u3002\u5982\u679c\u662f\u8d1f\u7684\uff0c\u5219\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u56e0\u6b64\uff0c\u5982\u679c\u5230\u622a\u9525\u7684\u6240\u6709\u5e73\u9762\u7684\u8ddd\u79bb\u4e3a\u6b63\uff0c\u5219\u4e00\u4e2a\u70b9\u4f4d\u4e8e\u89c6\u9525\u4f53\u7684\u5185\u90e8\u3002\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u5b9a\u4e49\u5982\u4e0b\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0}+D \uff0c\u5176\u4e2d x_{0} \u3001 y_{0} \u548c z_{0} \u662f\u70b9\u7684\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u5982\u679c Ax_{0}+By_{0}+Cz_{0}+D <= 0 \u5219\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u6ca1\u6709\u70b9\uff0c\u53ea\u6709\u590d\u6742\u7684\u7f51\u683c\uff0c\u6211\u4eec\u4e0d\u80fd\u4ec5\u4ec5\u7528\u70b9\u6765\u68c0\u67e5\u4e00\u4e2a\u7269\u54c1\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u4f60\u53ef\u4ee5\u8003\u8651\u68c0\u67e5 GameItem \u7684\u6bcf\u4e2a\u9876\u70b9\uff0c\u770b\u770b\u5b83\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u5982\u679c\u4efb\u4f55\u4e00\u4e2a\u70b9\u5728\u91cc\u9762\uff0c\u6e38\u620f\u9879\u5e94\u8be5\u88ab\u7ed8\u5236\u51fa\u6765\u3002\u4f46\u8fd9\u5c31\u662fOpenGL\u5728\u88c1\u526a\u65f6\u6240\u505a\u7684\uff0c\u4e5f\u662f\u6211\u4eec\u8981\u907f\u514d\u7684\u3002\u8bb0\u4f4f\uff0c\u7f51\u683c\u8d8a\u590d\u6742\uff0c\u622a\u9525\u5254\u9664\u7684\u597d\u5904\u8d8a\u660e\u663e\u3002 \u6211\u4eec\u9700\u8981\u628a\u6bcf\u4e00\u4e2a GameItem \u653e\u5230\u4e00\u4e2a\u7b80\u5355\u7684\u4f53\u4e2d\uff0c\u8fd9\u4e2a\u4f53\u5f88\u5bb9\u6613\u68c0\u67e5\u3002\u8fd9\u91cc\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u9879\uff1a \u8fb9\u754c\u76d2\uff08Bounding Box\uff09\u3002 \u8fb9\u754c\u7403\uff08Bounding Sphere\uff09\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7403\u4f53\uff0c\u56e0\u4e3a\u8fd9\u662f\u6700\u7b80\u5355\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u628a\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879\u653e\u5728\u4e00\u4e2a\u7403\u4f53\u4e2d\uff0c\u5e76\u68c0\u67e5\u7403\u4f53\u662f\u5426\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e2d\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7403\u4f53\u7684\u4e2d\u5fc3\u548c\u534a\u5f84\u3002\u68c0\u67e5\u5b83\u51e0\u4e4e\u7b49\u540c\u4e8e\u68c0\u67e5\u70b9\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u8003\u8651\u677f\u7532\u3002\u5982\u679c\u6ee1\u8db3\u4ee5\u4e0b\u6761\u4ef6\uff0c\u5219\u7403\u4f53\u5c06\u4f4d\u4e8e\u622a\u9525\u4e4b\u5916\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0} <= -\u534a\u5f84 \u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728 FrustumCullingFilter \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u68c0\u67e5\u7403\u4f53\u662f\u5426\u5728\u622a\u9525\u4e2d\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { boolean result = true; for (int i = 0; i < NUM_PLANES; i++) { Vector4f plane = frustumPlanes[i]; if (plane.x * x0 + plane.y * y0 + plane.z * z0 + plane.w <= -boundingRadius) { result = false; return result; } } return result; } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u8fc7\u6ee4\u89c6\u9525\u4f53\u5916\u7684\u6e38\u620f\u9879\u7684\u65b9\u6cd5\uff1a public void filter(List<GameItem> gameItems, float meshBoundingRadius) { float boundingRadius; Vector3f pos; for (GameItem gameItem : gameItems) { boundingRadius = gameItem.getScale() * meshBoundingRadius; pos = gameItem.getPosition(); gameItem.setInsideFrustum(insideFrustum(pos.x, pos.y, pos.z, boundingRadius)); } } \u6211\u4eec\u5728 GameItem \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 insideFrustum \u6765\u8ddf\u8e2a\u53ef\u89c1\u6027\u3002\u5982\u4f60\u6240\u89c1\uff0c\u8fb9\u754c\u7403\u7684\u677f\u7532\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u3002\u8fd9\u662f\u7531\u4e8e\u8fb9\u754c\u7403\u4e0e Mesh \u7ba1\u7406\uff0c\u5b83\u4e0d\u662f GameItem \u7684\u5c5e\u6027\u3002\u4f46\u662f\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u5728\u4e16\u754c\u5750\u6807\u4e2d\u64cd\u4f5c\uff0c\u5e76\u4e14\u8fb9\u754c\u7403\u7684\u534a\u5f84\u5c06\u5728\u6a21\u578b\u7a7a\u95f4\u9707\u3002\u6211\u4eec\u5c06\u5e94\u7528\u4e3a GameItem \u8bbe\u7f6e\u7684\u6bd4\u4f8b\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u7a7a\u95f4\uff0c\u6211\u4eec\u8fd8\u5047\u8bbe GameItem \u7684\u4f4d\u7f6e\u662f\u7403\u4f53\u7684\u4e2d\u5fc3\uff08\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6700\u540e\u4e00\u4e2a\u65b9\u6cd5\u53ea\u662f\u4e00\u4e2a\u5b9e\u7528\u65b9\u6cd5\uff0c\u5b83\u63a5\u53d7\u7f51\u683c\u8868\u5e76\u8fc7\u6ee4\u5176\u4e2d\u5305\u542b\u7684\u6240\u6709 GameItem \u5b9e\u4f8b\uff1a public void filter(Map<? extends Mesh, List<GameItem>> mapMesh) { for (Map.Entry<? extends Mesh, List<GameItem>> entry : mapMesh.entrySet()) { List<GameItem> gameItems = entry.getValue(); filter(gameItems, entry.getKey().getBoundingRadius()); } } \u5c31\u8fd9\u6837\u3002\u6211\u4eec\u53ef\u4ee5\u5728\u6e32\u67d3\u6d41\u7a0b\u4e2d\u4f7f\u7528\u8be5\u7c7b\uff0c\u53ea\u9700\u8981\u66f4\u65b0\u622a\u9525\u5e73\u9762\uff0c\u8ba1\u7b97\u51fa\u54ea\u4e9b\u6e38\u620f\u9879\u662f\u53ef\u89c1\u7684\uff0c\u5e76\u5728\u7ed8\u5236\u5b9e\u4f8b\u7f51\u683c\u548c\u975e\u5b9e\u4f8b\u7f51\u683c\u65f6\u8fc7\u6ee4\u6389\u5b83\u4eec\uff1a frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); \u4f60\u53ef\u4ee5\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u529f\u80fd\uff0c\u5e76\u53ef\u4ee5\u68c0\u67e5\u4f60\u53ef\u4ee5\u8fbe\u5230\u7684FPS\u7684\u589e\u52a0\u548c\u51cf\u5c11\u3002\u5728\u8fc7\u6ee4\u65f6\u4e0d\u8003\u8651\u7c92\u5b50\uff0c\u4f46\u662f\u6dfb\u52a0\u5b83\u662f\u5f88\u7b80\u5355\u7684\u3002\u5bf9\u4e8e\u7c92\u5b50\uff0c\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\u6700\u597d\u68c0\u67e5\u53d1\u5c04\u5668\u7684\u4f4d\u7f6e\uff0c\u800c\u4e0d\u662f\u68c0\u67e5\u6bcf\u4e2a\u7c92\u5b50\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e00"},{"location":"25-optimizations-frustum-culling/#-_1","text":"\u89e3\u91ca\u4e86\u622a\u9525\u5254\u9664\u7684\u57fa\u7840\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 JOML \u5e93\u4e2d\u63d0\u4f9b\u7684\u66f4\u7cbe\u7ec6\u7684\u65b9\u6cd5\u3002\u5b83\u7279\u522b\u5730\u63d0\u4f9b\u4e86\u4e00\u4e2a\u540d\u4e3a FrustumIntersection \u7684\u7c7b\uff0c\u8be5\u7c7b\u4ee5\u6309\u6b64 \u6587\u7ae0 \u6240\u8ff0\u7684\u4e00\u79cd\u66f4\u6709\u6548\u7684\u65b9\u5f0f\u83b7\u53d6\u89c6\u9525\u4f53\u7684\u5e73\u9762\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u6d4b\u8bd5\u8fb9\u754c\u76d2\u3001\u70b9\u548c\u7403\u4f53\u7684\u65b9\u6cd5\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u4fee\u6539 FrustumCullingFilter \u7c7b\u3002\u5c5e\u6027\u548c\u6784\u9020\u51fd\u6570\u7b80\u5316\u5982\u4e0b\uff1a public class FrustumCullingFilter { private final Matrix4f prjViewMatrix; private FrustumIntersection frustumInt; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumInt = new FrustumIntersection(); } updateFrustum \u65b9\u6cd5\u53ea\u662f\u5c06\u5e73\u9762\u83b7\u53d6\u59d4\u6258\u7ed9 FrustumIntersection \u5b9e\u4f8b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u66f4\u65b0\u622a\u9525\u76f8\u4ea4\u7c7b frustumInt.set(prjViewMatrix); } insideFrustum \u65b9\u6cd5\u66f4\u7b80\u5355\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { return frustumInt.testSphere(x0, y0, z0, boundingRadius); } \u4f7f\u7528\u8be5\u65b9\u6cd5\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u8fbe\u5230\u66f4\u9ad8\u7684FPS\u3002\u6b64\u5916\uff0c\u8fd8\u5411 Window \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u5168\u5c40\u6807\u8bb0\uff0c\u4ee5\u542f\u7528\u6216\u7981\u7528\u622a\u9525\u5254\u9664\u3002 GameItem \u7c7b\u4e5f\u6709\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u7684\u6807\u8bb0\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u67d0\u4e9b\u9879\uff0c\u622a\u9525\u5254\u9664\u8fc7\u6ee4\u53ef\u80fd\u6ca1\u6709\u610f\u4e49\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e8c"},{"location":"26-cascaded-shadow-maps/","text":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09 \u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4ecb\u7ecd\u4e86\u9634\u5f71\u6620\u5c04\u6280\u672f\uff0c\u4ee5\u4fbf\u5728\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u65f6\u4f7f\u7528\u5e73\u884c\u5149\u663e\u793a\u9634\u5f71\u3002\u6b64\u524d\u4ecb\u7ecd\u7684\u65b9\u6848\u4e2d\u8981\u6c42\u4f60\u624b\u52a8\u8c03\u6574\u4e00\u4e9b\u53c2\u6570\u4ee5\u6539\u8fdb\u6548\u679c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u8be5\u6280\u672f\uff0c\u4ee5\u81ea\u52a8\u5316\u6240\u6709\u6d41\u7a0b\uff0c\u5e76\u6539\u8fdb\u5728\u5f00\u653e\u7a7a\u95f4\u4e2d\u7684\u6548\u679c\u3002\u4e3a\u4e86\u8fbe\u5230\u76ee\u7684\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CMS\uff0cCascaded Shadow Map\uff09\u7684\u6280\u672f\u3002 \u8ba9\u6211\u4eec\u9996\u5148\u770b\u4e00\u4e0b\u5982\u4f55\u81ea\u52a8\u6784\u9020\u7528\u4e8e\u6e32\u67d3\u9634\u5f71\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u5982\u679c\u4f60\u56de\u60f3\u9634\u5f71\u4e00\u7ae0\uff0c\u6211\u4eec\u9700\u8981\u4ece\u5149\u7ebf\u7684\u89d2\u5ea6\u6765\u7ed8\u5236\u573a\u666f\u3002\u8fd9\u610f\u5473\u7740\u521b\u5efa\u4e00\u4e2a\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5b83\u5c31\u50cf\u4e00\u4e2a\u4f5c\u7528\u4e8e\u5149\u6e90\u7684\u6444\u50cf\u673a\u548c\u4e00\u4e2a\u6295\u5f71\u77e9\u9635\u3002\u7531\u4e8e\u5149\u662f\u5b9a\u5411\u7684\uff0c\u800c\u4e14\u5e94\u8be5\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\uff0c\u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4e86\u6b63\u4ea4\u6295\u5f71\u3002 \u6211\u4eec\u5e0c\u671b\u6240\u6709\u53ef\u89c1\u7684\u7269\u4f53\u90fd\u9002\u7528\u4e8e\u5149\u7167\u89c6\u56fe\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5c06\u89c6\u622a\u9525\u653e\u5165\u5149\u622a\u9525\u4e2d\u3002\u4e0b\u56fe\u662f\u6211\u4eec\u6700\u7ec8\u60f3\u8981\u5b9e\u73b0\u7684\u6548\u679c\uff1a \u8be5\u5982\u4f55\u6784\u9020\u5b83\uff1f\u9996\u5148\u662f\u8ba1\u7b97\u89c2\u5bdf\u6295\u5f71\u77e9\u9635\u7684\u622a\u9525\u9876\u70b9\u3002\u6211\u4eec\u5f97\u5230\u4e16\u754c\u7a7a\u95f4\u7684\u5750\u6807\uff0c\u7136\u540e\u8ba1\u7b97\u8fd9\u4e2a\u622a\u9525\u7684\u4e2d\u5fc3\uff0c\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06\u6240\u6709\u7684\u9876\u70b9\u7684\u5750\u6807\u76f8\u52a0\u5e76\u5c06\u7ed3\u679c\u9664\u4ee5\u9876\u70b9\u7684\u6570\u91cf\u6765\u8ba1\u7b97\u3002 \u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8bbe\u7f6e\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u5176\u4f4d\u7f6e\u53ca\u5176\u65b9\u5411\u5c06\u7528\u4e8e\u6784\u5efa\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u4f4d\u7f6e\uff0c\u6211\u4eec\u4ece\u6b64\u524d\u5f97\u5230\u7684\u89c6\u9525\u4f53\u7684\u4e2d\u5fc3\u5f00\u59cb\uff0c\u9006\u7740\u5149\u7684\u65b9\u5411\uff0c\u53d6\u76f8\u5f53\u4e8e\u89c6\u9525\u4f53\u7684\u8fd1Z\u5e73\u9762\u548c\u8fdcZ\u5e73\u9762\u7684\u8ddd\u79bb\u7684\u4e00\u70b9\u3002 \u6784\u5efa\u5b8c\u6210\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u5b83\u4eec\uff0c\u6211\u4eec\u5c06\u622a\u9525\u7684\u9876\u70b9\u8f6c\u6362\u5230\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\uff0c\u53ea\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u521a\u521a\u6784\u5efa\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u6295\u5f71\u77e9\u9635\u7684\u5c3a\u5bf8\u662f\u6700\u5927\u548c\u6700\u5c0f\u7684X\u548cY\u503c\uff0c\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u4e0e\u6807\u51c6\u6295\u5f71\u77e9\u9635\u76f8\u540c\u7684\u503c\uff0c\u8fdcZ\u5e73\u9762\u5219\u662f\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\u4e2d\u622a\u9525\u9876\u70b9\u7684\u6700\u5927\u548c\u6700\u5c0fZ\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 \u4f46\u662f\uff0c\u5982\u679c\u5728\u9634\u5f71\u793a\u4f8b\u4ee3\u7801\u7684\u57fa\u7840\u4e0a\u5b9e\u73b0\u4e0a\u8ff0\u7b97\u6cd5\uff0c\u5219\u53ef\u80fd\u4f1a\u5bf9\u9634\u5f71\u8d28\u91cf\u611f\u5230\u5931\u671b\u3002 \u539f\u56e0\u662f\u9634\u5f71\u5206\u8fa8\u7387\u53d7\u7eb9\u7406\u5927\u5c0f\u7684\u9650\u5236\u3002\u6211\u4eec\u73b0\u5728\u6b63\u8986\u76d6\u4e00\u4e2a\u6f5c\u5728\u7684\u5de8\u5927\u533a\u57df\uff0c\u5e76\u4e14\u6211\u4eec\u7528\u6765\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u6ca1\u6709\u8db3\u591f\u7684\u5206\u8fa8\u7387\u6765\u53d6\u5f97\u826f\u597d\u7684\u6548\u679c\u3002\u4f60\u53ef\u80fd\u8ba4\u4e3a\u89e3\u51b3\u65b9\u6cd5\u53ea\u662f\u63d0\u9ad8\u7eb9\u7406\u5206\u8fa8\u7387\uff0c\u4f46\u8fd9\u5e76\u4e0d\u8db3\u4ee5\u5b8c\u5168\u89e3\u51b3\u95ee\u9898\uff0c\u4f60\u9700\u8981\u5de8\u5927\u7684\u7eb9\u7406\u3002 \u6709\u4e00\u4e2a\u66f4\u806a\u660e\u7684\u89e3\u51b3\u65b9\u6848\u3002\u5176\u5173\u952e\u662f\uff0c\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u9700\u8981\u6bd4\u8fdc\u5904\u7269\u4f53\u7684\u9634\u5f71\u6709\u66f4\u9ad8\u7684\u8d28\u91cf\u3002\u4e00\u79cd\u65b9\u6cd5\u662f\u53ea\u6e32\u67d3\u9760\u8fd1\u6444\u50cf\u673a\u7684\u5bf9\u8c61\u7684\u9634\u5f71\uff0c\u4f46\u8fd9\u4f1a\u5bfc\u81f4\u9634\u5f71\u5728\u573a\u666f\u4e2d\u79fb\u52a8\u65f6\u51fa\u73b0\u6216\u6d88\u5931\u3002 \u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CSM\uff09\u4f7f\u7528\u7684\u65b9\u6cd5\u662f\u5c06\u89c6\u9525\u4f53\u5206\u5272\u4e3a\u591a\u4e2a\u90e8\u5206\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u8f83\u5c0f\u7684\u533a\u57df\uff0c\u800c\u8ddd\u79bb\u8f83\u8fdc\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u66f4\u5e7f\u7684\u533a\u57df\u3002\u4e0b\u56fe\u663e\u793a\u4e86\u628a\u4e00\u4e2a\u89c6\u9525\u4f53\u5206\u4e3a\u4e09\u4e2a\u90e8\u5206\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff0c\u5c06\u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\uff0c\u8c03\u6574\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u4ee5\u5408\u9002\u5730\u8986\u76d6\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u3002\u56e0\u6b64\uff0c\u50a8\u5b58\u6df1\u5ea6\u6620\u5c04\u7684\u7eb9\u7406\u8986\u76d6\u89c6\u9525\u4f53\u7684\u533a\u57df\u7f29\u5c0f\u4e86\u3002\u800c\u4e14\uff0c\u7531\u4e8e\u79bb\u6444\u50cf\u673a\u6700\u8fd1\u7684\u90e8\u5206\u4f1a\u5360\u7528\u8f83\u5c11\u7684\u7a7a\u95f4\uff0c\u56e0\u6b64\u6df1\u5ea6\u5206\u8fa8\u7387\u4f1a\u63d0\u9ad8\u3002 \u4ece\u4e0a\u8ff0\u89e3\u91ca\u53ef\u4ee5\u770b\u51fa\uff0c\u6211\u4eec\u9700\u8981\u5c3d\u53ef\u80fd\u591a\u7684\u5c06\u6df1\u5ea6\u56fe\u8fdb\u884c\u5206\u5272\uff0c\u6211\u4eec\u8fd8\u5c06\u66f4\u6539\u6bcf\u4e2a\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u8981\u4f7f\u7528CSM\u9700\u8981\u505a\u7684\u4e8b\u60c5\u662f\uff1a \u5c06\u89c6\u9525\u4f53\u5206\u4e3an\u4e2a\u90e8\u5206\u3002 \u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\u65f6\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff1a \u8ba1\u7b97\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u5c06\u573a\u666f\u6e32\u67d3\u4e3a\u5355\u72ec\u7684\u6df1\u5ea6\u56fe\u3002 \u6e32\u67d3\u573a\u666f\u65f6\uff1a \u4f7f\u7528\u6b64\u524d\u8ba1\u7b97\u7684\u6df1\u5ea6\u56fe\u3002 \u786e\u5b9a\u8981\u7ed8\u5236\u7684\u7247\u6bb5\u6240\u5c5e\u7684\u90e8\u5206\u3002 \u8ba1\u7b97\u9634\u5f71\u56e0\u5b50\uff0c\u5982\u9634\u5f71\u6620\u5c04\u4e2d\u6240\u8ff0\u3002 \u5982\u4f60\u6240\u89c1\uff0cCSM\u7684\u4e3b\u8981\u7f3a\u70b9\u662f\u6211\u4eec\u9700\u8981\u4ece\u706f\u5149\u7684\u89d2\u5ea6\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6e32\u67d3\u573a\u666f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u901a\u5e38\u53ea\u7528\u4e8e\u5f00\u653e\u7a7a\u95f4\u7684\u539f\u56e0\u3002\u4e0d\u7ba1\u600e\u4e48\u8bf4\uff0c\u6211\u4eec\u5c06\u53ef\u4ee5\u770b\u5230\u5982\u4f55\u8f7b\u677e\u5730\u51cf\u5c11\u5f00\u9500\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u4ee3\u7801\u3002\u4f46\u662f\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u6709\u4e00\u4e2a\u5c0f\u5c0f\u7684\u63d0\u9192\uff0c\u6211\u4e0d\u4f1a\u5728\u8fd9\u91cc\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u8fd9\u4f1a\u975e\u5e38\u67af\u71e5\u3002\u76f8\u53cd\uff0c\u6211\u5c06\u4ecb\u7ecd\u4e3b\u8981\u7c7b\u3001\u5b83\u4eec\u7684\u804c\u8d23\u548c\u53ef\u80fd\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u7247\u6bb5\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u3002\u6240\u6709\u4e0e\u7740\u8272\u76f8\u5173\u7684\u7c7b\u90fd\u5df2\u79fb\u52a8\u5230\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.graph.shadow \u7684\u65b0\u5305\u4e2d\u3002 \u6e32\u67d3\u9634\u5f71\u7684\u4ee3\u7801\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u4ece\u5149\u5f71\u900f\u89c6\u7684\u573a\u666f\u5df2\u7ecf\u79fb\u52a8\u5230\u4e86 ShadowRenderer \u7c7b\u4e2d\u3002\uff08\u8be5\u4ee3\u7801\u4ee5\u524d\u5728 Renderer \u7c7b\u4e2d\uff09\u3002 \u7c7b\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5e38\u91cf\uff1a public static final int NUM_CASCADES = 3; public static final float[] CASCADE_SPLITS = new float[]{Window.Z_FAR / 20.0f, Window.Z_FAR / 10.0f, Window.Z_FAR}; \u9996\u5148\u662f\u5c42\u7ea7\u6216\u62c6\u5206\u7684\u6570\u91cf\u3002\u7b2c\u4e8c\u4e2a\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u62c6\u5206\u7684\u90e8\u5206\u7684\u8fdcZ\u5e73\u9762\u7684\u4f4d\u7f6e\u3002\u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u7684\u95f4\u8ddd\u5e76\u4e0d\u76f8\u7b49\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u5728Z\u5e73\u9762\u4e0a\u7684\u8ddd\u79bb\u6700\u77ed\u3002 \u7c7b\u8fd8\u50a8\u5b58\u4e86\u7528\u4e8e\u6e32\u67d3\u6df1\u5ea6\u56fe\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u7684\u5f15\u7528\uff0c\u4e00\u4e2a\u5217\u8868\uff0c\u5176\u4e2d\u5305\u542b\u4e0e\u6bcf\u4e2a\u90e8\u5206\u76f8\u5173\u8054\u7684\u4fe1\u606f\uff0c\u5176\u7531 ShadowCascade \u7c7b\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5bf9\u50a8\u5b58\u6df1\u5ea6\u56fe\u6570\u636e\uff08\u7eb9\u7406\uff09\u7684\u5bf9\u8c61\u7684\u5f15\u7528\uff0c\u7531 ShadowBuffer \u7c7b\u5b9a\u4e49\u3002 ShadowRenderer \u7c7b\u5177\u6709\u7528\u4e8e\u8bbe\u7f6e\u7740\u8272\u5668\u548c\u6240\u9700\u5c5e\u6027\u7684\u65b9\u6cd5\u4ee5\u53ca\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\u3002 render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window, Scene scene, Camera camera, Transformation transformation, Renderer renderer) { update(window, camera.getViewMatrix(), scene); // \u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5927\u5c0f glBindFramebuffer(GL_FRAMEBUFFER, shadowBuffer.getDepthMapFBO()); glViewport(0, 0, ShadowBuffer.SHADOW_MAP_WIDTH, ShadowBuffer.SHADOW_MAP_HEIGHT); glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); // \u4e3a\u6bcf\u5c42\u56fe\u6e32\u67d3\u573a\u666f for (int i = 0; i < NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); depthShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix()); depthShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix()); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); glClear(GL_DEPTH_BUFFER_BIT); renderNonInstancedMeshes(scene, transformation); renderInstancedMeshes(scene, transformation); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6267\u884c\u7684\u51e0\u4e2a\u6e32\u67d3\u8fc7\u7a0b\uff0c\u7c7b\u4f3c\u4e8e\u6b64\u524d\u9634\u5f71\u56fe\u7684\u6e32\u67d3\u65b9\u6cd5\u3002\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u4f1a\u4f7f\u7528\u76f8\u5173\u7684 ShadowCascade \u5b9e\u4f8b\u4e2d\u4fdd\u51fd\u7684\u4fe1\u606f\u66f4\u6539\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002 \u6b64\u5916\uff0c\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u9700\u8981\u66f4\u6539\u6b63\u5728\u4f7f\u7528\u7684\u7eb9\u7406\u3002\u6bcf\u6b21\u90fd\u4f1a\u5c06\u6df1\u5ea6\u4fe1\u606f\u6e32\u67d3\u4e3a\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u6b64\u4fe1\u606f\u50a8\u5b58\u5728 ShadowBuffer \u7c7b\u4e2d\uff0c\u5e76\u8bbe\u7f6e\u4e3a\u4f9bFBO\u4f7f\u7528\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); \u6b63\u5982\u521a\u521a\u63d0\u5230\u7684\uff0c ShadowBuffer \u7c7b\u50a8\u5b58\u4e0e\u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u76f8\u5173\u7684\u4fe1\u606f\u3002\u4ee3\u7801\u4e0e\u9634\u5f71\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u4ee3\u7801\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u6211\u4eec\u4f7f\u7528\u7684\u662f\u7eb9\u7406\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684\u7c7b ArrTexture \uff0c\u5b83\u521b\u5efa\u4e86\u4e00\u4e2a\u5177\u6709\u76f8\u540c\u5c5e\u6027\u7684\u7eb9\u7406\u6570\u7ec4\u3002\u6b64\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a bind \u65b9\u6cd5\uff0c\u7528\u4e8e\u7ed1\u5b9a\u6240\u6709\u7eb9\u7406\u6570\u7ec4\uff0c\u4ee5\u4fbf\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u8be5\u65b9\u6cd5\u63a5\u6536\u4e00\u4e2a\u53c2\u6570\uff0c\u4ece\u67d0\u4e2a\u7eb9\u7406\u5355\u5143\u5f00\u59cb\u7ed1\u5b9a\u3002 public void bindTextures(int start) { for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { glActiveTexture(start + i); glBindTexture(GL_TEXTURE_2D, depthMap.getIds()[i]); } } ShadowCascade \u7c7b\u50a8\u5b58\u4e0e\u4e00\u4e2a\u90e8\u5206\u5173\u8054\u7684\u5149\u7167\u89c6\u56fe\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u7531\u4e00\u4e2a\u8fd1Z\u5e73\u9762\u8ddd\u79bb\u548c\u4e00\u4e2a\u8fdcZ\u5e73\u9762\u8ddd\u79bb\u5b9a\u4e49\uff0c\u5e76\u6839\u636e\u8be5\u4fe1\u606f\u8ba1\u7b97\u77e9\u9635\u3002 \u8be5\u7c7b\u63d0\u4f9b\u5e76\u66f4\u65b0\u4e86\u4ee5\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u65b9\u5411\u4e3a\u8f93\u5165\u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u9996\u5148\u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u89c6\u9525\u9876\u70b9\uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u6839\u636e\u5149\u7684\u65b9\u5411\uff0c\u4ece\u622a\u9525\u7684\u4e2d\u5fc3\u5230\u76f8\u5f53\u4e8e\u8fdcZ\u5e73\u9762\u5230\u8fd1Z\u5e73\u9762\u4e4b\u95f4\u7684\u8ddd\u79bb\u7684\u8ddd\u79bb\uff0c\u8ba1\u7b97\u51fa\u8be5\u4f4d\u7f6e\u3002 public void update(Window window, Matrix4f viewMatrix, DirectionalLight light) { // \u4e3a\u6b64\u5c42\u751f\u6210\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 float aspectRatio = (float) window.getWidth() / (float) window.getHeight(); projViewMatrix.setPerspective(Window.FOV, aspectRatio, zNear, zFar); projViewMatrix.mul(viewMatrix); // \u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u9876\u70b9 float maxZ = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; corner.set(0, 0, 0); projViewMatrix.frustumCorner(i, corner); centroid.add(corner); centroid.div(8.0f); minZ = Math.min(minZ, corner.z); maxZ = Math.max(maxZ, corner.z); } // \u4ece\u8d28\u5fc3\u9006\u7740\u5149\u7684\u65b9\u5411\u4e0amax.z-min.z\u7684\u8ddd\u79bb Vector3f lightDirection = light.getDirection(); Vector3f lightPosInc = new Vector3f().set(lightDirection); float distance = maxZ - minZ; lightPosInc.mul(distance); Vector3f lightPosition = new Vector3f(); lightPosition.set(centroid); lightPosition.add(lightPosInc); updateLightViewMatrix(lightDirection, lightPosition); updateLightProjectionMatrix(); } \u6839\u636e\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u6211\u4eec\u53ef\u4ee5\u6784\u9020\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightViewMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void updateLightViewMatrix(Vector3f lightDirection, Vector3f lightPosition) { float lightAngleX = (float) Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float) Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Transformation.updateGenericViewMatrix(lightPosition, new Vector3f(lightAngleX, lightAngleY, lightAngleZ), lightViewMatrix); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u6784\u9020\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightProjectionMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8be5\u65b9\u6cd5\u5c06\u89c6\u9525\u4f53\u5750\u6807\u8f6c\u6362\u5230\u5149\u7167\u7a7a\u95f4\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230x\u3001y\u5750\u6807\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\u6765\u6784\u9020\u5305\u56f4\u89c6\u9525\u4f53\u7684\u8fb9\u754c\u6846\u3002\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a0\uff0c\u8fdcZ\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u5750\u6807\u7684\u6700\u5927\u503c\u548c\u6700\u5c0f\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 private void updateLightProjectionMatrix() { // \u73b0\u5728\u8ba1\u7b97\u5149\u7167\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u5927\u5c0f\u3002 float minX = Float.MAX_VALUE; float maxX = -Float.MAX_VALUE; float minY = Float.MAX_VALUE; float maxY = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; float maxZ = -Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; tmpVec.set(corner, 1); tmpVec.mul(lightViewMatrix); minX = Math.min(tmpVec.x, minX); maxX = Math.max(tmpVec.x, maxX); minY = Math.min(tmpVec.y, minY); maxY = Math.max(tmpVec.y, maxY); minZ = Math.min(tmpVec.z, minZ); maxZ = Math.max(tmpVec.z, maxZ); } float distz = maxZ - minZ; orthoProjMatrix.setOrtho(minX, maxX, minY, maxY, 0, distz); } \u8bb0\u4f4f\uff0c\u6b63\u4ea4\u6295\u5f71\u5c31\u50cf\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5e94\u8be5\u5305\u542b\u6240\u6709\u5c06\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u3002\u8be5\u8fb9\u754c\u6846\u4ee5\u5149\u7167\u89c6\u56fe\u5750\u6807\u7a7a\u95f4\u8868\u793a\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u8ba1\u7b97\u5305\u56f4\u89c6\u9525\u4f53\u7684\u6700\u5c0f\u8fb9\u754c\u6846\uff0c\u8f74\u4e0e\u5149\u6e90\u4f4d\u7f6e\u5bf9\u9f50\u3002 Renderer \u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u4f7f\u7528\u89c6\u56fe\u5305\u4e2d\u7684\u7c7b\u4ee5\u53ca\u4fee\u6539\u4f20\u9012\u7ed9\u6e32\u67d3\u5668\u7684\u4fe1\u606f\u3002\u5728\u6e32\u67d3\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u6a21\u578b\u3001\u6a21\u578b\u89c2\u5bdf\u548c\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u6216\u5149\u7167\u89c6\u56fe\u77e9\u9635\u6765\u51cf\u5c11\u64cd\u4f5c\u7684\u6570\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9009\u62e9\u7b80\u5316\u8981\u4f20\u9012\u7684\u5143\u7d20\u7684\u6570\u91cf\uff0c\u73b0\u5728\u53ea\u5c06\u6a21\u578b\u3001\u89c2\u5bdf\u548c\u5149\u7167\u77e9\u9635\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u6b64\u5916\uff0c\u5bf9\u4e8e\u7c92\u5b50\uff0c\u6211\u4eec\u9700\u8981\u4fdd\u7559\u6bd4\u4f8b\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u518d\u4f20\u9012\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u6240\u4ee5\u73b0\u5728\u4fe1\u606f\u5c06\u4e22\u5931\u3002\u6211\u4eec\u91cd\u7528\u7528\u4e8e\u6807\u8bb0\u6240\u9009\u9879\u7684\u5c5e\u6027\u6765\u8bbe\u7f6e\u6bd4\u4f8b\u4fe1\u606f\u3002\u5728\u7c92\u5b50\u7740\u8272\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u503c\u518d\u6b21\u8bbe\u7f6e\u7f29\u653e\u3002 \u5728\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u8ba1\u7b97\u6a21\u578b\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5e76\u5c06\u5176\u4f5c\u4e3a\u8f93\u51fa\u4f20\u9012\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 mvVertexPos = mvPos.xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * vec4(position, 1.0); } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u503c\u6839\u636e\u7247\u5143\u6240\u5904\u7684\u90e8\u5206\u6765\u67e5\u8be2\u9002\u5f53\u7684\u6df1\u5ea6\u56fe\u3002\u8fd9\u9700\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u7279\u5b9a\u9879\u76ee\uff0c\u5b83\u4eec\u7684\u7247\u5143\u53ef\u80fd\u4f4d\u4e8e\u4e0d\u540c\u7684\u90e8\u5206\u4e2d\u3002 \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5fc5\u987b\u51b3\u5b9a\u8981\u5206\u6210\u54ea\u4e2a\u90e8\u5206\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u4f7f\u7528\u7247\u5143\u7684Z\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u6bcf\u4e2a\u90e8\u5206\u7684\u6700\u5927Z\u503c\u8fdb\u884c\u6bd4\u8f83\uff0c\u4e5f\u5c31\u662f\u8fdcZ\u5e73\u9762\u503c\u3002\u8fd9\u4e9b\u6570\u636e\u4f5c\u4e3a\u4e00\u4e2a\u65b0\u7684Uniform\u4f20\u9012\uff1a uniform float cascadeFarPlanes[NUM_CASCADES]; \u5982\u4e0b\u6240\u793a\uff0c\u6211\u4eec\u8ba1\u7b97\u5206\u5272\u7684\u90e8\u5206\uff0c\u53d8\u91cf idx \u5c06\u50a8\u5b58\u8981\u4f7f\u7528\u7684\u90e8\u5206\uff1a int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } \u6b64\u5916\uff0c\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u7eb9\u7406\u6570\u7ec4\uff0c\u4e00\u4e2a sampler2D \u6570\u7ec4\uff0c\u7528\u4e8e\u6df1\u5ea6\u56fe\uff0c\u5373\u4e0e\u6211\u4eec\u5206\u5272\u90e8\u5206\u76f8\u5173\u8054\u7684\u7eb9\u7406\u3002\u6e90\u4ee3\u7801\u7528\u4e00\u4e2aUniform\u5217\u8868\uff08\u800c\u4e0d\u662f\u4f7f\u7528\u6570\u7ec4\uff09\u50a8\u5b58\u7528\u4e8e\u5f15\u7528\u4e0e\u6bcf\u4e2a\u90e8\u5206\u5173\u8054\u7684\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u5355\u5143\u3002 uniform sampler2D normalMap; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; \u5c06\u5176\u66f4\u6539\u4e3a\u4e00\u7ec4Uniform\u4f1a\u5bfc\u81f4\u96be\u4ee5\u8ffd\u8e2a\u6b64\u793a\u4f8b\u7684\u5176\u4ed6\u7eb9\u7406\u51fa\u73b0\u7684\u95ee\u9898\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u5c1d\u8bd5\u5728\u4ee3\u7801\u4e2d\u4fee\u6539\u5b83\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4f59\u4fee\u6539\u548c\u7740\u8272\u5668\u53ea\u662f\u57fa\u4e8e\u4e0a\u8ff0\u66f4\u6539\u6240\u9700\u7684\u8c03\u6574\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u6700\u540e\uff0c\u5f53\u5f15\u5165\u8fd9\u4e9b\u66f4\u6539\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u6027\u80fd\u4e0b\u964d\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u7ed8\u5236\u7684\u6df1\u5ea6\u56fe\u662f\u6b64\u524d\u7684\u4e09\u500d\u3002\u5982\u679c\u6444\u50cf\u673a\u672a\u88ab\u79fb\u52a8\u6216\u573a\u666f\u9879\u672a\u53d1\u751f\u66f4\u6539\uff0c\u5219\u4e0d\u9700\u8981\u53cd\u590d\u6e32\u67d3\u6df1\u5ea6\u56fe\u3002\u6df1\u5ea6\u56fe\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u6e05\u9664\u5b83\u4eec\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5728 render \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u53d8\u91cf\uff0c\u7528\u4e8e\u6307\u793a\u662f\u5426\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4ee5\u907f\u514d\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4f7f\u5176\u4fdd\u6301\u4e0d\u53d8\uff0c\u8fd9\u4f1a\u663e\u8457\u63d0\u9ad8FPS\u3002\u6700\u7ec8\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a","title":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04"},{"location":"26-cascaded-shadow-maps/#cascaded-shadow-maps","text":"\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4ecb\u7ecd\u4e86\u9634\u5f71\u6620\u5c04\u6280\u672f\uff0c\u4ee5\u4fbf\u5728\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u65f6\u4f7f\u7528\u5e73\u884c\u5149\u663e\u793a\u9634\u5f71\u3002\u6b64\u524d\u4ecb\u7ecd\u7684\u65b9\u6848\u4e2d\u8981\u6c42\u4f60\u624b\u52a8\u8c03\u6574\u4e00\u4e9b\u53c2\u6570\u4ee5\u6539\u8fdb\u6548\u679c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u8be5\u6280\u672f\uff0c\u4ee5\u81ea\u52a8\u5316\u6240\u6709\u6d41\u7a0b\uff0c\u5e76\u6539\u8fdb\u5728\u5f00\u653e\u7a7a\u95f4\u4e2d\u7684\u6548\u679c\u3002\u4e3a\u4e86\u8fbe\u5230\u76ee\u7684\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CMS\uff0cCascaded Shadow Map\uff09\u7684\u6280\u672f\u3002 \u8ba9\u6211\u4eec\u9996\u5148\u770b\u4e00\u4e0b\u5982\u4f55\u81ea\u52a8\u6784\u9020\u7528\u4e8e\u6e32\u67d3\u9634\u5f71\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u5982\u679c\u4f60\u56de\u60f3\u9634\u5f71\u4e00\u7ae0\uff0c\u6211\u4eec\u9700\u8981\u4ece\u5149\u7ebf\u7684\u89d2\u5ea6\u6765\u7ed8\u5236\u573a\u666f\u3002\u8fd9\u610f\u5473\u7740\u521b\u5efa\u4e00\u4e2a\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5b83\u5c31\u50cf\u4e00\u4e2a\u4f5c\u7528\u4e8e\u5149\u6e90\u7684\u6444\u50cf\u673a\u548c\u4e00\u4e2a\u6295\u5f71\u77e9\u9635\u3002\u7531\u4e8e\u5149\u662f\u5b9a\u5411\u7684\uff0c\u800c\u4e14\u5e94\u8be5\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\uff0c\u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4e86\u6b63\u4ea4\u6295\u5f71\u3002 \u6211\u4eec\u5e0c\u671b\u6240\u6709\u53ef\u89c1\u7684\u7269\u4f53\u90fd\u9002\u7528\u4e8e\u5149\u7167\u89c6\u56fe\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5c06\u89c6\u622a\u9525\u653e\u5165\u5149\u622a\u9525\u4e2d\u3002\u4e0b\u56fe\u662f\u6211\u4eec\u6700\u7ec8\u60f3\u8981\u5b9e\u73b0\u7684\u6548\u679c\uff1a \u8be5\u5982\u4f55\u6784\u9020\u5b83\uff1f\u9996\u5148\u662f\u8ba1\u7b97\u89c2\u5bdf\u6295\u5f71\u77e9\u9635\u7684\u622a\u9525\u9876\u70b9\u3002\u6211\u4eec\u5f97\u5230\u4e16\u754c\u7a7a\u95f4\u7684\u5750\u6807\uff0c\u7136\u540e\u8ba1\u7b97\u8fd9\u4e2a\u622a\u9525\u7684\u4e2d\u5fc3\uff0c\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06\u6240\u6709\u7684\u9876\u70b9\u7684\u5750\u6807\u76f8\u52a0\u5e76\u5c06\u7ed3\u679c\u9664\u4ee5\u9876\u70b9\u7684\u6570\u91cf\u6765\u8ba1\u7b97\u3002 \u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8bbe\u7f6e\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u5176\u4f4d\u7f6e\u53ca\u5176\u65b9\u5411\u5c06\u7528\u4e8e\u6784\u5efa\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u4f4d\u7f6e\uff0c\u6211\u4eec\u4ece\u6b64\u524d\u5f97\u5230\u7684\u89c6\u9525\u4f53\u7684\u4e2d\u5fc3\u5f00\u59cb\uff0c\u9006\u7740\u5149\u7684\u65b9\u5411\uff0c\u53d6\u76f8\u5f53\u4e8e\u89c6\u9525\u4f53\u7684\u8fd1Z\u5e73\u9762\u548c\u8fdcZ\u5e73\u9762\u7684\u8ddd\u79bb\u7684\u4e00\u70b9\u3002 \u6784\u5efa\u5b8c\u6210\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u5b83\u4eec\uff0c\u6211\u4eec\u5c06\u622a\u9525\u7684\u9876\u70b9\u8f6c\u6362\u5230\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\uff0c\u53ea\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u521a\u521a\u6784\u5efa\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u6295\u5f71\u77e9\u9635\u7684\u5c3a\u5bf8\u662f\u6700\u5927\u548c\u6700\u5c0f\u7684X\u548cY\u503c\uff0c\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u4e0e\u6807\u51c6\u6295\u5f71\u77e9\u9635\u76f8\u540c\u7684\u503c\uff0c\u8fdcZ\u5e73\u9762\u5219\u662f\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\u4e2d\u622a\u9525\u9876\u70b9\u7684\u6700\u5927\u548c\u6700\u5c0fZ\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 \u4f46\u662f\uff0c\u5982\u679c\u5728\u9634\u5f71\u793a\u4f8b\u4ee3\u7801\u7684\u57fa\u7840\u4e0a\u5b9e\u73b0\u4e0a\u8ff0\u7b97\u6cd5\uff0c\u5219\u53ef\u80fd\u4f1a\u5bf9\u9634\u5f71\u8d28\u91cf\u611f\u5230\u5931\u671b\u3002 \u539f\u56e0\u662f\u9634\u5f71\u5206\u8fa8\u7387\u53d7\u7eb9\u7406\u5927\u5c0f\u7684\u9650\u5236\u3002\u6211\u4eec\u73b0\u5728\u6b63\u8986\u76d6\u4e00\u4e2a\u6f5c\u5728\u7684\u5de8\u5927\u533a\u57df\uff0c\u5e76\u4e14\u6211\u4eec\u7528\u6765\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u6ca1\u6709\u8db3\u591f\u7684\u5206\u8fa8\u7387\u6765\u53d6\u5f97\u826f\u597d\u7684\u6548\u679c\u3002\u4f60\u53ef\u80fd\u8ba4\u4e3a\u89e3\u51b3\u65b9\u6cd5\u53ea\u662f\u63d0\u9ad8\u7eb9\u7406\u5206\u8fa8\u7387\uff0c\u4f46\u8fd9\u5e76\u4e0d\u8db3\u4ee5\u5b8c\u5168\u89e3\u51b3\u95ee\u9898\uff0c\u4f60\u9700\u8981\u5de8\u5927\u7684\u7eb9\u7406\u3002 \u6709\u4e00\u4e2a\u66f4\u806a\u660e\u7684\u89e3\u51b3\u65b9\u6848\u3002\u5176\u5173\u952e\u662f\uff0c\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u9700\u8981\u6bd4\u8fdc\u5904\u7269\u4f53\u7684\u9634\u5f71\u6709\u66f4\u9ad8\u7684\u8d28\u91cf\u3002\u4e00\u79cd\u65b9\u6cd5\u662f\u53ea\u6e32\u67d3\u9760\u8fd1\u6444\u50cf\u673a\u7684\u5bf9\u8c61\u7684\u9634\u5f71\uff0c\u4f46\u8fd9\u4f1a\u5bfc\u81f4\u9634\u5f71\u5728\u573a\u666f\u4e2d\u79fb\u52a8\u65f6\u51fa\u73b0\u6216\u6d88\u5931\u3002 \u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CSM\uff09\u4f7f\u7528\u7684\u65b9\u6cd5\u662f\u5c06\u89c6\u9525\u4f53\u5206\u5272\u4e3a\u591a\u4e2a\u90e8\u5206\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u8f83\u5c0f\u7684\u533a\u57df\uff0c\u800c\u8ddd\u79bb\u8f83\u8fdc\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u66f4\u5e7f\u7684\u533a\u57df\u3002\u4e0b\u56fe\u663e\u793a\u4e86\u628a\u4e00\u4e2a\u89c6\u9525\u4f53\u5206\u4e3a\u4e09\u4e2a\u90e8\u5206\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff0c\u5c06\u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\uff0c\u8c03\u6574\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u4ee5\u5408\u9002\u5730\u8986\u76d6\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u3002\u56e0\u6b64\uff0c\u50a8\u5b58\u6df1\u5ea6\u6620\u5c04\u7684\u7eb9\u7406\u8986\u76d6\u89c6\u9525\u4f53\u7684\u533a\u57df\u7f29\u5c0f\u4e86\u3002\u800c\u4e14\uff0c\u7531\u4e8e\u79bb\u6444\u50cf\u673a\u6700\u8fd1\u7684\u90e8\u5206\u4f1a\u5360\u7528\u8f83\u5c11\u7684\u7a7a\u95f4\uff0c\u56e0\u6b64\u6df1\u5ea6\u5206\u8fa8\u7387\u4f1a\u63d0\u9ad8\u3002 \u4ece\u4e0a\u8ff0\u89e3\u91ca\u53ef\u4ee5\u770b\u51fa\uff0c\u6211\u4eec\u9700\u8981\u5c3d\u53ef\u80fd\u591a\u7684\u5c06\u6df1\u5ea6\u56fe\u8fdb\u884c\u5206\u5272\uff0c\u6211\u4eec\u8fd8\u5c06\u66f4\u6539\u6bcf\u4e2a\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u8981\u4f7f\u7528CSM\u9700\u8981\u505a\u7684\u4e8b\u60c5\u662f\uff1a \u5c06\u89c6\u9525\u4f53\u5206\u4e3an\u4e2a\u90e8\u5206\u3002 \u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\u65f6\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff1a \u8ba1\u7b97\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u5c06\u573a\u666f\u6e32\u67d3\u4e3a\u5355\u72ec\u7684\u6df1\u5ea6\u56fe\u3002 \u6e32\u67d3\u573a\u666f\u65f6\uff1a \u4f7f\u7528\u6b64\u524d\u8ba1\u7b97\u7684\u6df1\u5ea6\u56fe\u3002 \u786e\u5b9a\u8981\u7ed8\u5236\u7684\u7247\u6bb5\u6240\u5c5e\u7684\u90e8\u5206\u3002 \u8ba1\u7b97\u9634\u5f71\u56e0\u5b50\uff0c\u5982\u9634\u5f71\u6620\u5c04\u4e2d\u6240\u8ff0\u3002 \u5982\u4f60\u6240\u89c1\uff0cCSM\u7684\u4e3b\u8981\u7f3a\u70b9\u662f\u6211\u4eec\u9700\u8981\u4ece\u706f\u5149\u7684\u89d2\u5ea6\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6e32\u67d3\u573a\u666f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u901a\u5e38\u53ea\u7528\u4e8e\u5f00\u653e\u7a7a\u95f4\u7684\u539f\u56e0\u3002\u4e0d\u7ba1\u600e\u4e48\u8bf4\uff0c\u6211\u4eec\u5c06\u53ef\u4ee5\u770b\u5230\u5982\u4f55\u8f7b\u677e\u5730\u51cf\u5c11\u5f00\u9500\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u4ee3\u7801\u3002\u4f46\u662f\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u6709\u4e00\u4e2a\u5c0f\u5c0f\u7684\u63d0\u9192\uff0c\u6211\u4e0d\u4f1a\u5728\u8fd9\u91cc\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u8fd9\u4f1a\u975e\u5e38\u67af\u71e5\u3002\u76f8\u53cd\uff0c\u6211\u5c06\u4ecb\u7ecd\u4e3b\u8981\u7c7b\u3001\u5b83\u4eec\u7684\u804c\u8d23\u548c\u53ef\u80fd\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u7247\u6bb5\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u3002\u6240\u6709\u4e0e\u7740\u8272\u76f8\u5173\u7684\u7c7b\u90fd\u5df2\u79fb\u52a8\u5230\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.graph.shadow \u7684\u65b0\u5305\u4e2d\u3002 \u6e32\u67d3\u9634\u5f71\u7684\u4ee3\u7801\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u4ece\u5149\u5f71\u900f\u89c6\u7684\u573a\u666f\u5df2\u7ecf\u79fb\u52a8\u5230\u4e86 ShadowRenderer \u7c7b\u4e2d\u3002\uff08\u8be5\u4ee3\u7801\u4ee5\u524d\u5728 Renderer \u7c7b\u4e2d\uff09\u3002 \u7c7b\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5e38\u91cf\uff1a public static final int NUM_CASCADES = 3; public static final float[] CASCADE_SPLITS = new float[]{Window.Z_FAR / 20.0f, Window.Z_FAR / 10.0f, Window.Z_FAR}; \u9996\u5148\u662f\u5c42\u7ea7\u6216\u62c6\u5206\u7684\u6570\u91cf\u3002\u7b2c\u4e8c\u4e2a\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u62c6\u5206\u7684\u90e8\u5206\u7684\u8fdcZ\u5e73\u9762\u7684\u4f4d\u7f6e\u3002\u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u7684\u95f4\u8ddd\u5e76\u4e0d\u76f8\u7b49\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u5728Z\u5e73\u9762\u4e0a\u7684\u8ddd\u79bb\u6700\u77ed\u3002 \u7c7b\u8fd8\u50a8\u5b58\u4e86\u7528\u4e8e\u6e32\u67d3\u6df1\u5ea6\u56fe\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u7684\u5f15\u7528\uff0c\u4e00\u4e2a\u5217\u8868\uff0c\u5176\u4e2d\u5305\u542b\u4e0e\u6bcf\u4e2a\u90e8\u5206\u76f8\u5173\u8054\u7684\u4fe1\u606f\uff0c\u5176\u7531 ShadowCascade \u7c7b\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5bf9\u50a8\u5b58\u6df1\u5ea6\u56fe\u6570\u636e\uff08\u7eb9\u7406\uff09\u7684\u5bf9\u8c61\u7684\u5f15\u7528\uff0c\u7531 ShadowBuffer \u7c7b\u5b9a\u4e49\u3002 ShadowRenderer \u7c7b\u5177\u6709\u7528\u4e8e\u8bbe\u7f6e\u7740\u8272\u5668\u548c\u6240\u9700\u5c5e\u6027\u7684\u65b9\u6cd5\u4ee5\u53ca\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\u3002 render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window, Scene scene, Camera camera, Transformation transformation, Renderer renderer) { update(window, camera.getViewMatrix(), scene); // \u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5927\u5c0f glBindFramebuffer(GL_FRAMEBUFFER, shadowBuffer.getDepthMapFBO()); glViewport(0, 0, ShadowBuffer.SHADOW_MAP_WIDTH, ShadowBuffer.SHADOW_MAP_HEIGHT); glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); // \u4e3a\u6bcf\u5c42\u56fe\u6e32\u67d3\u573a\u666f for (int i = 0; i < NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); depthShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix()); depthShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix()); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); glClear(GL_DEPTH_BUFFER_BIT); renderNonInstancedMeshes(scene, transformation); renderInstancedMeshes(scene, transformation); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6267\u884c\u7684\u51e0\u4e2a\u6e32\u67d3\u8fc7\u7a0b\uff0c\u7c7b\u4f3c\u4e8e\u6b64\u524d\u9634\u5f71\u56fe\u7684\u6e32\u67d3\u65b9\u6cd5\u3002\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u4f1a\u4f7f\u7528\u76f8\u5173\u7684 ShadowCascade \u5b9e\u4f8b\u4e2d\u4fdd\u51fd\u7684\u4fe1\u606f\u66f4\u6539\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002 \u6b64\u5916\uff0c\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u9700\u8981\u66f4\u6539\u6b63\u5728\u4f7f\u7528\u7684\u7eb9\u7406\u3002\u6bcf\u6b21\u90fd\u4f1a\u5c06\u6df1\u5ea6\u4fe1\u606f\u6e32\u67d3\u4e3a\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u6b64\u4fe1\u606f\u50a8\u5b58\u5728 ShadowBuffer \u7c7b\u4e2d\uff0c\u5e76\u8bbe\u7f6e\u4e3a\u4f9bFBO\u4f7f\u7528\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); \u6b63\u5982\u521a\u521a\u63d0\u5230\u7684\uff0c ShadowBuffer \u7c7b\u50a8\u5b58\u4e0e\u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u76f8\u5173\u7684\u4fe1\u606f\u3002\u4ee3\u7801\u4e0e\u9634\u5f71\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u4ee3\u7801\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u6211\u4eec\u4f7f\u7528\u7684\u662f\u7eb9\u7406\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684\u7c7b ArrTexture \uff0c\u5b83\u521b\u5efa\u4e86\u4e00\u4e2a\u5177\u6709\u76f8\u540c\u5c5e\u6027\u7684\u7eb9\u7406\u6570\u7ec4\u3002\u6b64\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a bind \u65b9\u6cd5\uff0c\u7528\u4e8e\u7ed1\u5b9a\u6240\u6709\u7eb9\u7406\u6570\u7ec4\uff0c\u4ee5\u4fbf\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u8be5\u65b9\u6cd5\u63a5\u6536\u4e00\u4e2a\u53c2\u6570\uff0c\u4ece\u67d0\u4e2a\u7eb9\u7406\u5355\u5143\u5f00\u59cb\u7ed1\u5b9a\u3002 public void bindTextures(int start) { for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { glActiveTexture(start + i); glBindTexture(GL_TEXTURE_2D, depthMap.getIds()[i]); } } ShadowCascade \u7c7b\u50a8\u5b58\u4e0e\u4e00\u4e2a\u90e8\u5206\u5173\u8054\u7684\u5149\u7167\u89c6\u56fe\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u7531\u4e00\u4e2a\u8fd1Z\u5e73\u9762\u8ddd\u79bb\u548c\u4e00\u4e2a\u8fdcZ\u5e73\u9762\u8ddd\u79bb\u5b9a\u4e49\uff0c\u5e76\u6839\u636e\u8be5\u4fe1\u606f\u8ba1\u7b97\u77e9\u9635\u3002 \u8be5\u7c7b\u63d0\u4f9b\u5e76\u66f4\u65b0\u4e86\u4ee5\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u65b9\u5411\u4e3a\u8f93\u5165\u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u9996\u5148\u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u89c6\u9525\u9876\u70b9\uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u6839\u636e\u5149\u7684\u65b9\u5411\uff0c\u4ece\u622a\u9525\u7684\u4e2d\u5fc3\u5230\u76f8\u5f53\u4e8e\u8fdcZ\u5e73\u9762\u5230\u8fd1Z\u5e73\u9762\u4e4b\u95f4\u7684\u8ddd\u79bb\u7684\u8ddd\u79bb\uff0c\u8ba1\u7b97\u51fa\u8be5\u4f4d\u7f6e\u3002 public void update(Window window, Matrix4f viewMatrix, DirectionalLight light) { // \u4e3a\u6b64\u5c42\u751f\u6210\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 float aspectRatio = (float) window.getWidth() / (float) window.getHeight(); projViewMatrix.setPerspective(Window.FOV, aspectRatio, zNear, zFar); projViewMatrix.mul(viewMatrix); // \u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u9876\u70b9 float maxZ = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; corner.set(0, 0, 0); projViewMatrix.frustumCorner(i, corner); centroid.add(corner); centroid.div(8.0f); minZ = Math.min(minZ, corner.z); maxZ = Math.max(maxZ, corner.z); } // \u4ece\u8d28\u5fc3\u9006\u7740\u5149\u7684\u65b9\u5411\u4e0amax.z-min.z\u7684\u8ddd\u79bb Vector3f lightDirection = light.getDirection(); Vector3f lightPosInc = new Vector3f().set(lightDirection); float distance = maxZ - minZ; lightPosInc.mul(distance); Vector3f lightPosition = new Vector3f(); lightPosition.set(centroid); lightPosition.add(lightPosInc); updateLightViewMatrix(lightDirection, lightPosition); updateLightProjectionMatrix(); } \u6839\u636e\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u6211\u4eec\u53ef\u4ee5\u6784\u9020\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightViewMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void updateLightViewMatrix(Vector3f lightDirection, Vector3f lightPosition) { float lightAngleX = (float) Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float) Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Transformation.updateGenericViewMatrix(lightPosition, new Vector3f(lightAngleX, lightAngleY, lightAngleZ), lightViewMatrix); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u6784\u9020\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightProjectionMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8be5\u65b9\u6cd5\u5c06\u89c6\u9525\u4f53\u5750\u6807\u8f6c\u6362\u5230\u5149\u7167\u7a7a\u95f4\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230x\u3001y\u5750\u6807\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\u6765\u6784\u9020\u5305\u56f4\u89c6\u9525\u4f53\u7684\u8fb9\u754c\u6846\u3002\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a0\uff0c\u8fdcZ\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u5750\u6807\u7684\u6700\u5927\u503c\u548c\u6700\u5c0f\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 private void updateLightProjectionMatrix() { // \u73b0\u5728\u8ba1\u7b97\u5149\u7167\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u5927\u5c0f\u3002 float minX = Float.MAX_VALUE; float maxX = -Float.MAX_VALUE; float minY = Float.MAX_VALUE; float maxY = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; float maxZ = -Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; tmpVec.set(corner, 1); tmpVec.mul(lightViewMatrix); minX = Math.min(tmpVec.x, minX); maxX = Math.max(tmpVec.x, maxX); minY = Math.min(tmpVec.y, minY); maxY = Math.max(tmpVec.y, maxY); minZ = Math.min(tmpVec.z, minZ); maxZ = Math.max(tmpVec.z, maxZ); } float distz = maxZ - minZ; orthoProjMatrix.setOrtho(minX, maxX, minY, maxY, 0, distz); } \u8bb0\u4f4f\uff0c\u6b63\u4ea4\u6295\u5f71\u5c31\u50cf\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5e94\u8be5\u5305\u542b\u6240\u6709\u5c06\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u3002\u8be5\u8fb9\u754c\u6846\u4ee5\u5149\u7167\u89c6\u56fe\u5750\u6807\u7a7a\u95f4\u8868\u793a\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u8ba1\u7b97\u5305\u56f4\u89c6\u9525\u4f53\u7684\u6700\u5c0f\u8fb9\u754c\u6846\uff0c\u8f74\u4e0e\u5149\u6e90\u4f4d\u7f6e\u5bf9\u9f50\u3002 Renderer \u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u4f7f\u7528\u89c6\u56fe\u5305\u4e2d\u7684\u7c7b\u4ee5\u53ca\u4fee\u6539\u4f20\u9012\u7ed9\u6e32\u67d3\u5668\u7684\u4fe1\u606f\u3002\u5728\u6e32\u67d3\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u6a21\u578b\u3001\u6a21\u578b\u89c2\u5bdf\u548c\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u6216\u5149\u7167\u89c6\u56fe\u77e9\u9635\u6765\u51cf\u5c11\u64cd\u4f5c\u7684\u6570\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9009\u62e9\u7b80\u5316\u8981\u4f20\u9012\u7684\u5143\u7d20\u7684\u6570\u91cf\uff0c\u73b0\u5728\u53ea\u5c06\u6a21\u578b\u3001\u89c2\u5bdf\u548c\u5149\u7167\u77e9\u9635\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u6b64\u5916\uff0c\u5bf9\u4e8e\u7c92\u5b50\uff0c\u6211\u4eec\u9700\u8981\u4fdd\u7559\u6bd4\u4f8b\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u518d\u4f20\u9012\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u6240\u4ee5\u73b0\u5728\u4fe1\u606f\u5c06\u4e22\u5931\u3002\u6211\u4eec\u91cd\u7528\u7528\u4e8e\u6807\u8bb0\u6240\u9009\u9879\u7684\u5c5e\u6027\u6765\u8bbe\u7f6e\u6bd4\u4f8b\u4fe1\u606f\u3002\u5728\u7c92\u5b50\u7740\u8272\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u503c\u518d\u6b21\u8bbe\u7f6e\u7f29\u653e\u3002 \u5728\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u8ba1\u7b97\u6a21\u578b\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5e76\u5c06\u5176\u4f5c\u4e3a\u8f93\u51fa\u4f20\u9012\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 mvVertexPos = mvPos.xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * vec4(position, 1.0); } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u503c\u6839\u636e\u7247\u5143\u6240\u5904\u7684\u90e8\u5206\u6765\u67e5\u8be2\u9002\u5f53\u7684\u6df1\u5ea6\u56fe\u3002\u8fd9\u9700\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u7279\u5b9a\u9879\u76ee\uff0c\u5b83\u4eec\u7684\u7247\u5143\u53ef\u80fd\u4f4d\u4e8e\u4e0d\u540c\u7684\u90e8\u5206\u4e2d\u3002 \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5fc5\u987b\u51b3\u5b9a\u8981\u5206\u6210\u54ea\u4e2a\u90e8\u5206\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u4f7f\u7528\u7247\u5143\u7684Z\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u6bcf\u4e2a\u90e8\u5206\u7684\u6700\u5927Z\u503c\u8fdb\u884c\u6bd4\u8f83\uff0c\u4e5f\u5c31\u662f\u8fdcZ\u5e73\u9762\u503c\u3002\u8fd9\u4e9b\u6570\u636e\u4f5c\u4e3a\u4e00\u4e2a\u65b0\u7684Uniform\u4f20\u9012\uff1a uniform float cascadeFarPlanes[NUM_CASCADES]; \u5982\u4e0b\u6240\u793a\uff0c\u6211\u4eec\u8ba1\u7b97\u5206\u5272\u7684\u90e8\u5206\uff0c\u53d8\u91cf idx \u5c06\u50a8\u5b58\u8981\u4f7f\u7528\u7684\u90e8\u5206\uff1a int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } \u6b64\u5916\uff0c\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u7eb9\u7406\u6570\u7ec4\uff0c\u4e00\u4e2a sampler2D \u6570\u7ec4\uff0c\u7528\u4e8e\u6df1\u5ea6\u56fe\uff0c\u5373\u4e0e\u6211\u4eec\u5206\u5272\u90e8\u5206\u76f8\u5173\u8054\u7684\u7eb9\u7406\u3002\u6e90\u4ee3\u7801\u7528\u4e00\u4e2aUniform\u5217\u8868\uff08\u800c\u4e0d\u662f\u4f7f\u7528\u6570\u7ec4\uff09\u50a8\u5b58\u7528\u4e8e\u5f15\u7528\u4e0e\u6bcf\u4e2a\u90e8\u5206\u5173\u8054\u7684\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u5355\u5143\u3002 uniform sampler2D normalMap; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; \u5c06\u5176\u66f4\u6539\u4e3a\u4e00\u7ec4Uniform\u4f1a\u5bfc\u81f4\u96be\u4ee5\u8ffd\u8e2a\u6b64\u793a\u4f8b\u7684\u5176\u4ed6\u7eb9\u7406\u51fa\u73b0\u7684\u95ee\u9898\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u5c1d\u8bd5\u5728\u4ee3\u7801\u4e2d\u4fee\u6539\u5b83\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4f59\u4fee\u6539\u548c\u7740\u8272\u5668\u53ea\u662f\u57fa\u4e8e\u4e0a\u8ff0\u66f4\u6539\u6240\u9700\u7684\u8c03\u6574\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u6700\u540e\uff0c\u5f53\u5f15\u5165\u8fd9\u4e9b\u66f4\u6539\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u6027\u80fd\u4e0b\u964d\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u7ed8\u5236\u7684\u6df1\u5ea6\u56fe\u662f\u6b64\u524d\u7684\u4e09\u500d\u3002\u5982\u679c\u6444\u50cf\u673a\u672a\u88ab\u79fb\u52a8\u6216\u573a\u666f\u9879\u672a\u53d1\u751f\u66f4\u6539\uff0c\u5219\u4e0d\u9700\u8981\u53cd\u590d\u6e32\u67d3\u6df1\u5ea6\u56fe\u3002\u6df1\u5ea6\u56fe\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u6e05\u9664\u5b83\u4eec\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5728 render \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u53d8\u91cf\uff0c\u7528\u4e8e\u6307\u793a\u662f\u5426\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4ee5\u907f\u514d\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4f7f\u5176\u4fdd\u6301\u4e0d\u53d8\uff0c\u8fd9\u4f1a\u663e\u8457\u63d0\u9ad8FPS\u3002\u6700\u7ec8\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a","title":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09"},{"location":"27-assimp/","text":"Assimp\u5e93\uff08Assimp\uff09 \u9759\u6001\u7f51\u683c \u52a0\u8f7d\u4e0d\u540c\u683c\u5f0f\u7684\u590d\u6742\u4e09\u7ef4\u6a21\u578b\u7684\u529f\u80fd\u5bf9\u4e8e\u7f16\u5199\u6e38\u620f\u81f3\u5173\u91cd\u8981\uff0c\u4e3a\u5176\u4e2d\u4e00\u4e9b\u7f16\u5199\u89e3\u6790\u5668\u9700\u8981\u5927\u91cf\u7684\u5de5\u4f5c\uff0c\u5373\u4fbf\u53ea\u652f\u6301\u4e00\u79cd\u683c\u5f0f\u4e5f\u53ef\u80fd\u5f88\u8017\u65f6\u3002\u4f8b\u5982\uff0c\u5728\u7b2c\u4e5d\u7ae0\u4e2d\u63cf\u8ff0\u7684wavefront\u52a0\u8f7d\u5668\u53ea\u89e3\u6790\u4e86\u89c4\u8303\u4e2d\u7684\u4e00\u5c0f\u90e8\u5206\uff08\u6839\u672c\u4e0d\u5904\u7406\u6750\u8d28\uff09\u3002 \u5e78\u8fd0\u7684\u662f\uff0c\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528 Assimp \u5e93\u6765\u89e3\u6790\u8bb8\u591a\u5e38\u89c1\u76843D\u683c\u5f0f\u3002\u5b83\u662f\u4e00\u4e2aC++\u5e93\uff0c\u53ef\u4ee5\u4ee5\u5404\u79cd\u683c\u5f0f\u52a0\u8f7d\u9759\u6001\u548c\u52a8\u753b\u6a21\u578b\u3002LWJGL\u63d0\u4f9b\u4e86\u7ed1\u5b9a\u4ee5\u4fbf\u4eceJava\u4ee3\u7801\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u5b83\u3002 \u9996\u5148\u662f\u5c06Assimp\u7684Maven\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230 pom.xml \u6587\u4ef6\u4e2d\u3002\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u7f16\u8bd1\u65f6\u548c\u8fd0\u884c\u65f6\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> </dependency> <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u4e00\u65e6\u8bbe\u7f6e\u4e86\u4f9d\u8d56\u9879\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a StaticMeshesLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u7528\u4e8e\u52a0\u8f7d\u4e0d\u5e26\u52a8\u753b\u7684\u7f51\u683c\uff0c\u8be5\u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u9759\u6001\u516c\u5171\u65b9\u6cd5\uff1a public static Mesh[] load(String resourcePath, String texturesDir) throws Exception { return load(resourcePath, texturesDir, aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals); } public static Mesh[] load(String resourcePath, String texturesDir, int flags) throws Exception { // .... \u4e24\u79cd\u65b9\u6cd5\u90fd\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * resourcePath \uff1a\u6a21\u578b\u6587\u4ef6\u6240\u5728\u7684\u6587\u4ef6\u8def\u5f84\u3002\u8fd9\u662f\u4e00\u4e2a\u7edd\u5bf9\u8def\u5f84\uff0c\u56e0\u4e3aAssimp\u53ef\u80fd\u9700\u8981\u52a0\u8f7d\u5176\u4ed6\u6587\u4ef6\uff08\u4f8b\u5982wavefront\u3001OBJ\u7b49\u6587\u4ef6\u7684\u6750\u8d28\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u53ef\u80fd\u4f7f\u7528\u4e0e\u8d44\u6e90\u8def\u5f84\u76f8\u540c\u7684\u57fa\u8def\u5f84\u3002\u5982\u679c\u5c06\u8d44\u6e90\u5d4c\u5165JAR\u6587\u4ef6\u4e2d\uff0c\u90a3\u4e48assimp\u5c06\u65e0\u6cd5\u5bfc\u5165\u5b83\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u662f\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 * texturesDir \uff1a\u4fdd\u5b58\u6b64\u6a21\u578b\u7684\u6587\u4ef6\u5939\u8def\u5f84\u3002\u8fd9\u662fCLASSPATH\u7684\u76f8\u5bf9\u8def\u5f84\u3002\u4f8b\u5982\uff0cwavefront\u6750\u8d28\u6587\u4ef6\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u4ee3\u7801\u5e0c\u671b\u6b64\u6587\u4ef6\u4f4d\u4e8e texturesDir \u76ee\u5f55\u4e0b\u3002\u5982\u679c\u53d1\u73b0\u7eb9\u7406\u52a0\u8f7d\u9519\u8bef\uff0c\u53ef\u80fd\u9700\u8981\u5728\u6a21\u578b\u6587\u4ef6\u4e2d\u624b\u52a8\u8c03\u6574\u8fd9\u4e9b\u8def\u5f84\u3002 \u7b2c\u4e8c\u4e2a\u65b9\u6cd5\u6709\u4e00\u4e2a\u540d\u4e3a flags \u7684\u989d\u5916\u53c2\u6570\u3002\u6b64\u53c2\u6570\u5141\u8bb8\u8c03\u6574\u52a0\u8f7d\u8fc7\u7a0b\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u7b2c\u4e8c\u4e2a\u65b9\u6cd5\uff0c\u5e76\u4f20\u9012\u4e00\u4e9b\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u6709\u7528\u7684\u503c\uff1a * aiProcess_JoinIdenticalVertices \uff1a\u6b64\u6807\u8bb0\u5c06\u51cf\u5c11\u4f7f\u7528\u7684\u9876\u70b9\u6570\uff0c\u8bc6\u522b\u53ef\u5728\u9762\u4e4b\u95f4\u91cd\u7528\u7684\u9876\u70b9\u3002 * aiProcess_Triangulate \uff1a\u6a21\u578b\u53ef\u4ee5\u4f7f\u7528\u56db\u8fb9\u5f62\u6216\u5176\u4ed6\u51e0\u4f55\u56fe\u5f62\u6765\u5b9a\u4e49\u5b83\u4eec\u7684\u5143\u7d20\u3002\u7531\u4e8e\u6211\u4eec\u53ea\u5904\u7406\u4e09\u89d2\u5f62\uff0c\u56e0\u6b64\u5fc5\u987b\u4f7f\u7528\u6b64\u6807\u8bb0\u5c06\u6240\u6709\u7684\u9762\u62c6\u5206\u4e3a\u4e09\u89d2\u5f62\uff08\u5982\u679c\u6709\u5fc5\u8981\u7684\u8bdd\uff09\u3002 * aiProcess_FixInfacingNormals \uff1a\u6b64\u6807\u8bb0\u5c06\u5c1d\u8bd5\u53cd\u8f6c\u53ef\u80fd\u6307\u5411\u5185\u90e8\u7684\u6cd5\u7ebf\u3002 \u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u6807\u8bb0\u53ef\u4ee5\u4f7f\u7528\uff0c\u4f60\u53ef\u4ee5\u5728LWJGL\u7684Javadoc\u6587\u6863\u4e2d\u67e5\u9605\u5b83\u4eec\u3002 \u56de\u770b\u5230\u7b2c\u4e8c\u4e2a\u8f7d\u5165\u65b9\u6cd5\uff0c\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 aiImportFile \u65b9\u6cd5\u6765\u52a0\u8f7d\u5e26\u6709\u6240\u9009\u6807\u8bb0\u7684\u6a21\u578b\u3002 AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } \u8f7d\u5165\u65b9\u6cd5\u7684\u5176\u4f59\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials); meshes[i] = mesh; } return meshes; \u6211\u4eec\u5904\u7406\u6a21\u578b\u4e2d\u5305\u542b\u7684\u6750\u8d28\uff0c\u6750\u8d28\u5b9a\u4e49\u7ec4\u6210\u6a21\u578b\u7684\u7f51\u683c\u4f7f\u7528\u7684\u989c\u8272\u548c\u7eb9\u7406\u3002\u7136\u540e\u6211\u4eec\u5904\u7406\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u6a21\u578b\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7f51\u683c\uff0c\u6bcf\u4e2a\u7f51\u683c\u90fd\u53ef\u4ee5\u4f7f\u7528\u4e3a\u6a21\u578b\u5b9a\u4e49\u7684\u4e00\u79cd\u6750\u8d28\u3002 \u5982\u679c\u4f60\u770b\u5230\u4e0a\u9762\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u5f88\u591a\u5bf9Assimp\u5e93\u7684\u8c03\u7528\u8fd4\u56de\u7684 PointerBuffer \u5b9e\u4f8b\u3002\u4f60\u53ef\u4ee5\u7528C\u6307\u9488\u90a3\u6837\u7684\u65b9\u5f0f\u770b\u5f85\u5b83\u4eec\uff0c\u5b83\u4eec\u53ea\u662f\u6307\u5411\u50a8\u5b58\u6570\u636e\u7684\u5185\u5b58\u533a\u57df\u3002\u4f60\u9700\u8981\u63d0\u524d\u77e5\u9053\u5b83\u4eec\u50a8\u5b58\u7684\u6570\u636e\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5904\u7406\u5b83\u4eec\u3002\u5bf9\u4e8e\u6750\u8d28\uff0c\u6211\u4eec\u8fed\u4ee3\u8be5\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMaterial \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u8fed\u4ee3\u50a8\u5b58\u7f51\u683c\u6570\u636e\u7684\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMesh \u7c7b\u7684\u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u770b\u770b processMaterial \u65b9\u6cd5\uff1a private static void processMaterial(AIMaterial aiMaterial, List<Material> materials, String texturesDir) throws Exception { AIColor4D colour = AIColor4D.create(); AIString path = AIString.calloc(); Assimp.aiGetMaterialTexture(aiMaterial, aiTextureType_DIFFUSE, 0, path, (IntBuffer) null, null, null, null, null, null); String textPath = path.dataString(); Texture texture = null; if (textPath != null && textPath.length() > 0) { TextureCache textCache = TextureCache.getInstance(); texture = textCache.getTexture(texturesDir + \"/\" + textPath); } Vector4f ambient = Material.DEFAULT_COLOUR; int result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_AMBIENT, aiTextureType_NONE, 0, colour); if (result == 0) { ambient = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f diffuse = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_DIFFUSE, aiTextureType_NONE, 0, colour); if (result == 0) { diffuse = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f specular = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_SPECULAR, aiTextureType_NONE, 0, colour); if (result == 0) { specular = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Material material = new Material(ambient, diffuse, specular, 1.0f); material.setTexture(texture); materials.add(material); } \u6211\u4eec\u68c0\u67e5\u6750\u8d28\u662f\u5426\u5b9a\u4e49\u4e86\u7eb9\u7406\u3002\u5982\u679c\u6709\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a TextureCache \u7684\u65b0\u7c7b\uff0c\u7528\u4e8e\u7f13\u5b58\u7eb9\u7406\u3002\u8fd9\u662f\u56e0\u4e3a\u51e0\u4e2a\u7f51\u683c\u53ef\u80fd\u5171\u4eab\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u4e0d\u60f3\u6d6a\u8d39\u7a7a\u95f4\u4e00\u6b21\u53c8\u4e00\u6b21\u52a0\u8f7d\u76f8\u540c\u7684\u6570\u636e\u3002\u7136\u540e\u6211\u4eec\u5c1d\u8bd5\u83b7\u5f97\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u5e78\u8fd0\u7684\u662f\uff0c\u6211\u4eec\u5bf9\u6750\u8d28\u7684\u5b9a\u4e49\u5df2\u7ecf\u5305\u542b\u4e86\u8fd9\u4e9b\u4fe1\u606f\u3002 TextureCache \u7684\u5b9a\u4e49\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u6620\u5c04\uff0c\u901a\u8fc7\u7eb9\u7406\u6587\u4ef6\u7684\u8def\u5f84\u5bf9\u4e0d\u540c\u7684\u7eb9\u7406\u8fdb\u884c\u7d22\u5f15\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u7531\u4e8e\u73b0\u5728\u7eb9\u7406\u53ef\u80fd\u4f7f\u7528\u4e0d\u540c\u7684\u56fe\u50cf\u683c\u5f0f\uff08PNG\u3001JPEG\u7b49\uff09\uff0c\u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86\u7eb9\u7406\u7684\u52a0\u8f7d\u65b9\u5f0f\uff0c\u73b0\u5728\u4f7f\u7528STB\u5e93\u6765\u52a0\u8f7d\u66f4\u591a\u7684\u683c\u5f0f\uff0c\u800c\u4e0d\u662f\u4f7f\u7528PNG\u5e93\u3002 \u8ba9\u6211\u4eec\u770b\u5230 StaticMeshesLoader \u7c7b\u3002 processMesh \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static Mesh processMesh(AIMesh aiMesh, List<Material> materials) { List<Float> vertices = new ArrayList<>(); List<Float> textures = new ArrayList<>(); List<Float> normals = new ArrayList<>(); List<Integer> indices = new ArrayList(); processVertices(aiMesh, vertices); processNormals(aiMesh, normals); processTextCoords(aiMesh, textures); processIndices(aiMesh, indices); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices) ); Material material; int materialIdx = aiMesh.mMaterialIndex(); if (materialIdx >= 0 && materialIdx < materials.size()) { material = materials.get(materialIdx); } else { material = new Material(); } mesh.setMaterial(material); return mesh; } Mesh \u7531\u4e00\u7ec4\u9876\u70b9\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u65b9\u5411\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u5b9a\u4e49\u3002\u6bcf\u4e2a\u5143\u7d20\u90fd\u5728 processVertices \u3001 processNormals \u3001 processTextCoords \u548c processIndices \u65b9\u6cd5\u4e2d\u5904\u7406\uff0c\u7f51\u683c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u5176\u7d22\u5f15\u6307\u5411\u6750\u8d28\u3002\u5982\u679c\u7d22\u5f15\u4e0e\u4e4b\u524d\u5904\u7406\u7684\u6750\u8d28\u76f8\u5bf9\u5e94\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b83\u4eec\u4e0e Mesh \u76f8\u5173\u8054\u3002 processXXX \u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u662f\u5728\u8fd4\u56de\u6240\u9700\u6570\u636e\u7684 AIMesh \u5b9e\u4f8b\u4e0a\u8c03\u7528\u76f8\u5e94\u7684\u65b9\u6cd5\u3002\u4f8b\u5982\uff0c processVertices \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static void processVertices(AIMesh aiMesh, List<Float> vertices) { AIVector3D.Buffer aiVertices = aiMesh.mVertices(); while (aiVertices.remaining() > 0) { AIVector3D aiVertex = aiVertices.get(); vertices.add(aiVertex.x()); vertices.add(aiVertex.y()); vertices.add(aiVertex.z()); } } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u8c03\u7528 mVertices \u65b9\u6cd5\u6765\u83b7\u53d6\u9876\u70b9\u7684\u7f13\u51b2\u533a\uff0c\u7b80\u5355\u5730\u5904\u7406\u5b83\u4eec\u6765\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u9876\u70b9\u4f4d\u7f6e\u7684\u6d6e\u70b9\u6570\u5217\u8868\u3002\u56e0\u4e3a\uff0c\u8be5\u65b9\u6cd5\u53ea\u8fd4\u56de\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4f60\u53ef\u4ee5\u5c06\u8be5\u6570\u636e\u76f4\u63a5\u4f20\u7ed9\u521b\u5efa\u9876\u70b9\u7684OpenGL\u65b9\u6cd5\u3002\u4f46\u6211\u4eec\u4e0d\u8fd9\u6837\u505a\uff0c\u539f\u56e0\u6709\u4e24\u4e2a\u3002\u7b2c\u4e00\u4e2a\u539f\u56e0\u662f\u5c3d\u91cf\u51cf\u5c11\u5bf9\u4ee3\u7801\u5e93\u7684\u4fee\u6539\uff0c\u7b2c\u4e8c\u4e2a\u539f\u56e0\u662f\uff0c\u901a\u8fc7\u52a0\u8f7d\u6570\u636e\u5230\u4e2d\u95f4\u5c42\u4e2d\uff0c\u4f60\u53ef\u4ee5\u6267\u884c\u4e00\u4e9b\u4e13\u95e8\u7684\u5904\u7406\u4efb\u52a1\uff0c\u751a\u81f3\u8c03\u8bd5\u52a0\u8f7d\u8fc7\u7a0b\u3002 \u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u6709\u6548\u7684\u793a\u4f8b\uff0c\u5373\u76f4\u63a5\u5c06\u7f13\u51b2\u533a\u4f20\u7ed9OpenGL\uff0c\u53ef\u4ee5\u67e5\u770b\u8fd9\u4e2a \u4f8b\u5b50 \u3002 StaticMeshesLoader \u7c7b\u8ba9 OBJLoader \u7c7b\u8fc7\u65f6\u4e86\uff0c\u56e0\u6b64\u5b83\u5df2\u7ecf\u4ece\u6e90\u4ee3\u7801\u4e2d\u5220\u9664\u3002\u4e00\u4e2a\u66f4\u590d\u6742\u7684OBJ\u6587\u4ef6\u5df2\u7ecf\u4f5c\u4e3a\u793a\u4f8b\u63d0\u4f9b\uff0c\u5982\u679c\u8fd0\u884c\u5b83\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u52a8\u753b \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4f7f\u7528Assimp\u52a0\u8f7d\u4e86\u9759\u6001\u7f51\u683c\uff0c\u53ef\u4ee5\u7ee7\u7eed\u8bb2\u89e3\u52a8\u753b\u3002\u5982\u679c\u4f60\u56de\u60f3\u52a8\u753b\u4e00\u7ae0\uff0c\u4e0e\u7f51\u683c\u5173\u8054\u7684VAO\u5305\u542b\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u5e94\u5e94\u7528\u4e8e\u5173\u8282\u4f4d\u7f6e\u4ee5\u8c03\u6574\u6700\u7ec8\u9876\u70b9\u4f4d\u7f6e\u7684\u6743\u91cd\u5217\u8868\u3002 \u6bcf\u4e2a\u9876\u70b9\u4f4d\u7f6e\u90fd\u5173\u8054\u4e86\u4e00\u4e2a\u6539\u53d8\u6700\u7ec8\u4f4d\u7f6e\u7684\u56db\u4e2a\u6743\u91cd\u7684\u5217\u8868\uff0c\u5f15\u7528\u4e86\u5c06\u7ec4\u5408\u4ee5\u786e\u5b9a\u9876\u70b9\u6700\u7ec8\u4f4d\u7f6e\u7684\u9aa8\u9abc\u7d22\u5f15\u3002\u5728\u6bcf\u4e00\u5e27\uff0c\u4e00\u4e2a\u53d8\u6362\u77e9\u9635\u5217\u8868\u5c06\u88ab\u4f5c\u4e3aUniform\u52a0\u8f7d\u5230\u6bcf\u4e2a\u5173\u8282\u3002\u6839\u636e\u8fd9\u4e9b\u6570\u636e\uff0c\u7b97\u51fa\u6700\u7ec8\u4f4d\u7f6e\u3002 \u5728\u52a8\u753b\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u5f00\u53d1\u4e86\u4e00\u4e2aMD5\u89e3\u6790\u5668\u6765\u52a0\u8f7d\u52a8\u753b\u7f51\u683c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Assimp\u5e93\u3002\u8fd9\u5c06\u5141\u8bb8\u6211\u4eec\u52a0\u8f7dMD5\u4e4b\u5916\u7684\u66f4\u591a\u683c\u5f0f\uff0c\u4f8b\u5982 COLLADA \uff0c FBX \u7b49\u3002 \u5728\u5f00\u59cb\u7f16\u7801\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7406\u6e05\u4e00\u4e9b\u672f\u8bed\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u52a0\u533a\u5206\u5730\u63d0\u5230\u9aa8\u9abc\u548c\u5173\u8282\u3002\u9aa8\u9abc\u6216\u8005\u5173\u8282\u90fd\u53ea\u662f\u5f71\u54cd\u9876\u70b9\u7684\u5143\u7d20\uff0c\u5e76\u4e14\u5177\u6709\u5f62\u6210\u5c42\u6b21\u7684\u7236\u7ea7\u3002MD5\u683c\u5f0f\u4f7f\u7528\u672f\u8bed\u5173\u8282\uff0c\u800cAssimp\u4f7f\u7528\u672f\u8bed\u9aa8\u9abc\u3002 \u8ba9\u6211\u4eec\u5148\u770b\u4e00\u4e0b\u7531Assimp\u5904\u7406\u7684\u50a8\u5b58\u7740\u52a8\u753b\u4fe1\u606f\u7684\u7ed3\u6784\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u9aa8\u9abc\u548c\u6743\u91cd\u6570\u636e\u5f00\u59cb\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002\u7f51\u683c\u8fd8\u50a8\u5b58\u7740\u9aa8\u9abc\u5217\u8868\uff0c\u6bcf\u4e2a\u9aa8\u9abc\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u4e00\u4e2a\u504f\u79fb\u77e9\u9635\uff1a\u7a0d\u540e\u5c06\u7528\u5b83\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc\u5e94\u8be5\u4f7f\u7528\u7684\u6700\u7ec8\u53d8\u6362\u3002 \u9aa8\u9abc\u8fd8\u6307\u5411\u4e00\u4e2a\u6743\u91cd\u5217\u8868\uff0c\u6bcf\u4e2a\u6743\u91cd\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u6743\u91cd\u56e0\u5b50\uff0c\u5373\u7528\u4e8e\u8c03\u8282\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u9aa8\u9abc\u53d8\u6362\u5f71\u54cd\u7684\u6570\u5b57\u3002 \u4e00\u4e2a\u9876\u70b9\u6807\u8bc6\u7b26\uff0c\u5373\u4e0e\u5f53\u524d\u9aa8\u9abc\u76f8\u5173\u8054\u7684\u9876\u70b9\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u6240\u6709\u8fd9\u4e9b\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u4ece\u4e0a\u8ff0\u7684\u7ed3\u6784\u6784\u9020\u9876\u70b9\u4f4d\u7f6e\u3001\u9aa8\u9abc/\u5173\u8282/\u7d22\u5f15\u548c\u76f8\u5173\u6743\u91cd\u7684\u5217\u8868\u3002\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6a21\u578b\u4e2d\u5b9a\u4e00\u4e2a\u6240\u6709\u52a8\u753b\u5e27\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc/\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Assimp\u573a\u666f\u5bf9\u8c61\u662f\u5b9a\u4e49\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u6bcf\u4e2a\u8282\u70b9\u90fd\u7531\u4e00\u4e2a\u540d\u8bcd\u548c\u4e00\u4e2a\u5b50\u8282\u70b9\u5217\u8868\u5b9a\u4e49\u3002\u52a8\u753b\u4f7f\u7528\u8fd9\u4e9b\u8282\u70b9\u6765\u5b9a\u4e49\u5e94\u8be5\u5e94\u7528\u7684\u53d8\u6362\uff0c\u8fd9\u4e2a\u5c42\u6b21\u7ed3\u6784\u5b9e\u9645\u4e0a\u5b9a\u4e49\u4e86\u9aa8\u9abc\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u6bcf\u4e2a\u9aa8\u9abc\u90fd\u662f\u4e00\u4e2a\u8282\u70b9\uff0c\u5e76\u4e14\u6709\u4e00\u4e2a\u7236\u8282\u70b9\uff08\u6839\u8282\u70b9\u9664\u5916\uff09\uff0c\u53ef\u80fd\u8fd8\u6709\u4e00\u7ec4\u5b50\u8282\u70b9\u3002\u6709\u4e00\u4e9b\u7279\u6b8a\u7684\u8282\u70b9\u4e0d\u662f\u9aa8\u9abc\uff0c\u5b83\u4eec\u7528\u4e8e\u5bf9\u53d8\u6362\u8fdb\u884c\u5206\u7ec4\uff0c\u5728\u8ba1\u7b97\u53d8\u6362\u65f6\u8fdb\u884c\u5904\u7406\u3002\u53e6\u4e00\u4e2a\u95ee\u9898\u662f\uff0c\u8fd9\u4e9b\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u662f\u57fa\u4e8e\u6574\u4e2a\u6a21\u578b\u5b9a\u4e49\u7684\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u6ca1\u6709\u5355\u72ec\u7684\u5c42\u6b21\u7ed3\u6784\u3002 \u573a\u666f\u8fd8\u5b9a\u4e49\u4e86\u4e00\u7ec4\u52a8\u753b\u3002\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u53ef\u4ee5\u5bf9\u6a21\u578b\u505a\u884c\u8d70\u3001\u8dd1\u52a8\u7b49\u52a8\u753b\u3002\u6bcf\u4e2a\u52a8\u753b\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\u3002\u52a8\u753b\u5177\u6709\u4ee5\u4e0b\u5c5e\u6027\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u6301\u7eed\u65f6\u95f4\u3002\u5373\u52a8\u753b\u7684\u6301\u7eed\u65f6\u95f4\uff0c\u7531\u4e8e\u52a8\u753b\u662f\u5e94\u7528\u4e8e\u6bcf\u4e2a\u4e0d\u540c\u5e27\u7684\u6bcf\u4e2a\u8282\u70b9\u7684\u53d8\u6362\u5217\u8868\uff0c\u56e0\u6b64\u540d\u79f0\u53ef\u80fd\u770b\u8d77\u6765\u5f88\u6df7\u4e71\u3002 \u4e00\u4e2a\u52a8\u753b\u901a\u9053\uff08Animation Channel\uff09\u7684\u5217\u8868\u3002\u52a8\u753b\u901a\u9053\u50a8\u5b58\u5e94\u5e94\u7528\u4e8e\u6bcf\u4e2a\u8282\u70b9\u7684\u7279\u5b9a\u65f6\u95f4\u70b9\u7684\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u6570\u636e\uff0c\u6a21\u578b\u4e2d\u50a8\u5b58\u52a8\u753b\u901a\u9053\u6570\u636e\u7684\u7c7b\u662f AINodeAnim \u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e0a\u8ff0\u6240\u6709\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\uff1a \u5bf9\u4e8e\u7279\u5b9a\u7684\u65f6\u523b\uff0c\u6216\u8005\u8bf4\u5bf9\u4e8e\u5e27\uff0c\u8981\u5e94\u7528\u5230\u9aa8\u9abc\u7684\u53d8\u6362\u662f\u5728\u52a8\u753b\u901a\u9053\u4e2d\u4e3a\u8be5\u65f6\u523b\u5b9a\u4e49\u7684\u53d8\u6362\uff0c\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u5230\u6839\u8282\u70b9\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u573a\u666f\u4e2d\u5b58\u50a8\u7684\u4fe1\u606f\u8fdb\u884c\u91cd\u65b0\u6392\u5e8f\uff0c\u6d41\u7a0b\u5982\u4e0b\uff1a \u6784\u9020\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u3002 \u5bf9\u6bcf\u4e2a\u52a8\u753b\uff0c\u8fed\u4ee3\u6bcf\u4e2a\u52a8\u753b\u901a\u9053\uff08\u5bf9\u6bcf\u4e2a\u52a8\u753b\u8282\u70b9\uff09\uff1a\u4e3a\u6240\u6709\u5e27\u6784\u9020\u53d8\u6362\u77e9\u9635\u3002\u53d8\u6362\u77e9\u9635\u662f\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\u7684\u7ec4\u5408\u3002 \u91cd\u65b0\u6392\u5217\u6bcf\u4e00\u5e27\u7684\u4fe1\u606f\uff1a\u6784\u9020\u8981\u5e94\u7528\u4e8e\u7f51\u683c\u4e2d\u6bcf\u4e2a\u9aa8\u9abc\u7684\u6700\u7ec8\u53d8\u6362\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u9aa8\u9abc\u7684\u53d8\u6362\u77e9\u9635\uff08\u76f8\u5173\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\uff09\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\u76f4\u5230\u6839\u8282\u70b9\u6765\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u9996\u5148\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a AnimMeshesLoader \u7684\u7c7b\uff0c\u5b83\u7531 StaticMeshesLoader \u6269\u5c55\uff0c\u4f46\u5b83\u4e0d\u8fd4\u56de\u7f51\u683c\u6570\u7ec4\uff0c\u800c\u662f\u8fd4\u56de\u4e00\u4e2a AnimGameItem \u5b9e\u4f8b\u3002\u5b83\u5b9a\u4e49\u4e86\u4e24\u4e2a\u516c\u5171\u65b9\u6cd5\uff1a public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir) throws Exception { return loadAnimGameItem(resourcePath, texturesDir, aiProcess_GenSmoothNormals | aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals | aiProcess_LimitBoneWeights); } public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir, int flags) throws Exception { AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } List<Bone> boneList = new ArrayList<>(); int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials, boneList); meshes[i] = mesh; } AINode aiRootNode = aiScene.mRootNode(); Matrix4f rootTransfromation = AnimMeshesLoader.toMatrix(aiRootNode.mTransformation()); Node rootNode = processNodesHierarchy(aiRootNode, null); Map<String, Animation> animations = processAnimations(aiScene, boneList, rootNode, rootTransfromation); AnimGameItem item = new AnimGameItem(meshes, animations); return item; } \u8fd9\u4e9b\u65b9\u6cd5\u4e0e StaticMeshesLoader \u4e2d\u5b9a\u4e49\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u5982\u4e0b\u533a\u522b\uff1a \u4f20\u9012\u9ed8\u8ba4\u52a0\u8f7d\u6807\u8bb0\u7684\u65b9\u6cd5\u4f7f\u7528\u4e86\u65b0\u53c2\u6570\uff1a aiProcess_LimitBoneWeights \u3002\u8fd9\u5c06\u4f1a\u5c06\u5f71\u54cd\u9876\u70b9\u7684\u6700\u5927\u6743\u91cd\u6570\u9650\u5236\u4e3a4\uff08\u8fd9\u4e5f\u662f\u6211\u4eec\u5f53\u524d\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\u652f\u6301\u7684\u6700\u5927\u503c\uff09\u3002 \u5b9e\u9645\u52a0\u8f7d\u6a21\u578b\u7684\u65b9\u6cd5\u53ea\u52a0\u8f7d\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u4f46\u5b83\u9996\u5148\u8ba1\u7b97\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u7136\u540e\u5728\u7ed3\u5c3e\u8c03\u7528 processAnimations \u4ee5\u751f\u6210 AnimGameItem \u5b9e\u4f8b\u3002 processMesh \u65b9\u6cd5\u4e0e StaticMeshesLoader \u7c7b\u4e2d\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u5b83\u521b\u5efa\u7684\u7f51\u683c\u5c06\u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\uff1a processBones(aiMesh, boneList, boneIds, weights); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices), Utils.listIntToArray(boneIds), Utils.listToArray(weights)); \u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u6309 processBones \u65b9\u6cd5\u8ba1\u7b97\uff1a private static void processBones(AIMesh aiMesh, List<Bone> boneList, List<Integer> boneIds, List<Float> weights) { Map<Integer, List<VertexWeight>> weightSet = new HashMap<>(); int numBones = aiMesh.mNumBones(); PointerBuffer aiBones = aiMesh.mBones(); for (int i = 0; i < numBones; i++) { AIBone aiBone = AIBone.create(aiBones.get(i)); int id = boneList.size(); Bone bone = new Bone(id, aiBone.mName().dataString(), toMatrix(aiBone.mOffsetMatrix())); boneList.add(bone); int numWeights = aiBone.mNumWeights(); AIVertexWeight.Buffer aiWeights = aiBone.mWeights(); for (int j = 0; j < numWeights; j++) { AIVertexWeight aiWeight = aiWeights.get(j); VertexWeight vw = new VertexWeight(bone.getBoneId(), aiWeight.mVertexId(), aiWeight.mWeight()); List<VertexWeight> vertexWeightList = weightSet.get(vw.getVertexId()); if (vertexWeightList == null) { vertexWeightList = new ArrayList<>(); weightSet.put(vw.getVertexId(), vertexWeightList); } vertexWeightList.add(vw); } } int numVertices = aiMesh.mNumVertices(); for (int i = 0; i < numVertices; i++) { List<VertexWeight> vertexWeightList = weightSet.get(i); int size = vertexWeightList != null ? vertexWeightList.size() : 0; for (int j = 0; j < Mesh.MAX_WEIGHTS; j++) { if (j < size) { VertexWeight vw = vertexWeightList.get(j); weights.add(vw.getWeight()); boneIds.add(vw.getBoneId()); } else { weights.add(0.0f); boneIds.add(0); } } } } \u6b64\u65b9\u6cd5\u904d\u5386\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u5b9a\u4e49\uff0c\u83b7\u53d6\u5176\u6743\u91cd\u5e76\u751f\u6210\u4e09\u4e2a\u5217\u8868\uff1a boneList \uff1a\u50a8\u5b58\u8282\u70b9\u53ca\u5176\u504f\u79fb\u77e9\u9635\u7684\u5217\u8868\u3002\u7a0d\u540e\u5c06\u4f7f\u7528\u5b83\u6765\u8ba1\u7b97\u8282\u70b9\u53d8\u6362\u3002\u5df2\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Bone \u7684\u65b0\u7c7b\u6765\u50a8\u5b58\u8be5\u4fe1\u606f\u3002\u6b64\u5217\u8868\u5c06\u50a8\u5b58\u6240\u6709\u7f51\u683c\u7684\u9aa8\u9abc\u3002 boneIds \uff1a\u53ea\u50a8\u5b58\u5305\u542b Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u9aa8\u9abc\u6807\u8bc6\u3002\u9aa8\u9abc\u5728\u6e32\u67d3\u65f6\u6839\u636e\u5176\u4f4d\u7f6e\u8fdb\u884c\u6807\u8bc6\uff0c\u6b64\u5217\u8868\u4ec5\u5305\u542b\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u3002 weights \uff1a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u5173\u8054\u9aa8\u9abc\u7684 Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u6743\u91cd\u3002 weights \u548c boneIds \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u7528\u4e8e\u6784\u9020 Mesh \u6570\u636e\u3002 boneList \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5c06\u5728\u7a0d\u540e\u8ba1\u7b97\u52a8\u753b\u6570\u636e\u65f6\u4f7f\u7528\u3002 \u8ba9\u6211\u4eec\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\u3002\u4e00\u65e6\u6211\u4eec\u521b\u5efa\u4e86\u7f51\u683c\uff0c\u8fd8\u5f97\u5230\u4e86\u5e94\u7528\u4e8e\u6839\u8282\u70b9\u7684\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u4e5f\u5c06\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u7684\u53d8\u6362\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u662f\u5728 processNodesHierarchy \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8fd9\u4e2a\u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4ece\u6839\u8282\u70b9\u5f00\u59cb\u904d\u5386\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u6784\u9020\u4e00\u4e2a\u8282\u70b9\u6811\u3002 private static Node processNodesHierarchy(AINode aiNode, Node parentNode) { String nodeName = aiNode.mName().dataString(); Node node = new Node(nodeName, parentNode); int numChildren = aiNode.mNumChildren(); PointerBuffer aiChildren = aiNode.mChildren(); for (int i = 0; i < numChildren; i++) { AINode aiChildNode = AINode.create(aiChildren.get(i)); Node childNode = processNodesHierarchy(aiChildNode, node); node.addChild(childNode); } return node; } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Node \u7c7b\uff0c\u8be5\u7c7b\u5c06\u50a8\u5b58 AINode \u5b9e\u4f8b\u7684\u76f8\u5173\u4fe1\u606f\uff0c\u5e76\u63d0\u4f9b\u4e86\u67e5\u627e\u65b9\u6cd5\u6765\u5b9a\u4f4d\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u4ee5\u4fbf\u6309\u540d\u79f0\u67e5\u627e\u8282\u70b9\u3002\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8be5\u6570\u636e\u8ba1\u7b97 processAnimations \u65b9\u6cd5\u4e2d\u7684\u52a8\u753b\u3002\u8be5\u65b9\u6cd5\u8fd4\u56de Animation \u5b9e\u4f8b\u7684 Map \u3002\u8bf7\u8bb0\u4f4f\uff0c\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u56e0\u6b64\u5b83\u4eec\u6309\u540d\u79f0\u50a8\u5b58\u7d22\u5f15\u3002\u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6784\u5efa\u4e00\u4e2a AnimAgameItem \u5b9e\u4f8b\u3002 processAnimations \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a private static Map<String, Animation> processAnimations(AIScene aiScene, List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { Map<String, Animation> animations = new HashMap<>(); // \u5904\u7406\u6240\u6709\u52a8\u753b int numAnimations = aiScene.mNumAnimations(); PointerBuffer aiAnimations = aiScene.mAnimations(); for (int i = 0; i < numAnimations; i++) { AIAnimation aiAnimation = AIAnimation.create(aiAnimations.get(i)); // \u4e3a\u6bcf\u4e2a\u8282\u70b9\u8ba1\u7b97\u53d8\u6362\u77e9\u9635 int numChanels = aiAnimation.mNumChannels(); PointerBuffer aiChannels = aiAnimation.mChannels(); for (int j = 0; j < numChanels; j++) { AINodeAnim aiNodeAnim = AINodeAnim.create(aiChannels.get(j)); String nodeName = aiNodeAnim.mNodeName().dataString(); Node node = rootNode.findByName(nodeName); buildTransFormationMatrices(aiNodeAnim, node); } List<AnimatedFrame> frames = buildAnimationFrames(boneList, rootNode, rootTransformation); Animation animation = new Animation(aiAnimation.mName().dataString(), frames, aiAnimation.mDuration()); animations.put(animation.getName(), animation); } return animations; } \u5c06\u4e3a\u6bcf\u4e2a\u52a8\u753b\u5904\u7406\u5176\u52a8\u753b\u901a\u9053\uff0c\u6bcf\u4e2a\u901a\u9053\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\uff0c\u8fd9\u4e9b\u53d8\u5316\u5e94\u8be5\u968f\u7740\u65f6\u95f4\u7684\u63a8\u79fb\u5e94\u7528\u4e8e\u4e00\u4e2a\u8282\u70b9\u3002\u4e3a\u6bcf\u4e2a\u8282\u70b9\u5b9a\u4e49\u7684\u53d8\u6362\u5728 buildTransFormationMatrices \u65b9\u6cd5\u4e2d\u5b9a\u4e49\uff0c\u8fd9\u4e9b\u77e9\u9635\u88ab\u6bcf\u4e2a\u8282\u70b9\u50a8\u5b58\u3002\u4e00\u65e6\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u4e2d\u50a8\u5b58\u5b8c\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6784\u5efa\u52a8\u753b\u5e27\u3002 \u8ba9\u6211\u4eec\u5148\u56de\u987e\u4e00\u4e0b buildTransFormationMatrices \u65b9\u6cd5\uff1a private static void buildTransFormationMatrices(AINodeAnim aiNodeAnim, Node node) { int numFrames = aiNodeAnim.mNumPositionKeys(); AIVectorKey.Buffer positionKeys = aiNodeAnim.mPositionKeys(); AIVectorKey.Buffer scalingKeys = aiNodeAnim.mScalingKeys(); AIQuatKey.Buffer rotationKeys = aiNodeAnim.mRotationKeys(); for (int i = 0; i < numFrames; i++) { AIVectorKey aiVecKey = positionKeys.get(i); AIVector3D vec = aiVecKey.mValue(); Matrix4f transfMat = new Matrix4f().translate(vec.x(), vec.y(), vec.z()); AIQuatKey quatKey = rotationKeys.get(i); AIQuaternion aiQuat = quatKey.mValue(); Quaternionf quat = new Quaternionf(aiQuat.x(), aiQuat.y(), aiQuat.z(), aiQuat.w()); transfMat.rotate(quat); if (i < aiNodeAnim.mNumScalingKeys()) { aiVecKey = scalingKeys.get(i); vec = aiVecKey.mValue(); transfMat.scale(vec.x(), vec.y(), vec.z()); } node.addTransformation(transfMat); } } \u5982\u4f60\u6240\u89c1\uff0c AINodeAnim \u5b9e\u4f8b\u5b9a\u4e49\u4e86\u4e00\u7ec4\u5305\u542b\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4fe1\u606f\u7684\u952e\uff0c\u8fd9\u4e9b\u952e\u662f\u6307\u7279\u5b9a\u7684\u65f6\u523b\u3002\u6211\u4eec\u5047\u8bbe\u6570\u636e\u662f\u6309\u65f6\u95f4\u987a\u5e8f\u6392\u5217\u7684\uff0c\u5e76\u6784\u5efa\u4e00\u4e2a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5e27\u7684\u53d8\u6362\u7684\u77e9\u9635\u5217\u8868\u3002\u6700\u540e\u7684\u8ba1\u7b97\u662f\u5728 buildAnimationFrames \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private static List<AnimatedFrame> buildAnimationFrames(List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { int numFrames = rootNode.getAnimationFrames(); List<AnimatedFrame> frameList = new ArrayList<>(); for (int i = 0; i < numFrames; i++) { AnimatedFrame frame = new AnimatedFrame(); frameList.add(frame); int numBones = boneList.size(); for (int j = 0; j < numBones; j++) { Bone bone = boneList.get(j); Node node = rootNode.findByName(bone.getBoneName()); Matrix4f boneMatrix = Node.getParentTransforms(node, i); boneMatrix.mul(bone.getOffsetMatrix()); boneMatrix = new Matrix4f(rootTransformation).mul(boneMatrix); frame.setMatrix(j, boneMatrix); } } return frameList; } \u6b64\u65b9\u6cd5\u8fd4\u56de AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\uff0c\u6bcf\u4e2a AnimatedFrame \u5b9e\u4f8b\u5c06\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u7279\u5b9a\u5e27\u7684\u6bcf\u4e2a\u9aa8\u9abc\u7684\u53d8\u6362\u5217\u8868\u3002\u8fd9\u4e2a\u65b9\u6cd5\u53ea\u662f\u8fed\u4ee3\u50a8\u5b58\u6240\u6709\u9aa8\u9abc\u7684\u5217\u8868\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u9aa8\u9abc\uff1a \u83b7\u53d6\u76f8\u5173\u8054\u7684\u8282\u70b9\u3002 \u901a\u8fc7\u5c06\u76f8\u5173\u8054\u7684 Node \u7684\u53d8\u6362\u4e0e\u5176\u7236\u8282\u70b9\u7684\u6240\u6709\u53d8\u6362\u76f8\u4e58\uff0c\u751f\u6210\u53d8\u6362\u77e9\u9635\uff0c\u76f4\u81f3\u6839\u8282\u70b9\u3002\u8fd9\u662f\u5728 Node.getParentTransforms \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002 \u5b83\u5c06\u8be5\u77e9\u9635\u4e0e\u9aa8\u9abc\u7684\u504f\u501a\u77e9\u9635\u76f8\u4e58\u3002 \u6700\u540e\u7684\u53d8\u6362\u662f\u901a\u8fc7\u5c06\u6839\u8282\u70b9\u7684\u53d8\u6362\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u4e2d\u8ba1\u7b97\u7684\u77e9\u9635\u76f8\u4e58\u6765\u8ba1\u7b97\u7684\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4ed6\u4fee\u6539\u662f\u4e3a\u4e86\u9002\u5e94\u67d0\u4e9b\u7ed3\u6784\u800c\u8fdb\u884c\u7684\u5fae\u5c0f\u4fee\u6539\u3002\u6700\u540e\uff0c\u4f60\u80fd\u591f\u52a0\u8f7d\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u52a8\u753b\uff08\u4f60\u9700\u8981\u6309\u7a7a\u683c\u6539\u53d8\u5e27\uff09\uff1a \u8fd9\u4e2a\u793a\u4f8b\u7684\u590d\u6742\u4e4b\u5904\u5728\u4e8eAssimp\u7ed3\u6784\u7684\u8c03\u6574\uff0c\u4f7f\u5176\u9002\u5e94\u672c\u4e66\u4e2d\u4f7f\u7528\u7684\u5f15\u64ce\uff0c\u5e76\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6570\u636e\u3002\u6b64\u5916\uff0c\u8fd9\u4e9b\u6982\u5ff5\u4e0e\u52a8\u753b\u4e00\u7ae0\u4e2d\u7684\u6982\u5ff5\u7c7b\u4f3c\u3002\u4f60\u53ef\u4ee5\u5c1d\u8bd5\u4fee\u6539\u6e90\u4ee3\u7801\u4ee5\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u52a8\u753b\u3002","title":"Assimp\u5e93"},{"location":"27-assimp/#assimpassimp","text":"","title":"Assimp\u5e93\uff08Assimp\uff09"},{"location":"27-assimp/#_1","text":"\u52a0\u8f7d\u4e0d\u540c\u683c\u5f0f\u7684\u590d\u6742\u4e09\u7ef4\u6a21\u578b\u7684\u529f\u80fd\u5bf9\u4e8e\u7f16\u5199\u6e38\u620f\u81f3\u5173\u91cd\u8981\uff0c\u4e3a\u5176\u4e2d\u4e00\u4e9b\u7f16\u5199\u89e3\u6790\u5668\u9700\u8981\u5927\u91cf\u7684\u5de5\u4f5c\uff0c\u5373\u4fbf\u53ea\u652f\u6301\u4e00\u79cd\u683c\u5f0f\u4e5f\u53ef\u80fd\u5f88\u8017\u65f6\u3002\u4f8b\u5982\uff0c\u5728\u7b2c\u4e5d\u7ae0\u4e2d\u63cf\u8ff0\u7684wavefront\u52a0\u8f7d\u5668\u53ea\u89e3\u6790\u4e86\u89c4\u8303\u4e2d\u7684\u4e00\u5c0f\u90e8\u5206\uff08\u6839\u672c\u4e0d\u5904\u7406\u6750\u8d28\uff09\u3002 \u5e78\u8fd0\u7684\u662f\uff0c\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528 Assimp \u5e93\u6765\u89e3\u6790\u8bb8\u591a\u5e38\u89c1\u76843D\u683c\u5f0f\u3002\u5b83\u662f\u4e00\u4e2aC++\u5e93\uff0c\u53ef\u4ee5\u4ee5\u5404\u79cd\u683c\u5f0f\u52a0\u8f7d\u9759\u6001\u548c\u52a8\u753b\u6a21\u578b\u3002LWJGL\u63d0\u4f9b\u4e86\u7ed1\u5b9a\u4ee5\u4fbf\u4eceJava\u4ee3\u7801\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u5b83\u3002 \u9996\u5148\u662f\u5c06Assimp\u7684Maven\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230 pom.xml \u6587\u4ef6\u4e2d\u3002\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u7f16\u8bd1\u65f6\u548c\u8fd0\u884c\u65f6\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> </dependency> <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u4e00\u65e6\u8bbe\u7f6e\u4e86\u4f9d\u8d56\u9879\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a StaticMeshesLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u7528\u4e8e\u52a0\u8f7d\u4e0d\u5e26\u52a8\u753b\u7684\u7f51\u683c\uff0c\u8be5\u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u9759\u6001\u516c\u5171\u65b9\u6cd5\uff1a public static Mesh[] load(String resourcePath, String texturesDir) throws Exception { return load(resourcePath, texturesDir, aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals); } public static Mesh[] load(String resourcePath, String texturesDir, int flags) throws Exception { // .... \u4e24\u79cd\u65b9\u6cd5\u90fd\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * resourcePath \uff1a\u6a21\u578b\u6587\u4ef6\u6240\u5728\u7684\u6587\u4ef6\u8def\u5f84\u3002\u8fd9\u662f\u4e00\u4e2a\u7edd\u5bf9\u8def\u5f84\uff0c\u56e0\u4e3aAssimp\u53ef\u80fd\u9700\u8981\u52a0\u8f7d\u5176\u4ed6\u6587\u4ef6\uff08\u4f8b\u5982wavefront\u3001OBJ\u7b49\u6587\u4ef6\u7684\u6750\u8d28\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u53ef\u80fd\u4f7f\u7528\u4e0e\u8d44\u6e90\u8def\u5f84\u76f8\u540c\u7684\u57fa\u8def\u5f84\u3002\u5982\u679c\u5c06\u8d44\u6e90\u5d4c\u5165JAR\u6587\u4ef6\u4e2d\uff0c\u90a3\u4e48assimp\u5c06\u65e0\u6cd5\u5bfc\u5165\u5b83\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u662f\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 * texturesDir \uff1a\u4fdd\u5b58\u6b64\u6a21\u578b\u7684\u6587\u4ef6\u5939\u8def\u5f84\u3002\u8fd9\u662fCLASSPATH\u7684\u76f8\u5bf9\u8def\u5f84\u3002\u4f8b\u5982\uff0cwavefront\u6750\u8d28\u6587\u4ef6\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u4ee3\u7801\u5e0c\u671b\u6b64\u6587\u4ef6\u4f4d\u4e8e texturesDir \u76ee\u5f55\u4e0b\u3002\u5982\u679c\u53d1\u73b0\u7eb9\u7406\u52a0\u8f7d\u9519\u8bef\uff0c\u53ef\u80fd\u9700\u8981\u5728\u6a21\u578b\u6587\u4ef6\u4e2d\u624b\u52a8\u8c03\u6574\u8fd9\u4e9b\u8def\u5f84\u3002 \u7b2c\u4e8c\u4e2a\u65b9\u6cd5\u6709\u4e00\u4e2a\u540d\u4e3a flags \u7684\u989d\u5916\u53c2\u6570\u3002\u6b64\u53c2\u6570\u5141\u8bb8\u8c03\u6574\u52a0\u8f7d\u8fc7\u7a0b\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u7b2c\u4e8c\u4e2a\u65b9\u6cd5\uff0c\u5e76\u4f20\u9012\u4e00\u4e9b\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u6709\u7528\u7684\u503c\uff1a * aiProcess_JoinIdenticalVertices \uff1a\u6b64\u6807\u8bb0\u5c06\u51cf\u5c11\u4f7f\u7528\u7684\u9876\u70b9\u6570\uff0c\u8bc6\u522b\u53ef\u5728\u9762\u4e4b\u95f4\u91cd\u7528\u7684\u9876\u70b9\u3002 * aiProcess_Triangulate \uff1a\u6a21\u578b\u53ef\u4ee5\u4f7f\u7528\u56db\u8fb9\u5f62\u6216\u5176\u4ed6\u51e0\u4f55\u56fe\u5f62\u6765\u5b9a\u4e49\u5b83\u4eec\u7684\u5143\u7d20\u3002\u7531\u4e8e\u6211\u4eec\u53ea\u5904\u7406\u4e09\u89d2\u5f62\uff0c\u56e0\u6b64\u5fc5\u987b\u4f7f\u7528\u6b64\u6807\u8bb0\u5c06\u6240\u6709\u7684\u9762\u62c6\u5206\u4e3a\u4e09\u89d2\u5f62\uff08\u5982\u679c\u6709\u5fc5\u8981\u7684\u8bdd\uff09\u3002 * aiProcess_FixInfacingNormals \uff1a\u6b64\u6807\u8bb0\u5c06\u5c1d\u8bd5\u53cd\u8f6c\u53ef\u80fd\u6307\u5411\u5185\u90e8\u7684\u6cd5\u7ebf\u3002 \u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u6807\u8bb0\u53ef\u4ee5\u4f7f\u7528\uff0c\u4f60\u53ef\u4ee5\u5728LWJGL\u7684Javadoc\u6587\u6863\u4e2d\u67e5\u9605\u5b83\u4eec\u3002 \u56de\u770b\u5230\u7b2c\u4e8c\u4e2a\u8f7d\u5165\u65b9\u6cd5\uff0c\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 aiImportFile \u65b9\u6cd5\u6765\u52a0\u8f7d\u5e26\u6709\u6240\u9009\u6807\u8bb0\u7684\u6a21\u578b\u3002 AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } \u8f7d\u5165\u65b9\u6cd5\u7684\u5176\u4f59\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials); meshes[i] = mesh; } return meshes; \u6211\u4eec\u5904\u7406\u6a21\u578b\u4e2d\u5305\u542b\u7684\u6750\u8d28\uff0c\u6750\u8d28\u5b9a\u4e49\u7ec4\u6210\u6a21\u578b\u7684\u7f51\u683c\u4f7f\u7528\u7684\u989c\u8272\u548c\u7eb9\u7406\u3002\u7136\u540e\u6211\u4eec\u5904\u7406\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u6a21\u578b\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7f51\u683c\uff0c\u6bcf\u4e2a\u7f51\u683c\u90fd\u53ef\u4ee5\u4f7f\u7528\u4e3a\u6a21\u578b\u5b9a\u4e49\u7684\u4e00\u79cd\u6750\u8d28\u3002 \u5982\u679c\u4f60\u770b\u5230\u4e0a\u9762\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u5f88\u591a\u5bf9Assimp\u5e93\u7684\u8c03\u7528\u8fd4\u56de\u7684 PointerBuffer \u5b9e\u4f8b\u3002\u4f60\u53ef\u4ee5\u7528C\u6307\u9488\u90a3\u6837\u7684\u65b9\u5f0f\u770b\u5f85\u5b83\u4eec\uff0c\u5b83\u4eec\u53ea\u662f\u6307\u5411\u50a8\u5b58\u6570\u636e\u7684\u5185\u5b58\u533a\u57df\u3002\u4f60\u9700\u8981\u63d0\u524d\u77e5\u9053\u5b83\u4eec\u50a8\u5b58\u7684\u6570\u636e\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5904\u7406\u5b83\u4eec\u3002\u5bf9\u4e8e\u6750\u8d28\uff0c\u6211\u4eec\u8fed\u4ee3\u8be5\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMaterial \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u8fed\u4ee3\u50a8\u5b58\u7f51\u683c\u6570\u636e\u7684\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMesh \u7c7b\u7684\u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u770b\u770b processMaterial \u65b9\u6cd5\uff1a private static void processMaterial(AIMaterial aiMaterial, List<Material> materials, String texturesDir) throws Exception { AIColor4D colour = AIColor4D.create(); AIString path = AIString.calloc(); Assimp.aiGetMaterialTexture(aiMaterial, aiTextureType_DIFFUSE, 0, path, (IntBuffer) null, null, null, null, null, null); String textPath = path.dataString(); Texture texture = null; if (textPath != null && textPath.length() > 0) { TextureCache textCache = TextureCache.getInstance(); texture = textCache.getTexture(texturesDir + \"/\" + textPath); } Vector4f ambient = Material.DEFAULT_COLOUR; int result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_AMBIENT, aiTextureType_NONE, 0, colour); if (result == 0) { ambient = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f diffuse = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_DIFFUSE, aiTextureType_NONE, 0, colour); if (result == 0) { diffuse = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f specular = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_SPECULAR, aiTextureType_NONE, 0, colour); if (result == 0) { specular = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Material material = new Material(ambient, diffuse, specular, 1.0f); material.setTexture(texture); materials.add(material); } \u6211\u4eec\u68c0\u67e5\u6750\u8d28\u662f\u5426\u5b9a\u4e49\u4e86\u7eb9\u7406\u3002\u5982\u679c\u6709\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a TextureCache \u7684\u65b0\u7c7b\uff0c\u7528\u4e8e\u7f13\u5b58\u7eb9\u7406\u3002\u8fd9\u662f\u56e0\u4e3a\u51e0\u4e2a\u7f51\u683c\u53ef\u80fd\u5171\u4eab\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u4e0d\u60f3\u6d6a\u8d39\u7a7a\u95f4\u4e00\u6b21\u53c8\u4e00\u6b21\u52a0\u8f7d\u76f8\u540c\u7684\u6570\u636e\u3002\u7136\u540e\u6211\u4eec\u5c1d\u8bd5\u83b7\u5f97\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u5e78\u8fd0\u7684\u662f\uff0c\u6211\u4eec\u5bf9\u6750\u8d28\u7684\u5b9a\u4e49\u5df2\u7ecf\u5305\u542b\u4e86\u8fd9\u4e9b\u4fe1\u606f\u3002 TextureCache \u7684\u5b9a\u4e49\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u6620\u5c04\uff0c\u901a\u8fc7\u7eb9\u7406\u6587\u4ef6\u7684\u8def\u5f84\u5bf9\u4e0d\u540c\u7684\u7eb9\u7406\u8fdb\u884c\u7d22\u5f15\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u7531\u4e8e\u73b0\u5728\u7eb9\u7406\u53ef\u80fd\u4f7f\u7528\u4e0d\u540c\u7684\u56fe\u50cf\u683c\u5f0f\uff08PNG\u3001JPEG\u7b49\uff09\uff0c\u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86\u7eb9\u7406\u7684\u52a0\u8f7d\u65b9\u5f0f\uff0c\u73b0\u5728\u4f7f\u7528STB\u5e93\u6765\u52a0\u8f7d\u66f4\u591a\u7684\u683c\u5f0f\uff0c\u800c\u4e0d\u662f\u4f7f\u7528PNG\u5e93\u3002 \u8ba9\u6211\u4eec\u770b\u5230 StaticMeshesLoader \u7c7b\u3002 processMesh \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static Mesh processMesh(AIMesh aiMesh, List<Material> materials) { List<Float> vertices = new ArrayList<>(); List<Float> textures = new ArrayList<>(); List<Float> normals = new ArrayList<>(); List<Integer> indices = new ArrayList(); processVertices(aiMesh, vertices); processNormals(aiMesh, normals); processTextCoords(aiMesh, textures); processIndices(aiMesh, indices); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices) ); Material material; int materialIdx = aiMesh.mMaterialIndex(); if (materialIdx >= 0 && materialIdx < materials.size()) { material = materials.get(materialIdx); } else { material = new Material(); } mesh.setMaterial(material); return mesh; } Mesh \u7531\u4e00\u7ec4\u9876\u70b9\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u65b9\u5411\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u5b9a\u4e49\u3002\u6bcf\u4e2a\u5143\u7d20\u90fd\u5728 processVertices \u3001 processNormals \u3001 processTextCoords \u548c processIndices \u65b9\u6cd5\u4e2d\u5904\u7406\uff0c\u7f51\u683c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u5176\u7d22\u5f15\u6307\u5411\u6750\u8d28\u3002\u5982\u679c\u7d22\u5f15\u4e0e\u4e4b\u524d\u5904\u7406\u7684\u6750\u8d28\u76f8\u5bf9\u5e94\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b83\u4eec\u4e0e Mesh \u76f8\u5173\u8054\u3002 processXXX \u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u662f\u5728\u8fd4\u56de\u6240\u9700\u6570\u636e\u7684 AIMesh \u5b9e\u4f8b\u4e0a\u8c03\u7528\u76f8\u5e94\u7684\u65b9\u6cd5\u3002\u4f8b\u5982\uff0c processVertices \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static void processVertices(AIMesh aiMesh, List<Float> vertices) { AIVector3D.Buffer aiVertices = aiMesh.mVertices(); while (aiVertices.remaining() > 0) { AIVector3D aiVertex = aiVertices.get(); vertices.add(aiVertex.x()); vertices.add(aiVertex.y()); vertices.add(aiVertex.z()); } } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u8c03\u7528 mVertices \u65b9\u6cd5\u6765\u83b7\u53d6\u9876\u70b9\u7684\u7f13\u51b2\u533a\uff0c\u7b80\u5355\u5730\u5904\u7406\u5b83\u4eec\u6765\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u9876\u70b9\u4f4d\u7f6e\u7684\u6d6e\u70b9\u6570\u5217\u8868\u3002\u56e0\u4e3a\uff0c\u8be5\u65b9\u6cd5\u53ea\u8fd4\u56de\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4f60\u53ef\u4ee5\u5c06\u8be5\u6570\u636e\u76f4\u63a5\u4f20\u7ed9\u521b\u5efa\u9876\u70b9\u7684OpenGL\u65b9\u6cd5\u3002\u4f46\u6211\u4eec\u4e0d\u8fd9\u6837\u505a\uff0c\u539f\u56e0\u6709\u4e24\u4e2a\u3002\u7b2c\u4e00\u4e2a\u539f\u56e0\u662f\u5c3d\u91cf\u51cf\u5c11\u5bf9\u4ee3\u7801\u5e93\u7684\u4fee\u6539\uff0c\u7b2c\u4e8c\u4e2a\u539f\u56e0\u662f\uff0c\u901a\u8fc7\u52a0\u8f7d\u6570\u636e\u5230\u4e2d\u95f4\u5c42\u4e2d\uff0c\u4f60\u53ef\u4ee5\u6267\u884c\u4e00\u4e9b\u4e13\u95e8\u7684\u5904\u7406\u4efb\u52a1\uff0c\u751a\u81f3\u8c03\u8bd5\u52a0\u8f7d\u8fc7\u7a0b\u3002 \u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u6709\u6548\u7684\u793a\u4f8b\uff0c\u5373\u76f4\u63a5\u5c06\u7f13\u51b2\u533a\u4f20\u7ed9OpenGL\uff0c\u53ef\u4ee5\u67e5\u770b\u8fd9\u4e2a \u4f8b\u5b50 \u3002 StaticMeshesLoader \u7c7b\u8ba9 OBJLoader \u7c7b\u8fc7\u65f6\u4e86\uff0c\u56e0\u6b64\u5b83\u5df2\u7ecf\u4ece\u6e90\u4ee3\u7801\u4e2d\u5220\u9664\u3002\u4e00\u4e2a\u66f4\u590d\u6742\u7684OBJ\u6587\u4ef6\u5df2\u7ecf\u4f5c\u4e3a\u793a\u4f8b\u63d0\u4f9b\uff0c\u5982\u679c\u8fd0\u884c\u5b83\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a","title":"\u9759\u6001\u7f51\u683c"},{"location":"27-assimp/#_2","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4f7f\u7528Assimp\u52a0\u8f7d\u4e86\u9759\u6001\u7f51\u683c\uff0c\u53ef\u4ee5\u7ee7\u7eed\u8bb2\u89e3\u52a8\u753b\u3002\u5982\u679c\u4f60\u56de\u60f3\u52a8\u753b\u4e00\u7ae0\uff0c\u4e0e\u7f51\u683c\u5173\u8054\u7684VAO\u5305\u542b\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u5e94\u5e94\u7528\u4e8e\u5173\u8282\u4f4d\u7f6e\u4ee5\u8c03\u6574\u6700\u7ec8\u9876\u70b9\u4f4d\u7f6e\u7684\u6743\u91cd\u5217\u8868\u3002 \u6bcf\u4e2a\u9876\u70b9\u4f4d\u7f6e\u90fd\u5173\u8054\u4e86\u4e00\u4e2a\u6539\u53d8\u6700\u7ec8\u4f4d\u7f6e\u7684\u56db\u4e2a\u6743\u91cd\u7684\u5217\u8868\uff0c\u5f15\u7528\u4e86\u5c06\u7ec4\u5408\u4ee5\u786e\u5b9a\u9876\u70b9\u6700\u7ec8\u4f4d\u7f6e\u7684\u9aa8\u9abc\u7d22\u5f15\u3002\u5728\u6bcf\u4e00\u5e27\uff0c\u4e00\u4e2a\u53d8\u6362\u77e9\u9635\u5217\u8868\u5c06\u88ab\u4f5c\u4e3aUniform\u52a0\u8f7d\u5230\u6bcf\u4e2a\u5173\u8282\u3002\u6839\u636e\u8fd9\u4e9b\u6570\u636e\uff0c\u7b97\u51fa\u6700\u7ec8\u4f4d\u7f6e\u3002 \u5728\u52a8\u753b\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u5f00\u53d1\u4e86\u4e00\u4e2aMD5\u89e3\u6790\u5668\u6765\u52a0\u8f7d\u52a8\u753b\u7f51\u683c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Assimp\u5e93\u3002\u8fd9\u5c06\u5141\u8bb8\u6211\u4eec\u52a0\u8f7dMD5\u4e4b\u5916\u7684\u66f4\u591a\u683c\u5f0f\uff0c\u4f8b\u5982 COLLADA \uff0c FBX \u7b49\u3002 \u5728\u5f00\u59cb\u7f16\u7801\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7406\u6e05\u4e00\u4e9b\u672f\u8bed\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u52a0\u533a\u5206\u5730\u63d0\u5230\u9aa8\u9abc\u548c\u5173\u8282\u3002\u9aa8\u9abc\u6216\u8005\u5173\u8282\u90fd\u53ea\u662f\u5f71\u54cd\u9876\u70b9\u7684\u5143\u7d20\uff0c\u5e76\u4e14\u5177\u6709\u5f62\u6210\u5c42\u6b21\u7684\u7236\u7ea7\u3002MD5\u683c\u5f0f\u4f7f\u7528\u672f\u8bed\u5173\u8282\uff0c\u800cAssimp\u4f7f\u7528\u672f\u8bed\u9aa8\u9abc\u3002 \u8ba9\u6211\u4eec\u5148\u770b\u4e00\u4e0b\u7531Assimp\u5904\u7406\u7684\u50a8\u5b58\u7740\u52a8\u753b\u4fe1\u606f\u7684\u7ed3\u6784\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u9aa8\u9abc\u548c\u6743\u91cd\u6570\u636e\u5f00\u59cb\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002\u7f51\u683c\u8fd8\u50a8\u5b58\u7740\u9aa8\u9abc\u5217\u8868\uff0c\u6bcf\u4e2a\u9aa8\u9abc\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u4e00\u4e2a\u504f\u79fb\u77e9\u9635\uff1a\u7a0d\u540e\u5c06\u7528\u5b83\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc\u5e94\u8be5\u4f7f\u7528\u7684\u6700\u7ec8\u53d8\u6362\u3002 \u9aa8\u9abc\u8fd8\u6307\u5411\u4e00\u4e2a\u6743\u91cd\u5217\u8868\uff0c\u6bcf\u4e2a\u6743\u91cd\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u6743\u91cd\u56e0\u5b50\uff0c\u5373\u7528\u4e8e\u8c03\u8282\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u9aa8\u9abc\u53d8\u6362\u5f71\u54cd\u7684\u6570\u5b57\u3002 \u4e00\u4e2a\u9876\u70b9\u6807\u8bc6\u7b26\uff0c\u5373\u4e0e\u5f53\u524d\u9aa8\u9abc\u76f8\u5173\u8054\u7684\u9876\u70b9\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u6240\u6709\u8fd9\u4e9b\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u4ece\u4e0a\u8ff0\u7684\u7ed3\u6784\u6784\u9020\u9876\u70b9\u4f4d\u7f6e\u3001\u9aa8\u9abc/\u5173\u8282/\u7d22\u5f15\u548c\u76f8\u5173\u6743\u91cd\u7684\u5217\u8868\u3002\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6a21\u578b\u4e2d\u5b9a\u4e00\u4e2a\u6240\u6709\u52a8\u753b\u5e27\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc/\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Assimp\u573a\u666f\u5bf9\u8c61\u662f\u5b9a\u4e49\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u6bcf\u4e2a\u8282\u70b9\u90fd\u7531\u4e00\u4e2a\u540d\u8bcd\u548c\u4e00\u4e2a\u5b50\u8282\u70b9\u5217\u8868\u5b9a\u4e49\u3002\u52a8\u753b\u4f7f\u7528\u8fd9\u4e9b\u8282\u70b9\u6765\u5b9a\u4e49\u5e94\u8be5\u5e94\u7528\u7684\u53d8\u6362\uff0c\u8fd9\u4e2a\u5c42\u6b21\u7ed3\u6784\u5b9e\u9645\u4e0a\u5b9a\u4e49\u4e86\u9aa8\u9abc\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u6bcf\u4e2a\u9aa8\u9abc\u90fd\u662f\u4e00\u4e2a\u8282\u70b9\uff0c\u5e76\u4e14\u6709\u4e00\u4e2a\u7236\u8282\u70b9\uff08\u6839\u8282\u70b9\u9664\u5916\uff09\uff0c\u53ef\u80fd\u8fd8\u6709\u4e00\u7ec4\u5b50\u8282\u70b9\u3002\u6709\u4e00\u4e9b\u7279\u6b8a\u7684\u8282\u70b9\u4e0d\u662f\u9aa8\u9abc\uff0c\u5b83\u4eec\u7528\u4e8e\u5bf9\u53d8\u6362\u8fdb\u884c\u5206\u7ec4\uff0c\u5728\u8ba1\u7b97\u53d8\u6362\u65f6\u8fdb\u884c\u5904\u7406\u3002\u53e6\u4e00\u4e2a\u95ee\u9898\u662f\uff0c\u8fd9\u4e9b\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u662f\u57fa\u4e8e\u6574\u4e2a\u6a21\u578b\u5b9a\u4e49\u7684\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u6ca1\u6709\u5355\u72ec\u7684\u5c42\u6b21\u7ed3\u6784\u3002 \u573a\u666f\u8fd8\u5b9a\u4e49\u4e86\u4e00\u7ec4\u52a8\u753b\u3002\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u53ef\u4ee5\u5bf9\u6a21\u578b\u505a\u884c\u8d70\u3001\u8dd1\u52a8\u7b49\u52a8\u753b\u3002\u6bcf\u4e2a\u52a8\u753b\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\u3002\u52a8\u753b\u5177\u6709\u4ee5\u4e0b\u5c5e\u6027\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u6301\u7eed\u65f6\u95f4\u3002\u5373\u52a8\u753b\u7684\u6301\u7eed\u65f6\u95f4\uff0c\u7531\u4e8e\u52a8\u753b\u662f\u5e94\u7528\u4e8e\u6bcf\u4e2a\u4e0d\u540c\u5e27\u7684\u6bcf\u4e2a\u8282\u70b9\u7684\u53d8\u6362\u5217\u8868\uff0c\u56e0\u6b64\u540d\u79f0\u53ef\u80fd\u770b\u8d77\u6765\u5f88\u6df7\u4e71\u3002 \u4e00\u4e2a\u52a8\u753b\u901a\u9053\uff08Animation Channel\uff09\u7684\u5217\u8868\u3002\u52a8\u753b\u901a\u9053\u50a8\u5b58\u5e94\u5e94\u7528\u4e8e\u6bcf\u4e2a\u8282\u70b9\u7684\u7279\u5b9a\u65f6\u95f4\u70b9\u7684\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u6570\u636e\uff0c\u6a21\u578b\u4e2d\u50a8\u5b58\u52a8\u753b\u901a\u9053\u6570\u636e\u7684\u7c7b\u662f AINodeAnim \u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e0a\u8ff0\u6240\u6709\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\uff1a \u5bf9\u4e8e\u7279\u5b9a\u7684\u65f6\u523b\uff0c\u6216\u8005\u8bf4\u5bf9\u4e8e\u5e27\uff0c\u8981\u5e94\u7528\u5230\u9aa8\u9abc\u7684\u53d8\u6362\u662f\u5728\u52a8\u753b\u901a\u9053\u4e2d\u4e3a\u8be5\u65f6\u523b\u5b9a\u4e49\u7684\u53d8\u6362\uff0c\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u5230\u6839\u8282\u70b9\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u573a\u666f\u4e2d\u5b58\u50a8\u7684\u4fe1\u606f\u8fdb\u884c\u91cd\u65b0\u6392\u5e8f\uff0c\u6d41\u7a0b\u5982\u4e0b\uff1a \u6784\u9020\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u3002 \u5bf9\u6bcf\u4e2a\u52a8\u753b\uff0c\u8fed\u4ee3\u6bcf\u4e2a\u52a8\u753b\u901a\u9053\uff08\u5bf9\u6bcf\u4e2a\u52a8\u753b\u8282\u70b9\uff09\uff1a\u4e3a\u6240\u6709\u5e27\u6784\u9020\u53d8\u6362\u77e9\u9635\u3002\u53d8\u6362\u77e9\u9635\u662f\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\u7684\u7ec4\u5408\u3002 \u91cd\u65b0\u6392\u5217\u6bcf\u4e00\u5e27\u7684\u4fe1\u606f\uff1a\u6784\u9020\u8981\u5e94\u7528\u4e8e\u7f51\u683c\u4e2d\u6bcf\u4e2a\u9aa8\u9abc\u7684\u6700\u7ec8\u53d8\u6362\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u9aa8\u9abc\u7684\u53d8\u6362\u77e9\u9635\uff08\u76f8\u5173\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\uff09\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\u76f4\u5230\u6839\u8282\u70b9\u6765\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u9996\u5148\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a AnimMeshesLoader \u7684\u7c7b\uff0c\u5b83\u7531 StaticMeshesLoader \u6269\u5c55\uff0c\u4f46\u5b83\u4e0d\u8fd4\u56de\u7f51\u683c\u6570\u7ec4\uff0c\u800c\u662f\u8fd4\u56de\u4e00\u4e2a AnimGameItem \u5b9e\u4f8b\u3002\u5b83\u5b9a\u4e49\u4e86\u4e24\u4e2a\u516c\u5171\u65b9\u6cd5\uff1a public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir) throws Exception { return loadAnimGameItem(resourcePath, texturesDir, aiProcess_GenSmoothNormals | aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals | aiProcess_LimitBoneWeights); } public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir, int flags) throws Exception { AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } List<Bone> boneList = new ArrayList<>(); int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials, boneList); meshes[i] = mesh; } AINode aiRootNode = aiScene.mRootNode(); Matrix4f rootTransfromation = AnimMeshesLoader.toMatrix(aiRootNode.mTransformation()); Node rootNode = processNodesHierarchy(aiRootNode, null); Map<String, Animation> animations = processAnimations(aiScene, boneList, rootNode, rootTransfromation); AnimGameItem item = new AnimGameItem(meshes, animations); return item; } \u8fd9\u4e9b\u65b9\u6cd5\u4e0e StaticMeshesLoader \u4e2d\u5b9a\u4e49\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u5982\u4e0b\u533a\u522b\uff1a \u4f20\u9012\u9ed8\u8ba4\u52a0\u8f7d\u6807\u8bb0\u7684\u65b9\u6cd5\u4f7f\u7528\u4e86\u65b0\u53c2\u6570\uff1a aiProcess_LimitBoneWeights \u3002\u8fd9\u5c06\u4f1a\u5c06\u5f71\u54cd\u9876\u70b9\u7684\u6700\u5927\u6743\u91cd\u6570\u9650\u5236\u4e3a4\uff08\u8fd9\u4e5f\u662f\u6211\u4eec\u5f53\u524d\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\u652f\u6301\u7684\u6700\u5927\u503c\uff09\u3002 \u5b9e\u9645\u52a0\u8f7d\u6a21\u578b\u7684\u65b9\u6cd5\u53ea\u52a0\u8f7d\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u4f46\u5b83\u9996\u5148\u8ba1\u7b97\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u7136\u540e\u5728\u7ed3\u5c3e\u8c03\u7528 processAnimations \u4ee5\u751f\u6210 AnimGameItem \u5b9e\u4f8b\u3002 processMesh \u65b9\u6cd5\u4e0e StaticMeshesLoader \u7c7b\u4e2d\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u5b83\u521b\u5efa\u7684\u7f51\u683c\u5c06\u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\uff1a processBones(aiMesh, boneList, boneIds, weights); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices), Utils.listIntToArray(boneIds), Utils.listToArray(weights)); \u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u6309 processBones \u65b9\u6cd5\u8ba1\u7b97\uff1a private static void processBones(AIMesh aiMesh, List<Bone> boneList, List<Integer> boneIds, List<Float> weights) { Map<Integer, List<VertexWeight>> weightSet = new HashMap<>(); int numBones = aiMesh.mNumBones(); PointerBuffer aiBones = aiMesh.mBones(); for (int i = 0; i < numBones; i++) { AIBone aiBone = AIBone.create(aiBones.get(i)); int id = boneList.size(); Bone bone = new Bone(id, aiBone.mName().dataString(), toMatrix(aiBone.mOffsetMatrix())); boneList.add(bone); int numWeights = aiBone.mNumWeights(); AIVertexWeight.Buffer aiWeights = aiBone.mWeights(); for (int j = 0; j < numWeights; j++) { AIVertexWeight aiWeight = aiWeights.get(j); VertexWeight vw = new VertexWeight(bone.getBoneId(), aiWeight.mVertexId(), aiWeight.mWeight()); List<VertexWeight> vertexWeightList = weightSet.get(vw.getVertexId()); if (vertexWeightList == null) { vertexWeightList = new ArrayList<>(); weightSet.put(vw.getVertexId(), vertexWeightList); } vertexWeightList.add(vw); } } int numVertices = aiMesh.mNumVertices(); for (int i = 0; i < numVertices; i++) { List<VertexWeight> vertexWeightList = weightSet.get(i); int size = vertexWeightList != null ? vertexWeightList.size() : 0; for (int j = 0; j < Mesh.MAX_WEIGHTS; j++) { if (j < size) { VertexWeight vw = vertexWeightList.get(j); weights.add(vw.getWeight()); boneIds.add(vw.getBoneId()); } else { weights.add(0.0f); boneIds.add(0); } } } } \u6b64\u65b9\u6cd5\u904d\u5386\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u5b9a\u4e49\uff0c\u83b7\u53d6\u5176\u6743\u91cd\u5e76\u751f\u6210\u4e09\u4e2a\u5217\u8868\uff1a boneList \uff1a\u50a8\u5b58\u8282\u70b9\u53ca\u5176\u504f\u79fb\u77e9\u9635\u7684\u5217\u8868\u3002\u7a0d\u540e\u5c06\u4f7f\u7528\u5b83\u6765\u8ba1\u7b97\u8282\u70b9\u53d8\u6362\u3002\u5df2\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Bone \u7684\u65b0\u7c7b\u6765\u50a8\u5b58\u8be5\u4fe1\u606f\u3002\u6b64\u5217\u8868\u5c06\u50a8\u5b58\u6240\u6709\u7f51\u683c\u7684\u9aa8\u9abc\u3002 boneIds \uff1a\u53ea\u50a8\u5b58\u5305\u542b Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u9aa8\u9abc\u6807\u8bc6\u3002\u9aa8\u9abc\u5728\u6e32\u67d3\u65f6\u6839\u636e\u5176\u4f4d\u7f6e\u8fdb\u884c\u6807\u8bc6\uff0c\u6b64\u5217\u8868\u4ec5\u5305\u542b\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u3002 weights \uff1a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u5173\u8054\u9aa8\u9abc\u7684 Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u6743\u91cd\u3002 weights \u548c boneIds \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u7528\u4e8e\u6784\u9020 Mesh \u6570\u636e\u3002 boneList \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5c06\u5728\u7a0d\u540e\u8ba1\u7b97\u52a8\u753b\u6570\u636e\u65f6\u4f7f\u7528\u3002 \u8ba9\u6211\u4eec\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\u3002\u4e00\u65e6\u6211\u4eec\u521b\u5efa\u4e86\u7f51\u683c\uff0c\u8fd8\u5f97\u5230\u4e86\u5e94\u7528\u4e8e\u6839\u8282\u70b9\u7684\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u4e5f\u5c06\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u7684\u53d8\u6362\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u662f\u5728 processNodesHierarchy \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8fd9\u4e2a\u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4ece\u6839\u8282\u70b9\u5f00\u59cb\u904d\u5386\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u6784\u9020\u4e00\u4e2a\u8282\u70b9\u6811\u3002 private static Node processNodesHierarchy(AINode aiNode, Node parentNode) { String nodeName = aiNode.mName().dataString(); Node node = new Node(nodeName, parentNode); int numChildren = aiNode.mNumChildren(); PointerBuffer aiChildren = aiNode.mChildren(); for (int i = 0; i < numChildren; i++) { AINode aiChildNode = AINode.create(aiChildren.get(i)); Node childNode = processNodesHierarchy(aiChildNode, node); node.addChild(childNode); } return node; } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Node \u7c7b\uff0c\u8be5\u7c7b\u5c06\u50a8\u5b58 AINode \u5b9e\u4f8b\u7684\u76f8\u5173\u4fe1\u606f\uff0c\u5e76\u63d0\u4f9b\u4e86\u67e5\u627e\u65b9\u6cd5\u6765\u5b9a\u4f4d\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u4ee5\u4fbf\u6309\u540d\u79f0\u67e5\u627e\u8282\u70b9\u3002\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8be5\u6570\u636e\u8ba1\u7b97 processAnimations \u65b9\u6cd5\u4e2d\u7684\u52a8\u753b\u3002\u8be5\u65b9\u6cd5\u8fd4\u56de Animation \u5b9e\u4f8b\u7684 Map \u3002\u8bf7\u8bb0\u4f4f\uff0c\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u56e0\u6b64\u5b83\u4eec\u6309\u540d\u79f0\u50a8\u5b58\u7d22\u5f15\u3002\u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6784\u5efa\u4e00\u4e2a AnimAgameItem \u5b9e\u4f8b\u3002 processAnimations \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a private static Map<String, Animation> processAnimations(AIScene aiScene, List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { Map<String, Animation> animations = new HashMap<>(); // \u5904\u7406\u6240\u6709\u52a8\u753b int numAnimations = aiScene.mNumAnimations(); PointerBuffer aiAnimations = aiScene.mAnimations(); for (int i = 0; i < numAnimations; i++) { AIAnimation aiAnimation = AIAnimation.create(aiAnimations.get(i)); // \u4e3a\u6bcf\u4e2a\u8282\u70b9\u8ba1\u7b97\u53d8\u6362\u77e9\u9635 int numChanels = aiAnimation.mNumChannels(); PointerBuffer aiChannels = aiAnimation.mChannels(); for (int j = 0; j < numChanels; j++) { AINodeAnim aiNodeAnim = AINodeAnim.create(aiChannels.get(j)); String nodeName = aiNodeAnim.mNodeName().dataString(); Node node = rootNode.findByName(nodeName); buildTransFormationMatrices(aiNodeAnim, node); } List<AnimatedFrame> frames = buildAnimationFrames(boneList, rootNode, rootTransformation); Animation animation = new Animation(aiAnimation.mName().dataString(), frames, aiAnimation.mDuration()); animations.put(animation.getName(), animation); } return animations; } \u5c06\u4e3a\u6bcf\u4e2a\u52a8\u753b\u5904\u7406\u5176\u52a8\u753b\u901a\u9053\uff0c\u6bcf\u4e2a\u901a\u9053\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\uff0c\u8fd9\u4e9b\u53d8\u5316\u5e94\u8be5\u968f\u7740\u65f6\u95f4\u7684\u63a8\u79fb\u5e94\u7528\u4e8e\u4e00\u4e2a\u8282\u70b9\u3002\u4e3a\u6bcf\u4e2a\u8282\u70b9\u5b9a\u4e49\u7684\u53d8\u6362\u5728 buildTransFormationMatrices \u65b9\u6cd5\u4e2d\u5b9a\u4e49\uff0c\u8fd9\u4e9b\u77e9\u9635\u88ab\u6bcf\u4e2a\u8282\u70b9\u50a8\u5b58\u3002\u4e00\u65e6\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u4e2d\u50a8\u5b58\u5b8c\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6784\u5efa\u52a8\u753b\u5e27\u3002 \u8ba9\u6211\u4eec\u5148\u56de\u987e\u4e00\u4e0b buildTransFormationMatrices \u65b9\u6cd5\uff1a private static void buildTransFormationMatrices(AINodeAnim aiNodeAnim, Node node) { int numFrames = aiNodeAnim.mNumPositionKeys(); AIVectorKey.Buffer positionKeys = aiNodeAnim.mPositionKeys(); AIVectorKey.Buffer scalingKeys = aiNodeAnim.mScalingKeys(); AIQuatKey.Buffer rotationKeys = aiNodeAnim.mRotationKeys(); for (int i = 0; i < numFrames; i++) { AIVectorKey aiVecKey = positionKeys.get(i); AIVector3D vec = aiVecKey.mValue(); Matrix4f transfMat = new Matrix4f().translate(vec.x(), vec.y(), vec.z()); AIQuatKey quatKey = rotationKeys.get(i); AIQuaternion aiQuat = quatKey.mValue(); Quaternionf quat = new Quaternionf(aiQuat.x(), aiQuat.y(), aiQuat.z(), aiQuat.w()); transfMat.rotate(quat); if (i < aiNodeAnim.mNumScalingKeys()) { aiVecKey = scalingKeys.get(i); vec = aiVecKey.mValue(); transfMat.scale(vec.x(), vec.y(), vec.z()); } node.addTransformation(transfMat); } } \u5982\u4f60\u6240\u89c1\uff0c AINodeAnim \u5b9e\u4f8b\u5b9a\u4e49\u4e86\u4e00\u7ec4\u5305\u542b\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4fe1\u606f\u7684\u952e\uff0c\u8fd9\u4e9b\u952e\u662f\u6307\u7279\u5b9a\u7684\u65f6\u523b\u3002\u6211\u4eec\u5047\u8bbe\u6570\u636e\u662f\u6309\u65f6\u95f4\u987a\u5e8f\u6392\u5217\u7684\uff0c\u5e76\u6784\u5efa\u4e00\u4e2a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5e27\u7684\u53d8\u6362\u7684\u77e9\u9635\u5217\u8868\u3002\u6700\u540e\u7684\u8ba1\u7b97\u662f\u5728 buildAnimationFrames \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private static List<AnimatedFrame> buildAnimationFrames(List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { int numFrames = rootNode.getAnimationFrames(); List<AnimatedFrame> frameList = new ArrayList<>(); for (int i = 0; i < numFrames; i++) { AnimatedFrame frame = new AnimatedFrame(); frameList.add(frame); int numBones = boneList.size(); for (int j = 0; j < numBones; j++) { Bone bone = boneList.get(j); Node node = rootNode.findByName(bone.getBoneName()); Matrix4f boneMatrix = Node.getParentTransforms(node, i); boneMatrix.mul(bone.getOffsetMatrix()); boneMatrix = new Matrix4f(rootTransformation).mul(boneMatrix); frame.setMatrix(j, boneMatrix); } } return frameList; } \u6b64\u65b9\u6cd5\u8fd4\u56de AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\uff0c\u6bcf\u4e2a AnimatedFrame \u5b9e\u4f8b\u5c06\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u7279\u5b9a\u5e27\u7684\u6bcf\u4e2a\u9aa8\u9abc\u7684\u53d8\u6362\u5217\u8868\u3002\u8fd9\u4e2a\u65b9\u6cd5\u53ea\u662f\u8fed\u4ee3\u50a8\u5b58\u6240\u6709\u9aa8\u9abc\u7684\u5217\u8868\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u9aa8\u9abc\uff1a \u83b7\u53d6\u76f8\u5173\u8054\u7684\u8282\u70b9\u3002 \u901a\u8fc7\u5c06\u76f8\u5173\u8054\u7684 Node \u7684\u53d8\u6362\u4e0e\u5176\u7236\u8282\u70b9\u7684\u6240\u6709\u53d8\u6362\u76f8\u4e58\uff0c\u751f\u6210\u53d8\u6362\u77e9\u9635\uff0c\u76f4\u81f3\u6839\u8282\u70b9\u3002\u8fd9\u662f\u5728 Node.getParentTransforms \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002 \u5b83\u5c06\u8be5\u77e9\u9635\u4e0e\u9aa8\u9abc\u7684\u504f\u501a\u77e9\u9635\u76f8\u4e58\u3002 \u6700\u540e\u7684\u53d8\u6362\u662f\u901a\u8fc7\u5c06\u6839\u8282\u70b9\u7684\u53d8\u6362\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u4e2d\u8ba1\u7b97\u7684\u77e9\u9635\u76f8\u4e58\u6765\u8ba1\u7b97\u7684\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4ed6\u4fee\u6539\u662f\u4e3a\u4e86\u9002\u5e94\u67d0\u4e9b\u7ed3\u6784\u800c\u8fdb\u884c\u7684\u5fae\u5c0f\u4fee\u6539\u3002\u6700\u540e\uff0c\u4f60\u80fd\u591f\u52a0\u8f7d\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u52a8\u753b\uff08\u4f60\u9700\u8981\u6309\u7a7a\u683c\u6539\u53d8\u5e27\uff09\uff1a \u8fd9\u4e2a\u793a\u4f8b\u7684\u590d\u6742\u4e4b\u5904\u5728\u4e8eAssimp\u7ed3\u6784\u7684\u8c03\u6574\uff0c\u4f7f\u5176\u9002\u5e94\u672c\u4e66\u4e2d\u4f7f\u7528\u7684\u5f15\u64ce\uff0c\u5e76\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6570\u636e\u3002\u6b64\u5916\uff0c\u8fd9\u4e9b\u6982\u5ff5\u4e0e\u52a8\u753b\u4e00\u7ae0\u4e2d\u7684\u6982\u5ff5\u7c7b\u4f3c\u3002\u4f60\u53ef\u4ee5\u5c1d\u8bd5\u4fee\u6539\u6e90\u4ee3\u7801\u4ee5\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u52a8\u753b\u3002","title":"\u52a8\u753b"},{"location":"28-deferred-shading/","text":"\u5ef6\u8fdf\u7740\u8272\u6cd5\uff08Deferred Shading\uff09 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u65b9\u5f0f\u79f0\u4e3a\u6b63\u5411\u6e32\u67d3\u6cd5\uff08Forward Rendering\uff09\u3002\u6211\u4eec\u9996\u5148\u6e32\u67d33D\u5bf9\u8c61\uff0c\u5e76\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u7eb9\u7406\u548c\u5149\u7167\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u6709\u4e00\u4e2a\u5177\u6709\u591a\u79cd\u5149\u7167\u548c\u590d\u6742\u6548\u679c\u7684\u590d\u6742\u7247\u5143\u7740\u8272\u5668\u5904\u7406\u9636\u6bb5\uff0c\u8fd9\u79cd\u65b9\u6cd5\u5c31\u4e0d\u662f\u5f88\u9ad8\u6548\u3002\u6b64\u5916\uff0c\u6211\u4eec\u6700\u7ec8\u53ef\u80fd\u4f1a\u5c06\u8fd9\u4e9b\u6548\u679c\u5e94\u7528\u5230\u7a0d\u540e\u53ef\u80fd\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\u800c\u88ab\u4e22\u5f03\u7684\u7247\u5143\u4e0a\uff08\u5c3d\u7ba1\u8fd9\u5e76\u4e0d\u5b8c\u5168\u6b63\u786e\uff0c\u5982\u679c\u6211\u4eec\u542f\u7528 \u65e9\u671f\u7247\u5143\u6d4b\u8bd5 \u7684\u8bdd\uff09\u3002 \u4e3a\u4e86\u7f13\u89e3\u4e0a\u8ff0\u95ee\u9898\uff0c\u6211\u4eec\u53ef\u4ee5\u6539\u53d8\u65b9\u5f0f\uff0c\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u5ef6\u8fdf\u7740\u8272\u6cd5\u7684\u6280\u672f\u6765\u6e32\u67d3\u573a\u666f\u3002\u901a\u8fc7\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u5148\u5c06\u540e\u671f\uff08\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff09\u6240\u9700\u7684\u51e0\u4f55\u4fe1\u606f\u6e32\u67d3\u5230\u7f13\u51b2\u533a\u3002\u5f53\u4f7f\u7528\u50a8\u5b58\u5728\u8fd9\u4e9b\u7f13\u51b2\u533a\u4e2d\u7684\u4fe1\u606f\u65f6\uff0c\u7247\u5143\u7740\u8272\u5668\u6240\u9700\u7684\u590d\u6742\u8fd0\u7b97\u88ab\u63a8\u8fdf\uff08Postpone\uff09\u3001\u5ef6\u8fdf\uff08Defer\uff09\u5230\u4e4b\u540e\u7684\u9636\u6bb5\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u8fdb\u884c\u4e24\u4e2a\u6e32\u67d3\u9636\u6bb5\uff08Pass\uff09\u3002\u7b2c\u4e00\u4e2a\u662f\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff0c\u6211\u4eec\u5c06\u573a\u666f\u6e32\u67d3\u5230\u50a8\u5b58\u4ee5\u4e0b\u6570\u636e\u7684\u7f13\u51b2\u533a\u4e2d\uff1a \u4f4d\u7f6e\uff08\u5728\u672c\u4f8b\u4e2d\uff0c\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff0c\u5c3d\u7ba1\u4f60\u53ef\u4ee5\u770b\u5230\u4f7f\u7528\u4e16\u754c\u5750\u6807\u7684\u5176\u4ed6\u793a\u4f8b\uff09\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6f2b\u53cd\u5c04\u989c\u8272\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6cd5\u7ebf\uff08\u4e5f\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6709\u5411\u5149\u7684\u9634\u5f71\u56fe\uff08\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u4e00\u6b65\u5728\u5176\u4ed6\u5b9e\u73b0\u4e2d\u662f\u5355\u72ec\u5b8c\u6210\u7684\uff09\u3002 \u6240\u6709\u8fd9\u4e9b\u6570\u636e\u90fd\u5b58\u50a8\u5728\u4e00\u4e2a\u79f0\u4e3aG\u7f13\u51b2\u533a\uff08G-Buffer\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002 \u7b2c\u4e8c\u4e2a\u9636\u6bb5\u79f0\u4e3a\u5149\u7167\u5904\u7406\u9636\u6bb5\uff0c\u8be5\u9636\u6bb5\u9700\u8981\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\uff0c\u5e76\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u4fe1\u606f\u4e3a\u6bcf\u4e2a\u7247\u5143\u751f\u6210\u989c\u8272\u4fe1\u606f\u3002\u5f53\u6211\u4eec\u8fdb\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\uff0c\u6df1\u5ea6\u6d4b\u8bd5\u5c06\u5220\u9664\u6240\u6709\u770b\u4e0d\u5230\u7684\u573a\u666f\u6570\u636e\u3002\u56e0\u6b64\uff0c\u8981\u6267\u884c\u7684\u64cd\u4f5c\u6570\u91cf\u4ec5\u9650\u4e8e\u5c06\u5728\u5c4f\u5e55\u4e0a\u663e\u793a\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u95ee\u8fdb\u884c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u80fd\u5426\u63d0\u9ad8\u6027\u80fd\uff0c\u7b54\u6848\u662f\u89c6\u60c5\u51b5\u800c\u5b9a\u3002\u5ef6\u8fdf\u7740\u8272\u6cd5\u901a\u5e38\u5728\u6709\u8bb8\u591a\u4e0d\u540c\u7684\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u5c06\u901a\u8fc7\u51cf\u5c11\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u6267\u884c\u7684\u64cd\u4f5c\u6765\u8865\u507f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u4e3aG\u7f13\u51b2\u533a\u521b\u5efa\u4e00\u4e2a\u65b0\u7c7b\uff0c\u540d\u4e3a GBuffer \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine.graph; import org.lwjgl.system.MemoryStack; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import java.nio.IntBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL20.*; import static org.lwjgl.opengl.GL30.*; public class GBuffer { private static final int TOTAL_TEXTURES = 6; private int gBufferId; private int[] textureIds; private int width; private int height; \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5e38\u91cf\uff0c\u8be5\u5e38\u91cf\u4e3a\u8981\u4f7f\u7528\u7684\u6700\u5927\u7f13\u51b2\u533a\u6570\u5efa\u6a21\u3002\u4e0eG\u7f13\u51b2\u533a\u672c\u8eab\u5173\u8054\u7684ID\uff0c\u4ee5\u53ca\u5355\u4e2a\u7f13\u51b2\u533a\u7684\u6570\u7ec4\uff0c\u5c4f\u5e55\u7684\u5927\u5c0f\u4e5f\u4f1a\u88ab\u50a8\u5b58\u3002 \u8ba9\u6211\u4eec\u770b\u4e00\u4e0b\u6784\u9020\u51fd\u6570\uff1a public GBuffer(Window window) throws Exception { // \u521b\u5efaG\u7f13\u51b2\u533a gBufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBufferId); textureIds = new int[TOTAL_TEXTURES]; glGenTextures(textureIds); this.width = window.getWidth(); this.height = window.getHeight(); // \u4e3a\u4f4d\u7f6e\u3001\u6f2b\u53cd\u5c04\u989c\u8272\u3001\u955c\u9762\u53cd\u5c04\u989c\u8272\u3001\u6cd5\u7ebf\u3001\u9634\u5f71\u56e0\u5b50\u548c\u6df1\u5ea6\u521b\u5efa\u7eb9\u7406 // \u6240\u6709\u5750\u6807\u90fd\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d for(int i=0; i<TOTAL_TEXTURES; i++) { glBindTexture(GL_TEXTURE_2D, textureIds[i]); int attachmentType; switch(i) { case TOTAL_TEXTURES - 1: // \u6df1\u5ea6\u5206\u91cf glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT32F, width, height, 0, GL_DEPTH_COMPONENT, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_DEPTH_ATTACHMENT; break; default: glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, width, height, 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_COLOR_ATTACHMENT0 + i; break; } // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u5c06\u7eb9\u7406\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, attachmentType, GL_TEXTURE_2D, textureIds[i], 0); } try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer intBuff = stack.mallocInt(TOTAL_TEXTURES); int values[] = {GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1, GL_COLOR_ATTACHMENT2, GL_COLOR_ATTACHMENT3, GL_COLOR_ATTACHMENT4, GL_COLOR_ATTACHMENT5}; for(int i = 0; i < values.length; i++) { intBuff.put(values[i]); } intBuff.flip(); glDrawBuffers(intBuff); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u9996\u5148\u6211\u4eec\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8bb0\u4f4f\uff0c\u5e27\u7f13\u51b2\u533a\u53ea\u662f\u4e00\u4e2aOpenGL\u5bf9\u8c61\uff0c\u53ef\u7528\u4e8e\u6e32\u67d3\u64cd\u4f5c\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5230\u5c4f\u5e55\u3002\u7136\u540e\u6211\u4eec\u751f\u6210\u4e00\u7ec4\u7eb9\u7406\uff086\u4e2a\u7eb9\u7406\uff09\uff0c\u8fd9\u4e9b\u7eb9\u7406\u5c06\u4e0e\u5e27\u7f13\u51b2\u533a\u5173\u8054\u3002 \u4e4b\u540e\uff0c\u6211\u4eec\u4f7f\u7528for\u5faa\u73af\u6765\u521d\u59cb\u5316\u7eb9\u7406\uff0c\u6709\u5982\u4e0b\u7c7b\u578b\uff1a \u201c\u5e38\u89c4\u7eb9\u7406\u201d\uff0c\u5c06\u50a8\u5b58\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u548c\u6f2b\u53cd\u5c04\u5206\u91cf\u7b49\u3002 \u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u7eb9\u7406\uff0c\u8fd9\u5c06\u662f\u6700\u540e\u7684\u7eb9\u7406\u3002 \u7eb9\u7406\u521d\u59cb\u5316\u540e\uff0c\u6211\u4eec\u4e3a\u5b83\u4eec\u542f\u7528\u91c7\u6837\u5e76\u5c06\u5b83\u4eec\u7ed1\u5b9a\u5230\u5e27\u7f13\u51b2\u533a\u3002\u6bcf\u4e2a\u7eb9\u7406\u4f7f\u7528\u4ee5 GL_COLOR_ATTACHMENT0 \u4e3a\u5f00\u5934\u7684ID\u8fdb\u884c\u7ed1\u5b9a\u3002\u6bcf\u4e2a\u7eb9\u7406\u90fd\u4ee5\u8be5ID\u9012\u589e\u4e00\u4f4d\uff0c\u56e0\u6b64\u5750\u6807\u4f7f\u7528 GL_COLOR_ATTACHMENT0 \u7ed1\u5b9a\uff0c\u6f2b\u53cd\u5c04\u5206\u91cf\u4f7f\u7528 GL_COLOR_ATTACHMENT1 \uff08\u5373 GL_COLOR_ATTACHMENT0 + 1 \uff09\u9644\u52a0\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u5728\u521b\u5efa\u5b8c\u6240\u6709\u7eb9\u7406\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ba9\u7247\u5143\u7740\u8272\u5668\u4f7f\u7528\u5b83\u4eec\u8fdb\u884c\u6e32\u67d3\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glDrawBuffers \u5b8c\u6210\u7684\u3002\u6211\u4eec\u53ea\u4f20\u9012\u5e26\u6709\u6240\u7528\u989c\u8272\u7ed1\u5b9a\u7684ID\u7684\u6570\u7ec4\uff08 GL_COLOR_ ATTACHMENT0 \u5230 GL_COLOR_ATTACHMENT5 \uff09\u3002 \u7c7b\u7684\u5176\u4ed6\u90e8\u5206\u53ea\u662fgetter\u65b9\u6cd5\u548c cleanup \u65b9\u6cd5\u3002 public int getWidth() { return width; } public int getHeight() { return height; } public int getGBufferId() { return gBufferId; } public int[] getTextureIds() { return textureIds; } public int getPositionTexture() { return textureIds[0]; } public int getDepthTexture() { return textureIds[TOTAL_TEXTURES-1]; } public void cleanUp() { glDeleteFramebuffers(gBufferId); if (textureIds != null) { for (int i=0; i<TOTAL_TEXTURES; i++) { glDeleteTextures(textureIds[i]); } } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SceneBuffer \u7684\u65b0\u7c7b\uff0c\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\uff0c\u5c06\u5728\u6267\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u4e0d\u76f4\u63a5\u6e32\u67d3\u5230\u5c4f\u5e55\uff0c\u800c\u662f\u6e32\u67d3\u5230\u8fd9\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8fd9\u6837\u505a\uff0c\u6211\u4eec\u53ef\u4ee5\u5e94\u7528\u5176\u4ed6\u6548\u679c\uff08\u5982\u96fe\u3001\u5929\u7a7a\u76d2\u7b49\uff09\u3002\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class SceneBuffer { private int bufferId; private int textureId; public SceneBuffer(Window window) throws Exception { // \u521b\u5efa\u7f13\u51b2\u533a bufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, bufferId); // \u521b\u5efa\u7eb9\u7406 int[] textureIds = new int[1]; glGenTextures(textureIds); textureId = textureIds[0]; glBindTexture(GL_TEXTURE_2D, textureId); glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, window.getWidth(), window.getHeight(), 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u9644\u52a0\u7eb9\u7406\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, textureId, 0); // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public int getBufferId() { return bufferId; } public int getTextureId() { return textureId; } public void cleanup() { glDeleteFramebuffers(bufferId); glDeleteTextures(textureId); } } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u7c7b\u4f3c\u4e8e GBuffer \u7c7b\uff0c\u4f46\u8fd9\u91cc\u53ea\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u6765\u50a8\u5b58\u751f\u6210\u7684\u989c\u8272\u3002\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u8fd9\u4e9b\u65b0\u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528\u5b83\u4eec\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u518d\u4f7f\u7528\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u6b63\u5411\u6e32\u67d3\u7740\u8272\u5668\uff08\u540d\u4e3a scene_vertex.vs \u548c scene_fragment.fs \uff09\u3002 \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u521b\u5efa\u4e86\u4e00\u4e2a GBuffer \u5b9e\u73b0\uff0c\u6211\u4eec\u5206\u522b\u4e3a\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupGeometryShader \u65b9\u6cd5\uff09\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupDirLightShader \u548c setupPointLightShader \u65b9\u6cd5\uff09\u521d\u59cb\u5316\u4e86\u53e6\u4e00\u7ec4\u7740\u8272\u5668\u3002\u4f60\u6362\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a sceneBuffer \u7684 SceneBuffer \u7c7b\u7684\u5b9e\u4f8b\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u5149\u7167\u65f6\u4f7f\u7528\u3002\u540d\u4e3a bufferPassModelMatrix \u7684\u5b9e\u7528\u77e9\u9635\u4e5f\u88ab\u5b9e\u4f8b\u5316\uff08\u5728\u6267\u884c\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u65f6\u5c06\u4f7f\u7528\u5b83\uff09\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5728 init \u65b9\u6cd5\u7684\u672b\u5c3e\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Mesh \uff0c\u5b83\u5c06\u7528\u4e8e\u5149\u7167\u5904\u7406\u9636\u6bb5\u3002\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u8be6\u60c5\u5c06\u5728\u4e4b\u540e\u4ecb\u7ecd\u3002 public void init(Window window) throws Exception { shadowRenderer.init(window); gBuffer = new GBuffer(window); sceneBuffer = new SceneBuffer(window); setupSkyBoxShader(); setupParticlesShader(); setupGeometryShader(); setupDirLightShader(); setupPointLightShader(); setupFogShader(); bufferPassModelMatrix = new Matrix4f(); bufferPassMesh = StaticMeshesLoader.load(\"src/main/resources/models/buffer_pass_mess.obj\", \"src/main/resources/models\")[0]; } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\u4f7f\u7528\u7684\u7740\u8272\u5668\u5b9a\u4e49\u4e0e\u901a\u5e38\u4e00\u81f4\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\uff0c\u8ba9\u6211\u4eec\u5173\u6ce8\u5b83\u4eec\u7684\u5185\u5bb9\u3002\u6211\u4eec\u5c06\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\uff0c\u63a5\u4e0b\u6765\u662f\u9876\u70b9\u7740\u8272\u5668\u4ee3\u7801\uff08 gbuffer_vertex.vs \uff09\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; const int NUM_CASCADES = 3; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; layout (location=5) in mat4 modelInstancedMatrix; layout (location=9) in vec2 texOffset; layout (location=10) in float selectedInstanced; uniform int isInstanced; uniform mat4 viewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelNonInstancedMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 lightViewMatrix[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int numCols; uniform int numRows; uniform float selectedNonInstanced; out vec2 vs_textcoord; out vec3 vs_normal; out vec4 vs_mvVertexPos; out vec4 vs_mlightviewVertexPos[NUM_CASCADES]; out mat4 vs_modelMatrix; out float vs_selected; void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelMatrix; if ( isInstanced > 0 ) { vs_selected = selectedInstanced; modelMatrix = modelInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } else { vs_selected = selectedNonInstanced; modelMatrix = modelNonInstancedMatrix; int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } } mat4 modelViewMatrix = viewMatrix * modelMatrix; vs_mvVertexPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * vs_mvVertexPos; // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); vs_textcoord = vec2(x, y); vs_normal = normalize(modelViewMatrix * initNormal).xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { vs_mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * initPos; } vs_modelMatrix = modelMatrix; } \u6b64\u7740\u8272\u5668\u4e0e\u4e0a\u4e00\u7ae0\u4e2d\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\uff0c\u8f93\u51fa\u53d8\u91cf\u7684\u540d\u79f0\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u4f46\u672c\u8d28\u4e0a\u662f\u76f8\u540c\u7684\u7740\u8272\u5668\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u5e94\u8be5\u662f\u51e0\u8fd1\u4e00\u81f4\u7684\uff0c\u6211\u4eec\u6e32\u67d3\u9876\u70b9\u7684\u65b9\u5f0f\u4e0d\u5e94\u8be5\u6539\u53d8\uff0c\u4e3b\u8981\u7684\u66f4\u6539\u662f\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u5b83\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff08 gbuffer_fragment.fs \uff09\uff1a #version 330 const int NUM_CASCADES = 3; in vec2 vs_textcoord; in vec3 vs_normal; in vec4 vs_mvVertexPos; in vec4 vs_mlightviewVertexPos[NUM_CASCADES]; in mat4 vs_modelMatrix; in float vs_selected; layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; uniform mat4 viewMatrix; struct Material { vec4 diffuse; vec4 specular; int hasTexture; int hasNormalMap; float reflectance; }; uniform sampler2D texture_sampler; uniform sampler2D normalMap; uniform Material material; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; uniform float cascadeFarPlanes[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int renderShadow; vec4 diffuseC; vec4 speculrC; void getColour(Material material, vec2 textCoord) { if (material.hasTexture == 1) { diffuseC = texture(texture_sampler, textCoord); speculrC = diffuseC; } else { diffuseC = material.diffuse; speculrC = material.specular; } } vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(viewMatrix * modelMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } float calcShadow(vec4 position, int idx) { if ( renderShadow == 0 ) { return 1.0; } vec3 projCoords = position.xyz; // Transform from screen coordinates to texture coordinates projCoords = projCoords * 0.5 + 0.5; float bias = 0.005; float shadowFactor = 0.0; vec2 inc; if (idx == 0) { inc = 1.0 / textureSize(shadowMap_0, 0); } else if (idx == 1) { inc = 1.0 / textureSize(shadowMap_1, 0); } else { inc = 1.0 / textureSize(shadowMap_2, 0); } for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth; if (idx == 0) { textDepth = texture(shadowMap_0, projCoords.xy + vec2(row, col) * inc).r; } else if (idx == 1) { textDepth = texture(shadowMap_1, projCoords.xy + vec2(row, col) * inc).r; } else { textDepth = texture(shadowMap_2, projCoords.xy + vec2(row, col) * inc).r; } shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; if(projCoords.z > 1.0) { shadowFactor = 1.0; } return 1 - shadowFactor; } void main() { getColour(material, vs_textcoord); fs_worldpos = vs_mvVertexPos.xyz; fs_diffuse = diffuseC.xyz; fs_specular = speculrC.xyz; fs_normal = normalize(calcNormal(material, vs_normal, vs_textcoord, vs_modelMatrix)); int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(vs_mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } fs_shadow = vec2(calcShadow(vs_mlightviewVertexPos[idx], idx), material.reflectance); if ( vs_selected > 0 ) { fs_diffuse = vec3(fs_diffuse.x, fs_diffuse.y, 1); } } \u6700\u5173\u952e\u7684\u884c\u662f\uff1a layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; \u8fd9\u5c31\u662f\u6211\u4eec\u8981\u5f15\u7528\u8be5\u7247\u5143\u7740\u8272\u5668\u5c06\u5199\u5165\u7684\u7eb9\u7406\u7684\u5730\u65b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u662f\u8f6c\u50a8\u4f4d\u7f6e\uff08\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3001\u6f2b\u53cd\u5c04\u989c\u8272\uff08\u53ef\u4ee5\u662f\u6750\u8d28\u76f8\u5173\u7684\u7eb9\u7406\u7684\u989c\u8272\u5206\u91cf\uff09\u3001\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3001\u6cd5\u7ebf\u548c\u9634\u5f71\u56fe\u7684\u6df1\u5ea6\u503c\u3002 \u65c1\u6ce8\uff1a\u6211\u4eec\u5df2\u7ecf\u7b80\u5316\u4e86 Material \u7c7b\u7684\u5b9a\u4e49\uff0c\u5220\u9664\u4e86\u73af\u5883\u989c\u8272\u5206\u91cf\u3002 \u56de\u5230 Renderer \u7c7b\uff0c render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void render(Window window, Camera camera, Scene scene, boolean sceneChanged) { clear(); if (window.getOptions().frustumCulling) { frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); } // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe if (scene.isRenderShadows() && sceneChanged) { shadowRenderer.render(window, scene, camera, transformation, this); } glViewport(0, 0, window.getWidth(), window.getHeight()); // \u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21 window.updateProjectionMatrix(); renderGeometry(window, camera, scene); initLightRendering(); renderPointLights(window, camera, scene); renderDirectionalLight(window, camera, scene); endLightRendering(); renderFog(window, camera, scene); renderSkyBox(window, camera, scene); renderParticles(window, camera, scene); } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u662f\u5728 renderGeometry \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4e0d\u518d\u6709 renderScene \uff09\u3002\u5149\u7167\u5904\u7406\u9636\u6bb5\u5206\u51e0\u4e2a\u6b65\u9aa4\u5b8c\u6210\uff0c\u9996\u5148\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u7f13\u51b2\u533a\u548c\u5176\u4ed6\u53c2\u6570\uff08\u5728 initLightRendering \u4e2d\uff09\uff0c\u7136\u540e\u6e32\u67d3\u70b9\u5149\u6e90\uff08\u5728 renderPointLights \u4e2d\uff09\u548c\u5e73\u884c\u5149\uff08\u5728 renderDirectionalLight \u4e2d\uff09\uff0c\u6700\u540e\u6062\u590d\u72b6\u6001\uff08\u5728 endLightRendering \u4e2d\uff09\u3002 \u8ba9\u6211\u4eec\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\u3002 renderGeometry \u65b9\u6cd5\u51e0\u4e4e\u7b49\u540c\u4e8e\u5728\u524d\u51e0\u7ae0\u4e2d\u4f7f\u7528\u7684 renderScene \u65b9\u6cd5\uff1a private void renderGeometry(Window window, Camera camera, Scene scene) { // \u6e32\u67d3G\u7f13\u51b2\u533a\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBuffer.getGBufferId()); clear(); glDisable(GL_BLEND); gBufferShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); gBufferShaderProgram.setUniform(\"viewMatrix\", viewMatrix); gBufferShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); gBufferShaderProgram.setUniform(\"texture_sampler\", 0); gBufferShaderProgram.setUniform(\"normalMap\", 1); List<ShadowCascade> shadowCascades = shadowRenderer.getShadowCascades(); for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); gBufferShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix(), i); gBufferShaderProgram.setUniform(\"cascadeFarPlanes\", ShadowRenderer.CASCADE_SPLITS[i], i); gBufferShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix(), i); } shadowRenderer.bindTextures(GL_TEXTURE2); int start = 2; for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { gBufferShaderProgram.setUniform(\"shadowMap_\" + i, start + i); } gBufferShaderProgram.setUniform(\"renderShadow\", scene.isRenderShadows() ? 1 : 0); renderNonInstancedMeshes(scene); renderInstancedMeshes(scene, viewMatrix); gBufferShaderProgram.unbind(); glEnable(GL_BLEND); } \u4ec5\u6709\u7684\u533a\u522b\u662f\uff1a \u6211\u4eec\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a\u800c\u4e0d\u662f\u5c4f\u5e55\u3002 \u7981\u7528\u6df7\u5408\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u60f3\u4f7f\u7528\u6700\u63a5\u8fd1\u6444\u50cf\u673a\u7684\u503c\uff08\u6700\u5c0f\u6df1\u5ea6\u503c\uff09\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6df7\u5408\u3002 \u5982\u679c\u4f7f\u7528OpenGL\u8c03\u8bd5\u5668\uff08\u5982RenderDoc\uff09\u8c03\u8bd5\u793a\u4f8b\uff0c\u5219\u53ef\u4ee5\u770b\u5230\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u671f\u95f4\u751f\u6210\u7684\u7eb9\u7406\u3002\u4f4d\u7f6e\u7eb9\u7406\u5c06\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6f2b\u53cd\u5c04\u5206\u91cf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6cd5\u7ebf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u73b0\u5728\u8f6e\u5230\u5149\u7167\u5904\u7406\u9636\u6bb5\u4e86\u3002\u6211\u4eec\u9996\u5148\u9700\u8981\u5728\u6e32\u67d3\u4e4b\u524d\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u8fd9\u662f\u5728 initLightRendering \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void initLightRendering() { // \u7ed1\u5b9a\u573a\u666f\u7f13\u51b2\u533a glBindFramebuffer(GL_FRAMEBUFFER, sceneBuffer.getBufferId()); // \u6e05\u7406G\u7f13\u51b2\u533a clear(); // \u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4ee5\u5141\u8bb8\u7ed8\u5236\u5177\u6709\u76f8\u540c\u6df1\u5ea6\u7684\u591a\u4e2a\u56fe\u5c42 glDisable(GL_DEPTH_TEST); glEnable(GL_BLEND); glBlendEquation(GL_FUNC_ADD); glBlendFunc(GL_ONE, GL_ONE); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u4ee5\u4fbf\u8bfb\u53d6 glBindFramebuffer(GL_READ_FRAMEBUFFER, gBuffer.getGBufferId()); } \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\uff0c\u6240\u4ee5\u9996\u5148\u9700\u8981\u7ed1\u5b9a\u5230\u7eb9\u7406\u4e0a\uff0c\u8be5\u7eb9\u7406\u5c06\u4fdd\u5b58\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u7ed3\u679c\u3002\u7136\u540e\u6e05\u9664\u7f13\u51b2\u533a\u5e76\u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u3002\u56e0\u4e3a\u5df2\u7ecf\u5728\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u8fdb\u884c\u4e86\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u8fd9\u5c31\u4e0d\u518d\u9700\u8981\u4e86\u3002\u53e6\u4e00\u91cd\u8981\u6b65\u9aa4\u662f\u542f\u7528\u6df7\u5408\u3002\u6700\u540e\u4e00\u4e2a\u64cd\u4f5c\u662f\u542f\u7528G\u7f13\u51b2\u533a\u8fdb\u884c\u8bfb\u53d6\uff0c\u5b83\u5c06\u5728\u5149\u7167\u5904\u7406\u9636\u6bb5\u671f\u95f4\u4f7f\u7528\u3002 \u5728\u5206\u6790\u4e0d\u540c\u5149\u7167\u7684\u6e32\u67d3\u65b9\u6cd5\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7a0d\u5fae\u8003\u8651\u4e00\u4e0b\u5982\u4f55\u6e32\u67d3\u5149\u7167\u3002\u6211\u4eec\u9700\u8981\u4f7f\u7528G\u7f13\u51b2\u533a\u7684\u5185\u5bb9\uff0c\u4f46\u4e3a\u4e86\u4f7f\u7528\u5b83\u4eec\uff0c\u9700\u8981\u5148\u6e32\u67d3\u4e00\u4e9b\u4e1c\u897f\u3002\u4f46\u662f\uff0c\u6211\u4eec\u5df2\u7ecf\u7ed8\u5236\u4e86\u573a\u666f\uff0c\u73b0\u5728\u8981\u6e32\u67d3\u4ec0\u4e48\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e32\u67d3\u4e00\u4e2a\u5145\u6ee1\u4e86\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u5bf9\u4e8e\u8be5\u77e9\u5f62\u7684\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5e76\u751f\u6210\u6b63\u786e\u7684\u8f93\u51fa\u989c\u8272\u3002\u4f60\u8fd8\u8bb0\u5f97\u6211\u4eec\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u52a0\u8f7d\u7684 Mesh \u5417\uff1f\u5b83\u88ab\u547d\u540d\u4e3a bufferPassMesh \uff0c\u5b83\u53ea\u50a8\u5b58\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002 \u90a3\u4e48\uff0c\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u9876\u70b9\u7740\u8272\u5668\u770b\u8d77\u6765\u662f\u600e\u6837\u7684\uff1f #version 330 layout (location=0) in vec3 position; uniform mat4 projectionMatrix; uniform mat4 modelMatrix; void main() { gl_Position = projectionMatrix * modelMatrix * vec4(position, 1.0); } \u4e0a\u8ff0\u4ee3\u7801\u662f\u6e32\u67d3\u70b9\u5149\u6e90\u548c\u5e73\u884c\u5149\u65f6\u4f7f\u7528\u7684\u9876\u70b9\u7740\u8272\u5668\uff08 light_vertex.vs \uff09\u3002\u5b83\u53ea\u662f\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u6765\u8f6c\u50a8\u9876\u70b9\u3002\u4e0d\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u8fd9\u91cc\u4e0d\u9700\u8981\u6444\u50cf\u673a\u3002 \u70b9\u5149\u6e90\u7684\u7247\u5143\u7740\u8272\u5668\uff08 point_light_fragment.fs \uff09\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // Light position is assumed to be in view coordinates vec3 position; float intensity; Attenuation att; }; uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; uniform vec2 screenSize; uniform float specularPower; uniform PointLight pointLight; vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } vec4 calcLightColour(vec4 diffuseC, vec4 speculrC, float reflectance, vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 1); vec4 specColour = vec4(0, 0, 0, 1); // Diffuse Light float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // Specular Light vec3 camera_direction = normalize(-position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } vec4 calcPointLight(vec4 diffuseC, vec4 speculrC, float reflectance, PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(diffuseC, speculrC, reflectance, light.colour, light.intensity, position, to_light_dir, normal); // Apply Attenuation float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } void main() { vec2 textCoord = getTextCoord(); float depth = texture(depthText, textCoord).r; vec3 worldPos = texture(positionsText, textCoord).xyz; vec4 diffuseC = texture(diffuseText, textCoord); vec4 speculrC = texture(specularText, textCoord); vec3 normal = texture(normalsText, textCoord).xyz; float shadowFactor = texture(shadowText, textCoord).r; float reflectance = texture(shadowText, textCoord).g; fragColor = calcPointLight(diffuseC, speculrC, reflectance, pointLight, worldPos.xyz, normal.xyz) * shadowFactor; } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u5305\u542b\u4f60\u5e94\u8be5\u719f\u6089\u7684\u51fd\u6570\uff0c\u5b83\u4eec\u5728\u524d\u51e0\u7ae0\u7684\u573a\u666f\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8fc7\u3002\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u91cd\u8981\u4e8b\u9879\u5982\u4e0b\uff1a uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; \u8fd9\u4e9bUniform\u5efa\u6a21\u6784\u6210\u4e86G\u7f13\u51b2\u533a\u7684\u4e0d\u540c\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u8bbf\u95ee\u6570\u636e\u3002\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u95ee\uff0c\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u7247\u5143\u65f6\uff0c\u5982\u4f55\u77e5\u9053\u8981\u4ece\u8fd9\u4e9b\u7eb9\u7406\u4e2d\u83b7\u53d6\u54ea\u4e2a\u50cf\u7d20\uff1f\u7b54\u6848\u662f\u4f7f\u7528 gl_FragCoord \u8f93\u5165\u53d8\u91cf\uff0c\u6b64\u53d8\u91cf\u50a8\u5b58\u5f53\u524d\u7247\u5143\u4e0e\u7a97\u53e3\u7684\u76f8\u5bf9\u5750\u6807\u3002\u56e0\u4e3a\u8981\u4ece\u5750\u6807\u7cfb\u8f6c\u6362\u4e3a\u7eb9\u7406\uff0c\u6211\u4eec\u4f7f\u7528\u4ee5\u4e0b\u51fd\u6570\uff1a vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } \u5e73\u884c\u5149\u7684\u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u76f8\u4f3c\uff0c\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u3002\u73b0\u5728\u5df2\u7ecf\u6709\u4e86\u7740\u8272\u5668\uff0c\u6211\u4eec\u56de\u5230 Renderer \u7c7b\u3002\u5bf9\u4e8e\u70b9\u5149\u6e90\uff0c\u6211\u4eec\u5c06\u505a\u5c3d\u53ef\u80fd\u591a\u7684\u5149\u7167\u5904\u7406\uff0c\u6211\u4eec\u53ea\u662f\u7ed1\u5b9a\u7528\u4e8e\u6b64\u7c7b\u578b\u5149\u6e90\u7684\u7740\u8272\u5668\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u7ed8\u5236\u77e9\u5f62\u3002 private void renderPointLights(Window window, Camera camera, Scene scene) { pointLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); pointLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); pointLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 pointLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } pointLightShaderProgram.setUniform(\"positionsText\", 0); pointLightShaderProgram.setUniform(\"diffuseText\", 1); pointLightShaderProgram.setUniform(\"specularText\", 2); pointLightShaderProgram.setUniform(\"normalsText\", 3); pointLightShaderProgram.setUniform(\"shadowText\", 4); pointLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); SceneLight sceneLight = scene.getSceneLight(); PointLight[] pointLights = sceneLight.getPointLightList(); int numPointLights = pointLights != null ? pointLights.length : 0; for(int i=0; i<numPointLights; i++) { // \u83b7\u53d6\u70b9\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLights[i]); Vector3f lightPos = currPointLight.getPosition(); tmpVec.set(lightPos, 1); tmpVec.mul(viewMatrix); lightPos.x = tmpVec.x; lightPos.y = tmpVec.y; lightPos.z = tmpVec.z; pointLightShaderProgram.setUniform(\"pointLight\", currPointLight); bufferPassMesh.render(); } pointLightShaderProgram.unbind(); } \u5bf9\u4e8e\u5e73\u884c\u5149\u6765\u8bf4\uff0c\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u8fdb\u884c\u4e00\u6b21\u5904\u7406\uff1a private void renderDirectionalLight(Window window, Camera camera, Scene scene) { dirLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); dirLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); dirLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 dirLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } dirLightShaderProgram.setUniform(\"positionsText\", 0); dirLightShaderProgram.setUniform(\"diffuseText\", 1); dirLightShaderProgram.setUniform(\"specularText\", 2); dirLightShaderProgram.setUniform(\"normalsText\", 3); dirLightShaderProgram.setUniform(\"shadowText\", 4); dirLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); // \u73af\u5883\u5149\u7167 SceneLight sceneLight = scene.getSceneLight(); dirLightShaderProgram.setUniform(\"ambientLight\", sceneLight.getAmbientLight()); // \u5e73\u884c\u5149 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(sceneLight.getDirectionalLight()); tmpVec.set(currDirLight.getDirection(), 0); tmpVec.mul(viewMatrix); currDirLight.setDirection(new Vector3f(tmpVec.x, tmpVec.y, tmpVec.z)); dirLightShaderProgram.setUniform(\"directionalLight\", currDirLight); bufferPassMesh.render(); dirLightShaderProgram.unbind(); } endLightRendering \u53ea\u7b80\u5355\u5730\u6062\u590d\u72b6\u6001\u3002 private void endLightRendering() { // \u7ed1\u5b9a\u5c4f\u5e55\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_FRAMEBUFFER, 0); glEnable(GL_DEPTH_TEST); glDisable(GL_BLEND); } \u5982\u679c\u8fd0\u884c\u793a\u4f8b\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u672c\u7ae0\u6bd4\u9884\u671f\u65f6\u95f4\u957f\uff0c\u4f46\u6709\u51e0\u4e2a\u8981\u70b9\u9700\u8981\u6f84\u6e05\uff1a \u4e3a\u4e86\u7b80\u5316\u672c\u7ae0\uff0c\u5df2\u7ecf\u5220\u9664\u4e86\u805a\u5149\u6e90\u7684\u76f8\u5173\u5185\u5bb9\u3002 \u5ef6\u8fdf\u7740\u8272\u6cd5\u4e2d\u4f7f\u7528\u70b9\u5149\u6e90\u7684\u4e00\u79cd\u5e38\u89c1\u6280\u672f\u662f\u8ba1\u7b97\u53d7\u8be5\u5149\u6e90\u5f71\u54cd\u7684\u573a\u666f\u533a\u57df\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\u8f83\u5c0f\u7684\u56db\u8fb9\u5f62\uff0c\u5706\u5f62\u7b49\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5145\u6ee1\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u8bf7\u7262\u8bb0\uff0c\u6700\u597d\u662f\u597d\u7684\u654c\u4eba\uff0c\u8fdb\u884c\u590d\u6742\u7684\u5fae\u79ef\u5206\u4ee5\u786e\u5b9a\u6240\u9700\u7684\u6700\u5c0f\u5f62\u72b6\u53ef\u80fd\u6bd4\u4f7f\u7528\u5176\u4ed6\u7c97\u7cd9\u65b9\u6cd5\u6162\u3002 \u5982\u679c\u6ca1\u6709\u8bb8\u591a\u5149\u6e90\uff0c\u6b64\u65b9\u6cd5\u6bd4\u6b63\u5411\u7740\u8272\u6cd5\u6162\u3002 \u6700\u540e\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c\u5982\u679c\u4f60\u60f3\u4e86\u89e3\u8fd9\u4e9b\u6280\u672f\u5728\u73b0\u5b9e\u4e2d\u7684\u5e94\u7528\uff0c\u53ef\u4ee5\u67e5\u770b \u8fd9\u4e2a\u6781\u597d\u7684\u8bf4\u660e \uff0c\u4e86\u89e3GTA V\u7684\u5e27\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002","title":"\u5ef6\u8fdf\u7740\u8272\u6cd5"},{"location":"28-deferred-shading/#deferred-shading","text":"\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u65b9\u5f0f\u79f0\u4e3a\u6b63\u5411\u6e32\u67d3\u6cd5\uff08Forward Rendering\uff09\u3002\u6211\u4eec\u9996\u5148\u6e32\u67d33D\u5bf9\u8c61\uff0c\u5e76\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u7eb9\u7406\u548c\u5149\u7167\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u6709\u4e00\u4e2a\u5177\u6709\u591a\u79cd\u5149\u7167\u548c\u590d\u6742\u6548\u679c\u7684\u590d\u6742\u7247\u5143\u7740\u8272\u5668\u5904\u7406\u9636\u6bb5\uff0c\u8fd9\u79cd\u65b9\u6cd5\u5c31\u4e0d\u662f\u5f88\u9ad8\u6548\u3002\u6b64\u5916\uff0c\u6211\u4eec\u6700\u7ec8\u53ef\u80fd\u4f1a\u5c06\u8fd9\u4e9b\u6548\u679c\u5e94\u7528\u5230\u7a0d\u540e\u53ef\u80fd\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\u800c\u88ab\u4e22\u5f03\u7684\u7247\u5143\u4e0a\uff08\u5c3d\u7ba1\u8fd9\u5e76\u4e0d\u5b8c\u5168\u6b63\u786e\uff0c\u5982\u679c\u6211\u4eec\u542f\u7528 \u65e9\u671f\u7247\u5143\u6d4b\u8bd5 \u7684\u8bdd\uff09\u3002 \u4e3a\u4e86\u7f13\u89e3\u4e0a\u8ff0\u95ee\u9898\uff0c\u6211\u4eec\u53ef\u4ee5\u6539\u53d8\u65b9\u5f0f\uff0c\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u5ef6\u8fdf\u7740\u8272\u6cd5\u7684\u6280\u672f\u6765\u6e32\u67d3\u573a\u666f\u3002\u901a\u8fc7\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u5148\u5c06\u540e\u671f\uff08\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff09\u6240\u9700\u7684\u51e0\u4f55\u4fe1\u606f\u6e32\u67d3\u5230\u7f13\u51b2\u533a\u3002\u5f53\u4f7f\u7528\u50a8\u5b58\u5728\u8fd9\u4e9b\u7f13\u51b2\u533a\u4e2d\u7684\u4fe1\u606f\u65f6\uff0c\u7247\u5143\u7740\u8272\u5668\u6240\u9700\u7684\u590d\u6742\u8fd0\u7b97\u88ab\u63a8\u8fdf\uff08Postpone\uff09\u3001\u5ef6\u8fdf\uff08Defer\uff09\u5230\u4e4b\u540e\u7684\u9636\u6bb5\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u8fdb\u884c\u4e24\u4e2a\u6e32\u67d3\u9636\u6bb5\uff08Pass\uff09\u3002\u7b2c\u4e00\u4e2a\u662f\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff0c\u6211\u4eec\u5c06\u573a\u666f\u6e32\u67d3\u5230\u50a8\u5b58\u4ee5\u4e0b\u6570\u636e\u7684\u7f13\u51b2\u533a\u4e2d\uff1a \u4f4d\u7f6e\uff08\u5728\u672c\u4f8b\u4e2d\uff0c\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff0c\u5c3d\u7ba1\u4f60\u53ef\u4ee5\u770b\u5230\u4f7f\u7528\u4e16\u754c\u5750\u6807\u7684\u5176\u4ed6\u793a\u4f8b\uff09\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6f2b\u53cd\u5c04\u989c\u8272\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6cd5\u7ebf\uff08\u4e5f\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6709\u5411\u5149\u7684\u9634\u5f71\u56fe\uff08\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u4e00\u6b65\u5728\u5176\u4ed6\u5b9e\u73b0\u4e2d\u662f\u5355\u72ec\u5b8c\u6210\u7684\uff09\u3002 \u6240\u6709\u8fd9\u4e9b\u6570\u636e\u90fd\u5b58\u50a8\u5728\u4e00\u4e2a\u79f0\u4e3aG\u7f13\u51b2\u533a\uff08G-Buffer\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002 \u7b2c\u4e8c\u4e2a\u9636\u6bb5\u79f0\u4e3a\u5149\u7167\u5904\u7406\u9636\u6bb5\uff0c\u8be5\u9636\u6bb5\u9700\u8981\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\uff0c\u5e76\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u4fe1\u606f\u4e3a\u6bcf\u4e2a\u7247\u5143\u751f\u6210\u989c\u8272\u4fe1\u606f\u3002\u5f53\u6211\u4eec\u8fdb\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\uff0c\u6df1\u5ea6\u6d4b\u8bd5\u5c06\u5220\u9664\u6240\u6709\u770b\u4e0d\u5230\u7684\u573a\u666f\u6570\u636e\u3002\u56e0\u6b64\uff0c\u8981\u6267\u884c\u7684\u64cd\u4f5c\u6570\u91cf\u4ec5\u9650\u4e8e\u5c06\u5728\u5c4f\u5e55\u4e0a\u663e\u793a\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u95ee\u8fdb\u884c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u80fd\u5426\u63d0\u9ad8\u6027\u80fd\uff0c\u7b54\u6848\u662f\u89c6\u60c5\u51b5\u800c\u5b9a\u3002\u5ef6\u8fdf\u7740\u8272\u6cd5\u901a\u5e38\u5728\u6709\u8bb8\u591a\u4e0d\u540c\u7684\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u5c06\u901a\u8fc7\u51cf\u5c11\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u6267\u884c\u7684\u64cd\u4f5c\u6765\u8865\u507f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u4e3aG\u7f13\u51b2\u533a\u521b\u5efa\u4e00\u4e2a\u65b0\u7c7b\uff0c\u540d\u4e3a GBuffer \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine.graph; import org.lwjgl.system.MemoryStack; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import java.nio.IntBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL20.*; import static org.lwjgl.opengl.GL30.*; public class GBuffer { private static final int TOTAL_TEXTURES = 6; private int gBufferId; private int[] textureIds; private int width; private int height; \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5e38\u91cf\uff0c\u8be5\u5e38\u91cf\u4e3a\u8981\u4f7f\u7528\u7684\u6700\u5927\u7f13\u51b2\u533a\u6570\u5efa\u6a21\u3002\u4e0eG\u7f13\u51b2\u533a\u672c\u8eab\u5173\u8054\u7684ID\uff0c\u4ee5\u53ca\u5355\u4e2a\u7f13\u51b2\u533a\u7684\u6570\u7ec4\uff0c\u5c4f\u5e55\u7684\u5927\u5c0f\u4e5f\u4f1a\u88ab\u50a8\u5b58\u3002 \u8ba9\u6211\u4eec\u770b\u4e00\u4e0b\u6784\u9020\u51fd\u6570\uff1a public GBuffer(Window window) throws Exception { // \u521b\u5efaG\u7f13\u51b2\u533a gBufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBufferId); textureIds = new int[TOTAL_TEXTURES]; glGenTextures(textureIds); this.width = window.getWidth(); this.height = window.getHeight(); // \u4e3a\u4f4d\u7f6e\u3001\u6f2b\u53cd\u5c04\u989c\u8272\u3001\u955c\u9762\u53cd\u5c04\u989c\u8272\u3001\u6cd5\u7ebf\u3001\u9634\u5f71\u56e0\u5b50\u548c\u6df1\u5ea6\u521b\u5efa\u7eb9\u7406 // \u6240\u6709\u5750\u6807\u90fd\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d for(int i=0; i<TOTAL_TEXTURES; i++) { glBindTexture(GL_TEXTURE_2D, textureIds[i]); int attachmentType; switch(i) { case TOTAL_TEXTURES - 1: // \u6df1\u5ea6\u5206\u91cf glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT32F, width, height, 0, GL_DEPTH_COMPONENT, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_DEPTH_ATTACHMENT; break; default: glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, width, height, 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_COLOR_ATTACHMENT0 + i; break; } // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u5c06\u7eb9\u7406\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, attachmentType, GL_TEXTURE_2D, textureIds[i], 0); } try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer intBuff = stack.mallocInt(TOTAL_TEXTURES); int values[] = {GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1, GL_COLOR_ATTACHMENT2, GL_COLOR_ATTACHMENT3, GL_COLOR_ATTACHMENT4, GL_COLOR_ATTACHMENT5}; for(int i = 0; i < values.length; i++) { intBuff.put(values[i]); } intBuff.flip(); glDrawBuffers(intBuff); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u9996\u5148\u6211\u4eec\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8bb0\u4f4f\uff0c\u5e27\u7f13\u51b2\u533a\u53ea\u662f\u4e00\u4e2aOpenGL\u5bf9\u8c61\uff0c\u53ef\u7528\u4e8e\u6e32\u67d3\u64cd\u4f5c\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5230\u5c4f\u5e55\u3002\u7136\u540e\u6211\u4eec\u751f\u6210\u4e00\u7ec4\u7eb9\u7406\uff086\u4e2a\u7eb9\u7406\uff09\uff0c\u8fd9\u4e9b\u7eb9\u7406\u5c06\u4e0e\u5e27\u7f13\u51b2\u533a\u5173\u8054\u3002 \u4e4b\u540e\uff0c\u6211\u4eec\u4f7f\u7528for\u5faa\u73af\u6765\u521d\u59cb\u5316\u7eb9\u7406\uff0c\u6709\u5982\u4e0b\u7c7b\u578b\uff1a \u201c\u5e38\u89c4\u7eb9\u7406\u201d\uff0c\u5c06\u50a8\u5b58\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u548c\u6f2b\u53cd\u5c04\u5206\u91cf\u7b49\u3002 \u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u7eb9\u7406\uff0c\u8fd9\u5c06\u662f\u6700\u540e\u7684\u7eb9\u7406\u3002 \u7eb9\u7406\u521d\u59cb\u5316\u540e\uff0c\u6211\u4eec\u4e3a\u5b83\u4eec\u542f\u7528\u91c7\u6837\u5e76\u5c06\u5b83\u4eec\u7ed1\u5b9a\u5230\u5e27\u7f13\u51b2\u533a\u3002\u6bcf\u4e2a\u7eb9\u7406\u4f7f\u7528\u4ee5 GL_COLOR_ATTACHMENT0 \u4e3a\u5f00\u5934\u7684ID\u8fdb\u884c\u7ed1\u5b9a\u3002\u6bcf\u4e2a\u7eb9\u7406\u90fd\u4ee5\u8be5ID\u9012\u589e\u4e00\u4f4d\uff0c\u56e0\u6b64\u5750\u6807\u4f7f\u7528 GL_COLOR_ATTACHMENT0 \u7ed1\u5b9a\uff0c\u6f2b\u53cd\u5c04\u5206\u91cf\u4f7f\u7528 GL_COLOR_ATTACHMENT1 \uff08\u5373 GL_COLOR_ATTACHMENT0 + 1 \uff09\u9644\u52a0\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u5728\u521b\u5efa\u5b8c\u6240\u6709\u7eb9\u7406\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ba9\u7247\u5143\u7740\u8272\u5668\u4f7f\u7528\u5b83\u4eec\u8fdb\u884c\u6e32\u67d3\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glDrawBuffers \u5b8c\u6210\u7684\u3002\u6211\u4eec\u53ea\u4f20\u9012\u5e26\u6709\u6240\u7528\u989c\u8272\u7ed1\u5b9a\u7684ID\u7684\u6570\u7ec4\uff08 GL_COLOR_ ATTACHMENT0 \u5230 GL_COLOR_ATTACHMENT5 \uff09\u3002 \u7c7b\u7684\u5176\u4ed6\u90e8\u5206\u53ea\u662fgetter\u65b9\u6cd5\u548c cleanup \u65b9\u6cd5\u3002 public int getWidth() { return width; } public int getHeight() { return height; } public int getGBufferId() { return gBufferId; } public int[] getTextureIds() { return textureIds; } public int getPositionTexture() { return textureIds[0]; } public int getDepthTexture() { return textureIds[TOTAL_TEXTURES-1]; } public void cleanUp() { glDeleteFramebuffers(gBufferId); if (textureIds != null) { for (int i=0; i<TOTAL_TEXTURES; i++) { glDeleteTextures(textureIds[i]); } } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SceneBuffer \u7684\u65b0\u7c7b\uff0c\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\uff0c\u5c06\u5728\u6267\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u4e0d\u76f4\u63a5\u6e32\u67d3\u5230\u5c4f\u5e55\uff0c\u800c\u662f\u6e32\u67d3\u5230\u8fd9\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8fd9\u6837\u505a\uff0c\u6211\u4eec\u53ef\u4ee5\u5e94\u7528\u5176\u4ed6\u6548\u679c\uff08\u5982\u96fe\u3001\u5929\u7a7a\u76d2\u7b49\uff09\u3002\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class SceneBuffer { private int bufferId; private int textureId; public SceneBuffer(Window window) throws Exception { // \u521b\u5efa\u7f13\u51b2\u533a bufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, bufferId); // \u521b\u5efa\u7eb9\u7406 int[] textureIds = new int[1]; glGenTextures(textureIds); textureId = textureIds[0]; glBindTexture(GL_TEXTURE_2D, textureId); glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, window.getWidth(), window.getHeight(), 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u9644\u52a0\u7eb9\u7406\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, textureId, 0); // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public int getBufferId() { return bufferId; } public int getTextureId() { return textureId; } public void cleanup() { glDeleteFramebuffers(bufferId); glDeleteTextures(textureId); } } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u7c7b\u4f3c\u4e8e GBuffer \u7c7b\uff0c\u4f46\u8fd9\u91cc\u53ea\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u6765\u50a8\u5b58\u751f\u6210\u7684\u989c\u8272\u3002\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u8fd9\u4e9b\u65b0\u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528\u5b83\u4eec\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u518d\u4f7f\u7528\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u6b63\u5411\u6e32\u67d3\u7740\u8272\u5668\uff08\u540d\u4e3a scene_vertex.vs \u548c scene_fragment.fs \uff09\u3002 \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u521b\u5efa\u4e86\u4e00\u4e2a GBuffer \u5b9e\u73b0\uff0c\u6211\u4eec\u5206\u522b\u4e3a\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupGeometryShader \u65b9\u6cd5\uff09\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupDirLightShader \u548c setupPointLightShader \u65b9\u6cd5\uff09\u521d\u59cb\u5316\u4e86\u53e6\u4e00\u7ec4\u7740\u8272\u5668\u3002\u4f60\u6362\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a sceneBuffer \u7684 SceneBuffer \u7c7b\u7684\u5b9e\u4f8b\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u5149\u7167\u65f6\u4f7f\u7528\u3002\u540d\u4e3a bufferPassModelMatrix \u7684\u5b9e\u7528\u77e9\u9635\u4e5f\u88ab\u5b9e\u4f8b\u5316\uff08\u5728\u6267\u884c\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u65f6\u5c06\u4f7f\u7528\u5b83\uff09\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5728 init \u65b9\u6cd5\u7684\u672b\u5c3e\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Mesh \uff0c\u5b83\u5c06\u7528\u4e8e\u5149\u7167\u5904\u7406\u9636\u6bb5\u3002\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u8be6\u60c5\u5c06\u5728\u4e4b\u540e\u4ecb\u7ecd\u3002 public void init(Window window) throws Exception { shadowRenderer.init(window); gBuffer = new GBuffer(window); sceneBuffer = new SceneBuffer(window); setupSkyBoxShader(); setupParticlesShader(); setupGeometryShader(); setupDirLightShader(); setupPointLightShader(); setupFogShader(); bufferPassModelMatrix = new Matrix4f(); bufferPassMesh = StaticMeshesLoader.load(\"src/main/resources/models/buffer_pass_mess.obj\", \"src/main/resources/models\")[0]; } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\u4f7f\u7528\u7684\u7740\u8272\u5668\u5b9a\u4e49\u4e0e\u901a\u5e38\u4e00\u81f4\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\uff0c\u8ba9\u6211\u4eec\u5173\u6ce8\u5b83\u4eec\u7684\u5185\u5bb9\u3002\u6211\u4eec\u5c06\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\uff0c\u63a5\u4e0b\u6765\u662f\u9876\u70b9\u7740\u8272\u5668\u4ee3\u7801\uff08 gbuffer_vertex.vs \uff09\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; const int NUM_CASCADES = 3; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; layout (location=5) in mat4 modelInstancedMatrix; layout (location=9) in vec2 texOffset; layout (location=10) in float selectedInstanced; uniform int isInstanced; uniform mat4 viewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelNonInstancedMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 lightViewMatrix[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int numCols; uniform int numRows; uniform float selectedNonInstanced; out vec2 vs_textcoord; out vec3 vs_normal; out vec4 vs_mvVertexPos; out vec4 vs_mlightviewVertexPos[NUM_CASCADES]; out mat4 vs_modelMatrix; out float vs_selected; void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelMatrix; if ( isInstanced > 0 ) { vs_selected = selectedInstanced; modelMatrix = modelInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } else { vs_selected = selectedNonInstanced; modelMatrix = modelNonInstancedMatrix; int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } } mat4 modelViewMatrix = viewMatrix * modelMatrix; vs_mvVertexPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * vs_mvVertexPos; // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); vs_textcoord = vec2(x, y); vs_normal = normalize(modelViewMatrix * initNormal).xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { vs_mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * initPos; } vs_modelMatrix = modelMatrix; } \u6b64\u7740\u8272\u5668\u4e0e\u4e0a\u4e00\u7ae0\u4e2d\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\uff0c\u8f93\u51fa\u53d8\u91cf\u7684\u540d\u79f0\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u4f46\u672c\u8d28\u4e0a\u662f\u76f8\u540c\u7684\u7740\u8272\u5668\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u5e94\u8be5\u662f\u51e0\u8fd1\u4e00\u81f4\u7684\uff0c\u6211\u4eec\u6e32\u67d3\u9876\u70b9\u7684\u65b9\u5f0f\u4e0d\u5e94\u8be5\u6539\u53d8\uff0c\u4e3b\u8981\u7684\u66f4\u6539\u662f\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u5b83\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff08 gbuffer_fragment.fs \uff09\uff1a #version 330 const int NUM_CASCADES = 3; in vec2 vs_textcoord; in vec3 vs_normal; in vec4 vs_mvVertexPos; in vec4 vs_mlightviewVertexPos[NUM_CASCADES]; in mat4 vs_modelMatrix; in float vs_selected; layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; uniform mat4 viewMatrix; struct Material { vec4 diffuse; vec4 specular; int hasTexture; int hasNormalMap; float reflectance; }; uniform sampler2D texture_sampler; uniform sampler2D normalMap; uniform Material material; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; uniform float cascadeFarPlanes[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int renderShadow; vec4 diffuseC; vec4 speculrC; void getColour(Material material, vec2 textCoord) { if (material.hasTexture == 1) { diffuseC = texture(texture_sampler, textCoord); speculrC = diffuseC; } else { diffuseC = material.diffuse; speculrC = material.specular; } } vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(viewMatrix * modelMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } float calcShadow(vec4 position, int idx) { if ( renderShadow == 0 ) { return 1.0; } vec3 projCoords = position.xyz; // Transform from screen coordinates to texture coordinates projCoords = projCoords * 0.5 + 0.5; float bias = 0.005; float shadowFactor = 0.0; vec2 inc; if (idx == 0) { inc = 1.0 / textureSize(shadowMap_0, 0); } else if (idx == 1) { inc = 1.0 / textureSize(shadowMap_1, 0); } else { inc = 1.0 / textureSize(shadowMap_2, 0); } for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth; if (idx == 0) { textDepth = texture(shadowMap_0, projCoords.xy + vec2(row, col) * inc).r; } else if (idx == 1) { textDepth = texture(shadowMap_1, projCoords.xy + vec2(row, col) * inc).r; } else { textDepth = texture(shadowMap_2, projCoords.xy + vec2(row, col) * inc).r; } shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; if(projCoords.z > 1.0) { shadowFactor = 1.0; } return 1 - shadowFactor; } void main() { getColour(material, vs_textcoord); fs_worldpos = vs_mvVertexPos.xyz; fs_diffuse = diffuseC.xyz; fs_specular = speculrC.xyz; fs_normal = normalize(calcNormal(material, vs_normal, vs_textcoord, vs_modelMatrix)); int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(vs_mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } fs_shadow = vec2(calcShadow(vs_mlightviewVertexPos[idx], idx), material.reflectance); if ( vs_selected > 0 ) { fs_diffuse = vec3(fs_diffuse.x, fs_diffuse.y, 1); } } \u6700\u5173\u952e\u7684\u884c\u662f\uff1a layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; \u8fd9\u5c31\u662f\u6211\u4eec\u8981\u5f15\u7528\u8be5\u7247\u5143\u7740\u8272\u5668\u5c06\u5199\u5165\u7684\u7eb9\u7406\u7684\u5730\u65b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u662f\u8f6c\u50a8\u4f4d\u7f6e\uff08\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3001\u6f2b\u53cd\u5c04\u989c\u8272\uff08\u53ef\u4ee5\u662f\u6750\u8d28\u76f8\u5173\u7684\u7eb9\u7406\u7684\u989c\u8272\u5206\u91cf\uff09\u3001\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3001\u6cd5\u7ebf\u548c\u9634\u5f71\u56fe\u7684\u6df1\u5ea6\u503c\u3002 \u65c1\u6ce8\uff1a\u6211\u4eec\u5df2\u7ecf\u7b80\u5316\u4e86 Material \u7c7b\u7684\u5b9a\u4e49\uff0c\u5220\u9664\u4e86\u73af\u5883\u989c\u8272\u5206\u91cf\u3002 \u56de\u5230 Renderer \u7c7b\uff0c render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void render(Window window, Camera camera, Scene scene, boolean sceneChanged) { clear(); if (window.getOptions().frustumCulling) { frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); } // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe if (scene.isRenderShadows() && sceneChanged) { shadowRenderer.render(window, scene, camera, transformation, this); } glViewport(0, 0, window.getWidth(), window.getHeight()); // \u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21 window.updateProjectionMatrix(); renderGeometry(window, camera, scene); initLightRendering(); renderPointLights(window, camera, scene); renderDirectionalLight(window, camera, scene); endLightRendering(); renderFog(window, camera, scene); renderSkyBox(window, camera, scene); renderParticles(window, camera, scene); } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u662f\u5728 renderGeometry \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4e0d\u518d\u6709 renderScene \uff09\u3002\u5149\u7167\u5904\u7406\u9636\u6bb5\u5206\u51e0\u4e2a\u6b65\u9aa4\u5b8c\u6210\uff0c\u9996\u5148\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u7f13\u51b2\u533a\u548c\u5176\u4ed6\u53c2\u6570\uff08\u5728 initLightRendering \u4e2d\uff09\uff0c\u7136\u540e\u6e32\u67d3\u70b9\u5149\u6e90\uff08\u5728 renderPointLights \u4e2d\uff09\u548c\u5e73\u884c\u5149\uff08\u5728 renderDirectionalLight \u4e2d\uff09\uff0c\u6700\u540e\u6062\u590d\u72b6\u6001\uff08\u5728 endLightRendering \u4e2d\uff09\u3002 \u8ba9\u6211\u4eec\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\u3002 renderGeometry \u65b9\u6cd5\u51e0\u4e4e\u7b49\u540c\u4e8e\u5728\u524d\u51e0\u7ae0\u4e2d\u4f7f\u7528\u7684 renderScene \u65b9\u6cd5\uff1a private void renderGeometry(Window window, Camera camera, Scene scene) { // \u6e32\u67d3G\u7f13\u51b2\u533a\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBuffer.getGBufferId()); clear(); glDisable(GL_BLEND); gBufferShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); gBufferShaderProgram.setUniform(\"viewMatrix\", viewMatrix); gBufferShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); gBufferShaderProgram.setUniform(\"texture_sampler\", 0); gBufferShaderProgram.setUniform(\"normalMap\", 1); List<ShadowCascade> shadowCascades = shadowRenderer.getShadowCascades(); for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); gBufferShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix(), i); gBufferShaderProgram.setUniform(\"cascadeFarPlanes\", ShadowRenderer.CASCADE_SPLITS[i], i); gBufferShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix(), i); } shadowRenderer.bindTextures(GL_TEXTURE2); int start = 2; for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { gBufferShaderProgram.setUniform(\"shadowMap_\" + i, start + i); } gBufferShaderProgram.setUniform(\"renderShadow\", scene.isRenderShadows() ? 1 : 0); renderNonInstancedMeshes(scene); renderInstancedMeshes(scene, viewMatrix); gBufferShaderProgram.unbind(); glEnable(GL_BLEND); } \u4ec5\u6709\u7684\u533a\u522b\u662f\uff1a \u6211\u4eec\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a\u800c\u4e0d\u662f\u5c4f\u5e55\u3002 \u7981\u7528\u6df7\u5408\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u60f3\u4f7f\u7528\u6700\u63a5\u8fd1\u6444\u50cf\u673a\u7684\u503c\uff08\u6700\u5c0f\u6df1\u5ea6\u503c\uff09\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6df7\u5408\u3002 \u5982\u679c\u4f7f\u7528OpenGL\u8c03\u8bd5\u5668\uff08\u5982RenderDoc\uff09\u8c03\u8bd5\u793a\u4f8b\uff0c\u5219\u53ef\u4ee5\u770b\u5230\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u671f\u95f4\u751f\u6210\u7684\u7eb9\u7406\u3002\u4f4d\u7f6e\u7eb9\u7406\u5c06\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6f2b\u53cd\u5c04\u5206\u91cf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6cd5\u7ebf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u73b0\u5728\u8f6e\u5230\u5149\u7167\u5904\u7406\u9636\u6bb5\u4e86\u3002\u6211\u4eec\u9996\u5148\u9700\u8981\u5728\u6e32\u67d3\u4e4b\u524d\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u8fd9\u662f\u5728 initLightRendering \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void initLightRendering() { // \u7ed1\u5b9a\u573a\u666f\u7f13\u51b2\u533a glBindFramebuffer(GL_FRAMEBUFFER, sceneBuffer.getBufferId()); // \u6e05\u7406G\u7f13\u51b2\u533a clear(); // \u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4ee5\u5141\u8bb8\u7ed8\u5236\u5177\u6709\u76f8\u540c\u6df1\u5ea6\u7684\u591a\u4e2a\u56fe\u5c42 glDisable(GL_DEPTH_TEST); glEnable(GL_BLEND); glBlendEquation(GL_FUNC_ADD); glBlendFunc(GL_ONE, GL_ONE); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u4ee5\u4fbf\u8bfb\u53d6 glBindFramebuffer(GL_READ_FRAMEBUFFER, gBuffer.getGBufferId()); } \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\uff0c\u6240\u4ee5\u9996\u5148\u9700\u8981\u7ed1\u5b9a\u5230\u7eb9\u7406\u4e0a\uff0c\u8be5\u7eb9\u7406\u5c06\u4fdd\u5b58\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u7ed3\u679c\u3002\u7136\u540e\u6e05\u9664\u7f13\u51b2\u533a\u5e76\u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u3002\u56e0\u4e3a\u5df2\u7ecf\u5728\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u8fdb\u884c\u4e86\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u8fd9\u5c31\u4e0d\u518d\u9700\u8981\u4e86\u3002\u53e6\u4e00\u91cd\u8981\u6b65\u9aa4\u662f\u542f\u7528\u6df7\u5408\u3002\u6700\u540e\u4e00\u4e2a\u64cd\u4f5c\u662f\u542f\u7528G\u7f13\u51b2\u533a\u8fdb\u884c\u8bfb\u53d6\uff0c\u5b83\u5c06\u5728\u5149\u7167\u5904\u7406\u9636\u6bb5\u671f\u95f4\u4f7f\u7528\u3002 \u5728\u5206\u6790\u4e0d\u540c\u5149\u7167\u7684\u6e32\u67d3\u65b9\u6cd5\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7a0d\u5fae\u8003\u8651\u4e00\u4e0b\u5982\u4f55\u6e32\u67d3\u5149\u7167\u3002\u6211\u4eec\u9700\u8981\u4f7f\u7528G\u7f13\u51b2\u533a\u7684\u5185\u5bb9\uff0c\u4f46\u4e3a\u4e86\u4f7f\u7528\u5b83\u4eec\uff0c\u9700\u8981\u5148\u6e32\u67d3\u4e00\u4e9b\u4e1c\u897f\u3002\u4f46\u662f\uff0c\u6211\u4eec\u5df2\u7ecf\u7ed8\u5236\u4e86\u573a\u666f\uff0c\u73b0\u5728\u8981\u6e32\u67d3\u4ec0\u4e48\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e32\u67d3\u4e00\u4e2a\u5145\u6ee1\u4e86\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u5bf9\u4e8e\u8be5\u77e9\u5f62\u7684\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5e76\u751f\u6210\u6b63\u786e\u7684\u8f93\u51fa\u989c\u8272\u3002\u4f60\u8fd8\u8bb0\u5f97\u6211\u4eec\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u52a0\u8f7d\u7684 Mesh \u5417\uff1f\u5b83\u88ab\u547d\u540d\u4e3a bufferPassMesh \uff0c\u5b83\u53ea\u50a8\u5b58\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002 \u90a3\u4e48\uff0c\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u9876\u70b9\u7740\u8272\u5668\u770b\u8d77\u6765\u662f\u600e\u6837\u7684\uff1f #version 330 layout (location=0) in vec3 position; uniform mat4 projectionMatrix; uniform mat4 modelMatrix; void main() { gl_Position = projectionMatrix * modelMatrix * vec4(position, 1.0); } \u4e0a\u8ff0\u4ee3\u7801\u662f\u6e32\u67d3\u70b9\u5149\u6e90\u548c\u5e73\u884c\u5149\u65f6\u4f7f\u7528\u7684\u9876\u70b9\u7740\u8272\u5668\uff08 light_vertex.vs \uff09\u3002\u5b83\u53ea\u662f\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u6765\u8f6c\u50a8\u9876\u70b9\u3002\u4e0d\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u8fd9\u91cc\u4e0d\u9700\u8981\u6444\u50cf\u673a\u3002 \u70b9\u5149\u6e90\u7684\u7247\u5143\u7740\u8272\u5668\uff08 point_light_fragment.fs \uff09\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // Light position is assumed to be in view coordinates vec3 position; float intensity; Attenuation att; }; uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; uniform vec2 screenSize; uniform float specularPower; uniform PointLight pointLight; vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } vec4 calcLightColour(vec4 diffuseC, vec4 speculrC, float reflectance, vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 1); vec4 specColour = vec4(0, 0, 0, 1); // Diffuse Light float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // Specular Light vec3 camera_direction = normalize(-position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } vec4 calcPointLight(vec4 diffuseC, vec4 speculrC, float reflectance, PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(diffuseC, speculrC, reflectance, light.colour, light.intensity, position, to_light_dir, normal); // Apply Attenuation float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } void main() { vec2 textCoord = getTextCoord(); float depth = texture(depthText, textCoord).r; vec3 worldPos = texture(positionsText, textCoord).xyz; vec4 diffuseC = texture(diffuseText, textCoord); vec4 speculrC = texture(specularText, textCoord); vec3 normal = texture(normalsText, textCoord).xyz; float shadowFactor = texture(shadowText, textCoord).r; float reflectance = texture(shadowText, textCoord).g; fragColor = calcPointLight(diffuseC, speculrC, reflectance, pointLight, worldPos.xyz, normal.xyz) * shadowFactor; } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u5305\u542b\u4f60\u5e94\u8be5\u719f\u6089\u7684\u51fd\u6570\uff0c\u5b83\u4eec\u5728\u524d\u51e0\u7ae0\u7684\u573a\u666f\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8fc7\u3002\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u91cd\u8981\u4e8b\u9879\u5982\u4e0b\uff1a uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; \u8fd9\u4e9bUniform\u5efa\u6a21\u6784\u6210\u4e86G\u7f13\u51b2\u533a\u7684\u4e0d\u540c\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u8bbf\u95ee\u6570\u636e\u3002\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u95ee\uff0c\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u7247\u5143\u65f6\uff0c\u5982\u4f55\u77e5\u9053\u8981\u4ece\u8fd9\u4e9b\u7eb9\u7406\u4e2d\u83b7\u53d6\u54ea\u4e2a\u50cf\u7d20\uff1f\u7b54\u6848\u662f\u4f7f\u7528 gl_FragCoord \u8f93\u5165\u53d8\u91cf\uff0c\u6b64\u53d8\u91cf\u50a8\u5b58\u5f53\u524d\u7247\u5143\u4e0e\u7a97\u53e3\u7684\u76f8\u5bf9\u5750\u6807\u3002\u56e0\u4e3a\u8981\u4ece\u5750\u6807\u7cfb\u8f6c\u6362\u4e3a\u7eb9\u7406\uff0c\u6211\u4eec\u4f7f\u7528\u4ee5\u4e0b\u51fd\u6570\uff1a vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } \u5e73\u884c\u5149\u7684\u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u76f8\u4f3c\uff0c\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u3002\u73b0\u5728\u5df2\u7ecf\u6709\u4e86\u7740\u8272\u5668\uff0c\u6211\u4eec\u56de\u5230 Renderer \u7c7b\u3002\u5bf9\u4e8e\u70b9\u5149\u6e90\uff0c\u6211\u4eec\u5c06\u505a\u5c3d\u53ef\u80fd\u591a\u7684\u5149\u7167\u5904\u7406\uff0c\u6211\u4eec\u53ea\u662f\u7ed1\u5b9a\u7528\u4e8e\u6b64\u7c7b\u578b\u5149\u6e90\u7684\u7740\u8272\u5668\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u7ed8\u5236\u77e9\u5f62\u3002 private void renderPointLights(Window window, Camera camera, Scene scene) { pointLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); pointLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); pointLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 pointLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } pointLightShaderProgram.setUniform(\"positionsText\", 0); pointLightShaderProgram.setUniform(\"diffuseText\", 1); pointLightShaderProgram.setUniform(\"specularText\", 2); pointLightShaderProgram.setUniform(\"normalsText\", 3); pointLightShaderProgram.setUniform(\"shadowText\", 4); pointLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); SceneLight sceneLight = scene.getSceneLight(); PointLight[] pointLights = sceneLight.getPointLightList(); int numPointLights = pointLights != null ? pointLights.length : 0; for(int i=0; i<numPointLights; i++) { // \u83b7\u53d6\u70b9\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLights[i]); Vector3f lightPos = currPointLight.getPosition(); tmpVec.set(lightPos, 1); tmpVec.mul(viewMatrix); lightPos.x = tmpVec.x; lightPos.y = tmpVec.y; lightPos.z = tmpVec.z; pointLightShaderProgram.setUniform(\"pointLight\", currPointLight); bufferPassMesh.render(); } pointLightShaderProgram.unbind(); } \u5bf9\u4e8e\u5e73\u884c\u5149\u6765\u8bf4\uff0c\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u8fdb\u884c\u4e00\u6b21\u5904\u7406\uff1a private void renderDirectionalLight(Window window, Camera camera, Scene scene) { dirLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); dirLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); dirLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 dirLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } dirLightShaderProgram.setUniform(\"positionsText\", 0); dirLightShaderProgram.setUniform(\"diffuseText\", 1); dirLightShaderProgram.setUniform(\"specularText\", 2); dirLightShaderProgram.setUniform(\"normalsText\", 3); dirLightShaderProgram.setUniform(\"shadowText\", 4); dirLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); // \u73af\u5883\u5149\u7167 SceneLight sceneLight = scene.getSceneLight(); dirLightShaderProgram.setUniform(\"ambientLight\", sceneLight.getAmbientLight()); // \u5e73\u884c\u5149 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(sceneLight.getDirectionalLight()); tmpVec.set(currDirLight.getDirection(), 0); tmpVec.mul(viewMatrix); currDirLight.setDirection(new Vector3f(tmpVec.x, tmpVec.y, tmpVec.z)); dirLightShaderProgram.setUniform(\"directionalLight\", currDirLight); bufferPassMesh.render(); dirLightShaderProgram.unbind(); } endLightRendering \u53ea\u7b80\u5355\u5730\u6062\u590d\u72b6\u6001\u3002 private void endLightRendering() { // \u7ed1\u5b9a\u5c4f\u5e55\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_FRAMEBUFFER, 0); glEnable(GL_DEPTH_TEST); glDisable(GL_BLEND); } \u5982\u679c\u8fd0\u884c\u793a\u4f8b\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u672c\u7ae0\u6bd4\u9884\u671f\u65f6\u95f4\u957f\uff0c\u4f46\u6709\u51e0\u4e2a\u8981\u70b9\u9700\u8981\u6f84\u6e05\uff1a \u4e3a\u4e86\u7b80\u5316\u672c\u7ae0\uff0c\u5df2\u7ecf\u5220\u9664\u4e86\u805a\u5149\u6e90\u7684\u76f8\u5173\u5185\u5bb9\u3002 \u5ef6\u8fdf\u7740\u8272\u6cd5\u4e2d\u4f7f\u7528\u70b9\u5149\u6e90\u7684\u4e00\u79cd\u5e38\u89c1\u6280\u672f\u662f\u8ba1\u7b97\u53d7\u8be5\u5149\u6e90\u5f71\u54cd\u7684\u573a\u666f\u533a\u57df\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\u8f83\u5c0f\u7684\u56db\u8fb9\u5f62\uff0c\u5706\u5f62\u7b49\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5145\u6ee1\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u8bf7\u7262\u8bb0\uff0c\u6700\u597d\u662f\u597d\u7684\u654c\u4eba\uff0c\u8fdb\u884c\u590d\u6742\u7684\u5fae\u79ef\u5206\u4ee5\u786e\u5b9a\u6240\u9700\u7684\u6700\u5c0f\u5f62\u72b6\u53ef\u80fd\u6bd4\u4f7f\u7528\u5176\u4ed6\u7c97\u7cd9\u65b9\u6cd5\u6162\u3002 \u5982\u679c\u6ca1\u6709\u8bb8\u591a\u5149\u6e90\uff0c\u6b64\u65b9\u6cd5\u6bd4\u6b63\u5411\u7740\u8272\u6cd5\u6162\u3002 \u6700\u540e\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c\u5982\u679c\u4f60\u60f3\u4e86\u89e3\u8fd9\u4e9b\u6280\u672f\u5728\u73b0\u5b9e\u4e2d\u7684\u5e94\u7528\uff0c\u53ef\u4ee5\u67e5\u770b \u8fd9\u4e2a\u6781\u597d\u7684\u8bf4\u660e \uff0c\u4e86\u89e3GTA V\u7684\u5e27\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002","title":"\u5ef6\u8fdf\u7740\u8272\u6cd5\uff08Deferred Shading\uff09"},{"location":"a01-opengl-debugging/","text":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5\uff08OpenGL Debugging\uff09 \u8c03\u8bd5OpenGL\u7a0b\u5e8f\u53ef\u80fd\u662f\u4e00\u9879\u8270\u5de8\u7684\u4efb\u52a1\u3002\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u4e00\u4e2a\u9ed1\u5c4f\uff0c\u4f60\u65e0\u6cd5\u77e5\u9053\u5230\u5e95\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e3a\u4e86\u7f13\u89e3\u8fd9\u4e2a\u7a98\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e9b\u73b0\u6709\u7684\u5de5\u5177\u6765\u63d0\u4f9b\u5173\u4e8e\u6e32\u67d3\u6d41\u7a0b\u7684\u66f4\u591a\u4fe1\u606f\u3002 \u5728\u672c\u9644\u5f55\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 RenderDoc \u5de5\u5177\u8c03\u8bd5LWJGL\u7a0b\u5e8f\u3002RenderDoc\u662f\u4e00\u4e2a\u56fe\u5f62\u8c03\u8bd5\u5de5\u7a0b\uff0c\u53ef\u4ee5\u4e0eDirect3D\u3001Vulkan\u548cOpenGL\u4e00\u8d77\u4f7f\u7528\u3002\u5bf9\u4e8eOpenGL\uff0c\u5b83\u4ec5\u652f\u6301\u4ece3.2\u52304.5\u7684\u6838\u5fc3\u6a21\u5f0f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5427\uff0c\u4f60\u9700\u8981\u4e0b\u8f7d\u5e76\u5b89\u88c5\u5bf9\u5e94\u64cd\u4f5c\u7cfb\u7edf\u7684RenderDoc\u3002\u5b89\u88c5\u540e\uff0c\u5f53\u4f60\u542f\u52a8\u5b83\u65f6\uff0c\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u4e1c\u897f\uff1a \u7b2c\u4e00\u6b65\u662f\u914d\u7f6eRenderDoc\u6765\u8fd0\u884c\u548c\u76d1\u89c6\u6211\u4eec\u7684\u793a\u4f8b\u3002\u5728\u201cCapture Executable\u201d\u9009\u9879\u5361\u4e2d\uff0c\u9700\u8981\u8bbe\u7f6e\u4ee5\u4e0b\u53c2\u6570\uff1a Executable path \uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u5e94\u8be5\u6307\u5411JVM\u542f\u52a8\u7a0b\u5e8f\uff08\u4f8b\u5982\uff0c\u201cC:\\Program Files\\Java\\jdk-9\\bin\\java.exe\u201d\uff09\u3002 Working Directory \uff1a\u8fd9\u5c06\u4e3a\u4f60\u7684\u7a0b\u5e8f\u8bbe\u7f6e\u5de5\u4f5c\u76ee\u5f55\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5e94\u8be5\u5c06\u5176\u8bbe\u7f6e\u4e3aMaven\u8f6c\u50a8\u7ed3\u679c\u7684 target \u76ee\u5f55\u3002\u8fd9\u6837\u8bbe\u7f6e\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u4f9d\u8d56\u9879\u3002 Command line arguments \uff1a\u8fd9\u5c06\u5305\u542bJVM\u8fd0\u884c\u793a\u4f8b\u6240\u9700\u7684\u53c2\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u53ea\u9700\u8981\u4f20\u9012\u8981\u6267\u884c\u7684Jar\uff08\u4f8b\u5982\uff0c\u201c-java game-c28-1.0.jar\u201d\uff09\u3002 \u4f60\u8981\u8bb0\u4f4f3D\u6a21\u578b\u73b0\u5df2\u7531 Assimp \u5e93\u52a0\u8f7d\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u5b9e\u9645\u7684\u6587\u4ef6\u8def\u5f84\uff08\u800c\u4e0d\u662f CLASSPATH \u7684\u76f8\u5bf9\u8def\u5f84\uff09\uff0c\u56e0\u6b64\u4f60\u9700\u8981\u5728\u4f60\u8bbe\u7f6e\u7684\u5de5\u4f5c\u76ee\u5f55\u68c0\u67e5\u8def\u5f84\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6700\u7b80\u5355\u5feb\u901f\u7684\u6d4b\u8bd5\u65b9\u6cd5\u662f\u5c06src\u6587\u4ef6\u5939\u590d\u5236\u5230 target \u76ee\u5f55\u4e2d\u3002 \u6b64\u9009\u9879\u5361\u4e2d\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u9009\u9879\u7528\u4e8e\u914d\u7f6e\u6355\u83b7\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u5728 RenderDoc\u6587\u6863 \u4e2d\u67e5\u9605\u5b83\u4eec\u7684\u7528\u9014\u3002\u4e00\u5207\u5c31\u7eea\u540e\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u70b9\u51fb\u201cLaunch\u201d\u6309\u94ae\u6765\u5f00\u59cb\u8fd0\u884c\u7a0b\u5e8f\u3002\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u56e0\u4e3aRenderDoc\u53ea\u80fd\u4f7f\u7528OpenGL\u6838\u5fc3\u6a21\u5f0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u517c\u5bb9\u6027\u6a21\u5f0f\uff0c\u4f46\u5b83\u4f1a\u5ffd\u7565\u8b66\u544a\u7ee7\u7eed\u5de5\u4f5c\u3002\u7a0b\u5e8f\u8fd0\u884c\u540e\uff0c\u4f60\u5c31\u53ef\u4ee5\u89e6\u53d1\u5b83\u7684\u5feb\u7167\u3002\u4f60\u5c06\u770b\u5230\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u9009\u9879\u5361\uff0c\u540d\u4e3a\u201cjava [PID XXXX]\u201d\uff08\u5176\u4e2dXXXX\u6570\u5b57\u8868\u793aJava\u8fdb\u7a0b\u7684PID\u3001\u8fdb\u7a0b\u6807\u8bc6\u53f7\uff09 \u4ece\u8be5\u9009\u9879\u5361\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u6309\u4e0b\u201cTrigger capture\u201d\u6309\u94ae\u6765\u6355\u83b7\u7a0b\u5e8f\u7684\u72b6\u6001\u3002\u751f\u6210\u4e86\u4e00\u4e2a\u6355\u83b7\u7ed3\u679c\u540e\uff0c\u4f60\u5c06\u5728\u540c\u4e00\u4e2a\u9009\u9879\u5361\u4e2d\u770b\u5230\u4e00\u4e2a\u5c0f\u5feb\u7167\u3002 \u5982\u679c\u53cc\u51fb\u8be5\u6355\u83b7\u7ed3\u679c\uff0c\u5219\u5c06\u52a0\u8f7d\u6536\u96c6\u7684\u6240\u6709\u6570\u636e\uff0c\u5e76\u53ef\u4ee5\u5f00\u59cb\u67e5\u770b\u5b83\u3002\u201cEvent Browser\u201d\u9762\u677f\u5c06\u663e\u793a\u6240\u6709\u5728\u4e00\u4e2a\u6e32\u67d3\u5468\u671f\u5185\u6267\u884c\u7684\u4e0eOpenGL\u76f8\u5173\u7684\u8c03\u7528\u3002 \u5bf9\u4e8e\u7b2c\u4e00\u4e2a\u6e32\u67d3\u6d41\u7a0b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u5730\u9762\u662f\u5982\u4f55\u5728\u6a21\u578b\u623f\u5c4b\u7684\u7f51\u683c\u4e4b\u540e\u7ed8\u5236\u7684\u3002\u5982\u679c\u5355\u51fb\u4e00\u4e2aglDrawELements\u4e8b\u4ef6\uff0c\u5e76\u9009\u62e9\u201cMesh\u201d\u9009\u9879\u5361\uff0c\u5219\u53ef\u4ee5\u67e5\u770b\u7ed8\u5236\u7684\u7f51\u683c\uff0c\u4e8b\u4ef6\u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u8f93\u5165\u4e0e\u8f93\u51fa\u3002 \u4f60\u6362\u53ef\u4ee5\u67e5\u770b\u7528\u4e8e\u8be5\u7ed8\u5236\u64cd\u4f5c\u7684\u8f93\u5165\u7eb9\u7406\uff08\u901a\u8fc7\u5355\u51fb\u201cTexture Viewer\u201d\u9009\u9879\u5361\uff09\u3002 \u5728\u4e2d\u592e\u9762\u677f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u8f93\u51fa\uff0c\u5728\u53f3\u4fa7\u9762\u677f\u4e0a\u53ef\u4ee5\u770b\u5230\u7528\u4e8e\u8f93\u5165\u7684\u7eb9\u7406\u5217\u8868\u3002\u8fd8\u53ef\u4ee5\u9010\u4e2a\u67e5\u770b\u8f93\u51fa\u7eb9\u7406\u3002\u8fd9\u5f88\u597d\u5730\u8bf4\u660e\u4e86\u5ef6\u8fdf\u7740\u8272\u662f\u5982\u4f55\u5de5\u4f5c\u7684\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u8be5\u5de5\u5177\u63d0\u4f9b\u4e86\u6709\u5173\u6e32\u67d3\u65f6\u53d1\u751f\u7684\u60c5\u51b5\u7684\u5b9d\u8d35\u6570\u636e\uff0c\u5b83\u53ef\u4ee5\u5728\u8c03\u8bd5\u6e32\u67d3\u95ee\u9898\u65f6\u8282\u7701\u5b9d\u8d35\u7684\u65f6\u95f4\u3002\u5b83\u751a\u81f3\u53ef\u4ee5\u663e\u793a\u6709\u5173\u6e32\u67d3\u7ba1\u7ebf\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u7684\u4fe1\u606f\u3002","title":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5"},{"location":"a01-opengl-debugging/#a-openglopengl-debugging","text":"\u8c03\u8bd5OpenGL\u7a0b\u5e8f\u53ef\u80fd\u662f\u4e00\u9879\u8270\u5de8\u7684\u4efb\u52a1\u3002\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u4e00\u4e2a\u9ed1\u5c4f\uff0c\u4f60\u65e0\u6cd5\u77e5\u9053\u5230\u5e95\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e3a\u4e86\u7f13\u89e3\u8fd9\u4e2a\u7a98\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e9b\u73b0\u6709\u7684\u5de5\u5177\u6765\u63d0\u4f9b\u5173\u4e8e\u6e32\u67d3\u6d41\u7a0b\u7684\u66f4\u591a\u4fe1\u606f\u3002 \u5728\u672c\u9644\u5f55\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 RenderDoc \u5de5\u5177\u8c03\u8bd5LWJGL\u7a0b\u5e8f\u3002RenderDoc\u662f\u4e00\u4e2a\u56fe\u5f62\u8c03\u8bd5\u5de5\u7a0b\uff0c\u53ef\u4ee5\u4e0eDirect3D\u3001Vulkan\u548cOpenGL\u4e00\u8d77\u4f7f\u7528\u3002\u5bf9\u4e8eOpenGL\uff0c\u5b83\u4ec5\u652f\u6301\u4ece3.2\u52304.5\u7684\u6838\u5fc3\u6a21\u5f0f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5427\uff0c\u4f60\u9700\u8981\u4e0b\u8f7d\u5e76\u5b89\u88c5\u5bf9\u5e94\u64cd\u4f5c\u7cfb\u7edf\u7684RenderDoc\u3002\u5b89\u88c5\u540e\uff0c\u5f53\u4f60\u542f\u52a8\u5b83\u65f6\uff0c\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u4e1c\u897f\uff1a \u7b2c\u4e00\u6b65\u662f\u914d\u7f6eRenderDoc\u6765\u8fd0\u884c\u548c\u76d1\u89c6\u6211\u4eec\u7684\u793a\u4f8b\u3002\u5728\u201cCapture Executable\u201d\u9009\u9879\u5361\u4e2d\uff0c\u9700\u8981\u8bbe\u7f6e\u4ee5\u4e0b\u53c2\u6570\uff1a Executable path \uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u5e94\u8be5\u6307\u5411JVM\u542f\u52a8\u7a0b\u5e8f\uff08\u4f8b\u5982\uff0c\u201cC:\\Program Files\\Java\\jdk-9\\bin\\java.exe\u201d\uff09\u3002 Working Directory \uff1a\u8fd9\u5c06\u4e3a\u4f60\u7684\u7a0b\u5e8f\u8bbe\u7f6e\u5de5\u4f5c\u76ee\u5f55\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5e94\u8be5\u5c06\u5176\u8bbe\u7f6e\u4e3aMaven\u8f6c\u50a8\u7ed3\u679c\u7684 target \u76ee\u5f55\u3002\u8fd9\u6837\u8bbe\u7f6e\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u4f9d\u8d56\u9879\u3002 Command line arguments \uff1a\u8fd9\u5c06\u5305\u542bJVM\u8fd0\u884c\u793a\u4f8b\u6240\u9700\u7684\u53c2\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u53ea\u9700\u8981\u4f20\u9012\u8981\u6267\u884c\u7684Jar\uff08\u4f8b\u5982\uff0c\u201c-java game-c28-1.0.jar\u201d\uff09\u3002 \u4f60\u8981\u8bb0\u4f4f3D\u6a21\u578b\u73b0\u5df2\u7531 Assimp \u5e93\u52a0\u8f7d\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u5b9e\u9645\u7684\u6587\u4ef6\u8def\u5f84\uff08\u800c\u4e0d\u662f CLASSPATH \u7684\u76f8\u5bf9\u8def\u5f84\uff09\uff0c\u56e0\u6b64\u4f60\u9700\u8981\u5728\u4f60\u8bbe\u7f6e\u7684\u5de5\u4f5c\u76ee\u5f55\u68c0\u67e5\u8def\u5f84\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6700\u7b80\u5355\u5feb\u901f\u7684\u6d4b\u8bd5\u65b9\u6cd5\u662f\u5c06src\u6587\u4ef6\u5939\u590d\u5236\u5230 target \u76ee\u5f55\u4e2d\u3002 \u6b64\u9009\u9879\u5361\u4e2d\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u9009\u9879\u7528\u4e8e\u914d\u7f6e\u6355\u83b7\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u5728 RenderDoc\u6587\u6863 \u4e2d\u67e5\u9605\u5b83\u4eec\u7684\u7528\u9014\u3002\u4e00\u5207\u5c31\u7eea\u540e\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u70b9\u51fb\u201cLaunch\u201d\u6309\u94ae\u6765\u5f00\u59cb\u8fd0\u884c\u7a0b\u5e8f\u3002\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u56e0\u4e3aRenderDoc\u53ea\u80fd\u4f7f\u7528OpenGL\u6838\u5fc3\u6a21\u5f0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u517c\u5bb9\u6027\u6a21\u5f0f\uff0c\u4f46\u5b83\u4f1a\u5ffd\u7565\u8b66\u544a\u7ee7\u7eed\u5de5\u4f5c\u3002\u7a0b\u5e8f\u8fd0\u884c\u540e\uff0c\u4f60\u5c31\u53ef\u4ee5\u89e6\u53d1\u5b83\u7684\u5feb\u7167\u3002\u4f60\u5c06\u770b\u5230\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u9009\u9879\u5361\uff0c\u540d\u4e3a\u201cjava [PID XXXX]\u201d\uff08\u5176\u4e2dXXXX\u6570\u5b57\u8868\u793aJava\u8fdb\u7a0b\u7684PID\u3001\u8fdb\u7a0b\u6807\u8bc6\u53f7\uff09 \u4ece\u8be5\u9009\u9879\u5361\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u6309\u4e0b\u201cTrigger capture\u201d\u6309\u94ae\u6765\u6355\u83b7\u7a0b\u5e8f\u7684\u72b6\u6001\u3002\u751f\u6210\u4e86\u4e00\u4e2a\u6355\u83b7\u7ed3\u679c\u540e\uff0c\u4f60\u5c06\u5728\u540c\u4e00\u4e2a\u9009\u9879\u5361\u4e2d\u770b\u5230\u4e00\u4e2a\u5c0f\u5feb\u7167\u3002 \u5982\u679c\u53cc\u51fb\u8be5\u6355\u83b7\u7ed3\u679c\uff0c\u5219\u5c06\u52a0\u8f7d\u6536\u96c6\u7684\u6240\u6709\u6570\u636e\uff0c\u5e76\u53ef\u4ee5\u5f00\u59cb\u67e5\u770b\u5b83\u3002\u201cEvent Browser\u201d\u9762\u677f\u5c06\u663e\u793a\u6240\u6709\u5728\u4e00\u4e2a\u6e32\u67d3\u5468\u671f\u5185\u6267\u884c\u7684\u4e0eOpenGL\u76f8\u5173\u7684\u8c03\u7528\u3002 \u5bf9\u4e8e\u7b2c\u4e00\u4e2a\u6e32\u67d3\u6d41\u7a0b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u5730\u9762\u662f\u5982\u4f55\u5728\u6a21\u578b\u623f\u5c4b\u7684\u7f51\u683c\u4e4b\u540e\u7ed8\u5236\u7684\u3002\u5982\u679c\u5355\u51fb\u4e00\u4e2aglDrawELements\u4e8b\u4ef6\uff0c\u5e76\u9009\u62e9\u201cMesh\u201d\u9009\u9879\u5361\uff0c\u5219\u53ef\u4ee5\u67e5\u770b\u7ed8\u5236\u7684\u7f51\u683c\uff0c\u4e8b\u4ef6\u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u8f93\u5165\u4e0e\u8f93\u51fa\u3002 \u4f60\u6362\u53ef\u4ee5\u67e5\u770b\u7528\u4e8e\u8be5\u7ed8\u5236\u64cd\u4f5c\u7684\u8f93\u5165\u7eb9\u7406\uff08\u901a\u8fc7\u5355\u51fb\u201cTexture Viewer\u201d\u9009\u9879\u5361\uff09\u3002 \u5728\u4e2d\u592e\u9762\u677f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u8f93\u51fa\uff0c\u5728\u53f3\u4fa7\u9762\u677f\u4e0a\u53ef\u4ee5\u770b\u5230\u7528\u4e8e\u8f93\u5165\u7684\u7eb9\u7406\u5217\u8868\u3002\u8fd8\u53ef\u4ee5\u9010\u4e2a\u67e5\u770b\u8f93\u51fa\u7eb9\u7406\u3002\u8fd9\u5f88\u597d\u5730\u8bf4\u660e\u4e86\u5ef6\u8fdf\u7740\u8272\u662f\u5982\u4f55\u5de5\u4f5c\u7684\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u8be5\u5de5\u5177\u63d0\u4f9b\u4e86\u6709\u5173\u6e32\u67d3\u65f6\u53d1\u751f\u7684\u60c5\u51b5\u7684\u5b9d\u8d35\u6570\u636e\uff0c\u5b83\u53ef\u4ee5\u5728\u8c03\u8bd5\u6e32\u67d3\u95ee\u9898\u65f6\u8282\u7701\u5b9d\u8d35\u7684\u65f6\u95f4\u3002\u5b83\u751a\u81f3\u53ef\u4ee5\u663e\u793a\u6709\u5173\u6e32\u67d3\u7ba1\u7ebf\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u7684\u4fe1\u606f\u3002","title":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5\uff08OpenGL Debugging\uff09"},{"location":"glossary/","text":"\u672f\u8bed\u8868 \u672c\u4e66\u672f\u8bed\u8868\u6309\u672f\u8bed\u9996\u6b21\u4ecb\u7ecd\u7ae0\u8282\u6392\u5e8f\u3002 Java\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93\uff08Lightweight Java Game Library\uff0cLWJGL\uff09\uff1a OpenGL\u3001OpenCL\u3001OpenAL\u548cVulkan\u5bf9Java\u5e73\u53f0\u7684\u539f\u751f\u7ed1\u5b9a\uff0c\u5e38\u7528\u4e8e\u5f00\u53d1\u6e38\u620f\u3002 GLFW\uff1a \u4e3aOpenGL\u3001OpenGL ES\u548cVulkan\u63d0\u4f9b\u7684\u8de8\u5e73\u53f0\u7a97\u53e3\u4e0e\u8f93\u5165\u5e93\u3002 \u5e27\u7387\uff08Frames Per Second\uff0cFPS\uff09\uff1a \u4ee5\u5e27\u79f0\u4e3a\u5355\u4f4d\u7684\u4f4d\u56fe\u56fe\u50cf\u8fde\u7eed\u51fa\u73b0\u5728\u663e\u793a\u5668\u4e0a\u7684\u9891\u7387\uff08\u901f\u7387\uff09\uff0c\u5355\u4f4d\u4e3aHz\u6216FPS\uff0c\u901a\u4fd7\u6765\u8bb2\u5c31\u662f\u6bcf\u79d2\u51fa\u73b0\u5728\u5c4f\u5e55\u4e0a\u7684\u753b\u9762\u6570\u3002 \u5b9a\u957f\u6e38\u620f\u5faa\u73af\uff08Fixed Step Game Loop\uff09\uff1a \u4ee5\u56fa\u5b9a\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u7684\u6e38\u620f\u5faa\u73af\u3002 \u5782\u76f4\u540c\u6b65\uff08Vertical Synchronization\uff09\uff1a \u907f\u514d\u56e0\u4e3a\u6e38\u620f\u8fd0\u884c\u901f\u5ea6\u8fc7\u5feb\u5bfc\u81f4\u7684\u753b\u9762\u6495\u88c2\u73b0\u8c61\u3002 \u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\uff1a \u53c8\u79f0 \u6e32\u67d3\u7ba1\u7ebf\uff08Rendering Pipeline\uff09 \uff0c\u662f\u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u3002 \u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\uff1a \u56fa\u5b9a\u7ba1\u7ebf\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\uff1a \u53ef\u7f16\u7a0b\u7ba1\u7ebf\u4f7f\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002 \u7740\u8272\u5668\uff08Shader\uff09\uff1a \u7528\u4e8e\u63a7\u5236\u56fe\u5f62\u7ba1\u7ebf\u4e0d\u540c\u9636\u6bb5\u7684\u7279\u5b9a\u7a0b\u5e8f\u3002 \u9876\u70b9\uff08Vertex\uff09\uff1a \u7528\u4e8e\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002 \u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\uff1a \u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002 \u4e09\u89d2\u5f62\uff08Triangle\uff09\uff1a \u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\u4e4b\u4e00\uff0c\u6700\u7b80\u5355\u7684\u4e8c\u7ef4\u51e0\u4f55\u5f62\u72b6\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u751f\u6210\u7684\u4e09\u89d2\u5f62\u526a\u8f91\u5e76\u5c06\u5176\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u7247\u5143\uff08Fragment\uff09\uff1a \u7ec4\u6210\u5e27\u7684\u6700\u5c0f\u5355\u4f4d\uff0c\u901a\u5e38\u76f8\u5f53\u4e8e\u4e00\u4e2a\u50cf\u7d20\u7684\u5927\u5c0f\uff0c\u53ef\u8ba4\u4e3a\u5176\u5373\u662f\u50cf\u7d20\uff08Pixel\uff09\u3002 \u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u56fe\u5f62\u7ba1\u7ebf\u7684\u8f93\u51fa\uff0c\u7531\u591a\u4e2a\u50cf\u7d20\u7ec4\u6210\u7684\u6570\u636e\u7ed3\u6784\u3002 OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\uff1a \u7528\u4e8e\u7f16\u5199OpenGL\u7740\u8272\u5668\u7684\u7c7bC\u8bed\u8a00\u3002 \u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\uff1a \u9f50\u6b21\u5750\u6807\u5c31\u662f\u5c06\u4e00\u4e2a\u539f\u672c\u662fn\u7ef4\u7684\u5411\u91cf\u7528\u4e00\u4e2an+1\u7ef4\u5411\u91cf\u6765\u8868\u793a\u3002 \u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\uff1a \u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u6216\u5176\u4ed6\u6570\u636e\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\u7684\u5bf9\u8c61\uff0c\u4fbf\u4e8e\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u50a8\u5b58\u7684\u6570\u636e\u3002 \u56db\u8fb9\u5f62\uff08Quad\uff09\uff1a \u53ef\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u7531\u56db\u4e2a\u9876\u70b9\u7ec4\u6210\u3002 \u7f51\u683c\uff08Mesh\uff09\uff1a \u6e38\u620f\u5f00\u53d1\u4e2d\u5e38\u89c1\u6982\u5ff5\u4e4b\u4e00\uff0c\u901a\u5e38\u7528\u4e8e\u5305\u88c5\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\uff0c\u50a8\u5b58\u6a21\u578b\u7684\u4f4d\u7f6e\u3001\u9876\u70b9\u7d22\u5f15\u3001\u989c\u8272\u7b49\u6570\u636e\u3002 \u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\uff1a \u7528\u4e8e\u6307\u5b9a\u9876\u70b9\u7ed8\u5236\u987a\u5e8f\u7684\u7f13\u51b2\u533a\u3002 \u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\uff1a \u5c06\u9876\u70b9\u4ece\u4e09\u7ef4\u4e16\u754c\u7a7a\u95f4\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u7684\u77e9\u9635\u3002 \u622a\u9525\u4f53\uff08Frustum\uff09\uff1a \u4e09\u7ef4\u51e0\u4f55\u4f53\u7684\u4e00\u79cd\uff0c\u53c8\u79f0\u4e3a\u68f1\u53f0\u3002\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u4e3a\u56db\u68f1\u53f0\u3002 \u77e9\u9635\uff08Matrix\uff09\uff1a \u77e9\u9635\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\uff0c\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u7528\u4e8e\u53d8\u6362\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u3002 \u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\uff1a \u9ad8\u5ea6\u4e0e\u5bbd\u5ea6\u4e4b\u6bd4\u3002 JOML\uff08Java OpenGL Math Library\uff09\uff1a Java OpenGL \u6570\u5b66\u5e93\uff0c\u63d0\u4f9b\u4e86\u5bf9OpenGL\u7684\u4e00\u7cfb\u5217\u5e38\u7528\u6570\u5b66\u5b9e\u4f53\u7684\u5c01\u88c5\u3002 Uniform\uff1a Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\u3002 \u4f4d\u79fb\uff08Translation\uff09\uff1a \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09\uff1a \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09\uff1a \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u53d8\u6362\uff08Transformation\uff09\uff1a \u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4e09\u8005\u7684\u7edf\u79f0\u3002 \u4e16\u754c\u77e9\u9635\uff08World Matrix\uff09\uff1a \u5c06\u7269\u4f53\u6216\u6a21\u578b\u4ece\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u7a7a\u95f4\u7684\u77e9\u9635\uff0c\u7531\u4f4d\u79fb\u77e9\u9635\u3001\u65cb\u8f6c\u77e9\u9635\u548c\u7f29\u653e\u77e9\u9635\u76f8\u4e58\u6240\u5f97\u3002 \u4f4d\u79fb\u77e9\u9635\uff08Translation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u4f4d\u79fb\u53d8\u6362\u7684\u77e9\u9635\u3002 \u65cb\u8f6c\u77e9\u9635\uff08Rotation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u65cb\u8f6c\u53d8\u6362\u7684\u77e9\u9635\u3002 \u7f29\u653e\u77e9\u9635\uff08Scale Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u7f29\u653e\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\uff1a \u5bf9\u7247\u5143\u8fdb\u884c\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u4e22\u5f03\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u7247\u5143\u3002 \u7eb9\u7406\uff08Texture\uff09\uff1a \u7528\u4e8e\u7ed8\u5236\u6a21\u578b\u7684\u50cf\u7d20\u7684\u56fe\u50cf\u3002 \u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\uff1a \u5bf9\u4e8e\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u50cf\u7d20\uff0c\u5c06\u4f7f\u7528\u7ec6\u8282\u8f83\u4f4e\u7684\u7eb9\u7406\u8fdb\u884c\u7ed8\u5236\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u53ef\u89e3\u51b3\u7531\u4e8e\u8ddd\u79bb\u95ee\u9898\u800c\u5bfc\u81f4\u7684\u8fdc\u5904\u50cf\u7d20\u95ea\u70c1\u95ee\u9898\u3002 \u7eb9\u7406\u5750\u6807\uff08Texture Coordinate\uff09\uff1a \u901a\u5e38\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\uff0c\u7528\u4e8e\u6307\u5b9a\u7247\u5143\u5728\u7eb9\u7406\u4e0a\u7684\u4f4d\u7f6e\u3002 \u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u7eb9\u7406\u7684\u7a7a\u95f4\u3002 \u53d6\u6837\u5668\uff08Sampler\uff09\uff1a Uniform\u7c7b\u578b\u4e4b\u4e00\uff0c\u7528\u4e8e\u6307\u5b9a\u88ab\u53d6\u6837\u7684\u7eb9\u7406\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a OpenGL\u529f\u80fd\u4e4b\u4e00\uff0c\u7528\u4e8e\u6e32\u67d3\u900f\u660e\u6216\u534a\u900f\u660e\u7269\u4f53\uff0c\u5c06\u5176\u7247\u5143\u4e0e\u5176\u540e\u7247\u5143\u7684\u989c\u8272\u8fdb\u884c\u6df7\u5408\u3002 \u6444\u50cf\u673a\uff08Camera\uff09\uff1a \u7528\u4e8e\u81ea\u7531\u89c2\u5bdf\u4e09\u7ef4\u4e16\u754c\u7684\u529f\u80fd\u3002OpenGL\u4e2d\u4e0d\u5b58\u5728\u6b64\u529f\u80fd\u548c\u6982\u5ff5\uff0c\u79fb\u52a8\u6444\u50cf\u673a\u5b9e\u9645\u4e0a\u662f\u5c06\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u5411\u76f8\u53cd\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u7ffb\u6eda\uff08Roll\uff09\uff1a \u6b27\u62c9\u89d2\uff08Euler Angles\uff09\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7eb5\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u4fef\u4ef0\uff08Pitch\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u6a2a\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u504f\u822a\uff08Yaw\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7ad6\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\uff1a \u7528\u4e8e\u5c06\u9876\u70b9\u5411\u6444\u50cf\u673a\u6240\u5728\u4f4d\u7f6e\u7684\u76f8\u53cd\u65b9\u5411\u548c\u65cb\u8f6c\u72b6\u6001\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\uff1a \u662f\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\uff0c\u53ef\u5c06\u6a21\u578b\u7a7a\u95f4\u7684\u5750\u6807\u53d8\u6362\u5230\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\uff0c\u7528\u4e8e\u7b80\u5316\u8ba1\u7b97\u3002 OBJ\uff08.obj\uff09\uff1a Wavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002 \u6cd5\u7ebf\uff08Normal\uff09\uff1a \u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u5411\u91cf\u3002 \u5f52\u4e00\u5316\uff08Normalize\uff09\uff1a \u4f7f\u5411\u91cf\u7684\u957f\u5ea6\uff08\u6216\u6a21\u957f\uff09\u4e3a1\u3002 \u9876\u70b9\u6cd5\u7ebf\uff08Vertex Normal\uff09\uff1a \u4e00\u4e2a\u9876\u70b9\u7684\u6cd5\u7ebf\u662f\u5176\u53c2\u4e0e\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u7684\u9762\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff0c\u5176\u957f\u5ea6\u4ecd\u4e3a1\u3002 \u70b9\u5149\u6e90\uff08Point Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09\uff1a \u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09\uff1a \u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09\uff1a \u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 HUD\uff08Heads-Up Display\uff09\uff1a \u5e73\u89c6\u663e\u793a\u5668\uff0c\u5e38\u7528\u4e8e\u98de\u673a\u4e0a\u5c06\u91cd\u8981\u4fe1\u606f\u6295\u5f71\u4e8e\u6321\u98ce\u73bb\u7483\u6216\u5934\u76d4\u4e0a\uff0c\u4ee5\u4fbf\u98de\u884c\u5458\u540c\u65f6\u67e5\u770b\u524d\u65b9\u60c5\u51b5\u548c\u98de\u884c\u4fe1\u606f\u3002\u73b0\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u5c06\u6e38\u620f\u4e2d\u7684\u91cd\u8981\u4fe1\u606f\u663e\u793a\u4e8e\u4e09\u7ef4\u573a\u666f\u524d\u3002 \u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff0cOrthogonal Projection\uff09\uff1a \u4e5f\u79f0\u4e3a\u6b63\u6295\u5f71\uff0c\u6b63\u5c04\u6295\u5f71\u3002\u6307\u4e0d\u53d7\u8fd1\u5927\u8fdc\u5c0f\u5f71\u54cd\u7684\u5c06\u4e09\u7ef4\u7269\u4f53\u6295\u5f71\u5230\u4e8c\u7ef4\u5e73\u9762\u4e0a\u7684\u6295\u5f71\u65b9\u5f0f\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a \u5b9e\u73b03D\u6e32\u67d3\u4e2d\u7269\u4f53\u900f\u660e\u7684\u4e00\u4e2a\u529f\u80fd\uff0c\u542f\u7528\u900f\u660e\u5c06\u5141\u8bb8\u4f7f\u7528Alpha\u5206\u91cf\u6df7\u5408\u989c\u8272\u3002 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\uff1a \u5305\u88f93D\u573a\u666f\u5e76\u4ee5\u6444\u50cf\u673a\u4f4d\u7f6e\u4e3a\u539f\u70b9\u7684\u5de8\u5927\u7acb\u65b9\u4f53\uff0c\u5c06\u7eb9\u7406\u6e32\u67d3\u5728\u8be5\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4ee5\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff1a \u5c06\u7eb9\u7406\u5206\u4e3a\u516d\u4e2a\u90e8\u5206\uff0c\u5c06\u5404\u90e8\u5206\u6620\u5c04\u5230\u7acb\u65b9\u4f53\u4e0a\u3002 \u9762\u5254\u9664\uff08Face Culling\uff09\uff1a \u5254\u9664\u65e0\u7528\u6216\u770b\u4e0d\u5230\u7684\u9762\uff0c\u4ee5\u63d0\u5347\u6027\u80fd\u7684OpenGL\u529f\u80fd\u3002","title":"\u672f\u8bed\u8868"},{"location":"glossary/#_1","text":"\u672c\u4e66\u672f\u8bed\u8868\u6309\u672f\u8bed\u9996\u6b21\u4ecb\u7ecd\u7ae0\u8282\u6392\u5e8f\u3002 Java\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93\uff08Lightweight Java Game Library\uff0cLWJGL\uff09\uff1a OpenGL\u3001OpenCL\u3001OpenAL\u548cVulkan\u5bf9Java\u5e73\u53f0\u7684\u539f\u751f\u7ed1\u5b9a\uff0c\u5e38\u7528\u4e8e\u5f00\u53d1\u6e38\u620f\u3002 GLFW\uff1a \u4e3aOpenGL\u3001OpenGL ES\u548cVulkan\u63d0\u4f9b\u7684\u8de8\u5e73\u53f0\u7a97\u53e3\u4e0e\u8f93\u5165\u5e93\u3002 \u5e27\u7387\uff08Frames Per Second\uff0cFPS\uff09\uff1a \u4ee5\u5e27\u79f0\u4e3a\u5355\u4f4d\u7684\u4f4d\u56fe\u56fe\u50cf\u8fde\u7eed\u51fa\u73b0\u5728\u663e\u793a\u5668\u4e0a\u7684\u9891\u7387\uff08\u901f\u7387\uff09\uff0c\u5355\u4f4d\u4e3aHz\u6216FPS\uff0c\u901a\u4fd7\u6765\u8bb2\u5c31\u662f\u6bcf\u79d2\u51fa\u73b0\u5728\u5c4f\u5e55\u4e0a\u7684\u753b\u9762\u6570\u3002 \u5b9a\u957f\u6e38\u620f\u5faa\u73af\uff08Fixed Step Game Loop\uff09\uff1a \u4ee5\u56fa\u5b9a\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u7684\u6e38\u620f\u5faa\u73af\u3002 \u5782\u76f4\u540c\u6b65\uff08Vertical Synchronization\uff09\uff1a \u907f\u514d\u56e0\u4e3a\u6e38\u620f\u8fd0\u884c\u901f\u5ea6\u8fc7\u5feb\u5bfc\u81f4\u7684\u753b\u9762\u6495\u88c2\u73b0\u8c61\u3002 \u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\uff1a \u53c8\u79f0 \u6e32\u67d3\u7ba1\u7ebf\uff08Rendering Pipeline\uff09 \uff0c\u662f\u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u3002 \u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\uff1a \u56fa\u5b9a\u7ba1\u7ebf\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\uff1a \u53ef\u7f16\u7a0b\u7ba1\u7ebf\u4f7f\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002 \u7740\u8272\u5668\uff08Shader\uff09\uff1a \u7528\u4e8e\u63a7\u5236\u56fe\u5f62\u7ba1\u7ebf\u4e0d\u540c\u9636\u6bb5\u7684\u7279\u5b9a\u7a0b\u5e8f\u3002 \u9876\u70b9\uff08Vertex\uff09\uff1a \u7528\u4e8e\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002 \u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\uff1a \u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002 \u4e09\u89d2\u5f62\uff08Triangle\uff09\uff1a \u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\u4e4b\u4e00\uff0c\u6700\u7b80\u5355\u7684\u4e8c\u7ef4\u51e0\u4f55\u5f62\u72b6\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u751f\u6210\u7684\u4e09\u89d2\u5f62\u526a\u8f91\u5e76\u5c06\u5176\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u7247\u5143\uff08Fragment\uff09\uff1a \u7ec4\u6210\u5e27\u7684\u6700\u5c0f\u5355\u4f4d\uff0c\u901a\u5e38\u76f8\u5f53\u4e8e\u4e00\u4e2a\u50cf\u7d20\u7684\u5927\u5c0f\uff0c\u53ef\u8ba4\u4e3a\u5176\u5373\u662f\u50cf\u7d20\uff08Pixel\uff09\u3002 \u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u56fe\u5f62\u7ba1\u7ebf\u7684\u8f93\u51fa\uff0c\u7531\u591a\u4e2a\u50cf\u7d20\u7ec4\u6210\u7684\u6570\u636e\u7ed3\u6784\u3002 OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\uff1a \u7528\u4e8e\u7f16\u5199OpenGL\u7740\u8272\u5668\u7684\u7c7bC\u8bed\u8a00\u3002 \u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\uff1a \u9f50\u6b21\u5750\u6807\u5c31\u662f\u5c06\u4e00\u4e2a\u539f\u672c\u662fn\u7ef4\u7684\u5411\u91cf\u7528\u4e00\u4e2an+1\u7ef4\u5411\u91cf\u6765\u8868\u793a\u3002 \u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\uff1a \u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u6216\u5176\u4ed6\u6570\u636e\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\u7684\u5bf9\u8c61\uff0c\u4fbf\u4e8e\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u50a8\u5b58\u7684\u6570\u636e\u3002 \u56db\u8fb9\u5f62\uff08Quad\uff09\uff1a \u53ef\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u7531\u56db\u4e2a\u9876\u70b9\u7ec4\u6210\u3002 \u7f51\u683c\uff08Mesh\uff09\uff1a \u6e38\u620f\u5f00\u53d1\u4e2d\u5e38\u89c1\u6982\u5ff5\u4e4b\u4e00\uff0c\u901a\u5e38\u7528\u4e8e\u5305\u88c5\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\uff0c\u50a8\u5b58\u6a21\u578b\u7684\u4f4d\u7f6e\u3001\u9876\u70b9\u7d22\u5f15\u3001\u989c\u8272\u7b49\u6570\u636e\u3002 \u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\uff1a \u7528\u4e8e\u6307\u5b9a\u9876\u70b9\u7ed8\u5236\u987a\u5e8f\u7684\u7f13\u51b2\u533a\u3002 \u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\uff1a \u5c06\u9876\u70b9\u4ece\u4e09\u7ef4\u4e16\u754c\u7a7a\u95f4\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u7684\u77e9\u9635\u3002 \u622a\u9525\u4f53\uff08Frustum\uff09\uff1a \u4e09\u7ef4\u51e0\u4f55\u4f53\u7684\u4e00\u79cd\uff0c\u53c8\u79f0\u4e3a\u68f1\u53f0\u3002\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u4e3a\u56db\u68f1\u53f0\u3002 \u77e9\u9635\uff08Matrix\uff09\uff1a \u77e9\u9635\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\uff0c\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u7528\u4e8e\u53d8\u6362\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u3002 \u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\uff1a \u9ad8\u5ea6\u4e0e\u5bbd\u5ea6\u4e4b\u6bd4\u3002 JOML\uff08Java OpenGL Math Library\uff09\uff1a Java OpenGL \u6570\u5b66\u5e93\uff0c\u63d0\u4f9b\u4e86\u5bf9OpenGL\u7684\u4e00\u7cfb\u5217\u5e38\u7528\u6570\u5b66\u5b9e\u4f53\u7684\u5c01\u88c5\u3002 Uniform\uff1a Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\u3002 \u4f4d\u79fb\uff08Translation\uff09\uff1a \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09\uff1a \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09\uff1a \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u53d8\u6362\uff08Transformation\uff09\uff1a \u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4e09\u8005\u7684\u7edf\u79f0\u3002 \u4e16\u754c\u77e9\u9635\uff08World Matrix\uff09\uff1a \u5c06\u7269\u4f53\u6216\u6a21\u578b\u4ece\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u7a7a\u95f4\u7684\u77e9\u9635\uff0c\u7531\u4f4d\u79fb\u77e9\u9635\u3001\u65cb\u8f6c\u77e9\u9635\u548c\u7f29\u653e\u77e9\u9635\u76f8\u4e58\u6240\u5f97\u3002 \u4f4d\u79fb\u77e9\u9635\uff08Translation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u4f4d\u79fb\u53d8\u6362\u7684\u77e9\u9635\u3002 \u65cb\u8f6c\u77e9\u9635\uff08Rotation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u65cb\u8f6c\u53d8\u6362\u7684\u77e9\u9635\u3002 \u7f29\u653e\u77e9\u9635\uff08Scale Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u7f29\u653e\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\uff1a \u5bf9\u7247\u5143\u8fdb\u884c\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u4e22\u5f03\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u7247\u5143\u3002 \u7eb9\u7406\uff08Texture\uff09\uff1a \u7528\u4e8e\u7ed8\u5236\u6a21\u578b\u7684\u50cf\u7d20\u7684\u56fe\u50cf\u3002 \u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\uff1a \u5bf9\u4e8e\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u50cf\u7d20\uff0c\u5c06\u4f7f\u7528\u7ec6\u8282\u8f83\u4f4e\u7684\u7eb9\u7406\u8fdb\u884c\u7ed8\u5236\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u53ef\u89e3\u51b3\u7531\u4e8e\u8ddd\u79bb\u95ee\u9898\u800c\u5bfc\u81f4\u7684\u8fdc\u5904\u50cf\u7d20\u95ea\u70c1\u95ee\u9898\u3002 \u7eb9\u7406\u5750\u6807\uff08Texture Coordinate\uff09\uff1a \u901a\u5e38\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\uff0c\u7528\u4e8e\u6307\u5b9a\u7247\u5143\u5728\u7eb9\u7406\u4e0a\u7684\u4f4d\u7f6e\u3002 \u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u7eb9\u7406\u7684\u7a7a\u95f4\u3002 \u53d6\u6837\u5668\uff08Sampler\uff09\uff1a Uniform\u7c7b\u578b\u4e4b\u4e00\uff0c\u7528\u4e8e\u6307\u5b9a\u88ab\u53d6\u6837\u7684\u7eb9\u7406\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a OpenGL\u529f\u80fd\u4e4b\u4e00\uff0c\u7528\u4e8e\u6e32\u67d3\u900f\u660e\u6216\u534a\u900f\u660e\u7269\u4f53\uff0c\u5c06\u5176\u7247\u5143\u4e0e\u5176\u540e\u7247\u5143\u7684\u989c\u8272\u8fdb\u884c\u6df7\u5408\u3002 \u6444\u50cf\u673a\uff08Camera\uff09\uff1a \u7528\u4e8e\u81ea\u7531\u89c2\u5bdf\u4e09\u7ef4\u4e16\u754c\u7684\u529f\u80fd\u3002OpenGL\u4e2d\u4e0d\u5b58\u5728\u6b64\u529f\u80fd\u548c\u6982\u5ff5\uff0c\u79fb\u52a8\u6444\u50cf\u673a\u5b9e\u9645\u4e0a\u662f\u5c06\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u5411\u76f8\u53cd\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u7ffb\u6eda\uff08Roll\uff09\uff1a \u6b27\u62c9\u89d2\uff08Euler Angles\uff09\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7eb5\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u4fef\u4ef0\uff08Pitch\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u6a2a\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u504f\u822a\uff08Yaw\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7ad6\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\uff1a \u7528\u4e8e\u5c06\u9876\u70b9\u5411\u6444\u50cf\u673a\u6240\u5728\u4f4d\u7f6e\u7684\u76f8\u53cd\u65b9\u5411\u548c\u65cb\u8f6c\u72b6\u6001\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\uff1a \u662f\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\uff0c\u53ef\u5c06\u6a21\u578b\u7a7a\u95f4\u7684\u5750\u6807\u53d8\u6362\u5230\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\uff0c\u7528\u4e8e\u7b80\u5316\u8ba1\u7b97\u3002 OBJ\uff08.obj\uff09\uff1a Wavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002 \u6cd5\u7ebf\uff08Normal\uff09\uff1a \u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u5411\u91cf\u3002 \u5f52\u4e00\u5316\uff08Normalize\uff09\uff1a \u4f7f\u5411\u91cf\u7684\u957f\u5ea6\uff08\u6216\u6a21\u957f\uff09\u4e3a1\u3002 \u9876\u70b9\u6cd5\u7ebf\uff08Vertex Normal\uff09\uff1a \u4e00\u4e2a\u9876\u70b9\u7684\u6cd5\u7ebf\u662f\u5176\u53c2\u4e0e\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u7684\u9762\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff0c\u5176\u957f\u5ea6\u4ecd\u4e3a1\u3002 \u70b9\u5149\u6e90\uff08Point Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09\uff1a \u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09\uff1a \u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09\uff1a \u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 HUD\uff08Heads-Up Display\uff09\uff1a \u5e73\u89c6\u663e\u793a\u5668\uff0c\u5e38\u7528\u4e8e\u98de\u673a\u4e0a\u5c06\u91cd\u8981\u4fe1\u606f\u6295\u5f71\u4e8e\u6321\u98ce\u73bb\u7483\u6216\u5934\u76d4\u4e0a\uff0c\u4ee5\u4fbf\u98de\u884c\u5458\u540c\u65f6\u67e5\u770b\u524d\u65b9\u60c5\u51b5\u548c\u98de\u884c\u4fe1\u606f\u3002\u73b0\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u5c06\u6e38\u620f\u4e2d\u7684\u91cd\u8981\u4fe1\u606f\u663e\u793a\u4e8e\u4e09\u7ef4\u573a\u666f\u524d\u3002 \u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff0cOrthogonal Projection\uff09\uff1a \u4e5f\u79f0\u4e3a\u6b63\u6295\u5f71\uff0c\u6b63\u5c04\u6295\u5f71\u3002\u6307\u4e0d\u53d7\u8fd1\u5927\u8fdc\u5c0f\u5f71\u54cd\u7684\u5c06\u4e09\u7ef4\u7269\u4f53\u6295\u5f71\u5230\u4e8c\u7ef4\u5e73\u9762\u4e0a\u7684\u6295\u5f71\u65b9\u5f0f\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a \u5b9e\u73b03D\u6e32\u67d3\u4e2d\u7269\u4f53\u900f\u660e\u7684\u4e00\u4e2a\u529f\u80fd\uff0c\u542f\u7528\u900f\u660e\u5c06\u5141\u8bb8\u4f7f\u7528Alpha\u5206\u91cf\u6df7\u5408\u989c\u8272\u3002 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\uff1a \u5305\u88f93D\u573a\u666f\u5e76\u4ee5\u6444\u50cf\u673a\u4f4d\u7f6e\u4e3a\u539f\u70b9\u7684\u5de8\u5927\u7acb\u65b9\u4f53\uff0c\u5c06\u7eb9\u7406\u6e32\u67d3\u5728\u8be5\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4ee5\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff1a \u5c06\u7eb9\u7406\u5206\u4e3a\u516d\u4e2a\u90e8\u5206\uff0c\u5c06\u5404\u90e8\u5206\u6620\u5c04\u5230\u7acb\u65b9\u4f53\u4e0a\u3002 \u9762\u5254\u9664\uff08Face Culling\uff09\uff1a \u5254\u9664\u65e0\u7528\u6216\u770b\u4e0d\u5230\u7684\u9762\uff0c\u4ee5\u63d0\u5347\u6027\u80fd\u7684OpenGL\u529f\u80fd\u3002","title":"\u672f\u8bed\u8868"}]}
\ No newline at end of file
+{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1 \u672c\u4e66\u539f\u4ecb\u7ecd \u8fd9\u672c\u5728\u7ebf\u7535\u5b50\u4e66\u4e3b\u8981\u8bb2\u89e3\u4f7f\u7528LWJGL 3\u5e93\u5f00\u53d13D\u6e38\u620f\u3002 LWJGL\u662f\u4e00\u4e2aJava\u5e93\uff0c\u63d0\u4f9b\u4e86\u8bbf\u95eeOpenGL\u3001OpenAL\u548cOpenCL\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u5e93\u53ef\u4ee5\u5728\u4f7f\u7528\u9ad8\u6027\u80fd\u7684OpenGL\u7684\u540c\u65f6\uff0c\u4f7f\u7528Java\u8bed\u8a00\u5f00\u53d1\u3002 \u6211\u6700\u521d\u7684\u76ee\u6807\u662f\u5b66\u4e60\u4f7f\u7528OpenGL\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u6280\u672f\u3002\u6240\u9700\u8d44\u6599\u90fd\u53ef\u5728\u7f51\u4e0a\u627e\u5230\uff0c\u4f46\u662f\u6ca1\u6709\u4eba\u5c06\u5176\u6574\u7406\uff0c\u6709\u65f6\u5f88\u96be\u627e\u5230\uff0c\u751a\u81f3\u6709\u4e9b\u8d44\u6599\u4e0d\u5b8c\u6574\u6216\u5b58\u5728\u8bef\u5bfc\u3002 \u6211\u5f00\u59cb\u6536\u96c6\u4e00\u4e9b\u8d44\u6599\uff0c\u7f16\u5199\u4e00\u4e9b\u793a\u4f8b\uff0c\u5e76\u51b3\u5b9a\u4ee5\u7535\u5b50\u4e66\u7684\u5f62\u5f0f\u6574\u7406\u8fd9\u4e9b\u8d44\u6599\u3002 \u6e90\u4ee3\u7801 \u672c\u4e66\u4e2d\u6240\u6709\u7684\u6e90\u7801\u793a\u4f8b\u5747\u4e0a\u4f20\u81f3 GitHub . \u672c\u4e66\u82f1\u6587\u539f\u6587\u5730\u5740 GitBook GitHub . \u8bb8\u53ef\u8bc1 \u672c\u4f5c\u54c1\u91c7\u7528 \u77e5\u8bc6\u5171\u4eab\u7f72\u540d-\u76f8\u540c\u65b9\u5f0f\u5171\u4eab 4.0 \u56fd\u9645\u8bb8\u53ef\u534f\u8bae \u8fdb\u884c\u8bb8\u53ef\u3002 \u6240\u6709\u7684\u6e90\u4ee3\u7801\u7684\u8bb8\u53ef\u534f\u8bae\u5747\u4e3a Apache v2.0 \u539f\u4f5c\u8005 Antonio Hern\u00e1ndez Bejarano \u652f\u6301\u4f5c\u8005 \u5982\u679c\u4f60\u559c\u6b22\u8fd9\u672c\u4e66\uff0c\u8bf7Star\u5e76\u4e14\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u4f5c\u8005\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u6309\u94ae\u6350\u52a9\uff1a \u7279\u522b\u611f\u8c22 \u611f\u8c22\u6240\u6709\u63d0\u4f9b\u4e86\u6307\u6b63\u3001\u610f\u89c1\u548c\u5efa\u8bae\u7684\u8bfb\u8005\u3002 \u8bd1\u8005\u7684\u8bdd \u672c\u4e66\u662f\u8bd1\u8005\u4e3a\u4e86\u5b66\u4e60LWJGL3\u548cOpenGL\u800c\u7ffb\u8bd1\u7684\u3002\u9650\u4e8e\u8bd1\u8005\u7684\u80fd\u529b\uff0c\u672c\u8bd1\u672c\u4e2d\u5982\u6709\u4e0d\u59a5\u4e4b\u5904\u6b22\u8fce\u5404\u4f4d\u8bfb\u8005\u6307\u6b63\u3002 \u5982\u679c\u4f60\u559c\u6b22\u672c\u8bd1\u672c\uff0c\u8bf7Star\u5e76\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u8bd1\u8005\uff0c\u8bf7\u901a\u8fc7\u4e0b\u9762\u7684\u94fe\u63a5\u6350\u52a9\uff1a \u7231\u53d1\u7535 \u3002","title":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1"},{"location":"#lwjgl-33d3d-game-development-with-lwjgl-3","text":"","title":"\u300a\u7528LWJGL 3\u5f00\u53d13D\u6e38\u620f(3D Game Development with LWJGL 3)\u300b\u4e2d\u6587\u7ffb\u8bd1"},{"location":"#_1","text":"\u8fd9\u672c\u5728\u7ebf\u7535\u5b50\u4e66\u4e3b\u8981\u8bb2\u89e3\u4f7f\u7528LWJGL 3\u5e93\u5f00\u53d13D\u6e38\u620f\u3002 LWJGL\u662f\u4e00\u4e2aJava\u5e93\uff0c\u63d0\u4f9b\u4e86\u8bbf\u95eeOpenGL\u3001OpenAL\u548cOpenCL\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u5e93\u53ef\u4ee5\u5728\u4f7f\u7528\u9ad8\u6027\u80fd\u7684OpenGL\u7684\u540c\u65f6\uff0c\u4f7f\u7528Java\u8bed\u8a00\u5f00\u53d1\u3002 \u6211\u6700\u521d\u7684\u76ee\u6807\u662f\u5b66\u4e60\u4f7f\u7528OpenGL\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u6280\u672f\u3002\u6240\u9700\u8d44\u6599\u90fd\u53ef\u5728\u7f51\u4e0a\u627e\u5230\uff0c\u4f46\u662f\u6ca1\u6709\u4eba\u5c06\u5176\u6574\u7406\uff0c\u6709\u65f6\u5f88\u96be\u627e\u5230\uff0c\u751a\u81f3\u6709\u4e9b\u8d44\u6599\u4e0d\u5b8c\u6574\u6216\u5b58\u5728\u8bef\u5bfc\u3002 \u6211\u5f00\u59cb\u6536\u96c6\u4e00\u4e9b\u8d44\u6599\uff0c\u7f16\u5199\u4e00\u4e9b\u793a\u4f8b\uff0c\u5e76\u51b3\u5b9a\u4ee5\u7535\u5b50\u4e66\u7684\u5f62\u5f0f\u6574\u7406\u8fd9\u4e9b\u8d44\u6599\u3002","title":"\u672c\u4e66\u539f\u4ecb\u7ecd"},{"location":"#_2","text":"\u672c\u4e66\u4e2d\u6240\u6709\u7684\u6e90\u7801\u793a\u4f8b\u5747\u4e0a\u4f20\u81f3 GitHub . \u672c\u4e66\u82f1\u6587\u539f\u6587\u5730\u5740 GitBook GitHub .","title":"\u6e90\u4ee3\u7801"},{"location":"#_3","text":"\u672c\u4f5c\u54c1\u91c7\u7528 \u77e5\u8bc6\u5171\u4eab\u7f72\u540d-\u76f8\u540c\u65b9\u5f0f\u5171\u4eab 4.0 \u56fd\u9645\u8bb8\u53ef\u534f\u8bae \u8fdb\u884c\u8bb8\u53ef\u3002 \u6240\u6709\u7684\u6e90\u4ee3\u7801\u7684\u8bb8\u53ef\u534f\u8bae\u5747\u4e3a Apache v2.0","title":"\u8bb8\u53ef\u8bc1"},{"location":"#_4","text":"Antonio Hern\u00e1ndez Bejarano","title":"\u539f\u4f5c\u8005"},{"location":"#_5","text":"\u5982\u679c\u4f60\u559c\u6b22\u8fd9\u672c\u4e66\uff0c\u8bf7Star\u5e76\u4e14\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u4f5c\u8005\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u4e0b\u9762\u7684\u6309\u94ae\u6350\u52a9\uff1a","title":"\u652f\u6301\u4f5c\u8005"},{"location":"#_6","text":"\u611f\u8c22\u6240\u6709\u63d0\u4f9b\u4e86\u6307\u6b63\u3001\u610f\u89c1\u548c\u5efa\u8bae\u7684\u8bfb\u8005\u3002","title":"\u7279\u522b\u611f\u8c22"},{"location":"#_7","text":"\u672c\u4e66\u662f\u8bd1\u8005\u4e3a\u4e86\u5b66\u4e60LWJGL3\u548cOpenGL\u800c\u7ffb\u8bd1\u7684\u3002\u9650\u4e8e\u8bd1\u8005\u7684\u80fd\u529b\uff0c\u672c\u8bd1\u672c\u4e2d\u5982\u6709\u4e0d\u59a5\u4e4b\u5904\u6b22\u8fce\u5404\u4f4d\u8bfb\u8005\u6307\u6b63\u3002 \u5982\u679c\u4f60\u559c\u6b22\u672c\u8bd1\u672c\uff0c\u8bf7Star\u5e76\u5206\u4eab\u5b83\u3002\u5982\u679c\u4f60\u60f3\u6350\u52a9\u8bd1\u8005\uff0c\u8bf7\u901a\u8fc7\u4e0b\u9762\u7684\u94fe\u63a5\u6350\u52a9\uff1a \u7231\u53d1\u7535 \u3002","title":"\u8bd1\u8005\u7684\u8bdd"},{"location":"01-first-steps/","text":"\u4e8b\u524d\u51c6\u5907\uff08First Steps\uff09 \u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u6280\u672f\u3002\u672c\u4e66\u5c06\u4f7f\u7528Java\u8bed\u8a00\u548cJava\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93( LWJGL )\u6765\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002LWJGL\u5e93\u5141\u8bb8\u6211\u4eec\u8bbf\u95ee\u5e95\u5c42\u7684API\uff08\u5e94\u7528\u7a0b\u5e8f\u63a5\u53e3\uff09\uff0c\u4f8b\u5982OpenGL\u3002 LWJGL\u662f\u4e00\u4e2a\u5e95\u5c42\u7684API\uff0c\u5b83\u50cf\u4e00\u4e2aOpenGL\u5305\u88c5\u5e93\u3002\u5982\u679c\u4f60\u662f\u60f3\u5728\u77ed\u65f6\u95f4\u5185\u5f00\u59cb\u5236\u4f5c\u4e00\u4e2a3D\u6e38\u620f\uff0c\u90a3\u4e48\u4f60\u4e5f\u8bb8\u8be5\u8003\u8651\u5176\u5b83\u9009\u62e9\uff0c\u6bd4\u5982\u4f7f\u7528\u5f15\u64ce[JmonkeyEngine]\u3002\u4f7f\u7528LWJGL\u8fd9\u4e2a\u5e95\u5c42API\uff0c\u5728\u4f60\u6536\u5230\u6210\u6548\u4e4b\u524d\uff0c\u9700\u8981\u4e86\u89e3\u8bb8\u591a\u6982\u5ff5\u5e76\u4e14\u7f16\u5199\u5927\u91cf\u7684\u4ee3\u7801\u3002\u8fd9\u6837\u505a\u7684\u597d\u5904\u662f\u4f60\u53ef\u4ee5\u66f4\u597d\u7684\u7406\u89e33D\u56fe\u5f62\u6e32\u67d3\uff0c\u5e76\u4e14\u53ef\u4ee5\u66f4\u597d\u7684\u63a7\u5236\u5b83\u3002 \u5728\u4e0a\u6587\u8bf4\u5230\uff0c\u5728\u672c\u4e66\u4e2d\u6211\u4eec\u5c06\u4f7f\u7528Java\uff0c\u66f4\u786e\u5207\u6765\u8bf4\u6211\u4eec\u5c06\u4f7f\u7528Java 10\u3002\u6240\u4ee5\u4f60\u9700\u8981\u4eceOracle\u7684\u9875\u9762\u4e0b\u8f7d\u5bf9\u5e94\u7248\u672c\u7684JDK\u3002\u8bf7\u9009\u62e9\u9002\u5408\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u7684\u5b89\u88c5\u7a0b\u5e8f\u3002\u672c\u4e66\u5047\u5b9a\u4f60\u5bf9Java\u8bed\u8a00\u6709\u4e00\u5b9a\u7684\u4e86\u89e3\u3002 \u5982\u679c\u4f60\u9700\u8981\u4e00\u4e2a\u53ef\u4ee5\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\u7684Java IDE\uff08\u96c6\u6210\u5f00\u53d1\u73af\u5883\uff09\uff0c\u4f60\u53ef\u4ee5\u4e0b\u8f7d\u4e3aJava 10\u63d0\u4f9b\u826f\u597d\u652f\u6301\u7684IntelliJ IDEA\u3002\u7531\u4e8eJava 10\u4ec5\u652f\u630164\u4f4d\u7684\u5e73\u53f0\uff0c\u8bb0\u5f97\u4e0b\u8f7d64\u4f4d\u7248\u672c\u7684IntelliJ\u3002IntelliJ\u63d0\u4f9b\u6709\u4e00\u4e2a\u514d\u8d39\u4e14\u5f00\u6e90\u7684\u793e\u533a\u7248\uff0c\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83\uff1a https://www.jetbrains.com/idea/download/ \u3002 \u4e3a\u4e86\u6784\u5efa\u793a\u4f8b\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u4f7f\u7528 Maven \u3002Maven\u5df2\u7ecf\u96c6\u6210\u5728\u5927\u591a\u6570IDE\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5728IDE\u4e2d\u76f4\u63a5\u6253\u5f00\u4e0d\u540c\u7ae0\u8282\u7684\u793a\u4f8b\u4ee3\u7801\u3002\u53ea\u8981\u6253\u5f00\u4e86\u793a\u4f8b\u4ee3\u7801\u6240\u5728\u7684\u6587\u4ef6\u5939\uff0cIntelliJ\u5c31\u4f1a\u68c0\u6d4b\u5230\u5b83\u662f\u4e00\u4e2aMaven\u9879\u76ee\u3002 Maven\u57fa\u4e8e\u4e00\u4e2a\u540d\u4e3a pom.xml \uff08Project Object Model\uff0c\u9879\u76ee\u5bf9\u8c61\u6a21\u578b\uff09\u7684XML\u6587\u4ef6\u6765\u6784\u5efa\u9879\u76ee\uff0c\u5b83\u7ba1\u7406\u4e86\u9879\u76ee\u7684\u4f9d\u8d56\uff08\u9700\u8981\u4f7f\u7528\u7684\u5e93\uff09\u548c\u5728\u6784\u5efa\u8fc7\u7a0b\u4e2d\u9700\u8981\u6267\u884c\u7684\u6b65\u9aa4\u3002Maven\u9075\u5faa\u7ea6\u5b9a\u9ad8\u4e8e\u914d\u7f6e\u7684\u539f\u5219\uff0c\u5373\u5982\u679c\u4f60\u9075\u5b88\u6807\u51c6\u7684\u9879\u76ee\u7ed3\u6784\u548c\u547d\u540d\u7ea6\u5b9a\uff0c\u5c31\u4e0d\u9700\u8981\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u660e\u786e\u5730\u58f0\u660e\u6e90\u6587\u4ef6\u5728\u54ea\u91cc\u6216\u8005\u5e94\u8be5\u5728\u54ea\u91cc\u7f16\u8bd1\u7c7b\u3002 \u672c\u4e66\u4e0d\u662f\u4e00\u4e2aMaven\u6559\u7a0b\uff0c\u5982\u679c\u6709\u9700\u8981\uff0c\u8bf7\u5728\u7f51\u4e0a\u641c\u7d22Maven\u7684\u76f8\u5173\u8d44\u6599\u3002\u6e90\u4ee3\u7801\u6587\u4ef6\u5939\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7236\u9879\u76ee\uff0c\u5b83\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u63d2\u4ef6\u5e76\u4e14\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u5e93\u7684\u7248\u672c\u3002 LWJGL 3.1\u5728\u9879\u76ee\u6784\u5efa\u4e0a\u6709\u4e00\u4e9b\u53d8\u5316\u3002\u73b0\u5728\uff0c\u5b83\u53d8\u5f97\u66f4\u52a0\u6a21\u5757\u5316\uff0c\u6211\u4eec\u53ef\u4ee5\u6709\u9009\u62e9\u5730\u4f7f\u7528\u7c7b\u5e93\uff0c\u800c\u4e0d\u662f\u5bfc\u5165\u4e00\u4e2a\u5de8\u5927\u7684Jar\u6587\u4ef6\u3002\u4f46\u8fd9\u662f\u6709\u4ee3\u4ef7\u7684\uff1a\u4f60\u9700\u8981\u4ed4\u7ec6\u5730\u9010\u4e2a\u6307\u5b9a\u4f9d\u8d56\u5173\u7cfb\u3002\u4e0d\u8fc7 LWJGL\u4e0b\u8f7d \u9875\u9762\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4e3a\u60a8\u751f\u6210POM\u6587\u4ef6\u7684\u811a\u672c\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u4f7f\u7528GLFW\u548cOpenGL\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u6211\u4eec\u7684POM\u6587\u4ef6\u3002 LWJGL\u5e73\u53f0\u4f9d\u8d56\u5e93\u5df2\u7ecf\u53ef\u4ee5\u4e3a\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u81ea\u52a8\u89e3\u538b\u672c\u5730\u5e93\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u4f7f\u7528\u5176\u4ed6\u63d2\u4ef6\uff08\u4f8b\u5982 mavennatives \uff09\u3002\u6211\u4eec\u53ea\u9700\u8981\u914d\u7f6e\u4e09\u4e2aProfile\u6765\u8bbe\u7f6eLWJGL\u6240\u5904\u7684\u64cd\u4f5c\u7cfb\u7edf\u3002Profile\u5c06\u4f1a\u4e3aWindows\u3001Linux\u548cMac OS\u7cfb\u5217\u8bbe\u7f6e\u6b63\u786e\u7684\u503c\u3002 <profiles> <profile> <id>windows-profile</id> <activation> <os> <family>Windows</family> </os> </activation> <properties> <native.target>natives-windows</native.target> </properties> </profile> <profile> <id>linux-profile</id> <activation> <os> <family>Linux</family> </os> </activation> <properties> <native.target>natives-linux</native.target> </properties> </profile> <profile> <id>OSX-profile</id> <activation> <os> <family>mac</family> </os> </activation> <properties> <native.target>natives-osx</native.target> </properties> </profile> </profiles> \u5728\u6bcf\u4e2a\u9879\u76ee\u4e2d\uff0cLWJGL\u5e73\u53f0\u4f9d\u8d56\u9879\u5c06\u4f7f\u7528\u914d\u7f6e\u6587\u4ef6\u4e3a\u5f53\u524d\u5e73\u53f0\u8bbe\u7f6e\u7684\u6b63\u786e\u7684\u5c5e\u6027\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-platform</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> </dependency> \u6b64\u5916\uff0c\u6bcf\u4e2a\u9879\u76ee\u53ef\u751f\u6210\u4e00\u4e2a\u53ef\u8fd0\u884c\u7684Jar\uff08\u4e00\u79cd\u53ef\u4ee5\u901a\u8fc7\u8f93\u5165 java -jar name_of_the_jar.jar \u5c31\u53ef\u8fd0\u884c\u7684Jar\uff09\uff0c\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528Maven\u7684 maven-jar-plugin \u63d2\u4ef6\u5b9e\u73b0\u7684\u3002\u8be5\u63d2\u4ef6\u521b\u5efa\u4e86\u4e00\u4e2a\u542b\u6709 MANIFEST.MF \u6587\u4ef6\u7684Jar\uff0c\u5e76\u4e14\u6587\u4ef6\u5185\u6709\u6307\u5b9a\u7684\u503c\uff0c\u8be5\u6587\u4ef6\u6700\u91cd\u8981\u7684\u5c5e\u6027\u5c31\u662f Main-Class \uff0c\u5b83\u6307\u660e\u4e86\u7a0b\u5e8f\u7684\u5165\u53e3\u3002\u6b64\u5916\uff0c\u6240\u6709\u7684\u4f9d\u8d56\u5e93\u90fd\u88ab\u8bbe\u7f6e\u5728\u8be5\u6587\u4ef6\u7684 Class-Path \u5c5e\u6027\u4e2d\u3002\u8981\u5728\u53e6\u4e00\u53f0\u8ba1\u7b97\u673a\u4e0a\u8fd0\u884c\u5b83\uff0c\u4f60\u53ea\u9700\u8981\u590d\u5236\u4f4d\u4e8e\u76ee\u6807\u76ee\u5f55\u4e0b\u7684\u4e3bJar\u6587\u4ef6\u548cLib\u76ee\u5f55\uff08\u5305\u62ec\u5176\u4e2d\u6240\u6709\u7684Jar\u6587\u4ef6\uff09\u3002 Jar\u6587\u4ef6\u50a8\u5b58\u7740LWJGL\u7c7b\u548c\u672c\u5730\u5e93\u3002LWJGL\u8fd8\u5c06\u8d1f\u8d23\u63d0\u53d6\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u6dfb\u52a0\u5230JVM\u7684\u5e93\u8def\u5f84\u4e2d\u3002 \u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u662fLWJGL\u7f51\u7ad9( https://www.lwjgl.org/guide )\u63d0\u4f9b\u7684\u7684\u5165\u95e8\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6ca1\u6709\u4f7f\u7528Swing\u6216JavaFX\u4f5c\u4e3a\u6211\u4eec\u7684GUI\u5e93\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f GLFW \uff0c\u5b83\u662f\u4e00\u4e2a\u7528\u4e8e\u5904\u7406GUI\u7ec4\u4ef6\uff08\u7a97\u53e3\u7b49\uff09\u548c\u4e8b\u4ef6\uff08\u6309\u952e\u6309\u4e0b\u3001\u9f20\u6807\u79fb\u52a8\u7b49\uff09\uff0c\u5e76\u4e14\u4e0eOpenGL\u4e0a\u4e0b\u6587\u8fdb\u884c\u7b80\u5355\u8fde\u63a5\u7684\u5e93\u3002\u6b64\u524d\u7248\u672c\u7684LWJGL\u63d0\u4f9b\u4e86\u4e00\u4e2a\u81ea\u5b9a\u4e49GUI API\uff0c\u4f46\u5728LWJGL 3\u4e2d\uff0cGLFW\u662f\u9996\u9009\u7684\u7a97\u53e3API\u3002 \u793a\u4f8b\u6e90\u7801\u5f88\u7b80\u5355\u5e76\u6709\u7740\u826f\u597d\u7684\u6587\u6863\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u4f1a\u5728\u4e66\u4e2d\u518d\u6b21\u8bf4\u660e\u3002 \u5982\u679c\u4f60\u6b63\u786e\u5730\u914d\u7f6e\u4e86\u73af\u5883\uff0c\u4f60\u5e94\u8be5\u80fd\u591f\u8fd0\u884c\u5b83\u5e76\u770b\u5230\u4e00\u4e2a\u6709\u7ea2\u8272\u80cc\u666f\u7684\u7a97\u53e3\u3002 \u672c\u4e66\u4e2d\u6e90\u4ee3\u7801\u53d1\u5e03\u4e8e GitHub \u3002","title":"\u4e8b\u524d\u51c6\u5907"},{"location":"01-first-steps/#first-steps","text":"\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5f00\u53d13D\u6e38\u620f\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u6280\u672f\u3002\u672c\u4e66\u5c06\u4f7f\u7528Java\u8bed\u8a00\u548cJava\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93( LWJGL )\u6765\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002LWJGL\u5e93\u5141\u8bb8\u6211\u4eec\u8bbf\u95ee\u5e95\u5c42\u7684API\uff08\u5e94\u7528\u7a0b\u5e8f\u63a5\u53e3\uff09\uff0c\u4f8b\u5982OpenGL\u3002 LWJGL\u662f\u4e00\u4e2a\u5e95\u5c42\u7684API\uff0c\u5b83\u50cf\u4e00\u4e2aOpenGL\u5305\u88c5\u5e93\u3002\u5982\u679c\u4f60\u662f\u60f3\u5728\u77ed\u65f6\u95f4\u5185\u5f00\u59cb\u5236\u4f5c\u4e00\u4e2a3D\u6e38\u620f\uff0c\u90a3\u4e48\u4f60\u4e5f\u8bb8\u8be5\u8003\u8651\u5176\u5b83\u9009\u62e9\uff0c\u6bd4\u5982\u4f7f\u7528\u5f15\u64ce[JmonkeyEngine]\u3002\u4f7f\u7528LWJGL\u8fd9\u4e2a\u5e95\u5c42API\uff0c\u5728\u4f60\u6536\u5230\u6210\u6548\u4e4b\u524d\uff0c\u9700\u8981\u4e86\u89e3\u8bb8\u591a\u6982\u5ff5\u5e76\u4e14\u7f16\u5199\u5927\u91cf\u7684\u4ee3\u7801\u3002\u8fd9\u6837\u505a\u7684\u597d\u5904\u662f\u4f60\u53ef\u4ee5\u66f4\u597d\u7684\u7406\u89e33D\u56fe\u5f62\u6e32\u67d3\uff0c\u5e76\u4e14\u53ef\u4ee5\u66f4\u597d\u7684\u63a7\u5236\u5b83\u3002 \u5728\u4e0a\u6587\u8bf4\u5230\uff0c\u5728\u672c\u4e66\u4e2d\u6211\u4eec\u5c06\u4f7f\u7528Java\uff0c\u66f4\u786e\u5207\u6765\u8bf4\u6211\u4eec\u5c06\u4f7f\u7528Java 10\u3002\u6240\u4ee5\u4f60\u9700\u8981\u4eceOracle\u7684\u9875\u9762\u4e0b\u8f7d\u5bf9\u5e94\u7248\u672c\u7684JDK\u3002\u8bf7\u9009\u62e9\u9002\u5408\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u7684\u5b89\u88c5\u7a0b\u5e8f\u3002\u672c\u4e66\u5047\u5b9a\u4f60\u5bf9Java\u8bed\u8a00\u6709\u4e00\u5b9a\u7684\u4e86\u89e3\u3002 \u5982\u679c\u4f60\u9700\u8981\u4e00\u4e2a\u53ef\u4ee5\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\u7684Java IDE\uff08\u96c6\u6210\u5f00\u53d1\u73af\u5883\uff09\uff0c\u4f60\u53ef\u4ee5\u4e0b\u8f7d\u4e3aJava 10\u63d0\u4f9b\u826f\u597d\u652f\u6301\u7684IntelliJ IDEA\u3002\u7531\u4e8eJava 10\u4ec5\u652f\u630164\u4f4d\u7684\u5e73\u53f0\uff0c\u8bb0\u5f97\u4e0b\u8f7d64\u4f4d\u7248\u672c\u7684IntelliJ\u3002IntelliJ\u63d0\u4f9b\u6709\u4e00\u4e2a\u514d\u8d39\u4e14\u5f00\u6e90\u7684\u793e\u533a\u7248\uff0c\u4f60\u53ef\u4ee5\u5728\u8fd9\u91cc\u4e0b\u8f7d\u5b83\uff1a https://www.jetbrains.com/idea/download/ \u3002 \u4e3a\u4e86\u6784\u5efa\u793a\u4f8b\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u4f7f\u7528 Maven \u3002Maven\u5df2\u7ecf\u96c6\u6210\u5728\u5927\u591a\u6570IDE\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5728IDE\u4e2d\u76f4\u63a5\u6253\u5f00\u4e0d\u540c\u7ae0\u8282\u7684\u793a\u4f8b\u4ee3\u7801\u3002\u53ea\u8981\u6253\u5f00\u4e86\u793a\u4f8b\u4ee3\u7801\u6240\u5728\u7684\u6587\u4ef6\u5939\uff0cIntelliJ\u5c31\u4f1a\u68c0\u6d4b\u5230\u5b83\u662f\u4e00\u4e2aMaven\u9879\u76ee\u3002 Maven\u57fa\u4e8e\u4e00\u4e2a\u540d\u4e3a pom.xml \uff08Project Object Model\uff0c\u9879\u76ee\u5bf9\u8c61\u6a21\u578b\uff09\u7684XML\u6587\u4ef6\u6765\u6784\u5efa\u9879\u76ee\uff0c\u5b83\u7ba1\u7406\u4e86\u9879\u76ee\u7684\u4f9d\u8d56\uff08\u9700\u8981\u4f7f\u7528\u7684\u5e93\uff09\u548c\u5728\u6784\u5efa\u8fc7\u7a0b\u4e2d\u9700\u8981\u6267\u884c\u7684\u6b65\u9aa4\u3002Maven\u9075\u5faa\u7ea6\u5b9a\u9ad8\u4e8e\u914d\u7f6e\u7684\u539f\u5219\uff0c\u5373\u5982\u679c\u4f60\u9075\u5b88\u6807\u51c6\u7684\u9879\u76ee\u7ed3\u6784\u548c\u547d\u540d\u7ea6\u5b9a\uff0c\u5c31\u4e0d\u9700\u8981\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u660e\u786e\u5730\u58f0\u660e\u6e90\u6587\u4ef6\u5728\u54ea\u91cc\u6216\u8005\u5e94\u8be5\u5728\u54ea\u91cc\u7f16\u8bd1\u7c7b\u3002 \u672c\u4e66\u4e0d\u662f\u4e00\u4e2aMaven\u6559\u7a0b\uff0c\u5982\u679c\u6709\u9700\u8981\uff0c\u8bf7\u5728\u7f51\u4e0a\u641c\u7d22Maven\u7684\u76f8\u5173\u8d44\u6599\u3002\u6e90\u4ee3\u7801\u6587\u4ef6\u5939\u5b9a\u4e49\u4e86\u4e00\u4e2a\u7236\u9879\u76ee\uff0c\u5b83\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u63d2\u4ef6\u5e76\u4e14\u58f0\u660e\u9700\u8981\u4f7f\u7528\u7684\u5e93\u7684\u7248\u672c\u3002 LWJGL 3.1\u5728\u9879\u76ee\u6784\u5efa\u4e0a\u6709\u4e00\u4e9b\u53d8\u5316\u3002\u73b0\u5728\uff0c\u5b83\u53d8\u5f97\u66f4\u52a0\u6a21\u5757\u5316\uff0c\u6211\u4eec\u53ef\u4ee5\u6709\u9009\u62e9\u5730\u4f7f\u7528\u7c7b\u5e93\uff0c\u800c\u4e0d\u662f\u5bfc\u5165\u4e00\u4e2a\u5de8\u5927\u7684Jar\u6587\u4ef6\u3002\u4f46\u8fd9\u662f\u6709\u4ee3\u4ef7\u7684\uff1a\u4f60\u9700\u8981\u4ed4\u7ec6\u5730\u9010\u4e2a\u6307\u5b9a\u4f9d\u8d56\u5173\u7cfb\u3002\u4e0d\u8fc7 LWJGL\u4e0b\u8f7d \u9875\u9762\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4e3a\u60a8\u751f\u6210POM\u6587\u4ef6\u7684\u811a\u672c\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u4f7f\u7528GLFW\u548cOpenGL\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u6211\u4eec\u7684POM\u6587\u4ef6\u3002 LWJGL\u5e73\u53f0\u4f9d\u8d56\u5e93\u5df2\u7ecf\u53ef\u4ee5\u4e3a\u4f60\u7684\u64cd\u4f5c\u7cfb\u7edf\u81ea\u52a8\u89e3\u538b\u672c\u5730\u5e93\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u4f7f\u7528\u5176\u4ed6\u63d2\u4ef6\uff08\u4f8b\u5982 mavennatives \uff09\u3002\u6211\u4eec\u53ea\u9700\u8981\u914d\u7f6e\u4e09\u4e2aProfile\u6765\u8bbe\u7f6eLWJGL\u6240\u5904\u7684\u64cd\u4f5c\u7cfb\u7edf\u3002Profile\u5c06\u4f1a\u4e3aWindows\u3001Linux\u548cMac OS\u7cfb\u5217\u8bbe\u7f6e\u6b63\u786e\u7684\u503c\u3002 <profiles> <profile> <id>windows-profile</id> <activation> <os> <family>Windows</family> </os> </activation> <properties> <native.target>natives-windows</native.target> </properties> </profile> <profile> <id>linux-profile</id> <activation> <os> <family>Linux</family> </os> </activation> <properties> <native.target>natives-linux</native.target> </properties> </profile> <profile> <id>OSX-profile</id> <activation> <os> <family>mac</family> </os> </activation> <properties> <native.target>natives-osx</native.target> </properties> </profile> </profiles> \u5728\u6bcf\u4e2a\u9879\u76ee\u4e2d\uff0cLWJGL\u5e73\u53f0\u4f9d\u8d56\u9879\u5c06\u4f7f\u7528\u914d\u7f6e\u6587\u4ef6\u4e3a\u5f53\u524d\u5e73\u53f0\u8bbe\u7f6e\u7684\u6b63\u786e\u7684\u5c5e\u6027\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-platform</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> </dependency> \u6b64\u5916\uff0c\u6bcf\u4e2a\u9879\u76ee\u53ef\u751f\u6210\u4e00\u4e2a\u53ef\u8fd0\u884c\u7684Jar\uff08\u4e00\u79cd\u53ef\u4ee5\u901a\u8fc7\u8f93\u5165 java -jar name_of_the_jar.jar \u5c31\u53ef\u8fd0\u884c\u7684Jar\uff09\uff0c\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528Maven\u7684 maven-jar-plugin \u63d2\u4ef6\u5b9e\u73b0\u7684\u3002\u8be5\u63d2\u4ef6\u521b\u5efa\u4e86\u4e00\u4e2a\u542b\u6709 MANIFEST.MF \u6587\u4ef6\u7684Jar\uff0c\u5e76\u4e14\u6587\u4ef6\u5185\u6709\u6307\u5b9a\u7684\u503c\uff0c\u8be5\u6587\u4ef6\u6700\u91cd\u8981\u7684\u5c5e\u6027\u5c31\u662f Main-Class \uff0c\u5b83\u6307\u660e\u4e86\u7a0b\u5e8f\u7684\u5165\u53e3\u3002\u6b64\u5916\uff0c\u6240\u6709\u7684\u4f9d\u8d56\u5e93\u90fd\u88ab\u8bbe\u7f6e\u5728\u8be5\u6587\u4ef6\u7684 Class-Path \u5c5e\u6027\u4e2d\u3002\u8981\u5728\u53e6\u4e00\u53f0\u8ba1\u7b97\u673a\u4e0a\u8fd0\u884c\u5b83\uff0c\u4f60\u53ea\u9700\u8981\u590d\u5236\u4f4d\u4e8e\u76ee\u6807\u76ee\u5f55\u4e0b\u7684\u4e3bJar\u6587\u4ef6\u548cLib\u76ee\u5f55\uff08\u5305\u62ec\u5176\u4e2d\u6240\u6709\u7684Jar\u6587\u4ef6\uff09\u3002 Jar\u6587\u4ef6\u50a8\u5b58\u7740LWJGL\u7c7b\u548c\u672c\u5730\u5e93\u3002LWJGL\u8fd8\u5c06\u8d1f\u8d23\u63d0\u53d6\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u6dfb\u52a0\u5230JVM\u7684\u5e93\u8def\u5f84\u4e2d\u3002 \u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u662fLWJGL\u7f51\u7ad9( https://www.lwjgl.org/guide )\u63d0\u4f9b\u7684\u7684\u5165\u95e8\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6ca1\u6709\u4f7f\u7528Swing\u6216JavaFX\u4f5c\u4e3a\u6211\u4eec\u7684GUI\u5e93\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f GLFW \uff0c\u5b83\u662f\u4e00\u4e2a\u7528\u4e8e\u5904\u7406GUI\u7ec4\u4ef6\uff08\u7a97\u53e3\u7b49\uff09\u548c\u4e8b\u4ef6\uff08\u6309\u952e\u6309\u4e0b\u3001\u9f20\u6807\u79fb\u52a8\u7b49\uff09\uff0c\u5e76\u4e14\u4e0eOpenGL\u4e0a\u4e0b\u6587\u8fdb\u884c\u7b80\u5355\u8fde\u63a5\u7684\u5e93\u3002\u6b64\u524d\u7248\u672c\u7684LWJGL\u63d0\u4f9b\u4e86\u4e00\u4e2a\u81ea\u5b9a\u4e49GUI API\uff0c\u4f46\u5728LWJGL 3\u4e2d\uff0cGLFW\u662f\u9996\u9009\u7684\u7a97\u53e3API\u3002 \u793a\u4f8b\u6e90\u7801\u5f88\u7b80\u5355\u5e76\u6709\u7740\u826f\u597d\u7684\u6587\u6863\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u4f1a\u5728\u4e66\u4e2d\u518d\u6b21\u8bf4\u660e\u3002 \u5982\u679c\u4f60\u6b63\u786e\u5730\u914d\u7f6e\u4e86\u73af\u5883\uff0c\u4f60\u5e94\u8be5\u80fd\u591f\u8fd0\u884c\u5b83\u5e76\u770b\u5230\u4e00\u4e2a\u6709\u7ea2\u8272\u80cc\u666f\u7684\u7a97\u53e3\u3002 \u672c\u4e66\u4e2d\u6e90\u4ee3\u7801\u53d1\u5e03\u4e8e GitHub \u3002","title":"\u4e8b\u524d\u51c6\u5907\uff08First Steps\uff09"},{"location":"02-the-game-loop/","text":"\u6e38\u620f\u5faa\u73af\uff08The Game Loop\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u6e38\u620f\u5faa\u73af\u6765\u5f00\u59cb\u5f00\u53d1\u6e38\u620f\u5f15\u64ce\u3002\u6e38\u620f\u5faa\u73af\u662f\u6bcf\u4e2a\u6e38\u620f\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u4e2a\u65e0\u4f11\u6b62\u7684\u5faa\u73af\uff0c\u8d1f\u8d23\u5468\u671f\u5730\u5904\u7406\u7528\u6237\u7684\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u56fe\u50cf\u5230\u5c4f\u5e55\u4e0a\u3002 \u4e0b\u8ff0\u4ee3\u7801\u7247\u6bb5\u5c55\u793a\u4e86\u6e38\u620f\u5faa\u73af\u7684\u7ed3\u6784\uff1a while (keepOnRunning) { handleInput(); updateGameState(); render(); } \u90a3\u4e48\uff0c\u8fd9\u5c31\u5b8c\u4e86\u5417\uff1f\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u6e38\u620f\u5faa\u73af\u4e86\u5417\uff1f\u663e\u7136\u8fd8\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6709\u5f88\u591a\u7f3a\u9677\u3002\u9996\u5148\uff0c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u7684\u901f\u5ea6\u5c06\u53d6\u51b3\u4e8e\u8fd0\u884c\u5b83\u7684\u8ba1\u7b97\u673a\u3002\u5982\u679c\u8ba1\u7b97\u673a\u8db3\u591f\u5feb\uff0c\u7528\u6237\u751a\u81f3\u770b\u4e0d\u5230\u6e38\u620f\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u6b64\u5916\uff0c\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5c06\u6d88\u8017\u6240\u6709\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6e38\u620f\u5faa\u73af\u72ec\u7acb\u4e8e\u8fd0\u884c\u7684\u8ba1\u7b97\u673a\uff0c\u5c1d\u8bd5\u4ee5\u6052\u5b9a\u901f\u7387\u8fd0\u884c\u3002\u5047\u8bbe\u6211\u4eec\u5e0c\u671b\u6e38\u620f\u4ee5\u6bcf\u79d250\u5e27\uff0850 Frames Per Second\uff0c50 FPS\uff09\u7684\u6052\u5b9a\u901f\u7387\u8fd0\u884c\uff0c\u90a3\u4e48\u6e38\u620f\u5faa\u73af\u4ee3\u7801\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff1a double secsPerFrame = 1.0d / 50.0d; while (keepOnRunning) { double now = getTime(); handleInput(); updateGameState(); render(); sleep(now + secsPerFrame \u2013 getTime()); } \u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5f88\u7b80\u5355\uff0c\u53ef\u4ee5\u7528\u4e8e\u4e00\u4e9b\u6e38\u620f\uff0c\u4f46\u662f\u5b83\u4e5f\u5b58\u5728\u4e00\u4e9b\u7f3a\u9677\u3002\u9996\u5148\uff0c\u5b83\u5047\u5b9a\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u9002\u5408\u4ee550FPS\uff08\u5373 secsPerFrame \u7b49\u4e8e20\u6beb\u79d2\uff09\u7684\u901f\u7387\u66f4\u65b0\u3002 \u6b64\u5916\uff0c\u6211\u4eec\u7684\u8ba1\u7b97\u673a\u53ef\u80fd\u4f1a\u4f18\u5148\u8003\u8651\u6682\u505c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u4e00\u6bb5\u65f6\u95f4\uff0c\u4ee5\u8fd0\u884c\u5176\u4ed6\u7684\u4efb\u52a1\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u80fd\u4f1a\u5728\u975e\u5e38\u4e0d\u7a33\u5b9a\u7684\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\uff0c\u8fd9\u662f\u4e0d\u7b26\u5408\u6e38\u620f\u7269\u7406\u7684\u8981\u6c42\u7684\u3002 \u6700\u540e\uff0c\u7ebf\u7a0b\u4f11\u7720\u7684\u65f6\u95f4\u7cbe\u5ea6\u4ec5\u4ec5\u53ea\u67090.1\u79d2\uff0c\u6240\u4ee5\u5373\u4f7f\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u6ca1\u6709\u6d88\u8017\u65f6\u95f4\uff0c\u4e5f\u4e0d\u4f1a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u3002\u6240\u4ee5\uff0c\u5982\u4f60\u6240\u89c1\uff0c\u95ee\u9898\u6ca1\u90a3\u4e48\u7b80\u5355\u3002 \u5728\u7f51\u4e0a\u4f60\u53ef\u4ee5\u627e\u5230\u5927\u91cf\u7684\u6e38\u620f\u5faa\u73af\u7684\u53d8\u79cd\u3002\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u7528\u4e00\u4e2a\u4e0d\u592a\u590d\u6742\u7684\uff0c\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u80fd\u6b63\u5e38\u5de5\u4f5c\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u7528\u7684\u65b9\u6cd5\u901a\u5e38\u88ab\u79f0\u4e3a \u5b9a\u957f\u6e38\u620f\u5faa\u73af \uff08Fixed Step Game Loop\uff09\u3002 \u9996\u5148\uff0c\u6211\u4eec\u53ef\u80fd\u60f3\u8981\u5355\u72ec\u63a7\u5236\u6e38\u620f\u72b6\u6001\u88ab\u66f4\u65b0\u7684\u5468\u671f\u548c\u6e38\u620f\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u7684\u5468\u671f\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u56e0\u4e3a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u66f4\u4e3a\u91cd\u8981\uff0c\u7279\u522b\u662f\u5982\u679c\u4f7f\u7528\u7269\u7406\u5f15\u64ce\u3002\u76f8\u53cd\uff0c\u5982\u679c\u6e32\u67d3\u6ca1\u6709\u53ca\u65f6\u5b8c\u6210\uff0c\u5728\u8fd0\u884c\u6e38\u620f\u5faa\u73af\u65f6\u6e32\u67d3\u65e7\u5e27\u4e5f\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6211\u4eec\u53ef\u4ee5\u7075\u6d3b\u5730\u8df3\u8fc7\u67d0\u4e9b\u5e27\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u73b0\u5728\u7684\u6e38\u620f\u5faa\u73af\u662f\u4ec0\u4e48\u6837\u7684\uff1a double secsPerUpdate = 1.0d / 30.0d; double previous = getTime(); double steps = 0.0; while (true) { double loopStartTime = getTime(); double elapsed = loopStartTime - previous; previous = loopStartTime; steps += elapsed; handleInput(); while (steps >= secsPerUpdate) { updateGameState(); steps -= secsPerUpdate; } render(); sync(loopStartTime); } \u4f7f\u7528\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u56fa\u5b9a\u7684\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u3002\u4f46\u662f\u5982\u4f55\u907f\u514d\u8017\u5c3d\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u4f7f\u5b83\u4e0d\u8fde\u7eed\u6e32\u67d3\u5462\uff1f\u8fd9\u5728 sync \u65b9\u6cd5\u4e2d\u5b9e\u73b0\uff1a private void sync(double loopStartTime) { float loopSlot = 1f / 50; double endTime = loopStartTime + loopSlot; while(getTime() < endTime) { try { Thread.sleep(1); } catch (InterruptedException ie) {} } } \u90a3\u4e48\u4e0a\u8ff0\u65b9\u6cd5\u505a\u4e86\u4ec0\u4e48\u5462\uff1f\u7b80\u800c\u8a00\u4e4b\uff0c\u6211\u4eec\u8ba1\u7b97\u6e38\u620f\u5faa\u73af\u8fed\u4ee3\u5e94\u8be5\u6301\u7eed\u591a\u957f\u65f6\u95f4\uff08\u5b83\u88ab\u50a8\u5b58\u5728 loopSlot \u53d8\u91cf\u4e2d\uff09\uff0c\u4f11\u7720\u7684\u65f6\u95f4\u53d6\u51b3\u4e8e\u5728\u5faa\u73af\u4e2d\u82b1\u8d39\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u4e0d\u505a\u4e00\u6574\u6bb5\u65f6\u95f4\u7684\u4f11\u7720\uff0c\u800c\u662f\u8fdb\u884c\u4e00\u4e9b\u5c0f\u7684\u4f11\u7720\u3002\u8fd9\u5141\u8bb8\u5176\u4ed6\u4efb\u52a1\u8fd0\u884c\uff0c\u5e76\u907f\u514d\u6b64\u524d\u63d0\u5230\u7684\u4f11\u7720\u51c6\u786e\u6027\u95ee\u9898\u3002\u63a5\u4e0b\u6765\u6211\u4eec\u8981\u505a\u7684\u662f\uff1a 1. \u8ba1\u7b97\u5e94\u8be5\u9000\u51fa\u8fd9\u4e2a\u65b9\u6cd5\u7684\u65f6\u95f4\uff08\u8fd9\u4e2a\u53d8\u91cf\u540d\u4e3a endTime \uff09\uff0c\u5e76\u5f00\u59cb\u6e38\u620f\u5faa\u73af\u7684\u53e6\u4e00\u6b21\u8fed\u4ee3\u3002 2. \u6bd4\u8f83\u5f53\u524d\u65f6\u95f4\u548c\u7ed3\u675f\u65f6\u95f4\uff0c\u5982\u679c\u6ca1\u6709\u5230\u8fbe\u7ed3\u675f\u65f6\u95f4\uff0c\u5c31\u4f11\u77201\u6beb\u79d2\u3002 \u73b0\u5728\u662f\u6784\u5efa\u4ee3\u7801\u5e93\u4ee5\u4fbf\u5f00\u59cb\u7f16\u5199\u6e38\u620f\u5f15\u64ce\u7684\u7b2c\u4e00\u4e2a\u7248\u672c\u7684\u65f6\u5019\u4e86\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u6765\u8ba8\u8bba\u4e00\u4e0b\u63a7\u5236\u6e32\u67d3\u901f\u7387\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u505a\u5fae\u4f11\u7720\u662f\u4e3a\u4e86\u63a7\u5236\u9700\u8981\u7b49\u5f85\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u53e6\u4e00\u79cd\u65b9\u6cd5\u6765\u9650\u5236\u5e27\u7387\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 \u5782\u76f4\u540c\u6b65 \uff08Vertical Synchronization\uff09\uff0c\u5782\u76f4\u540c\u6b65\u7684\u4e3b\u8981\u76ee\u7684\u662f\u907f\u514d\u753b\u9762\u6495\u88c2\u3002\u4ec0\u4e48\u662f\u753b\u9762\u6495\u88c2\uff1f\u8fd9\u662f\u4e00\u79cd\u663e\u793a\u73b0\u8c61\uff0c\u5f53\u6b63\u5728\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u66f4\u65b0\u56fe\u50cf\u50a8\u5b58\u533a\uff0c\u5bfc\u81f4\u5c4f\u5e55\u7684\u4e00\u90e8\u5206\u663e\u793a\u5148\u524d\u7684\u56fe\u50cf\uff0c\u800c\u5c4f\u5e55\u7684\u53e6\u4e00\u90e8\u5206\u663e\u793a\u6b63\u5728\u6e32\u67d3\u7684\u56fe\u50cf\u3002\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u5f53GPU\u4e2d\u7684\u6570\u636e\u6b63\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4e0d\u4f1a\u5411GPU\u53d1\u9001\u6570\u636e\u3002 \u5f53\u5f00\u542f\u5782\u76f4\u540c\u6b65\u65f6\uff0c\u6211\u4eec\u5c06\u4e0e\u663e\u5361\u7684\u5237\u65b0\u7387\u540c\u6b65\uff0c\u663e\u5361\u5c06\u4ee5\u6052\u5b9a\u7684\u5e27\u7387\u6e32\u67d3\u3002\u7528\u4e0b\u8ff0\u4e00\u884c\u4ee3\u7801\u542f\u7528\u5b83\uff1a glfwSwapInterval(1); \u6709\u4e86\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u610f\u5473\u7740\u81f3\u5c11\u5728\u4e00\u4e2a\u5c4f\u5e55\u66f4\u65b0\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u7b49\u5f85\u3002\u4e8b\u5b9e\u4e0a\u6211\u4eec\u4e0d\u662f\u76f4\u63a5\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u6570\u636e\u50a8\u5b58\u5728\u7f13\u51b2\u533a\u4e2d\uff0c\u7136\u540e\u7528\u4e0b\u9762\u7684\u65b9\u6cd5\u4ea4\u6362\u5b83\uff1a glfwSwapBuffers(windowHandle); \u56e0\u6b64\uff0c\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u7a33\u5b9a\u7684\u5e27\u7387\uff0c\u800c\u4e0d\u9700\u8981\u8fdb\u884c\u5fae\u4f11\u7720\u6765\u68c0\u67e5\u66f4\u65b0\u65f6\u95f4\u3002\u6b64\u5916\uff0c\u5e27\u7387\u5c06\u4e0e\u8bbe\u5907\u7684\u663e\u5361\u5237\u65b0\u7387\u76f8\u5339\u914d\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5982\u679c\u5b83\u8bbe\u5b9a\u4e3a60Hz\uff0860FPS\uff09\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u670960FPS\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5728 glfwSwapInterval \u65b9\u6cd5\u4e2d\u8bbe\u7f6e\u9ad8\u4e8e1\u7684\u6570\u5b57\u6765\u964d\u4f4e\u8fd9\u4e2a\u901f\u7387\uff08\u5982\u679c\u8bbe\u7f6e\u4e3a2\uff0c\u5c06\u5f97\u523030FPS\uff09\u3002 \u8ba9\u6211\u4eec\u6574\u7406\u4e00\u4e0b\u6e90\u4ee3\u7801\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u628a\u6240\u6709\u7684GLFW\u7a97\u53e3\u521d\u59cb\u5316\u4ee3\u7801\u5c01\u88c5\u5728\u4e00\u4e2a\u540d\u4e3a Window \u7684\u7c7b\u4e2d\uff0c\u4f20\u9012\u4e00\u4e9b\u57fa\u672c\u7684\u53c2\u6570\uff08\u5982\u6807\u9898\u548c\u5927\u5c0f\uff09\u3002 Window \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u4ee5\u4fbf\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u68c0\u6d4b\u6309\u4e0b\u7684\u6309\u952e\uff1a public boolean isKeyPressed(int keyCode) { return glfwGetKey(windowHandle, keyCode) == GLFW_PRESS; } \u9664\u4e86\u6709\u521d\u59cb\u5316\u4ee3\u7801\u4ee5\u5916\uff0c Window \u7c7b\u8fd8\u9700\u8981\u77e5\u9053\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u3002\u56e0\u6b64\u9700\u8981\u8bbe\u7f6e\u4e00\u4e2a\u56de\u8c03\u65b9\u6cd5\uff0c\u5728\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\u8c03\u7528\u5b83\u3002\u56de\u8c03\u65b9\u6cd5\u5c06\u63a5\u6536\u5e27\u7f13\u51b2\u533a\uff08\u6e32\u67d3\u533a\u57df\uff0c\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u663e\u793a\u533a\u57df\uff09\u7684\u4ee5\u50cf\u7d20\u4e3a\u5355\u4f4d\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u3002\u5982\u679c\u5e0c\u671b\u5f97\u5230\u5e27\u7f13\u51b2\u533a\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 glfwSetWindowSizeCallback \u65b9\u6cd5\u3002\u5c4f\u5e55\u5750\u6807\u4e0d\u4e00\u5b9a\u5bf9\u5e94\u50cf\u7d20\uff08\u4f8b\u5982\uff0c\u5177\u6709\u89c6\u7f51\u819c\u663e\u793a\u5c4f\uff08Retina Display\uff09\u7684Mac\u8bbe\u5907\uff09\u3002\u56e0\u4e3a\u6211\u4eec\u5c06\u5728\u8fdb\u884cOpenGL\u8c03\u7528\u65f6\u4f7f\u7528\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6240\u4ee5\u8981\u6ce8\u610f\u50cf\u7d20\u4e0d\u5728\u5c4f\u5e55\u5750\u6807\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7GLFW\u7684\u6587\u6863\u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002 // \u8bbe\u7f6e\u8c03\u6574\u5927\u5c0f\u56de\u8c03 glfwSetFramebufferSizeCallback(windowHandle, (window, width, height) -> { Window.this.width = width; Window.this.height = height; Window.this.setResized(true); }); \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a Renderer \u7c7b\uff0c\u5b83\u5c06\u5904\u7406\u6211\u4eec\u6e38\u620f\u7684\u6e32\u67d3\u3002\u73b0\u5728\uff0c\u5b83\u4ec5\u4f1a\u6709\u4e00\u4e2a\u7a7a\u7684 init \u65b9\u6cd5\uff0c\u548c\u53e6\u4e00\u4e2a\u7528\u9884\u8bbe\u989c\u8272\u6e05\u7a7a\u5c4f\u5e55\u7684\u65b9\u6cd5\uff1a public void init() throws Exception { } public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IGameLogic \u7684\u63a5\u53e3\uff0c\u5b83\u5c01\u88c5\u4e86\u6211\u4eec\u7684\u6e38\u620f\u903b\u8f91\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba9\u6e38\u620f\u5f15\u64ce\u5728\u4e0d\u540c\u7684\u6e38\u620f\u4e0a\u91cd\u590d\u4f7f\u7528\u3002\u8be5\u63a5\u53e3\u5c06\u5177\u6709\u83b7\u53d6\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u6e38\u620f\u5185\u5bb9\u7684\u65b9\u6cd5\u3002 public interface IGameLogic { void init() throws Exception; void input(Window window); void update(float interval); void render(Window window); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameEngine \u7684\u7c7b\uff0c\u5b83\u5c06\u5305\u542b\u6211\u4eec\u6e38\u620f\u5faa\u73af\u7684\u4ee3\u7801\uff0c\u8be5\u7c7b\u5c06\u5b9e\u73b0\u50a8\u5b58\u6e38\u620f\u5faa\u73af\uff1a public class GameEngine implements Runnable { //... public GameEngine(String windowTitle, int width, int height, boolean vSync, IGameLogic gameLogic) throws Exception { window = new Window(windowTitle, width, height, vSync); this.gameLogic = gameLogic; //... } vSync \u53c2\u6570\u5141\u8bb8\u6211\u4eec\u9009\u62e9\u662f\u5426\u542f\u7528\u5782\u76f4\u540c\u6b65\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5b9e\u73b0\u4e86 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u62ec\u6e38\u620f\u5faa\u73af\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } } GameEngine \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a run \u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u6267\u884c\u521d\u59cb\u5316\u4efb\u52a1\uff0c\u5e76\u8fd0\u884c\u6e38\u620f\u5faa\u73af\uff0c\u76f4\u5230\u6211\u4eec\u5173\u95ed\u7a97\u53e3\u3002\u5173\u4e8e\u7ebf\u7a0b\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0cGLFW\u9700\u8981\u4ece\u4e3b\u7ebf\u7a0b\u521d\u59cb\u5316\uff0c\u4e8b\u4ef6\u7684\u8f6e\u8be2\u4e5f\u5e94\u8be5\u5728\u8be5\u7ebf\u7a0b\u4e2d\u5b8c\u6210\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728\u4e3b\u7ebf\u7a0b\u4e2d\u6267\u884c\u6240\u6709\u5185\u5bb9\uff0c\u800c\u4e0d\u662f\u4e3a\u6e38\u620f\u5faa\u73af\u521b\u5efa\u5355\u72ec\u7684\u7ebf\u7a0b\u3002 \u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u5c06\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u5176\u4ed6\u8f85\u52a9\u7c7b\uff0c\u4f8b\u5982 Timer \uff08\u5b83\u5c06\u63d0\u4f9b\u7528\u4e8e\u8ba1\u7b97\u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\u7684\u5b9e\u7528\u65b9\u6cd5\uff09\uff0c\u5e76\u5728\u6e38\u620f\u5faa\u73af\u903b\u8f91\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002 GameEngine \u7c7b\u53ea\u662f\u5c06 input \u548c update \u65b9\u6cd5\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u3002\u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5b83\u4e5f\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u5e76\u66f4\u65b0\u7a97\u53e3\u3002 protected void input() { gameLogic.input(window); } protected void update(float interval) { gameLogic.update(interval); } protected void render() { gameLogic.render(window); window.update(); } \u5728\u7a0b\u5e8f\u7684\u5165\u53e3\uff0c\u542b\u6709 main \u65b9\u6cd5\u7684\u7c7b\u53ea\u4f1a\u521b\u5efa\u4e00\u4e2a GameEngine \u5b9e\u4f8b\u5e76\u8fd0\u884c\u5b83\u3002 public class Main { public static void main(String[] args) { try { boolean vSync = true; IGameLogic gameLogic = new DummyGame(); GameEngine gameEng = new GameEngine(\"GAME\", 600, 480, vSync, gameLogic); gameEng.run(); } catch (Exception excp) { excp.printStackTrace(); System.exit(-1); } } } \u6700\u540e\uff0c\u5728\u672c\u7ae0\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684\u6e38\u620f\u903b\u8f91\u7c7b\u3002\u5b83\u53ea\u4f1a\u5728\u6309\u4e0b\u4e0a\u6216\u4e0b\u952e\u65f6\uff0c\u53d8\u4eae\u6216\u53d8\u6697\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u7684\u6e05\u7a7a\u989c\u8272\uff0c render \u65b9\u6cd5\u5c06\u4f1a\u7528\u8fd9\u4e2a\u989c\u8272\u6e05\u7a7a\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u3002 public class DummyGame implements IGameLogic { private int direction = 0; private float color = 0.0f; private final Renderer renderer; public DummyGame() { renderer = new Renderer(); } @Override public void init() throws Exception { renderer.init(); } @Override public void input(Window window) { if (window.isKeyPressed(GLFW_KEY_UP)) { direction = 1; } else if (window.isKeyPressed(GLFW_KEY_DOWN)) { direction = -1; } else { direction = 0; } } @Override public void update(float interval) { color += direction * 0.01f; if (color > 1) { color = 1.0f; } else if ( color < 0 ) { color = 0.0f; } } @Override public void render(Window window) { if (window.isResized()) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } window.setClearColor(color, color, color, 0.0f); renderer.clear(); } } \u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5f53\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\uff0c\u6211\u4eec\u63a5\u6536\u901a\u77e5\uff0c\u4ee5\u4fbf\u66f4\u65b0\u89c6\u53e3\u5c06\u5750\u6807\u4e2d\u5fc3\u5b9a\u4f4d\u5230\u7a97\u53e3\u7684\u4e2d\u5fc3\u3002 \u521b\u5efa\u7684\u7c7b\u5c42\u6b21\u7ed3\u6784\u5c06\u5e2e\u52a9\u6211\u4eec\u5c06\u6e38\u620f\u5f15\u64ce\u4ee3\u7801\u4e0e\u5177\u4f53\u7684\u6e38\u620f\u4ee3\u7801\u5206\u5f00\u3002\u867d\u7136\u73b0\u5728\u53ef\u80fd\u770b\u8d77\u6765\u6ca1\u6709\u5fc5\u8981\uff0c\u4f46\u6211\u4eec\u5df2\u5c06\u6bcf\u4e2a\u6e38\u620f\u7684\u901a\u7528\u4ee3\u7801\uff0c\u4ece\u5177\u4f53\u7684\u6e38\u620f\u7684\u903b\u8f91\u3001\u7f8e\u672f\u4f5c\u54c1\u548c\u8d44\u6e90\u4e2d\u5206\u79bb\u51fa\u6765\uff0c\u4ee5\u4fbf\u91cd\u7528\u6e38\u620f\u5f15\u64ce\u3002\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u8fd9\u4e2a\u7c7b\u5c42\u6b21\u7ed3\u6784\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u6e38\u620f\u5f15\u64ce\u53d8\u5f97\u66f4\u52a0\u590d\u6742\u3002 \u5e73\u53f0\u5dee\u5f02\uff08OSX\uff09 \u4f60\u53ef\u4ee5\u8fd0\u884c\u4e0a\u9762\u7684\u4ee3\u7801\u5728Windows\u6216Linux\u4e0a\uff0c\u4f46\u6211\u4eec\u4ecd\u9700\u8981\u4e3aOS X\u5e73\u53f0\u505a\u4e00\u4e9b\u4fee\u6539\u3002\u6b63\u5982GLFW\u6587\u6863\u4e2d\u6240\u63cf\u8ff0\u7684\uff1a \u76ee\u524dOS X\u4ec5\u652f\u6301\u7684OpenGL 3.x\u548c4.x\u7248\u672c\u7684\u73af\u5883\u662f\u5411\u4e0a\u517c\u5bb9\u7684\u3002OS X 10.7 Lion\u652f\u6301OpenGL 3.2\u7248\u672c\u548cOS X 10.9 Mavericks\u652f\u6301OpenGL 3.3\u548c4.1\u7248\u672c\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u7684GPU\u9700\u8981\u652f\u6301\u6307\u5b9a\u7248\u672c\u7684OpenGL\uff0c\u4ee5\u6210\u529f\u521b\u5efa\u73af\u5883\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u652f\u6301\u5728\u6b64\u540e\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u7279\u6027\uff0c\u6211\u4eec\u9700\u8981\u5c06\u4e0b\u8ff0\u4ee3\u7801\u6dfb\u52a0\u5230 Window \u7c7b\u521b\u5efa\u7a97\u53e3\u4ee3\u7801\u4e4b\u524d\uff1a glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 2); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE); \u8fd9\u5c06\u4f7f\u7a0b\u5e8f\u4f7f\u7528OpenGL 3.2\u52304.1\u4e4b\u95f4\u7684\u6700\u9ad8\u7248\u672c\u3002\u5982\u679c\u6ca1\u6709\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u4f1a\u4f7f\u7528\u65e7\u7248\u672c\u7684OpenGL\u3002","title":"\u6e38\u620f\u5faa\u73af"},{"location":"02-the-game-loop/#the-game-loop","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u6e38\u620f\u5faa\u73af\u6765\u5f00\u59cb\u5f00\u53d1\u6e38\u620f\u5f15\u64ce\u3002\u6e38\u620f\u5faa\u73af\u662f\u6bcf\u4e2a\u6e38\u620f\u7684\u6838\u5fc3\u90e8\u5206\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u4e2a\u65e0\u4f11\u6b62\u7684\u5faa\u73af\uff0c\u8d1f\u8d23\u5468\u671f\u5730\u5904\u7406\u7528\u6237\u7684\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u56fe\u50cf\u5230\u5c4f\u5e55\u4e0a\u3002 \u4e0b\u8ff0\u4ee3\u7801\u7247\u6bb5\u5c55\u793a\u4e86\u6e38\u620f\u5faa\u73af\u7684\u7ed3\u6784\uff1a while (keepOnRunning) { handleInput(); updateGameState(); render(); } \u90a3\u4e48\uff0c\u8fd9\u5c31\u5b8c\u4e86\u5417\uff1f\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u6e38\u620f\u5faa\u73af\u4e86\u5417\uff1f\u663e\u7136\u8fd8\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u6709\u5f88\u591a\u7f3a\u9677\u3002\u9996\u5148\uff0c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u7684\u901f\u5ea6\u5c06\u53d6\u51b3\u4e8e\u8fd0\u884c\u5b83\u7684\u8ba1\u7b97\u673a\u3002\u5982\u679c\u8ba1\u7b97\u673a\u8db3\u591f\u5feb\uff0c\u7528\u6237\u751a\u81f3\u770b\u4e0d\u5230\u6e38\u620f\u4e2d\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u6b64\u5916\uff0c\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5c06\u6d88\u8017\u6240\u6709\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6e38\u620f\u5faa\u73af\u72ec\u7acb\u4e8e\u8fd0\u884c\u7684\u8ba1\u7b97\u673a\uff0c\u5c1d\u8bd5\u4ee5\u6052\u5b9a\u901f\u7387\u8fd0\u884c\u3002\u5047\u8bbe\u6211\u4eec\u5e0c\u671b\u6e38\u620f\u4ee5\u6bcf\u79d250\u5e27\uff0850 Frames Per Second\uff0c50 FPS\uff09\u7684\u6052\u5b9a\u901f\u7387\u8fd0\u884c\uff0c\u90a3\u4e48\u6e38\u620f\u5faa\u73af\u4ee3\u7801\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff1a double secsPerFrame = 1.0d / 50.0d; while (keepOnRunning) { double now = getTime(); handleInput(); updateGameState(); render(); sleep(now + secsPerFrame \u2013 getTime()); } \u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\u5f88\u7b80\u5355\uff0c\u53ef\u4ee5\u7528\u4e8e\u4e00\u4e9b\u6e38\u620f\uff0c\u4f46\u662f\u5b83\u4e5f\u5b58\u5728\u4e00\u4e9b\u7f3a\u9677\u3002\u9996\u5148\uff0c\u5b83\u5047\u5b9a\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u9002\u5408\u4ee550FPS\uff08\u5373 secsPerFrame \u7b49\u4e8e20\u6beb\u79d2\uff09\u7684\u901f\u7387\u66f4\u65b0\u3002 \u6b64\u5916\uff0c\u6211\u4eec\u7684\u8ba1\u7b97\u673a\u53ef\u80fd\u4f1a\u4f18\u5148\u8003\u8651\u6682\u505c\u6e38\u620f\u5faa\u73af\u8fd0\u884c\u4e00\u6bb5\u65f6\u95f4\uff0c\u4ee5\u8fd0\u884c\u5176\u4ed6\u7684\u4efb\u52a1\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u80fd\u4f1a\u5728\u975e\u5e38\u4e0d\u7a33\u5b9a\u7684\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\uff0c\u8fd9\u662f\u4e0d\u7b26\u5408\u6e38\u620f\u7269\u7406\u7684\u8981\u6c42\u7684\u3002 \u6700\u540e\uff0c\u7ebf\u7a0b\u4f11\u7720\u7684\u65f6\u95f4\u7cbe\u5ea6\u4ec5\u4ec5\u53ea\u67090.1\u79d2\uff0c\u6240\u4ee5\u5373\u4f7f\u6211\u4eec\u7684\u66f4\u65b0\u548c\u6e32\u67d3\u65b9\u6cd5\u6ca1\u6709\u6d88\u8017\u65f6\u95f4\uff0c\u4e5f\u4e0d\u4f1a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u3002\u6240\u4ee5\uff0c\u5982\u4f60\u6240\u89c1\uff0c\u95ee\u9898\u6ca1\u90a3\u4e48\u7b80\u5355\u3002 \u5728\u7f51\u4e0a\u4f60\u53ef\u4ee5\u627e\u5230\u5927\u91cf\u7684\u6e38\u620f\u5faa\u73af\u7684\u53d8\u79cd\u3002\u5728\u672c\u4e66\u4e2d\uff0c\u6211\u4eec\u5c06\u7528\u4e00\u4e2a\u4e0d\u592a\u590d\u6742\u7684\uff0c\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u80fd\u6b63\u5e38\u5de5\u4f5c\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u7528\u7684\u65b9\u6cd5\u901a\u5e38\u88ab\u79f0\u4e3a \u5b9a\u957f\u6e38\u620f\u5faa\u73af \uff08Fixed Step Game Loop\uff09\u3002 \u9996\u5148\uff0c\u6211\u4eec\u53ef\u80fd\u60f3\u8981\u5355\u72ec\u63a7\u5236\u6e38\u620f\u72b6\u6001\u88ab\u66f4\u65b0\u7684\u5468\u671f\u548c\u6e38\u620f\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u7684\u5468\u671f\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u56e0\u4e3a\u4ee5\u6052\u5b9a\u7684\u901f\u7387\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u66f4\u4e3a\u91cd\u8981\uff0c\u7279\u522b\u662f\u5982\u679c\u4f7f\u7528\u7269\u7406\u5f15\u64ce\u3002\u76f8\u53cd\uff0c\u5982\u679c\u6e32\u67d3\u6ca1\u6709\u53ca\u65f6\u5b8c\u6210\uff0c\u5728\u8fd0\u884c\u6e38\u620f\u5faa\u73af\u65f6\u6e32\u67d3\u65e7\u5e27\u4e5f\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6211\u4eec\u53ef\u4ee5\u7075\u6d3b\u5730\u8df3\u8fc7\u67d0\u4e9b\u5e27\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u73b0\u5728\u7684\u6e38\u620f\u5faa\u73af\u662f\u4ec0\u4e48\u6837\u7684\uff1a double secsPerUpdate = 1.0d / 30.0d; double previous = getTime(); double steps = 0.0; while (true) { double loopStartTime = getTime(); double elapsed = loopStartTime - previous; previous = loopStartTime; steps += elapsed; handleInput(); while (steps >= secsPerUpdate) { updateGameState(); steps -= secsPerUpdate; } render(); sync(loopStartTime); } \u4f7f\u7528\u8fd9\u4e2a\u6e38\u620f\u5faa\u73af\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u56fa\u5b9a\u7684\u5468\u671f\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u3002\u4f46\u662f\u5982\u4f55\u907f\u514d\u8017\u5c3d\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u4f7f\u5b83\u4e0d\u8fde\u7eed\u6e32\u67d3\u5462\uff1f\u8fd9\u5728 sync \u65b9\u6cd5\u4e2d\u5b9e\u73b0\uff1a private void sync(double loopStartTime) { float loopSlot = 1f / 50; double endTime = loopStartTime + loopSlot; while(getTime() < endTime) { try { Thread.sleep(1); } catch (InterruptedException ie) {} } } \u90a3\u4e48\u4e0a\u8ff0\u65b9\u6cd5\u505a\u4e86\u4ec0\u4e48\u5462\uff1f\u7b80\u800c\u8a00\u4e4b\uff0c\u6211\u4eec\u8ba1\u7b97\u6e38\u620f\u5faa\u73af\u8fed\u4ee3\u5e94\u8be5\u6301\u7eed\u591a\u957f\u65f6\u95f4\uff08\u5b83\u88ab\u50a8\u5b58\u5728 loopSlot \u53d8\u91cf\u4e2d\uff09\uff0c\u4f11\u7720\u7684\u65f6\u95f4\u53d6\u51b3\u4e8e\u5728\u5faa\u73af\u4e2d\u82b1\u8d39\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u4e0d\u505a\u4e00\u6574\u6bb5\u65f6\u95f4\u7684\u4f11\u7720\uff0c\u800c\u662f\u8fdb\u884c\u4e00\u4e9b\u5c0f\u7684\u4f11\u7720\u3002\u8fd9\u5141\u8bb8\u5176\u4ed6\u4efb\u52a1\u8fd0\u884c\uff0c\u5e76\u907f\u514d\u6b64\u524d\u63d0\u5230\u7684\u4f11\u7720\u51c6\u786e\u6027\u95ee\u9898\u3002\u63a5\u4e0b\u6765\u6211\u4eec\u8981\u505a\u7684\u662f\uff1a 1. \u8ba1\u7b97\u5e94\u8be5\u9000\u51fa\u8fd9\u4e2a\u65b9\u6cd5\u7684\u65f6\u95f4\uff08\u8fd9\u4e2a\u53d8\u91cf\u540d\u4e3a endTime \uff09\uff0c\u5e76\u5f00\u59cb\u6e38\u620f\u5faa\u73af\u7684\u53e6\u4e00\u6b21\u8fed\u4ee3\u3002 2. \u6bd4\u8f83\u5f53\u524d\u65f6\u95f4\u548c\u7ed3\u675f\u65f6\u95f4\uff0c\u5982\u679c\u6ca1\u6709\u5230\u8fbe\u7ed3\u675f\u65f6\u95f4\uff0c\u5c31\u4f11\u77201\u6beb\u79d2\u3002 \u73b0\u5728\u662f\u6784\u5efa\u4ee3\u7801\u5e93\u4ee5\u4fbf\u5f00\u59cb\u7f16\u5199\u6e38\u620f\u5f15\u64ce\u7684\u7b2c\u4e00\u4e2a\u7248\u672c\u7684\u65f6\u5019\u4e86\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u6765\u8ba8\u8bba\u4e00\u4e0b\u63a7\u5236\u6e32\u67d3\u901f\u7387\u7684\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u505a\u5fae\u4f11\u7720\u662f\u4e3a\u4e86\u63a7\u5236\u9700\u8981\u7b49\u5f85\u7684\u65f6\u95f4\u3002\u4f46\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u53e6\u4e00\u79cd\u65b9\u6cd5\u6765\u9650\u5236\u5e27\u7387\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 \u5782\u76f4\u540c\u6b65 \uff08Vertical Synchronization\uff09\uff0c\u5782\u76f4\u540c\u6b65\u7684\u4e3b\u8981\u76ee\u7684\u662f\u907f\u514d\u753b\u9762\u6495\u88c2\u3002\u4ec0\u4e48\u662f\u753b\u9762\u6495\u88c2\uff1f\u8fd9\u662f\u4e00\u79cd\u663e\u793a\u73b0\u8c61\uff0c\u5f53\u6b63\u5728\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u66f4\u65b0\u56fe\u50cf\u50a8\u5b58\u533a\uff0c\u5bfc\u81f4\u5c4f\u5e55\u7684\u4e00\u90e8\u5206\u663e\u793a\u5148\u524d\u7684\u56fe\u50cf\uff0c\u800c\u5c4f\u5e55\u7684\u53e6\u4e00\u90e8\u5206\u663e\u793a\u6b63\u5728\u6e32\u67d3\u7684\u56fe\u50cf\u3002\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u5f53GPU\u4e2d\u7684\u6570\u636e\u6b63\u88ab\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4e0d\u4f1a\u5411GPU\u53d1\u9001\u6570\u636e\u3002 \u5f53\u5f00\u542f\u5782\u76f4\u540c\u6b65\u65f6\uff0c\u6211\u4eec\u5c06\u4e0e\u663e\u5361\u7684\u5237\u65b0\u7387\u540c\u6b65\uff0c\u663e\u5361\u5c06\u4ee5\u6052\u5b9a\u7684\u5e27\u7387\u6e32\u67d3\u3002\u7528\u4e0b\u8ff0\u4e00\u884c\u4ee3\u7801\u542f\u7528\u5b83\uff1a glfwSwapInterval(1); \u6709\u4e86\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u610f\u5473\u7740\u81f3\u5c11\u5728\u4e00\u4e2a\u5c4f\u5e55\u66f4\u65b0\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u7b49\u5f85\u3002\u4e8b\u5b9e\u4e0a\u6211\u4eec\u4e0d\u662f\u76f4\u63a5\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u6570\u636e\u50a8\u5b58\u5728\u7f13\u51b2\u533a\u4e2d\uff0c\u7136\u540e\u7528\u4e0b\u9762\u7684\u65b9\u6cd5\u4ea4\u6362\u5b83\uff1a glfwSwapBuffers(windowHandle); \u56e0\u6b64\uff0c\u5982\u679c\u542f\u7528\u5782\u76f4\u540c\u6b65\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u7a33\u5b9a\u7684\u5e27\u7387\uff0c\u800c\u4e0d\u9700\u8981\u8fdb\u884c\u5fae\u4f11\u7720\u6765\u68c0\u67e5\u66f4\u65b0\u65f6\u95f4\u3002\u6b64\u5916\uff0c\u5e27\u7387\u5c06\u4e0e\u8bbe\u5907\u7684\u663e\u5361\u5237\u65b0\u7387\u76f8\u5339\u914d\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5982\u679c\u5b83\u8bbe\u5b9a\u4e3a60Hz\uff0860FPS\uff09\uff0c\u90a3\u4e48\u6211\u4eec\u5c31\u670960FPS\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5728 glfwSwapInterval \u65b9\u6cd5\u4e2d\u8bbe\u7f6e\u9ad8\u4e8e1\u7684\u6570\u5b57\u6765\u964d\u4f4e\u8fd9\u4e2a\u901f\u7387\uff08\u5982\u679c\u8bbe\u7f6e\u4e3a2\uff0c\u5c06\u5f97\u523030FPS\uff09\u3002 \u8ba9\u6211\u4eec\u6574\u7406\u4e00\u4e0b\u6e90\u4ee3\u7801\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u628a\u6240\u6709\u7684GLFW\u7a97\u53e3\u521d\u59cb\u5316\u4ee3\u7801\u5c01\u88c5\u5728\u4e00\u4e2a\u540d\u4e3a Window \u7684\u7c7b\u4e2d\uff0c\u4f20\u9012\u4e00\u4e9b\u57fa\u672c\u7684\u53c2\u6570\uff08\u5982\u6807\u9898\u548c\u5927\u5c0f\uff09\u3002 Window \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u4ee5\u4fbf\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u68c0\u6d4b\u6309\u4e0b\u7684\u6309\u952e\uff1a public boolean isKeyPressed(int keyCode) { return glfwGetKey(windowHandle, keyCode) == GLFW_PRESS; } \u9664\u4e86\u6709\u521d\u59cb\u5316\u4ee3\u7801\u4ee5\u5916\uff0c Window \u7c7b\u8fd8\u9700\u8981\u77e5\u9053\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u3002\u56e0\u6b64\u9700\u8981\u8bbe\u7f6e\u4e00\u4e2a\u56de\u8c03\u65b9\u6cd5\uff0c\u5728\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\u8c03\u7528\u5b83\u3002\u56de\u8c03\u65b9\u6cd5\u5c06\u63a5\u6536\u5e27\u7f13\u51b2\u533a\uff08\u6e32\u67d3\u533a\u57df\uff0c\u7b80\u5355\u6765\u8bf4\u5c31\u662f\u663e\u793a\u533a\u57df\uff09\u7684\u4ee5\u50cf\u7d20\u4e3a\u5355\u4f4d\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\u3002\u5982\u679c\u5e0c\u671b\u5f97\u5230\u5e27\u7f13\u51b2\u533a\u7684\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528 glfwSetWindowSizeCallback \u65b9\u6cd5\u3002\u5c4f\u5e55\u5750\u6807\u4e0d\u4e00\u5b9a\u5bf9\u5e94\u50cf\u7d20\uff08\u4f8b\u5982\uff0c\u5177\u6709\u89c6\u7f51\u819c\u663e\u793a\u5c4f\uff08Retina Display\uff09\u7684Mac\u8bbe\u5907\uff09\u3002\u56e0\u4e3a\u6211\u4eec\u5c06\u5728\u8fdb\u884cOpenGL\u8c03\u7528\u65f6\u4f7f\u7528\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6240\u4ee5\u8981\u6ce8\u610f\u50cf\u7d20\u4e0d\u5728\u5c4f\u5e55\u5750\u6807\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7GLFW\u7684\u6587\u6863\u4e86\u89e3\u66f4\u591a\u4fe1\u606f\u3002 // \u8bbe\u7f6e\u8c03\u6574\u5927\u5c0f\u56de\u8c03 glfwSetFramebufferSizeCallback(windowHandle, (window, width, height) -> { Window.this.width = width; Window.this.height = height; Window.this.setResized(true); }); \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a Renderer \u7c7b\uff0c\u5b83\u5c06\u5904\u7406\u6211\u4eec\u6e38\u620f\u7684\u6e32\u67d3\u3002\u73b0\u5728\uff0c\u5b83\u4ec5\u4f1a\u6709\u4e00\u4e2a\u7a7a\u7684 init \u65b9\u6cd5\uff0c\u548c\u53e6\u4e00\u4e2a\u7528\u9884\u8bbe\u989c\u8272\u6e05\u7a7a\u5c4f\u5e55\u7684\u65b9\u6cd5\uff1a public void init() throws Exception { } public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IGameLogic \u7684\u63a5\u53e3\uff0c\u5b83\u5c01\u88c5\u4e86\u6211\u4eec\u7684\u6e38\u620f\u903b\u8f91\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba9\u6e38\u620f\u5f15\u64ce\u5728\u4e0d\u540c\u7684\u6e38\u620f\u4e0a\u91cd\u590d\u4f7f\u7528\u3002\u8be5\u63a5\u53e3\u5c06\u5177\u6709\u83b7\u53d6\u8f93\u5165\u3001\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u548c\u6e32\u67d3\u6e38\u620f\u5185\u5bb9\u7684\u65b9\u6cd5\u3002 public interface IGameLogic { void init() throws Exception; void input(Window window); void update(float interval); void render(Window window); } \u7136\u540e\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameEngine \u7684\u7c7b\uff0c\u5b83\u5c06\u5305\u542b\u6211\u4eec\u6e38\u620f\u5faa\u73af\u7684\u4ee3\u7801\uff0c\u8be5\u7c7b\u5c06\u5b9e\u73b0\u50a8\u5b58\u6e38\u620f\u5faa\u73af\uff1a public class GameEngine implements Runnable { //... public GameEngine(String windowTitle, int width, int height, boolean vSync, IGameLogic gameLogic) throws Exception { window = new Window(windowTitle, width, height, vSync); this.gameLogic = gameLogic; //... } vSync \u53c2\u6570\u5141\u8bb8\u6211\u4eec\u9009\u62e9\u662f\u5426\u542f\u7528\u5782\u76f4\u540c\u6b65\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5b9e\u73b0\u4e86 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u62ec\u6e38\u620f\u5faa\u73af\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } } GameEngine \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a run \u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u6267\u884c\u521d\u59cb\u5316\u4efb\u52a1\uff0c\u5e76\u8fd0\u884c\u6e38\u620f\u5faa\u73af\uff0c\u76f4\u5230\u6211\u4eec\u5173\u95ed\u7a97\u53e3\u3002\u5173\u4e8e\u7ebf\u7a0b\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0cGLFW\u9700\u8981\u4ece\u4e3b\u7ebf\u7a0b\u521d\u59cb\u5316\uff0c\u4e8b\u4ef6\u7684\u8f6e\u8be2\u4e5f\u5e94\u8be5\u5728\u8be5\u7ebf\u7a0b\u4e2d\u5b8c\u6210\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728\u4e3b\u7ebf\u7a0b\u4e2d\u6267\u884c\u6240\u6709\u5185\u5bb9\uff0c\u800c\u4e0d\u662f\u4e3a\u6e38\u620f\u5faa\u73af\u521b\u5efa\u5355\u72ec\u7684\u7ebf\u7a0b\u3002 \u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u5c06\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u5176\u4ed6\u8f85\u52a9\u7c7b\uff0c\u4f8b\u5982 Timer \uff08\u5b83\u5c06\u63d0\u4f9b\u7528\u4e8e\u8ba1\u7b97\u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\u7684\u5b9e\u7528\u65b9\u6cd5\uff09\uff0c\u5e76\u5728\u6e38\u620f\u5faa\u73af\u903b\u8f91\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002 GameEngine \u7c7b\u53ea\u662f\u5c06 input \u548c update \u65b9\u6cd5\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u3002\u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5b83\u4e5f\u59d4\u6258\u7ed9 IGameLogic \u5b9e\u4f8b\u5e76\u66f4\u65b0\u7a97\u53e3\u3002 protected void input() { gameLogic.input(window); } protected void update(float interval) { gameLogic.update(interval); } protected void render() { gameLogic.render(window); window.update(); } \u5728\u7a0b\u5e8f\u7684\u5165\u53e3\uff0c\u542b\u6709 main \u65b9\u6cd5\u7684\u7c7b\u53ea\u4f1a\u521b\u5efa\u4e00\u4e2a GameEngine \u5b9e\u4f8b\u5e76\u8fd0\u884c\u5b83\u3002 public class Main { public static void main(String[] args) { try { boolean vSync = true; IGameLogic gameLogic = new DummyGame(); GameEngine gameEng = new GameEngine(\"GAME\", 600, 480, vSync, gameLogic); gameEng.run(); } catch (Exception excp) { excp.printStackTrace(); System.exit(-1); } } } \u6700\u540e\uff0c\u5728\u672c\u7ae0\u4e2d\u6211\u4eec\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684\u6e38\u620f\u903b\u8f91\u7c7b\u3002\u5b83\u53ea\u4f1a\u5728\u6309\u4e0b\u4e0a\u6216\u4e0b\u952e\u65f6\uff0c\u53d8\u4eae\u6216\u53d8\u6697\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u7684\u6e05\u7a7a\u989c\u8272\uff0c render \u65b9\u6cd5\u5c06\u4f1a\u7528\u8fd9\u4e2a\u989c\u8272\u6e05\u7a7a\u7a97\u53e3\u7684\u989c\u8272\u7f13\u51b2\u533a\u3002 public class DummyGame implements IGameLogic { private int direction = 0; private float color = 0.0f; private final Renderer renderer; public DummyGame() { renderer = new Renderer(); } @Override public void init() throws Exception { renderer.init(); } @Override public void input(Window window) { if (window.isKeyPressed(GLFW_KEY_UP)) { direction = 1; } else if (window.isKeyPressed(GLFW_KEY_DOWN)) { direction = -1; } else { direction = 0; } } @Override public void update(float interval) { color += direction * 0.01f; if (color > 1) { color = 1.0f; } else if ( color < 0 ) { color = 0.0f; } } @Override public void render(Window window) { if (window.isResized()) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } window.setClearColor(color, color, color, 0.0f); renderer.clear(); } } \u5728 render \u65b9\u6cd5\u4e2d\uff0c\u5f53\u7a97\u53e3\u5927\u5c0f\u88ab\u8c03\u6574\u65f6\uff0c\u6211\u4eec\u63a5\u6536\u901a\u77e5\uff0c\u4ee5\u4fbf\u66f4\u65b0\u89c6\u53e3\u5c06\u5750\u6807\u4e2d\u5fc3\u5b9a\u4f4d\u5230\u7a97\u53e3\u7684\u4e2d\u5fc3\u3002 \u521b\u5efa\u7684\u7c7b\u5c42\u6b21\u7ed3\u6784\u5c06\u5e2e\u52a9\u6211\u4eec\u5c06\u6e38\u620f\u5f15\u64ce\u4ee3\u7801\u4e0e\u5177\u4f53\u7684\u6e38\u620f\u4ee3\u7801\u5206\u5f00\u3002\u867d\u7136\u73b0\u5728\u53ef\u80fd\u770b\u8d77\u6765\u6ca1\u6709\u5fc5\u8981\uff0c\u4f46\u6211\u4eec\u5df2\u5c06\u6bcf\u4e2a\u6e38\u620f\u7684\u901a\u7528\u4ee3\u7801\uff0c\u4ece\u5177\u4f53\u7684\u6e38\u620f\u7684\u903b\u8f91\u3001\u7f8e\u672f\u4f5c\u54c1\u548c\u8d44\u6e90\u4e2d\u5206\u79bb\u51fa\u6765\uff0c\u4ee5\u4fbf\u91cd\u7528\u6e38\u620f\u5f15\u64ce\u3002\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u8fd9\u4e2a\u7c7b\u5c42\u6b21\u7ed3\u6784\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u6e38\u620f\u5f15\u64ce\u53d8\u5f97\u66f4\u52a0\u590d\u6742\u3002","title":"\u6e38\u620f\u5faa\u73af\uff08The Game Loop\uff09"},{"location":"02-the-game-loop/#osx","text":"\u4f60\u53ef\u4ee5\u8fd0\u884c\u4e0a\u9762\u7684\u4ee3\u7801\u5728Windows\u6216Linux\u4e0a\uff0c\u4f46\u6211\u4eec\u4ecd\u9700\u8981\u4e3aOS X\u5e73\u53f0\u505a\u4e00\u4e9b\u4fee\u6539\u3002\u6b63\u5982GLFW\u6587\u6863\u4e2d\u6240\u63cf\u8ff0\u7684\uff1a \u76ee\u524dOS X\u4ec5\u652f\u6301\u7684OpenGL 3.x\u548c4.x\u7248\u672c\u7684\u73af\u5883\u662f\u5411\u4e0a\u517c\u5bb9\u7684\u3002OS X 10.7 Lion\u652f\u6301OpenGL 3.2\u7248\u672c\u548cOS X 10.9 Mavericks\u652f\u6301OpenGL 3.3\u548c4.1\u7248\u672c\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u7684GPU\u9700\u8981\u652f\u6301\u6307\u5b9a\u7248\u672c\u7684OpenGL\uff0c\u4ee5\u6210\u529f\u521b\u5efa\u73af\u5883\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u652f\u6301\u5728\u6b64\u540e\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u7279\u6027\uff0c\u6211\u4eec\u9700\u8981\u5c06\u4e0b\u8ff0\u4ee3\u7801\u6dfb\u52a0\u5230 Window \u7c7b\u521b\u5efa\u7a97\u53e3\u4ee3\u7801\u4e4b\u524d\uff1a glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3); glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 2); glfwWindowHint(GLFW_OPENGL_PROFILE, GLFW_OPENGL_CORE_PROFILE); glfwWindowHint(GLFW_OPENGL_FORWARD_COMPAT, GL_TRUE); \u8fd9\u5c06\u4f7f\u7a0b\u5e8f\u4f7f\u7528OpenGL 3.2\u52304.1\u4e4b\u95f4\u7684\u6700\u9ad8\u7248\u672c\u3002\u5982\u679c\u6ca1\u6709\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c31\u4f1a\u4f7f\u7528\u65e7\u7248\u672c\u7684OpenGL\u3002","title":"\u5e73\u53f0\u5dee\u5f02\uff08OSX\uff09"},{"location":"03-a-brief-about-coordinates/","text":"\u5750\u6807\u7b80\u4ecb\uff08A brief about coordinates\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u8ba8\u8bba\u5750\u6807\u548c\u5750\u6807\u7cfb\uff08Coordinate System\uff09\uff0c\u5c1d\u8bd5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u4ecb\u7ecd\u4e00\u4e9b\u57fa\u672c\u7684\u6570\u5b66\u6982\u5ff5\uff0c\u4e3a\u540e\u9762\u7ae0\u8282\u5c06\u8981\u4ecb\u7ecd\u7684\u6280\u672f\u548c\u5185\u5bb9\u63d0\u4f9b\u5e2e\u52a9\u3002\u6211\u4eec\u5c06\u4f1a\u5c06\u4e00\u4e9b\u5185\u5bb9\u7b80\u5316\uff0c\u4ee5\u6613\u4e8e\u5b66\u4e60\uff0c\u4f46\u727a\u7272\u4e86\u51c6\u786e\u6027\u3002 \u6211\u4eec\u901a\u8fc7\u6307\u5b9a\u5750\u6807\u6765\u786e\u5b9a\u7269\u4f53\u5728\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\u3002\u8054\u60f3\u5730\u56fe\uff0c\u901a\u8fc7\u5728\u5730\u56fe\u4e0a\u6307\u5b9a\u7eac\u5ea6\u548c\u7ecf\u5ea6\u6765\u786e\u5b9a\u4e00\u4e2a\u70b9\u3002\u53ea\u9700\u4e00\u5bf9\u6570\u5b57\uff0c\u5c31\u53ef\u4ee5\u7cbe\u786e\u5730\u786e\u8ba4\u4e00\u4e2a\u70b9\uff0c\u8fd9\u5bf9\u6570\u5b57\u5c31\u662f\u70b9\u5750\u6807\uff08\u5b9e\u9645\u4e0a\u6709\u4e9b\u590d\u6742\uff0c\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u624d\u80fd\u5728\u5730\u56fe\u4e0a\u786e\u5b9a\u4e00\u4e2a\u70b9\uff0c\u56e0\u4e3a\u5730\u56fe\u662f\u4e00\u4e2a\u4e0d\u5b8c\u7f8e\u7684\u692d\u5706\u7403\u4f53\uff08\u5730\u7403\uff09\u7684\u6295\u5f71\uff0c\u4f46\u8fd9\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u7c7b\u6bd4\uff09\u3002 \u5750\u6807\u7cfb\u662f\u4e00\u4e2a\u7cfb\u7edf\uff0c\u5b83\u4f7f\u7528\u4e00\u4e2a\u6216\u591a\u4e2a\u6570\u5b57\uff0c\u5373\u4e00\u4e2a\u6216\u591a\u4e2a\u5206\u91cf\u6765\u552f\u4e00\u5730\u786e\u5b9a\u4e00\u4e2a\u70b9\u7684\u4f4d\u7f6e\u3002\u5b58\u5728\u7740\u591a\u79cd\u4e0d\u540c\u7684\u5750\u6807\u7cfb\uff08\u5982\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6781\u5750\u6807\u7cfb\u7b49\uff09\uff0c\u5e76\u4e14\u53ef\u4ee5\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u5750\u6807\u7531\u4e24\u4e2a\u6570\u5b57\u5b9a\u4e49\uff0c\u5b83\u4eec\u8868\u793a\u5230\u4e24\u4e2a\u76f8\u4e92\u5782\u76f4\u7684X\u8f74\u548cY\u8f74\u95f4\u8ddd\u79bb\u3002 \u7ee7\u7eed\u7c7b\u6bd4\u5730\u56fe\uff0c\u5750\u6807\u7cfb\u5b9a\u4e49\u4e00\u4e2a\u539f\u70b9\u3002\u5bf9\u4e8e\u5730\u7406\u5750\u6807\u6765\u8bf4\uff0c\u539f\u70b9\u88ab\u8bbe\u7f6e\u4e3a\u8d64\u9053\u548c\u96f6\u5ea6\u7ecf\u7ebf\u4ea4\u53c9\u7684\u70b9\u3002\u6839\u636e\u539f\u70b9\u8bbe\u7f6e\u7684\u4f4d\u7f6e\uff0c\u7279\u5b9a\u70b9\u7684\u5750\u6807\u662f\u4e0d\u540c\u7684\u3002\u5750\u6807\u7cfb\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u8f74\u7684\u65b9\u5411\u3002\u5728\u4e0a\u56fe\u4e2d\uff0cX\u5750\u6807\u968f\u7740\u70b9\u5411\u53f3\u79fb\u52a8\u800c\u589e\u52a0\uff0cY\u5750\u6807\u968f\u7740\u70b9\u5411\u4e0a\u79fb\u52a8\u800c\u589e\u52a0\u3002\u4f46\u6211\u4eec\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e0e\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e0d\u540c\u7684\uff0c\u5177\u6709\u4e0d\u540c\u7684\u8f74\u53d6\u5411\u7684\u5750\u6807\u7cfb\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e0d\u540c\u7684\u5750\u6807\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e9b\u53c2\u6570\uff0c\u4f8b\u5982\u539f\u70b9\u548c\u8f74\u65b9\u5411\uff0c\u4ee5\u4fbf\u4f7f\u6784\u6210\u5750\u6807\u7684\u6570\u5b57\u5bf9\u6709\u6070\u5f53\u7684\u542b\u4e49\u3002\u4e3a\u4e86\u4f7f\u7528\u4e00\u7ec4\u5750\u6807\uff0c\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u5bf9\u5e94\u7684\u5750\u6807\u7cfb\uff0c\u597d\u6d88\u606f\u662f\u53ef\u4ee5\u901a\u8fc7\u5e73\u79fb\u548c\u65cb\u8f6c\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u5982\u679c\u8981\u5904\u7406\u4e09\u7ef4\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u589e\u52a0\u4e00\u4e2a\u8f74\uff0c\u5373Z\u8f74\u3002\u4e09\u7ef4\u5750\u6807\u5c06\u7531\u4e09\u4e2a\u6570\u5b57(x, y, z)\u6784\u6210\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u53ea\u8981\u8f74\u76f8\u4e92\u5782\u76f4\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6539\u53d8\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u7684\u8f74\u7684\u65b9\u5411\u3002\u4e0b\u56fe\u663e\u793a\u53e6\u4e00\u4e2a\u4e09\u7ef4\u5750\u6807\u7cfb\u3002 \u4e09\u7ef4\u5750\u6807\u53ef\u5206\u4e3a\u5de6\u624b\u7cfb\u548c\u53f3\u624b\u7cfb\u4e24\u79cd\u7c7b\u578b\u3002\u4f60\u600e\u4e48\u77e5\u9053\u5b83\u662f\u4ec0\u4e48\u7c7b\u578b\u7684\uff1f\u7528\u4f60\u7684\u624b\u5728\u4f60\u7684\u62c7\u6307\u548c\u98df\u6307\u4e4b\u95f4\u5f62\u6210\u4e00\u4e2a\u201cL\u201d\uff0c\u4e2d\u6307\u5e94\u6307\u5411\u5782\u76f4\u4e8e\u5176\u4ed6\u4e24\u4e2a\u624b\u6307\u7684\u65b9\u5411\u3002\u62c7\u6307\u5e94\u8be5\u6307\u5411X\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u98df\u6307\u5e94\u8be5\u6307\u5411Y\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u800c\u4e2d\u6307\u5e94\u8be5\u6307\u5411Z\u8f74\u7684\u6b63\u65b9\u5411\u3002\u5982\u679c\u4f60\u80fd\u7528\u5de6\u624b\u505a\u5230\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5de6\u624b\u7cfb\uff0c\u5982\u679c\u4f60\u9700\u8981\u7528\u53f3\u624b\uff0c\u90a3\u5b83\u5c31\u662f\u53f3\u624b\u7cfb\u3002 \u4e8c\u7ef4\u5750\u6807\u7cfb\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u901a\u8fc7\u65cb\u8f6c\uff0c\u6211\u4eec\u53ef\u4ee5\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u4f46\u662f\uff0c\u4e09\u7ef4\u5750\u6807\u7cfb\u5e76\u4e0d\u90fd\u662f\u76f8\u540c\u7684\u3002\u5982\u679c\u5b83\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u624b\u6765\u8868\u793a\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u4e24\u8005\u90fd\u662f\u5de6\u624b\u7cfb\u6216\u8005\u53f3\u624b\u7cfb\uff0c\u90a3\u4e48\u5c31\u80fd\u901a\u8fc7\u65cb\u8f6c\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u73b0\u5728\u5df2\u7ecf\u660e\u786e\u4e86\u4e00\u4e9b\u57fa\u672c\u7684\u6982\u5ff5\uff0c\u8ba9\u6211\u4eec\u6765\u8bb2\u89e3\u4e00\u4e9b\u5728\u5904\u7406\u4e09\u7ef4\u56fe\u5f62\u65f6\u5e38\u7528\u7684\u672f\u8bed\u3002\u5f53\u6211\u4eec\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u91ca\u5982\u4f55\u6e32\u67d3\u4e09\u7ef4\u6a21\u578b\u65f6\uff0c\u5c06\u770b\u5230\u6211\u4eec\u5c06\u4f7f\u7528\u4e0d\u540c\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\uff0c\u8fd9\u662f\u56e0\u4e3a\u6bcf\u4e2a\u5750\u6807\u7cfb\u90fd\u6709\u4e0d\u540c\u7684\u8bbe\u5b9a\uff0c\u6709\u4e0d\u540c\u7684\u76ee\u7684\u3002\u4e00\u7ec4\u5750\u6807\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u9664\u975e\u660e\u786e\u5b83\u662f\u67d0\u4e2a\u5750\u6807\u7cfb\u7684\u5750\u6807\u3002\u5f53\u4f60\u770b\u5230\u5750\u6807(40.438031, -3.676626)\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u6709\u4e00\u4e2a\u5927\u80c6\u7684\u60f3\u6cd5\u3002\u4f46\u662f\u5982\u679c\u6211\u8bf4\u5b83\u662f\u51e0\u4f55\u5750\u6807\uff08\u7ecf\u5ea6\u548c\u7eac\u5ea6\uff09\u65f6\uff0c\u4f60\u5c31\u4f1a\u53d1\u73b0\u5b83\u662f\u9a6c\u5fb7\u91cc\u67d0\u4e2a\u5730\u65b9\u7684\u5750\u6807\u3002 \u5f53\u6211\u4eec\u52a0\u8f7d\u4e09\u7ef4\u7269\u4f53\u65f6\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e00\u7ec4\u4e09\u7ef4\u5750\u6807\u3002\u8fd9\u4e9b\u5750\u6807\u5728\u88ab\u79f0\u4e3a\u7269\u4f53\u5750\u6807\u7cfb\uff08Object Coordinate Space\uff09\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u8868\u8fbe\u3002\u5f53\u5efa\u6a21\u5e08\u5728\u8bbe\u8ba1\u8fd9\u4e9b\u4e09\u7ef4\u6a21\u578b\u7684\u65f6\u5019\uff0c\u4ed6\u4eec\u5bf9\u8be5\u6a21\u578b\u5c06\u663e\u793a\u7684\u4e09\u7ef4\u573a\u666f\u6beb\u4e0d\u77e5\u60c5\uff0c\u56e0\u6b64\u53ea\u80fd\u4f7f\u7528\u4e0e\u6a21\u578b\u76f8\u5173\u7684\u5750\u6807\u7cfb\u6765\u5b9a\u4e49\u5750\u6807\u3002 \u5f53\u8981\u7ed8\u5236\u4e00\u4e2a\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u6240\u6709\u7684\u4e09\u7ef4\u7269\u4f53\u5c06\u4e0e\u88ab\u79f0\u4e3a\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u7cfb\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u7269\u4f53\u7684\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u4e16\u754c\u5750\u6807\u7cfb\u3002\u4e00\u4e9b\u7269\u4f53\u9700\u8981\u65cb\u8f6c\u3001\u62c9\u4f38\u3001\u653e\u5927\u548c\u8f6c\u6362\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u80fd\u591f\u6b63\u786e\u5730\u663e\u793a\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u9650\u5236\u6240\u663e\u793a\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u8303\u56f4\uff0c\u4f8b\u5982\u79fb\u52a8\u6444\u50cf\u673a\u7a7f\u68ad\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u8f6c\u6362\u5230\u6444\u50cf\u673a\u6216\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u6700\u540e\uff0c\u8fd9\u4e9b\u5750\u6807\u9700\u8981\u8f6c\u6362\u4e3a\u4e8c\u7ef4\u7684\u5c4f\u5e55\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u89c2\u5bdf\u5750\u6807\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u5750\u6807\u7cfb\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08Z\u8f74\u5782\u76f4\u4e8e\u5c4f\u5e55\uff09\uff0c\u5750\u6807\u5728-1\u548c+1\u4e4b\u95f4\u3002 \u5982\u679c\u4f60\u4e0d\u80fd\u6e05\u695a\u5730\u7406\u89e3\u8fd9\u4e9b\u6982\u5ff5\uff0c\u522b\u62c5\u5fc3\u3002\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff0c\u5b83\u4eec\u5c06\u7528\u5b9e\u4f8b\u8868\u73b0\u51fa\u6765\u3002","title":"\u5750\u6807\u7b80\u4ecb"},{"location":"03-a-brief-about-coordinates/#a-brief-about-coordinates","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u8ba8\u8bba\u5750\u6807\u548c\u5750\u6807\u7cfb\uff08Coordinate System\uff09\uff0c\u5c1d\u8bd5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u4ecb\u7ecd\u4e00\u4e9b\u57fa\u672c\u7684\u6570\u5b66\u6982\u5ff5\uff0c\u4e3a\u540e\u9762\u7ae0\u8282\u5c06\u8981\u4ecb\u7ecd\u7684\u6280\u672f\u548c\u5185\u5bb9\u63d0\u4f9b\u5e2e\u52a9\u3002\u6211\u4eec\u5c06\u4f1a\u5c06\u4e00\u4e9b\u5185\u5bb9\u7b80\u5316\uff0c\u4ee5\u6613\u4e8e\u5b66\u4e60\uff0c\u4f46\u727a\u7272\u4e86\u51c6\u786e\u6027\u3002 \u6211\u4eec\u901a\u8fc7\u6307\u5b9a\u5750\u6807\u6765\u786e\u5b9a\u7269\u4f53\u5728\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\u3002\u8054\u60f3\u5730\u56fe\uff0c\u901a\u8fc7\u5728\u5730\u56fe\u4e0a\u6307\u5b9a\u7eac\u5ea6\u548c\u7ecf\u5ea6\u6765\u786e\u5b9a\u4e00\u4e2a\u70b9\u3002\u53ea\u9700\u4e00\u5bf9\u6570\u5b57\uff0c\u5c31\u53ef\u4ee5\u7cbe\u786e\u5730\u786e\u8ba4\u4e00\u4e2a\u70b9\uff0c\u8fd9\u5bf9\u6570\u5b57\u5c31\u662f\u70b9\u5750\u6807\uff08\u5b9e\u9645\u4e0a\u6709\u4e9b\u590d\u6742\uff0c\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u624d\u80fd\u5728\u5730\u56fe\u4e0a\u786e\u5b9a\u4e00\u4e2a\u70b9\uff0c\u56e0\u4e3a\u5730\u56fe\u662f\u4e00\u4e2a\u4e0d\u5b8c\u7f8e\u7684\u692d\u5706\u7403\u4f53\uff08\u5730\u7403\uff09\u7684\u6295\u5f71\uff0c\u4f46\u8fd9\u662f\u4e00\u4e2a\u5f88\u597d\u7684\u7c7b\u6bd4\uff09\u3002 \u5750\u6807\u7cfb\u662f\u4e00\u4e2a\u7cfb\u7edf\uff0c\u5b83\u4f7f\u7528\u4e00\u4e2a\u6216\u591a\u4e2a\u6570\u5b57\uff0c\u5373\u4e00\u4e2a\u6216\u591a\u4e2a\u5206\u91cf\u6765\u552f\u4e00\u5730\u786e\u5b9a\u4e00\u4e2a\u70b9\u7684\u4f4d\u7f6e\u3002\u5b58\u5728\u7740\u591a\u79cd\u4e0d\u540c\u7684\u5750\u6807\u7cfb\uff08\u5982\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6781\u5750\u6807\u7cfb\u7b49\uff09\uff0c\u5e76\u4e14\u53ef\u4ee5\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u5750\u6807\u7531\u4e24\u4e2a\u6570\u5b57\u5b9a\u4e49\uff0c\u5b83\u4eec\u8868\u793a\u5230\u4e24\u4e2a\u76f8\u4e92\u5782\u76f4\u7684X\u8f74\u548cY\u8f74\u95f4\u8ddd\u79bb\u3002 \u7ee7\u7eed\u7c7b\u6bd4\u5730\u56fe\uff0c\u5750\u6807\u7cfb\u5b9a\u4e49\u4e00\u4e2a\u539f\u70b9\u3002\u5bf9\u4e8e\u5730\u7406\u5750\u6807\u6765\u8bf4\uff0c\u539f\u70b9\u88ab\u8bbe\u7f6e\u4e3a\u8d64\u9053\u548c\u96f6\u5ea6\u7ecf\u7ebf\u4ea4\u53c9\u7684\u70b9\u3002\u6839\u636e\u539f\u70b9\u8bbe\u7f6e\u7684\u4f4d\u7f6e\uff0c\u7279\u5b9a\u70b9\u7684\u5750\u6807\u662f\u4e0d\u540c\u7684\u3002\u5750\u6807\u7cfb\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u8f74\u7684\u65b9\u5411\u3002\u5728\u4e0a\u56fe\u4e2d\uff0cX\u5750\u6807\u968f\u7740\u70b9\u5411\u53f3\u79fb\u52a8\u800c\u589e\u52a0\uff0cY\u5750\u6807\u968f\u7740\u70b9\u5411\u4e0a\u79fb\u52a8\u800c\u589e\u52a0\u3002\u4f46\u6211\u4eec\u4e5f\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e0e\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e0d\u540c\u7684\uff0c\u5177\u6709\u4e0d\u540c\u7684\u8f74\u53d6\u5411\u7684\u5750\u6807\u7cfb\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e0d\u540c\u7684\u5750\u6807\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e9b\u53c2\u6570\uff0c\u4f8b\u5982\u539f\u70b9\u548c\u8f74\u65b9\u5411\uff0c\u4ee5\u4fbf\u4f7f\u6784\u6210\u5750\u6807\u7684\u6570\u5b57\u5bf9\u6709\u6070\u5f53\u7684\u542b\u4e49\u3002\u4e3a\u4e86\u4f7f\u7528\u4e00\u7ec4\u5750\u6807\uff0c\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u5bf9\u5e94\u7684\u5750\u6807\u7cfb\uff0c\u597d\u6d88\u606f\u662f\u53ef\u4ee5\u901a\u8fc7\u5e73\u79fb\u548c\u65cb\u8f6c\u5c06\u5750\u6807\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u5982\u679c\u8981\u5904\u7406\u4e09\u7ef4\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u589e\u52a0\u4e00\u4e2a\u8f74\uff0c\u5373Z\u8f74\u3002\u4e09\u7ef4\u5750\u6807\u5c06\u7531\u4e09\u4e2a\u6570\u5b57(x, y, z)\u6784\u6210\u3002 \u5728\u4e8c\u7ef4\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\u4e2d\uff0c\u53ea\u8981\u8f74\u76f8\u4e92\u5782\u76f4\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6539\u53d8\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u7684\u8f74\u7684\u65b9\u5411\u3002\u4e0b\u56fe\u663e\u793a\u53e6\u4e00\u4e2a\u4e09\u7ef4\u5750\u6807\u7cfb\u3002 \u4e09\u7ef4\u5750\u6807\u53ef\u5206\u4e3a\u5de6\u624b\u7cfb\u548c\u53f3\u624b\u7cfb\u4e24\u79cd\u7c7b\u578b\u3002\u4f60\u600e\u4e48\u77e5\u9053\u5b83\u662f\u4ec0\u4e48\u7c7b\u578b\u7684\uff1f\u7528\u4f60\u7684\u624b\u5728\u4f60\u7684\u62c7\u6307\u548c\u98df\u6307\u4e4b\u95f4\u5f62\u6210\u4e00\u4e2a\u201cL\u201d\uff0c\u4e2d\u6307\u5e94\u6307\u5411\u5782\u76f4\u4e8e\u5176\u4ed6\u4e24\u4e2a\u624b\u6307\u7684\u65b9\u5411\u3002\u62c7\u6307\u5e94\u8be5\u6307\u5411X\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u98df\u6307\u5e94\u8be5\u6307\u5411Y\u8f74\u7684\u6b63\u65b9\u5411\uff0c\u800c\u4e2d\u6307\u5e94\u8be5\u6307\u5411Z\u8f74\u7684\u6b63\u65b9\u5411\u3002\u5982\u679c\u4f60\u80fd\u7528\u5de6\u624b\u505a\u5230\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5de6\u624b\u7cfb\uff0c\u5982\u679c\u4f60\u9700\u8981\u7528\u53f3\u624b\uff0c\u90a3\u5b83\u5c31\u662f\u53f3\u624b\u7cfb\u3002 \u4e8c\u7ef4\u5750\u6807\u7cfb\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u901a\u8fc7\u65cb\u8f6c\uff0c\u6211\u4eec\u53ef\u4ee5\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002\u4f46\u662f\uff0c\u4e09\u7ef4\u5750\u6807\u7cfb\u5e76\u4e0d\u90fd\u662f\u76f8\u540c\u7684\u3002\u5982\u679c\u5b83\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u624b\u6765\u8868\u793a\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u4e24\u8005\u90fd\u662f\u5de6\u624b\u7cfb\u6216\u8005\u53f3\u624b\u7cfb\uff0c\u90a3\u4e48\u5c31\u80fd\u901a\u8fc7\u65cb\u8f6c\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\u3002 \u73b0\u5728\u5df2\u7ecf\u660e\u786e\u4e86\u4e00\u4e9b\u57fa\u672c\u7684\u6982\u5ff5\uff0c\u8ba9\u6211\u4eec\u6765\u8bb2\u89e3\u4e00\u4e9b\u5728\u5904\u7406\u4e09\u7ef4\u56fe\u5f62\u65f6\u5e38\u7528\u7684\u672f\u8bed\u3002\u5f53\u6211\u4eec\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u91ca\u5982\u4f55\u6e32\u67d3\u4e09\u7ef4\u6a21\u578b\u65f6\uff0c\u5c06\u770b\u5230\u6211\u4eec\u5c06\u4f7f\u7528\u4e0d\u540c\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\uff0c\u8fd9\u662f\u56e0\u4e3a\u6bcf\u4e2a\u5750\u6807\u7cfb\u90fd\u6709\u4e0d\u540c\u7684\u8bbe\u5b9a\uff0c\u6709\u4e0d\u540c\u7684\u76ee\u7684\u3002\u4e00\u7ec4\u5750\u6807\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u9664\u975e\u660e\u786e\u5b83\u662f\u67d0\u4e2a\u5750\u6807\u7cfb\u7684\u5750\u6807\u3002\u5f53\u4f60\u770b\u5230\u5750\u6807(40.438031, -3.676626)\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u6709\u4e00\u4e2a\u5927\u80c6\u7684\u60f3\u6cd5\u3002\u4f46\u662f\u5982\u679c\u6211\u8bf4\u5b83\u662f\u51e0\u4f55\u5750\u6807\uff08\u7ecf\u5ea6\u548c\u7eac\u5ea6\uff09\u65f6\uff0c\u4f60\u5c31\u4f1a\u53d1\u73b0\u5b83\u662f\u9a6c\u5fb7\u91cc\u67d0\u4e2a\u5730\u65b9\u7684\u5750\u6807\u3002 \u5f53\u6211\u4eec\u52a0\u8f7d\u4e09\u7ef4\u7269\u4f53\u65f6\uff0c\u6211\u4eec\u5c06\u5f97\u5230\u4e00\u7ec4\u4e09\u7ef4\u5750\u6807\u3002\u8fd9\u4e9b\u5750\u6807\u5728\u88ab\u79f0\u4e3a\u7269\u4f53\u5750\u6807\u7cfb\uff08Object Coordinate Space\uff09\u7684\u4e09\u7ef4\u5750\u6807\u7cfb\u4e2d\u8868\u8fbe\u3002\u5f53\u5efa\u6a21\u5e08\u5728\u8bbe\u8ba1\u8fd9\u4e9b\u4e09\u7ef4\u6a21\u578b\u7684\u65f6\u5019\uff0c\u4ed6\u4eec\u5bf9\u8be5\u6a21\u578b\u5c06\u663e\u793a\u7684\u4e09\u7ef4\u573a\u666f\u6beb\u4e0d\u77e5\u60c5\uff0c\u56e0\u6b64\u53ea\u80fd\u4f7f\u7528\u4e0e\u6a21\u578b\u76f8\u5173\u7684\u5750\u6807\u7cfb\u6765\u5b9a\u4e49\u5750\u6807\u3002 \u5f53\u8981\u7ed8\u5236\u4e00\u4e2a\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u6240\u6709\u7684\u4e09\u7ef4\u7269\u4f53\u5c06\u4e0e\u88ab\u79f0\u4e3a\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u7cfb\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u7269\u4f53\u7684\u5750\u6807\u7cfb\u8f6c\u6362\u5230\u4e16\u754c\u5750\u6807\u7cfb\u3002\u4e00\u4e9b\u7269\u4f53\u9700\u8981\u65cb\u8f6c\u3001\u62c9\u4f38\u3001\u653e\u5927\u548c\u8f6c\u6362\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u80fd\u591f\u6b63\u786e\u5730\u663e\u793a\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u9650\u5236\u6240\u663e\u793a\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u8303\u56f4\uff0c\u4f8b\u5982\u79fb\u52a8\u6444\u50cf\u673a\u7a7f\u68ad\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u5750\u6807\u8f6c\u6362\u5230\u6444\u50cf\u673a\u6216\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u6700\u540e\uff0c\u8fd9\u4e9b\u5750\u6807\u9700\u8981\u8f6c\u6362\u4e3a\u4e8c\u7ef4\u7684\u5c4f\u5e55\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u4e09\u7ef4\u89c2\u5bdf\u5750\u6807\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u5750\u6807\u7cfb\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08Z\u8f74\u5782\u76f4\u4e8e\u5c4f\u5e55\uff09\uff0c\u5750\u6807\u5728-1\u548c+1\u4e4b\u95f4\u3002 \u5982\u679c\u4f60\u4e0d\u80fd\u6e05\u695a\u5730\u7406\u89e3\u8fd9\u4e9b\u6982\u5ff5\uff0c\u522b\u62c5\u5fc3\u3002\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff0c\u5b83\u4eec\u5c06\u7528\u5b9e\u4f8b\u8868\u73b0\u51fa\u6765\u3002","title":"\u5750\u6807\u7b80\u4ecb\uff08A brief about coordinates\uff09"},{"location":"04-rendering/","text":"\u6e32\u67d3\uff08Rendering\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u7528OpenGL\u6e32\u67d3\u573a\u666f\u65f6\u8981\u505a\u7684\u4e8b\u9879\u3002\u5982\u679c\u4f60\u5df2\u7ecf\u4e60\u60ef\u4e86OpenGL\u7684\u65e7\u7248\u672c\uff0c\u4e60\u60ef\u4e86\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\uff0c\u4f60\u53ef\u80fd\u4f1a\u8df3\u8fc7\u8fd9\u4e00\u7ae0\uff0c\u4e0d\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u5b83\u9700\u8981\u8fd9\u4e48\u590d\u6742\u3002\u5b83\u5176\u5b9e\u66f4\u7b80\u5355\u3001\u66f4\u7075\u6d3b\uff0c\u4f60\u53ea\u9700\u8981\u7ed9\u5b83\u4e00\u4e2a\u8868\u73b0\u7684\u673a\u4f1a\u3002\u73b0\u4ee3OpenGL\u4f7f\u4f60\u53ea\u9700\u8003\u8651\u4e00\u4e2a\u95ee\u9898\uff0c\u8fd9\u53ef\u4ee5\u4f7f\u4f60\u4ee5\u66f4\u5408\u7406\u7684\u65b9\u5f0f\u7ec4\u7ec7\u4ee3\u7801\u548c\u5f00\u53d1\u3002 \u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u88ab\u7edf\u79f0\u4e3a\u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\u3002OpenGL\u6700\u521d\u7684\u7248\u672c\u4f7f\u7528\u4e86\u4e00\u4e2a\u88ab\u79f0\u4e3a\u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\u7684\u6a21\u578b\u3002\u8be5\u6a21\u578b\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\uff08\u4f8b\u5982\uff0c\u201c\u8bbe\u7f6e\u96fe\u201d\u6216\u201c\u6dfb\u52a0\u5149\u7167\u201d\uff09\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u56fe\u5f62\u7ba1\u7ebf\u7531\u4ee5\u4e0b\u64cd\u4f5c\u6b65\u9aa4\u7ec4\u6210\uff1a OpenGL 2.0 \u5f15\u5165\u4e86\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\u7684\u6982\u5ff5\u3002\u5728\u8be5\u6a21\u578b\u4e2d\uff0c\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\uff08Shader\uff09\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002\u4e0b\u56fe\u7b80\u5355\u7684\u5c55\u793a\u4e86OpenGL\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff1a \u8be5\u6e32\u67d3\u65b9\u5f0f\u6700\u521d\u5c06\u4ee5\u9876\u70b9\u7f13\u51b2\u533a\u4e3a\u5f62\u5f0f\u7684\u4e00\u7cfb\u5217\u9876\u70b9\u4f5c\u4e3a\u8f93\u5165\u3002\u4f46\u662f\uff0c\u4ec0\u4e48\u662f\u9876\u70b9\uff1f\u9876\u70b9\uff08Vertex\uff09\u662f\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002\u5982\u4f55\u63cf\u8ff0\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4e00\u4e2a\u70b9\u5462\uff1f\u901a\u8fc7\u6307\u5b9a\u5176X\u3001Y\u548cZ\u5750\u6807\u3002\u4ec0\u4e48\u662f\u9876\u70b9\u7f13\u51b2\u533a\uff1f\u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\u662f\u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u53e6\u4e00\u79cd\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u8fd9\u4e9b\u9876\u70b9\u7531\u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\u5904\u7406\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u529f\u80fd\u662f\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002\u8be5\u7740\u8272\u5668\u8fd8\u53ef\u4ee5\u751f\u6210\u4e0e\u989c\u8272\u6216\u7eb9\u7406\u76f8\u5173\u7684\u5176\u4ed6\u8f93\u51fa\uff0c\u4f46\u5176\u4e3b\u8981\u76ee\u7684\u8fd8\u662f\u5c06\u9876\u70b9\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\uff0c\u5373\u751f\u6210\u70b9\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002\u5b83\u4f9d\u7167\u9876\u70b9\u50a8\u5b58\u7684\u987a\u5e8f\uff0c\u4f7f\u7528\u4e0d\u540c\u7684\u6a21\u578b\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002\u4e3a\u4ec0\u4e48\u662f\u4e09\u89d2\u5f62\uff1f\u4e09\u89d2\u5f62\u5c31\u662f\u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\uff0c\u5b83\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u53ef\u4ee5\u7ec4\u5408\u548c\u53d8\u6362\uff0c\u4ee5\u6784\u5efa\u590d\u6742\u7684\u4e09\u7ef4\u573a\u666f\u3002\u6b64\u9636\u6bb5\u8fd8\u53ef\u4ee5\u4f7f\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6765\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\u9636\u6bb5\u63a5\u6536\u6b64\u524d\u751f\u6210\u7684\u4e09\u89d2\u5f62\uff0c\u526a\u8f91\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u8fd9\u4e9b\u7247\u5143\u5c06\u5728\u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\u88ab\u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\u4f7f\u7528\uff0c\u4ee5\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002\u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\u662f\u56fe\u5f62\u7ba1\u7ebf\u7684\u6700\u7ec8\u8f93\u51fa\uff0c\u5b83\u50a8\u5b58\u4e86\u6bcf\u4e2a\u50cf\u7d20\u5e94\u8be5\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u7684\u503c\u3002 \u6ce8\u610f\uff0c\u663e\u5361\u88ab\u8bbe\u8ba1\u6210\u5e76\u884c\u5904\u7406\u4e0a\u8ff0\u6240\u6709\u64cd\u4f5c\uff0c\u8f93\u5165\u7684\u6570\u636e\u53ef\u4ee5\u5e76\u884c\u5904\u7406\u4ee5\u751f\u6210\u6700\u7ec8\u573a\u666f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u7b2c\u4e00\u4e2a\u7740\u8272\u5668\u7a0b\u5e8f\u3002\u7740\u8272\u5668\u662f\u4f7f\u7528\u57fa\u4e8eANSI C\u7684OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\u7f16\u5199\u7684\u3002\u9996\u5148\uff0c\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a\u201c vertex.vs \u201d\uff08\u6269\u5c55\u540d\u4e3a\u9876\u70b9\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; void main() { gl_Position = vec4(position, 1.0); } \u7b2c\u4e00\u884c\u662f\u4e00\u4e2a\u8868\u793a\u6211\u4eec\u6b63\u4f7f\u7528\u7684GLSL\u8bed\u8a00\u7248\u672c\u7684\u6807\u8bc6\u7b26\u3002\u4e0b\u8868\u662fGLSL\u7248\u672c\u3001\u4e0e\u8be5\u7248\u672c\u5339\u914d\u7684OpenGL\u7248\u672c\u548c\u4f7f\u7528\u65b9\u6cd5\uff08\u6765\u81ea\u7ef4\u57fa\u767e\u79d1\uff1a https://en.wikipedia.org/wiki/OpenGL_Shading_Language#Versions \uff09\uff1a GLSL\u7248\u672c OpenGL\u7248\u672c \u7740\u8272\u5668\u6807\u8bc6\u7b26 1.10.59 2.0 #version 110 1.20.8 2.1 #version 120 1.30.10 3.0 #version 130 1.40.08 3.1 #version 140 1.50.11 3.2 #version 150 3.30.6 3.3 #version 330 4.00.9 4.0 #version 400 4.10.6 4.1 #version 410 4.20.11 4.2 #version 420 4.30.8 4.3 #version 430 4.40 4.4 #version 440 4.50 4.5 #version 450 \u7b2c\u4e8c\u884c\u6307\u5b9a\u6b64\u7740\u8272\u5668\u7684\u8f93\u5165\u683c\u5f0f\u3002OpenGL\u7f13\u51b2\u533a\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u662f\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u8be5\u8bed\u8a00\u4e0d\u4f1a\u5f3a\u8feb\u4f60\u4f20\u9012\u9884\u5b9a\u4e49\u8bed\u8a00\u7684\u4efb\u4f55\u6307\u5b9a\u6570\u636e\u7ed3\u6784\u3002\u4ece\u7740\u8272\u5668\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u5b83\u671f\u671b\u63a5\u6536\u4e00\u4e2a\u5b58\u6709\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002\u5b83\u53ef\u4ee5\u662f\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4e00\u4e2a\u6709\u4e00\u4e9b\u9644\u52a0\u4fe1\u606f\u7684\u4f4d\u7f6e\uff0c\u6216\u8005\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\u3002\u9876\u70b9\u7740\u8272\u5668\u53ea\u63a5\u6536\u6d6e\u70b9\u6570\u7ec4\u3002\u5f53\u586b\u5145\u7f13\u51b2\u533a\u65f6\uff0c\u6211\u4eec\u5b9a\u4e49\u8981\u7531\u7740\u8272\u5668\u5904\u7406\u7684\u7f13\u51b2\u533a\u5757\u3002 \u9996\u5148\uff0c\u9700\u8981\u628a\u8fd9\u4e9b\u5757\u53d8\u6210\u5bf9\u6211\u4eec\u6709\u610f\u4e49\u7684\u6570\u636e\u3002\u73b0\u5728\u89c4\u5b9a\u4ece\u4f4d\u7f6e0\u5f00\u59cb\uff0c\u6211\u4eec\u671f\u671b\u63a5\u6536\u7531\u4e09\u4e2a\u5c5e\u6027(X, Y, Z)\u7ec4\u6210\u7684\u5411\u91cf\u3002 \u7740\u8272\u5668\u6709\u4e2a main \u4ee3\u7801\u5757\uff0c\u5c31\u50cf\u4efb\u4f55C\u8bed\u8a00\u7a0b\u5e8f\u4e00\u6837\uff0c\u4e0a\u8ff0\u793a\u4f8b\u662f\u975e\u5e38\u7b80\u5355\u7684\u3002\u5b83\u53ea\u662f\u5c06\u63a5\u6536\u5230\u7684\u5750\u6807\u4e0d\u7ecf\u4efb\u4f55\u53d8\u6362\u5730\u8fd4\u56de\u5230 gl_Position \u3002\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u4e09\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\u88ab\u8f6c\u6362\u6210\u56db\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\uff08 vec4 \uff09\u3002\u8fd9\u662f\u56e0\u4e3a gl_Position \u4ec5\u63a5\u6536 vec4 \u7c7b\u578b\u7684\u6570\u636e\uff0c\u56e0\u4e3a\u5b83\u662f\u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u5e0c\u671b\u63a5\u6536\u5230\u5f62\u4f3c(X, Y, Z, W)\u7684\u4e1c\u897f\uff0c\u5176\u4e2dW\u4ee3\u8868\u4e00\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u3002\u4e3a\u4ec0\u4e48\u8fd8\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u7ef4\u5ea6\uff1f\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u6211\u4eec\u9700\u8981\u505a\u7684\u5927\u90e8\u5206\u64cd\u4f5c\u90fd\u662f\u57fa\u4e8e\u5411\u91cf\u548c\u77e9\u9635\u7684\u3002\u5982\u679c\u6ca1\u6709\u989d\u5916\u7684\u7ef4\u5ea6\uff0c\u4e00\u4e9b\u64cd\u4f5c\u4e0d\u80fd\u7ec4\u5408\u3002\u4f8b\u5982\uff0c\u4e0d\u80fd\u628a\u65cb\u8f6c\u548c\u4f4d\u79fb\u64cd\u4f5c\u7ec4\u5408\u8d77\u6765\u3002\uff08\u5982\u679c\u4f60\u60f3\u5b66\u4e60\u66f4\u591a\u6709\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u77e5\u8bc6\uff0c\u8fd9\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u5141\u8bb8\u6211\u4eec\u7ec4\u5408\u4eff\u5c04\u548c\u7ebf\u6027\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7\u9605\u8bfb\u300a3D Math Primer for Graphics and Game Development\u300b\uff08\u4f5c\u8005\u662fFletcher Dunn \u548c Ian Parberry\uff09\u6765\u66f4\u591a\u5730\u4e86\u89e3\u8fd9\u4e00\u70b9\u3002\uff09 \u73b0\u5728\u6765\u770b\u770b\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\u3002\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a fragment.fs \uff08\u6269\u5c55\u540d\u7247\u5143\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; void main() { fragColor = vec4(0.0, 0.5, 0.5, 1.0); } \u8be5\u7ed3\u6784\u4e0e\u6211\u4eec\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\u3002\u73b0\u5728\uff0c\u5b83\u5c06\u4e3a\u6bcf\u4e2a\u7247\u5143\u8bbe\u7f6e\u56fa\u5b9a\u7684\u989c\u8272\u3002\u8f93\u51fa\u503c\u88ab\u5b9a\u4e49\u4e3a\u7b2c\u4e8c\u884c\u7684 vec4 \u7c7b\u578b\u7684 fragColor \u53d8\u91cf\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u7740\u8272\u5668\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u4eec\u5462\uff1f\u4ee5\u4e0b\u662f\u6211\u4eec\u8981\u505a\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\uff1a 1. \u521b\u5efaOpenGL\u7a0b\u5e8f\u3002 2. \u8f7d\u5165\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6587\u4ef6\u3002 3. \u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u5e76\u6307\u5b9a\u5b83\u7684\u7c7b\u578b\uff08\u9876\u70b9\u6216\u7247\u5143\uff09\u3002 4. \u7f16\u8bd1\u7740\u8272\u5668\u3002 5. \u5c06\u7740\u8272\u5668\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e0a\u3002 6. \u8fde\u63a5\u7a0b\u5e8f\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u5c06\u4f1a\u88ab\u8f7d\u5165\u5230\u663e\u5361\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5f15\u7528\u7a0b\u5e8fID\u6765\u4f7f\u7528\u5b83\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL20.*; public class ShaderProgram { private final int programId; private int vertexShaderId; private int fragmentShaderId; public ShaderProgram() throws Exception { programId = glCreateProgram(); if (programId == 0) { throw new Exception(\"Could not create Shader\"); } } public void createVertexShader(String shaderCode) throws Exception { vertexShaderId = createShader(shaderCode, GL_VERTEX_SHADER); } public void createFragmentShader(String shaderCode) throws Exception { fragmentShaderId = createShader(shaderCode, GL_FRAGMENT_SHADER); } protected int createShader(String shaderCode, int shaderType) throws Exception { int shaderId = glCreateShader(shaderType); if (shaderId == 0) { throw new Exception(\"Error creating shader. Type: \" + shaderType); } glShaderSource(shaderId, shaderCode); glCompileShader(shaderId); if (glGetShaderi(shaderId, GL_COMPILE_STATUS) == 0) { throw new Exception(\"Error compiling Shader code: \" + glGetShaderInfoLog(shaderId, 1024)); } glAttachShader(programId, shaderId); return shaderId; } public void link() throws Exception { glLinkProgram(programId); if (glGetProgrami(programId, GL_LINK_STATUS) == 0) { throw new Exception(\"Error linking Shader code: \" + glGetProgramInfoLog(programId, 1024)); } if (vertexShaderId != 0) { glDetachShader(programId, vertexShaderId); } if (fragmentShaderId != 0) { glDetachShader(programId, fragmentShaderId); } glValidateProgram(programId); if (glGetProgrami(programId, GL_VALIDATE_STATUS) == 0) { System.err.println(\"Warning validating Shader code: \" + glGetProgramInfoLog(programId, 1024)); } } public void bind() { glUseProgram(programId); } public void unbind() { glUseProgram(0); } public void cleanup() { unbind(); if (programId != 0) { glDeleteProgram(programId); } } } ShaderProgram \u7c7b\u7684\u6784\u9020\u51fd\u6570\u5728OpenGL\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7a0b\u5e8f\uff0c\u5e76\u63d0\u4f9b\u6dfb\u52a0\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u7684\u65b9\u6cd5\u3002\u8fd9\u4e9b\u7740\u8272\u5668\u88ab\u7f16\u8bd1\u5e76\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e2d\u3002\u5f53\u6240\u6709\u7684\u7740\u8272\u5668\u90fd\u88ab\u7ed1\u5b9a\u65f6\uff0c\u5e94\u8be5\u8c03\u7528 link \u65b9\u6cd5\uff0c\u6765\u8fde\u63a5\u6240\u6709\u4ee3\u7801\u5e76\u9a8c\u8bc1\u6240\u6709\u64cd\u4f5c\u90fd\u5df2\u6b63\u786e\u5730\u5b8c\u6210\u3002 \u4e00\u65e6\u7740\u8272\u5668\u7a0b\u5e8f\u88ab\u8fde\u63a5\uff0c\u7f16\u8bd1\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u88ab\u91ca\u653e\uff08\u901a\u8fc7\u8c03\u7528 glDetachShader \u65b9\u6cd5\uff09\u3002 \u9a8c\u8bc1\u662f\u901a\u8fc7\u8c03\u7528 glValidateProgram \u65b9\u6cd5\u5b8c\u6210\u7684\u3002\u6b64\u65b9\u6cd5\u4e3b\u8981\u7528\u4e8e\u8c03\u8bd5\uff0c\u5f53\u6e38\u620f\u5230\u8fbe\u751f\u4ea7\u9636\u6bb5\u65f6\uff0c\u5e94\u5c06\u5176\u5220\u9664\u3002\u6b64\u65b9\u6cd5\u5c06\u9a8c\u8bc1\u5728 \u5f53\u524dOpenGL\u72b6\u6001 \u4e0b\u7740\u8272\u5668\u662f\u5426\u6b63\u786e\u3002\u8fd9\u610f\u5473\u7740\uff0c\u5373\u4f7f\u7740\u8272\u5668\u662f\u6b63\u786e\u7684\uff0c\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u4e5f\u53ef\u80fd\u9a8c\u8bc1\u5931\u8d25\uff0c\u8fd9\u662f\u56e0\u4e3a\u5f53\u524d\u72b6\u6001\u4e0d\u591f\u5b8c\u6574\uff08\u4e00\u4e9b\u6570\u636e\u53ef\u80fd\u5c1a\u672a\u52a0\u8f7d\uff09\uff0c\u65e0\u6cd5\u8fd0\u884c\u7740\u8272\u5668\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u9519\u8bef\u4fe1\u606f\u8f93\u51fa\u5230\u6807\u51c6\u9519\u8bef\u8f93\u51fa\u4e2d\u3002 ShaderProgram \u7c7b\u8fd8\u63d0\u4f9b\u4e86\u5728\u6e32\u67d3\u65f6\u6fc0\u6d3b\u8be5\u7a0b\u5e8f\uff08\u7ed1\u5b9a\uff09\u548c\u505c\u6b62\u4f7f\u7528\u5b83\uff08\u89e3\u7ed1\uff09\u7684\u65b9\u6cd5\u3002\u6700\u540e\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\uff0c\u7528\u4e8e\u5728\u5b83\u4e0d\u518d\u88ab\u9700\u8981\u65f6\uff0c\u91ca\u653e\u6240\u6709\u8d44\u6e90\u3002 \u65e2\u7136\u6709\u4e00\u4e2a\u6e05\u7406\u65b9\u6cd5\uff0c\u8ba9\u6211\u4eec\u66f4\u6539 IGameLogic \u63a5\u53e3\u6765\u6dfb\u52a0\u4e00\u4e2a cleanup \u65b9\u6cd5\uff1a void cleanup(); \u8be5\u65b9\u6cd5\u5c06\u5728\u6e38\u620f\u5faa\u73af\u7ed3\u675f\u65f6\u8c03\u7528\uff0c\u6240\u4ee5\u9700\u8981\u4fee\u6539 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } finally { cleanup(); } } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u7740\u8272\u5668\u6765\u663e\u793a\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002\u9996\u5148\uff0c\u6211\u4eec\u8981\u521b\u5efa\u7740\u8272\u5668\u7a0b\u5e8f\uff1a public void init() throws Exception { shaderProgram = new ShaderProgram(); shaderProgram.createVertexShader(Utils.loadResource(\"/vertex.vs\")); shaderProgram.createFragmentShader(Utils.loadResource(\"/fragment.fs\")); shaderProgram.link(); } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4ece\u7c7b\u8def\u5f84\u4e2d\u53d6\u5f97\u6587\u4ef6\u5185\u5bb9\u7684\u65b9\u6cd5\uff0c\u6b64\u65b9\u6cd5\u7528\u4e8e\u53d6\u5f97\u6211\u4eec\u7684\u7740\u8272\u5668\u4ee3\u7801\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u628a\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e3a\u4e00\u7ec4\u6d6e\u70b9\u6570\uff0c\u521b\u5efa\u4e00\u4e2a\u4e00\u7ef4\u6d6e\u70b9\u6570\u7ec4\uff0c\u5b83\u5c06\u5b9a\u4e49\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6570\u7ec4\u4e2d\u6ca1\u6709\u6570\u636e\u7ed3\u6784\u3002\u5c31\u76ee\u524d\u800c\u8a00\uff0cOpenGL\u65e0\u6cd5\u77e5\u9053\u8be5\u6570\u7ec4\u7684\u7ed3\u6784\uff0c\u8fd9\u53ea\u662f\u4e00\u7ec4\u6d6e\u70b9\u6570\uff1a float[] vertices = new float[]{ 0.0f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f }; \u4e0b\u56fe\u4f53\u73b0\u4e86\u5728\u5750\u6807\u7cfb\u4e2d\u7684\u4e09\u89d2\u5f62\u3002 \u73b0\u5728\u6211\u4eec\u6709\u4e86\u5750\u6807\uff0c\u9700\u8981\u628a\u5b83\u4eec\u50a8\u5b58\u5230\u663e\u5361\u4e2d\uff0c\u5e76\u544a\u8bc9OpenGL\u5b83\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u5c06\u4ecb\u7ecd\u4e24\u4e2a\u91cd\u8981\u7684\u6982\u5ff5\uff0c\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\u548c\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\u3002\u5982\u679c\u4f60\u5bf9\u63a5\u4e0b\u6765\u7684\u4ee3\u7801\u611f\u5230\u56f0\u60d1\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u73b0\u5728\u6240\u505a\u7684\u662f\u628a\u5c06\u8981\u7ed8\u5236\u7684\u6a21\u578b\u5bf9\u8c61\u7684\u6570\u636e\u4f20\u9012\u5230\u663e\u5b58\u4e2d\u3002\u5f53\u50a8\u5b58\u5b83\u7684\u65f6\u5019\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2aID\uff0c\u7a0d\u540e\u7ed8\u5236\u65f6\u4f1a\u4f7f\u7528\u5b83\u3002 \u5148\u4ecb\u7ecd\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08VBO\uff09\u5427\uff0cVBO\u53ea\u662f\u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7528\u6765\u6682\u5b58\u4e00\u7ec4\u7528\u4e8e\u5efa\u6a21\u4e09\u89d2\u5f62\u7684\u6d6e\u70b9\u6570\u7684\u5730\u65b9\u3002\u5982\u4e0a\u6240\u8ff0\uff0cOpenGL\u5bf9\u6211\u4eec\u7684\u6570\u636e\u7ed3\u6784\u4e00\u65e0\u6240\u77e5\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u4e0d\u4ec5\u53ef\u4ee5\u50a8\u5b58\u5750\u6807\uff0c\u8fd8\u53ef\u4ee5\u50a8\u5b58\u5176\u4ed6\u4fe1\u606f\uff0c\u6bd4\u5982\u7eb9\u7406\u3001\u989c\u8272\u7b49\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\u662f\u4e00\u4e2a\u5bf9\u8c61\uff0c\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u901a\u5e38\u88ab\u79f0\u4e3a\u5c5e\u6027\u5217\u8868\u7684VBO\u3002\u6bcf\u4e2a\u5c5e\u6027\u5217\u8868\u53ef\u4ee5\u4fdd\u5b58\u4e00\u79cd\u7c7b\u578b\u7684\u6570\u636e\uff1a\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\u3002\u5728\u6bcf\u4e2a\u6e32\u67d3\u95f4\u9694\u4e2d\uff0c\u4f60\u53ef\u4ee5\u81ea\u7531\u5730\u50a8\u5b58\u6240\u9700\u7684\u4efb\u4f55\u6570\u636e\u3002 \u4e00\u4e2aVAO\u5c31\u50cf\u662f\u4e00\u4e2a\u5305\u88c5\uff0c\u5b83\u6309\u4e00\u7ec4\u5b9a\u4e49\u5bf9\u50a8\u5b58\u5728\u663e\u5361\u4e2d\u7684\u6570\u636e\u5206\u7ec4\u3002\u5f53\u521b\u5efa\u4e00\u4e2aVAO\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u4e00\u4e2aID\u3002\u6211\u4eec\u4f7f\u7528\u6b64ID\u6765\u6e32\u67d3\u5b83\u548c\u4f7f\u7528\u5b83\u5728\u521b\u5efa\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002\u9996\u5148\u8981\u505a\u7684\u4e8b\u5c31\u662f\u628a\u6d6e\u70b9\u6570\u50a8\u5b58\u5728\u4e00\u4e2a FloatBuffer \u4e2d\u3002\u8fd9\u4e3b\u8981\u662f\u56e0\u4e3a\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u57fa\u4e8eC\u8bed\u8a00\u7684OpenGL\u5e93\u7684\u63a5\u53e3\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u6d6e\u70b9\u6570\u7ec4\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u5e93\u7ba1\u7406\u7684\u4e1c\u897f\u3002 FloatBuffer verticesBuffer = MemoryUtil.memAllocFloat(vertices.length); verticesBuffer.put(vertices).flip(); \u6211\u4eec\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u5728\u5806\u5916\u5185\u5b58\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4ee5\u4fbfOpenGL\u5e93\u8bbf\u95ee\u5b83\u3002\u5728\u50a8\u5b58\u4e86\u6570\u636e\uff08\u8c03\u7528 put \u65b9\u6cd5\uff09\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8c03\u7528 flip \u65b9\u6cd5\u5c06\u7f13\u51b2\u533a\u7684\u4f4d\u7f6e\u91cd\u7f6e\u4e3a0\uff08\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9\u5b83\u7684\u5199\u5165\uff09\u3002\u8bb0\u4f4f\uff0cJava\u4e2d\u7684\u5bf9\u8c61\uff0c\u88ab\u5206\u914d\u5728\u4e00\u4e2a\u53eb\u5806\uff08Heap\uff09\u7684\u5185\u5b58\u7a7a\u95f4\u3002\u5806\u662fJVM\u5185\u5b58\u4e2d\u4fdd\u7559\u7684\u4e00\u5927\u5806\u5185\u5b58\uff0c\u50a8\u5b58\u5728\u5806\u4e2d\u7684\u5bf9\u8c61\u4e0d\u80fd\u901a\u8fc7\u672c\u5730\u4ee3\u7801\u8bbf\u95ee\uff08JNI\uff0c\u8fd9\u79cd\u673a\u5236\u4f7f\u5f97Java\u4e0d\u80fd\u76f4\u63a5\u8c03\u7528\u672c\u5730\u4ee3\u7801\uff09\u3002Java\u4ee3\u7801\u548c\u672c\u5730\u4ee3\u7801\u76f4\u63a5\u5171\u4eab\u5185\u5b58\u6570\u636e\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u5728Java\u4e2d\u76f4\u63a5\u5730\u5206\u914d\u5185\u5b58\u3002 \u5982\u679c\u4f60\u6765\u81eaLWJGL\u7684\u65e7\u7248\u672c\uff0c\u5f3a\u8c03\u4e00\u4e9b\u8981\u70b9\u662f\u5f88\u91cd\u8981\u7684\u3002\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e86\uff0c\u6211\u4eec\u4e0d\u4f7f\u7528\u5de5\u5177\u7c7b BufferUtils \uff0c\u800c\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u521b\u5efa\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7531\u4e8e BufferUtils \u4e0d\u662f\u975e\u5e38\u6709\u6548\u7684\uff0c\u5e76\u4e14\u4ec5\u88ab\u7528\u4e8e\u5411\u4e0b\u517c\u5bb9\u3002LWJGL3\u63d0\u4f9b\u4e86\u4e24\u79cd\u7f13\u51b2\u533a\u7684\u7ba1\u7406\u65b9\u6cd5\uff1a \u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\uff0c\u5373\u7531\u5783\u573e\u56de\u6536\u5668\u81ea\u52a8\u56de\u6536\u7684\u7f13\u51b2\u533a\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u77ed\u6682\u7684\u64cd\u4f5c\uff0c\u6216\u8005\u7528\u4e8e\u4f20\u9012\u5230GPU\u7684\u6570\u636e\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u50a8\u5b58\u4e8e\u8fdb\u7a0b\u5185\u5b58\u4e2d\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 org.lwjgl.system.MemoryStack \u5b9e\u73b0\u7684\u3002 \u624b\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002\u6b64\u60c5\u51b5\u4e0b\uff0c\u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u5c0f\u5fc3\u5730\u91ca\u653e\u5b83\u4eec\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u957f\u65f6\u95f4\u7684\u64cd\u4f5c\u6216\u8005\u5927\u91cf\u7684\u6570\u636e\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 MemoryUtil \u7c7b\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u4ee5\u5728\u6b64\u5904\u67e5\u9605\u7ec6\u8282\uff1a https://blog.lwjgl.org/memory-management-in-lwjgl-3/ \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u7684\u6570\u636e\u88ab\u53d1\u9001\u5230GPU\uff0c\u8fd9\u6837\u53ef\u4ee5\u8003\u8651\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\u3002\u4f46\u7a0d\u540e\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u50a8\u5b58\u53ef\u80fd\u9700\u8981\u624b\u52a8\u7ba1\u7406\u7684\u5927\u91cf\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u4f7f\u7528 MemoryUtil \u7c7b\u7684\u539f\u56e0\uff0c\u56e0\u6b64\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u8981\u5728\u6700\u540e\u4e00\u4e2a\u5757\u4e2d\u91ca\u653e\u7f13\u51b2\u533a\u8d44\u6e90\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002 \u73b0\u5728\u9700\u8981\u521b\u5efaVAO\u7136\u540e\u7ed1\u5b9a\u5b83\uff1a vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); \u7136\u540e\u9700\u8981\u521b\u5efaVBO\uff0c\u7ed1\u5b9a\u5b83\u5e76\u5c06\u6570\u636e\u8f93\u5165\uff1a vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); \u63a5\u4e0b\u6765\u662f\u6700\u91cd\u8981\u7684\u90e8\u5206\u3002\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u5c06\u5176\u50a8\u5b58\u5728VAO\u7684\u5c5e\u6027\u5217\u8868\u4e2d\uff0c\u8fd9\u662f\u7528\u4e0b\u8ff0\u4ee3\u7801\u5b8c\u6210\u7684\uff1a glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); \u5b83\u7684\u53c2\u6570\u662f\uff1a index: \u6307\u5b9a\u7740\u8272\u5668\u671f\u671b\u6b64\u6570\u636e\u7684\u4f4d\u7f6e\u3002 size: \u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u7684\u6570\u636e\u6570\uff08\u4ece1\u52304\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u7ef4\u5750\u6807\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u662f3\u3002 type: \u6307\u5b9a\u6570\u7ec4\u4e2d\u6bcf\u4e2a\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u6d6e\u70b9\u6570\u3002 normalized: \u6307\u5b9a\u503c\u662f\u5426\u5e94\u5f52\u4e00\u5316\u3002 stride: \u6307\u5b9a\u8fde\u7eed\u9876\u70b9\u6570\u636e\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\uff08\u7a0d\u540e\u6211\u4eec\u518d\u89e3\u91ca\uff09\u3002 offset: \u6307\u5b9a\u7f13\u51b2\u533a\u4e2d\u7b2c\u4e00\u4e2a\u6570\u636e\u7684\u504f\u79fb\u91cf\u3002 \u5728\u5b8c\u6210\u4e86VBO\u64cd\u4f5c\u4e4b\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u9664\u5b83\u548cVAO\u7684\u7ed1\u5b9a\uff08\u7ed1\u5b9a\u52300\uff09\u3002 // \u89e3\u7ed1VBO glBindBuffer(GL_ARRAY_BUFFER, 0); // \u89e3\u7ed1VAO glBindVertexArray(0); \u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec \u5fc5\u987b \u901a\u8fc7\u624b\u52a8\u8c03\u7528 memFree \u65b9\u6cd5\u91ca\u653e\u7531 FloatBuffer \u5360\u7528\u7684\u5806\u5916\u5185\u5b58\uff0c\u56e0\u4e3aJava\u5783\u573e\u56de\u6536\u4e0d\u4f1a\u6e05\u7406\u5206\u914d\u7684\u5806\u5916\u5185\u5b58\u3002 if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } \u8fd9\u5c31\u662f init \u65b9\u6cd5\u5e94\u6709\u7684\u4ee3\u7801\u3002\u6211\u4eec\u7684\u6570\u636e\u5df2\u7ecf\u5728\u663e\u5361\u4e2d\u51c6\u5907\u4f7f\u7528\u4e86\uff0c\u73b0\u5728\u53ea\u9700\u8981\u4fee\u6539 render \u65b9\u6cd5\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u8fdb\u884c\u6e32\u67d3\u3002 public void render(Window window) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed1\u5b9aVAO glBindVertexArray(vaoId); // \u7ed8\u5236\u9876\u70b9 glDrawArrays(GL_TRIANGLES, 0, 3); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e05\u7406\u7a97\u53e3\uff0c\u7ed1\u5b9a\u7740\u8272\u5668\u7a0b\u5e8f\uff0c\u7ed1\u5b9aVAO\uff0c\u7ed8\u5236\u50a8\u5b58\u5728VAO\u5173\u8054\u7684VBO\u4e2d\u7684\u9876\u70b9\uff0c\u7136\u540e\u8fd8\u539f\u72b6\u6001\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6211\u4eec\u8fd8\u5728 Renderer \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u7528\u4e8e\u91ca\u653e\u8d44\u6e90\u3002 public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u5c31\u8fd9\u6837\uff01\u5982\u679c\u4f60\u5c0f\u5fc3\u5730\u6309\u7740\u4e0a\u8ff0\u6b65\u9aa4\u505a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u7684\u56fe\u50cf\u3002 \u8fd9\u5c31\u662f\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff01\u4f60\u4e5f\u8bb8\u4f1a\u60f3\u8fd9\u5e76\u4e0d\u4f1a\u4f7f\u5b83\u6210\u4e3a\u524d\u5341\u540d\u7684\u6e38\u620f\uff0c\u4f60\u7684\u60f3\u6cd5\u662f\u5bf9\u7684\u3002\u4f60\u4e5f\u53ef\u4ee5\u8ba4\u4e3a\u8fd9\u662f\u4e00\u4ef6\u65e0\u804a\u7684\u4e8b\u60c5\u6765\u753b\u4e00\u4e2a\u65e0\u804a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u6b63\u5728\u4ecb\u7ecd\u5173\u952e\u7684\u6982\u5ff5\uff0c\u5e76\u51c6\u5907\u57fa\u4e8e\u67b6\u6784\u6765\u505a\u66f4\u590d\u6742\u7684\u4e8b\u60c5\uff0c\u8bf7\u8010\u5fc3\u7b49\u5f85\uff0c\u7ee7\u7eed\u9605\u8bfb\u3002","title":"\u6e32\u67d3"},{"location":"04-rendering/#rendering","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u7528OpenGL\u6e32\u67d3\u573a\u666f\u65f6\u8981\u505a\u7684\u4e8b\u9879\u3002\u5982\u679c\u4f60\u5df2\u7ecf\u4e60\u60ef\u4e86OpenGL\u7684\u65e7\u7248\u672c\uff0c\u4e60\u60ef\u4e86\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\uff0c\u4f60\u53ef\u80fd\u4f1a\u8df3\u8fc7\u8fd9\u4e00\u7ae0\uff0c\u4e0d\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u5b83\u9700\u8981\u8fd9\u4e48\u590d\u6742\u3002\u5b83\u5176\u5b9e\u66f4\u7b80\u5355\u3001\u66f4\u7075\u6d3b\uff0c\u4f60\u53ea\u9700\u8981\u7ed9\u5b83\u4e00\u4e2a\u8868\u73b0\u7684\u673a\u4f1a\u3002\u73b0\u4ee3OpenGL\u4f7f\u4f60\u53ea\u9700\u8003\u8651\u4e00\u4e2a\u95ee\u9898\uff0c\u8fd9\u53ef\u4ee5\u4f7f\u4f60\u4ee5\u66f4\u5408\u7406\u7684\u65b9\u5f0f\u7ec4\u7ec7\u4ee3\u7801\u548c\u5f00\u53d1\u3002 \u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u88ab\u7edf\u79f0\u4e3a\u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\u3002OpenGL\u6700\u521d\u7684\u7248\u672c\u4f7f\u7528\u4e86\u4e00\u4e2a\u88ab\u79f0\u4e3a\u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\u7684\u6a21\u578b\u3002\u8be5\u6a21\u578b\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\uff08\u4f8b\u5982\uff0c\u201c\u8bbe\u7f6e\u96fe\u201d\u6216\u201c\u6dfb\u52a0\u5149\u7167\u201d\uff09\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u56fe\u5f62\u7ba1\u7ebf\u7531\u4ee5\u4e0b\u64cd\u4f5c\u6b65\u9aa4\u7ec4\u6210\uff1a OpenGL 2.0 \u5f15\u5165\u4e86\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\u7684\u6982\u5ff5\u3002\u5728\u8be5\u6a21\u578b\u4e2d\uff0c\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\uff08Shader\uff09\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002\u4e0b\u56fe\u7b80\u5355\u7684\u5c55\u793a\u4e86OpenGL\u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff1a \u8be5\u6e32\u67d3\u65b9\u5f0f\u6700\u521d\u5c06\u4ee5\u9876\u70b9\u7f13\u51b2\u533a\u4e3a\u5f62\u5f0f\u7684\u4e00\u7cfb\u5217\u9876\u70b9\u4f5c\u4e3a\u8f93\u5165\u3002\u4f46\u662f\uff0c\u4ec0\u4e48\u662f\u9876\u70b9\uff1f\u9876\u70b9\uff08Vertex\uff09\u662f\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002\u5982\u4f55\u63cf\u8ff0\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4e00\u4e2a\u70b9\u5462\uff1f\u901a\u8fc7\u6307\u5b9a\u5176X\u3001Y\u548cZ\u5750\u6807\u3002\u4ec0\u4e48\u662f\u9876\u70b9\u7f13\u51b2\u533a\uff1f\u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\u662f\u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u53e6\u4e00\u79cd\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u8fd9\u4e9b\u9876\u70b9\u7531\u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\u5904\u7406\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u529f\u80fd\u662f\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002\u8be5\u7740\u8272\u5668\u8fd8\u53ef\u4ee5\u751f\u6210\u4e0e\u989c\u8272\u6216\u7eb9\u7406\u76f8\u5173\u7684\u5176\u4ed6\u8f93\u51fa\uff0c\u4f46\u5176\u4e3b\u8981\u76ee\u7684\u8fd8\u662f\u5c06\u9876\u70b9\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\uff0c\u5373\u751f\u6210\u70b9\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002\u5b83\u4f9d\u7167\u9876\u70b9\u50a8\u5b58\u7684\u987a\u5e8f\uff0c\u4f7f\u7528\u4e0d\u540c\u7684\u6a21\u578b\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002\u4e3a\u4ec0\u4e48\u662f\u4e09\u89d2\u5f62\uff1f\u4e09\u89d2\u5f62\u5c31\u662f\u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\uff0c\u5b83\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u53ef\u4ee5\u7ec4\u5408\u548c\u53d8\u6362\uff0c\u4ee5\u6784\u5efa\u590d\u6742\u7684\u4e09\u7ef4\u573a\u666f\u3002\u6b64\u9636\u6bb5\u8fd8\u53ef\u4ee5\u4f7f\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6765\u5bf9\u9876\u70b9\u8fdb\u884c\u5206\u7ec4\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\u9636\u6bb5\u63a5\u6536\u6b64\u524d\u751f\u6210\u7684\u4e09\u89d2\u5f62\uff0c\u526a\u8f91\u5b83\u4eec\uff0c\u5e76\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u8fd9\u4e9b\u7247\u5143\u5c06\u5728\u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\u88ab\u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\u4f7f\u7528\uff0c\u4ee5\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002\u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\u662f\u56fe\u5f62\u7ba1\u7ebf\u7684\u6700\u7ec8\u8f93\u51fa\uff0c\u5b83\u50a8\u5b58\u4e86\u6bcf\u4e2a\u50cf\u7d20\u5e94\u8be5\u88ab\u7ed8\u5236\u5230\u5c4f\u5e55\u4e0a\u7684\u503c\u3002 \u6ce8\u610f\uff0c\u663e\u5361\u88ab\u8bbe\u8ba1\u6210\u5e76\u884c\u5904\u7406\u4e0a\u8ff0\u6240\u6709\u64cd\u4f5c\uff0c\u8f93\u5165\u7684\u6570\u636e\u53ef\u4ee5\u5e76\u884c\u5904\u7406\u4ee5\u751f\u6210\u6700\u7ec8\u573a\u666f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u7b2c\u4e00\u4e2a\u7740\u8272\u5668\u7a0b\u5e8f\u3002\u7740\u8272\u5668\u662f\u4f7f\u7528\u57fa\u4e8eANSI C\u7684OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\u7f16\u5199\u7684\u3002\u9996\u5148\uff0c\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a\u201c vertex.vs \u201d\uff08\u6269\u5c55\u540d\u4e3a\u9876\u70b9\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; void main() { gl_Position = vec4(position, 1.0); } \u7b2c\u4e00\u884c\u662f\u4e00\u4e2a\u8868\u793a\u6211\u4eec\u6b63\u4f7f\u7528\u7684GLSL\u8bed\u8a00\u7248\u672c\u7684\u6807\u8bc6\u7b26\u3002\u4e0b\u8868\u662fGLSL\u7248\u672c\u3001\u4e0e\u8be5\u7248\u672c\u5339\u914d\u7684OpenGL\u7248\u672c\u548c\u4f7f\u7528\u65b9\u6cd5\uff08\u6765\u81ea\u7ef4\u57fa\u767e\u79d1\uff1a https://en.wikipedia.org/wiki/OpenGL_Shading_Language#Versions \uff09\uff1a GLSL\u7248\u672c OpenGL\u7248\u672c \u7740\u8272\u5668\u6807\u8bc6\u7b26 1.10.59 2.0 #version 110 1.20.8 2.1 #version 120 1.30.10 3.0 #version 130 1.40.08 3.1 #version 140 1.50.11 3.2 #version 150 3.30.6 3.3 #version 330 4.00.9 4.0 #version 400 4.10.6 4.1 #version 410 4.20.11 4.2 #version 420 4.30.8 4.3 #version 430 4.40 4.4 #version 440 4.50 4.5 #version 450 \u7b2c\u4e8c\u884c\u6307\u5b9a\u6b64\u7740\u8272\u5668\u7684\u8f93\u5165\u683c\u5f0f\u3002OpenGL\u7f13\u51b2\u533a\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u662f\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u8be5\u8bed\u8a00\u4e0d\u4f1a\u5f3a\u8feb\u4f60\u4f20\u9012\u9884\u5b9a\u4e49\u8bed\u8a00\u7684\u4efb\u4f55\u6307\u5b9a\u6570\u636e\u7ed3\u6784\u3002\u4ece\u7740\u8272\u5668\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u5b83\u671f\u671b\u63a5\u6536\u4e00\u4e2a\u5b58\u6709\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002\u5b83\u53ef\u4ee5\u662f\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4e00\u4e2a\u6709\u4e00\u4e9b\u9644\u52a0\u4fe1\u606f\u7684\u4f4d\u7f6e\uff0c\u6216\u8005\u6211\u4eec\u60f3\u8981\u7684\u4efb\u4f55\u6570\u636e\u3002\u9876\u70b9\u7740\u8272\u5668\u53ea\u63a5\u6536\u6d6e\u70b9\u6570\u7ec4\u3002\u5f53\u586b\u5145\u7f13\u51b2\u533a\u65f6\uff0c\u6211\u4eec\u5b9a\u4e49\u8981\u7531\u7740\u8272\u5668\u5904\u7406\u7684\u7f13\u51b2\u533a\u5757\u3002 \u9996\u5148\uff0c\u9700\u8981\u628a\u8fd9\u4e9b\u5757\u53d8\u6210\u5bf9\u6211\u4eec\u6709\u610f\u4e49\u7684\u6570\u636e\u3002\u73b0\u5728\u89c4\u5b9a\u4ece\u4f4d\u7f6e0\u5f00\u59cb\uff0c\u6211\u4eec\u671f\u671b\u63a5\u6536\u7531\u4e09\u4e2a\u5c5e\u6027(X, Y, Z)\u7ec4\u6210\u7684\u5411\u91cf\u3002 \u7740\u8272\u5668\u6709\u4e2a main \u4ee3\u7801\u5757\uff0c\u5c31\u50cf\u4efb\u4f55C\u8bed\u8a00\u7a0b\u5e8f\u4e00\u6837\uff0c\u4e0a\u8ff0\u793a\u4f8b\u662f\u975e\u5e38\u7b80\u5355\u7684\u3002\u5b83\u53ea\u662f\u5c06\u63a5\u6536\u5230\u7684\u5750\u6807\u4e0d\u7ecf\u4efb\u4f55\u53d8\u6362\u5730\u8fd4\u56de\u5230 gl_Position \u3002\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u4e09\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\u88ab\u8f6c\u6362\u6210\u56db\u4e2a\u5c5e\u6027\u7684\u5411\u91cf\uff08 vec4 \uff09\u3002\u8fd9\u662f\u56e0\u4e3a gl_Position \u4ec5\u63a5\u6536 vec4 \u7c7b\u578b\u7684\u6570\u636e\uff0c\u56e0\u4e3a\u5b83\u662f\u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u5e0c\u671b\u63a5\u6536\u5230\u5f62\u4f3c(X, Y, Z, W)\u7684\u4e1c\u897f\uff0c\u5176\u4e2dW\u4ee3\u8868\u4e00\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u3002\u4e3a\u4ec0\u4e48\u8fd8\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u7ef4\u5ea6\uff1f\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u6211\u4eec\u9700\u8981\u505a\u7684\u5927\u90e8\u5206\u64cd\u4f5c\u90fd\u662f\u57fa\u4e8e\u5411\u91cf\u548c\u77e9\u9635\u7684\u3002\u5982\u679c\u6ca1\u6709\u989d\u5916\u7684\u7ef4\u5ea6\uff0c\u4e00\u4e9b\u64cd\u4f5c\u4e0d\u80fd\u7ec4\u5408\u3002\u4f8b\u5982\uff0c\u4e0d\u80fd\u628a\u65cb\u8f6c\u548c\u4f4d\u79fb\u64cd\u4f5c\u7ec4\u5408\u8d77\u6765\u3002\uff08\u5982\u679c\u4f60\u60f3\u5b66\u4e60\u66f4\u591a\u6709\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u77e5\u8bc6\uff0c\u8fd9\u4e2a\u989d\u5916\u7684\u7ef4\u5ea6\u5141\u8bb8\u6211\u4eec\u7ec4\u5408\u4eff\u5c04\u548c\u7ebf\u6027\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u901a\u8fc7\u9605\u8bfb\u300a3D Math Primer for Graphics and Game Development\u300b\uff08\u4f5c\u8005\u662fFletcher Dunn \u548c Ian Parberry\uff09\u6765\u66f4\u591a\u5730\u4e86\u89e3\u8fd9\u4e00\u70b9\u3002\uff09 \u73b0\u5728\u6765\u770b\u770b\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\u3002\u5728 resources \u76ee\u5f55\u4e0b\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a fragment.fs \uff08\u6269\u5c55\u540d\u7247\u5143\u7740\u8272\u5668\u82f1\u6587\u7b80\u5199\uff09\u7684\u6587\u4ef6\uff0c\u5185\u5bb9\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; void main() { fragColor = vec4(0.0, 0.5, 0.5, 1.0); } \u8be5\u7ed3\u6784\u4e0e\u6211\u4eec\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\u3002\u73b0\u5728\uff0c\u5b83\u5c06\u4e3a\u6bcf\u4e2a\u7247\u5143\u8bbe\u7f6e\u56fa\u5b9a\u7684\u989c\u8272\u3002\u8f93\u51fa\u503c\u88ab\u5b9a\u4e49\u4e3a\u7b2c\u4e8c\u884c\u7684 vec4 \u7c7b\u578b\u7684 fragColor \u53d8\u91cf\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u7740\u8272\u5668\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u4eec\u5462\uff1f\u4ee5\u4e0b\u662f\u6211\u4eec\u8981\u505a\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\uff1a 1. \u521b\u5efaOpenGL\u7a0b\u5e8f\u3002 2. \u8f7d\u5165\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6587\u4ef6\u3002 3. \u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u5e76\u6307\u5b9a\u5b83\u7684\u7c7b\u578b\uff08\u9876\u70b9\u6216\u7247\u5143\uff09\u3002 4. \u7f16\u8bd1\u7740\u8272\u5668\u3002 5. \u5c06\u7740\u8272\u5668\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e0a\u3002 6. \u8fde\u63a5\u7a0b\u5e8f\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u5c06\u4f1a\u88ab\u8f7d\u5165\u5230\u663e\u5361\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5f15\u7528\u7a0b\u5e8fID\u6765\u4f7f\u7528\u5b83\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL20.*; public class ShaderProgram { private final int programId; private int vertexShaderId; private int fragmentShaderId; public ShaderProgram() throws Exception { programId = glCreateProgram(); if (programId == 0) { throw new Exception(\"Could not create Shader\"); } } public void createVertexShader(String shaderCode) throws Exception { vertexShaderId = createShader(shaderCode, GL_VERTEX_SHADER); } public void createFragmentShader(String shaderCode) throws Exception { fragmentShaderId = createShader(shaderCode, GL_FRAGMENT_SHADER); } protected int createShader(String shaderCode, int shaderType) throws Exception { int shaderId = glCreateShader(shaderType); if (shaderId == 0) { throw new Exception(\"Error creating shader. Type: \" + shaderType); } glShaderSource(shaderId, shaderCode); glCompileShader(shaderId); if (glGetShaderi(shaderId, GL_COMPILE_STATUS) == 0) { throw new Exception(\"Error compiling Shader code: \" + glGetShaderInfoLog(shaderId, 1024)); } glAttachShader(programId, shaderId); return shaderId; } public void link() throws Exception { glLinkProgram(programId); if (glGetProgrami(programId, GL_LINK_STATUS) == 0) { throw new Exception(\"Error linking Shader code: \" + glGetProgramInfoLog(programId, 1024)); } if (vertexShaderId != 0) { glDetachShader(programId, vertexShaderId); } if (fragmentShaderId != 0) { glDetachShader(programId, fragmentShaderId); } glValidateProgram(programId); if (glGetProgrami(programId, GL_VALIDATE_STATUS) == 0) { System.err.println(\"Warning validating Shader code: \" + glGetProgramInfoLog(programId, 1024)); } } public void bind() { glUseProgram(programId); } public void unbind() { glUseProgram(0); } public void cleanup() { unbind(); if (programId != 0) { glDeleteProgram(programId); } } } ShaderProgram \u7c7b\u7684\u6784\u9020\u51fd\u6570\u5728OpenGL\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7a0b\u5e8f\uff0c\u5e76\u63d0\u4f9b\u6dfb\u52a0\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u7684\u65b9\u6cd5\u3002\u8fd9\u4e9b\u7740\u8272\u5668\u88ab\u7f16\u8bd1\u5e76\u7ed1\u5b9a\u5230OpenGL\u7a0b\u5e8f\u4e2d\u3002\u5f53\u6240\u6709\u7684\u7740\u8272\u5668\u90fd\u88ab\u7ed1\u5b9a\u65f6\uff0c\u5e94\u8be5\u8c03\u7528 link \u65b9\u6cd5\uff0c\u6765\u8fde\u63a5\u6240\u6709\u4ee3\u7801\u5e76\u9a8c\u8bc1\u6240\u6709\u64cd\u4f5c\u90fd\u5df2\u6b63\u786e\u5730\u5b8c\u6210\u3002 \u4e00\u65e6\u7740\u8272\u5668\u7a0b\u5e8f\u88ab\u8fde\u63a5\uff0c\u7f16\u8bd1\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u88ab\u91ca\u653e\uff08\u901a\u8fc7\u8c03\u7528 glDetachShader \u65b9\u6cd5\uff09\u3002 \u9a8c\u8bc1\u662f\u901a\u8fc7\u8c03\u7528 glValidateProgram \u65b9\u6cd5\u5b8c\u6210\u7684\u3002\u6b64\u65b9\u6cd5\u4e3b\u8981\u7528\u4e8e\u8c03\u8bd5\uff0c\u5f53\u6e38\u620f\u5230\u8fbe\u751f\u4ea7\u9636\u6bb5\u65f6\uff0c\u5e94\u5c06\u5176\u5220\u9664\u3002\u6b64\u65b9\u6cd5\u5c06\u9a8c\u8bc1\u5728 \u5f53\u524dOpenGL\u72b6\u6001 \u4e0b\u7740\u8272\u5668\u662f\u5426\u6b63\u786e\u3002\u8fd9\u610f\u5473\u7740\uff0c\u5373\u4f7f\u7740\u8272\u5668\u662f\u6b63\u786e\u7684\uff0c\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u4e5f\u53ef\u80fd\u9a8c\u8bc1\u5931\u8d25\uff0c\u8fd9\u662f\u56e0\u4e3a\u5f53\u524d\u72b6\u6001\u4e0d\u591f\u5b8c\u6574\uff08\u4e00\u4e9b\u6570\u636e\u53ef\u80fd\u5c1a\u672a\u52a0\u8f7d\uff09\uff0c\u65e0\u6cd5\u8fd0\u884c\u7740\u8272\u5668\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u9519\u8bef\u4fe1\u606f\u8f93\u51fa\u5230\u6807\u51c6\u9519\u8bef\u8f93\u51fa\u4e2d\u3002 ShaderProgram \u7c7b\u8fd8\u63d0\u4f9b\u4e86\u5728\u6e32\u67d3\u65f6\u6fc0\u6d3b\u8be5\u7a0b\u5e8f\uff08\u7ed1\u5b9a\uff09\u548c\u505c\u6b62\u4f7f\u7528\u5b83\uff08\u89e3\u7ed1\uff09\u7684\u65b9\u6cd5\u3002\u6700\u540e\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\uff0c\u7528\u4e8e\u5728\u5b83\u4e0d\u518d\u88ab\u9700\u8981\u65f6\uff0c\u91ca\u653e\u6240\u6709\u8d44\u6e90\u3002 \u65e2\u7136\u6709\u4e00\u4e2a\u6e05\u7406\u65b9\u6cd5\uff0c\u8ba9\u6211\u4eec\u66f4\u6539 IGameLogic \u63a5\u53e3\u6765\u6dfb\u52a0\u4e00\u4e2a cleanup \u65b9\u6cd5\uff1a void cleanup(); \u8be5\u65b9\u6cd5\u5c06\u5728\u6e38\u620f\u5faa\u73af\u7ed3\u675f\u65f6\u8c03\u7528\uff0c\u6240\u4ee5\u9700\u8981\u4fee\u6539 GameEngine \u7c7b\u7684 run \u65b9\u6cd5\uff1a @Override public void run() { try { init(); gameLoop(); } catch (Exception excp) { excp.printStackTrace(); } finally { cleanup(); } } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u7740\u8272\u5668\u6765\u663e\u793a\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002\u9996\u5148\uff0c\u6211\u4eec\u8981\u521b\u5efa\u7740\u8272\u5668\u7a0b\u5e8f\uff1a public void init() throws Exception { shaderProgram = new ShaderProgram(); shaderProgram.createVertexShader(Utils.loadResource(\"/vertex.vs\")); shaderProgram.createFragmentShader(Utils.loadResource(\"/fragment.fs\")); shaderProgram.link(); } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u4e00\u4e2a\u4ece\u7c7b\u8def\u5f84\u4e2d\u53d6\u5f97\u6587\u4ef6\u5185\u5bb9\u7684\u65b9\u6cd5\uff0c\u6b64\u65b9\u6cd5\u7528\u4e8e\u53d6\u5f97\u6211\u4eec\u7684\u7740\u8272\u5668\u4ee3\u7801\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u628a\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e3a\u4e00\u7ec4\u6d6e\u70b9\u6570\uff0c\u521b\u5efa\u4e00\u4e2a\u4e00\u7ef4\u6d6e\u70b9\u6570\u7ec4\uff0c\u5b83\u5c06\u5b9a\u4e49\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6570\u7ec4\u4e2d\u6ca1\u6709\u6570\u636e\u7ed3\u6784\u3002\u5c31\u76ee\u524d\u800c\u8a00\uff0cOpenGL\u65e0\u6cd5\u77e5\u9053\u8be5\u6570\u7ec4\u7684\u7ed3\u6784\uff0c\u8fd9\u53ea\u662f\u4e00\u7ec4\u6d6e\u70b9\u6570\uff1a float[] vertices = new float[]{ 0.0f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f }; \u4e0b\u56fe\u4f53\u73b0\u4e86\u5728\u5750\u6807\u7cfb\u4e2d\u7684\u4e09\u89d2\u5f62\u3002 \u73b0\u5728\u6211\u4eec\u6709\u4e86\u5750\u6807\uff0c\u9700\u8981\u628a\u5b83\u4eec\u50a8\u5b58\u5230\u663e\u5361\u4e2d\uff0c\u5e76\u544a\u8bc9OpenGL\u5b83\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u5c06\u4ecb\u7ecd\u4e24\u4e2a\u91cd\u8981\u7684\u6982\u5ff5\uff0c\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\u548c\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\u3002\u5982\u679c\u4f60\u5bf9\u63a5\u4e0b\u6765\u7684\u4ee3\u7801\u611f\u5230\u56f0\u60d1\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u73b0\u5728\u6240\u505a\u7684\u662f\u628a\u5c06\u8981\u7ed8\u5236\u7684\u6a21\u578b\u5bf9\u8c61\u7684\u6570\u636e\u4f20\u9012\u5230\u663e\u5b58\u4e2d\u3002\u5f53\u50a8\u5b58\u5b83\u7684\u65f6\u5019\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u4e00\u4e2aID\uff0c\u7a0d\u540e\u7ed8\u5236\u65f6\u4f1a\u4f7f\u7528\u5b83\u3002 \u5148\u4ecb\u7ecd\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08VBO\uff09\u5427\uff0cVBO\u53ea\u662f\u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7528\u6765\u6682\u5b58\u4e00\u7ec4\u7528\u4e8e\u5efa\u6a21\u4e09\u89d2\u5f62\u7684\u6d6e\u70b9\u6570\u7684\u5730\u65b9\u3002\u5982\u4e0a\u6240\u8ff0\uff0cOpenGL\u5bf9\u6211\u4eec\u7684\u6570\u636e\u7ed3\u6784\u4e00\u65e0\u6240\u77e5\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u4e0d\u4ec5\u53ef\u4ee5\u50a8\u5b58\u5750\u6807\uff0c\u8fd8\u53ef\u4ee5\u50a8\u5b58\u5176\u4ed6\u4fe1\u606f\uff0c\u6bd4\u5982\u7eb9\u7406\u3001\u989c\u8272\u7b49\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\u662f\u4e00\u4e2a\u5bf9\u8c61\uff0c\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u901a\u5e38\u88ab\u79f0\u4e3a\u5c5e\u6027\u5217\u8868\u7684VBO\u3002\u6bcf\u4e2a\u5c5e\u6027\u5217\u8868\u53ef\u4ee5\u4fdd\u5b58\u4e00\u79cd\u7c7b\u578b\u7684\u6570\u636e\uff1a\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\u3002\u5728\u6bcf\u4e2a\u6e32\u67d3\u95f4\u9694\u4e2d\uff0c\u4f60\u53ef\u4ee5\u81ea\u7531\u5730\u50a8\u5b58\u6240\u9700\u7684\u4efb\u4f55\u6570\u636e\u3002 \u4e00\u4e2aVAO\u5c31\u50cf\u662f\u4e00\u4e2a\u5305\u88c5\uff0c\u5b83\u6309\u4e00\u7ec4\u5b9a\u4e49\u5bf9\u50a8\u5b58\u5728\u663e\u5361\u4e2d\u7684\u6570\u636e\u5206\u7ec4\u3002\u5f53\u521b\u5efa\u4e00\u4e2aVAO\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u4e00\u4e2aID\u3002\u6211\u4eec\u4f7f\u7528\u6b64ID\u6765\u6e32\u67d3\u5b83\u548c\u4f7f\u7528\u5b83\u5728\u521b\u5efa\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7f16\u5199\u793a\u4f8b\u4ee3\u7801\u3002\u9996\u5148\u8981\u505a\u7684\u4e8b\u5c31\u662f\u628a\u6d6e\u70b9\u6570\u50a8\u5b58\u5728\u4e00\u4e2a FloatBuffer \u4e2d\u3002\u8fd9\u4e3b\u8981\u662f\u56e0\u4e3a\u6211\u4eec\u5fc5\u987b\u4f7f\u7528\u57fa\u4e8eC\u8bed\u8a00\u7684OpenGL\u5e93\u7684\u63a5\u53e3\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u6d6e\u70b9\u6570\u7ec4\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u5e93\u7ba1\u7406\u7684\u4e1c\u897f\u3002 FloatBuffer verticesBuffer = MemoryUtil.memAllocFloat(vertices.length); verticesBuffer.put(vertices).flip(); \u6211\u4eec\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u5728\u5806\u5916\u5185\u5b58\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4ee5\u4fbfOpenGL\u5e93\u8bbf\u95ee\u5b83\u3002\u5728\u50a8\u5b58\u4e86\u6570\u636e\uff08\u8c03\u7528 put \u65b9\u6cd5\uff09\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8c03\u7528 flip \u65b9\u6cd5\u5c06\u7f13\u51b2\u533a\u7684\u4f4d\u7f6e\u91cd\u7f6e\u4e3a0\uff08\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9\u5b83\u7684\u5199\u5165\uff09\u3002\u8bb0\u4f4f\uff0cJava\u4e2d\u7684\u5bf9\u8c61\uff0c\u88ab\u5206\u914d\u5728\u4e00\u4e2a\u53eb\u5806\uff08Heap\uff09\u7684\u5185\u5b58\u7a7a\u95f4\u3002\u5806\u662fJVM\u5185\u5b58\u4e2d\u4fdd\u7559\u7684\u4e00\u5927\u5806\u5185\u5b58\uff0c\u50a8\u5b58\u5728\u5806\u4e2d\u7684\u5bf9\u8c61\u4e0d\u80fd\u901a\u8fc7\u672c\u5730\u4ee3\u7801\u8bbf\u95ee\uff08JNI\uff0c\u8fd9\u79cd\u673a\u5236\u4f7f\u5f97Java\u4e0d\u80fd\u76f4\u63a5\u8c03\u7528\u672c\u5730\u4ee3\u7801\uff09\u3002Java\u4ee3\u7801\u548c\u672c\u5730\u4ee3\u7801\u76f4\u63a5\u5171\u4eab\u5185\u5b58\u6570\u636e\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u5728Java\u4e2d\u76f4\u63a5\u5730\u5206\u914d\u5185\u5b58\u3002 \u5982\u679c\u4f60\u6765\u81eaLWJGL\u7684\u65e7\u7248\u672c\uff0c\u5f3a\u8c03\u4e00\u4e9b\u8981\u70b9\u662f\u5f88\u91cd\u8981\u7684\u3002\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e86\uff0c\u6211\u4eec\u4e0d\u4f7f\u7528\u5de5\u5177\u7c7b BufferUtils \uff0c\u800c\u4f7f\u7528 MemoryUtil \u7c7b\u6765\u521b\u5efa\u7f13\u51b2\u533a\u3002\u8fd9\u662f\u7531\u4e8e BufferUtils \u4e0d\u662f\u975e\u5e38\u6709\u6548\u7684\uff0c\u5e76\u4e14\u4ec5\u88ab\u7528\u4e8e\u5411\u4e0b\u517c\u5bb9\u3002LWJGL3\u63d0\u4f9b\u4e86\u4e24\u79cd\u7f13\u51b2\u533a\u7684\u7ba1\u7406\u65b9\u6cd5\uff1a \u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\uff0c\u5373\u7531\u5783\u573e\u56de\u6536\u5668\u81ea\u52a8\u56de\u6536\u7684\u7f13\u51b2\u533a\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u77ed\u6682\u7684\u64cd\u4f5c\uff0c\u6216\u8005\u7528\u4e8e\u4f20\u9012\u5230GPU\u7684\u6570\u636e\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u50a8\u5b58\u4e8e\u8fdb\u7a0b\u5185\u5b58\u4e2d\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 org.lwjgl.system.MemoryStack \u5b9e\u73b0\u7684\u3002 \u624b\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002\u6b64\u60c5\u51b5\u4e0b\uff0c\u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u5c0f\u5fc3\u5730\u91ca\u653e\u5b83\u4eec\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u9002\u7528\u4e8e\u957f\u65f6\u95f4\u7684\u64cd\u4f5c\u6216\u8005\u5927\u91cf\u7684\u6570\u636e\u3002\u8fd9\u662f\u901a\u8fc7\u4f7f\u7528 MemoryUtil \u7c7b\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u4ee5\u5728\u6b64\u5904\u67e5\u9605\u7ec6\u8282\uff1a https://blog.lwjgl.org/memory-management-in-lwjgl-3/ \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u7684\u6570\u636e\u88ab\u53d1\u9001\u5230GPU\uff0c\u8fd9\u6837\u53ef\u4ee5\u8003\u8651\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\u3002\u4f46\u7a0d\u540e\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u50a8\u5b58\u53ef\u80fd\u9700\u8981\u624b\u52a8\u7ba1\u7406\u7684\u5927\u91cf\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u4f7f\u7528 MemoryUtil \u7c7b\u7684\u539f\u56e0\uff0c\u56e0\u6b64\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u8981\u5728\u6700\u540e\u4e00\u4e2a\u5757\u4e2d\u91ca\u653e\u7f13\u51b2\u533a\u8d44\u6e90\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u81ea\u52a8\u7ba1\u7406\u7f13\u51b2\u533a\u3002 \u73b0\u5728\u9700\u8981\u521b\u5efaVAO\u7136\u540e\u7ed1\u5b9a\u5b83\uff1a vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); \u7136\u540e\u9700\u8981\u521b\u5efaVBO\uff0c\u7ed1\u5b9a\u5b83\u5e76\u5c06\u6570\u636e\u8f93\u5165\uff1a vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); \u63a5\u4e0b\u6765\u662f\u6700\u91cd\u8981\u7684\u90e8\u5206\u3002\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u5c06\u5176\u50a8\u5b58\u5728VAO\u7684\u5c5e\u6027\u5217\u8868\u4e2d\uff0c\u8fd9\u662f\u7528\u4e0b\u8ff0\u4ee3\u7801\u5b8c\u6210\u7684\uff1a glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); \u5b83\u7684\u53c2\u6570\u662f\uff1a index: \u6307\u5b9a\u7740\u8272\u5668\u671f\u671b\u6b64\u6570\u636e\u7684\u4f4d\u7f6e\u3002 size: \u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u7684\u6570\u636e\u6570\uff08\u4ece1\u52304\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u7ef4\u5750\u6807\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u662f3\u3002 type: \u6307\u5b9a\u6570\u7ec4\u4e2d\u6bcf\u4e2a\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u6d6e\u70b9\u6570\u3002 normalized: \u6307\u5b9a\u503c\u662f\u5426\u5e94\u5f52\u4e00\u5316\u3002 stride: \u6307\u5b9a\u8fde\u7eed\u9876\u70b9\u6570\u636e\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\uff08\u7a0d\u540e\u6211\u4eec\u518d\u89e3\u91ca\uff09\u3002 offset: \u6307\u5b9a\u7f13\u51b2\u533a\u4e2d\u7b2c\u4e00\u4e2a\u6570\u636e\u7684\u504f\u79fb\u91cf\u3002 \u5728\u5b8c\u6210\u4e86VBO\u64cd\u4f5c\u4e4b\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u9664\u5b83\u548cVAO\u7684\u7ed1\u5b9a\uff08\u7ed1\u5b9a\u52300\uff09\u3002 // \u89e3\u7ed1VBO glBindBuffer(GL_ARRAY_BUFFER, 0); // \u89e3\u7ed1VAO glBindVertexArray(0); \u4e00\u65e6\u5b8c\u6210\u64cd\u4f5c\uff0c\u6211\u4eec \u5fc5\u987b \u901a\u8fc7\u624b\u52a8\u8c03\u7528 memFree \u65b9\u6cd5\u91ca\u653e\u7531 FloatBuffer \u5360\u7528\u7684\u5806\u5916\u5185\u5b58\uff0c\u56e0\u4e3aJava\u5783\u573e\u56de\u6536\u4e0d\u4f1a\u6e05\u7406\u5206\u914d\u7684\u5806\u5916\u5185\u5b58\u3002 if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } \u8fd9\u5c31\u662f init \u65b9\u6cd5\u5e94\u6709\u7684\u4ee3\u7801\u3002\u6211\u4eec\u7684\u6570\u636e\u5df2\u7ecf\u5728\u663e\u5361\u4e2d\u51c6\u5907\u4f7f\u7528\u4e86\uff0c\u73b0\u5728\u53ea\u9700\u8981\u4fee\u6539 render \u65b9\u6cd5\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u8fdb\u884c\u6e32\u67d3\u3002 public void render(Window window) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed1\u5b9aVAO glBindVertexArray(vaoId); // \u7ed8\u5236\u9876\u70b9 glDrawArrays(GL_TRIANGLES, 0, 3); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e05\u7406\u7a97\u53e3\uff0c\u7ed1\u5b9a\u7740\u8272\u5668\u7a0b\u5e8f\uff0c\u7ed1\u5b9aVAO\uff0c\u7ed8\u5236\u50a8\u5b58\u5728VAO\u5173\u8054\u7684VBO\u4e2d\u7684\u9876\u70b9\uff0c\u7136\u540e\u8fd8\u539f\u72b6\u6001\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6211\u4eec\u8fd8\u5728 Renderer \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u7528\u4e8e\u91ca\u653e\u8d44\u6e90\u3002 public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u5c31\u8fd9\u6837\uff01\u5982\u679c\u4f60\u5c0f\u5fc3\u5730\u6309\u7740\u4e0a\u8ff0\u6b65\u9aa4\u505a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u7684\u56fe\u50cf\u3002 \u8fd9\u5c31\u662f\u6211\u4eec\u7684\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff01\u4f60\u4e5f\u8bb8\u4f1a\u60f3\u8fd9\u5e76\u4e0d\u4f1a\u4f7f\u5b83\u6210\u4e3a\u524d\u5341\u540d\u7684\u6e38\u620f\uff0c\u4f60\u7684\u60f3\u6cd5\u662f\u5bf9\u7684\u3002\u4f60\u4e5f\u53ef\u4ee5\u8ba4\u4e3a\u8fd9\u662f\u4e00\u4ef6\u65e0\u804a\u7684\u4e8b\u60c5\u6765\u753b\u4e00\u4e2a\u65e0\u804a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u6b63\u5728\u4ecb\u7ecd\u5173\u952e\u7684\u6982\u5ff5\uff0c\u5e76\u51c6\u5907\u57fa\u4e8e\u67b6\u6784\u6765\u505a\u66f4\u590d\u6742\u7684\u4e8b\u60c5\uff0c\u8bf7\u8010\u5fc3\u7b49\u5f85\uff0c\u7ee7\u7eed\u9605\u8bfb\u3002","title":"\u6e32\u67d3\uff08Rendering\uff09"},{"location":"05-more-on-rendering/","text":"\u6e32\u67d3\u8865\u5145\uff08More on Rendering\uff09 \u672c\u7ae0\u6211\u4eec\u5c06\u7ee7\u7eed\u8bb2\u8ff0OpenGL\u5982\u4f55\u6e32\u67d3\u7269\u4f53\u3002\u4e3a\u4e86\u6574\u7406\u4ee3\u7801\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Mesh \u7684\u65b0\u7c7b\uff0c\u628a\u4e00\u4e2a\u4f4d\u7f6e\u6570\u7ec4\u4f5c\u4e3a\u8f93\u5165\uff0c\u4e3a\u9700\u8981\u52a0\u8f7d\u5230\u663e\u5361\u4e2d\u7684\u6a21\u578b\u521b\u5efaVBO\u548cVAO\u5bf9\u8c61\u3002 package org.lwjglb.engine.graph; import java.nio.FloatBuffer; import org.lwjgl.system.MemoryUtil; import static org.lwjgl.opengl.GL30.*; public class Mesh { private final int vaoId; private final int vboId; private final int vertexCount; public Mesh(float[] positions) { FloatBuffer verticesBuffer = null; try { verticesBuffer = MemoryUtil.memAllocFloat(positions.length); vertexCount = positions.length / 3; verticesBuffer.put(positions).flip(); vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); glBindBuffer(GL_ARRAY_BUFFER, 0); glBindVertexArray(0); } finally { if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } } } public int getVaoId() { return vaoId; } public int getVertexCount() { return vertexCount; } public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } } \u6211\u4eec\u5c06\u5728 DummyGame \u7c7b\u4e2d\u5b9e\u4f8b\u5316 Mesh \uff0c\u7136\u540e\u5c06 Renderer \u7684 init \u65b9\u6cd5\u4e2d\u7684VAO\u548cVBO\u4ee3\u7801\u5220\u9664\u3002\u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\u5c06\u63a5\u6536\u4e00\u4e2a Mesh \u5bf9\u8c61\u6765\u6e32\u67d3\u3002 cleanup \u65b9\u6cd5\u4e5f\u88ab\u7b80\u5316\uff0c\u56e0\u4e3a Mesh \u7c7b\u5df2\u7ecf\u63d0\u4f9b\u4e86\u4e00\u4e2a\u91ca\u653eVAO\u548cVBO\u8d44\u6e90\u7684\u65b9\u6cd5\u3002 public void render(Mesh mesh) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed8\u5236 glBindVertexArray(mesh.getVaoId()); glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } } \u503c\u5f97\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); Mesh \u7c7b\u901a\u8fc7\u5c06\u4f4d\u7f6e\u6570\u7ec4\u9664\u4ee53\u6765\u8ba1\u7b97\u9876\u70b9\u7684\u6570\u76ee\uff08\u56e0\u4e3a\u6211\u4eec\u4f7f\u7528X\uff0cY\u548cZ\u5750\u6807\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u66f4\u590d\u6742\u7684\u5f62\u72b6\u3002\u6765\u8bd5\u8bd5\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4e00\u4e2a\u6b63\u65b9\u5f62\u53ef\u4ee5\u7528\u4e24\u4e2a\u4e09\u89d2\u5f62\u6765\u7ec4\u6210\uff0c\u5982\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u4e2d\u7684\u6bcf\u4e00\u4e2a\u90fd\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V1\u3001V2\u548cV4\uff08\u6a59\u8272\u7684\u70b9\uff09\u7ec4\u6210\uff0c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V4\uff0cV2\u548cV3\uff08\u7eff\u8272\u7684\u70b9\uff09\u7ec4\u6210\u3002\u9876\u70b9\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u8fde\u63a5\uff0c\u56e0\u6b64\u8981\u4f20\u9012\u7684\u6d6e\u70b9\u6570\u6570\u7ec4\u5e94\u8be5\u662f[V1, V2, V4, V4, V2, V3]\u3002\u56e0\u6b64\uff0c DummyGame \u7684 init \u65b9\u6cd5\u5c06\u662f\u8fd9\u6837\u7684\uff1a @Override public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, 0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, }; mesh = new Mesh(positions); } \u73b0\u5728\u4f60\u5e94\u8be5\u53ef\u4ee5\u770b\u5230\u8fd9\u6837\u7684\u4e00\u4e2a\u6b63\u65b9\u5f62\uff1a \u6211\u4eec\u505a\u5b8c\u4e86\u5417\uff1f\u5e76\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4ecd\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u6211\u4eec\u4f7f\u7528\u4e86\u91cd\u590d\u7684\u5750\u6807\u6765\u8868\u793a\u6b63\u65b9\u5f62\uff0c\u4f20\u9012\u4e86\u4e24\u6b21V2\u548cV4\u5750\u6807\u3002\u8fd9\u662f\u4e2a\u5c0f\u56fe\u5f62\uff0c\u5b83\u53ef\u80fd\u4e0d\u662f\u4ec0\u4e48\u5927\u95ee\u9898\uff0c\u4f46\u60f3\u8c61\u5728\u4e00\u4e2a\u66f4\u590d\u6742\u76843D\u6a21\u578b\u4e2d\uff0c\u6211\u4eec\u4f1a\u591a\u6b21\u91cd\u590d\u4f20\u9012\u5750\u6807\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u4e2a\u6d6e\u70b9\u6570\u8868\u793a\u9876\u70b9\u7684\u4f4d\u7f6e\uff0c\u4f46\u6b64\u540e\u5c06\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u6765\u8868\u793a\u7eb9\u7406\u7b49\u3002\u8003\u8651\u5230\u5728\u66f4\u590d\u6742\u7684\u5f62\u72b6\u4e2d\uff0c\u4e09\u89d2\u5f62\u76f4\u63a5\u5171\u4eab\u7684\u9876\u70b9\u6570\u91cf\u751a\u81f3\u66f4\u9ad8\uff0c\u5982\u56fe\u6240\u793a\uff08\u5176\u9876\u70b9\u53ef\u4ee5\u5728\u516d\u4e2a\u4e09\u89d2\u5f62\u4e4b\u95f4\u5171\u4eab\uff09\uff1a \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u66f4\u591a\u7684\u5185\u5b58\u6765\u50a8\u5b58\u91cd\u590d\u7684\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\u5927\u663e\u8eab\u624b\u7684\u65f6\u5019\u3002\u4e3a\u4e86\u7ed8\u5236\u6b63\u65b9\u5f62\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4ee5\u8fd9\u6837\u7684\u65b9\u5f0f\u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\uff1aV1, V2, V3, V4\u3002\u6bcf\u4e2a\u9876\u70b9\u5728\u6570\u7ec4\u4e2d\u90fd\u6709\u4e00\u4e2a\u4f4d\u7f6e\u3002V1\u5728\u4f4d\u7f6e0\u4e0a\uff0cV2\u5728\u4f4d\u7f6e1\u4e0a\uff0c\u7b49\u7b49\uff1a V1 V2 V3 V4 0 1 2 3 \u7136\u540e\uff0c\u6211\u4eec\u901a\u8fc7\u5f15\u7528\u5b83\u4eec\u7684\u4f4d\u7f6e\u6765\u6307\u5b9a\u8fd9\u4e9b\u9876\u70b9\u7684\u987a\u5e8f\uff1a 0 1 3 3 1 2 V1 V2 V4 V4 V2 V3 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Mesh \u7c7b\u6765\u63a5\u6536\u53e6\u4e00\u4e2a\u53c2\u6570\uff0c\u4e00\u4e2a\u7d22\u5f15\u6570\u7ec4\uff0c\u73b0\u5728\u7ed8\u5236\u7684\u9876\u70b9\u6570\u91cf\u662f\u8be5\u7d22\u5f15\u6570\u7ec4\u7684\u957f\u5ea6\u3002 public Mesh(float[] positions, int[] indices) { vertexCount = indices.length; \u5728\u521b\u5efa\u4e86\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\u6765\u50a8\u5b58\u7d22\u5f15\u3002\u56e0\u6b64\uff0c\u91cd\u547d\u540d\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u7684ID\u7684\u53d8\u91cf\u540d\uff0c\u5e76\u4e3a\u7d22\u5f15VBO\uff08 idxVboId \uff09\u521b\u5efa\u4e00\u4e2aID\u3002\u521b\u5efaVBO\u7684\u8fc7\u7a0b\u76f8\u4f3c\uff0c\u4f46\u73b0\u5728\u7684\u7c7b\u578b\u662f GL_ELEMENT_ARRAY_BUFFER \u3002 idxVboId = glGenBuffers(); indicesBuffer = MemoryUtil.memAllocInt(indices.length); indicesBuffer.put(indices).flip(); glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, idxVboId); glBufferData(GL_ELEMENT_ARRAY_BUFFER, indicesBuffer, GL_STATIC_DRAW); memFree(indicesBuffer); \u56e0\u4e3a\u6211\u4eec\u662f\u5728\u5904\u7406\u6574\u6570\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a IntBuffer \u800c\u4e0d\u662f\u4e00\u4e2a FloatBuffer \u3002 \u5c31\u662f\u8fd9\u6837\u3002\u73b0\u5728VAO\u5305\u542b\u4e24\u4e2aVBO\uff0c\u4e00\u4e2a\u50a8\u5b58\u4f4d\u7f6e\uff0c\u53e6\u4e00\u4e2a\u50a8\u5b58\u7d22\u5f15\u3002 Mesh \u7c7b\u7684 cleanUp \u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8981\u91ca\u653e\u53e6\u4e00\u4e2aVBO\u3002 public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664 VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(posVboId); glDeleteBuffers(idxVboId); // \u5220\u9664 VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5728\u7ed8\u5236\u65f6\u8c03\u7528\u7684 glDrawArrays \u65b9\u6cd5\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); \u6539\u4e3a\u8c03\u7528 glDrawElements \u65b9\u6cd5\uff1a glDrawElements(GL_TRIANGLES, mesh.getVertexCount(), GL_UNSIGNED_INT, 0); \u65b9\u6cd5\u7684\u53c2\u6570\u5982\u4e0b\uff1a * mode: \u6307\u5b9a\u6e32\u67d3\u7684\u56fe\u5143\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u4e09\u89d2\u5f62\uff0c\u6ca1\u6709\u53d8\u5316\u3002 * count: \u6307\u5b9a\u8981\u6e32\u67d3\u7684\u9876\u70b9\u6570\u3002 * type: \u6307\u5b9a\u7d22\u5f15\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u65e0\u7b26\u53f7\u6574\u6570\u578b\u3002 * indices: \u6307\u5b9a\u8981\u5f00\u59cb\u4f7f\u7528\u7d22\u5f15\u6e32\u67d3\u7684\u6570\u636e\u504f\u79fb\u91cf\u3002 \u73b0\u5728\u53ef\u4ee5\u4f7f\u7528\u5168\u65b0\u548c\u66f4\u6709\u6548\u7684\u65b9\u6cd5\u6765\u7ed8\u5236\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4ec5\u9700\u6307\u5b9a\u7d22\u5f15\u3002 public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; int[] indices = new int[]{ 0, 1, 3, 3, 1, 2, }; mesh = new Mesh(positions, indices); } \u73b0\u5728\u4e3a\u793a\u4f8b\u4ee3\u7801\u6dfb\u52a0\u989c\u8272\u5427\u3002\u6211\u4eec\u628a\u53e6\u4e00\u7ec4\u6d6e\u70b9\u6570\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u5b83\u50a8\u5b58\u4e86\u6b63\u65b9\u5f62\u4e2d\u6bcf\u4e2a\u9876\u70b9\u7684\u989c\u8272\u3002 public Mesh(float[] positions, float[] colours, int[] indices) { \u4e3a\u4e86\u4f7f\u7528\u8be5\u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\uff0c\u5b83\u5c06\u4e0e\u6211\u4eec\u7684VAO\u76f8\u5173\u8054\u3002 // \u989c\u8272 VBO colourVboId = glGenBuffers(); FloatBuffer colourBuffer = memAllocFloat(colours.length); colourBuffer.put(colours).flip(); glBindBuffer(GL_ARRAY_BUFFER, colourVboId); glBufferData(GL_ARRAY_BUFFER, colourBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 3, GL_FLOAT, false, 0, 0); \u8bf7\u6ce8\u610f glVertexAttribPointer \u65b9\u6cd5\u7684\u8c03\u7528\uff0c\u7b2c\u4e00\u4e2a\u53c2\u6570\u73b0\u5728\u662f\u201c1\u201d\uff0c\u8fd9\u662f\u7740\u8272\u5668\u671f\u671b\u6570\u636e\u7684\u4f4d\u7f6e\u3002\uff08\u5f53\u7136\uff0c\u7531\u4e8e\u589e\u52a0\u4e86\u4e00\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u5728 cleanUp \u65b9\u6cd5\u4e2d\u91ca\u653e\u5b83\uff09\u3002\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u9700\u8981\u5728\u6e32\u67d3\u671f\u95f4\u542f\u7528\u4f4d\u7f6e1\u5904\u7684VAO\u5c5e\u6027\u3002 \u63a5\u4e0b\u6765\u662f\u4fee\u6539\u7740\u8272\u5668\u3002\u9876\u70b9\u7740\u8272\u5668\u73b0\u5728\u9700\u8981\u4e24\u4e2a\u53c2\u6570\uff0c\u5750\u6807\uff08\u4f4d\u7f6e0\uff09\u548c\u989c\u8272\uff08\u4f4d\u7f6e1\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c06\u53ea\u8f93\u51fa\u63a5\u6536\u5230\u7684\u989c\u8272\uff0c\u4ee5\u4fbf\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u5bf9\u5176\u8fdb\u884c\u5904\u7406\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; void main() { gl_Position = vec4(position, 1.0); exColour = inColour; } \u73b0\u5728\uff0c\u7247\u5143\u7740\u8272\u5668\u63a5\u6536\u7531\u9876\u70b9\u7740\u8272\u5668\u5904\u7406\u7684\u989c\u8272\uff0c\u5e76\u4f7f\u7528\u5b83\u6765\u751f\u6210\u989c\u8272\u3002 #version 330 in vec3 exColour; out vec4 fragColor; void main() { fragColor = vec4(exColour, 1.0); } \u6700\u540e\u8981\u505a\u7684\u662f\u4fee\u6539\u6e32\u67d3\u4ee3\u7801\u4ee5\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6570\u636e\u6570\u7ec4\uff1a \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5c06\u5982\u4e0b\u6240\u793a\u7684\u989c\u8272\u6570\u7ec4\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u4e3a\u6b63\u65b9\u5f62\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u7136\u540e\u4f1a\u5f97\u5230\u4e00\u4e2a\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002","title":"\u6e32\u67d3\u8865\u5145"},{"location":"05-more-on-rendering/#more-on-rendering","text":"\u672c\u7ae0\u6211\u4eec\u5c06\u7ee7\u7eed\u8bb2\u8ff0OpenGL\u5982\u4f55\u6e32\u67d3\u7269\u4f53\u3002\u4e3a\u4e86\u6574\u7406\u4ee3\u7801\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Mesh \u7684\u65b0\u7c7b\uff0c\u628a\u4e00\u4e2a\u4f4d\u7f6e\u6570\u7ec4\u4f5c\u4e3a\u8f93\u5165\uff0c\u4e3a\u9700\u8981\u52a0\u8f7d\u5230\u663e\u5361\u4e2d\u7684\u6a21\u578b\u521b\u5efaVBO\u548cVAO\u5bf9\u8c61\u3002 package org.lwjglb.engine.graph; import java.nio.FloatBuffer; import org.lwjgl.system.MemoryUtil; import static org.lwjgl.opengl.GL30.*; public class Mesh { private final int vaoId; private final int vboId; private final int vertexCount; public Mesh(float[] positions) { FloatBuffer verticesBuffer = null; try { verticesBuffer = MemoryUtil.memAllocFloat(positions.length); vertexCount = positions.length / 3; verticesBuffer.put(positions).flip(); vaoId = glGenVertexArrays(); glBindVertexArray(vaoId); vboId = glGenBuffers(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, verticesBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(0); glVertexAttribPointer(0, 3, GL_FLOAT, false, 0, 0); glBindBuffer(GL_ARRAY_BUFFER, 0); glBindVertexArray(0); } finally { if (verticesBuffer != null) { MemoryUtil.memFree(verticesBuffer); } } } public int getVaoId() { return vaoId; } public int getVertexCount() { return vertexCount; } public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(vboId); // \u5220\u9664VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } } \u6211\u4eec\u5c06\u5728 DummyGame \u7c7b\u4e2d\u5b9e\u4f8b\u5316 Mesh \uff0c\u7136\u540e\u5c06 Renderer \u7684 init \u65b9\u6cd5\u4e2d\u7684VAO\u548cVBO\u4ee3\u7801\u5220\u9664\u3002\u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\u5c06\u63a5\u6536\u4e00\u4e2a Mesh \u5bf9\u8c61\u6765\u6e32\u67d3\u3002 cleanup \u65b9\u6cd5\u4e5f\u88ab\u7b80\u5316\uff0c\u56e0\u4e3a Mesh \u7c7b\u5df2\u7ecf\u63d0\u4f9b\u4e86\u4e00\u4e2a\u91ca\u653eVAO\u548cVBO\u8d44\u6e90\u7684\u65b9\u6cd5\u3002 public void render(Mesh mesh) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u7ed8\u5236 glBindVertexArray(mesh.getVaoId()); glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); // \u8fd8\u539f\u72b6\u6001 glBindVertexArray(0); shaderProgram.unbind(); } public void cleanup() { if (shaderProgram != null) { shaderProgram.cleanup(); } } \u503c\u5f97\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); Mesh \u7c7b\u901a\u8fc7\u5c06\u4f4d\u7f6e\u6570\u7ec4\u9664\u4ee53\u6765\u8ba1\u7b97\u9876\u70b9\u7684\u6570\u76ee\uff08\u56e0\u4e3a\u6211\u4eec\u4f7f\u7528X\uff0cY\u548cZ\u5750\u6807\uff09\u3002\u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u66f4\u590d\u6742\u7684\u5f62\u72b6\u3002\u6765\u8bd5\u8bd5\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4e00\u4e2a\u6b63\u65b9\u5f62\u53ef\u4ee5\u7528\u4e24\u4e2a\u4e09\u89d2\u5f62\u6765\u7ec4\u6210\uff0c\u5982\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u4e2d\u7684\u6bcf\u4e00\u4e2a\u90fd\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V1\u3001V2\u548cV4\uff08\u6a59\u8272\u7684\u70b9\uff09\u7ec4\u6210\uff0c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\u7531\u9876\u70b9V4\uff0cV2\u548cV3\uff08\u7eff\u8272\u7684\u70b9\uff09\u7ec4\u6210\u3002\u9876\u70b9\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u8fde\u63a5\uff0c\u56e0\u6b64\u8981\u4f20\u9012\u7684\u6d6e\u70b9\u6570\u6570\u7ec4\u5e94\u8be5\u662f[V1, V2, V4, V4, V2, V3]\u3002\u56e0\u6b64\uff0c DummyGame \u7684 init \u65b9\u6cd5\u5c06\u662f\u8fd9\u6837\u7684\uff1a @Override public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, 0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, }; mesh = new Mesh(positions); } \u73b0\u5728\u4f60\u5e94\u8be5\u53ef\u4ee5\u770b\u5230\u8fd9\u6837\u7684\u4e00\u4e2a\u6b63\u65b9\u5f62\uff1a \u6211\u4eec\u505a\u5b8c\u4e86\u5417\uff1f\u5e76\u6ca1\u6709\uff0c\u4e0a\u8ff0\u4ee3\u7801\u4ecd\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u6211\u4eec\u4f7f\u7528\u4e86\u91cd\u590d\u7684\u5750\u6807\u6765\u8868\u793a\u6b63\u65b9\u5f62\uff0c\u4f20\u9012\u4e86\u4e24\u6b21V2\u548cV4\u5750\u6807\u3002\u8fd9\u662f\u4e2a\u5c0f\u56fe\u5f62\uff0c\u5b83\u53ef\u80fd\u4e0d\u662f\u4ec0\u4e48\u5927\u95ee\u9898\uff0c\u4f46\u60f3\u8c61\u5728\u4e00\u4e2a\u66f4\u590d\u6742\u76843D\u6a21\u578b\u4e2d\uff0c\u6211\u4eec\u4f1a\u591a\u6b21\u91cd\u590d\u4f20\u9012\u5750\u6807\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u4e09\u4e2a\u6d6e\u70b9\u6570\u8868\u793a\u9876\u70b9\u7684\u4f4d\u7f6e\uff0c\u4f46\u6b64\u540e\u5c06\u9700\u8981\u66f4\u591a\u7684\u6570\u636e\u6765\u8868\u793a\u7eb9\u7406\u7b49\u3002\u8003\u8651\u5230\u5728\u66f4\u590d\u6742\u7684\u5f62\u72b6\u4e2d\uff0c\u4e09\u89d2\u5f62\u76f4\u63a5\u5171\u4eab\u7684\u9876\u70b9\u6570\u91cf\u751a\u81f3\u66f4\u9ad8\uff0c\u5982\u56fe\u6240\u793a\uff08\u5176\u9876\u70b9\u53ef\u4ee5\u5728\u516d\u4e2a\u4e09\u89d2\u5f62\u4e4b\u95f4\u5171\u4eab\uff09\uff1a \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u66f4\u591a\u7684\u5185\u5b58\u6765\u50a8\u5b58\u91cd\u590d\u7684\u6570\u636e\uff0c\u8fd9\u5c31\u662f\u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\u5927\u663e\u8eab\u624b\u7684\u65f6\u5019\u3002\u4e3a\u4e86\u7ed8\u5236\u6b63\u65b9\u5f62\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4ee5\u8fd9\u6837\u7684\u65b9\u5f0f\u6307\u5b9a\u6bcf\u4e2a\u9876\u70b9\uff1aV1, V2, V3, V4\u3002\u6bcf\u4e2a\u9876\u70b9\u5728\u6570\u7ec4\u4e2d\u90fd\u6709\u4e00\u4e2a\u4f4d\u7f6e\u3002V1\u5728\u4f4d\u7f6e0\u4e0a\uff0cV2\u5728\u4f4d\u7f6e1\u4e0a\uff0c\u7b49\u7b49\uff1a V1 V2 V3 V4 0 1 2 3 \u7136\u540e\uff0c\u6211\u4eec\u901a\u8fc7\u5f15\u7528\u5b83\u4eec\u7684\u4f4d\u7f6e\u6765\u6307\u5b9a\u8fd9\u4e9b\u9876\u70b9\u7684\u987a\u5e8f\uff1a 0 1 3 3 1 2 V1 V2 V4 V4 V2 V3 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Mesh \u7c7b\u6765\u63a5\u6536\u53e6\u4e00\u4e2a\u53c2\u6570\uff0c\u4e00\u4e2a\u7d22\u5f15\u6570\u7ec4\uff0c\u73b0\u5728\u7ed8\u5236\u7684\u9876\u70b9\u6570\u91cf\u662f\u8be5\u7d22\u5f15\u6570\u7ec4\u7684\u957f\u5ea6\u3002 public Mesh(float[] positions, int[] indices) { vertexCount = indices.length; \u5728\u521b\u5efa\u4e86\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\u6765\u50a8\u5b58\u7d22\u5f15\u3002\u56e0\u6b64\uff0c\u91cd\u547d\u540d\u50a8\u5b58\u4f4d\u7f6e\u7684VBO\u7684ID\u7684\u53d8\u91cf\u540d\uff0c\u5e76\u4e3a\u7d22\u5f15VBO\uff08 idxVboId \uff09\u521b\u5efa\u4e00\u4e2aID\u3002\u521b\u5efaVBO\u7684\u8fc7\u7a0b\u76f8\u4f3c\uff0c\u4f46\u73b0\u5728\u7684\u7c7b\u578b\u662f GL_ELEMENT_ARRAY_BUFFER \u3002 idxVboId = glGenBuffers(); indicesBuffer = MemoryUtil.memAllocInt(indices.length); indicesBuffer.put(indices).flip(); glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, idxVboId); glBufferData(GL_ELEMENT_ARRAY_BUFFER, indicesBuffer, GL_STATIC_DRAW); memFree(indicesBuffer); \u56e0\u4e3a\u6211\u4eec\u662f\u5728\u5904\u7406\u6574\u6570\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a IntBuffer \u800c\u4e0d\u662f\u4e00\u4e2a FloatBuffer \u3002 \u5c31\u662f\u8fd9\u6837\u3002\u73b0\u5728VAO\u5305\u542b\u4e24\u4e2aVBO\uff0c\u4e00\u4e2a\u50a8\u5b58\u4f4d\u7f6e\uff0c\u53e6\u4e00\u4e2a\u50a8\u5b58\u7d22\u5f15\u3002 Mesh \u7c7b\u7684 cleanUp \u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8981\u91ca\u653e\u53e6\u4e00\u4e2aVBO\u3002 public void cleanUp() { glDisableVertexAttribArray(0); // \u5220\u9664 VBO glBindBuffer(GL_ARRAY_BUFFER, 0); glDeleteBuffers(posVboId); glDeleteBuffers(idxVboId); // \u5220\u9664 VAO glBindVertexArray(0); glDeleteVertexArrays(vaoId); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5728\u7ed8\u5236\u65f6\u8c03\u7528\u7684 glDrawArrays \u65b9\u6cd5\uff1a glDrawArrays(GL_TRIANGLES, 0, mesh.getVertexCount()); \u6539\u4e3a\u8c03\u7528 glDrawElements \u65b9\u6cd5\uff1a glDrawElements(GL_TRIANGLES, mesh.getVertexCount(), GL_UNSIGNED_INT, 0); \u65b9\u6cd5\u7684\u53c2\u6570\u5982\u4e0b\uff1a * mode: \u6307\u5b9a\u6e32\u67d3\u7684\u56fe\u5143\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u4e09\u89d2\u5f62\uff0c\u6ca1\u6709\u53d8\u5316\u3002 * count: \u6307\u5b9a\u8981\u6e32\u67d3\u7684\u9876\u70b9\u6570\u3002 * type: \u6307\u5b9a\u7d22\u5f15\u6570\u636e\u7684\u7c7b\u578b\uff0c\u73b0\u5728\u662f\u65e0\u7b26\u53f7\u6574\u6570\u578b\u3002 * indices: \u6307\u5b9a\u8981\u5f00\u59cb\u4f7f\u7528\u7d22\u5f15\u6e32\u67d3\u7684\u6570\u636e\u504f\u79fb\u91cf\u3002 \u73b0\u5728\u53ef\u4ee5\u4f7f\u7528\u5168\u65b0\u548c\u66f4\u6709\u6548\u7684\u65b9\u6cd5\u6765\u7ed8\u5236\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4ec5\u9700\u6307\u5b9a\u7d22\u5f15\u3002 public void init() throws Exception { renderer.init(); float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; int[] indices = new int[]{ 0, 1, 3, 3, 1, 2, }; mesh = new Mesh(positions, indices); } \u73b0\u5728\u4e3a\u793a\u4f8b\u4ee3\u7801\u6dfb\u52a0\u989c\u8272\u5427\u3002\u6211\u4eec\u628a\u53e6\u4e00\u7ec4\u6d6e\u70b9\u6570\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u5b83\u50a8\u5b58\u4e86\u6b63\u65b9\u5f62\u4e2d\u6bcf\u4e2a\u9876\u70b9\u7684\u989c\u8272\u3002 public Mesh(float[] positions, float[] colours, int[] indices) { \u4e3a\u4e86\u4f7f\u7528\u8be5\u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2aVBO\uff0c\u5b83\u5c06\u4e0e\u6211\u4eec\u7684VAO\u76f8\u5173\u8054\u3002 // \u989c\u8272 VBO colourVboId = glGenBuffers(); FloatBuffer colourBuffer = memAllocFloat(colours.length); colourBuffer.put(colours).flip(); glBindBuffer(GL_ARRAY_BUFFER, colourVboId); glBufferData(GL_ARRAY_BUFFER, colourBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 3, GL_FLOAT, false, 0, 0); \u8bf7\u6ce8\u610f glVertexAttribPointer \u65b9\u6cd5\u7684\u8c03\u7528\uff0c\u7b2c\u4e00\u4e2a\u53c2\u6570\u73b0\u5728\u662f\u201c1\u201d\uff0c\u8fd9\u662f\u7740\u8272\u5668\u671f\u671b\u6570\u636e\u7684\u4f4d\u7f6e\u3002\uff08\u5f53\u7136\uff0c\u7531\u4e8e\u589e\u52a0\u4e86\u4e00\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u5728 cleanUp \u65b9\u6cd5\u4e2d\u91ca\u653e\u5b83\uff09\u3002\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u9700\u8981\u5728\u6e32\u67d3\u671f\u95f4\u542f\u7528\u4f4d\u7f6e1\u5904\u7684VAO\u5c5e\u6027\u3002 \u63a5\u4e0b\u6765\u662f\u4fee\u6539\u7740\u8272\u5668\u3002\u9876\u70b9\u7740\u8272\u5668\u73b0\u5728\u9700\u8981\u4e24\u4e2a\u53c2\u6570\uff0c\u5750\u6807\uff08\u4f4d\u7f6e0\uff09\u548c\u989c\u8272\uff08\u4f4d\u7f6e1\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c06\u53ea\u8f93\u51fa\u63a5\u6536\u5230\u7684\u989c\u8272\uff0c\u4ee5\u4fbf\u7247\u5143\u7740\u8272\u5668\u53ef\u4ee5\u5bf9\u5176\u8fdb\u884c\u5904\u7406\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; void main() { gl_Position = vec4(position, 1.0); exColour = inColour; } \u73b0\u5728\uff0c\u7247\u5143\u7740\u8272\u5668\u63a5\u6536\u7531\u9876\u70b9\u7740\u8272\u5668\u5904\u7406\u7684\u989c\u8272\uff0c\u5e76\u4f7f\u7528\u5b83\u6765\u751f\u6210\u989c\u8272\u3002 #version 330 in vec3 exColour; out vec4 fragColor; void main() { fragColor = vec4(exColour, 1.0); } \u6700\u540e\u8981\u505a\u7684\u662f\u4fee\u6539\u6e32\u67d3\u4ee3\u7801\u4ee5\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6570\u636e\u6570\u7ec4\uff1a \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5c06\u5982\u4e0b\u6240\u793a\u7684\u989c\u8272\u6570\u7ec4\u4f20\u9012\u7ed9 Mesh \u7c7b\uff0c\u4e3a\u6b63\u65b9\u5f62\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u7136\u540e\u4f1a\u5f97\u5230\u4e00\u4e2a\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002","title":"\u6e32\u67d3\u8865\u5145\uff08More on Rendering\uff09"},{"location":"06-transformations/","text":"\u53d8\u6362\uff08Transformations\uff09 \u6295\u5f71 \u8ba9\u6211\u4eec\u56de\u770b\u5728\u524d\u4e00\u7ae0\u4e2d\u521b\u5efa\u7684\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002\u5982\u679c\u4ed4\u7ec6\u770b\uff0c\u5b83\u66f4\u50cf\u4e00\u4e2a\u77e9\u5f62\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u5c06\u7a97\u53e3\u7684\u5bbd\u5ea6\u4ece600\u50cf\u7d20\u6539\u4e3a900\u50cf\u7d20\uff0c\u5931\u771f\u5c31\u4f1a\u66f4\u52a0\u660e\u663e\u3002\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\u5462\uff1f \u5982\u679c\u4f60\u67e5\u770b\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u6211\u4eec\u53ea\u662f\u76f4\u63a5\u5730\u4f20\u9012\u5750\u6807\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5f53\u4e00\u4e2a\u9876\u70b9\u7684X\u5750\u6807\u4e3a0.5\u65f6\uff0c\u6211\u4eec\u8ba9OpenGL\u5728\u5c4f\u5e55\u7684X\u5750\u6807\u4e3a0.5\u7684\u4f4d\u7f6e\u7ed8\u5236\u5b83\u3002\u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08\u4ec5\u542bX\u548cY\u8f74\uff09\u3002 \u5c06\u8fd9\u4e9b\u5750\u6807\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807\u7cfb\uff08\u5176\u539f\u70b9\u4f4d\u4e8e\u4e0a\u56fe\u7684\u5de6\u4e0a\u89d2\uff09\uff0c\u9700\u8981\u8003\u8651\u5230\u7a97\u53e3\u7684\u5927\u5c0f\u3002\u56e0\u6b64\uff0c\u5982\u679c\u6211\u4eec\u7684\u7a97\u53e3\u5927\u5c0f\u4e3a900x480\uff0cOpenGL\u5750\u6807(1, 0)\u5c06\u88ab\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807(900, 0)\uff0c\u6700\u7ec8\u521b\u5efa\u4e00\u4e2a\u77e9\u5f62\u800c\u4e0d\u662f\u4e00\u4e2a\u6b63\u65b9\u5f62\u3002 \u4f46\u662f\uff0c\u95ee\u9898\u8fdc\u6bd4\u8fd9\u66f4\u4e25\u91cd\u3002\u5c06\u56db\u8fb9\u5f62\u7684Z\u5750\u6807\u4ece0.0\u4fee\u6539\u4e3a1.0\u548c-1.0\uff0c\u4f60\u53d1\u73b0\u4e86\u4ec0\u4e48\uff1f\u56db\u8fb9\u5f62\u5b8c\u5168\u662f\u7ed8\u5236\u5728\u540c\u4e00\u4e2a\u5730\u65b9\uff0c\u4e0d\u7ba1\u5b83\u662f\u5426\u6cbf\u7740Z\u8f74\u4f4d\u79fb\u3002\u4e3a\u4ec0\u4e48\u4f1a\u53d1\u751f\u8fd9\u79cd\u60c5\u51b5\uff1f\u8fdc\u5904\u7684\u7269\u4f53\u5e94\u8be5\u6bd4\u8fd1\u5904\u7684\u7269\u4f53\u7ed8\u5236\u5f97\u66f4\u5c0f\uff0c\u4f46\u662f\u6211\u4eec\u4f7f\u7528\u76f8\u540c\u7684X\u548cY\u5750\u6807\u7ed8\u5236\u5b83\u4eec\u3002 \u4f46\u7a0d\u7b49\u4e00\u4e0b\uff0c\u8fd9\u4e0d\u5e94\u8be5\u7531Z\u5750\u6807\u6765\u5904\u7406\u5417\uff1f\u8fd9\u534a\u5bf9\u534a\u9519\u3002Z\u5750\u6807\u544a\u8bc9OpenGL\u4e00\u4e2a\u7269\u4f53\u7684\u8fdc\u8fd1\uff0c\u4f46\u662fOpenGL\u5bf9\u4f60\u7684\u7269\u4f53\u7684\u5927\u5c0f\u4e00\u65e0\u6240\u77e5\u3002\u4f60\u53ef\u4ee5\u6709\u4e24\u4e2a\u4e0d\u540c\u5927\u5c0f\u7684\u7269\u4f53\uff0c\u4e00\u4e2a\u66f4\u8fd1\u66f4\u5c0f\uff0c\u4e00\u4e2a\u66f4\u8fdc\u66f4\u5927\uff0c\u800c\u4e14\u53ef\u4ee5\u4ee5\u76f8\u540c\u7684\u5927\u5c0f\u6b63\u786e\u5730\u6295\u5f71\u5230\u5c4f\u5e55\u4e0a\uff08\u6709\u76f8\u540c\u7684\u5c4f\u5e55X\u548cY\u5750\u6807\uff0c\u4f46Z\u5750\u6807\u4e0d\u540c\uff09\u3002OpenGL\u53ea\u4f7f\u7528\u6b63\u5728\u4f20\u9012\u7684\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\u3002 \u65e2\u7136\u5df2\u7ecf\u786e\u8bca\u4e86\u8fd9\u4e2a\u95ee\u9898\uff0c\u8be5\u600e\u4e48\u89e3\u51b3\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\u6216\u622a\u9525\u4f53\uff08Frustum\uff09\u3002\u6295\u5f71\u77e9\u9635\u5c06\u5904\u7406\u7ed8\u5236\u533a\u57df\u7684\u5bbd\u9ad8\u6bd4\uff08\u5927\u5c0f\u4e0e\u9ad8\u5ea6\u4e4b\u95f4\u7684\u5173\u7cfb\uff09\uff0c\u8fd9\u6837\u7269\u4f53\u5c31\u4e0d\u4f1a\u53d8\u5f62\u3002\u5b83\u8fd8\u53ef\u4ee5\u5904\u7406\u8ddd\u79bb\uff0c\u6240\u4ee5\u8f83\u8fdc\u7684\u7269\u4f53\u5c06\u4f1a\u88ab\u7ed8\u5236\u5f97\u66f4\u5c0f\u3002\u6295\u5f71\u77e9\u9635\u8fd8\u5c06\u8003\u8651\u6211\u4eec\u7684\u89c6\u91ce\u548c\u5e94\u8be5\u663e\u793a\u7684\u8ddd\u79bb\u6709\u591a\u8fdc\u3002 \u5bf9\u4e8e\u4e0d\u719f\u6089\u77e9\u9635\u7684\u4eba\uff0c\u77e9\u9635\uff08Matrix\uff09\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\u3002\u77e9\u9635\u4e2d\u7684\u6bcf\u4e2a\u6570\u5b57\u88ab\u79f0\u4e3a\u5143\u7d20\u3002\u77e9\u9635\u9636\u6b21\u662f\u884c\u548c\u5217\u7684\u6570\u91cf\u3002\u4f8b\u5982\uff0c\u6b64\u5904\u662f\u4e00\u4e2a2x2\u77e9\u9635\uff08\u67092\u884c2\u5217\uff09\u3002 \u77e9\u9635\u6709\u8bb8\u591a\u53ef\u4ee5\u5e94\u7528\u4e8e\u5b83\u4eec\u7684\u57fa\u672c\u8fd0\u7b97\uff08\u5982\u52a0\u6cd5\u3001\u4e58\u6cd5\u7b49\uff09\uff0c\u4f60\u53ef\u4ee5\u5728\u6570\u5b66\u4e66\u4e2d\u67e5\u9605\uff0c\u5176\u4e2d\u4e0e\u4e09\u7ef4\u56fe\u5f62\u76f8\u5173\u7684\u77e9\u9635\u5bf9\u7a7a\u95f4\u4e2d\u70b9\u7684\u53d8\u6362\u975e\u5e38\u6709\u7528\u3002 \u4f60\u53ef\u4ee5\u628a\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u6210\u4e00\u4e2a\u6444\u50cf\u673a\uff0c\u5b83\u6709\u4e00\u4e2a\u89c6\u91ce\u548c\u6700\u5c0f\u548c\u6700\u5927\u8ddd\u79bb\u3002\u8be5\u6444\u50cf\u673a\u7684\u53ef\u89c6\u533a\u57df\u662f\u4e00\u4e2a\u622a\u65ad\u7684\u91d1\u5b57\u5854\uff0c\u4e0b\u56fe\u4e3a\u8be5\u533a\u57df\u7684\u4fef\u89c6\u56fe\u3002 \u6295\u5f71\u77e9\u9635\u5c06\u6b63\u786e\u5730\u6295\u5f71\u4e09\u7ef4\u5750\u6807\uff0c\u4ee5\u4fbf\u5b83\u4eec\u80fd\u591f\u5728\u4e8c\u7ef4\u5c4f\u5e55\u4e0a\u6b63\u786e\u5730\u663e\u793a\u3002\u8be5\u77e9\u9635\u7684\u6570\u5b66\u8868\u793a\u5982\u4e0b\uff08\u4e0d\u8981\u5bb3\u6015\uff09\uff1a \u5176\u4e2d\u5c4f\u5e55\u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\u6307\u7684\u662f\u5c4f\u5e55\u5bbd\u5ea6\u4e0e\u5c4f\u5e55\u9ad8\u5ea6\u7684\u5173\u7cfb\uff08 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4=\u5bbd\u5ea6/\u9ad8\u5ea6 \uff09\u3002\u4e3a\u4e86\u83b7\u5f97\u7ed9\u5b9a\u70b9\u7684\u6295\u5f71\u5750\u6807\uff0c\u53ea\u9700\u8981\u5c06\u6295\u5f71\u77e9\u9635\u4e58\u4ee5\u539f\u59cb\u5750\u6807\uff0c\u7ed3\u679c\u662f\u6295\u5f71\u540e\u7684\u53e6\u4e00\u4e2a\u5411\u91cf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u4e00\u7ec4\u6570\u5b66\u5b9e\u4f53\uff0c\u5982\u5411\u91cf\u3001\u77e9\u9635\uff0c\u5e76\u5305\u62ec\u53ef\u4ee5\u5bf9\u5b83\u4eec\u8fdb\u884c\u7684\u8fd0\u7b97\u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4ece\u5934\u5f00\u59cb\u7f16\u5199\u6240\u6709\u7684\u4ee3\u7801\uff0c\u6216\u8005\u4f7f\u7528\u5df2\u5b9e\u73b0\u7684\u5e93\u3002\u5f53\u7136\u6211\u4eec\u4f1a\u9009\u62e9\u5bb9\u6613\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528JOML\uff08Java OpenGL Math Library\uff0cJava OpenGL \u6570\u5b66\u5e93\uff09\u5904\u7406LWJGL\u5185\u7684\u6570\u5b66\u8fd0\u7b97\u3002\u4e3a\u4e86\u4f7f\u7528\u8be5\u5e93\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 pom.xml \u6587\u4ef6\u6dfb\u52a0\u53e6\u4e00\u4e2a\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.joml</groupId> <artifactId>joml</artifactId> <version>${joml.version}</version> </dependency> \u7136\u540e\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u5e93\u7248\u672c\u3002 <properties> [...] <joml.version>1.9.6</joml.version> [...] </properties> \u73b0\u5728\u4e00\u5207\u90fd\u51c6\u5907\u597d\u4e86\uff0c\u6765\u5b9a\u4e49\u6211\u4eec\u7684\u6295\u5f71\u77e9\u9635\u3002\u5728 Renderer \u7c7b\u4e2d\u521b\u5efa Matrix4f \u7c7b\uff08\u7531JOML\u5e93\u63d0\u4f9b\uff09\u7684\u5b9e\u4f8b\u3002 Matrix4f \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a perspective \u65b9\u6cd5\u6765\u521b\u5efa\u6295\u5f71\u77e9\u9635\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u4ee5\u4e0b\u53c2\u6570\uff1a \u89c6\u91ce\uff1a\u53ef\u89c6\u533a\u57df\u89d2\u7684\u5f27\u5ea6\u5927\u5c0f\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u8be5\u503c\u7684\u5e38\u6570\u3002 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4\u3002 \u6700\u8fd1\u89c6\u8ddd\uff08z-near\uff09\u3002 \u6700\u8fdc\u89c6\u8ddd\uff08z-far\uff09\u3002 \u6211\u4eec\u5c06\u5728 init \u65b9\u6cd5\u4e2d\u5b9e\u4f8b\u5316\u8be5\u77e9\u9635\uff0c\u56e0\u6b64\u9700\u8981\u4f20\u9012\u5bf9 Window \u5b9e\u4f8b\u7684\u9634\u5f71\u4ee5\u83b7\u53d6\u7a97\u53e3\u5927\u5c0f\uff08\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u4ee3\u7801\u5982\u4e0b\uff1a /** * \u89c6\u91ce\u5f27\u5ea6 */ private static final float FOV = (float) Math.toRadians(60.0f); private static final float Z_NEAR = 0.01f; private static final float Z_FAR = 1000.f; private Matrix4f projectionMatrix; \u6295\u5f71\u77e9\u9635\u7684\u521b\u5efa\u5982\u4e0b\u6240\u793a\uff1a float aspectRatio = (float) window.getWidth() / window.getHeight(); projectionMatrix = new Matrix4f().perspective(FOV, aspectRatio, Z_NEAR, Z_FAR); \u73b0\u5728\u6211\u4eec\u7701\u7565\u5bbd\u9ad8\u6bd4\u53ef\u53d8\u7684\u60c5\u51b5\uff08\u901a\u8fc7\u8c03\u6574\u7a97\u53e3\u5927\u5c0f\uff09\uff0c\u8fd9\u53ef\u4ee5\u5728 render \u65b9\u6cd5\u4e2d\u68c0\u67e5\u5e76\u76f8\u5e94\u5730\u6539\u53d8\u6295\u5f71\u77e9\u9635\u3002 \u73b0\u5728\u6709\u4e86\u77e9\u9635\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\uff0c\u5e76\u4e14\u5b83\u5e94\u8be5\u88ab\u5e94\u7528\u5230\u6240\u6709\u9876\u70b9\u4e0a\u3002\u9996\u5148\uff0c\u4f60\u53ef\u80fd\u4f1a\u60f3\u5230\u628a\u5b83\u6346\u7ed1\u5728\u9876\u70b9\u8f93\u5165\u4e2d\uff08\u5c31\u50cf\u5750\u6807\u548c\u989c\u8272\u90a3\u6837\uff09\u3002\u4f46\u8fd9\u6837\uff0c\u6211\u4eec\u4f1a\u6d6a\u8d39\u5f88\u591a\u7a7a\u95f4\uff0c\u56e0\u4e3a\u6295\u5f71\u77e9\u9635\u5728\u51e0\u6b21\u6e32\u67d3\u671f\u95f4\u90fd\u4e0d\u4f1a\u53d1\u751f\u6539\u53d8\u3002\u4f60\u53ef\u80fd\u8fd8\u60f3\u5728Java\u4ee3\u7801\u4e2d\u7528\u77e9\u9635\u5904\u7406\u6240\u6709\u9876\u70b9\uff0c\u4f46\u8fd9\u6837\u6211\u4eec\u8f93\u5165\u7684VBO\u5c31\u662f\u6ca1\u7528\u7684\u4e86\uff0c\u8fd9\u6837\u5c31\u4e0d\u80fd\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u5904\u7406\u5668\u8d44\u6e90\u4e86\u3002 \u7b54\u6848\u662f\u4f7f\u7528\u201c uniform \u201d\u3002Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4e0e\u7740\u8272\u5668\u4ea4\u6d41\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u5e76\u58f0\u660e\u4e00\u4e2a\u65b0\u7684\u540d\u4e3a projectionMatrix \u7684Uniform\uff0c\u5e76\u7528\u5b83\u6765\u8ba1\u7b97\u6295\u5f71\u540e\u7684\u4f4d\u7f6e\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u628a projectionMatrix \u5b9a\u4e49\u4e3a\u4e00\u4e2a4x4\u7684\u77e9\u9635\uff0c\u65b0\u7684\u5750\u6807\u662f\u901a\u8fc7\u628a\u5b83\u4e0e\u539f\u59cb\u5750\u6807\u76f8\u4e58\u5f97\u5230\u7684\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u628a\u6295\u5f71\u77e9\u9635\u7684\u503c\u4f20\u9012\u7ed9\u7740\u8272\u5668\uff0c\u9996\u5148\u9700\u8981\u786e\u5b9aUniform\u7684\u4f4d\u7f6e\u3002 \u8fd9\u662f\u901a\u8fc7\u8c03\u7528\u65b9\u6cd5 glGetUniformLocation \u5b9e\u73b0\u7684\uff0c\u5b83\u6709\u4e24\u4e2a\u53c2\u6570\uff1a \u7740\u8272\u5668\u7a0b\u5e8f\u7684ID Uniform\u540d\uff08\u5b83\u5e94\u8be5\u4e0e\u7740\u8272\u5668\u91cc\u5b9a\u4e49\u7684\u540d\u79f0\u76f8\u540c\uff09 \u6b64\u65b9\u6cd5\u8fd4\u56de\u50a8\u5b58Uniform\u4f4d\u7f6e\u7684ID\u3002\u7531\u4e8e\u53ef\u80fd\u6709\u4e00\u4e2a\u4ee5\u4e0a\u7684Uniform\uff0c\u6211\u4eec\u5c06\u628a\u8fd9\u4e9bID\u50a8\u5b58\u5728\u7531\u53d8\u91cf\u540d\u4f5c\u4e3a\u7d22\u5f15\u7684Map\u4e2d\uff08\u6b64\u540e\u6211\u4eec\u9700\u8981\u90a3\u4e2aID\uff09\u3002\u56e0\u6b64\uff0c\u5728 ShaderProgram \u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b57\u6bb5\u6765\u4fdd\u5b58\u8fd9\u4e9bID\uff1a private final Map<String, Integer> uniforms; \u7136\u540e\u7531\u6784\u9020\u65b9\u6cd5\u521d\u59cb\u5316\u5b83\uff1a uniforms = new HashMap<>(); \u6700\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u65b0\u7684Uniform\u548c\u50a8\u5b58\u83b7\u5f97\u7684\u4f4d\u7f6e\u3002 public void createUniform(String uniformName) throws Exception { int uniformLocation = glGetUniformLocation(programId, uniformName); if (uniformLocation < 0) { throw new Exception(\"Could not find uniform:\" + uniformName); } uniforms.put(uniformName, uniformLocation); } \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7a0b\u5e8f\u7f16\u8bd1\u540e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u8c03\u7528 createUniform \u65b9\u6cd5\uff08\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5728\u6295\u5f71\u77e9\u9635\u5b9e\u4f8b\u5316\u540e\u8c03\u7528\u5b83\uff09\u3002 shaderProgram.createUniform(\"projectionMatrix\"); \u6b64\u65f6\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u4e00\u4e2a\u53ef\u4ee5\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u6570\u636e\u7684\u50a8\u5b58\u5668\u3002\u7531\u4e8e\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u671f\u95f4\u4e0d\u4f1a\u53d8\u5316\uff0c\u6240\u4ee5\u53ef\u4ee5\u5728\u521b\u5efaUniform\u540e\u76f4\u63a5\u8bbe\u7f6e\u503c\uff0c\u4f46\u6211\u4eec\u5c06\u5728 render \u65b9\u6cd5\u4e2d\u505a\u6b64\u4e8b\u3002\u7a0d\u540e\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ef\u4ee5\u91cd\u7528\u8be5Uniform\u6765\u6267\u884c\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e2d\u9700\u8981\u6267\u884c\u7684\u5176\u4ed6\u64cd\u4f5c\u3002 \u6211\u4eec\u5c06\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a setUniform \u7684\u65b9\u6cd5\u6765\u8bbe\u7f6e\u6570\u636e\uff0c\u901a\u8fc7\u4f7f\u7528JOML\u5e93\u63d0\u4f9b\u7684\u5b9e\u7528\u65b9\u6cd5\u5c06\u77e9\u9635\u8f6c\u6362\u4e3a4x4\u7684 FloatBuffer \u5bf9\u8c61\uff0c\u5e76\u5c06\u5b83\u4eec\u53d1\u9001\u5230Uniform\u4e2d\u3002 public void setUniform(String uniformName, Matrix4f value) { // \u8f6c\u50a8\u77e9\u9635\u5230FloatBuffer try (MemoryStack stack = MemoryStack.stackPush()) { FloatBuffer fb = stack.mallocFloat(16); value.get(fb); glUniformMatrix4fv(uniforms.get(uniformName), false, fb); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528\u4e0e\u6b64\u524d\u4e0d\u540c\u7684\u65b9\u5f0f\u521b\u5efa\u7f13\u51b2\u533a\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\uff0c\u5e76\u5c06\u5b83\u4eec\u5206\u914d\u5230\u5806\u6808\u4e0a\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u5f88\u5c0f\uff0c\u5e76\u4e14\u5728\u8be5\u65b9\u6cd5\u4e4b\u5916\u4e0d\u4f1a\u4f7f\u7528\u5b83\u3002\u56e0\u6b64\u6211\u4eec\u4f7f\u7528 MemoryStack \u7c7b\u3002 \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7ed1\u5b9a\u4e4b\u540e\uff0c\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); \u6211\u4eec\u5c31\u8981\u5b8c\u6210\u4e86\uff0c\u73b0\u5728\u53ef\u4ee5\u6b63\u786e\u5730\u6e32\u67d3\u56db\u8fb9\u5f62\uff0c\u6240\u4ee5\u73b0\u5728\u53ef\u4ee5\u542f\u52a8\u7a0b\u5e8f\uff0c\u7136\u540e\u5f97\u5230\u4e00\u4e2a...\u9ed1\u8272\u80cc\u666f\uff0c\u6ca1\u6709\u4efb\u4f55\u5f69\u8272\u56db\u8fb9\u5f62\u3002\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u6211\u4eec\u628a\u4ec0\u4e48\u5f04\u574f\u4e86\u5417\uff1f\u5b9e\u9645\u4e0a\u6ca1\u6709\u4efb\u4f55\u95ee\u9898\u3002\u8bb0\u4f4f\u6211\u4eec\u6b63\u5728\u6a21\u62df\u6444\u50cf\u673a\u89c2\u5bdf\u573a\u666f\u7684\u6548\u679c\u3002\u6211\u4eec\u63d0\u4f9b\u4e86\u4e24\u4e2a\u8ddd\u79bb\uff0c\u4e00\u4e2a\u662f\u6700\u8fdc\u89c6\u8ddd\uff081000f\uff09\u548c\u4e00\u4e2a\u6700\u8fd1\u89c6\u8ddd\uff080.01f\uff09\u3002\u800c\u6211\u4eec\u7684\u5750\u6807\u662f\uff1a float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; \u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5750\u6807\u4e2d\u7684Z\u5750\u6807\u4f4d\u4e8e\u53ef\u89c6\u533a\u57df\u4e4b\u5916\u3002\u5c06\u5b83\u4eec\u8d4b\u503c\u4e3a-0.05f\uff0c\u73b0\u5728\u4f60\u4f1a\u770b\u5230\u50cf\u8fd9\u6837\u7684\u4e00\u4e2a\u5de8\u5927\u7684\u7eff\u8272\u6b63\u65b9\u5f62\uff1a \u8fd9\u662f\u56e0\u4e3a\uff0c\u6211\u4eec\u6b63\u7ed8\u5236\u51fa\u79bb\u6444\u50cf\u673a\u592a\u8fd1\u7684\u6b63\u65b9\u5f62\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u653e\u5927\u5b83\u3002\u5982\u679c\u73b0\u5728\u628a\u4e00\u4e2a -1.05f \u7684\u503c\u8d4b\u503c\u7ed9Z\u5750\u6807\uff0c\u5c31\u53ef\u4ee5\u770b\u5230\u5f69\u8272\u6b63\u65b9\u5f62\u4e86\u3002 \u5982\u679c\u7ee7\u7eed\u5411\u540e\u79fb\u52a8\u56db\u8fb9\u5f62\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u5b83\u53d8\u5c0f\u4e86\u3002\u8fd8\u8981\u6ce8\u610f\u5230\u56db\u8fb9\u5f62\u4e0d\u518d\u50cf\u77e9\u5f62\u4e86\u3002 \u4f7f\u7528\u53d8\u6362 \u56de\u60f3\u4e00\u4e0b\u5230\u76ee\u524d\u4e3a\u6b62\u6211\u4eec\u90fd\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u5df2\u7ecf\u5b66\u4f1a\u4e86\u5982\u4f55\u5c06\u6570\u636e\u4ee5\u6709\u6548\u7684\u683c\u5f0f\u4f20\u9012\u7ed9\u663e\u5361\uff0c\u4ee5\u53ca\u5982\u4f55\u4f7f\u7528\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6765\u6295\u5f71\u8fd9\u4e9b\u9876\u70b9\u5e76\u8bbe\u7f6e\u5b83\u4eec\u7684\u989c\u8272\u3002\u73b0\u5728\u5e94\u8be5\u5f00\u59cb\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7ed8\u5236\u66f4\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4f46\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u80fd\u591f\u52a0\u8f7d\u6a21\u578b\uff0c\u5e76\u5728\u6307\u5b9a\u7684\u4f4d\u7f6e\u4ee5\u9002\u5f53\u7684\u5927\u5c0f\u548c\u6240\u9700\u7684\u65cb\u8f6c\u5c06\u5b83\u6e32\u67d3\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002 \u73b0\u5728\u4e3a\u4e86\u5b9e\u73b0\u8fd9\u6837\u7684\u6e32\u67d3\uff0c\u6211\u4eec\u9700\u8981\u63d0\u4f9b\u4e00\u4e9b\u57fa\u672c\u64cd\u4f5c\u6765\u64cd\u4f5c\u6a21\u578b\uff1a \u4f4d\u79fb\uff08Translation\uff09: \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09: \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09: \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u4e0a\u9762\u7684\u64cd\u4f5c\u7edf\u79f0\u4e3a\u53d8\u6362\uff08Transformation\uff09\u3002\u4f60\u53ef\u80fd\u731c\u5230\u8981\u5b9e\u73b0\u8fd9\u4e00\u70b9\u7684\u65b9\u6cd5\u662f\u628a\u5750\u6807\u4e58\u4ee5\u4e00\u7ec4\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u79fb\u52a8\uff0c\u4e00\u4e2a\u7528\u4e8e\u65cb\u8f6c\uff0c\u4e00\u4e2a\u7528\u4e8e\u7f29\u653e\uff09\u3002\u8fd9\u4e09\u4e2a\u77e9\u9635\u5c06\u88ab\u7ec4\u5408\u6210\u4e00\u4e2a\u79f0\u4e3a\u201c\u4e16\u754c\u77e9\u9635\u201d\u7684\u77e9\u9635\uff0c\u5e76\u4f5c\u4e3a\u4e00\u4e2aUniform\u4f20\u9012\u7ed9\u9876\u70b9\u7740\u8272\u5668\u3002 \u4e4b\u6240\u4ee5\u88ab\u79f0\u4e3a\u4e16\u754c\u77e9\u9635\uff0c\u662f\u56e0\u4e3a\u6211\u4eec\u6b63\u5728\u5c06\u6a21\u578b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002\u5f53\u5b66\u4e60\u52a0\u8f7d3D\u6a21\u578b\u65f6\uff0c\u4f60\u4f1a\u53d1\u73b0\u8fd9\u4e9b\u6a21\u578b\u662f\u5728\u5b83\u4eec\u81ea\u5df1\u7684\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u7684\uff0c\u5b83\u4eec\u4e0d\u77e5\u9053\u4f60\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u5927\u5c0f\uff0c\u4f46\u5b83\u4eec\u9700\u8981\u5728\u91cc\u9762\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u7528\u77e9\u9635\u4e58\u4ee5\u5750\u6807\u65f6\uff0c\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u6a21\u578b\u5750\u6807\u7cfb\uff09\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u4e09\u7ef4\u4e16\u754c\u5750\u6807\u7cfb\uff09\u3002 \u4e16\u754c\u77e9\u9635\u5e94\u8be5\u8fd9\u6837\u8ba1\u7b97\uff08\u987a\u5e8f\u5f88\u91cd\u8981\uff0c\u56e0\u4e3a\u4e58\u6cd5\u4ea4\u6362\u5f8b\u4e0d\u9002\u7528\u4e8e\u77e9\u9635\uff09: \u4e16\u754c\u77e9\u9635=\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \u5982\u679c\u628a\u6295\u5f71\u77e9\u9635\u5305\u542b\u5728\u53d8\u6362\u77e9\u9635\u4e2d\uff0c\u5b83\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\begin{array}{lcl} Transf & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \\\\ & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4e16\u754c\u77e9\u9635\\right] \\end{array} \u4f4d\u79fb\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a \\begin{bmatrix} 1 & 0 & 0 & dx \\\\ 0 & 1 & 0 & dy \\\\ 0 & 0 & 1 & dz \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u4f4d\u79fb\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a dx: \u6cbfX\u8f74\u4f4d\u79fb\u3002 dy: \u6cbfY\u8f74\u4f4d\u79fb\u3002 dz: \u6cbfZ\u8f74\u4f4d\u79fb\u3002 \u7f29\u653e\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1b \\begin{bmatrix} sx & 0 & 0 & 0 \\\\ 0 & sy & 0 & 0 \\\\ 0 & 0 & sz & 0 \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7f29\u653e\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a sx: \u6cbf\u7740X\u8f74\u7f29\u653e\u3002 sy: \u6cbf\u7740Y\u8f74\u7f29\u653e\u3002 sz: \u6cbf\u7740Z\u8f74\u7f29\u653e\u3002 \u65cb\u8f6c\u77e9\u9635\u8981\u590d\u6742\u5f97\u591a\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u5b83\u53ef\u4ee5\u7531\u6bcf\u4e2a\u7ed5\u5355\u72ec\u7684\u8f74\u65cb\u8f6c\u7684\u65cb\u8f6c\u77e9\u9635\u76f8\u4e58\u5f97\u5230\u3002 \u73b0\u5728\uff0c\u4e3a\u4e86\u5b9e\u8df5\u8fd9\u4e9b\u7406\u8bba\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u4ee3\u7801\u4e00\u70b9\u70b9\u3002\u5728\u6e38\u620f\u4e2d\uff0c\u6211\u4eec\u5c06\u52a0\u8f7d\u4e00\u7ec4\u6a21\u578b\uff0c\u7528\u6765\u6839\u636e\u6e38\u620f\u903b\u8f91\u5728\u4e0d\u540c\u7684\u4f4d\u7f6e\u6e32\u67d3\u8bb8\u591a\u7269\u4f53\uff08\u60f3\u8c61\u4e00\u4e2aFPS\u6e38\u620f\uff0c\u5b83\u8f7d\u5165\u4e86\u4e09\u4e2a\u4e0d\u540c\u654c\u4eba\u7684\u6a21\u578b\u3002\u786e\u5b9e\u53ea\u6709\u4e09\u4e2a\u6a21\u578b\uff0c\u4f46\u4f7f\u7528\u8fd9\u4e9b\u6a21\u578b\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u60f3\u8981\u7684\u4efb\u610f\u6570\u91cf\u7684\u654c\u4eba\uff09\u3002\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u5bf9\u8c61\u521b\u5efa\u4e00\u4e2aVAO\u548c\u4e00\u7ec4VBO\u5417\uff1f\u7b54\u6848\u662f\u4e0d\u9700\u8981\uff0c\u53ea\u9700\u8981\u6bcf\u4e2a\u6a21\u578b\u52a0\u8f7d\u4e00\u6b21\u5c31\u884c\u3002\u6211\u4eec\u9700\u8981\u505a\u7684\u662f\u6839\u636e\u5b83\u7684\u4f4d\u7f6e\uff0c\u5927\u5c0f\u548c\u65cb\u8f6c\u6765\u72ec\u7acb\u5730\u7ed8\u5236\u5b83\u3002\u5f53\u6e32\u67d3\u8fd9\u4e9b\u6a21\u578b\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u5b83\u4eec\u8fdb\u884c\u53d8\u6362\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameItem \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u6a21\u578b\u52a0\u8f7d\u5230 Mesh \u5b9e\u4f8b\u4e2d\u3002\u4e00\u4e2a GameItem \u5b9e\u4f8b\u5c06\u7531\u53d8\u91cf\u50a8\u5b58\u5b83\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u72b6\u6001\u548c\u7f29\u653e\u3002\u5982\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private final Mesh mesh; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem(Mesh mesh) { this.mesh = mesh; position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return mesh; } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Transformation \u7684\u7c7b\uff0c\u8ba9\u5b83\u6765\u5904\u7406\u53d8\u6362\u3002 package org.lwjglb.engine.graph; import org.joml.Matrix4f; import org.joml.Vector3f; public class Transformation { private final Matrix4f projectionMatrix; private final Matrix4f worldMatrix; public Transformation() { worldMatrix = new Matrix4f(); projectionMatrix = new Matrix4f(); } public final Matrix4f getProjectionMatrix(float fov, float width, float height, float zNear, float zFar) { float aspectRatio = width / height; projectionMatrix.identity(); projectionMatrix.perspective(fov, aspectRatio, zNear, zFar); return projectionMatrix; } public Matrix4f getWorldMatrix(Vector3f offset, Vector3f rotation, float scale) { worldMatrix.identity().translate(offset). rotateX((float)Math.toRadians(rotation.x)). rotateY((float)Math.toRadians(rotation.y)). rotateZ((float)Math.toRadians(rotation.z)). scale(scale); return worldMatrix; } } \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e2a\u7c7b\u628a\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u8d77\u6765\u3002\u7ed9\u5b9a\u4e00\u7ec4\u53c2\u6570\u6765\u8fdb\u884c\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u7136\u540e\u8fd4\u56de\u4e16\u754c\u77e9\u9635\u3002 getWorldMatrix \u8fd4\u56de\u7684\u7ed3\u679c\u5c06\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u53d8\u6362\u5750\u6807\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u83b7\u5f97\u6295\u5f71\u77e9\u9635\u7684\u65b9\u6cd5\u3002 \u9700\u8981\u6ce8\u610f\u7684\u4e00\u4ef6\u4e8b\u662f\uff0c Matrix4f \u7c7b\u7684 mul \u65b9\u6cd5\u4fee\u6539\u4e86\u8be5\u5b9e\u4f8b\u7684\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u6295\u5f71\u77e9\u9635\u4e0e\u53d8\u6362\u77e9\u9635\u76f8\u4e58\uff0c\u6211\u4eec\u4f1a\u4fee\u6539\u6295\u5f71\u77e9\u9635\u672c\u8eab\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u603b\u662f\u5728\u6bcf\u6b21\u8c03\u7528\u65f6\u5c06\u6bcf\u4e2a\u77e9\u9635\u521d\u59cb\u5316\u4e3a\u5355\u4f4d\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4ec5\u5b9e\u4f8b\u5316\u4e86\u6ca1\u6709\u4efb\u4f55\u53c2\u6570\u7684 Transformation \u7c7b\uff0c\u800c\u5728 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u521b\u5efa\u4e86Uniform\u3002 public Renderer() { transformation = new Transformation(); } public void init(Window window) throws Exception { // ... \u6b64\u524d\u7684\u4e00\u4e9b\u4ee3\u7801 ... // \u4e3a\u4e16\u754c\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u521b\u5efaUniform shaderProgram.createUniform(\"projectionMatrix\"); shaderProgram.createUniform(\"worldMatrix\"); window.setClearColor(0.0f, 0.0f, 0.0f, 0.0f); } \u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\uff0c\u73b0\u5728\u53ef\u4ee5\u63a5\u6536\u5230\u4e00\u4e2a GameItem \u7684\u6570\u7ec4\uff1a public void render(Window window, GameItem[] gameItems) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u6e32\u67d3\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u4e16\u754c\u77e9\u9635 Matrix4f worldMatrix = transformation.getWorldMatrix( gameItem.getPosition(), gameItem.getRotation(), gameItem.getScale()); shaderProgram.setUniform(\"worldMatrix\", worldMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c gameItem.getMesh().render(); } shaderProgram.unbind(); } \u6bcf\u6b21\u8c03\u7528 render \u65f6\u5c31\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21\uff0c\u8fd9\u6837\u6211\u4eec\u53ef\u4ee5\u5904\u7406\u7a97\u53e3\u5927\u5c0f\u7684\u8c03\u6574\u64cd\u4f5c\u3002\u7136\u540e\u6211\u4eec\u904d\u5386 GameItem \u6570\u7ec4\uff0c\u5e76\u6839\u636e\u5b83\u4eec\u5404\u81ea\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u521b\u5efa\u53d8\u6362\u77e9\u9635\uff0c\u8be5\u77e9\u9635\u5c06\u88ab\u4f20\u9012\u5230\u7740\u8272\u5668\u5e76\u7ed8\u5236 Mesh \u3002\u6295\u5f71\u77e9\u9635\u5bf9\u4e8e\u6240\u6709\u8981\u6e32\u67d3\u7684\u9879\u76ee\u90fd\u662f\u76f8\u540c\u7684\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u5728 Transformation \u7c7b\u4e2d\u662f\u5355\u72ec\u4e00\u4e2a\u53d8\u91cf\u7684\u539f\u56e0\u3002 \u6211\u4eec\u5c06\u6e32\u67d3\u4ee3\u7801\u79fb\u52a8\u5230 Mesh \u7c7b\u4e2d\uff1a public void render() { // \u7ed8\u5236Mesh glBindVertexArray(getVaoId()); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); // \u91cd\u7f6e\u72b6\u6001 glBindVertexArray(0); } \u9876\u70b9\u7740\u8272\u5668\u53ea\u9700\u7b80\u5355\u5730\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 worldMatrix \u77e9\u9635\uff0c\u7136\u540e\u7528\u5b83\u4e0e projectionMatrix \u4e00\u540c\u8ba1\u7b97\u5750\u6807\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4f60\u6240\u89c1\uff0c\u4ee3\u7801\u5b8c\u5168\u4e00\u81f4\u3002\u6211\u4eec\u4f7f\u7528Uniform\u6765\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\uff0c\u5e76\u4e14\u8003\u8651\u622a\u9525\u3001\u4f4d\u7f6e\u3001\u7f29\u653e\u548c\u65cb\u8f6c\u7b49\u3002 \u53e6\u5916\u4e00\u4e2a\u91cd\u8981\u7684\u95ee\u9898\u662f\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u76f4\u63a5\u4f7f\u7528\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u800c\u662f\u628a\u5b83\u4eec\u7ec4\u5408\u6210\u4e00\u4e2a\u4e16\u754c\u77e9\u9635\u5462\uff1f\u539f\u56e0\u662f\u6211\u4eec\u5e94\u8be5\u5c3d\u91cf\u51cf\u5c11\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u77e9\u9635\u3002\u8fd8\u8981\u8bb0\u4f4f\uff0c\u5728\u7740\u8272\u5668\u4e2d\u6240\u505a\u7684\u77e9\u9635\u4e58\u6cd5\u662f\u6bcf\u4e2a\u9876\u70b9\u4e00\u6b21\uff0c\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u8c03\u7528\u671f\u95f4\u4e0d\u4f1a\u6539\u53d8\uff0c\u800c\u6bcf\u4e00\u4e2a GameItem \u5b9e\u4f8b\u7684\u4e16\u754c\u77e9\u9635\u4e5f\u4e0d\u4f1a\u6539\u53d8\u3002\u5982\u679c\u72ec\u7acb\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u6211\u4eec\u8981\u505a\u66f4\u591a\u7684\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\u3002\u5728\u4e00\u4e2a\u6709\u8d85\u591a\u9876\u70b9\u7684\u6a21\u578b\u4e2d\uff0c\u8fd9\u662f\u5f88\u591a\u4f59\u7684\u64cd\u4f5c\u3002 \u4f46\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u60f3\uff0c\u5982\u679c\u6bcf\u4e2a GameItem \u4e2d\u7684\u4e16\u754c\u77e9\u9635\u90fd\u4e0d\u4f1a\u53d1\u751f\u53d8\u5316\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u5728Java\u7c7b\u4e2d\u505a\u77e9\u9635\u4e58\u6cd5\uff1f\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u4e0e\u6bcf\u4e2a GameItem \u76f8\u4e58\uff0c\u628a\u5b83\u4eec\u4f5c\u4e3a\u4e00\u4e2aUniform\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u786e\u5b9e\u80fd\u7701\u4e0b\u66f4\u591a\u7684\u64cd\u4f5c\u3002\u4f46\u5f53\u6211\u4eec\u5411\u6e38\u620f\u5f15\u64ce\u4e2d\u6dfb\u52a0\u66f4\u591a\u7684\u7279\u6027\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u6240\u4ee5\u6700\u597d\u72ec\u7acb\u5730\u5904\u7406\u8fd9\u4e24\u4e2a\u77e9\u9635\u3002 \u6700\u540e\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\uff0c\u8ba9\u5176\u4e0e Mesh \u5173\u8054\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e9b\u903b\u8f91\u6765\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u56db\u8fb9\u5f62\u3002\u56e0\u4e3a\u8fd9\u53ea\u662f\u4e2a\u6d4b\u8bd5\u793a\u4f8b\uff0c\u6ca1\u6709\u6dfb\u52a0\u592a\u591a\u5185\u5bb9\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u76f8\u5173\u4ee3\u7801\u3002","title":"\u53d8\u6362"},{"location":"06-transformations/#transformations","text":"","title":"\u53d8\u6362\uff08Transformations\uff09"},{"location":"06-transformations/#_1","text":"\u8ba9\u6211\u4eec\u56de\u770b\u5728\u524d\u4e00\u7ae0\u4e2d\u521b\u5efa\u7684\u8272\u5f69\u9c9c\u8273\u7684\u6b63\u65b9\u5f62\u3002\u5982\u679c\u4ed4\u7ec6\u770b\uff0c\u5b83\u66f4\u50cf\u4e00\u4e2a\u77e9\u5f62\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u5c06\u7a97\u53e3\u7684\u5bbd\u5ea6\u4ece600\u50cf\u7d20\u6539\u4e3a900\u50cf\u7d20\uff0c\u5931\u771f\u5c31\u4f1a\u66f4\u52a0\u660e\u663e\u3002\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\u5462\uff1f \u5982\u679c\u4f60\u67e5\u770b\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u6211\u4eec\u53ea\u662f\u76f4\u63a5\u5730\u4f20\u9012\u5750\u6807\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5f53\u4e00\u4e2a\u9876\u70b9\u7684X\u5750\u6807\u4e3a0.5\u65f6\uff0c\u6211\u4eec\u8ba9OpenGL\u5728\u5c4f\u5e55\u7684X\u5750\u6807\u4e3a0.5\u7684\u4f4d\u7f6e\u7ed8\u5236\u5b83\u3002\u4e0b\u56fe\u5c55\u793a\u4e86OpenGL\u5750\u6807\u7cfb\uff08\u4ec5\u542bX\u548cY\u8f74\uff09\u3002 \u5c06\u8fd9\u4e9b\u5750\u6807\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807\u7cfb\uff08\u5176\u539f\u70b9\u4f4d\u4e8e\u4e0a\u56fe\u7684\u5de6\u4e0a\u89d2\uff09\uff0c\u9700\u8981\u8003\u8651\u5230\u7a97\u53e3\u7684\u5927\u5c0f\u3002\u56e0\u6b64\uff0c\u5982\u679c\u6211\u4eec\u7684\u7a97\u53e3\u5927\u5c0f\u4e3a900x480\uff0cOpenGL\u5750\u6807(1, 0)\u5c06\u88ab\u6295\u5f71\u5230\u7a97\u53e3\u5750\u6807(900, 0)\uff0c\u6700\u7ec8\u521b\u5efa\u4e00\u4e2a\u77e9\u5f62\u800c\u4e0d\u662f\u4e00\u4e2a\u6b63\u65b9\u5f62\u3002 \u4f46\u662f\uff0c\u95ee\u9898\u8fdc\u6bd4\u8fd9\u66f4\u4e25\u91cd\u3002\u5c06\u56db\u8fb9\u5f62\u7684Z\u5750\u6807\u4ece0.0\u4fee\u6539\u4e3a1.0\u548c-1.0\uff0c\u4f60\u53d1\u73b0\u4e86\u4ec0\u4e48\uff1f\u56db\u8fb9\u5f62\u5b8c\u5168\u662f\u7ed8\u5236\u5728\u540c\u4e00\u4e2a\u5730\u65b9\uff0c\u4e0d\u7ba1\u5b83\u662f\u5426\u6cbf\u7740Z\u8f74\u4f4d\u79fb\u3002\u4e3a\u4ec0\u4e48\u4f1a\u53d1\u751f\u8fd9\u79cd\u60c5\u51b5\uff1f\u8fdc\u5904\u7684\u7269\u4f53\u5e94\u8be5\u6bd4\u8fd1\u5904\u7684\u7269\u4f53\u7ed8\u5236\u5f97\u66f4\u5c0f\uff0c\u4f46\u662f\u6211\u4eec\u4f7f\u7528\u76f8\u540c\u7684X\u548cY\u5750\u6807\u7ed8\u5236\u5b83\u4eec\u3002 \u4f46\u7a0d\u7b49\u4e00\u4e0b\uff0c\u8fd9\u4e0d\u5e94\u8be5\u7531Z\u5750\u6807\u6765\u5904\u7406\u5417\uff1f\u8fd9\u534a\u5bf9\u534a\u9519\u3002Z\u5750\u6807\u544a\u8bc9OpenGL\u4e00\u4e2a\u7269\u4f53\u7684\u8fdc\u8fd1\uff0c\u4f46\u662fOpenGL\u5bf9\u4f60\u7684\u7269\u4f53\u7684\u5927\u5c0f\u4e00\u65e0\u6240\u77e5\u3002\u4f60\u53ef\u4ee5\u6709\u4e24\u4e2a\u4e0d\u540c\u5927\u5c0f\u7684\u7269\u4f53\uff0c\u4e00\u4e2a\u66f4\u8fd1\u66f4\u5c0f\uff0c\u4e00\u4e2a\u66f4\u8fdc\u66f4\u5927\uff0c\u800c\u4e14\u53ef\u4ee5\u4ee5\u76f8\u540c\u7684\u5927\u5c0f\u6b63\u786e\u5730\u6295\u5f71\u5230\u5c4f\u5e55\u4e0a\uff08\u6709\u76f8\u540c\u7684\u5c4f\u5e55X\u548cY\u5750\u6807\uff0c\u4f46Z\u5750\u6807\u4e0d\u540c\uff09\u3002OpenGL\u53ea\u4f7f\u7528\u6b63\u5728\u4f20\u9012\u7684\u5750\u6807\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\u3002 \u65e2\u7136\u5df2\u7ecf\u786e\u8bca\u4e86\u8fd9\u4e2a\u95ee\u9898\uff0c\u8be5\u600e\u4e48\u89e3\u51b3\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\u6216\u622a\u9525\u4f53\uff08Frustum\uff09\u3002\u6295\u5f71\u77e9\u9635\u5c06\u5904\u7406\u7ed8\u5236\u533a\u57df\u7684\u5bbd\u9ad8\u6bd4\uff08\u5927\u5c0f\u4e0e\u9ad8\u5ea6\u4e4b\u95f4\u7684\u5173\u7cfb\uff09\uff0c\u8fd9\u6837\u7269\u4f53\u5c31\u4e0d\u4f1a\u53d8\u5f62\u3002\u5b83\u8fd8\u53ef\u4ee5\u5904\u7406\u8ddd\u79bb\uff0c\u6240\u4ee5\u8f83\u8fdc\u7684\u7269\u4f53\u5c06\u4f1a\u88ab\u7ed8\u5236\u5f97\u66f4\u5c0f\u3002\u6295\u5f71\u77e9\u9635\u8fd8\u5c06\u8003\u8651\u6211\u4eec\u7684\u89c6\u91ce\u548c\u5e94\u8be5\u663e\u793a\u7684\u8ddd\u79bb\u6709\u591a\u8fdc\u3002 \u5bf9\u4e8e\u4e0d\u719f\u6089\u77e9\u9635\u7684\u4eba\uff0c\u77e9\u9635\uff08Matrix\uff09\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\u3002\u77e9\u9635\u4e2d\u7684\u6bcf\u4e2a\u6570\u5b57\u88ab\u79f0\u4e3a\u5143\u7d20\u3002\u77e9\u9635\u9636\u6b21\u662f\u884c\u548c\u5217\u7684\u6570\u91cf\u3002\u4f8b\u5982\uff0c\u6b64\u5904\u662f\u4e00\u4e2a2x2\u77e9\u9635\uff08\u67092\u884c2\u5217\uff09\u3002 \u77e9\u9635\u6709\u8bb8\u591a\u53ef\u4ee5\u5e94\u7528\u4e8e\u5b83\u4eec\u7684\u57fa\u672c\u8fd0\u7b97\uff08\u5982\u52a0\u6cd5\u3001\u4e58\u6cd5\u7b49\uff09\uff0c\u4f60\u53ef\u4ee5\u5728\u6570\u5b66\u4e66\u4e2d\u67e5\u9605\uff0c\u5176\u4e2d\u4e0e\u4e09\u7ef4\u56fe\u5f62\u76f8\u5173\u7684\u77e9\u9635\u5bf9\u7a7a\u95f4\u4e2d\u70b9\u7684\u53d8\u6362\u975e\u5e38\u6709\u7528\u3002 \u4f60\u53ef\u4ee5\u628a\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u6210\u4e00\u4e2a\u6444\u50cf\u673a\uff0c\u5b83\u6709\u4e00\u4e2a\u89c6\u91ce\u548c\u6700\u5c0f\u548c\u6700\u5927\u8ddd\u79bb\u3002\u8be5\u6444\u50cf\u673a\u7684\u53ef\u89c6\u533a\u57df\u662f\u4e00\u4e2a\u622a\u65ad\u7684\u91d1\u5b57\u5854\uff0c\u4e0b\u56fe\u4e3a\u8be5\u533a\u57df\u7684\u4fef\u89c6\u56fe\u3002 \u6295\u5f71\u77e9\u9635\u5c06\u6b63\u786e\u5730\u6295\u5f71\u4e09\u7ef4\u5750\u6807\uff0c\u4ee5\u4fbf\u5b83\u4eec\u80fd\u591f\u5728\u4e8c\u7ef4\u5c4f\u5e55\u4e0a\u6b63\u786e\u5730\u663e\u793a\u3002\u8be5\u77e9\u9635\u7684\u6570\u5b66\u8868\u793a\u5982\u4e0b\uff08\u4e0d\u8981\u5bb3\u6015\uff09\uff1a \u5176\u4e2d\u5c4f\u5e55\u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\u6307\u7684\u662f\u5c4f\u5e55\u5bbd\u5ea6\u4e0e\u5c4f\u5e55\u9ad8\u5ea6\u7684\u5173\u7cfb\uff08 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4=\u5bbd\u5ea6/\u9ad8\u5ea6 \uff09\u3002\u4e3a\u4e86\u83b7\u5f97\u7ed9\u5b9a\u70b9\u7684\u6295\u5f71\u5750\u6807\uff0c\u53ea\u9700\u8981\u5c06\u6295\u5f71\u77e9\u9635\u4e58\u4ee5\u539f\u59cb\u5750\u6807\uff0c\u7ed3\u679c\u662f\u6295\u5f71\u540e\u7684\u53e6\u4e00\u4e2a\u5411\u91cf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u4e00\u7ec4\u6570\u5b66\u5b9e\u4f53\uff0c\u5982\u5411\u91cf\u3001\u77e9\u9635\uff0c\u5e76\u5305\u62ec\u53ef\u4ee5\u5bf9\u5b83\u4eec\u8fdb\u884c\u7684\u8fd0\u7b97\u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4ece\u5934\u5f00\u59cb\u7f16\u5199\u6240\u6709\u7684\u4ee3\u7801\uff0c\u6216\u8005\u4f7f\u7528\u5df2\u5b9e\u73b0\u7684\u5e93\u3002\u5f53\u7136\u6211\u4eec\u4f1a\u9009\u62e9\u5bb9\u6613\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528JOML\uff08Java OpenGL Math Library\uff0cJava OpenGL \u6570\u5b66\u5e93\uff09\u5904\u7406LWJGL\u5185\u7684\u6570\u5b66\u8fd0\u7b97\u3002\u4e3a\u4e86\u4f7f\u7528\u8be5\u5e93\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 pom.xml \u6587\u4ef6\u6dfb\u52a0\u53e6\u4e00\u4e2a\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.joml</groupId> <artifactId>joml</artifactId> <version>${joml.version}</version> </dependency> \u7136\u540e\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u5e93\u7248\u672c\u3002 <properties> [...] <joml.version>1.9.6</joml.version> [...] </properties> \u73b0\u5728\u4e00\u5207\u90fd\u51c6\u5907\u597d\u4e86\uff0c\u6765\u5b9a\u4e49\u6211\u4eec\u7684\u6295\u5f71\u77e9\u9635\u3002\u5728 Renderer \u7c7b\u4e2d\u521b\u5efa Matrix4f \u7c7b\uff08\u7531JOML\u5e93\u63d0\u4f9b\uff09\u7684\u5b9e\u4f8b\u3002 Matrix4f \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a perspective \u65b9\u6cd5\u6765\u521b\u5efa\u6295\u5f71\u77e9\u9635\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u4ee5\u4e0b\u53c2\u6570\uff1a \u89c6\u91ce\uff1a\u53ef\u89c6\u533a\u57df\u89d2\u7684\u5f27\u5ea6\u5927\u5c0f\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u8be5\u503c\u7684\u5e38\u6570\u3002 \u5c4f\u5e55\u5bbd\u9ad8\u6bd4\u3002 \u6700\u8fd1\u89c6\u8ddd\uff08z-near\uff09\u3002 \u6700\u8fdc\u89c6\u8ddd\uff08z-far\uff09\u3002 \u6211\u4eec\u5c06\u5728 init \u65b9\u6cd5\u4e2d\u5b9e\u4f8b\u5316\u8be5\u77e9\u9635\uff0c\u56e0\u6b64\u9700\u8981\u4f20\u9012\u5bf9 Window \u5b9e\u4f8b\u7684\u9634\u5f71\u4ee5\u83b7\u53d6\u7a97\u53e3\u5927\u5c0f\uff08\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u4ee3\u7801\u5982\u4e0b\uff1a /** * \u89c6\u91ce\u5f27\u5ea6 */ private static final float FOV = (float) Math.toRadians(60.0f); private static final float Z_NEAR = 0.01f; private static final float Z_FAR = 1000.f; private Matrix4f projectionMatrix; \u6295\u5f71\u77e9\u9635\u7684\u521b\u5efa\u5982\u4e0b\u6240\u793a\uff1a float aspectRatio = (float) window.getWidth() / window.getHeight(); projectionMatrix = new Matrix4f().perspective(FOV, aspectRatio, Z_NEAR, Z_FAR); \u73b0\u5728\u6211\u4eec\u7701\u7565\u5bbd\u9ad8\u6bd4\u53ef\u53d8\u7684\u60c5\u51b5\uff08\u901a\u8fc7\u8c03\u6574\u7a97\u53e3\u5927\u5c0f\uff09\uff0c\u8fd9\u53ef\u4ee5\u5728 render \u65b9\u6cd5\u4e2d\u68c0\u67e5\u5e76\u76f8\u5e94\u5730\u6539\u53d8\u6295\u5f71\u77e9\u9635\u3002 \u73b0\u5728\u6709\u4e86\u77e9\u9635\uff0c\u8be5\u5982\u4f55\u4f7f\u7528\u5b83\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\uff0c\u5e76\u4e14\u5b83\u5e94\u8be5\u88ab\u5e94\u7528\u5230\u6240\u6709\u9876\u70b9\u4e0a\u3002\u9996\u5148\uff0c\u4f60\u53ef\u80fd\u4f1a\u60f3\u5230\u628a\u5b83\u6346\u7ed1\u5728\u9876\u70b9\u8f93\u5165\u4e2d\uff08\u5c31\u50cf\u5750\u6807\u548c\u989c\u8272\u90a3\u6837\uff09\u3002\u4f46\u8fd9\u6837\uff0c\u6211\u4eec\u4f1a\u6d6a\u8d39\u5f88\u591a\u7a7a\u95f4\uff0c\u56e0\u4e3a\u6295\u5f71\u77e9\u9635\u5728\u51e0\u6b21\u6e32\u67d3\u671f\u95f4\u90fd\u4e0d\u4f1a\u53d1\u751f\u6539\u53d8\u3002\u4f60\u53ef\u80fd\u8fd8\u60f3\u5728Java\u4ee3\u7801\u4e2d\u7528\u77e9\u9635\u5904\u7406\u6240\u6709\u9876\u70b9\uff0c\u4f46\u8fd9\u6837\u6211\u4eec\u8f93\u5165\u7684VBO\u5c31\u662f\u6ca1\u7528\u7684\u4e86\uff0c\u8fd9\u6837\u5c31\u4e0d\u80fd\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u5904\u7406\u5668\u8d44\u6e90\u4e86\u3002 \u7b54\u6848\u662f\u4f7f\u7528\u201c uniform \u201d\u3002Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4e0e\u7740\u8272\u5668\u4ea4\u6d41\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\uff0c\u5e76\u58f0\u660e\u4e00\u4e2a\u65b0\u7684\u540d\u4e3a projectionMatrix \u7684Uniform\uff0c\u5e76\u7528\u5b83\u6765\u8ba1\u7b97\u6295\u5f71\u540e\u7684\u4f4d\u7f6e\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u628a projectionMatrix \u5b9a\u4e49\u4e3a\u4e00\u4e2a4x4\u7684\u77e9\u9635\uff0c\u65b0\u7684\u5750\u6807\u662f\u901a\u8fc7\u628a\u5b83\u4e0e\u539f\u59cb\u5750\u6807\u76f8\u4e58\u5f97\u5230\u7684\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u628a\u6295\u5f71\u77e9\u9635\u7684\u503c\u4f20\u9012\u7ed9\u7740\u8272\u5668\uff0c\u9996\u5148\u9700\u8981\u786e\u5b9aUniform\u7684\u4f4d\u7f6e\u3002 \u8fd9\u662f\u901a\u8fc7\u8c03\u7528\u65b9\u6cd5 glGetUniformLocation \u5b9e\u73b0\u7684\uff0c\u5b83\u6709\u4e24\u4e2a\u53c2\u6570\uff1a \u7740\u8272\u5668\u7a0b\u5e8f\u7684ID Uniform\u540d\uff08\u5b83\u5e94\u8be5\u4e0e\u7740\u8272\u5668\u91cc\u5b9a\u4e49\u7684\u540d\u79f0\u76f8\u540c\uff09 \u6b64\u65b9\u6cd5\u8fd4\u56de\u50a8\u5b58Uniform\u4f4d\u7f6e\u7684ID\u3002\u7531\u4e8e\u53ef\u80fd\u6709\u4e00\u4e2a\u4ee5\u4e0a\u7684Uniform\uff0c\u6211\u4eec\u5c06\u628a\u8fd9\u4e9bID\u50a8\u5b58\u5728\u7531\u53d8\u91cf\u540d\u4f5c\u4e3a\u7d22\u5f15\u7684Map\u4e2d\uff08\u6b64\u540e\u6211\u4eec\u9700\u8981\u90a3\u4e2aID\uff09\u3002\u56e0\u6b64\uff0c\u5728 ShaderProgram \u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b57\u6bb5\u6765\u4fdd\u5b58\u8fd9\u4e9bID\uff1a private final Map<String, Integer> uniforms; \u7136\u540e\u7531\u6784\u9020\u65b9\u6cd5\u521d\u59cb\u5316\u5b83\uff1a uniforms = new HashMap<>(); \u6700\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u65b0\u7684Uniform\u548c\u50a8\u5b58\u83b7\u5f97\u7684\u4f4d\u7f6e\u3002 public void createUniform(String uniformName) throws Exception { int uniformLocation = glGetUniformLocation(programId, uniformName); if (uniformLocation < 0) { throw new Exception(\"Could not find uniform:\" + uniformName); } uniforms.put(uniformName, uniformLocation); } \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7a0b\u5e8f\u7f16\u8bd1\u540e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u8c03\u7528 createUniform \u65b9\u6cd5\uff08\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5728\u6295\u5f71\u77e9\u9635\u5b9e\u4f8b\u5316\u540e\u8c03\u7528\u5b83\uff09\u3002 shaderProgram.createUniform(\"projectionMatrix\"); \u6b64\u65f6\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u4e00\u4e2a\u53ef\u4ee5\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u6570\u636e\u7684\u50a8\u5b58\u5668\u3002\u7531\u4e8e\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u671f\u95f4\u4e0d\u4f1a\u53d8\u5316\uff0c\u6240\u4ee5\u53ef\u4ee5\u5728\u521b\u5efaUniform\u540e\u76f4\u63a5\u8bbe\u7f6e\u503c\uff0c\u4f46\u6211\u4eec\u5c06\u5728 render \u65b9\u6cd5\u4e2d\u505a\u6b64\u4e8b\u3002\u7a0d\u540e\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ef\u4ee5\u91cd\u7528\u8be5Uniform\u6765\u6267\u884c\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e2d\u9700\u8981\u6267\u884c\u7684\u5176\u4ed6\u64cd\u4f5c\u3002 \u6211\u4eec\u5c06\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a setUniform \u7684\u65b9\u6cd5\u6765\u8bbe\u7f6e\u6570\u636e\uff0c\u901a\u8fc7\u4f7f\u7528JOML\u5e93\u63d0\u4f9b\u7684\u5b9e\u7528\u65b9\u6cd5\u5c06\u77e9\u9635\u8f6c\u6362\u4e3a4x4\u7684 FloatBuffer \u5bf9\u8c61\uff0c\u5e76\u5c06\u5b83\u4eec\u53d1\u9001\u5230Uniform\u4e2d\u3002 public void setUniform(String uniformName, Matrix4f value) { // \u8f6c\u50a8\u77e9\u9635\u5230FloatBuffer try (MemoryStack stack = MemoryStack.stackPush()) { FloatBuffer fb = stack.mallocFloat(16); value.get(fb); glUniformMatrix4fv(uniforms.get(uniformName), false, fb); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528\u4e0e\u6b64\u524d\u4e0d\u540c\u7684\u65b9\u5f0f\u521b\u5efa\u7f13\u51b2\u533a\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f\u81ea\u52a8\u7ba1\u7406\u7684\u7f13\u51b2\u533a\uff0c\u5e76\u5c06\u5b83\u4eec\u5206\u914d\u5230\u5806\u6808\u4e0a\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u5f88\u5c0f\uff0c\u5e76\u4e14\u5728\u8be5\u65b9\u6cd5\u4e4b\u5916\u4e0d\u4f1a\u4f7f\u7528\u5b83\u3002\u56e0\u6b64\u6211\u4eec\u4f7f\u7528 MemoryStack \u7c7b\u3002 \u73b0\u5728\uff0c\u5728\u7740\u8272\u5668\u7ed1\u5b9a\u4e4b\u540e\uff0c\u53ef\u4ee5\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); \u6211\u4eec\u5c31\u8981\u5b8c\u6210\u4e86\uff0c\u73b0\u5728\u53ef\u4ee5\u6b63\u786e\u5730\u6e32\u67d3\u56db\u8fb9\u5f62\uff0c\u6240\u4ee5\u73b0\u5728\u53ef\u4ee5\u542f\u52a8\u7a0b\u5e8f\uff0c\u7136\u540e\u5f97\u5230\u4e00\u4e2a...\u9ed1\u8272\u80cc\u666f\uff0c\u6ca1\u6709\u4efb\u4f55\u5f69\u8272\u56db\u8fb9\u5f62\u3002\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u6211\u4eec\u628a\u4ec0\u4e48\u5f04\u574f\u4e86\u5417\uff1f\u5b9e\u9645\u4e0a\u6ca1\u6709\u4efb\u4f55\u95ee\u9898\u3002\u8bb0\u4f4f\u6211\u4eec\u6b63\u5728\u6a21\u62df\u6444\u50cf\u673a\u89c2\u5bdf\u573a\u666f\u7684\u6548\u679c\u3002\u6211\u4eec\u63d0\u4f9b\u4e86\u4e24\u4e2a\u8ddd\u79bb\uff0c\u4e00\u4e2a\u662f\u6700\u8fdc\u89c6\u8ddd\uff081000f\uff09\u548c\u4e00\u4e2a\u6700\u8fd1\u89c6\u8ddd\uff080.01f\uff09\u3002\u800c\u6211\u4eec\u7684\u5750\u6807\u662f\uff1a float[] positions = new float[]{ -0.5f, 0.5f, 0.0f, -0.5f, -0.5f, 0.0f, 0.5f, -0.5f, 0.0f, 0.5f, 0.5f, 0.0f, }; \u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5750\u6807\u4e2d\u7684Z\u5750\u6807\u4f4d\u4e8e\u53ef\u89c6\u533a\u57df\u4e4b\u5916\u3002\u5c06\u5b83\u4eec\u8d4b\u503c\u4e3a-0.05f\uff0c\u73b0\u5728\u4f60\u4f1a\u770b\u5230\u50cf\u8fd9\u6837\u7684\u4e00\u4e2a\u5de8\u5927\u7684\u7eff\u8272\u6b63\u65b9\u5f62\uff1a \u8fd9\u662f\u56e0\u4e3a\uff0c\u6211\u4eec\u6b63\u7ed8\u5236\u51fa\u79bb\u6444\u50cf\u673a\u592a\u8fd1\u7684\u6b63\u65b9\u5f62\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u653e\u5927\u5b83\u3002\u5982\u679c\u73b0\u5728\u628a\u4e00\u4e2a -1.05f \u7684\u503c\u8d4b\u503c\u7ed9Z\u5750\u6807\uff0c\u5c31\u53ef\u4ee5\u770b\u5230\u5f69\u8272\u6b63\u65b9\u5f62\u4e86\u3002 \u5982\u679c\u7ee7\u7eed\u5411\u540e\u79fb\u52a8\u56db\u8fb9\u5f62\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u5b83\u53d8\u5c0f\u4e86\u3002\u8fd8\u8981\u6ce8\u610f\u5230\u56db\u8fb9\u5f62\u4e0d\u518d\u50cf\u77e9\u5f62\u4e86\u3002","title":"\u6295\u5f71"},{"location":"06-transformations/#_2","text":"\u56de\u60f3\u4e00\u4e0b\u5230\u76ee\u524d\u4e3a\u6b62\u6211\u4eec\u90fd\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u5df2\u7ecf\u5b66\u4f1a\u4e86\u5982\u4f55\u5c06\u6570\u636e\u4ee5\u6709\u6548\u7684\u683c\u5f0f\u4f20\u9012\u7ed9\u663e\u5361\uff0c\u4ee5\u53ca\u5982\u4f55\u4f7f\u7528\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u6765\u6295\u5f71\u8fd9\u4e9b\u9876\u70b9\u5e76\u8bbe\u7f6e\u5b83\u4eec\u7684\u989c\u8272\u3002\u73b0\u5728\u5e94\u8be5\u5f00\u59cb\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7ed8\u5236\u66f4\u590d\u6742\u7684\u6a21\u578b\u4e86\uff0c\u4f46\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u80fd\u591f\u52a0\u8f7d\u6a21\u578b\uff0c\u5e76\u5728\u6307\u5b9a\u7684\u4f4d\u7f6e\u4ee5\u9002\u5f53\u7684\u5927\u5c0f\u548c\u6240\u9700\u7684\u65cb\u8f6c\u5c06\u5b83\u6e32\u67d3\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002 \u73b0\u5728\u4e3a\u4e86\u5b9e\u73b0\u8fd9\u6837\u7684\u6e32\u67d3\uff0c\u6211\u4eec\u9700\u8981\u63d0\u4f9b\u4e00\u4e9b\u57fa\u672c\u64cd\u4f5c\u6765\u64cd\u4f5c\u6a21\u578b\uff1a \u4f4d\u79fb\uff08Translation\uff09: \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09: \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09: \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u4e0a\u9762\u7684\u64cd\u4f5c\u7edf\u79f0\u4e3a\u53d8\u6362\uff08Transformation\uff09\u3002\u4f60\u53ef\u80fd\u731c\u5230\u8981\u5b9e\u73b0\u8fd9\u4e00\u70b9\u7684\u65b9\u6cd5\u662f\u628a\u5750\u6807\u4e58\u4ee5\u4e00\u7ec4\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u79fb\u52a8\uff0c\u4e00\u4e2a\u7528\u4e8e\u65cb\u8f6c\uff0c\u4e00\u4e2a\u7528\u4e8e\u7f29\u653e\uff09\u3002\u8fd9\u4e09\u4e2a\u77e9\u9635\u5c06\u88ab\u7ec4\u5408\u6210\u4e00\u4e2a\u79f0\u4e3a\u201c\u4e16\u754c\u77e9\u9635\u201d\u7684\u77e9\u9635\uff0c\u5e76\u4f5c\u4e3a\u4e00\u4e2aUniform\u4f20\u9012\u7ed9\u9876\u70b9\u7740\u8272\u5668\u3002 \u4e4b\u6240\u4ee5\u88ab\u79f0\u4e3a\u4e16\u754c\u77e9\u9635\uff0c\u662f\u56e0\u4e3a\u6211\u4eec\u6b63\u5728\u5c06\u6a21\u578b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002\u5f53\u5b66\u4e60\u52a0\u8f7d3D\u6a21\u578b\u65f6\uff0c\u4f60\u4f1a\u53d1\u73b0\u8fd9\u4e9b\u6a21\u578b\u662f\u5728\u5b83\u4eec\u81ea\u5df1\u7684\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u7684\uff0c\u5b83\u4eec\u4e0d\u77e5\u9053\u4f60\u7684\u4e09\u7ef4\u7a7a\u95f4\u7684\u5927\u5c0f\uff0c\u4f46\u5b83\u4eec\u9700\u8981\u5728\u91cc\u9762\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u7528\u77e9\u9635\u4e58\u4ee5\u5750\u6807\u65f6\uff0c\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u4ece\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u6a21\u578b\u5750\u6807\u7cfb\uff09\u8f6c\u6362\u5230\u53e6\u4e00\u4e2a\u5750\u6807\u7cfb\uff08\u4e09\u7ef4\u4e16\u754c\u5750\u6807\u7cfb\uff09\u3002 \u4e16\u754c\u77e9\u9635\u5e94\u8be5\u8fd9\u6837\u8ba1\u7b97\uff08\u987a\u5e8f\u5f88\u91cd\u8981\uff0c\u56e0\u4e3a\u4e58\u6cd5\u4ea4\u6362\u5f8b\u4e0d\u9002\u7528\u4e8e\u77e9\u9635\uff09: \u4e16\u754c\u77e9\u9635=\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \u5982\u679c\u628a\u6295\u5f71\u77e9\u9635\u5305\u542b\u5728\u53d8\u6362\u77e9\u9635\u4e2d\uff0c\u5b83\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\begin{array}{lcl} Transf & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4f4d\u79fb\u77e9\u9635\\right]\\left[\u65cb\u8f6c\u77e9\u9635\\right]\\left[\u7f29\u653e\u77e9\u9635\\right] \\\\ & = & \\left[\u6295\u5f71\u77e9\u9635\\right]\\left[\u4e16\u754c\u77e9\u9635\\right] \\end{array} \u4f4d\u79fb\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a \\begin{bmatrix} 1 & 0 & 0 & dx \\\\ 0 & 1 & 0 & dy \\\\ 0 & 0 & 1 & dz \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u4f4d\u79fb\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a dx: \u6cbfX\u8f74\u4f4d\u79fb\u3002 dy: \u6cbfY\u8f74\u4f4d\u79fb\u3002 dz: \u6cbfZ\u8f74\u4f4d\u79fb\u3002 \u7f29\u653e\u77e9\u9635\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1b \\begin{bmatrix} sx & 0 & 0 & 0 \\\\ 0 & sy & 0 & 0 \\\\ 0 & 0 & sz & 0 \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7f29\u653e\u77e9\u9635\u7684\u53c2\u6570\u5982\u4e0b\uff1a sx: \u6cbf\u7740X\u8f74\u7f29\u653e\u3002 sy: \u6cbf\u7740Y\u8f74\u7f29\u653e\u3002 sz: \u6cbf\u7740Z\u8f74\u7f29\u653e\u3002 \u65cb\u8f6c\u77e9\u9635\u8981\u590d\u6742\u5f97\u591a\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u5b83\u53ef\u4ee5\u7531\u6bcf\u4e2a\u7ed5\u5355\u72ec\u7684\u8f74\u65cb\u8f6c\u7684\u65cb\u8f6c\u77e9\u9635\u76f8\u4e58\u5f97\u5230\u3002 \u73b0\u5728\uff0c\u4e3a\u4e86\u5b9e\u8df5\u8fd9\u4e9b\u7406\u8bba\uff0c\u6211\u4eec\u9700\u8981\u91cd\u6784\u4ee3\u7801\u4e00\u70b9\u70b9\u3002\u5728\u6e38\u620f\u4e2d\uff0c\u6211\u4eec\u5c06\u52a0\u8f7d\u4e00\u7ec4\u6a21\u578b\uff0c\u7528\u6765\u6839\u636e\u6e38\u620f\u903b\u8f91\u5728\u4e0d\u540c\u7684\u4f4d\u7f6e\u6e32\u67d3\u8bb8\u591a\u7269\u4f53\uff08\u60f3\u8c61\u4e00\u4e2aFPS\u6e38\u620f\uff0c\u5b83\u8f7d\u5165\u4e86\u4e09\u4e2a\u4e0d\u540c\u654c\u4eba\u7684\u6a21\u578b\u3002\u786e\u5b9e\u53ea\u6709\u4e09\u4e2a\u6a21\u578b\uff0c\u4f46\u4f7f\u7528\u8fd9\u4e9b\u6a21\u578b\uff0c\u6211\u4eec\u53ef\u4ee5\u6e32\u67d3\u60f3\u8981\u7684\u4efb\u610f\u6570\u91cf\u7684\u654c\u4eba\uff09\u3002\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u5bf9\u8c61\u521b\u5efa\u4e00\u4e2aVAO\u548c\u4e00\u7ec4VBO\u5417\uff1f\u7b54\u6848\u662f\u4e0d\u9700\u8981\uff0c\u53ea\u9700\u8981\u6bcf\u4e2a\u6a21\u578b\u52a0\u8f7d\u4e00\u6b21\u5c31\u884c\u3002\u6211\u4eec\u9700\u8981\u505a\u7684\u662f\u6839\u636e\u5b83\u7684\u4f4d\u7f6e\uff0c\u5927\u5c0f\u548c\u65cb\u8f6c\u6765\u72ec\u7acb\u5730\u7ed8\u5236\u5b83\u3002\u5f53\u6e32\u67d3\u8fd9\u4e9b\u6a21\u578b\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u5b83\u4eec\u8fdb\u884c\u53d8\u6362\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a GameItem \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u6a21\u578b\u52a0\u8f7d\u5230 Mesh \u5b9e\u4f8b\u4e2d\u3002\u4e00\u4e2a GameItem \u5b9e\u4f8b\u5c06\u7531\u53d8\u91cf\u50a8\u5b58\u5b83\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u72b6\u6001\u548c\u7f29\u653e\u3002\u5982\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private final Mesh mesh; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem(Mesh mesh) { this.mesh = mesh; position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return mesh; } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Transformation \u7684\u7c7b\uff0c\u8ba9\u5b83\u6765\u5904\u7406\u53d8\u6362\u3002 package org.lwjglb.engine.graph; import org.joml.Matrix4f; import org.joml.Vector3f; public class Transformation { private final Matrix4f projectionMatrix; private final Matrix4f worldMatrix; public Transformation() { worldMatrix = new Matrix4f(); projectionMatrix = new Matrix4f(); } public final Matrix4f getProjectionMatrix(float fov, float width, float height, float zNear, float zFar) { float aspectRatio = width / height; projectionMatrix.identity(); projectionMatrix.perspective(fov, aspectRatio, zNear, zFar); return projectionMatrix; } public Matrix4f getWorldMatrix(Vector3f offset, Vector3f rotation, float scale) { worldMatrix.identity().translate(offset). rotateX((float)Math.toRadians(rotation.x)). rotateY((float)Math.toRadians(rotation.y)). rotateZ((float)Math.toRadians(rotation.z)). scale(scale); return worldMatrix; } } \u5982\u4f60\u6240\u89c1\uff0c\u8fd9\u4e2a\u7c7b\u628a\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u8d77\u6765\u3002\u7ed9\u5b9a\u4e00\u7ec4\u53c2\u6570\u6765\u8fdb\u884c\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u7136\u540e\u8fd4\u56de\u4e16\u754c\u77e9\u9635\u3002 getWorldMatrix \u8fd4\u56de\u7684\u7ed3\u679c\u5c06\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u53d8\u6362\u5750\u6807\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u83b7\u5f97\u6295\u5f71\u77e9\u9635\u7684\u65b9\u6cd5\u3002 \u9700\u8981\u6ce8\u610f\u7684\u4e00\u4ef6\u4e8b\u662f\uff0c Matrix4f \u7c7b\u7684 mul \u65b9\u6cd5\u4fee\u6539\u4e86\u8be5\u5b9e\u4f8b\u7684\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u6295\u5f71\u77e9\u9635\u4e0e\u53d8\u6362\u77e9\u9635\u76f8\u4e58\uff0c\u6211\u4eec\u4f1a\u4fee\u6539\u6295\u5f71\u77e9\u9635\u672c\u8eab\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u603b\u662f\u5728\u6bcf\u6b21\u8c03\u7528\u65f6\u5c06\u6bcf\u4e2a\u77e9\u9635\u521d\u59cb\u5316\u4e3a\u5355\u4f4d\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4ec5\u5b9e\u4f8b\u5316\u4e86\u6ca1\u6709\u4efb\u4f55\u53c2\u6570\u7684 Transformation \u7c7b\uff0c\u800c\u5728 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u521b\u5efa\u4e86Uniform\u3002 public Renderer() { transformation = new Transformation(); } public void init(Window window) throws Exception { // ... \u6b64\u524d\u7684\u4e00\u4e9b\u4ee3\u7801 ... // \u4e3a\u4e16\u754c\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u521b\u5efaUniform shaderProgram.createUniform(\"projectionMatrix\"); shaderProgram.createUniform(\"worldMatrix\"); window.setClearColor(0.0f, 0.0f, 0.0f, 0.0f); } \u5728 Renderer \u7c7b\u7684\u6e32\u67d3\u65b9\u6cd5\u4e2d\uff0c\u73b0\u5728\u53ef\u4ee5\u63a5\u6536\u5230\u4e00\u4e2a GameItem \u7684\u6570\u7ec4\uff1a public void render(Window window, GameItem[] gameItems) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } shaderProgram.bind(); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u6e32\u67d3\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u4e16\u754c\u77e9\u9635 Matrix4f worldMatrix = transformation.getWorldMatrix( gameItem.getPosition(), gameItem.getRotation(), gameItem.getScale()); shaderProgram.setUniform(\"worldMatrix\", worldMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c gameItem.getMesh().render(); } shaderProgram.unbind(); } \u6bcf\u6b21\u8c03\u7528 render \u65f6\u5c31\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21\uff0c\u8fd9\u6837\u6211\u4eec\u53ef\u4ee5\u5904\u7406\u7a97\u53e3\u5927\u5c0f\u7684\u8c03\u6574\u64cd\u4f5c\u3002\u7136\u540e\u6211\u4eec\u904d\u5386 GameItem \u6570\u7ec4\uff0c\u5e76\u6839\u636e\u5b83\u4eec\u5404\u81ea\u7684\u4f4d\u7f6e\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u521b\u5efa\u53d8\u6362\u77e9\u9635\uff0c\u8be5\u77e9\u9635\u5c06\u88ab\u4f20\u9012\u5230\u7740\u8272\u5668\u5e76\u7ed8\u5236 Mesh \u3002\u6295\u5f71\u77e9\u9635\u5bf9\u4e8e\u6240\u6709\u8981\u6e32\u67d3\u7684\u9879\u76ee\u90fd\u662f\u76f8\u540c\u7684\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u5728 Transformation \u7c7b\u4e2d\u662f\u5355\u72ec\u4e00\u4e2a\u53d8\u91cf\u7684\u539f\u56e0\u3002 \u6211\u4eec\u5c06\u6e32\u67d3\u4ee3\u7801\u79fb\u52a8\u5230 Mesh \u7c7b\u4e2d\uff1a public void render() { // \u7ed8\u5236Mesh glBindVertexArray(getVaoId()); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); // \u91cd\u7f6e\u72b6\u6001 glBindVertexArray(0); } \u9876\u70b9\u7740\u8272\u5668\u53ea\u9700\u7b80\u5355\u5730\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 worldMatrix \u77e9\u9635\uff0c\u7136\u540e\u7528\u5b83\u4e0e projectionMatrix \u4e00\u540c\u8ba1\u7b97\u5750\u6807\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec3 inColour; out vec3 exColour; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); exColour = inColour; } \u5982\u4f60\u6240\u89c1\uff0c\u4ee3\u7801\u5b8c\u5168\u4e00\u81f4\u3002\u6211\u4eec\u4f7f\u7528Uniform\u6765\u6b63\u786e\u5730\u6295\u5f71\u5750\u6807\uff0c\u5e76\u4e14\u8003\u8651\u622a\u9525\u3001\u4f4d\u7f6e\u3001\u7f29\u653e\u548c\u65cb\u8f6c\u7b49\u3002 \u53e6\u5916\u4e00\u4e2a\u91cd\u8981\u7684\u95ee\u9898\u662f\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u76f4\u63a5\u4f7f\u7528\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u800c\u662f\u628a\u5b83\u4eec\u7ec4\u5408\u6210\u4e00\u4e2a\u4e16\u754c\u77e9\u9635\u5462\uff1f\u539f\u56e0\u662f\u6211\u4eec\u5e94\u8be5\u5c3d\u91cf\u51cf\u5c11\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u77e9\u9635\u3002\u8fd8\u8981\u8bb0\u4f4f\uff0c\u5728\u7740\u8272\u5668\u4e2d\u6240\u505a\u7684\u77e9\u9635\u4e58\u6cd5\u662f\u6bcf\u4e2a\u9876\u70b9\u4e00\u6b21\uff0c\u6295\u5f71\u77e9\u9635\u5728\u6e32\u67d3\u8c03\u7528\u671f\u95f4\u4e0d\u4f1a\u6539\u53d8\uff0c\u800c\u6bcf\u4e00\u4e2a GameItem \u5b9e\u4f8b\u7684\u4e16\u754c\u77e9\u9635\u4e5f\u4e0d\u4f1a\u6539\u53d8\u3002\u5982\u679c\u72ec\u7acb\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\uff0c\u6211\u4eec\u8981\u505a\u66f4\u591a\u7684\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\u3002\u5728\u4e00\u4e2a\u6709\u8d85\u591a\u9876\u70b9\u7684\u6a21\u578b\u4e2d\uff0c\u8fd9\u662f\u5f88\u591a\u4f59\u7684\u64cd\u4f5c\u3002 \u4f46\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u60f3\uff0c\u5982\u679c\u6bcf\u4e2a GameItem \u4e2d\u7684\u4e16\u754c\u77e9\u9635\u90fd\u4e0d\u4f1a\u53d1\u751f\u53d8\u5316\uff0c\u4e3a\u4ec0\u4e48\u4e0d\u5728Java\u7c7b\u4e2d\u505a\u77e9\u9635\u4e58\u6cd5\uff1f\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u4e0e\u6bcf\u4e2a GameItem \u76f8\u4e58\uff0c\u628a\u5b83\u4eec\u4f5c\u4e3a\u4e00\u4e2aUniform\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u786e\u5b9e\u80fd\u7701\u4e0b\u66f4\u591a\u7684\u64cd\u4f5c\u3002\u4f46\u5f53\u6211\u4eec\u5411\u6e38\u620f\u5f15\u64ce\u4e2d\u6dfb\u52a0\u66f4\u591a\u7684\u7279\u6027\u65f6\uff0c\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u6240\u4ee5\u6700\u597d\u72ec\u7acb\u5730\u5904\u7406\u8fd9\u4e24\u4e2a\u77e9\u9635\u3002 \u6700\u540e\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\uff0c\u8ba9\u5176\u4e0e Mesh \u5173\u8054\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e9b\u903b\u8f91\u6765\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u56db\u8fb9\u5f62\u3002\u56e0\u4e3a\u8fd9\u53ea\u662f\u4e2a\u6d4b\u8bd5\u793a\u4f8b\uff0c\u6ca1\u6709\u6dfb\u52a0\u592a\u591a\u5185\u5bb9\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u76f8\u5173\u4ee3\u7801\u3002","title":"\u4f7f\u7528\u53d8\u6362"},{"location":"07-textures/","text":"\u7eb9\u7406\uff08Textures\uff09 \u521b\u5efa\u4e00\u4e2a\u4e09\u7ef4\u7acb\u65b9\u4f53 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u4e2d\u52a0\u8f7d\u7eb9\u7406\u5e76\u4f7f\u7528\u5b83\u4eec\u3002\u4e3a\u4e86\u8bb2\u89e3\u4e0e\u7eb9\u7406\u76f8\u5173\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u628a\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u6b63\u65b9\u5f62\u66f4\u6539\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u7ed8\u5236\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6b63\u786e\u5730\u5b9a\u4e49\u4e00\u4e2a\u7acb\u65b9\u4f53\u7684\u5750\u6807\uff0c\u5c31\u80fd\u4f7f\u7528\u73b0\u6709\u4ee3\u7801\u6b63\u786e\u5730\u7ed8\u5236\u5b83\u3002 \u4e3a\u4e86\u7ed8\u5236\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u516b\u4e2a\u9876\u70b9\u3002 \u56e0\u6b64\uff0c\u5b83\u7684\u5750\u6807\u6570\u7ec4\u5c06\u662f\u8fd9\u6837\u7684\uff1a float[] positions = new float[] { // VO -0.5f, 0.5f, 0.5f, // V1 -0.5f, -0.5f, 0.5f, // V2 0.5f, -0.5f, 0.5f, // V3 0.5f, 0.5f, 0.5f, // V4 -0.5f, 0.5f, -0.5f, // V5 0.5f, 0.5f, -0.5f, // V6 -0.5f, -0.5f, -0.5f, // V7 0.5f, -0.5f, -0.5f, }; \u5f53\u7136\uff0c\u7531\u4e8e\u6211\u4eec\u591a\u4e864\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u9700\u8981\u66f4\u6539\u989c\u8272\u6570\u7ec4\uff0c\u76ee\u524d\u4ec5\u91cd\u590d\u524d\u56db\u9879\u7684\u503c\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u6700\u540e\uff0c\u7531\u4e8e\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u6784\u6210\u7684\uff0c\u9700\u8981\u7ed8\u5236\u5341\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u6bcf\u4e2a\u9762\u4e24\u4e2a\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4fee\u6539\u7d22\u5f15\u6570\u7ec4\u3002\u8bb0\u4f4f\u4e09\u89d2\u5f62\u5fc5\u987b\u6309\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\uff0c\u5982\u679c\u4f60\u76f4\u63a5\u53bb\u5b9a\u4e49\u4e09\u89d2\u5f62\uff0c\u5f88\u5bb9\u6613\u72af\u9519\u3002\u4e00\u5b9a\u8981\u5c06\u4f60\u60f3\u5b9a\u4e49\u7684\u9762\u6446\u5728\u4f60\u7684\u9762\u524d\uff0c\u786e\u8ba4\u9876\u70b9\u5e76\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 int[] indices = new int[] { // \u524d\u9762 0, 1, 3, 3, 1, 2, // \u4e0a\u9762 4, 0, 3, 5, 4, 3, // \u53f3\u9762 3, 2, 7, 5, 3, 7, // \u5de6\u9762 6, 1, 0, 6, 0, 4, // \u4e0b\u9762 2, 1, 6, 2, 6, 7, // \u540e\u9762 7, 6, 4, 7, 4, 5, }; \u4e3a\u4e86\u66f4\u597d\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u5c06\u4fee\u6539 DummyGame \u7c7b\u4e2d\u65cb\u8f6c\u6a21\u578b\u7684\u4ee3\u7801\uff0c\u4f7f\u6a21\u578b\u6cbf\u7740\u4e09\u4e2a\u8f74\u65cb\u8f6c\u3002 // \u66f4\u65b0\u65cb\u8f6c\u89d2 float rotation = gameItem.getRotation().x + 1.5f; if ( rotation > 360 ) { rotation = 0; } gameItem.setRotation(rotation, rotation, rotation); \u8fd9\u5c31\u5b8c\u4e86\uff0c\u73b0\u5728\u80fd\u591f\u663e\u793a\u4e00\u4e2a\u65cb\u8f6c\u7684\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e86\uff0c\u4f60\u53ef\u4ee5\u7f16\u8bd1\u548c\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u8fd9\u4e2a\u7acb\u65b9\u4f53\u6709\u4e9b\u5947\u602a\uff0c\u6709\u4e9b\u9762\u6ca1\u88ab\u6b63\u786e\u5730\u7ed8\u5236\uff0c\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u7acb\u65b9\u4f53\u4e4b\u6240\u4ee5\u51fa\u73b0\u8fd9\u4e2a\u73b0\u8c61\uff0c\u662f\u56e0\u4e3a\u7ec4\u6210\u7acb\u65b9\u4f53\u7684\u4e09\u89d2\u5f62\u662f\u4ee5\u4e00\u79cd\u968f\u673a\u987a\u5e8f\u7ed8\u5236\u7684\u3002\u4e8b\u5b9e\u4e0a\u8ddd\u79bb\u8f83\u8fdc\u7684\u50cf\u7d20\u5e94\u8be5\u5728\u8ddd\u79bb\u8f83\u8fd1\u7684\u50cf\u7d20\u4e4b\u524d\u7ed8\u5236\uff0c\u800c\u4e0d\u662f\u73b0\u5728\u8fd9\u6837\u3002\u4e3a\u4e86\u4fee\u590d\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\u3002 \u8fd9\u5c06\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u53bb\u505a\uff1a glEnable(GL_DEPTH_TEST); \u73b0\u5728\u7acb\u65b9\u4f53\u88ab\u6b63\u786e\u5730\u6e32\u67d3\u4e86\uff01 \u5982\u679c\u4f60\u770b\u4e86\u672c\u7ae0\u8be5\u5c0f\u8282\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230 Mesh \u7c7b\u505a\u4e86\u4e00\u4e0b\u5c0f\u89c4\u6a21\u7684\u8c03\u6574\uff0cVBO\u7684ID\u73b0\u5728\u88ab\u50a8\u5b58\u5728\u4e00\u4e2aList\u4e2d\uff0c\u4ee5\u4fbf\u4e8e\u8fed\u4ee3\u5b83\u4eec\u3002 \u4e3a\u7acb\u65b9\u4f53\u6dfb\u52a0\u7eb9\u7406 \u73b0\u5728\u6211\u4eec\u5c06\u628a\u7eb9\u7406\u5e94\u7528\u5230\u7acb\u65b9\u4f53\u4e0a\u3002\u7eb9\u7406\uff08Texture\uff09\u662f\u7528\u6765\u7ed8\u5236\u67d0\u4e2a\u6a21\u578b\u7684\u50cf\u7d20\u989c\u8272\u7684\u56fe\u50cf\uff0c\u53ef\u4ee5\u8ba4\u4e3a\u7eb9\u7406\u662f\u5305\u5728\u4e09\u7ef4\u6a21\u578b\u4e0a\u7684\u76ae\u80a4\u3002\u4f60\u8981\u505a\u7684\u662f\u5c06\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u70b9\u5206\u914d\u7ed9\u6a21\u578b\u4e2d\u7684\u9876\u70b9\uff0c\u8fd9\u6837\u505aOpenGL\u5c31\u80fd\u6839\u636e\u7eb9\u7406\u56fe\u50cf\u8ba1\u7b97\u5176\u4ed6\u50cf\u7d20\u7684\u989c\u8272\u3002 \u7eb9\u7406\u56fe\u50cf\u4e0d\u5fc5\u4e0e\u6a21\u578b\u540c\u6837\u5927\u5c0f\uff0c\u5b83\u53ef\u4ee5\u53d8\u5927\u6216\u53d8\u5c0f\u3002\u5982\u679c\u8981\u5904\u7406\u7684\u50cf\u7d20\u4e0d\u80fd\u6620\u5c04\u5230\u7eb9\u7406\u4e2d\u7684\u6307\u5b9a\u70b9\uff0cOpenGL\u5c06\u63a8\u65ad\u989c\u8272\u3002\u53ef\u5728\u521b\u5efa\u7eb9\u7406\u65f6\u63a7\u5236\u5982\u4f55\u8fdb\u884c\u989c\u8272\u63a8\u65ad\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u5c06\u7eb9\u7406\u5e94\u7528\u5230\u6a21\u578b\u4e0a\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u662f\u5c06\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u6bcf\u4e2a\u9876\u70b9\u3002\u7eb9\u7406\u5750\u6807\u7cfb\u6709\u4e9b\u4e0d\u540c\u4e8e\u6a21\u578b\u5750\u6807\u7cfb\u3002\u9996\u5148\uff0c\u6211\u4eec\u7684\u7eb9\u7406\u662f\u4e8c\u7ef4\u7eb9\u7406\uff0c\u6240\u4ee5\u5750\u6807\u53ea\u6709X\u548cY\u4e24\u4e2a\u91cf\u3002\u6b64\u5916\uff0c\u539f\u70b9\u662f\u56fe\u50cf\u7684\u5de6\u4e0a\u89d2\uff0cX\u6216Y\u7684\u6700\u5927\u503c\u90fd\u662f1\u3002 \u6211\u4eec\u5982\u4f55\u5c06\u7eb9\u7406\u5750\u6807\u4e0e\u4f4d\u7f6e\u5750\u6807\u8054\u7cfb\u8d77\u6765\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5c31\u50cf\u4f20\u9012\u989c\u8272\u4fe1\u606f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2aVBO\uff0c\u4e3a\u6bcf\u4e2a\u9876\u70b9\u50a8\u5b58\u5176\u7eb9\u7406\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e0a\u4f7f\u7528\u7eb9\u7406\u5427\u3002\u9996\u5148\u662f\u52a0\u8f7d\u5c06\u88ab\u7528\u4f5c\u7eb9\u7406\u7684\u56fe\u50cf\u3002\u5bf9\u6b64\u5728LWJGL\u7684\u65e9\u671f\u7248\u672c\u4e2d\uff0c\u901a\u5e38\u4f7f\u7528Slick2D\u5e93\u3002\u5728\u64b0\u5199\u672c\u6587\u65f6\uff0c\u8be5\u5e93\u4f3c\u4e4e\u4e0eLWJGL 3\u4e0d\u517c\u5bb9\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u4f7f\u7528LWJGL\u4e3a stb \u5e93\u63d0\u4f9b\u7684\u5c01\u88c5\u3002\u4e3a\u4e86\u4f7f\u7528\u5b83\uff0c\u9996\u5148\u9700\u8981\u5728\u672c\u5730\u7684 pom.xml \u6587\u4ef6\u4e2d\u58f0\u660e\u4f9d\u8d56\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> </dependency> [...] <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u4e00\u4e9b\u6559\u7a0b\u4e2d\uff0c\u4f60\u53ef\u80fd\u770b\u5230\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u8c03\u7528 glEnable(GL_TEXTURE_2D) \u6765\u542f\u7528OpenGL\u73af\u5883\u4e2d\u7684\u7eb9\u7406\u3002\u5982\u679c\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\u8fd9\u662f\u5bf9\u7684\uff0c\u4f46\u6211\u4eec\u4f7f\u7528GLSL\u7740\u8272\u5668\uff0c\u56e0\u6b64\u4e0d\u518d\u9700\u8981\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 Texture \u7c7b\uff0c\u5b83\u5c06\u6267\u884c\u52a0\u8f7d\u7eb9\u7406\u6240\u5fc5\u987b\u7684\u6b65\u9aa4\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5c06\u56fe\u50cf\u8f7d\u5165\u5230 ByteBuffer \u4e2d\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a private static int loadTexture(String fileName) throws Exception { int width; int height; ByteBuffer buf; // \u52a0\u8f7d\u7eb9\u7406\u6587\u4ef6 try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer w = stack.mallocInt(1); IntBuffer h = stack.mallocInt(1); IntBuffer channels = stack.mallocInt(1); buf = stbi_load(fileName, w, h, channels, 4); if (buf == null) { throw new Exception(\"Image file [\" + fileName + \"] not loaded: \" + stbi_failure_reason()); } /* \u83b7\u5f97\u56fe\u50cf\u7684\u9ad8\u5ea6\u4e0e\u5bbd\u5ea6 */ width = w.get(); height = h.get(); } [... \u63a5\u4e0b\u6765\u8fd8\u6709\u66f4\u591a\u4ee3\u7801 ...] \u9996\u5148\u6211\u4eec\u8981\u4e3a\u5e93\u5206\u914d IntBuffer \uff0c\u4ee5\u8fd4\u56de\u56fe\u50cf\u5927\u5c0f\u4e0e\u901a\u9053\u6570\u3002\u7136\u540e\uff0c\u6211\u4eec\u8c03\u7528 stbi_load \u65b9\u6cd5\u5c06\u56fe\u50cf\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u5982\u4e0b\u53c2\u6570\uff1a filePath \uff1a\u6587\u4ef6\u7684\u7edd\u5bf9\u8def\u5f84\u3002stb\u5e93\u662f\u672c\u5730\u7684\uff0c\u4e0d\u77e5\u9053\u5173\u4e8e CLASSPATH \u7684\u4efb\u4f55\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5e38\u89c4\u7684\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 width \uff1a\u56fe\u50cf\u5bbd\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u5bbd\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 height \uff1a\u56fe\u50cf\u9ad8\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u9ad8\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 channels \uff1a\u56fe\u50cf\u901a\u9053\u3002 desired_channels \uff1a\u6240\u9700\u7684\u56fe\u50cf\u901a\u9053\uff0c\u6211\u4eec\u4f20\u51654\uff08RGBA\uff09\u3002 \u4e00\u4ef6\u5173\u4e8eOpenGL\u7684\u91cd\u8981\u4e8b\u9879\uff0c\u7531\u4e8e\u5386\u53f2\u539f\u56e0\uff0c\u8981\u6c42\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u6bcf\u4e2a\u8f74\u7684\u50cf\u7d20\u6570\uff09\u5fc5\u987b\u662f\u4e8c\u7684\u6307\u6570\uff082, 4, 8, 16, ....\uff09\u3002\u4e00\u4e9b\u9a71\u52a8\u89e3\u9664\u4e86\u8fd9\u79cd\u9650\u5236\uff0c\u4f46\u6700\u597d\u8fd8\u662f\u4fdd\u6301\u4ee5\u514d\u51fa\u73b0\u95ee\u9898\u3002 \u4e0b\u4e00\u6b65\u662f\u5c06\u7eb9\u7406\u4e0a\u4f20\u5230\u663e\u5b58\u4e2d\u3002\u9996\u5148\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7eb9\u7406ID\uff0c\u4e0e\u8be5\u7eb9\u7406\u76f8\u5173\u7684\u64cd\u4f5c\u90fd\u8981\u4f7f\u7528\u8be5ID\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u5b83\u3002 // \u521b\u5efa\u4e00\u4e2a\u65b0\u7684OpenGL\u7eb9\u7406 int textureId = glGenTextures(); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, textureId); \u7136\u540e\u9700\u8981\u544a\u8bc9OpenGL\u5982\u4f55\u89e3\u5305RGBA\u5b57\u8282\uff0c\u7531\u4e8e\u6bcf\u4e2a\u5206\u91cf\u53ea\u6709\u4e00\u4e2a\u5b57\u8282\u5927\u5c0f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u4ee5\u4e0b\u4ee3\u7801\uff1a glPixelStorei(GL_UNPACK_ALIGNMENT, 1); \u6700\u540e\u6211\u4eec\u53ef\u4ee5\u4e0a\u4f20\u7eb9\u7406\u6570\u636e\uff1a glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, buf); glTexImage2D \u7684\u53c2\u6570\u5982\u4e0b\u6240\u793a\uff1a target : \u6307\u5b9a\u76ee\u6807\u7eb9\u7406\uff08\u7eb9\u7406\u7c7b\u578b\uff09\uff0c\u672c\u4f8b\u4e2d\u662f GL_TEXTURE_2D \u3002 level : \u6307\u5b9a\u7eb9\u7406\u7ec6\u8282\u7684\u7b49\u7ea7\u30020\u7ea7\u662f\u57fa\u672c\u56fe\u50cf\u7b49\u7ea7\uff0c\u7b2cn\u7ea7\u662f\u7b2cn\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u7684\u56fe\u50cf\uff0c\u4e4b\u540e\u518d\u8c08\u8bba\u8fd9\u4e2a\u95ee\u9898\u3002 internal format : \u6307\u5b9a\u7eb9\u7406\u4e2d\u989c\u8272\u5206\u91cf\u7684\u6570\u91cf\u3002 width : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u5bbd\u5ea6\u3002 height : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u9ad8\u5ea6\u3002 border : \u6b64\u503c\u5fc5\u987b\u4e3a0\u3002 format : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u683c\u5f0f\uff0c\u73b0\u5728\u4e3aRGBA\u3002 type : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u7c7b\u578b\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65e0\u7b26\u53f7\u5b57\u8282\u3002 data : \u50a8\u5b58\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002 \u5728\u4e00\u4e9b\u4ee3\u7801\u4e2d\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5728\u8c03\u7528 glTexImage2D \u65b9\u6cd5\u524d\u8bbe\u7f6e\u4e86\u4e00\u4e9b\u8fc7\u6ee4\u53c2\u6570\u3002\u8fc7\u6ee4\u662f\u6307\u5728\u7f29\u653e\u65f6\u5982\u4f55\u7ed8\u5236\u56fe\u50cf\uff0c\u4ee5\u53ca\u5982\u4f55\u63d2\u503c\u50cf\u7d20\u3002\u5982\u679c\u672a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff0c\u7eb9\u7406\u5c06\u4e0d\u4f1a\u663e\u793a\u3002\u56e0\u6b64\uff0c\u5728 glTexImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u524d\uff0c\u4f1a\u770b\u5230\u4ee5\u4e0b\u4ee3\u7801\uff1a glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u8fd9\u4e9b\u53c2\u6570\u57fa\u672c\u4e0a\u5728\u8bf4\uff0c\u5f53\u7ed8\u5236\u4e00\u4e2a\u50cf\u7d20\u65f6\uff0c\u5982\u679c\u6ca1\u6709\u76f4\u63a5\u4e00\u5bf9\u4e00\u5730\u5173\u8054\u5230\u7eb9\u7406\u5750\u6807\uff0c\u5b83\u5c06\u9009\u62e9\u6700\u8fd1\u7684\u7eb9\u7406\u5750\u6807\u70b9\u3002 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e0d\u4f1a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u751f\u6210\u4e00\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u662f\u7531\u9ad8\u7ec6\u8282\u7eb9\u7406\u751f\u6210\u7684\u9010\u7ea7\u964d\u4f4e\u5206\u8fa8\u7387\u7684\u7eb9\u7406\u96c6\u5408\u3002\u5f53\u6211\u4eec\u7684\u7269\u4f53\u7f29\u653e\u65f6\uff0c\u5c31\u5c06\u81ea\u52a8\u4f7f\u7528\u4f4e\u5206\u8fa8\u7387\u7684\u56fe\u50cf\u3002 \u4e3a\u4e86\u751f\u6210\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff0c\u53ea\u9700\u8981\u7f16\u5199\u4ee5\u4e0b\u4ee3\u7801\uff08\u76ee\u524d\u6211\u4eec\u628a\u5b83\u653e\u5728 glTextImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u540e\uff09\uff1a glGenerateMipmap(GL_TEXTURE_2D); \u6700\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u91ca\u653e\u539f\u59cb\u56fe\u50cf\u6570\u636e\u672c\u8eab\u7684\u5185\u5b58\uff1a stbi_image_free(buf); \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u5df2\u7ecf\u6210\u529f\u5730\u52a0\u8f7d\u4e86\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6b63\u5982\u6b64\u524d\u6240\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u628a\u7eb9\u7406\u5750\u6807\u4f5c\u4e3a\u53e6\u4e00\u4e2aVBO\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u4fee\u6539 Mesh \u7c7b\u4ee5\u63a5\u6536\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u800c\u4e0d\u662f\u989c\u8272\uff08\u6211\u4eec\u53ef\u4ee5\u540c\u65f6\u6709\u989c\u8272\u548c\u7eb9\u7406\uff0c\u4f46\u4e3a\u4e86\u7b80\u5316\u5b83\uff0c\u6211\u4eec\u5c06\u5220\u9664\u989c\u8272\uff09\uff0c\u6784\u9020\u51fd\u6570\u73b0\u5728\u5982\u4e0b\u6240\u793a\uff1a public Mesh(float[] positions, float[] textCoords, int[] indices, Texture texture) \u7eb9\u7406\u5750\u6807VBO\u4e0e\u989c\u8272VBO\u521b\u5efa\u7684\u65b9\u5f0f\u76f8\u540c\u3002\u552f\u4e00\u7684\u533a\u522b\u662f\u5b83\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\u800c\u4e0d\u662f\u4e09\u4e2a\uff1a vboId = glGenBuffers(); vboIdList.add(vboId); textCoordsBuffer = MemoryUtil.memAllocFloat(textCoords.length); textCoordsBuffer.put(textCoords).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, textCoordsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 2, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4fee\u6539\u4e86\u7b2c\u4e8c\u4e2a\u8f93\u5165\u53c2\u6570\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u662f\u4e00\u4e2a vec2 \uff08\u4e5f\u987a\u4fbf\u66f4\u6539\u4e86\u540d\u79f0\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c31\u50cf\u6b64\u524d\u4e00\u6837\uff0c\u4ec5\u5c06\u7eb9\u7406\u5750\u6807\u4f20\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; out vec2 outTexCoord; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u90a3\u4e9b\u7eb9\u7406\u5750\u6807\u6765\u8bbe\u7f6e\u50cf\u7d20\u989c\u8272\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5728\u5206\u6790\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u7406\u6e05\u4e00\u4e9b\u6982\u5ff5\u3002\u663e\u5361\u6709\u51e0\u4e2a\u7a7a\u95f4\u6216\u69fd\u6765\u50a8\u5b58\u7eb9\u7406\uff0c\u6bcf\u4e00\u4e2a\u7a7a\u95f4\u88ab\u79f0\u4e3a\u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\u3002\u5f53\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u6211\u4eec\u5fc5\u987b\u8bbe\u7f6e\u60f3\u7528\u7684\u7eb9\u7406\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a texture_sampler \u7684\u65b0Uniform\uff0c\u8be5Uniform\u7684\u7c7b\u578b\u662f sampler2D \uff0c\u5e76\u50a8\u5b58\u6709\u6211\u4eec\u5e0c\u671b\u4f7f\u7528\u7684\u7eb9\u7406\u5355\u5143\u7684\u503c\u3002 \u5728 main \u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u540d\u4e3a texture \u7684\u7eb9\u7406\u91c7\u6837\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u6709\u4e24\u4e2a\u53c2\u6570\uff1a\u53d6\u6837\u5668\uff08Sampler\uff09\u548c\u7eb9\u7406\u5750\u6807\uff0c\u5e76\u8fd4\u56de\u6b63\u786e\u7684\u989c\u8272\u3002\u53d6\u6837\u5668Uniform\u5141\u8bb8\u4f7f\u7528\u591a\u91cd\u7eb9\u7406\uff08Multi-texture\uff09\uff0c\u4e0d\u8fc7\u73b0\u5728\u4e0d\u662f\u8ba8\u8bba\u8fd9\u4e2a\u8bdd\u9898\u7684\u65f6\u5019\uff0c\u4f46\u662f\u6211\u4eec\u4f1a\u5728\u7a0d\u540e\u518d\u5c1d\u8bd5\u6dfb\u52a0\u3002 \u56e0\u6b64\uff0c\u5728 ShaderProgram \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u5141\u8bb8\u4e3a\u6574\u6570\u578bUniform\u8bbe\u7f6e\u503c\uff1a public void setUniform(String uniformName, int value) { glUniform1i(uniforms.get(uniformName), value); } \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684Uniform\uff1a shaderProgram.createUniform(\"texture_sampler\"); \u6b64\u5916\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06Uniform\u7684\u503c\u8bbe\u7f6e\u4e3a0\uff08\u6211\u4eec\u73b0\u5728\u4e0d\u4f7f\u7528\u591a\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u53ea\u4f7f\u7528\u5355\u51430\uff09\u3002 shaderProgram.setUniform(\"texture_sampler\", 0); \u6700\u597d\uff0c\u6211\u4eec\u53ea\u9700\u4fee\u6539 Mesh \u7c7b\u7684 render \u65b9\u6cd5\u5c31\u53ef\u4ee5\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u65b9\u6cd5\u8d77\u59cb\u5904\uff0c\u6dfb\u52a0\u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\uff1a // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5355\u5143 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); \u6211\u4eec\u5df2\u7ecf\u5c06 texture.getId() \u6240\u83b7\u5f97\u7684\u7eb9\u7406ID\u7ed1\u5b9a\u5230\u7eb9\u7406\u5355\u51430\u4e0a\u3002 \u6211\u4eec\u521a\u521a\u4fee\u6539\u4e86\u4ee3\u7801\u6765\u652f\u6301\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\uff0c\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\u662f\u8fd9\u6837\u7684\uff1a \u5728\u6211\u4eec\u7684\u4e09\u7ef4\u6a21\u578b\u4e2d\uff0c\u5171\u6709\u516b\u4e2a\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u5b9a\u4e49\u6b63\u9762\u6bcf\u4e2a\u9876\u70b9\u7684\u7eb9\u7406\u5750\u6807\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V0 0.0, 0.0 V1 0.0, 0.5 V2 0.5, 0.5 V3 0.5, 0.0 \u7136\u540e\uff0c\u5b9a\u4e49\u9876\u9762\u7684\u7eb9\u7406\u6620\u5c04\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V4 0.0, 0.5 V5 0.5, 0.5 V0 0.0, 1.0 V3 0.5, 1.0 \u5982\u4f60\u6240\u89c1\uff0c\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u540c\u4e00\u4e2a\u9876\u70b9\uff08V0\u548cV3\uff09\u8bbe\u7f6e\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u600e\u4e48\u6837\u624d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u5462\uff1f\u89e3\u51b3\u8fd9\u4e00\u95ee\u9898\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u91cd\u590d\u4e00\u4e9b\u9876\u70b9\u5e76\u5173\u8054\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u5bf9\u4e8e\u9876\u9762\uff0c\u6211\u4eec\u9700\u8981\u91cd\u590d\u56db\u4e2a\u9876\u70b9\u5e76\u4e3a\u5b83\u4eec\u5206\u914d\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u3002 \u56e0\u4e3a\u524d\u9762\u3001\u540e\u9762\u548c\u4fa7\u9762\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u9700\u8981\u91cd\u590d\u8fd9\u4e9b\u9876\u70b9\u3002\u5728\u6e90\u7801\u4e2d\u6709\u5b8c\u6574\u7684\u5b9a\u4e49\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ece8\u4e2a\u70b9\u4e0a\u5347\u523020\u4e2a\u70b9\u4e86\u3002\u6700\u7ec8\u7684\u7ed3\u679c\u5c31\u50cf\u8fd9\u6837\u3002 \u5728\u63a5\u4e0b\u6765\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u75313D\u5efa\u6a21\u5de5\u5177\u751f\u6210\u7684\u6a21\u578b\uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u624b\u52a8\u5b9a\u4e49\u9876\u70b9\u548c\u7eb9\u7406\u5750\u6807\u4e86\uff08\u987a\u4fbf\u4e00\u63d0\uff0c\u5bf9\u4e8e\u66f4\u590d\u6742\u7684\u6a21\u578b\uff0c\u624b\u52a8\u5b9a\u4e49\u662f\u4e0d\u5b58\u5728\u7684\uff09\u3002 \u900f\u660e\u7eb9\u7406\u7b80\u4ecb \u5982\u4f60\u6240\u89c1\uff0c\u5f53\u52a0\u8f7d\u56fe\u50cf\u65f6\uff0c\u6211\u4eec\u68c0\u7d22\u4e86\u56db\u4e2aRGBA\u7ec4\u4ef6\uff0c\u5305\u62ec\u900f\u660e\u5ea6\u7b49\u7ea7\u3002\u4f46\u5982\u679c\u52a0\u8f7d\u4e00\u4e2a\u900f\u660e\u7684\u7eb9\u7406\uff0c\u53ef\u80fd\u770b\u4e0d\u5230\u4efb\u4f55\u4e1c\u897f\u3002\u4e3a\u4e86\u652f\u6301\u900f\u660e\u5ea6\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u4ee5\u4e0b\u4ee3\u7801\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff1a glEnable(GL_BLEND); \u4f46\u4ec5\u542f\u7528\u6df7\u5408\uff0c\u900f\u660e\u6548\u679c\u4ecd\u7136\u4e0d\u4f1a\u663e\u793a\uff0c\u6211\u4eec\u8fd8\u9700\u8981\u6307\u793aOpenGL\u5982\u4f55\u8fdb\u884c\u6df7\u5408\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glBlendFunc \u65b9\u6cd5\u5b8c\u6210\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u4f60\u53ef\u4ee5\u67e5\u770b \u6b64\u5904 \u6709\u5173\u53ef\u4f7f\u7528\u7684\u4e0d\u540c\u529f\u80fd\u7684\u8be6\u7ec6\u8bf4\u660e\u3002 \u5373\u4f7f\u542f\u7528\u4e86\u6df7\u5408\u5e76\u8bbe\u7f6e\u4e86\u529f\u80fd\uff0c\u4e5f\u53ef\u80fd\u770b\u4e0d\u5230\u6b63\u786e\u7684\u900f\u660e\u6548\u679c\u3002\u5176\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5f53\u4f7f\u7528\u6df1\u5ea6\u503c\u4e22\u5f03\u7247\u5143\u65f6\uff0c\u6211\u4eec\u53ef\u80fd\u5c06\u5177\u6709\u900f\u660e\u5ea6\u7684\u7247\u5143\u4e0e\u80cc\u666f\u6df7\u5408\uff0c\u800c\u4e0d\u662f\u4e0e\u5b83\u4eec\u540e\u9762\u7684\u7247\u5143\u6df7\u5408\uff0c\u8fd9\u5c06\u5f97\u5230\u9519\u8bef\u7684\u6e32\u67d3\u7ed3\u679c\u3002\u4e3a\u4e86\u89e3\u51b3\u8be5\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u5148\u7ed8\u5236\u4e0d\u900f\u660e\u7269\u4f53\uff0c\u7136\u540e\u6309\u6df1\u5ea6\u9012\u51cf\u987a\u5e8f\u7ed8\u5236\u5177\u6709\u900f\u660e\u5ea6\u7684\u7269\u4f53\uff08\u5e94\u5148\u7ed8\u5236\u8f83\u8fdc\u7269\u4f53\uff09\u3002","title":"\u7eb9\u7406"},{"location":"07-textures/#textures","text":"","title":"\u7eb9\u7406\uff08Textures\uff09"},{"location":"07-textures/#_1","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u4e2d\u52a0\u8f7d\u7eb9\u7406\u5e76\u4f7f\u7528\u5b83\u4eec\u3002\u4e3a\u4e86\u8bb2\u89e3\u4e0e\u7eb9\u7406\u76f8\u5173\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u628a\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u6b63\u65b9\u5f62\u66f4\u6539\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u7ed8\u5236\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6b63\u786e\u5730\u5b9a\u4e49\u4e00\u4e2a\u7acb\u65b9\u4f53\u7684\u5750\u6807\uff0c\u5c31\u80fd\u4f7f\u7528\u73b0\u6709\u4ee3\u7801\u6b63\u786e\u5730\u7ed8\u5236\u5b83\u3002 \u4e3a\u4e86\u7ed8\u5236\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u516b\u4e2a\u9876\u70b9\u3002 \u56e0\u6b64\uff0c\u5b83\u7684\u5750\u6807\u6570\u7ec4\u5c06\u662f\u8fd9\u6837\u7684\uff1a float[] positions = new float[] { // VO -0.5f, 0.5f, 0.5f, // V1 -0.5f, -0.5f, 0.5f, // V2 0.5f, -0.5f, 0.5f, // V3 0.5f, 0.5f, 0.5f, // V4 -0.5f, 0.5f, -0.5f, // V5 0.5f, 0.5f, -0.5f, // V6 -0.5f, -0.5f, -0.5f, // V7 0.5f, -0.5f, -0.5f, }; \u5f53\u7136\uff0c\u7531\u4e8e\u6211\u4eec\u591a\u4e864\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u9700\u8981\u66f4\u6539\u989c\u8272\u6570\u7ec4\uff0c\u76ee\u524d\u4ec5\u91cd\u590d\u524d\u56db\u9879\u7684\u503c\u3002 float[] colours = new float[]{ 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 0.5f, 0.0f, 0.5f, 0.5f, }; \u6700\u540e\uff0c\u7531\u4e8e\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u6784\u6210\u7684\uff0c\u9700\u8981\u7ed8\u5236\u5341\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u6bcf\u4e2a\u9762\u4e24\u4e2a\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4fee\u6539\u7d22\u5f15\u6570\u7ec4\u3002\u8bb0\u4f4f\u4e09\u89d2\u5f62\u5fc5\u987b\u6309\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\uff0c\u5982\u679c\u4f60\u76f4\u63a5\u53bb\u5b9a\u4e49\u4e09\u89d2\u5f62\uff0c\u5f88\u5bb9\u6613\u72af\u9519\u3002\u4e00\u5b9a\u8981\u5c06\u4f60\u60f3\u5b9a\u4e49\u7684\u9762\u6446\u5728\u4f60\u7684\u9762\u524d\uff0c\u786e\u8ba4\u9876\u70b9\u5e76\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 int[] indices = new int[] { // \u524d\u9762 0, 1, 3, 3, 1, 2, // \u4e0a\u9762 4, 0, 3, 5, 4, 3, // \u53f3\u9762 3, 2, 7, 5, 3, 7, // \u5de6\u9762 6, 1, 0, 6, 0, 4, // \u4e0b\u9762 2, 1, 6, 2, 6, 7, // \u540e\u9762 7, 6, 4, 7, 4, 5, }; \u4e3a\u4e86\u66f4\u597d\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u6211\u4eec\u5c06\u4fee\u6539 DummyGame \u7c7b\u4e2d\u65cb\u8f6c\u6a21\u578b\u7684\u4ee3\u7801\uff0c\u4f7f\u6a21\u578b\u6cbf\u7740\u4e09\u4e2a\u8f74\u65cb\u8f6c\u3002 // \u66f4\u65b0\u65cb\u8f6c\u89d2 float rotation = gameItem.getRotation().x + 1.5f; if ( rotation > 360 ) { rotation = 0; } gameItem.setRotation(rotation, rotation, rotation); \u8fd9\u5c31\u5b8c\u4e86\uff0c\u73b0\u5728\u80fd\u591f\u663e\u793a\u4e00\u4e2a\u65cb\u8f6c\u7684\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e86\uff0c\u4f60\u53ef\u4ee5\u7f16\u8bd1\u548c\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u8fd9\u4e2a\u7acb\u65b9\u4f53\u6709\u4e9b\u5947\u602a\uff0c\u6709\u4e9b\u9762\u6ca1\u88ab\u6b63\u786e\u5730\u7ed8\u5236\uff0c\u8fd9\u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u7acb\u65b9\u4f53\u4e4b\u6240\u4ee5\u51fa\u73b0\u8fd9\u4e2a\u73b0\u8c61\uff0c\u662f\u56e0\u4e3a\u7ec4\u6210\u7acb\u65b9\u4f53\u7684\u4e09\u89d2\u5f62\u662f\u4ee5\u4e00\u79cd\u968f\u673a\u987a\u5e8f\u7ed8\u5236\u7684\u3002\u4e8b\u5b9e\u4e0a\u8ddd\u79bb\u8f83\u8fdc\u7684\u50cf\u7d20\u5e94\u8be5\u5728\u8ddd\u79bb\u8f83\u8fd1\u7684\u50cf\u7d20\u4e4b\u524d\u7ed8\u5236\uff0c\u800c\u4e0d\u662f\u73b0\u5728\u8fd9\u6837\u3002\u4e3a\u4e86\u4fee\u590d\u5b83\uff0c\u6211\u4eec\u5fc5\u987b\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\u3002 \u8fd9\u5c06\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u53bb\u505a\uff1a glEnable(GL_DEPTH_TEST); \u73b0\u5728\u7acb\u65b9\u4f53\u88ab\u6b63\u786e\u5730\u6e32\u67d3\u4e86\uff01 \u5982\u679c\u4f60\u770b\u4e86\u672c\u7ae0\u8be5\u5c0f\u8282\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230 Mesh \u7c7b\u505a\u4e86\u4e00\u4e0b\u5c0f\u89c4\u6a21\u7684\u8c03\u6574\uff0cVBO\u7684ID\u73b0\u5728\u88ab\u50a8\u5b58\u5728\u4e00\u4e2aList\u4e2d\uff0c\u4ee5\u4fbf\u4e8e\u8fed\u4ee3\u5b83\u4eec\u3002","title":"\u521b\u5efa\u4e00\u4e2a\u4e09\u7ef4\u7acb\u65b9\u4f53"},{"location":"07-textures/#_2","text":"\u73b0\u5728\u6211\u4eec\u5c06\u628a\u7eb9\u7406\u5e94\u7528\u5230\u7acb\u65b9\u4f53\u4e0a\u3002\u7eb9\u7406\uff08Texture\uff09\u662f\u7528\u6765\u7ed8\u5236\u67d0\u4e2a\u6a21\u578b\u7684\u50cf\u7d20\u989c\u8272\u7684\u56fe\u50cf\uff0c\u53ef\u4ee5\u8ba4\u4e3a\u7eb9\u7406\u662f\u5305\u5728\u4e09\u7ef4\u6a21\u578b\u4e0a\u7684\u76ae\u80a4\u3002\u4f60\u8981\u505a\u7684\u662f\u5c06\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u70b9\u5206\u914d\u7ed9\u6a21\u578b\u4e2d\u7684\u9876\u70b9\uff0c\u8fd9\u6837\u505aOpenGL\u5c31\u80fd\u6839\u636e\u7eb9\u7406\u56fe\u50cf\u8ba1\u7b97\u5176\u4ed6\u50cf\u7d20\u7684\u989c\u8272\u3002 \u7eb9\u7406\u56fe\u50cf\u4e0d\u5fc5\u4e0e\u6a21\u578b\u540c\u6837\u5927\u5c0f\uff0c\u5b83\u53ef\u4ee5\u53d8\u5927\u6216\u53d8\u5c0f\u3002\u5982\u679c\u8981\u5904\u7406\u7684\u50cf\u7d20\u4e0d\u80fd\u6620\u5c04\u5230\u7eb9\u7406\u4e2d\u7684\u6307\u5b9a\u70b9\uff0cOpenGL\u5c06\u63a8\u65ad\u989c\u8272\u3002\u53ef\u5728\u521b\u5efa\u7eb9\u7406\u65f6\u63a7\u5236\u5982\u4f55\u8fdb\u884c\u989c\u8272\u63a8\u65ad\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u5c06\u7eb9\u7406\u5e94\u7528\u5230\u6a21\u578b\u4e0a\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u662f\u5c06\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u6bcf\u4e2a\u9876\u70b9\u3002\u7eb9\u7406\u5750\u6807\u7cfb\u6709\u4e9b\u4e0d\u540c\u4e8e\u6a21\u578b\u5750\u6807\u7cfb\u3002\u9996\u5148\uff0c\u6211\u4eec\u7684\u7eb9\u7406\u662f\u4e8c\u7ef4\u7eb9\u7406\uff0c\u6240\u4ee5\u5750\u6807\u53ea\u6709X\u548cY\u4e24\u4e2a\u91cf\u3002\u6b64\u5916\uff0c\u539f\u70b9\u662f\u56fe\u50cf\u7684\u5de6\u4e0a\u89d2\uff0cX\u6216Y\u7684\u6700\u5927\u503c\u90fd\u662f1\u3002 \u6211\u4eec\u5982\u4f55\u5c06\u7eb9\u7406\u5750\u6807\u4e0e\u4f4d\u7f6e\u5750\u6807\u8054\u7cfb\u8d77\u6765\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5c31\u50cf\u4f20\u9012\u989c\u8272\u4fe1\u606f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2aVBO\uff0c\u4e3a\u6bcf\u4e2a\u9876\u70b9\u50a8\u5b58\u5176\u7eb9\u7406\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u4fbf\u5728\u4e09\u7ef4\u7acb\u65b9\u4f53\u4e0a\u4f7f\u7528\u7eb9\u7406\u5427\u3002\u9996\u5148\u662f\u52a0\u8f7d\u5c06\u88ab\u7528\u4f5c\u7eb9\u7406\u7684\u56fe\u50cf\u3002\u5bf9\u6b64\u5728LWJGL\u7684\u65e9\u671f\u7248\u672c\u4e2d\uff0c\u901a\u5e38\u4f7f\u7528Slick2D\u5e93\u3002\u5728\u64b0\u5199\u672c\u6587\u65f6\uff0c\u8be5\u5e93\u4f3c\u4e4e\u4e0eLWJGL 3\u4e0d\u517c\u5bb9\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u4f7f\u7528LWJGL\u4e3a stb \u5e93\u63d0\u4f9b\u7684\u5c01\u88c5\u3002\u4e3a\u4e86\u4f7f\u7528\u5b83\uff0c\u9996\u5148\u9700\u8981\u5728\u672c\u5730\u7684 pom.xml \u6587\u4ef6\u4e2d\u58f0\u660e\u4f9d\u8d56\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> </dependency> [...] <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-stb</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u4e00\u4e9b\u6559\u7a0b\u4e2d\uff0c\u4f60\u53ef\u80fd\u770b\u5230\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u8c03\u7528 glEnable(GL_TEXTURE_2D) \u6765\u542f\u7528OpenGL\u73af\u5883\u4e2d\u7684\u7eb9\u7406\u3002\u5982\u679c\u4f7f\u7528\u56fa\u5b9a\u7ba1\u7ebf\u8fd9\u662f\u5bf9\u7684\uff0c\u4f46\u6211\u4eec\u4f7f\u7528GLSL\u7740\u8272\u5668\uff0c\u56e0\u6b64\u4e0d\u518d\u9700\u8981\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 Texture \u7c7b\uff0c\u5b83\u5c06\u6267\u884c\u52a0\u8f7d\u7eb9\u7406\u6240\u5fc5\u987b\u7684\u6b65\u9aa4\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u5c06\u56fe\u50cf\u8f7d\u5165\u5230 ByteBuffer \u4e2d\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a private static int loadTexture(String fileName) throws Exception { int width; int height; ByteBuffer buf; // \u52a0\u8f7d\u7eb9\u7406\u6587\u4ef6 try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer w = stack.mallocInt(1); IntBuffer h = stack.mallocInt(1); IntBuffer channels = stack.mallocInt(1); buf = stbi_load(fileName, w, h, channels, 4); if (buf == null) { throw new Exception(\"Image file [\" + fileName + \"] not loaded: \" + stbi_failure_reason()); } /* \u83b7\u5f97\u56fe\u50cf\u7684\u9ad8\u5ea6\u4e0e\u5bbd\u5ea6 */ width = w.get(); height = h.get(); } [... \u63a5\u4e0b\u6765\u8fd8\u6709\u66f4\u591a\u4ee3\u7801 ...] \u9996\u5148\u6211\u4eec\u8981\u4e3a\u5e93\u5206\u914d IntBuffer \uff0c\u4ee5\u8fd4\u56de\u56fe\u50cf\u5927\u5c0f\u4e0e\u901a\u9053\u6570\u3002\u7136\u540e\uff0c\u6211\u4eec\u8c03\u7528 stbi_load \u65b9\u6cd5\u5c06\u56fe\u50cf\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\uff0c\u8be5\u65b9\u6cd5\u9700\u8981\u5982\u4e0b\u53c2\u6570\uff1a filePath \uff1a\u6587\u4ef6\u7684\u7edd\u5bf9\u8def\u5f84\u3002stb\u5e93\u662f\u672c\u5730\u7684\uff0c\u4e0d\u77e5\u9053\u5173\u4e8e CLASSPATH \u7684\u4efb\u4f55\u5185\u5bb9\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5e38\u89c4\u7684\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 width \uff1a\u56fe\u50cf\u5bbd\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u5bbd\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 height \uff1a\u56fe\u50cf\u9ad8\u5ea6\uff0c\u83b7\u53d6\u7684\u56fe\u50cf\u9ad8\u5ea6\u5c06\u88ab\u5199\u5165\u5176\u4e2d\u3002 channels \uff1a\u56fe\u50cf\u901a\u9053\u3002 desired_channels \uff1a\u6240\u9700\u7684\u56fe\u50cf\u901a\u9053\uff0c\u6211\u4eec\u4f20\u51654\uff08RGBA\uff09\u3002 \u4e00\u4ef6\u5173\u4e8eOpenGL\u7684\u91cd\u8981\u4e8b\u9879\uff0c\u7531\u4e8e\u5386\u53f2\u539f\u56e0\uff0c\u8981\u6c42\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u6bcf\u4e2a\u8f74\u7684\u50cf\u7d20\u6570\uff09\u5fc5\u987b\u662f\u4e8c\u7684\u6307\u6570\uff082, 4, 8, 16, ....\uff09\u3002\u4e00\u4e9b\u9a71\u52a8\u89e3\u9664\u4e86\u8fd9\u79cd\u9650\u5236\uff0c\u4f46\u6700\u597d\u8fd8\u662f\u4fdd\u6301\u4ee5\u514d\u51fa\u73b0\u95ee\u9898\u3002 \u4e0b\u4e00\u6b65\u662f\u5c06\u7eb9\u7406\u4e0a\u4f20\u5230\u663e\u5b58\u4e2d\u3002\u9996\u5148\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7eb9\u7406ID\uff0c\u4e0e\u8be5\u7eb9\u7406\u76f8\u5173\u7684\u64cd\u4f5c\u90fd\u8981\u4f7f\u7528\u8be5ID\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u5b83\u3002 // \u521b\u5efa\u4e00\u4e2a\u65b0\u7684OpenGL\u7eb9\u7406 int textureId = glGenTextures(); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, textureId); \u7136\u540e\u9700\u8981\u544a\u8bc9OpenGL\u5982\u4f55\u89e3\u5305RGBA\u5b57\u8282\uff0c\u7531\u4e8e\u6bcf\u4e2a\u5206\u91cf\u53ea\u6709\u4e00\u4e2a\u5b57\u8282\u5927\u5c0f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u4ee5\u4e0b\u4ee3\u7801\uff1a glPixelStorei(GL_UNPACK_ALIGNMENT, 1); \u6700\u540e\u6211\u4eec\u53ef\u4ee5\u4e0a\u4f20\u7eb9\u7406\u6570\u636e\uff1a glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, buf); glTexImage2D \u7684\u53c2\u6570\u5982\u4e0b\u6240\u793a\uff1a target : \u6307\u5b9a\u76ee\u6807\u7eb9\u7406\uff08\u7eb9\u7406\u7c7b\u578b\uff09\uff0c\u672c\u4f8b\u4e2d\u662f GL_TEXTURE_2D \u3002 level : \u6307\u5b9a\u7eb9\u7406\u7ec6\u8282\u7684\u7b49\u7ea7\u30020\u7ea7\u662f\u57fa\u672c\u56fe\u50cf\u7b49\u7ea7\uff0c\u7b2cn\u7ea7\u662f\u7b2cn\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u7684\u56fe\u50cf\uff0c\u4e4b\u540e\u518d\u8c08\u8bba\u8fd9\u4e2a\u95ee\u9898\u3002 internal format : \u6307\u5b9a\u7eb9\u7406\u4e2d\u989c\u8272\u5206\u91cf\u7684\u6570\u91cf\u3002 width : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u5bbd\u5ea6\u3002 height : \u6307\u5b9a\u7eb9\u7406\u56fe\u50cf\u7684\u9ad8\u5ea6\u3002 border : \u6b64\u503c\u5fc5\u987b\u4e3a0\u3002 format : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u683c\u5f0f\uff0c\u73b0\u5728\u4e3aRGBA\u3002 type : \u6307\u5b9a\u50cf\u7d20\u6570\u636e\u7684\u7c7b\u578b\u3002\u73b0\u5728\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65e0\u7b26\u53f7\u5b57\u8282\u3002 data : \u50a8\u5b58\u6570\u636e\u7684\u7f13\u51b2\u533a\u3002 \u5728\u4e00\u4e9b\u4ee3\u7801\u4e2d\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5728\u8c03\u7528 glTexImage2D \u65b9\u6cd5\u524d\u8bbe\u7f6e\u4e86\u4e00\u4e9b\u8fc7\u6ee4\u53c2\u6570\u3002\u8fc7\u6ee4\u662f\u6307\u5728\u7f29\u653e\u65f6\u5982\u4f55\u7ed8\u5236\u56fe\u50cf\uff0c\u4ee5\u53ca\u5982\u4f55\u63d2\u503c\u50cf\u7d20\u3002\u5982\u679c\u672a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff0c\u7eb9\u7406\u5c06\u4e0d\u4f1a\u663e\u793a\u3002\u56e0\u6b64\uff0c\u5728 glTexImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u524d\uff0c\u4f1a\u770b\u5230\u4ee5\u4e0b\u4ee3\u7801\uff1a glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u8fd9\u4e9b\u53c2\u6570\u57fa\u672c\u4e0a\u5728\u8bf4\uff0c\u5f53\u7ed8\u5236\u4e00\u4e2a\u50cf\u7d20\u65f6\uff0c\u5982\u679c\u6ca1\u6709\u76f4\u63a5\u4e00\u5bf9\u4e00\u5730\u5173\u8054\u5230\u7eb9\u7406\u5750\u6807\uff0c\u5b83\u5c06\u9009\u62e9\u6700\u8fd1\u7684\u7eb9\u7406\u5750\u6807\u70b9\u3002 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e0d\u4f1a\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u751f\u6210\u4e00\u4e2a\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u662f\u7531\u9ad8\u7ec6\u8282\u7eb9\u7406\u751f\u6210\u7684\u9010\u7ea7\u964d\u4f4e\u5206\u8fa8\u7387\u7684\u7eb9\u7406\u96c6\u5408\u3002\u5f53\u6211\u4eec\u7684\u7269\u4f53\u7f29\u653e\u65f6\uff0c\u5c31\u5c06\u81ea\u52a8\u4f7f\u7528\u4f4e\u5206\u8fa8\u7387\u7684\u56fe\u50cf\u3002 \u4e3a\u4e86\u751f\u6210\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff0c\u53ea\u9700\u8981\u7f16\u5199\u4ee5\u4e0b\u4ee3\u7801\uff08\u76ee\u524d\u6211\u4eec\u628a\u5b83\u653e\u5728 glTextImage2D \u65b9\u6cd5\u8c03\u7528\u4e4b\u540e\uff09\uff1a glGenerateMipmap(GL_TEXTURE_2D); \u6700\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u91ca\u653e\u539f\u59cb\u56fe\u50cf\u6570\u636e\u672c\u8eab\u7684\u5185\u5b58\uff1a stbi_image_free(buf); \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u5df2\u7ecf\u6210\u529f\u5730\u52a0\u8f7d\u4e86\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6b63\u5982\u6b64\u524d\u6240\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u628a\u7eb9\u7406\u5750\u6807\u4f5c\u4e3a\u53e6\u4e00\u4e2aVBO\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u4fee\u6539 Mesh \u7c7b\u4ee5\u63a5\u6536\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u800c\u4e0d\u662f\u989c\u8272\uff08\u6211\u4eec\u53ef\u4ee5\u540c\u65f6\u6709\u989c\u8272\u548c\u7eb9\u7406\uff0c\u4f46\u4e3a\u4e86\u7b80\u5316\u5b83\uff0c\u6211\u4eec\u5c06\u5220\u9664\u989c\u8272\uff09\uff0c\u6784\u9020\u51fd\u6570\u73b0\u5728\u5982\u4e0b\u6240\u793a\uff1a public Mesh(float[] positions, float[] textCoords, int[] indices, Texture texture) \u7eb9\u7406\u5750\u6807VBO\u4e0e\u989c\u8272VBO\u521b\u5efa\u7684\u65b9\u5f0f\u76f8\u540c\u3002\u552f\u4e00\u7684\u533a\u522b\u662f\u5b83\u6bcf\u4e2a\u9876\u70b9\u5c5e\u6027\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\u800c\u4e0d\u662f\u4e09\u4e2a\uff1a vboId = glGenBuffers(); vboIdList.add(vboId); textCoordsBuffer = MemoryUtil.memAllocFloat(textCoords.length); textCoordsBuffer.put(textCoords).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, textCoordsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(1); glVertexAttribPointer(1, 2, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4fee\u6539\u4e86\u7b2c\u4e8c\u4e2a\u8f93\u5165\u53c2\u6570\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u662f\u4e00\u4e2a vec2 \uff08\u4e5f\u987a\u4fbf\u66f4\u6539\u4e86\u540d\u79f0\uff09\u3002\u9876\u70b9\u7740\u8272\u5668\u5c31\u50cf\u6b64\u524d\u4e00\u6837\uff0c\u4ec5\u5c06\u7eb9\u7406\u5750\u6807\u4f20\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; out vec2 outTexCoord; uniform mat4 worldMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * worldMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u90a3\u4e9b\u7eb9\u7406\u5750\u6807\u6765\u8bbe\u7f6e\u50cf\u7d20\u989c\u8272\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5728\u5206\u6790\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u7406\u6e05\u4e00\u4e9b\u6982\u5ff5\u3002\u663e\u5361\u6709\u51e0\u4e2a\u7a7a\u95f4\u6216\u69fd\u6765\u50a8\u5b58\u7eb9\u7406\uff0c\u6bcf\u4e00\u4e2a\u7a7a\u95f4\u88ab\u79f0\u4e3a\u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\u3002\u5f53\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u6211\u4eec\u5fc5\u987b\u8bbe\u7f6e\u60f3\u7528\u7684\u7eb9\u7406\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a texture_sampler \u7684\u65b0Uniform\uff0c\u8be5Uniform\u7684\u7c7b\u578b\u662f sampler2D \uff0c\u5e76\u50a8\u5b58\u6709\u6211\u4eec\u5e0c\u671b\u4f7f\u7528\u7684\u7eb9\u7406\u5355\u5143\u7684\u503c\u3002 \u5728 main \u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u540d\u4e3a texture \u7684\u7eb9\u7406\u91c7\u6837\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u6709\u4e24\u4e2a\u53c2\u6570\uff1a\u53d6\u6837\u5668\uff08Sampler\uff09\u548c\u7eb9\u7406\u5750\u6807\uff0c\u5e76\u8fd4\u56de\u6b63\u786e\u7684\u989c\u8272\u3002\u53d6\u6837\u5668Uniform\u5141\u8bb8\u4f7f\u7528\u591a\u91cd\u7eb9\u7406\uff08Multi-texture\uff09\uff0c\u4e0d\u8fc7\u73b0\u5728\u4e0d\u662f\u8ba8\u8bba\u8fd9\u4e2a\u8bdd\u9898\u7684\u65f6\u5019\uff0c\u4f46\u662f\u6211\u4eec\u4f1a\u5728\u7a0d\u540e\u518d\u5c1d\u8bd5\u6dfb\u52a0\u3002 \u56e0\u6b64\uff0c\u5728 ShaderProgram \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u5141\u8bb8\u4e3a\u6574\u6570\u578bUniform\u8bbe\u7f6e\u503c\uff1a public void setUniform(String uniformName, int value) { glUniform1i(uniforms.get(uniformName), value); } \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684Uniform\uff1a shaderProgram.createUniform(\"texture_sampler\"); \u6b64\u5916\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5c06Uniform\u7684\u503c\u8bbe\u7f6e\u4e3a0\uff08\u6211\u4eec\u73b0\u5728\u4e0d\u4f7f\u7528\u591a\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u53ea\u4f7f\u7528\u5355\u51430\uff09\u3002 shaderProgram.setUniform(\"texture_sampler\", 0); \u6700\u597d\uff0c\u6211\u4eec\u53ea\u9700\u4fee\u6539 Mesh \u7c7b\u7684 render \u65b9\u6cd5\u5c31\u53ef\u4ee5\u4f7f\u7528\u7eb9\u7406\u3002\u5728\u65b9\u6cd5\u8d77\u59cb\u5904\uff0c\u6dfb\u52a0\u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\uff1a // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5355\u5143 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); \u6211\u4eec\u5df2\u7ecf\u5c06 texture.getId() \u6240\u83b7\u5f97\u7684\u7eb9\u7406ID\u7ed1\u5b9a\u5230\u7eb9\u7406\u5355\u51430\u4e0a\u3002 \u6211\u4eec\u521a\u521a\u4fee\u6539\u4e86\u4ee3\u7801\u6765\u652f\u6301\u7eb9\u7406\uff0c\u73b0\u5728\u9700\u8981\u4e3a\u4e09\u7ef4\u7acb\u65b9\u4f53\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\uff0c\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\u662f\u8fd9\u6837\u7684\uff1a \u5728\u6211\u4eec\u7684\u4e09\u7ef4\u6a21\u578b\u4e2d\uff0c\u5171\u6709\u516b\u4e2a\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u5b9a\u4e49\u6b63\u9762\u6bcf\u4e2a\u9876\u70b9\u7684\u7eb9\u7406\u5750\u6807\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V0 0.0, 0.0 V1 0.0, 0.5 V2 0.5, 0.5 V3 0.5, 0.0 \u7136\u540e\uff0c\u5b9a\u4e49\u9876\u9762\u7684\u7eb9\u7406\u6620\u5c04\u3002 \u9876\u70b9 \u7eb9\u7406\u5750\u6807 V4 0.0, 0.5 V5 0.5, 0.5 V0 0.0, 1.0 V3 0.5, 1.0 \u5982\u4f60\u6240\u89c1\uff0c\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u540c\u4e00\u4e2a\u9876\u70b9\uff08V0\u548cV3\uff09\u8bbe\u7f6e\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u600e\u4e48\u6837\u624d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u5462\uff1f\u89e3\u51b3\u8fd9\u4e00\u95ee\u9898\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u91cd\u590d\u4e00\u4e9b\u9876\u70b9\u5e76\u5173\u8054\u4e0d\u540c\u7684\u7eb9\u7406\u5750\u6807\u3002\u5bf9\u4e8e\u9876\u9762\uff0c\u6211\u4eec\u9700\u8981\u91cd\u590d\u56db\u4e2a\u9876\u70b9\u5e76\u4e3a\u5b83\u4eec\u5206\u914d\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u3002 \u56e0\u4e3a\u524d\u9762\u3001\u540e\u9762\u548c\u4fa7\u9762\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u9700\u8981\u91cd\u590d\u8fd9\u4e9b\u9876\u70b9\u3002\u5728\u6e90\u7801\u4e2d\u6709\u5b8c\u6574\u7684\u5b9a\u4e49\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ece8\u4e2a\u70b9\u4e0a\u5347\u523020\u4e2a\u70b9\u4e86\u3002\u6700\u7ec8\u7684\u7ed3\u679c\u5c31\u50cf\u8fd9\u6837\u3002 \u5728\u63a5\u4e0b\u6765\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u75313D\u5efa\u6a21\u5de5\u5177\u751f\u6210\u7684\u6a21\u578b\uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u624b\u52a8\u5b9a\u4e49\u9876\u70b9\u548c\u7eb9\u7406\u5750\u6807\u4e86\uff08\u987a\u4fbf\u4e00\u63d0\uff0c\u5bf9\u4e8e\u66f4\u590d\u6742\u7684\u6a21\u578b\uff0c\u624b\u52a8\u5b9a\u4e49\u662f\u4e0d\u5b58\u5728\u7684\uff09\u3002","title":"\u4e3a\u7acb\u65b9\u4f53\u6dfb\u52a0\u7eb9\u7406"},{"location":"07-textures/#_3","text":"\u5982\u4f60\u6240\u89c1\uff0c\u5f53\u52a0\u8f7d\u56fe\u50cf\u65f6\uff0c\u6211\u4eec\u68c0\u7d22\u4e86\u56db\u4e2aRGBA\u7ec4\u4ef6\uff0c\u5305\u62ec\u900f\u660e\u5ea6\u7b49\u7ea7\u3002\u4f46\u5982\u679c\u52a0\u8f7d\u4e00\u4e2a\u900f\u660e\u7684\u7eb9\u7406\uff0c\u53ef\u80fd\u770b\u4e0d\u5230\u4efb\u4f55\u4e1c\u897f\u3002\u4e3a\u4e86\u652f\u6301\u900f\u660e\u5ea6\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u4ee5\u4e0b\u4ee3\u7801\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff1a glEnable(GL_BLEND); \u4f46\u4ec5\u542f\u7528\u6df7\u5408\uff0c\u900f\u660e\u6548\u679c\u4ecd\u7136\u4e0d\u4f1a\u663e\u793a\uff0c\u6211\u4eec\u8fd8\u9700\u8981\u6307\u793aOpenGL\u5982\u4f55\u8fdb\u884c\u6df7\u5408\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glBlendFunc \u65b9\u6cd5\u5b8c\u6210\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u4f60\u53ef\u4ee5\u67e5\u770b \u6b64\u5904 \u6709\u5173\u53ef\u4f7f\u7528\u7684\u4e0d\u540c\u529f\u80fd\u7684\u8be6\u7ec6\u8bf4\u660e\u3002 \u5373\u4f7f\u542f\u7528\u4e86\u6df7\u5408\u5e76\u8bbe\u7f6e\u4e86\u529f\u80fd\uff0c\u4e5f\u53ef\u80fd\u770b\u4e0d\u5230\u6b63\u786e\u7684\u900f\u660e\u6548\u679c\u3002\u5176\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5f53\u4f7f\u7528\u6df1\u5ea6\u503c\u4e22\u5f03\u7247\u5143\u65f6\uff0c\u6211\u4eec\u53ef\u80fd\u5c06\u5177\u6709\u900f\u660e\u5ea6\u7684\u7247\u5143\u4e0e\u80cc\u666f\u6df7\u5408\uff0c\u800c\u4e0d\u662f\u4e0e\u5b83\u4eec\u540e\u9762\u7684\u7247\u5143\u6df7\u5408\uff0c\u8fd9\u5c06\u5f97\u5230\u9519\u8bef\u7684\u6e32\u67d3\u7ed3\u679c\u3002\u4e3a\u4e86\u89e3\u51b3\u8be5\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u5148\u7ed8\u5236\u4e0d\u900f\u660e\u7269\u4f53\uff0c\u7136\u540e\u6309\u6df1\u5ea6\u9012\u51cf\u987a\u5e8f\u7ed8\u5236\u5177\u6709\u900f\u660e\u5ea6\u7684\u7269\u4f53\uff08\u5e94\u5148\u7ed8\u5236\u8f83\u8fdc\u7269\u4f53\uff09\u3002","title":"\u900f\u660e\u7eb9\u7406\u7b80\u4ecb"},{"location":"08-camera/","text":"\u6444\u50cf\u673a\uff08Camera\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u7684\u4e09\u7ef4\u573a\u666f\u4e2d\u79fb\u52a8\u3002\u8be5\u529f\u80fd\u5c31\u50cf\u662f\u6709\u4e00\u53f0\u53ef\u4ee5\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\u7684\u6444\u50cf\u673a\uff0c\u7136\u800c\u4e8b\u5b9e\u4e0a\u6444\u50cf\u673a\u5c31\u662f\u63cf\u8ff0\u8be5\u529f\u80fd\u7684\u672f\u8bed\u3002 \u4f46\u5982\u679c\u4f60\u5c1d\u8bd5\u5728OpenGL\u5bfb\u627e\u6444\u50cf\u673a\u529f\u80fd\uff0c\u4f60\u4f1a\u53d1\u73b0\u6ca1\u6709\u6444\u50cf\u673a\u8fd9\u4e2a\u6982\u5ff5\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u6444\u50cf\u673a\u4e00\u76f4\u662f\u56fa\u5b9a\u5728\u5c4f\u5e55\u4e2d\u5fc3\u7684\u4ee5(0, 0, 0)\u4e3a\u4e2d\u5fc3\u70b9\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u51fa\u4e00\u4e2a\u53ef\u4ee5\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u79fb\u52a8\u7684\u6444\u50cf\u3002\u4f46\u8981\u600e\u4e48\u505a\u5462\uff1f\u6444\u50cf\u673a\u662f\u4e0d\u80fd\u79fb\u52a8\u7684\uff0c\u56e0\u6b64\u6211\u4eec\u5fc5\u987b\u8981\u79fb\u52a8\u4e16\u754c\u4e2d\u7684\u5168\u90e8\u7269\u4f53\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u79fb\u52a8\u4e0d\u4e86\u6444\u50cf\u673a\u5c31\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002 \u5047\u8bbe\u6444\u50cf\u673a\u4ece(Cx, Cy, Cz)\u6cbf\u7740Z\u8f74\u79fb\u52a8\u5230(Cx, Cy, Cz+dz)\uff0c\u4ece\u800c\u9760\u8fd1\u5728(Ox, Oy, Oz)\u653e\u7f6e\u7684\u7269\u4f53\u3002 \u6211\u4eec\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u5c06\u7269\u4f53\uff08\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u6240\u6709\u7269\u4f53\uff09\u6309\u6444\u50cf\u673a\u5e94\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u79fb\u52a8\u3002\u5176\u5b9e\u7269\u4f53\u5c31\u50cf\u662f\u653e\u5728\u8dd1\u6b65\u673a\u4e0a\u4e00\u6837\u5411\u540e\u9000\u3002 \u6444\u50cf\u673a\u53ef\u4ee5\u6cbf\u7740\u4e09\u4e2a\u8f74\uff08X\u3001Y\u548cZ\uff09\u79fb\u52a8\uff0c\u4e5f\u53ef\u4ee5\u7ed5\u7740\u5b83\u4eec\u65cb\u8f6c\uff08\u7ffb\u6eda\uff08Roll\uff09\u3001\u4fef\u4ef0\uff08Pitch\uff09\u548c\u504f\u822a\uff08Yaw\uff09\uff09\u3002 \u57fa\u672c\u4e0a\u8981\u505a\u7684\u5c31\u662f\u8ba9\u79fb\u52a8\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u4e09\u7ef4\u4e16\u754c\u5168\u90e8\u7269\u4f53\u3002\u90a3\u8981\u600e\u4e48\u505a\u5462\uff1f\u7b54\u6848\u662f\u5e94\u7528\u53e6\u4e00\u79cd\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u5c06\u6240\u6709\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u6309\u6444\u50cf\u673a\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u5e73\u79fb\uff0c\u518d\u6839\u636e\u6444\u50cf\u673a\u7684\u65cb\u8f6c\u6765\u65cb\u8f6c\u5b83\u4eec\u3002\u5f53\u7136\uff0c\u8fd9\u5c06\u7528\u5230\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6240\u8c13\u7684\u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\u6765\u5b8c\u6210\u3002\u8fd9\u4e2a\u77e9\u9635\u9996\u5148\u8fdb\u884c\u5e73\u79fb\uff0c\u7136\u540e\u6cbf\u7740\u8f74\u7ebf\u8fdb\u884c\u65cb\u8f6c\u3002 \u6765\u770b\u770b\u5982\u4f55\u6784\u9020\u8fd9\u4e2a\u77e9\u9635\u3002\u5982\u679c\u4f60\u60f3\u8d77\u53d8\u6362\u4e00\u7ae0\uff08\u7b2c6\u7ae0\uff09\uff0c\u5176\u4e2d\u7684\u53d8\u6362\u65b9\u7a0b\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u89c2\u5bdf\u77e9\u9635\u5e94\u5728\u5e94\u7528\u6295\u5f71\u77e9\u9635\u4e4b\u524d\u5e94\u7528\uff0c\u56e0\u6b64\u6211\u4eec\u7684\u65b9\u7a0b\u5e94\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u73b0\u5728\u6709\u4e09\u4e2a\u77e9\u9635\u4e86\uff0c\u6211\u4eec\u5e94\u7a0d\u5fae\u601d\u8003\u4e00\u4e0b\u8fd9\u4e9b\u77e9\u9635\u7684\u751f\u547d\u5468\u671f\u3002\u5728\u6e38\u620f\u8fd0\u884c\u65f6\uff0c\u6295\u5f71\u77e9\u9635\u5e94\u8be5\u4e0d\u4f1a\u6709\u592a\u591a\u7684\u53d8\u5316\uff0c\u6700\u574f\u7684\u60c5\u51b5\u4e0b\uff0c\u6bcf\u6b21\u6e32\u67d3\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u5982\u679c\u6444\u50cf\u673a\u79fb\u52a8\uff0c\u5219\u89c2\u5bdf\u77e9\u9635\u5728\u6bcf\u6b21\u6e32\u67d3\u65f6\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u6bcf\u6e32\u67d3\u4e00\u4e2a GameItem \u5b9e\u4f8b\u4e16\u754c\u77e9\u9635\u90fd\u4f1a\u6539\u53d8\u4e00\u6b21\uff0c\u4e00\u6b21\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u90fd\u4f1a\u6539\u53d8\u591a\u6b21\u3002 \u56e0\u6b64\u6211\u4eec\u5e94\u8be5\u5c06\u591a\u5c11\u77e9\u9635\u4f20\u9012\u5230\u9876\u70b9\u7740\u8272\u5668\u5462\uff1f\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e9b\u4ee3\u7801\uff0c\u4e3a\u4e09\u4e2a\u77e9\u9635\u5206\u522b\u5b9a\u4e49\u4e00\u4e2aUniform\uff0c\u4f46\u7406\u8bba\u4e0a\u6700\u6709\u6548\u7684\u65b9\u6cd5\u662f\u5c06\u6295\u5f71\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u7ec4\u5408\uff0c\u5c06\u5176\u79f0\u4e3a pv \u77e9\u9635\uff0c\u5e76\u4f20\u9012 world \u548c pv \u77e9\u9635\u5230\u7740\u8272\u5668\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u5e76\u53ef\u4ee5\u907f\u514d\u4e00\u4e9b\u989d\u5916\u7684\u8fd0\u7b97\u3002 \u4f46\u5b9e\u9645\u4e0a\uff0c\u6700\u65b9\u4fbf\u7684\u65b9\u6cd5\u662f\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u3002\u4e3a\u4ec0\u4e48\u8fd9\u6837\uff1f\u56e0\u4e3a\u8981\u8bb0\u4f4f\u6574\u4e2a\u6444\u50cf\u673a\u6982\u5ff5\u5c31\u662f\u4e2a\u9a97\u5c40\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u6765\u6a21\u62df\u6444\u50cf\u673a\u7684\u4f4d\u79fb\uff0c\u5e76\u4ec5\u663e\u793a\u4e00\u5c0f\u90e8\u5206\u7684\u4e09\u7ef4\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5904\u7406\u4e16\u754c\u5750\u6807\uff0c\u53ef\u80fd\u4f1a\u8ba9\u8fdc\u79bb\u539f\u70b9\u7684\u4e16\u754c\u5750\u6807\u9047\u5230\u4e00\u4e9b\u7cbe\u5ea6\u95ee\u9898\u3002\u5982\u679c\u5728\u6240\u8c13\u7684\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u5904\u7406\uff0c\u6211\u4eec\u5c06\u5904\u7406\u7684\u70b9\u867d\u7136\u8fdc\u79bb\u4e16\u754c\u539f\u70b9\uff0c\u4f46\u4e5f\u9760\u8fd1\u6444\u50cf\u673a\u3002\u53ef\u4ee5\u5c06\u89c2\u5bdf\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u7684\u77e9\u9635\u79f0\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u4ee5\u652f\u6301\u6444\u50cf\u673a\u5427\u3002\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Camera \u7684\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u72b6\u6001\u3002\u8be5\u7c7b\u5c06\u63d0\u4f9b\u8bbe\u7f6e\u4f4d\u7f6e\u6216\u65cb\u8f6c\u72b6\u6001\u7684\u65b9\u6cd5\uff08 setPosition \u6216 setRotation \uff09\uff0c\u6216\u5728\u5f53\u524d\u72b6\u6001\u4e0b\u7528\u504f\u79fb\u91cf\u66f4\u65b0\u8fd9\u4e9b\u503c\u7684\u65b9\u6cd5\uff08 movePosition \u6216 moveRotation \uff09\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class Camera { private final Vector3f position; private final Vector3f rotation; public Camera() { position = new Vector3f(0, 0, 0); rotation = new Vector3f(0, 0, 0); } public Camera(Vector3f position, Vector3f rotation) { this.position = position; this.rotation = rotation; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { position.x = x; position.y = y; position.z = z; } public void movePosition(float offsetX, float offsetY, float offsetZ) { if ( offsetZ != 0 ) { position.x += (float)Math.sin(Math.toRadians(rotation.y)) * -1.0f * offsetZ; position.z += (float)Math.cos(Math.toRadians(rotation.y)) * offsetZ; } if ( offsetX != 0) { position.x += (float)Math.sin(Math.toRadians(rotation.y - 90)) * -1.0f * offsetX; position.z += (float)Math.cos(Math.toRadians(rotation.y - 90)) * offsetX; } position.y += offsetY; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { rotation.x = x; rotation.y = y; rotation.z = z; } public void moveRotation(float offsetX, float offsetY, float offsetZ) { rotation.x += offsetX; rotation.y += offsetY; rotation.z += offsetZ; } } \u63a5\u4e0b\u6765\u5728 Transformation \u4e2d\uff0c\u5c06\u5b9a\u4e49\u4e00\u4e2a\u65b0\u77e9\u9635\u6765\u50a8\u5b58\u89c2\u5bdf\u77e9\u9635\u3002 private final Matrix4f viewMatrix; \u6211\u4eec\u8981\u63d0\u4f9b\u4e00\u4e2a\u66f4\u65b0\u8fd9\u4e2a\u503c\u7684\u65b9\u6cd5\u3002\u4e0e\u6295\u5f71\u77e9\u9635\u76f8\u4f3c\uff0c\u8fd9\u4e2a\u77e9\u9635\u5bf9\u4e8e\u6e32\u67d3\u5468\u671f\u4e2d\u6e32\u67d3\u7684\u6240\u6709\u7269\u4f53\u90fd\u662f\u76f8\u540c\u7684\u3002 public Matrix4f getViewMatrix(Camera camera) { Vector3f cameraPos = camera.getPosition(); Vector3f rotation = camera.getRotation(); viewMatrix.identity(); // \u9996\u5148\u8fdb\u884c\u65cb\u8f6c\uff0c\u4f7f\u6444\u50cf\u673a\u5728\u5176\u4f4d\u7f6e\u4e0a\u65cb\u8f6c viewMatrix.rotate((float)Math.toRadians(rotation.x), new Vector3f(1, 0, 0)) .rotate((float)Math.toRadians(rotation.y), new Vector3f(0, 1, 0)); // \u7136\u540e\u505a\u4f4d\u79fb viewMatrix.translate(-cameraPos.x, -cameraPos.y, -cameraPos.z); return viewMatrix; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u65cb\u8f6c\uff0c\u7136\u540e\u4f4d\u79fb\u3002\u5982\u679c\u64cd\u4f5c\u987a\u5e8f\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u4e0d\u4f1a\u6cbf\u7740\u6444\u50cf\u673a\u4f4d\u7f6e\u65cb\u8f6c\uff0c\u800c\u662f\u6cbf\u7740\u5750\u6807\u539f\u70b9\u65cb\u8f6c\u3002\u8bf7\u6ce8\u610f\uff0c\u5728 Camera \u7c7b\u7684 movePosition \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u53ea\u662f\u7b80\u5355\u5730\u589e\u52a0\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u504f\u79fb\u91cf\u3002\u6211\u4eec\u8fd8\u8003\u8651\u4e86\u6cbfY\u8f74\u7684\u65cb\u8f6c\uff0c\u4e5f\u5c31\u662f\u504f\u822a\uff0c\u4ee5\u4fbf\u8ba1\u7b97\u6700\u7ec8\u4f4d\u7f6e\u3002\u5982\u679c\u53ea\u662f\u901a\u8fc7\u504f\u79fb\u6765\u589e\u52a0\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u6444\u50cf\u673a\u5c31\u4e0d\u4f1a\u671d\u7740\u5b83\u6240\u671d\u5411\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u9664\u4e86\u4e0a\u8ff0\u6240\u8bf4\u7684\uff0c\u6211\u4eec\u73b0\u5728\u8fd8\u6ca1\u6709\u5f97\u5230\u4e00\u4e2a\u53ef\u4ee5\u5b8c\u5168\u81ea\u7531\u79fb\u52a8\u7684\u6444\u50cf\u673a\uff08\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u6cbf\u7740X\u8f74\u65cb\u8f6c\uff0c\u5f53\u5411\u524d\u79fb\u52a8\u65f6\uff0c\u6444\u50cf\u673a\u4e0d\u4f1a\u5728\u7a7a\u95f4\u4e2d\u5411\u4e0a\u6216\u5411\u4e0b\u79fb\u52a8\uff09\uff0c\u8fd9\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u8fd9\u6709\u70b9\u590d\u6742\u3002 \u6700\u540e\uff0c\u6211\u4eec\u5c06\u79fb\u9664\u4e4b\u524d\u7684 getWorldMatrix \u65b9\u6cd5\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e2a\u540d\u4e3a getModelViewMatrix \u7684\u65b0\u65b9\u6cd5\u3002 public Matrix4f getModelViewMatrix(GameItem gameItem, Matrix4f viewMatrix) { Vector3f rotation = gameItem.getRotation(); modelViewMatrix.set(viewMatrix).translate(gameItem.getPosition()). rotateX((float)Math.toRadians(-rotation.x)). rotateY((float)Math.toRadians(-rotation.y)). rotateZ((float)Math.toRadians(-rotation.z)). scale(gameItem.getScale()); return modelViewMatrix; } \u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u5c06\u8c03\u7528\u4e00\u6b21 getModelViewMatrix \u65b9\u6cd5\u3002 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u6444\u50cf\u673a\u7684\u503c\uff0c\u5728\u6295\u5f71\u77e9\u9635\u66f4\u65b0\u4e4b\u540e\u66f4\u65b0\u89c2\u5bdf\u77e9\u9635\u3002 // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 Matrix4f viewMatrix = transformation.getViewMatrix(camera); shaderProgram.setUniform(\"texture_sampler\", 0); // \u6e32\u67d3\u6bcf\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u6e32\u67d3\u8be5\u6e38\u620f\u9879\u7684\u7f51\u683c gameItem.getMesh().render(); } \u8fd9\u5c31\u662f\u5b9e\u73b0\u6444\u50cf\u673a\u6982\u5ff5\u7684\u57fa\u672c\u4ee3\u7801\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u53ef\u4ee5\u4fee\u6539\u8f93\u5165\u5904\u7406\u548c\u66f4\u65b0\u6444\u50cf\u673a\u7684\u65b9\u5f0f\uff0c\u5c06\u8bbe\u7f6e\u5982\u4e0b\u6309\u952e\uff1a \u201cA\u201d\u548c\u201cD\u201d\u952e\u4f7f\u6444\u50cf\u673a\u5de6\u53f3\uff08X\u8f74\uff09\u79fb\u52a8\u3002 \u201cW\u201d\u548c\u201cS\u201d\u952e\u4f7f\u6444\u50cf\u673a\u524d\u540e\uff08Z\u8f74\uff09\u79fb\u52a8\u3002 \u201cZ\u201d\u548c\u201cX\u201d\u952e\u4f7f\u6444\u50cf\u673a\u4e0a\u4e0b\uff08Y\u8f74\uff09\u79fb\u52a8\u3002 \u5f53\u9f20\u6807\u6309\u4e0b\u53f3\u952e\u65f6\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9f20\u6807\u4f4d\u7f6e\u6cbfX\u548cY\u8f74\u65cb\u8f6c\u6444\u50cf\u673a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u5c06\u9996\u6b21\u4f7f\u7528\u9f20\u6807\uff0c\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MouseInput \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u5c01\u88c5\u9f20\u6807\u8bbf\u95ee\u3002\u8be5\u7c7b\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine; import org.joml.Vector2d; import org.joml.Vector2f; import static org.lwjgl.glfw.GLFW.*; public class MouseInput { private final Vector2d previousPos; private final Vector2d currentPos; private final Vector2f displVec; private boolean inWindow = false; private boolean leftButtonPressed = false; private boolean rightButtonPressed = false; public MouseInput() { previousPos = new Vector2d(-1, -1); currentPos = new Vector2d(0, 0); displVec = new Vector2f(); } public void init(Window window) { glfwSetCursorPosCallback(window.getWindowHandle(), (windowHandle, xpos, ypos) -> { currentPos.x = xpos; currentPos.y = ypos; }); glfwSetCursorEnterCallback(window.getWindowHandle(), (windowHandle, entered) -> { inWindow = entered; }); glfwSetMouseButtonCallback(window.getWindowHandle(), (windowHandle, button, action, mode) -> { leftButtonPressed = button == GLFW_MOUSE_BUTTON_1 && action == GLFW_PRESS; rightButtonPressed = button == GLFW_MOUSE_BUTTON_2 && action == GLFW_PRESS; }); } public Vector2f getDisplVec() { return displVec; } public void input(Window window) { displVec.x = 0; displVec.y = 0; if (previousPos.x > 0 && previousPos.y > 0 && inWindow) { double deltax = currentPos.x - previousPos.x; double deltay = currentPos.y - previousPos.y; boolean rotateX = deltax != 0; boolean rotateY = deltay != 0; if (rotateX) { displVec.y = (float) deltax; } if (rotateY) { displVec.x = (float) deltay; } } previousPos.x = currentPos.x; previousPos.y = currentPos.y; } public boolean isLeftButtonPressed() { return leftButtonPressed; } public boolean isRightButtonPressed() { return rightButtonPressed; } } MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5e94\u5728\u5728\u521d\u59cb\u5316\u9636\u6bb5\u8c03\u7528\u7684 init \u65b9\u6cd5\uff0c\u5e76\u6ce8\u518c\u4e00\u7ec4\u56de\u8c03\u4ee5\u5904\u7406\u9f20\u6807\u4e8b\u4ef6\uff1a glfwSetCursorPosCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u79fb\u52a8\u65f6\u88ab\u8c03\u7528\u3002 glfwSetCursorEnterCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u65f6\u88ab\u8c03\u7528\u3002\u5373\u4f7f\u9f20\u6807\u4e0d\u5728\u7a97\u53e3\u5185\uff0c\u6211\u4eec\u4e5f\u4f1a\u6536\u5230\u9f20\u6807\u4e8b\u4ef6\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e2a\u56de\u8c03\u6765\u786e\u8ba4\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u3002 glfwSetMouseButtonCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5728\u6309\u4e0b\u9f20\u6807\u6309\u94ae\u65f6\u88ab\u8c03\u7528\u3002 MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a input \u65b9\u6cd5\uff0c\u5728\u5904\u7406\u6e38\u620f\u8f93\u5165\u65f6\u5e94\u8c03\u7528\u8be5\u65b9\u6cd5\u3002\u8be5\u65b9\u6cd5\u8ba1\u7b97\u9f20\u6807\u4ece\u4e0a\u4e00\u4e2a\u4f4d\u7f6e\u7684\u4f4d\u79fb\uff0c\u5e76\u5c06\u5176\u5b58\u50a8\u5230 Vector2f \u7c7b\u578b\u7684 displVec \u53d8\u91cf\u4e2d\uff0c\u4ee5\u4fbf\u6e38\u620f\u4f7f\u7528\u5b83\u3002 MouseInput \u7c7b\u5c06\u5728 GameEngine \u7c7b\u4e2d\u5b9e\u4f8b\u5316\uff0c\u5e76\u4e14\u5c06\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7ed9\u6e38\u620f\u5b9e\u73b0\u7684 init \u548c update \u65b9\u6cd5\uff08\u56e0\u6b64\u9700\u8981\u76f8\u5e94\u5730\u66f4\u6539 IGameLogic \u63a5\u53e3\uff09\u3002 void input(Window window, MouseInput mouseInput); void update(float interval, MouseInput mouseInput); \u9f20\u6807\u8f93\u5165\u5c06\u5728 GameEngine \u7c7b\u7684 input \u65b9\u6cd5\u4e2d\u88ab\u5904\u7406\uff0c\u800c\u6700\u7ec8\u7684\u63a7\u5236\u5c06\u4ea4\u7531\u6e38\u620f\u5b9e\u73b0\u3002 protected void input() { mouseInput.input(window); gameLogic.input(window, mouseInput); } \u73b0\u5728\u5df2\u7ecf\u51c6\u5907\u597d\u4fee\u6539 DummyGame \u7c7b\u6765\u5904\u7406\u952e\u76d8\u548c\u9f20\u6807\u8f93\u5165\u4e86\u3002\u8be5\u7c7b\u7684\u8f93\u5165\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a @Override public void input(Window window, MouseInput mouseInput) { cameraInc.set(0, 0, 0); if (window.isKeyPressed(GLFW_KEY_W)) { cameraInc.z = -1; } else if (window.isKeyPressed(GLFW_KEY_S)) { cameraInc.z = 1; } if (window.isKeyPressed(GLFW_KEY_A)) { cameraInc.x = -1; } else if (window.isKeyPressed(GLFW_KEY_D)) { cameraInc.x = 1; } if (window.isKeyPressed(GLFW_KEY_Z)) { cameraInc.y = -1; } else if (window.isKeyPressed(GLFW_KEY_X)) { cameraInc.y = 1; } } \u8fd9\u53ea\u662f\u66f4\u65b0\u4e00\u4e2a\u540d\u4e3a cameraInc \u7684 Vector3f \u53d8\u91cf\uff0c\u5b83\u50a8\u5b58\u4e86\u6444\u50cf\u673a\u5e94\u7528\u7684\u4f4d\u79fb\u3002 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u5c06\u6839\u636e\u5904\u7406\u7684\u952e\u76d8\u548c\u9f20\u6807\u4e8b\u4ef6\uff0c\u4fee\u6539\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u3002 @Override public void update(float interval, MouseInput mouseInput) { // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u57fa\u4e8e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); } } \u73b0\u5728\u53ef\u4ee5\u6dfb\u52a0\u66f4\u591a\u7684\u7acb\u65b9\u4f53\u5230\u4e16\u754c\u4e2d\uff0c\u7f29\u653e\u5b83\u4eec\uff0c\u5c06\u5b83\u4eec\u8bbe\u7f6e\u5728\u7279\u5b9a\u4f4d\u7f6e\uff0c\u5e76\u4f7f\u7528\u65b0\u6444\u50cf\u673a\u6e38\u73a9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6240\u6709\u7684\u7acb\u65b9\u4f53\u5171\u4eab\u76f8\u540c\u7684\u7f51\u683c\u3002 GameItem gameItem1 = new GameItem(mesh); gameItem1.setScale(0.5f); gameItem1.setPosition(0, 0, -2); GameItem gameItem2 = new GameItem(mesh); gameItem2.setScale(0.5f); gameItem2.setPosition(0.5f, 0.5f, -2); GameItem gameItem3 = new GameItem(mesh); gameItem3.setScale(0.5f); gameItem3.setPosition(0, 0, -2.5f); GameItem gameItem4 = new GameItem(mesh); gameItem4.setScale(0.5f); gameItem4.setPosition(0.5f, 0, -2.5f); gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4}; \u4f60\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\u3002","title":"\u6444\u50cf\u673a"},{"location":"08-camera/#camera","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e32\u67d3\u7684\u4e09\u7ef4\u573a\u666f\u4e2d\u79fb\u52a8\u3002\u8be5\u529f\u80fd\u5c31\u50cf\u662f\u6709\u4e00\u53f0\u53ef\u4ee5\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\u7684\u6444\u50cf\u673a\uff0c\u7136\u800c\u4e8b\u5b9e\u4e0a\u6444\u50cf\u673a\u5c31\u662f\u63cf\u8ff0\u8be5\u529f\u80fd\u7684\u672f\u8bed\u3002 \u4f46\u5982\u679c\u4f60\u5c1d\u8bd5\u5728OpenGL\u5bfb\u627e\u6444\u50cf\u673a\u529f\u80fd\uff0c\u4f60\u4f1a\u53d1\u73b0\u6ca1\u6709\u6444\u50cf\u673a\u8fd9\u4e2a\u6982\u5ff5\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u6444\u50cf\u673a\u4e00\u76f4\u662f\u56fa\u5b9a\u5728\u5c4f\u5e55\u4e2d\u5fc3\u7684\u4ee5(0, 0, 0)\u4e3a\u4e2d\u5fc3\u70b9\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u51fa\u4e00\u4e2a\u53ef\u4ee5\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u79fb\u52a8\u7684\u6444\u50cf\u3002\u4f46\u8981\u600e\u4e48\u505a\u5462\uff1f\u6444\u50cf\u673a\u662f\u4e0d\u80fd\u79fb\u52a8\u7684\uff0c\u56e0\u6b64\u6211\u4eec\u5fc5\u987b\u8981\u79fb\u52a8\u4e16\u754c\u4e2d\u7684\u5168\u90e8\u7269\u4f53\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5982\u679c\u79fb\u52a8\u4e0d\u4e86\u6444\u50cf\u673a\u5c31\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002 \u5047\u8bbe\u6444\u50cf\u673a\u4ece(Cx, Cy, Cz)\u6cbf\u7740Z\u8f74\u79fb\u52a8\u5230(Cx, Cy, Cz+dz)\uff0c\u4ece\u800c\u9760\u8fd1\u5728(Ox, Oy, Oz)\u653e\u7f6e\u7684\u7269\u4f53\u3002 \u6211\u4eec\u5b9e\u9645\u4e0a\u505a\u7684\u662f\u5c06\u7269\u4f53\uff08\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u6240\u6709\u7269\u4f53\uff09\u6309\u6444\u50cf\u673a\u5e94\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u79fb\u52a8\u3002\u5176\u5b9e\u7269\u4f53\u5c31\u50cf\u662f\u653e\u5728\u8dd1\u6b65\u673a\u4e0a\u4e00\u6837\u5411\u540e\u9000\u3002 \u6444\u50cf\u673a\u53ef\u4ee5\u6cbf\u7740\u4e09\u4e2a\u8f74\uff08X\u3001Y\u548cZ\uff09\u79fb\u52a8\uff0c\u4e5f\u53ef\u4ee5\u7ed5\u7740\u5b83\u4eec\u65cb\u8f6c\uff08\u7ffb\u6eda\uff08Roll\uff09\u3001\u4fef\u4ef0\uff08Pitch\uff09\u548c\u504f\u822a\uff08Yaw\uff09\uff09\u3002 \u57fa\u672c\u4e0a\u8981\u505a\u7684\u5c31\u662f\u8ba9\u79fb\u52a8\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u4e09\u7ef4\u4e16\u754c\u5168\u90e8\u7269\u4f53\u3002\u90a3\u8981\u600e\u4e48\u505a\u5462\uff1f\u7b54\u6848\u662f\u5e94\u7528\u53e6\u4e00\u79cd\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u5c06\u6240\u6709\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u6309\u6444\u50cf\u673a\u79fb\u52a8\u7684\u76f8\u53cd\u65b9\u5411\u5e73\u79fb\uff0c\u518d\u6839\u636e\u6444\u50cf\u673a\u7684\u65cb\u8f6c\u6765\u65cb\u8f6c\u5b83\u4eec\u3002\u5f53\u7136\uff0c\u8fd9\u5c06\u7528\u5230\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6240\u8c13\u7684\u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\u6765\u5b8c\u6210\u3002\u8fd9\u4e2a\u77e9\u9635\u9996\u5148\u8fdb\u884c\u5e73\u79fb\uff0c\u7136\u540e\u6cbf\u7740\u8f74\u7ebf\u8fdb\u884c\u65cb\u8f6c\u3002 \u6765\u770b\u770b\u5982\u4f55\u6784\u9020\u8fd9\u4e2a\u77e9\u9635\u3002\u5982\u679c\u4f60\u60f3\u8d77\u53d8\u6362\u4e00\u7ae0\uff08\u7b2c6\u7ae0\uff09\uff0c\u5176\u4e2d\u7684\u53d8\u6362\u65b9\u7a0b\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u89c2\u5bdf\u77e9\u9635\u5e94\u5728\u5e94\u7528\u6295\u5f71\u77e9\u9635\u4e4b\u524d\u5e94\u7528\uff0c\u56e0\u6b64\u6211\u4eec\u7684\u65b9\u7a0b\u5e94\u5982\u4e0b\u6240\u793a\uff1a \\begin{array}{lcl} Transf & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4f4d\u79fb\u77e9\u9635 \\rbrack \\cdot \\lbrack \u65cb\u8f6c\u77e9\u9635 \\rbrack \\cdot \\lbrack \u7f29\u653e\u77e9\u9635 \\rbrack \\\\ & = & \\lbrack \u6295\u5f71\u77e9\u9635 \\rbrack \\cdot \\lbrack \u89c2\u5bdf\u77e9\u9635 \\rbrack \\cdot \\lbrack \u4e16\u754c\u77e9\u9635 \\rbrack \\end{array} \u73b0\u5728\u6709\u4e09\u4e2a\u77e9\u9635\u4e86\uff0c\u6211\u4eec\u5e94\u7a0d\u5fae\u601d\u8003\u4e00\u4e0b\u8fd9\u4e9b\u77e9\u9635\u7684\u751f\u547d\u5468\u671f\u3002\u5728\u6e38\u620f\u8fd0\u884c\u65f6\uff0c\u6295\u5f71\u77e9\u9635\u5e94\u8be5\u4e0d\u4f1a\u6709\u592a\u591a\u7684\u53d8\u5316\uff0c\u6700\u574f\u7684\u60c5\u51b5\u4e0b\uff0c\u6bcf\u6b21\u6e32\u67d3\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u5982\u679c\u6444\u50cf\u673a\u79fb\u52a8\uff0c\u5219\u89c2\u5bdf\u77e9\u9635\u5728\u6bcf\u6b21\u6e32\u67d3\u65f6\u53ef\u80fd\u6539\u53d8\u4e00\u6b21\u3002\u6bcf\u6e32\u67d3\u4e00\u4e2a GameItem \u5b9e\u4f8b\u4e16\u754c\u77e9\u9635\u90fd\u4f1a\u6539\u53d8\u4e00\u6b21\uff0c\u4e00\u6b21\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u90fd\u4f1a\u6539\u53d8\u591a\u6b21\u3002 \u56e0\u6b64\u6211\u4eec\u5e94\u8be5\u5c06\u591a\u5c11\u77e9\u9635\u4f20\u9012\u5230\u9876\u70b9\u7740\u8272\u5668\u5462\uff1f\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e9b\u4ee3\u7801\uff0c\u4e3a\u4e09\u4e2a\u77e9\u9635\u5206\u522b\u5b9a\u4e49\u4e00\u4e2aUniform\uff0c\u4f46\u7406\u8bba\u4e0a\u6700\u6709\u6548\u7684\u65b9\u6cd5\u662f\u5c06\u6295\u5f71\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u7ec4\u5408\uff0c\u5c06\u5176\u79f0\u4e3a pv \u77e9\u9635\uff0c\u5e76\u4f20\u9012 world \u548c pv \u77e9\u9635\u5230\u7740\u8272\u5668\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e16\u754c\u5750\u6807\uff0c\u5e76\u53ef\u4ee5\u907f\u514d\u4e00\u4e9b\u989d\u5916\u7684\u8fd0\u7b97\u3002 \u4f46\u5b9e\u9645\u4e0a\uff0c\u6700\u65b9\u4fbf\u7684\u65b9\u6cd5\u662f\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u3002\u4e3a\u4ec0\u4e48\u8fd9\u6837\uff1f\u56e0\u4e3a\u8981\u8bb0\u4f4f\u6574\u4e2a\u6444\u50cf\u673a\u6982\u5ff5\u5c31\u662f\u4e2a\u9a97\u5c40\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u6765\u6a21\u62df\u6444\u50cf\u673a\u7684\u4f4d\u79fb\uff0c\u5e76\u4ec5\u663e\u793a\u4e00\u5c0f\u90e8\u5206\u7684\u4e09\u7ef4\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5904\u7406\u4e16\u754c\u5750\u6807\uff0c\u53ef\u80fd\u4f1a\u8ba9\u8fdc\u79bb\u539f\u70b9\u7684\u4e16\u754c\u5750\u6807\u9047\u5230\u4e00\u4e9b\u7cbe\u5ea6\u95ee\u9898\u3002\u5982\u679c\u5728\u6240\u8c13\u7684\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u5904\u7406\uff0c\u6211\u4eec\u5c06\u5904\u7406\u7684\u70b9\u867d\u7136\u8fdc\u79bb\u4e16\u754c\u539f\u70b9\uff0c\u4f46\u4e5f\u9760\u8fd1\u6444\u50cf\u673a\u3002\u53ef\u4ee5\u5c06\u89c2\u5bdf\u77e9\u9635\u548c\u4e16\u754c\u77e9\u9635\u7ec4\u5408\u7684\u77e9\u9635\u79f0\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u4ee5\u652f\u6301\u6444\u50cf\u673a\u5427\u3002\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Camera \u7684\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u72b6\u6001\u3002\u8be5\u7c7b\u5c06\u63d0\u4f9b\u8bbe\u7f6e\u4f4d\u7f6e\u6216\u65cb\u8f6c\u72b6\u6001\u7684\u65b9\u6cd5\uff08 setPosition \u6216 setRotation \uff09\uff0c\u6216\u5728\u5f53\u524d\u72b6\u6001\u4e0b\u7528\u504f\u79fb\u91cf\u66f4\u65b0\u8fd9\u4e9b\u503c\u7684\u65b9\u6cd5\uff08 movePosition \u6216 moveRotation \uff09\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class Camera { private final Vector3f position; private final Vector3f rotation; public Camera() { position = new Vector3f(0, 0, 0); rotation = new Vector3f(0, 0, 0); } public Camera(Vector3f position, Vector3f rotation) { this.position = position; this.rotation = rotation; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { position.x = x; position.y = y; position.z = z; } public void movePosition(float offsetX, float offsetY, float offsetZ) { if ( offsetZ != 0 ) { position.x += (float)Math.sin(Math.toRadians(rotation.y)) * -1.0f * offsetZ; position.z += (float)Math.cos(Math.toRadians(rotation.y)) * offsetZ; } if ( offsetX != 0) { position.x += (float)Math.sin(Math.toRadians(rotation.y - 90)) * -1.0f * offsetX; position.z += (float)Math.cos(Math.toRadians(rotation.y - 90)) * offsetX; } position.y += offsetY; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { rotation.x = x; rotation.y = y; rotation.z = z; } public void moveRotation(float offsetX, float offsetY, float offsetZ) { rotation.x += offsetX; rotation.y += offsetY; rotation.z += offsetZ; } } \u63a5\u4e0b\u6765\u5728 Transformation \u4e2d\uff0c\u5c06\u5b9a\u4e49\u4e00\u4e2a\u65b0\u77e9\u9635\u6765\u50a8\u5b58\u89c2\u5bdf\u77e9\u9635\u3002 private final Matrix4f viewMatrix; \u6211\u4eec\u8981\u63d0\u4f9b\u4e00\u4e2a\u66f4\u65b0\u8fd9\u4e2a\u503c\u7684\u65b9\u6cd5\u3002\u4e0e\u6295\u5f71\u77e9\u9635\u76f8\u4f3c\uff0c\u8fd9\u4e2a\u77e9\u9635\u5bf9\u4e8e\u6e32\u67d3\u5468\u671f\u4e2d\u6e32\u67d3\u7684\u6240\u6709\u7269\u4f53\u90fd\u662f\u76f8\u540c\u7684\u3002 public Matrix4f getViewMatrix(Camera camera) { Vector3f cameraPos = camera.getPosition(); Vector3f rotation = camera.getRotation(); viewMatrix.identity(); // \u9996\u5148\u8fdb\u884c\u65cb\u8f6c\uff0c\u4f7f\u6444\u50cf\u673a\u5728\u5176\u4f4d\u7f6e\u4e0a\u65cb\u8f6c viewMatrix.rotate((float)Math.toRadians(rotation.x), new Vector3f(1, 0, 0)) .rotate((float)Math.toRadians(rotation.y), new Vector3f(0, 1, 0)); // \u7136\u540e\u505a\u4f4d\u79fb viewMatrix.translate(-cameraPos.x, -cameraPos.y, -cameraPos.z); return viewMatrix; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u65cb\u8f6c\uff0c\u7136\u540e\u4f4d\u79fb\u3002\u5982\u679c\u64cd\u4f5c\u987a\u5e8f\u76f8\u53cd\uff0c\u6211\u4eec\u5c06\u4e0d\u4f1a\u6cbf\u7740\u6444\u50cf\u673a\u4f4d\u7f6e\u65cb\u8f6c\uff0c\u800c\u662f\u6cbf\u7740\u5750\u6807\u539f\u70b9\u65cb\u8f6c\u3002\u8bf7\u6ce8\u610f\uff0c\u5728 Camera \u7c7b\u7684 movePosition \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u53ea\u662f\u7b80\u5355\u5730\u589e\u52a0\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u504f\u79fb\u91cf\u3002\u6211\u4eec\u8fd8\u8003\u8651\u4e86\u6cbfY\u8f74\u7684\u65cb\u8f6c\uff0c\u4e5f\u5c31\u662f\u504f\u822a\uff0c\u4ee5\u4fbf\u8ba1\u7b97\u6700\u7ec8\u4f4d\u7f6e\u3002\u5982\u679c\u53ea\u662f\u901a\u8fc7\u504f\u79fb\u6765\u589e\u52a0\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u6444\u50cf\u673a\u5c31\u4e0d\u4f1a\u671d\u7740\u5b83\u6240\u671d\u5411\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u9664\u4e86\u4e0a\u8ff0\u6240\u8bf4\u7684\uff0c\u6211\u4eec\u73b0\u5728\u8fd8\u6ca1\u6709\u5f97\u5230\u4e00\u4e2a\u53ef\u4ee5\u5b8c\u5168\u81ea\u7531\u79fb\u52a8\u7684\u6444\u50cf\u673a\uff08\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u6cbf\u7740X\u8f74\u65cb\u8f6c\uff0c\u5f53\u5411\u524d\u79fb\u52a8\u65f6\uff0c\u6444\u50cf\u673a\u4e0d\u4f1a\u5728\u7a7a\u95f4\u4e2d\u5411\u4e0a\u6216\u5411\u4e0b\u79fb\u52a8\uff09\uff0c\u8fd9\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u8fd9\u6709\u70b9\u590d\u6742\u3002 \u6700\u540e\uff0c\u6211\u4eec\u5c06\u79fb\u9664\u4e4b\u524d\u7684 getWorldMatrix \u65b9\u6cd5\uff0c\u5e76\u6dfb\u52a0\u4e00\u4e2a\u540d\u4e3a getModelViewMatrix \u7684\u65b0\u65b9\u6cd5\u3002 public Matrix4f getModelViewMatrix(GameItem gameItem, Matrix4f viewMatrix) { Vector3f rotation = gameItem.getRotation(); modelViewMatrix.set(viewMatrix).translate(gameItem.getPosition()). rotateX((float)Math.toRadians(-rotation.x)). rotateY((float)Math.toRadians(-rotation.y)). rotateZ((float)Math.toRadians(-rotation.z)). scale(gameItem.getScale()); return modelViewMatrix; } \u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u5c06\u8c03\u7528\u4e00\u6b21 getModelViewMatrix \u65b9\u6cd5\u3002 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u6444\u50cf\u673a\u7684\u503c\uff0c\u5728\u6295\u5f71\u77e9\u9635\u66f4\u65b0\u4e4b\u540e\u66f4\u65b0\u89c2\u5bdf\u77e9\u9635\u3002 // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); shaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 Matrix4f viewMatrix = transformation.getViewMatrix(camera); shaderProgram.setUniform(\"texture_sampler\", 0); // \u6e32\u67d3\u6bcf\u4e2a\u6e38\u620f\u9879 for(GameItem gameItem : gameItems) { // \u4e3a\u8be5\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u6e32\u67d3\u8be5\u6e38\u620f\u9879\u7684\u7f51\u683c gameItem.getMesh().render(); } \u8fd9\u5c31\u662f\u5b9e\u73b0\u6444\u50cf\u673a\u6982\u5ff5\u7684\u57fa\u672c\u4ee3\u7801\uff0c\u73b0\u5728\u9700\u8981\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u53ef\u4ee5\u4fee\u6539\u8f93\u5165\u5904\u7406\u548c\u66f4\u65b0\u6444\u50cf\u673a\u7684\u65b9\u5f0f\uff0c\u5c06\u8bbe\u7f6e\u5982\u4e0b\u6309\u952e\uff1a \u201cA\u201d\u548c\u201cD\u201d\u952e\u4f7f\u6444\u50cf\u673a\u5de6\u53f3\uff08X\u8f74\uff09\u79fb\u52a8\u3002 \u201cW\u201d\u548c\u201cS\u201d\u952e\u4f7f\u6444\u50cf\u673a\u524d\u540e\uff08Z\u8f74\uff09\u79fb\u52a8\u3002 \u201cZ\u201d\u548c\u201cX\u201d\u952e\u4f7f\u6444\u50cf\u673a\u4e0a\u4e0b\uff08Y\u8f74\uff09\u79fb\u52a8\u3002 \u5f53\u9f20\u6807\u6309\u4e0b\u53f3\u952e\u65f6\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9f20\u6807\u4f4d\u7f6e\u6cbfX\u548cY\u8f74\u65cb\u8f6c\u6444\u50cf\u673a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u5c06\u9996\u6b21\u4f7f\u7528\u9f20\u6807\uff0c\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MouseInput \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u5c01\u88c5\u9f20\u6807\u8bbf\u95ee\u3002\u8be5\u7c7b\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine; import org.joml.Vector2d; import org.joml.Vector2f; import static org.lwjgl.glfw.GLFW.*; public class MouseInput { private final Vector2d previousPos; private final Vector2d currentPos; private final Vector2f displVec; private boolean inWindow = false; private boolean leftButtonPressed = false; private boolean rightButtonPressed = false; public MouseInput() { previousPos = new Vector2d(-1, -1); currentPos = new Vector2d(0, 0); displVec = new Vector2f(); } public void init(Window window) { glfwSetCursorPosCallback(window.getWindowHandle(), (windowHandle, xpos, ypos) -> { currentPos.x = xpos; currentPos.y = ypos; }); glfwSetCursorEnterCallback(window.getWindowHandle(), (windowHandle, entered) -> { inWindow = entered; }); glfwSetMouseButtonCallback(window.getWindowHandle(), (windowHandle, button, action, mode) -> { leftButtonPressed = button == GLFW_MOUSE_BUTTON_1 && action == GLFW_PRESS; rightButtonPressed = button == GLFW_MOUSE_BUTTON_2 && action == GLFW_PRESS; }); } public Vector2f getDisplVec() { return displVec; } public void input(Window window) { displVec.x = 0; displVec.y = 0; if (previousPos.x > 0 && previousPos.y > 0 && inWindow) { double deltax = currentPos.x - previousPos.x; double deltay = currentPos.y - previousPos.y; boolean rotateX = deltax != 0; boolean rotateY = deltay != 0; if (rotateX) { displVec.y = (float) deltax; } if (rotateY) { displVec.x = (float) deltay; } } previousPos.x = currentPos.x; previousPos.y = currentPos.y; } public boolean isLeftButtonPressed() { return leftButtonPressed; } public boolean isRightButtonPressed() { return rightButtonPressed; } } MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5e94\u5728\u5728\u521d\u59cb\u5316\u9636\u6bb5\u8c03\u7528\u7684 init \u65b9\u6cd5\uff0c\u5e76\u6ce8\u518c\u4e00\u7ec4\u56de\u8c03\u4ee5\u5904\u7406\u9f20\u6807\u4e8b\u4ef6\uff1a glfwSetCursorPosCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u79fb\u52a8\u65f6\u88ab\u8c03\u7528\u3002 glfwSetCursorEnterCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5c06\u5728\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u65f6\u88ab\u8c03\u7528\u3002\u5373\u4f7f\u9f20\u6807\u4e0d\u5728\u7a97\u53e3\u5185\uff0c\u6211\u4eec\u4e5f\u4f1a\u6536\u5230\u9f20\u6807\u4e8b\u4ef6\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e2a\u56de\u8c03\u6765\u786e\u8ba4\u9f20\u6807\u8fdb\u5165\u7a97\u53e3\u3002 glfwSetMouseButtonCallback \uff1a\u6ce8\u518c\u4e00\u4e2a\u56de\u8c03\uff0c\u8be5\u56de\u8c03\u5728\u6309\u4e0b\u9f20\u6807\u6309\u94ae\u65f6\u88ab\u8c03\u7528\u3002 MouseInput \u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e2a input \u65b9\u6cd5\uff0c\u5728\u5904\u7406\u6e38\u620f\u8f93\u5165\u65f6\u5e94\u8c03\u7528\u8be5\u65b9\u6cd5\u3002\u8be5\u65b9\u6cd5\u8ba1\u7b97\u9f20\u6807\u4ece\u4e0a\u4e00\u4e2a\u4f4d\u7f6e\u7684\u4f4d\u79fb\uff0c\u5e76\u5c06\u5176\u5b58\u50a8\u5230 Vector2f \u7c7b\u578b\u7684 displVec \u53d8\u91cf\u4e2d\uff0c\u4ee5\u4fbf\u6e38\u620f\u4f7f\u7528\u5b83\u3002 MouseInput \u7c7b\u5c06\u5728 GameEngine \u7c7b\u4e2d\u5b9e\u4f8b\u5316\uff0c\u5e76\u4e14\u5c06\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u7ed9\u6e38\u620f\u5b9e\u73b0\u7684 init \u548c update \u65b9\u6cd5\uff08\u56e0\u6b64\u9700\u8981\u76f8\u5e94\u5730\u66f4\u6539 IGameLogic \u63a5\u53e3\uff09\u3002 void input(Window window, MouseInput mouseInput); void update(float interval, MouseInput mouseInput); \u9f20\u6807\u8f93\u5165\u5c06\u5728 GameEngine \u7c7b\u7684 input \u65b9\u6cd5\u4e2d\u88ab\u5904\u7406\uff0c\u800c\u6700\u7ec8\u7684\u63a7\u5236\u5c06\u4ea4\u7531\u6e38\u620f\u5b9e\u73b0\u3002 protected void input() { mouseInput.input(window); gameLogic.input(window, mouseInput); } \u73b0\u5728\u5df2\u7ecf\u51c6\u5907\u597d\u4fee\u6539 DummyGame \u7c7b\u6765\u5904\u7406\u952e\u76d8\u548c\u9f20\u6807\u8f93\u5165\u4e86\u3002\u8be5\u7c7b\u7684\u8f93\u5165\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a @Override public void input(Window window, MouseInput mouseInput) { cameraInc.set(0, 0, 0); if (window.isKeyPressed(GLFW_KEY_W)) { cameraInc.z = -1; } else if (window.isKeyPressed(GLFW_KEY_S)) { cameraInc.z = 1; } if (window.isKeyPressed(GLFW_KEY_A)) { cameraInc.x = -1; } else if (window.isKeyPressed(GLFW_KEY_D)) { cameraInc.x = 1; } if (window.isKeyPressed(GLFW_KEY_Z)) { cameraInc.y = -1; } else if (window.isKeyPressed(GLFW_KEY_X)) { cameraInc.y = 1; } } \u8fd9\u53ea\u662f\u66f4\u65b0\u4e00\u4e2a\u540d\u4e3a cameraInc \u7684 Vector3f \u53d8\u91cf\uff0c\u5b83\u50a8\u5b58\u4e86\u6444\u50cf\u673a\u5e94\u7528\u7684\u4f4d\u79fb\u3002 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u5c06\u6839\u636e\u5904\u7406\u7684\u952e\u76d8\u548c\u9f20\u6807\u4e8b\u4ef6\uff0c\u4fee\u6539\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u3002 @Override public void update(float interval, MouseInput mouseInput) { // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u57fa\u4e8e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); } } \u73b0\u5728\u53ef\u4ee5\u6dfb\u52a0\u66f4\u591a\u7684\u7acb\u65b9\u4f53\u5230\u4e16\u754c\u4e2d\uff0c\u7f29\u653e\u5b83\u4eec\uff0c\u5c06\u5b83\u4eec\u8bbe\u7f6e\u5728\u7279\u5b9a\u4f4d\u7f6e\uff0c\u5e76\u4f7f\u7528\u65b0\u6444\u50cf\u673a\u6e38\u73a9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6240\u6709\u7684\u7acb\u65b9\u4f53\u5171\u4eab\u76f8\u540c\u7684\u7f51\u683c\u3002 GameItem gameItem1 = new GameItem(mesh); gameItem1.setScale(0.5f); gameItem1.setPosition(0, 0, -2); GameItem gameItem2 = new GameItem(mesh); gameItem2.setScale(0.5f); gameItem2.setPosition(0.5f, 0.5f, -2); GameItem gameItem3 = new GameItem(mesh); gameItem3.setScale(0.5f); gameItem3.setPosition(0, 0, -2.5f); GameItem gameItem4 = new GameItem(mesh); gameItem4.setScale(0.5f); gameItem4.setPosition(0.5f, 0, -2.5f); gameItems = new GameItem[]{gameItem1, gameItem2, gameItem3, gameItem4}; \u4f60\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\u3002","title":"\u6444\u50cf\u673a\uff08Camera\uff09"},{"location":"09-loading-more-complex-models/","text":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b\uff08Loading more complex models\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u52a0\u8f7d\u5728\u5916\u90e8\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u590d\u6742\u6a21\u578b\u3002\u8fd9\u4e9b\u6a21\u578b\u5c06\u4f7f\u75283D\u5efa\u6a21\u5de5\u5177(\u4f8b\u5982 Blender )\u521b\u5efa\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u901a\u8fc7\u76f4\u63a5\u7f16\u7801\u5b9a\u4e49\u5176\u51e0\u4f55\u56fe\u5f62\u7684\u6570\u7ec4\u6765\u521b\u5efa\u6a21\u578b\u3002\u4f46\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u4ee5OBJ\u683c\u5f0f\u5b9a\u4e49\u7684\u6a21\u578b\u3002 OBJ\uff08\u6216.obj\uff09\u662fWavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002OBJ\u6587\u4ef6\u5b9a\u4e49\u6784\u6210\u4e09\u7ef4\u6a21\u578b\u7684\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u591a\u8fb9\u5f62\u3002\u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5bb9\u6613\u89e3\u6790\u7684\u683c\u5f0f\uff0c\u56e0\u4e3a\u5b83\u57fa\u4e8e\u6587\u672c\uff0c\u6bcf\u4e00\u884c\u5b9a\u4e49\u4e00\u4e2a\u5143\u7d20\uff08\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u7b49\uff09\u3002 \u5728.obj\u6587\u4ef6\u4e2d\uff0c\u6bcf\u884c\u4ee5\u4e00\u4e2a\u6807\u8bb0\u5143\u7d20\u7c7b\u578b\u7684\u6807\u8bc6\u7b26\u5f00\u5934\uff1a \u4ee5\"#\"\u5f00\u59cb\u7684\u884c\u662f\u6ce8\u91ca\u3002 \u4ee5\"v\"\u5f00\u59cb\u7684\u884c\u7528\u5750\u6807(x, y, z, w)\u5b9a\u4e49\u4e00\u4e2a\u51e0\u4f55\u9876\u70b9\u3002\u4f8b\u5982\uff1a v 0.155 0.211 0.32 1.0 \u3002 \u4ee5\"vn\"\u5f00\u59cb\u7684\u884c\u662f\u7528\u5750\u6807(x, y, z)\u5b9a\u4e49\u9876\u70b9\u6cd5\u7ebf\uff08Normals\uff09\u3002\u4f8b\u5982\uff1a vn 0.71 0.21 0.82 \u3002\u4e4b\u540e\u518d\u8ba8\u8bba\u8fd9\u4e2a\u4e1c\u897f\u3002 \u4ee5\"vt\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u3002\u4f8b\u5982\uff1a vt 0.500 1 \u3002 \u4ee5\"f\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u9762\u3002\u5229\u7528\u8be5\u884c\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u6784\u9020\u7d22\u5f15\u6570\u7ec4\u3002\u6211\u4eec\u53ea\u5904\u7406\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u7684\u60c5\u51b5\u3002\u5b83\u53ef\u4ee5\u6709\u51e0\u79cd\u5b9a\u4e49\u65b9\u5f0f\uff1a \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\uff08 f v1 v2 v3 \uff09\u3002\u4f8b\u5982\uff1a f 6 3 1 \u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u8fd9\u4e2a\u4e09\u89d2\u5f62\u662f\u7531\u4f4d\u7f6e\u4e3a6\u30013\u548c1\u7684\u51e0\u4f55\u9876\u70b9\u5b9a\u4e49\u7684\uff08\u9876\u70b9\u7d22\u5f15\u603b\u662f\u4ece1\u5f00\u59cb\uff09\u3002 \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff08 f v1/t1/n1 v2/t2/n2 v3/t3/n3 \uff09\u3002\u4f8b\u5982\uff1a f 6/4/1 3/5/3 7/6/5 \u3002\u7b2c\u4e00\u90e8\u5206\u662f v1/t1/n1 \uff0c\u5176\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6cd5\u7ebf\u3002\u770b\u5230\u8be5\u90e8\u5206\u53ef\u4ee5\u8bf4\u51fa\uff1a\u9009\u62e9\u51e0\u4f55\u9876\u70b96\u3001\u7eb9\u7406\u5750\u68074\u548c\u9876\u70b9\u6cd5\u7ebf1\u3002 OBJ\u683c\u5f0f\u6709\u66f4\u591a\u7684\u5143\u7d20\u7c7b\u578b\uff08\u5982\u4e00\u7ec4\u591a\u8fb9\u5f62\u3001\u5b9a\u4e49\u6750\u8d28\u7b49\uff09\u3002\u73b0\u5728\u6211\u4eec\u4ec5\u5b9e\u73b0\u4e0a\u8ff0\u5b50\u96c6\uff0c\u6211\u4eec\u7684OBJ\u52a0\u8f7d\u5668\u5c06\u5ffd\u7565\u5176\u4ed6\u5143\u7d20\u7c7b\u578b\u3002 \u4f46\u662f\u4ec0\u4e48\u662f\u6cd5\u7ebf\u5462\uff1f\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u5b83\u3002\u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u5982\u4e0a\u6240\u89c1\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u6709\u4e24\u6761\u6cd5\u7ebf\uff0c\u6211\u4eec\u5e94\u8be5\u7528\u54ea\u4e00\u4e2a\u5462\uff1f\u4e09\u7ef4\u56fe\u5f62\u4e2d\u7684\u6cd5\u7ebf\u662f\u7528\u4e8e\u5149\u7167\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u9762\u5411\u5149\u6e90\u7684\u6cd5\u7ebf\u3002\u6362\u8a00\u4e4b\uff0c\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u6307\u5411\u6a21\u578b\u5916\u7684\u6cd5\u7ebf\u3002 \u6211\u4eec\u6709\u4e00\u4e2a\u7531\u591a\u8fb9\u5f62\u548c\u4e09\u89d2\u5f62\u7ec4\u6210\u76843D\u6a21\u578b\uff0c\u6bcf\u4e2a\u4e09\u89d2\u5f62\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\uff0c\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u5411\u91cf\u662f\u5782\u76f4\u4e8e\u4e09\u89d2\u5f62\u8868\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u9876\u70b9\u6cd5\u7ebf\u4e0e\u7279\u5b9a\u9876\u70b9\u76f8\u5173\u8054\uff0c\u5e76\u4e14\u662f\u5468\u56f4\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff08\u5f53\u7136\u5b83\u7684\u957f\u5ea6\u7b49\u4e8e1\uff09\u3002\u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u4e00\u4e2a3D\u7f51\u683c\u7684\u9876\u70b9\u6a21\u578b\uff08\u53d6\u81ea \u7ef4\u57fa\u767e\u79d1 \uff09 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u521b\u5efaOBJ\u52a0\u8f7d\u5668\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u4fee\u6539 Mesh \u7c7b\uff0c\u56e0\u4e3a\u73b0\u5728\u5fc5\u987b\u4f7f\u7528\u7eb9\u7406\u3002\u6211\u4eec\u53ef\u80fd\u52a0\u8f7d\u4e00\u4e9b\u6ca1\u6709\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u7684OBJ\u6587\u4ef6\uff0c\u56e0\u6b64\u5fc5\u987b\u80fd\u591f\u4f7f\u7528\u989c\u8272\u800c\u4e0d\u662f\u4f7f\u7528\u7eb9\u7406\u6e32\u67d3\u5b83\u4eec\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u7684\u5b9a\u4e49\u683c\u5f0f\u4e3a\uff1a f v/n \u3002 Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u540d\u4e3a colour \u7684\u65b0\u5c5e\u6027\u3002 private Vector3f colour; \u5e76\u4e14\u6784\u9020\u51fd\u6570\u4e0d\u518d\u9700\u8981 Texture \u3002\u53d6\u800c\u4ee3\u4e4b\u7684\u662f\uff0c\u6211\u4eec\u5c06\u4e3a\u7eb9\u7406\u548c\u989c\u8272\u5c5e\u6027\u63d0\u4f9b get \u548c set \u65b9\u6cd5\u3002 public Mesh(float[] positions, float[] textCoords, float[] normals, int[] indices) { \u5f53\u7136\uff0c\u5728 render \u548c clear \u65b9\u6cd5\u4e2d\uff0c\u5728\u4f7f\u7528\u7eb9\u7406\u4e4b\u524d\uff0c\u5fc5\u987b\u68c0\u67e5\u7eb9\u7406\u662f\u5426\u4e3a null \u3002\u6b63\u5982\u4f60\u5728\u6784\u9020\u51fd\u6570\u4e2d\u770b\u5230\u7684\uff0c\u73b0\u5728\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u540d\u4e3a normals \u7684\u65b0\u6d6e\u70b9\u6570\u7ec4\u3002\u5982\u4f55\u4f7f\u7528\u6cd5\u7ebf\u6e32\u67d3\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5b83\u53ea\u662fVAO\u4e2d\u7684\u53e6\u4e00\u4e2aVBO\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u5982\u4e0b\u4ee3\u7801\uff1a // \u9876\u70b9\u6cd5\u7ebfVBO vboId = glGenBuffers(); vboIdList.add(vboId); vecNormalsBuffer = MemoryUtil.memAllocFloat(normals.length); vecNormalsBuffer.put(normals).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, vecNormalsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(2); glVertexAttribPointer(2, 3, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9 Mesh \u7c7b\u7684\u4fee\u6539\uff0c\u53ef\u4ee5\u4fee\u6539\u4ee3\u7801\u6765\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6216\u56fa\u5b9a\u7684\u989c\u8272\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u50cf\u8fd9\u6837\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 colour; uniform int useColour; void main() { if ( useColour == 1 ) { fragColor = vec4(colour, 1); } else { fragColor = texture(texture_sampler, outTexCoord); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e24\u4e2a\u65b0Uniform\uff1a colour : \u5c06\u50a8\u5b58\u57fa\u672c\u989c\u8272\u3002 useColour : \u8fd9\u662f\u4e2a\u6807\u5fd7\uff0c\u5f53\u4f60\u4e0d\u60f3\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u5b83\u5c06\u88ab\u8bbe\u7f6e\u4e3a1\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u8fd9\u4e24\u4e2aUniform\u3002 // \u4e3a\u9ed8\u8ba4\u989c\u8272\u4e0e\u63a7\u5236\u5b83\u7684\u6807\u5fd7\u521b\u5efaUniform shaderProgram.createUniform(\"colour\"); shaderProgram.createUniform(\"useColour\"); \u548c\u5176\u4ed6Uniform\u4e00\u6837\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e5f\u9700\u8981\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\u3002 for(GameItem gameItem : gameItems) { Mesh mesh = gameItem.getMesh(); // \u4e3a\u8be5\u6e38\u620f\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c shaderProgram.setUniform(\"colour\", mesh.getColour()); shaderProgram.setUniform(\"useColour\", mesh.isTextured() ? 0 : 1); mesh.render(); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a OBJLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u89e3\u6790OBJ\u6587\u4ef6\uff0c\u5e76\u7528\u5176\u4e2d\u5305\u542b\u7684\u6570\u636e\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u3002\u4f60\u53ef\u80fd\u4f1a\u5728\u7f51\u4e0a\u53d1\u73b0\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\u53ef\u80fd\u6bd4\u8fd9\u66f4\u6709\u6548\uff0c\u4f46\u6211\u8ba4\u4e3a\u8be5\u65b9\u6848\u66f4\u5bb9\u6613\u7406\u89e3\u3002\u8fd9\u662f\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u5c06\u6709\u5982\u4e0b\u9759\u6001\u65b9\u6cd5\uff1a public static Mesh loadMesh(String fileName) throws Exception { \u53c2\u6570 fileName \u6307\u5b9aOBJ\u6a21\u578b\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8be5\u6587\u4ef6\u5fc5\u987b\u5305\u542b\u5728\u7c7b\u8def\u5f84\u4e2d\u3002 \u5728\u8be5\u65b9\u6cd5\u4e2d\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9\u5e76\u5c06\u6240\u6709\u884c\u50a8\u5b58\u5230\u4e00\u4e2a\u6570\u7ec4\u4e2d\uff0c\u7136\u540e\u521b\u5efa\u51e0\u4e2a\u5217\u8868\u6765\u50a8\u5b58\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u9762\u3002 List<String> lines = Utils.readAllLines(fileName); List<Vector3f> vertices = new ArrayList<>(); List<Vector2f> textures = new ArrayList<>(); List<Vector3f> normals = new ArrayList<>(); List<Face> faces = new ArrayList<>(); \u7136\u540e\u89e3\u6790\u6bcf\u4e00\u884c\uff0c\u5e76\u6839\u636e\u5f00\u5934\u6807\u8bc6\u7b26\u5f97\u5230\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u9876\u70b9\u6cd5\u7ebf\u6216\u9762\u5b9a\u4e49\uff0c\u6700\u540e\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 for (String line : lines) { String[] tokens = line.split(\"\\\\s+\"); switch (tokens[0]) { case \"v\": // \u51e0\u4f55\u9876\u70b9 Vector3f vec3f = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); vertices.add(vec3f); break; case \"vt\": // \u7eb9\u7406\u5750\u6807 Vector2f vec2f = new Vector2f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2])); textures.add(vec2f); break; case \"vn\": // \u9876\u70b9\u6cd5\u7ebf Vector3f vec3fNorm = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); normals.add(vec3fNorm); break; case \"f\": Face face = new Face(tokens[1], tokens[2], tokens[3]); faces.add(face); break; default: // \u5ffd\u7565\u5176\u4ed6\u884c break; } } return reorderLists(vertices, textures, normals, faces); \u5728\u8bb2\u89e3\u91cd\u65b0\u6392\u5e8f\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u5982\u4f55\u89e3\u6790\u9762\u7684\u5b9a\u4e49\u3002\u6211\u4eec\u5df2\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Face \u7684\u7c7b\uff0c\u5b83\u8d1f\u8d23\u89e3\u6790\u4e00\u4e2a\u9762\u7684\u5b9a\u4e49\u3002\u4e00\u4e2a Face \u662f\u7531\u4e00\u4e2a\u7d22\u5f15\u7ec4\u5217\u8868\u7ec4\u6210\u7684\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u5904\u7406\u7684\u662f\u4e09\u89d2\u5f62\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u6709\u4e09\u4e2a\u7d22\u5f15\u7ec4\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a IndexGroup \u7684\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u7d22\u5f15\u7ec4\u7684\u6570\u636e\u3002 protected static class IdxGroup { public static final int NO_VALUE = -1; public int idxPos; public int idxTextCoord; public int idxVecNormal; public IdxGroup() { idxPos = NO_VALUE; idxTextCoord = NO_VALUE; idxVecNormal = NO_VALUE; } } Face \u7c7b\u5982\u4e0b\u6240\u793a\uff1a protected static class Face { /** * \u9762\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u7ec4\u5217\u8868\uff08\u6bcf\u4e2a\u9762\u4e09\u4e2a\u9876\u70b9\uff09\u3002 */ private IdxGroup[] idxGroups = new IdxGroup[3]; public Face(String v1, String v2, String v3) { idxGroups = new IdxGroup[3]; // \u89e3\u6790\u884c idxGroups[0] = parseLine(v1); idxGroups[1] = parseLine(v2); idxGroups[2] = parseLine(v3); } private IdxGroup parseLine(String line) { IdxGroup idxGroup = new IdxGroup(); String[] lineTokens = line.split(\"/\"); int length = lineTokens.length; idxGroup.idxPos = Integer.parseInt(lineTokens[0]) - 1; if (length > 1) { // \u5982\u679cOBJ\u4e0d\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\uff0c\u5219\u53ef\u4e3anull String textCoord = lineTokens[1]; idxGroup.idxTextCoord = textCoord.length() > 0 ? Integer.parseInt(textCoord) - 1 : IdxGroup.NO_VALUE; if (length > 2) { idxGroup.idxVecNormal = Integer.parseInt(lineTokens[2]) - 1; } } return idxGroup; } public IdxGroup[] getFaceVertexIndices() { return idxGroups; } } \u5f53\u89e3\u6790\u9762\u65f6\uff0c\u6211\u4eec\u53ef\u4ee5\u770b\u5230\u6ca1\u6709\u7eb9\u7406\u4f46\u5e26\u6709\u77e2\u91cf\u6cd5\u7ebf\u7684\u5bf9\u8c61\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u5b9a\u4e49\u53ef\u80fd\u50cf f 11//1 17//1 13//1 \u8fd9\u6837\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8fd9\u4e9b\u60c5\u51b5\u3002 \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 Mesh \u7c7b\u9700\u8981\u56db\u4e2a\u6570\u7ec4\uff0c\u5206\u522b\u7528\u4e8e\u4f4d\u7f6e\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u77e2\u91cf\u548c\u7d22\u5f15\u3002\u524d\u4e09\u4e2a\u6570\u7ec4\u5e94\u8be5\u5177\u6709\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\uff0c\u56e0\u4e3a\u7d22\u5f15\u6570\u7ec4\u662f\u552f\u4e00\u7684\uff08\u6ce8\u610f\uff0c\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\u5e76\u4e0d\u610f\u5473\u7740\u76f8\u540c\u7684\u957f\u5ea6\u3002\u9876\u70b9\u5750\u6807\u662f\u4e09\u7ef4\u7684\uff0c\u7531\u4e09\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u3002\u7eb9\u7406\u5750\u6807\u662f\u4e8c\u7ef4\u7684\uff0c\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\uff09\u3002OpenGL\u4e0d\u5141\u8bb8\u6211\u4eec\u5bf9\u6bcf\u4e2a\u5143\u7d20\u7c7b\u578b\u5b9a\u4e49\u4e0d\u540c\u7684\u7d22\u5f15\u6570\u7ec4\uff08\u5982\u679c\u53ef\u4ee5\u7684\u8bdd\uff0c\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u5728\u5e94\u7528\u7eb9\u7406\u65f6\u91cd\u590d\u9876\u70b9\uff09\u3002 \u5f53\u4f60\u6253\u5f00\u4e00\u4e2aOBJ\u6587\u4ef6\u65f6\uff0c\u4f60\u9996\u5148\u53ef\u80fd\u4f1a\u770b\u5230\u50a8\u5b58\u9876\u70b9\u5750\u6807\u7684\u5217\u8868\uff0c\u6bd4\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6570\u91cf\u7684\u5217\u8868\u7684\u5143\u7d20\u6570\u91cf\u66f4\u591a\u3002\u8fd9\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u95ee\u9898\u3002\u4e3e\u4e00\u4e2a\u7b80\u5355\u7684\u4f8b\u5b50\uff0c\u5b9a\u4e49\u4e00\u4e2a\u5177\u6709\u50cf\u7d20\u9ad8\u5ea6\u7684\u6b63\u65b9\u5f62\uff08\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\uff0c\u5176OBJ\u6587\u4ef6\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff08\u4e0d\u8981\u592a\u5173\u6ce8\u6cd5\u7ebf\u5750\u6807\uff0c\u56e0\u4e3a\u5b83\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\u3002 v 0 0 0 v 1 0 0 v 1 1 0 v 0 1 0 vt 0 1 vt 1 1 vn 0 0 1 f 1/2/1 2/1/1 3/2/1 f 1/2/1 3/2/1 4/1/1 \u5f53\u5b8c\u6210\u5bf9\u6587\u4ef6\u7684\u89e3\u6790\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u5982\u4e0b\u6240\u793a\u5217\u8868\uff08\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b57\u662f\u5b83\u5728\u6587\u4ef6\u4e2d\u7684\u4f4d\u7f6e\u987a\u5e8f\uff0c\u6309\u51fa\u73b0\u987a\u5e8f\u6392\u5217\uff09\uff1a \u73b0\u5728\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u5b9a\u4e49\u6765\u521b\u5efa\u5305\u542b\u7d22\u5f15\u7684\u6700\u7ec8\u6570\u7ec4\u3002\u9700\u8981\u8003\u8651\u7684\u662f\uff0c\u7eb9\u7406\u5750\u6807\u4e0e\u6cd5\u7ebf\u5411\u91cf\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0e\u9876\u70b9\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0d\u5bf9\u5e94\u3002\u5982\u679c\u5217\u8868\u7684\u5927\u5c0f\u662f\u76f8\u540c\u7684\u5e76\u6709\u5e8f\u7684\uff0c\u90a3\u4e48\u9762\u5b9a\u4e49\u5c31\u53ea\u9700\u8981\u6bcf\u4e2a\u9876\u70b9\u4e00\u4e2a\u7d22\u5f15\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6392\u5217\u6570\u636e\uff0c\u5e76\u6839\u636e\u9700\u8981\u8fdb\u884c\u76f8\u5e94\u7684\u8bbe\u7f6e\u3002\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e09\u4e2a\u6570\u7ec4\uff08\u7528\u4e8e\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff09\u548c\u4e00\u4e2a\u7d22\u5f15\u5217\u8868\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u4e09\u4e2a\u6570\u7ec4\u5143\u7d20\u6570\u91cf\u76f8\u540c\uff08\u7b49\u4e8e\u9876\u70b9\u6570\uff09\uff0c\u9876\u70b9\u6570\u7ec4\u5c06\u662f\u9876\u70b9\u5217\u8868\u7684\u526f\u672c\u3002 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u5904\u7406\u8fd9\u4e9b\u9762\u3002\u7b2c\u4e00\u4e2a\u9762\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u7ec4\u662f1/2/1\u3002\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\uff08\u5b9a\u4e49\u51e0\u4f55\u9876\u70b9\u7684\u7d22\u5f15\uff09\u6765\u6784\u9020\u7d22\u5f15\u5217\u8868\uff0c\u79f0\u4e4b\u4e3a posIndex \u3002 \u9762\u6307\u5b9a\u6211\u4eec\u5e94\u8be5\u628a\u5360\u636e\u7b2c\u4e00\u4e2a\u4f4d\u7f6e\u7684\u5143\u7d20\u7684\u7d22\u5f15\u6dfb\u52a0\u5230\u7d22\u5f15\u5217\u8868\u4e2d\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06 posIndex \u51cf\u53bb1\u540e\u653e\u5230 indicesList \u4e2d\uff08\u5fc5\u987b\u51cf1\uff0c\u56e0\u4e3a\u6570\u7ec4\u7684\u8d77\u59cb\u662f0\uff0c\u800cOBJ\u6587\u4ef6\u683c\u5f0f\u4e2d\u8d77\u59cb\u662f1\uff09\u3002 \u7136\u540e\uff0c\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u7684\u5176\u4ed6\u7d22\u5f15\u6765\u8bbe\u7f6e texturesArray \u548c normalsArray \u3002\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u662f2\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5c06\u7b2c\u4e8c\u4e2a\u7eb9\u7406\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u7136\u540e\u6211\u4eec\u770b\u5230\u7b2c\u4e09\u4e2a\u7d22\u5f15\uff0c\u5b83\u4e3a1\uff0c\u6240\u4ee5\u8981\u505a\u7684\u662f\u5c06\u7b2c\u4e00\u4e2a\u6cd5\u7ebf\u5411\u91cf\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e00\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e8c\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u7b2c\u4e8c\u4e2a\u9762\u4e5f\u5b9a\u4e49\u4e86\u5df2\u7ecf\u88ab\u8d4b\u503c\u7684\u9876\u70b9\uff0c\u4f46\u662f\u5b83\u4eec\u6709\u76f8\u540c\u7684\u503c\uff0c\u6240\u4ee5\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u4e0a\u5f88\u7b80\u5355\u3002\u6211\u89c9\u5f97\u8fd9\u4e2a\u8fc7\u7a0b\u5df2\u7ecf\u8bb2\u89e3\u5f97\u8db3\u591f\u6e05\u6670\u4e86\uff0c\u4e0d\u8fc7\u5728\u4f60\u660e\u767d\u4e4b\u524d\u53ef\u80fd\u4f1a\u6709\u4e9b\u68d8\u624b\u3002\u91cd\u65b0\u6392\u5217\u6570\u636e\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\u3002\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u8981\u7684\u662f\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u9876\u70b9\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u7ec4\u8f6c\u6362\u4e3a\u6d6e\u70b9\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u5bf9\u4e8e\u9876\u70b9\u548c\u6cd5\u7ebf\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee53\uff0c\u800c\u5bf9\u4e8e\u7eb9\u7406\u5750\u6807\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee52\u3002 private static Mesh reorderLists(List<Vector3f> posList, List<Vector2f> textCoordList, List<Vector3f> normList, List<Face> facesList) { List<Integer> indices = new ArrayList<>(); // \u6309\u58f0\u660e\u7684\u987a\u5e8f\u521b\u5efa\u4f4d\u7f6e\u6570\u7ec4 float[] posArr = new float[posList.size() * 3]; int i = 0; for (Vector3f pos : posList) { posArr[i * 3] = pos.x; posArr[i * 3 + 1] = pos.y; posArr[i * 3 + 2] = pos.z; i++; } float[] textCoordArr = new float[posList.size() * 2]; float[] normArr = new float[posList.size() * 3]; for (Face face : facesList) { IdxGroup[] faceVertexIndices = face.getFaceVertexIndices(); for (IdxGroup indValue : faceVertexIndices) { processFaceVertex(indValue, textCoordList, normList, indices, textCoordArr, normArr); } } int[] indicesArr = new int[indices.size()]; indicesArr = indices.stream().mapToInt((Integer v) -> v).toArray(); Mesh mesh = new Mesh(posArr, textCoordArr, normArr, indicesArr); return mesh; } private static void processFaceVertex(IdxGroup indices, List<Vector2f> textCoordList, List<Vector3f> normList, List<Integer> indicesList, float[] texCoordArr, float[] normArr) { // \u8bbe\u7f6e\u9876\u70b9\u5750\u6807\u7684\u7d22\u5f15 int posIndex = indices.idxPos; indicesList.add(posIndex); // \u5bf9\u7eb9\u7406\u5750\u6807\u91cd\u65b0\u6392\u5e8f if (indices.idxTextCoord >= 0) { Vector2f textCoord = textCoordList.get(indices.idxTextCoord); texCoordArr[posIndex * 2] = textCoord.x; texCoordArr[posIndex * 2 + 1] = 1 - textCoord.y; } if (indices.idxVecNormal >= 0) { // \u5bf9\u6cd5\u7ebf\u5411\u91cf\u91cd\u65b0\u6392\u5e8f Vector3f vecNorm = normList.get(indices.idxVecNormal); normArr[posIndex * 3] = vecNorm.x; normArr[posIndex * 3 + 1] = vecNorm.y; normArr[posIndex * 3 + 2] = vecNorm.z; } } \u6b64\u5916\u9700\u8981\u6ce8\u610f\u7684\u662f\u7eb9\u7406\u5750\u6807\u662fUV\u683c\u5f0f\uff0c\u6240\u4ee5Y\u5750\u6807\u4e3a\u7528\u4e00\u51cf\u53bb\u6587\u4ef6\u4e2d\u53d6\u5230\u7684\u503c\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6e32\u67d3OBJ\u6a21\u578b\u3002\u6211\u51c6\u5907\u4e86\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u662f\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u8fc7\u7684\u5177\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u5728 DummyGame \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002 Texture texture = new Texture(\"/textures/grassblock.png\"); mesh.setTexture(texture); GameItem gameItem = new GameItem(mesh); gameItem.setScale(0.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u7136\u540e\u5c06\u4f1a\u5f97\u5230\u4e00\u4e2a\u719f\u6089\u7684\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002 \u6211\u4eec\u53ef\u4ee5\u5c1d\u8bd5\u6e32\u67d3\u5176\u4ed6\u6a21\u578b\uff0c\u4f8b\u5982\u53ef\u4ee5\u4f7f\u7528\u8457\u540d\u7684Stanford Bunny\u6a21\u578b\uff08\u5b83\u53ef\u4ee5\u514d\u8d39\u4e0b\u8f7d\uff09\uff0c\u5b83\u653e\u5728resources\u6587\u4ef6\u5939\u4e2d\u3002\u8fd9\u4e2a\u6a21\u578b\u6ca1\u6709\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u505a\uff1a Mesh mesh = OBJLoader.loadMesh(\"/models/bunny.obj\"); GameItem gameItem = new GameItem(mesh); gameItem.setScale(1.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u8fd9\u4e2a\u6a21\u578b\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u56e0\u4e3a\u6ca1\u6709\u7eb9\u7406\u4e5f\u6ca1\u6709\u5149\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u80fd\u770b\u5230\u5b83\u7684\u4f53\u79ef\uff0c\u4f46\u662f\u4f60\u53ef\u4ee5\u68c0\u67e5\u6a21\u578b\u662f\u5426\u6b63\u786e\u5730\u52a0\u8f7d\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u8bbe\u7f6eOpenGL\u53c2\u6570\u65f6\uff0c\u6dfb\u52a0\u8fd9\u4e00\u884c\u4ee3\u7801\u3002 glPolygonMode( GL_FRONT_AND_BACK, GL_LINE ); \u5f53\u4f60\u653e\u5927\u7684\u65f6\u5019\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6784\u6210\u6a21\u578b\u7684\u6240\u6709\u4e09\u89d2\u5f62\u3002 \u6709\u4e86\u8fd9\u4e2aOBJ\u8f7d\u5165\u7c7b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u4f7f\u7528Blender\u521b\u5efa\u6a21\u578b\u3002Blender\u662f\u4e00\u4e2a\u5f3a\u5927\u7684\u5de5\u5177\uff0c\u4f46\u521a\u5f00\u59cb\u4f7f\u7528\u5b83\u6709\u70b9\u56f0\u96be\uff0c\u5b83\u6709\u5f88\u591a\u9009\u9879\uff0c\u5f88\u591a\u5173\u8282\u7ec4\u5408\uff0c\u5728\u9996\u6b21\u4f7f\u7528\u5b83\u65f6\u4f60\u9700\u8981\u82b1\u65f6\u95f4\u505a\u5f88\u591a\u6700\u57fa\u672c\u7684\u4e8b\u60c5\u3002\u5f53\u4f7f\u7528Blender\u5bfc\u51fa\u6a21\u578b\u65f6\uff0c\u8bf7\u786e\u4fdd\u5305\u542b\u6cd5\u7ebf\u5e76\u5c06\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u3002 \u5bfc\u51fa\u65f6\u8bf7\u8bb0\u5f97\u5206\u5272\u8fb9\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u80fd\u5c06\u591a\u4e2a\u7eb9\u7406\u5750\u6807\u6307\u5b9a\u7ed9\u540c\u4e00\u4e2a\u9876\u70b9\u3002\u6b64\u5916\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u4e09\u89d2\u5f62\u5b9a\u4e49\u6cd5\u7ebf\uff0c\u800c\u4e0d\u662f\u6307\u5b9a\u7ed9\u9876\u70b9\u3002\u5982\u679c\u4f60\u5728\u67d0\u4e9b\u6a21\u578b\u4e2d\u9047\u5230\u4e86\u5149\u7167\u95ee\u9898\uff08\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff09\uff0c\u4f60\u5e94\u8be5\u9a8c\u8bc1\u4e00\u4e0b\u6cd5\u7ebf\u3002\u4f60\u53ef\u4ee5\u5728Blender\u4e2d\u770b\u5230\u6cd5\u7ebf\u3002","title":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b"},{"location":"09-loading-more-complex-models/#loading-more-complex-models","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u52a0\u8f7d\u5728\u5916\u90e8\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u590d\u6742\u6a21\u578b\u3002\u8fd9\u4e9b\u6a21\u578b\u5c06\u4f7f\u75283D\u5efa\u6a21\u5de5\u5177(\u4f8b\u5982 Blender )\u521b\u5efa\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u901a\u8fc7\u76f4\u63a5\u7f16\u7801\u5b9a\u4e49\u5176\u51e0\u4f55\u56fe\u5f62\u7684\u6570\u7ec4\u6765\u521b\u5efa\u6a21\u578b\u3002\u4f46\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u52a0\u8f7d\u4ee5OBJ\u683c\u5f0f\u5b9a\u4e49\u7684\u6a21\u578b\u3002 OBJ\uff08\u6216.obj\uff09\u662fWavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002OBJ\u6587\u4ef6\u5b9a\u4e49\u6784\u6210\u4e09\u7ef4\u6a21\u578b\u7684\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u591a\u8fb9\u5f62\u3002\u8fd9\u662f\u4e00\u79cd\u76f8\u5bf9\u5bb9\u6613\u89e3\u6790\u7684\u683c\u5f0f\uff0c\u56e0\u4e3a\u5b83\u57fa\u4e8e\u6587\u672c\uff0c\u6bcf\u4e00\u884c\u5b9a\u4e49\u4e00\u4e2a\u5143\u7d20\uff08\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u7b49\uff09\u3002 \u5728.obj\u6587\u4ef6\u4e2d\uff0c\u6bcf\u884c\u4ee5\u4e00\u4e2a\u6807\u8bb0\u5143\u7d20\u7c7b\u578b\u7684\u6807\u8bc6\u7b26\u5f00\u5934\uff1a \u4ee5\"#\"\u5f00\u59cb\u7684\u884c\u662f\u6ce8\u91ca\u3002 \u4ee5\"v\"\u5f00\u59cb\u7684\u884c\u7528\u5750\u6807(x, y, z, w)\u5b9a\u4e49\u4e00\u4e2a\u51e0\u4f55\u9876\u70b9\u3002\u4f8b\u5982\uff1a v 0.155 0.211 0.32 1.0 \u3002 \u4ee5\"vn\"\u5f00\u59cb\u7684\u884c\u662f\u7528\u5750\u6807(x, y, z)\u5b9a\u4e49\u9876\u70b9\u6cd5\u7ebf\uff08Normals\uff09\u3002\u4f8b\u5982\uff1a vn 0.71 0.21 0.82 \u3002\u4e4b\u540e\u518d\u8ba8\u8bba\u8fd9\u4e2a\u4e1c\u897f\u3002 \u4ee5\"vt\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u3002\u4f8b\u5982\uff1a vt 0.500 1 \u3002 \u4ee5\"f\"\u5f00\u59cb\u7684\u884c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u9762\u3002\u5229\u7528\u8be5\u884c\u4e2d\u7684\u6570\u636e\u53ef\u4ee5\u6784\u9020\u7d22\u5f15\u6570\u7ec4\u3002\u6211\u4eec\u53ea\u5904\u7406\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u7684\u60c5\u51b5\u3002\u5b83\u53ef\u4ee5\u6709\u51e0\u79cd\u5b9a\u4e49\u65b9\u5f0f\uff1a \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\uff08 f v1 v2 v3 \uff09\u3002\u4f8b\u5982\uff1a f 6 3 1 \u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u8fd9\u4e2a\u4e09\u89d2\u5f62\u662f\u7531\u4f4d\u7f6e\u4e3a6\u30013\u548c1\u7684\u51e0\u4f55\u9876\u70b9\u5b9a\u4e49\u7684\uff08\u9876\u70b9\u7d22\u5f15\u603b\u662f\u4ece1\u5f00\u59cb\uff09\u3002 \u5b83\u53ef\u4ee5\u5b9a\u4e49\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff08 f v1/t1/n1 v2/t2/n2 v3/t3/n3 \uff09\u3002\u4f8b\u5982\uff1a f 6/4/1 3/5/3 7/6/5 \u3002\u7b2c\u4e00\u90e8\u5206\u662f v1/t1/n1 \uff0c\u5176\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6cd5\u7ebf\u3002\u770b\u5230\u8be5\u90e8\u5206\u53ef\u4ee5\u8bf4\u51fa\uff1a\u9009\u62e9\u51e0\u4f55\u9876\u70b96\u3001\u7eb9\u7406\u5750\u68074\u548c\u9876\u70b9\u6cd5\u7ebf1\u3002 OBJ\u683c\u5f0f\u6709\u66f4\u591a\u7684\u5143\u7d20\u7c7b\u578b\uff08\u5982\u4e00\u7ec4\u591a\u8fb9\u5f62\u3001\u5b9a\u4e49\u6750\u8d28\u7b49\uff09\u3002\u73b0\u5728\u6211\u4eec\u4ec5\u5b9e\u73b0\u4e0a\u8ff0\u5b50\u96c6\uff0c\u6211\u4eec\u7684OBJ\u52a0\u8f7d\u5668\u5c06\u5ffd\u7565\u5176\u4ed6\u5143\u7d20\u7c7b\u578b\u3002 \u4f46\u662f\u4ec0\u4e48\u662f\u6cd5\u7ebf\u5462\uff1f\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u5b83\u3002\u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u5982\u4e0a\u6240\u89c1\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u6709\u4e24\u6761\u6cd5\u7ebf\uff0c\u6211\u4eec\u5e94\u8be5\u7528\u54ea\u4e00\u4e2a\u5462\uff1f\u4e09\u7ef4\u56fe\u5f62\u4e2d\u7684\u6cd5\u7ebf\u662f\u7528\u4e8e\u5149\u7167\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u9762\u5411\u5149\u6e90\u7684\u6cd5\u7ebf\u3002\u6362\u8a00\u4e4b\uff0c\u6211\u4eec\u5e94\u8be5\u9009\u62e9\u6307\u5411\u6a21\u578b\u5916\u7684\u6cd5\u7ebf\u3002 \u6211\u4eec\u6709\u4e00\u4e2a\u7531\u591a\u8fb9\u5f62\u548c\u4e09\u89d2\u5f62\u7ec4\u6210\u76843D\u6a21\u578b\uff0c\u6bcf\u4e2a\u4e09\u89d2\u5f62\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\uff0c\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u5411\u91cf\u662f\u5782\u76f4\u4e8e\u4e09\u89d2\u5f62\u8868\u9762\u7684\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002 \u9876\u70b9\u6cd5\u7ebf\u4e0e\u7279\u5b9a\u9876\u70b9\u76f8\u5173\u8054\uff0c\u5e76\u4e14\u662f\u5468\u56f4\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff08\u5f53\u7136\u5b83\u7684\u957f\u5ea6\u7b49\u4e8e1\uff09\u3002\u5728\u8fd9\u91cc\u4f60\u53ef\u4ee5\u770b\u5230\u4e00\u4e2a3D\u7f51\u683c\u7684\u9876\u70b9\u6a21\u578b\uff08\u53d6\u81ea \u7ef4\u57fa\u767e\u79d1 \uff09 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u521b\u5efaOBJ\u52a0\u8f7d\u5668\u3002\u9996\u5148\uff0c\u6211\u4eec\u5c06\u4fee\u6539 Mesh \u7c7b\uff0c\u56e0\u4e3a\u73b0\u5728\u5fc5\u987b\u4f7f\u7528\u7eb9\u7406\u3002\u6211\u4eec\u53ef\u80fd\u52a0\u8f7d\u4e00\u4e9b\u6ca1\u6709\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\u7684OBJ\u6587\u4ef6\uff0c\u56e0\u6b64\u5fc5\u987b\u80fd\u591f\u4f7f\u7528\u989c\u8272\u800c\u4e0d\u662f\u4f7f\u7528\u7eb9\u7406\u6e32\u67d3\u5b83\u4eec\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u7684\u5b9a\u4e49\u683c\u5f0f\u4e3a\uff1a f v/n \u3002 Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u540d\u4e3a colour \u7684\u65b0\u5c5e\u6027\u3002 private Vector3f colour; \u5e76\u4e14\u6784\u9020\u51fd\u6570\u4e0d\u518d\u9700\u8981 Texture \u3002\u53d6\u800c\u4ee3\u4e4b\u7684\u662f\uff0c\u6211\u4eec\u5c06\u4e3a\u7eb9\u7406\u548c\u989c\u8272\u5c5e\u6027\u63d0\u4f9b get \u548c set \u65b9\u6cd5\u3002 public Mesh(float[] positions, float[] textCoords, float[] normals, int[] indices) { \u5f53\u7136\uff0c\u5728 render \u548c clear \u65b9\u6cd5\u4e2d\uff0c\u5728\u4f7f\u7528\u7eb9\u7406\u4e4b\u524d\uff0c\u5fc5\u987b\u68c0\u67e5\u7eb9\u7406\u662f\u5426\u4e3a null \u3002\u6b63\u5982\u4f60\u5728\u6784\u9020\u51fd\u6570\u4e2d\u770b\u5230\u7684\uff0c\u73b0\u5728\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u540d\u4e3a normals \u7684\u65b0\u6d6e\u70b9\u6570\u7ec4\u3002\u5982\u4f55\u4f7f\u7528\u6cd5\u7ebf\u6e32\u67d3\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u5b83\u53ea\u662fVAO\u4e2d\u7684\u53e6\u4e00\u4e2aVBO\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u5982\u4e0b\u4ee3\u7801\uff1a // \u9876\u70b9\u6cd5\u7ebfVBO vboId = glGenBuffers(); vboIdList.add(vboId); vecNormalsBuffer = MemoryUtil.memAllocFloat(normals.length); vecNormalsBuffer.put(normals).flip(); glBindBuffer(GL_ARRAY_BUFFER, vboId); glBufferData(GL_ARRAY_BUFFER, vecNormalsBuffer, GL_STATIC_DRAW); glEnableVertexAttribArray(2); glVertexAttribPointer(2, 3, GL_FLOAT, false, 0, 0); \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b8c\u6210\u4e86\u5bf9 Mesh \u7c7b\u7684\u4fee\u6539\uff0c\u53ef\u4ee5\u4fee\u6539\u4ee3\u7801\u6765\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6216\u56fa\u5b9a\u7684\u989c\u8272\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u50cf\u8fd9\u6837\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\uff1a #version 330 in vec2 outTexCoord; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 colour; uniform int useColour; void main() { if ( useColour == 1 ) { fragColor = vec4(colour, 1); } else { fragColor = texture(texture_sampler, outTexCoord); } } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e24\u4e2a\u65b0Uniform\uff1a colour : \u5c06\u50a8\u5b58\u57fa\u672c\u989c\u8272\u3002 useColour : \u8fd9\u662f\u4e2a\u6807\u5fd7\uff0c\u5f53\u4f60\u4e0d\u60f3\u4f7f\u7528\u7eb9\u7406\u65f6\uff0c\u5b83\u5c06\u88ab\u8bbe\u7f6e\u4e3a1\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u8fd9\u4e24\u4e2aUniform\u3002 // \u4e3a\u9ed8\u8ba4\u989c\u8272\u4e0e\u63a7\u5236\u5b83\u7684\u6807\u5fd7\u521b\u5efaUniform shaderProgram.createUniform(\"colour\"); shaderProgram.createUniform(\"useColour\"); \u548c\u5176\u4ed6Uniform\u4e00\u6837\uff0c\u5728 Renderer \u7c7b\u7684 render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e5f\u9700\u8981\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\u3002 for(GameItem gameItem : gameItems) { Mesh mesh = gameItem.getMesh(); // \u4e3a\u8be5\u6e38\u620f\u9879\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635 Matrix4f modelViewMatrix = transformation.getModelViewMatrix(gameItem, viewMatrix); shaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); // \u4e3a\u8be5\u6e38\u620f\u9879\u6e32\u67d3\u7f51\u683c shaderProgram.setUniform(\"colour\", mesh.getColour()); shaderProgram.setUniform(\"useColour\", mesh.isTextured() ? 0 : 1); mesh.render(); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a OBJLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u89e3\u6790OBJ\u6587\u4ef6\uff0c\u5e76\u7528\u5176\u4e2d\u5305\u542b\u7684\u6570\u636e\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u3002\u4f60\u53ef\u80fd\u4f1a\u5728\u7f51\u4e0a\u53d1\u73b0\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\u53ef\u80fd\u6bd4\u8fd9\u66f4\u6709\u6548\uff0c\u4f46\u6211\u8ba4\u4e3a\u8be5\u65b9\u6848\u66f4\u5bb9\u6613\u7406\u89e3\u3002\u8fd9\u662f\u4e00\u4e2a\u5de5\u5177\u7c7b\uff0c\u5b83\u5c06\u6709\u5982\u4e0b\u9759\u6001\u65b9\u6cd5\uff1a public static Mesh loadMesh(String fileName) throws Exception { \u53c2\u6570 fileName \u6307\u5b9aOBJ\u6a21\u578b\u7684\u6587\u4ef6\u540d\u79f0\uff0c\u8be5\u6587\u4ef6\u5fc5\u987b\u5305\u542b\u5728\u7c7b\u8def\u5f84\u4e2d\u3002 \u5728\u8be5\u65b9\u6cd5\u4e2d\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u8bfb\u53d6\u6587\u4ef6\u5185\u5bb9\u5e76\u5c06\u6240\u6709\u884c\u50a8\u5b58\u5230\u4e00\u4e2a\u6570\u7ec4\u4e2d\uff0c\u7136\u540e\u521b\u5efa\u51e0\u4e2a\u5217\u8868\u6765\u50a8\u5b58\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u9762\u3002 List<String> lines = Utils.readAllLines(fileName); List<Vector3f> vertices = new ArrayList<>(); List<Vector2f> textures = new ArrayList<>(); List<Vector3f> normals = new ArrayList<>(); List<Face> faces = new ArrayList<>(); \u7136\u540e\u89e3\u6790\u6bcf\u4e00\u884c\uff0c\u5e76\u6839\u636e\u5f00\u5934\u6807\u8bc6\u7b26\u5f97\u5230\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u9876\u70b9\u6cd5\u7ebf\u6216\u9762\u5b9a\u4e49\uff0c\u6700\u540e\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 for (String line : lines) { String[] tokens = line.split(\"\\\\s+\"); switch (tokens[0]) { case \"v\": // \u51e0\u4f55\u9876\u70b9 Vector3f vec3f = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); vertices.add(vec3f); break; case \"vt\": // \u7eb9\u7406\u5750\u6807 Vector2f vec2f = new Vector2f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2])); textures.add(vec2f); break; case \"vn\": // \u9876\u70b9\u6cd5\u7ebf Vector3f vec3fNorm = new Vector3f( Float.parseFloat(tokens[1]), Float.parseFloat(tokens[2]), Float.parseFloat(tokens[3])); normals.add(vec3fNorm); break; case \"f\": Face face = new Face(tokens[1], tokens[2], tokens[3]); faces.add(face); break; default: // \u5ffd\u7565\u5176\u4ed6\u884c break; } } return reorderLists(vertices, textures, normals, faces); \u5728\u8bb2\u89e3\u91cd\u65b0\u6392\u5e8f\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u5982\u4f55\u89e3\u6790\u9762\u7684\u5b9a\u4e49\u3002\u6211\u4eec\u5df2\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Face \u7684\u7c7b\uff0c\u5b83\u8d1f\u8d23\u89e3\u6790\u4e00\u4e2a\u9762\u7684\u5b9a\u4e49\u3002\u4e00\u4e2a Face \u662f\u7531\u4e00\u4e2a\u7d22\u5f15\u7ec4\u5217\u8868\u7ec4\u6210\u7684\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u5904\u7406\u7684\u662f\u4e09\u89d2\u5f62\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u6709\u4e09\u4e2a\u7d22\u5f15\u7ec4\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u53e6\u4e00\u4e2a\u540d\u4e3a IndexGroup \u7684\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u7d22\u5f15\u7ec4\u7684\u6570\u636e\u3002 protected static class IdxGroup { public static final int NO_VALUE = -1; public int idxPos; public int idxTextCoord; public int idxVecNormal; public IdxGroup() { idxPos = NO_VALUE; idxTextCoord = NO_VALUE; idxVecNormal = NO_VALUE; } } Face \u7c7b\u5982\u4e0b\u6240\u793a\uff1a protected static class Face { /** * \u9762\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u7ec4\u5217\u8868\uff08\u6bcf\u4e2a\u9762\u4e09\u4e2a\u9876\u70b9\uff09\u3002 */ private IdxGroup[] idxGroups = new IdxGroup[3]; public Face(String v1, String v2, String v3) { idxGroups = new IdxGroup[3]; // \u89e3\u6790\u884c idxGroups[0] = parseLine(v1); idxGroups[1] = parseLine(v2); idxGroups[2] = parseLine(v3); } private IdxGroup parseLine(String line) { IdxGroup idxGroup = new IdxGroup(); String[] lineTokens = line.split(\"/\"); int length = lineTokens.length; idxGroup.idxPos = Integer.parseInt(lineTokens[0]) - 1; if (length > 1) { // \u5982\u679cOBJ\u4e0d\u5b9a\u4e49\u7eb9\u7406\u5750\u6807\uff0c\u5219\u53ef\u4e3anull String textCoord = lineTokens[1]; idxGroup.idxTextCoord = textCoord.length() > 0 ? Integer.parseInt(textCoord) - 1 : IdxGroup.NO_VALUE; if (length > 2) { idxGroup.idxVecNormal = Integer.parseInt(lineTokens[2]) - 1; } } return idxGroup; } public IdxGroup[] getFaceVertexIndices() { return idxGroups; } } \u5f53\u89e3\u6790\u9762\u65f6\uff0c\u6211\u4eec\u53ef\u4ee5\u770b\u5230\u6ca1\u6709\u7eb9\u7406\u4f46\u5e26\u6709\u77e2\u91cf\u6cd5\u7ebf\u7684\u5bf9\u8c61\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9762\u5b9a\u4e49\u53ef\u80fd\u50cf f 11//1 17//1 13//1 \u8fd9\u6837\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8fd9\u4e9b\u60c5\u51b5\u3002 \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u91cd\u65b0\u6392\u5217\u8fd9\u4e9b\u6570\u636e\u3002 Mesh \u7c7b\u9700\u8981\u56db\u4e2a\u6570\u7ec4\uff0c\u5206\u522b\u7528\u4e8e\u4f4d\u7f6e\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u77e2\u91cf\u548c\u7d22\u5f15\u3002\u524d\u4e09\u4e2a\u6570\u7ec4\u5e94\u8be5\u5177\u6709\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\uff0c\u56e0\u4e3a\u7d22\u5f15\u6570\u7ec4\u662f\u552f\u4e00\u7684\uff08\u6ce8\u610f\uff0c\u76f8\u540c\u6570\u91cf\u7684\u5143\u7d20\u5e76\u4e0d\u610f\u5473\u7740\u76f8\u540c\u7684\u957f\u5ea6\u3002\u9876\u70b9\u5750\u6807\u662f\u4e09\u7ef4\u7684\uff0c\u7531\u4e09\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u3002\u7eb9\u7406\u5750\u6807\u662f\u4e8c\u7ef4\u7684\uff0c\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\uff09\u3002OpenGL\u4e0d\u5141\u8bb8\u6211\u4eec\u5bf9\u6bcf\u4e2a\u5143\u7d20\u7c7b\u578b\u5b9a\u4e49\u4e0d\u540c\u7684\u7d22\u5f15\u6570\u7ec4\uff08\u5982\u679c\u53ef\u4ee5\u7684\u8bdd\uff0c\u6211\u4eec\u5c31\u4e0d\u9700\u8981\u5728\u5e94\u7528\u7eb9\u7406\u65f6\u91cd\u590d\u9876\u70b9\uff09\u3002 \u5f53\u4f60\u6253\u5f00\u4e00\u4e2aOBJ\u6587\u4ef6\u65f6\uff0c\u4f60\u9996\u5148\u53ef\u80fd\u4f1a\u770b\u5230\u50a8\u5b58\u9876\u70b9\u5750\u6807\u7684\u5217\u8868\uff0c\u6bd4\u50a8\u5b58\u7eb9\u7406\u5750\u6807\u548c\u9876\u70b9\u6570\u91cf\u7684\u5217\u8868\u7684\u5143\u7d20\u6570\u91cf\u66f4\u591a\u3002\u8fd9\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u95ee\u9898\u3002\u4e3e\u4e00\u4e2a\u7b80\u5355\u7684\u4f8b\u5b50\uff0c\u5b9a\u4e49\u4e00\u4e2a\u5177\u6709\u50cf\u7d20\u9ad8\u5ea6\u7684\u6b63\u65b9\u5f62\uff08\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\uff0c\u5176OBJ\u6587\u4ef6\u53ef\u80fd\u662f\u8fd9\u6837\u7684\uff08\u4e0d\u8981\u592a\u5173\u6ce8\u6cd5\u7ebf\u5750\u6807\uff0c\u56e0\u4e3a\u5b83\u53ea\u662f\u4e3a\u4e86\u6f14\u793a\uff09\u3002 v 0 0 0 v 1 0 0 v 1 1 0 v 0 1 0 vt 0 1 vt 1 1 vn 0 0 1 f 1/2/1 2/1/1 3/2/1 f 1/2/1 3/2/1 4/1/1 \u5f53\u5b8c\u6210\u5bf9\u6587\u4ef6\u7684\u89e3\u6790\u65f6\uff0c\u6211\u4eec\u5f97\u5230\u5982\u4e0b\u6240\u793a\u5217\u8868\uff08\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b57\u662f\u5b83\u5728\u6587\u4ef6\u4e2d\u7684\u4f4d\u7f6e\u987a\u5e8f\uff0c\u6309\u51fa\u73b0\u987a\u5e8f\u6392\u5217\uff09\uff1a \u73b0\u5728\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u5b9a\u4e49\u6765\u521b\u5efa\u5305\u542b\u7d22\u5f15\u7684\u6700\u7ec8\u6570\u7ec4\u3002\u9700\u8981\u8003\u8651\u7684\u662f\uff0c\u7eb9\u7406\u5750\u6807\u4e0e\u6cd5\u7ebf\u5411\u91cf\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0e\u9876\u70b9\u7684\u5b9a\u4e49\u987a\u5e8f\u4e0d\u5bf9\u5e94\u3002\u5982\u679c\u5217\u8868\u7684\u5927\u5c0f\u662f\u76f8\u540c\u7684\u5e76\u6709\u5e8f\u7684\uff0c\u90a3\u4e48\u9762\u5b9a\u4e49\u5c31\u53ea\u9700\u8981\u6bcf\u4e2a\u9876\u70b9\u4e00\u4e2a\u7d22\u5f15\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6392\u5217\u6570\u636e\uff0c\u5e76\u6839\u636e\u9700\u8981\u8fdb\u884c\u76f8\u5e94\u7684\u8bbe\u7f6e\u3002\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e09\u4e2a\u6570\u7ec4\uff08\u7528\u4e8e\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u6cd5\u7ebf\uff09\u548c\u4e00\u4e2a\u7d22\u5f15\u5217\u8868\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u4e09\u4e2a\u6570\u7ec4\u5143\u7d20\u6570\u91cf\u76f8\u540c\uff08\u7b49\u4e8e\u9876\u70b9\u6570\uff09\uff0c\u9876\u70b9\u6570\u7ec4\u5c06\u662f\u9876\u70b9\u5217\u8868\u7684\u526f\u672c\u3002 \u73b0\u5728\u6211\u4eec\u5f00\u59cb\u5904\u7406\u8fd9\u4e9b\u9762\u3002\u7b2c\u4e00\u4e2a\u9762\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u7ec4\u662f1/2/1\u3002\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\uff08\u5b9a\u4e49\u51e0\u4f55\u9876\u70b9\u7684\u7d22\u5f15\uff09\u6765\u6784\u9020\u7d22\u5f15\u5217\u8868\uff0c\u79f0\u4e4b\u4e3a posIndex \u3002 \u9762\u6307\u5b9a\u6211\u4eec\u5e94\u8be5\u628a\u5360\u636e\u7b2c\u4e00\u4e2a\u4f4d\u7f6e\u7684\u5143\u7d20\u7684\u7d22\u5f15\u6dfb\u52a0\u5230\u7d22\u5f15\u5217\u8868\u4e2d\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06 posIndex \u51cf\u53bb1\u540e\u653e\u5230 indicesList \u4e2d\uff08\u5fc5\u987b\u51cf1\uff0c\u56e0\u4e3a\u6570\u7ec4\u7684\u8d77\u59cb\u662f0\uff0c\u800cOBJ\u6587\u4ef6\u683c\u5f0f\u4e2d\u8d77\u59cb\u662f1\uff09\u3002 \u7136\u540e\uff0c\u6211\u4eec\u4f7f\u7528\u7d22\u5f15\u7ec4\u7684\u5176\u4ed6\u7d22\u5f15\u6765\u8bbe\u7f6e texturesArray \u548c normalsArray \u3002\u7d22\u5f15\u7ec4\u4e2d\u7684\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u662f2\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u5c06\u7b2c\u4e8c\u4e2a\u7eb9\u7406\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u7136\u540e\u6211\u4eec\u770b\u5230\u7b2c\u4e09\u4e2a\u7d22\u5f15\uff0c\u5b83\u4e3a1\uff0c\u6240\u4ee5\u8981\u505a\u7684\u662f\u5c06\u7b2c\u4e00\u4e2a\u6cd5\u7ebf\u5411\u91cf\u5750\u6807\u653e\u5728\u4e0e\u6240\u5360\u9876\u70b9\u6307\u5b9a\u7684 posIndex \u4f4d\u7f6e\uff08V1\uff09\u76f8\u540c\u7684\u4f4d\u7f6e\u4e0a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e00\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u5728\u5904\u7406\u4e86\u7b2c\u4e8c\u4e2a\u9762\u4e4b\u540e\uff0c\u6570\u7ec4\u548c\u5217\u8868\u5982\u4e0b\u6240\u793a\u3002 \u7b2c\u4e8c\u4e2a\u9762\u4e5f\u5b9a\u4e49\u4e86\u5df2\u7ecf\u88ab\u8d4b\u503c\u7684\u9876\u70b9\uff0c\u4f46\u662f\u5b83\u4eec\u6709\u76f8\u540c\u7684\u503c\uff0c\u6240\u4ee5\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u4e0a\u5f88\u7b80\u5355\u3002\u6211\u89c9\u5f97\u8fd9\u4e2a\u8fc7\u7a0b\u5df2\u7ecf\u8bb2\u89e3\u5f97\u8db3\u591f\u6e05\u6670\u4e86\uff0c\u4e0d\u8fc7\u5728\u4f60\u660e\u767d\u4e4b\u524d\u53ef\u80fd\u4f1a\u6709\u4e9b\u68d8\u624b\u3002\u91cd\u65b0\u6392\u5217\u6570\u636e\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\u3002\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u8981\u7684\u662f\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u5fc5\u987b\u628a\u9876\u70b9\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u7ec4\u8f6c\u6362\u4e3a\u6d6e\u70b9\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u5bf9\u4e8e\u9876\u70b9\u548c\u6cd5\u7ebf\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee53\uff0c\u800c\u5bf9\u4e8e\u7eb9\u7406\u5750\u6807\u6765\u8bf4\u6570\u7ec4\u7684\u957f\u5ea6\u662f\u9876\u70b9\u5217\u8868\u7684\u957f\u5ea6\u4e58\u4ee52\u3002 private static Mesh reorderLists(List<Vector3f> posList, List<Vector2f> textCoordList, List<Vector3f> normList, List<Face> facesList) { List<Integer> indices = new ArrayList<>(); // \u6309\u58f0\u660e\u7684\u987a\u5e8f\u521b\u5efa\u4f4d\u7f6e\u6570\u7ec4 float[] posArr = new float[posList.size() * 3]; int i = 0; for (Vector3f pos : posList) { posArr[i * 3] = pos.x; posArr[i * 3 + 1] = pos.y; posArr[i * 3 + 2] = pos.z; i++; } float[] textCoordArr = new float[posList.size() * 2]; float[] normArr = new float[posList.size() * 3]; for (Face face : facesList) { IdxGroup[] faceVertexIndices = face.getFaceVertexIndices(); for (IdxGroup indValue : faceVertexIndices) { processFaceVertex(indValue, textCoordList, normList, indices, textCoordArr, normArr); } } int[] indicesArr = new int[indices.size()]; indicesArr = indices.stream().mapToInt((Integer v) -> v).toArray(); Mesh mesh = new Mesh(posArr, textCoordArr, normArr, indicesArr); return mesh; } private static void processFaceVertex(IdxGroup indices, List<Vector2f> textCoordList, List<Vector3f> normList, List<Integer> indicesList, float[] texCoordArr, float[] normArr) { // \u8bbe\u7f6e\u9876\u70b9\u5750\u6807\u7684\u7d22\u5f15 int posIndex = indices.idxPos; indicesList.add(posIndex); // \u5bf9\u7eb9\u7406\u5750\u6807\u91cd\u65b0\u6392\u5e8f if (indices.idxTextCoord >= 0) { Vector2f textCoord = textCoordList.get(indices.idxTextCoord); texCoordArr[posIndex * 2] = textCoord.x; texCoordArr[posIndex * 2 + 1] = 1 - textCoord.y; } if (indices.idxVecNormal >= 0) { // \u5bf9\u6cd5\u7ebf\u5411\u91cf\u91cd\u65b0\u6392\u5e8f Vector3f vecNorm = normList.get(indices.idxVecNormal); normArr[posIndex * 3] = vecNorm.x; normArr[posIndex * 3 + 1] = vecNorm.y; normArr[posIndex * 3 + 2] = vecNorm.z; } } \u6b64\u5916\u9700\u8981\u6ce8\u610f\u7684\u662f\u7eb9\u7406\u5750\u6807\u662fUV\u683c\u5f0f\uff0c\u6240\u4ee5Y\u5750\u6807\u4e3a\u7528\u4e00\u51cf\u53bb\u6587\u4ef6\u4e2d\u53d6\u5230\u7684\u503c\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6e32\u67d3OBJ\u6a21\u578b\u3002\u6211\u51c6\u5907\u4e86\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u662f\u6b64\u524d\u7ae0\u8282\u4e2d\u4f7f\u7528\u8fc7\u7684\u5177\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002\u4e3a\u4e86\u5728 DummyGame \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002 Texture texture = new Texture(\"/textures/grassblock.png\"); mesh.setTexture(texture); GameItem gameItem = new GameItem(mesh); gameItem.setScale(0.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u7136\u540e\u5c06\u4f1a\u5f97\u5230\u4e00\u4e2a\u719f\u6089\u7684\u6709\u7eb9\u7406\u7684\u7acb\u65b9\u4f53\u3002 \u6211\u4eec\u53ef\u4ee5\u5c1d\u8bd5\u6e32\u67d3\u5176\u4ed6\u6a21\u578b\uff0c\u4f8b\u5982\u53ef\u4ee5\u4f7f\u7528\u8457\u540d\u7684Stanford Bunny\u6a21\u578b\uff08\u5b83\u53ef\u4ee5\u514d\u8d39\u4e0b\u8f7d\uff09\uff0c\u5b83\u653e\u5728resources\u6587\u4ef6\u5939\u4e2d\u3002\u8fd9\u4e2a\u6a21\u578b\u6ca1\u6709\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u505a\uff1a Mesh mesh = OBJLoader.loadMesh(\"/models/bunny.obj\"); GameItem gameItem = new GameItem(mesh); gameItem.setScale(1.5f); gameItem.setPosition(0, 0, -2); gameItems = new GameItem[]{gameItem}; \u8fd9\u4e2a\u6a21\u578b\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u56e0\u4e3a\u6ca1\u6709\u7eb9\u7406\u4e5f\u6ca1\u6709\u5149\uff0c\u6240\u4ee5\u6211\u4eec\u4e0d\u80fd\u770b\u5230\u5b83\u7684\u4f53\u79ef\uff0c\u4f46\u662f\u4f60\u53ef\u4ee5\u68c0\u67e5\u6a21\u578b\u662f\u5426\u6b63\u786e\u5730\u52a0\u8f7d\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u8bbe\u7f6eOpenGL\u53c2\u6570\u65f6\uff0c\u6dfb\u52a0\u8fd9\u4e00\u884c\u4ee3\u7801\u3002 glPolygonMode( GL_FRONT_AND_BACK, GL_LINE ); \u5f53\u4f60\u653e\u5927\u7684\u65f6\u5019\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\u3002 \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6784\u6210\u6a21\u578b\u7684\u6240\u6709\u4e09\u89d2\u5f62\u3002 \u6709\u4e86\u8fd9\u4e2aOBJ\u8f7d\u5165\u7c7b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u4f7f\u7528Blender\u521b\u5efa\u6a21\u578b\u3002Blender\u662f\u4e00\u4e2a\u5f3a\u5927\u7684\u5de5\u5177\uff0c\u4f46\u521a\u5f00\u59cb\u4f7f\u7528\u5b83\u6709\u70b9\u56f0\u96be\uff0c\u5b83\u6709\u5f88\u591a\u9009\u9879\uff0c\u5f88\u591a\u5173\u8282\u7ec4\u5408\uff0c\u5728\u9996\u6b21\u4f7f\u7528\u5b83\u65f6\u4f60\u9700\u8981\u82b1\u65f6\u95f4\u505a\u5f88\u591a\u6700\u57fa\u672c\u7684\u4e8b\u60c5\u3002\u5f53\u4f7f\u7528Blender\u5bfc\u51fa\u6a21\u578b\u65f6\uff0c\u8bf7\u786e\u4fdd\u5305\u542b\u6cd5\u7ebf\u5e76\u5c06\u9762\u5bfc\u51fa\u4e3a\u4e09\u89d2\u5f62\u3002 \u5bfc\u51fa\u65f6\u8bf7\u8bb0\u5f97\u5206\u5272\u8fb9\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u80fd\u5c06\u591a\u4e2a\u7eb9\u7406\u5750\u6807\u6307\u5b9a\u7ed9\u540c\u4e00\u4e2a\u9876\u70b9\u3002\u6b64\u5916\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u4e2a\u4e09\u89d2\u5f62\u5b9a\u4e49\u6cd5\u7ebf\uff0c\u800c\u4e0d\u662f\u6307\u5b9a\u7ed9\u9876\u70b9\u3002\u5982\u679c\u4f60\u5728\u67d0\u4e9b\u6a21\u578b\u4e2d\u9047\u5230\u4e86\u5149\u7167\u95ee\u9898\uff08\u5728\u4e0b\u4e00\u7ae0\u4e2d\uff09\uff0c\u4f60\u5e94\u8be5\u9a8c\u8bc1\u4e00\u4e0b\u6cd5\u7ebf\u3002\u4f60\u53ef\u4ee5\u5728Blender\u4e2d\u770b\u5230\u6cd5\u7ebf\u3002","title":"\u52a0\u8f7d\u66f4\u590d\u6742\u7684\u6a21\u578b\uff08Loading more complex models\uff09"},{"location":"10-let-there-be-light/","text":"\u8981\u6709\u5149\uff08Let there be light\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4e3a3D\u6e38\u620f\u5f15\u64ce\u6dfb\u52a0\u5149\u7167\u3002\u6211\u4eec\u4e0d\u4f1a\u53bb\u5b9e\u73b0\u4e00\u4e2a\u5b8c\u7f8e\u7684\u5149\u7167\u6a21\u578b\uff0c\u56e0\u4e3a\u629b\u5f00\u590d\u6742\u6027\u4e0d\u8c08\uff0c\u5b83\u8fd8\u9700\u8981\u6d88\u8017\u5927\u91cf\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u76f8\u53cd\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u8fd1\u4f3c\u7684\u3001\u50cf\u6837\u7684\u5149\u7167\u6548\u679c\uff1a\u6211\u4eec\u5c06\u4f7f\u7528\u540d\u4e3a Phong \u7684\u7740\u8272\u7b97\u6cd5\uff08\u7531Bui Tuong Phong\u5f00\u53d1\uff09\u3002\u53e6\u4e00\u4e2a\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u5c06\u53ea\u6a21\u62df\u5149\u7167\uff0c\u4f46\u4e0d\u4f1a\u6a21\u62df\u8fd9\u4e9b\u5149\u7167\u6240\u4ea7\u751f\u7684\u9634\u5f71\uff08\u8fd9\u5c06\u5728\u540e\u7eed\u7ae0\u8282\u4e2d\u5b9e\u73b0\uff09\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5148\u5b9a\u4e49\u51e0\u4e2a\u5149\u7167\u7c7b\u578b\uff1a \u70b9\u5149\u6e90\uff08Point Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u6a21\u62df\u5149\u7167\uff0c\u6211\u4eec\u9700\u8981\u8003\u8651\u5149\u7167\u7684\u7c7b\u578b\u3001\u4f4d\u7f6e\u548c\u5176\u4ed6\u4e00\u4e9b\u53c2\u6570\uff0c\u5982\u989c\u8272\u3002\u5f53\u7136\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u8003\u8651\u7269\u4f53\u5982\u4f55\u53d7\u5149\u7167\u5f71\u54cd\u5438\u6536\u548c\u53cd\u5c04\u5149\u3002 Phong\u7740\u8272\u7b97\u6cd5\u5c06\u6a21\u62df\u5149\u7ebf\u5bf9\u6211\u4eec\u6a21\u578b\u4e2d\u6bcf\u4e2a\u70b9\u7684\u5f71\u54cd\uff0c\u5373\u5bf9\u6bcf\u4e2a\u9876\u70b9\u7684\u5f71\u54cd\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u88ab\u79f0\u4e3a\u5c40\u90e8\u5149\u7167\u6a21\u578b\u7684\u539f\u56e0\uff0c\u8fd9\u4e5f\u662f\u8be5\u7b97\u6cd5\u4e0d\u80fd\u8ba1\u7b97\u9634\u5f71\u7684\u539f\u56e0\uff1a\u5b83\u53ea\u4f1a\u8ba1\u7b97\u5e94\u7528\u5230\u6bcf\u4e2a\u9876\u70b9\u7684\u5149\u7167\uff0c\u800c\u4e0d\u8003\u8651\u9876\u70b9\u662f\u5426\u4f4d\u4e8e\u906e\u5149\u7269\u4f53\u4e4b\u540e\u3002\u6211\u4eec\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u3002\u4f46\u6b63\u56e0\u5982\u6b64\uff0c\u5b83\u662f\u4e00\u79cd\u975e\u5e38\u7b80\u5355\u5feb\u901f\u7684\u7b97\u6cd5\uff0c\u5e76\u4e14\u53ef\u4ee5\u63d0\u4f9b\u975e\u5e38\u597d\u7684\u6548\u679c\u3002\u6211\u4eec\u5c06\u5728\u6b64\u5b9e\u73b0\u4e00\u4e2a\u6ca1\u6709\u6df1\u5165\u8003\u8651\u6750\u8d28\u5f71\u54cd\u7684\u7b80\u5316\u7248\u672c\u3002 Phong\u7b97\u6cd5\u63d0\u4f9b\u4e86\u4e09\u79cd\u5149\u7167\u5206\u91cf\uff1a \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u6a21\u62df\u6765\u81ea\u4efb\u4f55\u65b9\u5411\u7684\u5149\u7167\uff0c\u5b83\u5c06\u7167\u4eae\uff08\u9700\u8981\u5bf9\u5e94\u5f3a\u5ea6\u503c\uff09\u672a\u53d7\u4efb\u4f55\u5149\u7ebf\u7167\u5c04\u7684\u533a\u57df\uff0c\u5c31\u50cf\u80cc\u666f\u5149\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09 \uff1a\u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09 \uff1a\u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 \u6700\u540e\uff0c\u6211\u4eec\u8981\u5f97\u5230\u4e00\u4e2a\u56e0\u6570\uff0c\u5c06\u5b83\u4e0e\u6307\u5b9a\u7247\u5143\u7684\u989c\u8272\u76f8\u4e58\uff0c\u6839\u636e\u5b83\u6240\u53d7\u7684\u5149\u7167\u5c06\u8be5\u989c\u8272\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u4ee4 A \u4e3a\u73af\u5883\u5149\u3001 D \u4e3a\u6f2b\u53cd\u5c04\u5149\u3001 S \u4e3a\u955c\u9762\u53cd\u5c04\u5149\uff0c\u76ee\u6807\u56e0\u6570\u5c06\u662f\u4e0a\u8ff0\u5206\u91cf\u7684\u603b\u548c\uff1a L = A + D + S \u8fd9\u4e9b\u5206\u91cf\u5176\u5b9e\u5c31\u662f\u989c\u8272\uff0c\u4e5f\u5c31\u662f\u6bcf\u4e2a\u5149\u7167\u5206\u91cf\u6240\u8d21\u732e\u7684\u989c\u8272\u5206\u91cf\u3002\u8fd9\u662f\u56e0\u4e3a\u5149\u7167\u5206\u91cf\u4e0d\u4ec5\u4f1a\u63d0\u4f9b\u4e00\u5b9a\u7a0b\u5ea6\u7684\u4eae\u5ea6\uff0c\u8fd8\u4f1a\u6539\u53d8\u6a21\u578b\u7684\u989c\u8272\u3002\u5728\u6211\u4eec\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u53ea\u9700\u5c06\u8be5\u5149\u7167\u7684\u989c\u8272\u4e0e\u539f\u59cb\u7247\u5143\u989c\u8272\uff08\u4ece\u7eb9\u7406\u6216\u57fa\u8272\u83b7\u5f97\u7684\uff09\u76f8\u4e58\u5373\u53ef\u3002 \u6211\u4eec\u8fd8\u53ef\u4ee5\u4e3a\u76f8\u540c\u7684\u6750\u8d28\u6307\u5b9a\u4e0d\u540c\u7684\u989c\u8272\uff0c\u8fd9\u4e9b\u989c\u8272\u5c06\u7528\u4e8e\u73af\u5883\u5149\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002\u56e0\u6b64\uff0c\u8fd9\u4e9b\u5206\u91cf\u5c06\u7531\u6750\u8d28\u5173\u8054\u7684\u989c\u8272\u8c03\u6574\u3002\u5982\u679c\u6750\u8d28\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u5206\u91cf\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u3002 \u6240\u4ee5\u5bf9\u4e8e\u65e0\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u73af\u5883\u5149\u7684\u989c\u8272 + D * \u6f2b\u53cd\u5c04\u7684\u989c\u8272 + S * \u955c\u9762\u53cd\u5c04\u7684\u989c\u8272 \u5bf9\u4e8e\u6709\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u7eb9\u7406\u989c\u8272 + D * \u7eb9\u7406\u989c\u8272 + S * \u7eb9\u7406\u989c\u8272 \u73af\u5883\u5149\u5206\u91cf \u8ba9\u6211\u4eec\u6765\u770b\u770b\u7b2c\u4e00\u4e2a\u5206\u91cf\uff0c\u5373\u73af\u5883\u5149\u5206\u91cf\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u5e38\u91cf\uff0c\u4f1a\u4f7f\u6211\u4eec\u7684\u6240\u6709\u7269\u4f53\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5b83\u6765\u6a21\u62df\u4e00\u5929\u4e2d\u7279\u5b9a\u65f6\u95f4\u6bb5\u5185\u7684\u5149\u7167\uff08\u9ece\u660e\u3001\u9ec4\u660f\u7b49\uff09\uff0c\u4e5f\u53ef\u4ee5\u7528\u5b83\u6765\u6dfb\u52a0\u4e00\u4e9b\u4e0d\u76f4\u63a5\u88ab\u5149\u7ebf\u7167\u5c04\u5230\uff0c\u4f46\u53ef\u4ee5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u88ab\u95f4\u63a5\u5149\u7ebf\u7167\u5c04\uff08\u6bd4\u5982\u53cd\u5c04\uff09\u5230\u7684\u70b9\u7684\u5149\u7167\u3002 \u73af\u5883\u5149\u662f\u6700\u5bb9\u6613\u8ba1\u7b97\u7684\u5206\u91cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u4e00\u79cd\u989c\u8272\uff0c\u5b83\u5c06\u4e0e\u57fa\u8272\u76f8\u4e58\uff0c\u4ee5\u8c03\u6574\u8be5\u57fa\u8272\u3002\u5047\u5982\u6211\u4eec\u5df2\u7ecf\u786e\u5b9a\u7247\u5143\u7684\u989c\u8272\u662f (1.0, 0.0, 0.0) \uff0c\u5373\u7ea2\u8272\u3002\u5982\u679c\u6ca1\u6709\u73af\u5883\u5149\u65f6\uff0c\u5b83\u5c06\u663e\u793a\u4e3a\u5b8c\u5168\u7ea2\u8272\u7684\u7247\u5143\u3002\u5982\u679c\u6211\u4eec\u5c06\u73af\u5883\u5149\u8bbe\u7f6e\u4e3a (0.5, 0.5, 0.5) \uff0c\u5219\u6700\u7ec8\u989c\u8272\u5c06\u4e3a (0.5, 0.0, 0.0) \uff0c\u5176\u5b9e\u5c31\u662f\u53d8\u6697\u7684\u7ea2\u8272\u3002\u8fd9\u79cd\u5149\u7167\u4f1a\u4ee5\u76f8\u540c\u7684\u65b9\u5f0f\u4f7f\u6240\u6709\u7247\u5143\u53d8\u6697\uff08\u79f0\u5176\u4e3a\u4f7f\u7269\u4f53\u53d8\u6697\u7684\u5149\u4f3c\u4e4e\u6709\u70b9\u5947\u602a\uff0c\u4e8b\u5b9e\u4e0a\u8fd9\u5c31\u662f\u6211\u4eec\u5f97\u5230\u7684\u6548\u679c\uff09\u3002\u6b64\u5916\uff0c\u5982\u679c\u5149\u8272\u7684RGB\u5206\u91cf\u4e0d\u76f8\u540c\uff0c\u5b83\u8fd8\u53ef\u4ee5\u4e3a\u7247\u5143\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u77e2\u91cf\u6765\u8c03\u8282\u73af\u5883\u5149\u5f3a\u5ea6\u548c\u989c\u8272\u3002 \u6f2b\u53cd\u5c04 \u73b0\u5728\u6211\u4eec\u6765\u8c08\u8c08\u6f2b\u53cd\u5c04\uff0c\u5b83\u6a21\u62df\u4e86\u8fd9\u6837\u4e00\u4e2a\u73b0\u8c61\uff1a\u4e0e\u5149\u7ebf\u5782\u76f4\u7684\u9762\u770b\u8d77\u6765\u6bd4\u4ee5\u66f4\u63a5\u8fd1\u4e0e\u5149\u7ebf\u5e73\u884c\u7684\u89d2\u5ea6\u63a5\u6536\u5149\u7ebf\u7684\u9762\u66f4\u4eae\u3002\u4e00\u4e2a\u7269\u4f53\u63a5\u6536\u5230\u7684\u5149\u8d8a\u591a\uff0c\u5176\u5149\u5bc6\u5ea6\uff08\u5728\u6b64\u8fd9\u6837\u79f0\u547c\uff09\u5c31\u8d8a\u9ad8\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\uff1f\u4f60\u8fd8\u8bb0\u5f97\u4e0a\u4e00\u7ae0\u4e2d\u6211\u4eec\u4ecb\u7ecd\u8fc7\u7684\u6cd5\u7ebf\u7684\u6982\u5ff5\u5417\uff1f\u6cd5\u7ebf\u662f\u5782\u76f4\u4e8e\u5e73\u9762\u5e76\u4e14\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002\u56e0\u6b64\uff0c\u8ba9\u6211\u4eec\u4e3a\u4e0a\u56fe\u4e2d\u7684\u4e09\u4e2a\u70b9\u7684\u7ed8\u5236\u6cd5\u7ebf\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6bcf\u4e2a\u70b9\u7684\u6cd5\u7ebf\u5c06\u662f\u5782\u76f4\u4e8e\u6bcf\u4e2a\u70b9\u7684\u5207\u5e73\u9762\u7684\u5411\u91cf\u3002\u6211\u4eec\u4e0d\u7528\u7ed8\u5236\u6765\u81ea\u5149\u6e90\u7684\u5149\u7ebf\uff0c\u800c\u662f\u7ed8\u5236\u4ece\u6bcf\u4e2a\u70b9\u5230\u5149\u6e90\uff08\u5373\u76f8\u53cd\u7684\u65b9\u5411\uff09\u7684\u5411\u91cf\u3002 \u5982\u4f60\u6240\u89c1\uff0c P1 \u70b9\u7684\u6cd5\u7ebf N1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u8be5\u6cd5\u7ebf\u7684\u65b9\u5411\u4e0e\u5149\u7ebf\u7684\u65b9\u5411\u76f8\u53cd\uff08 N1 \u5df2\u88ab\u79fb\u52a8\uff0c\u4ee5\u4fbf\u4f60\u53ef\u4ee5\u770b\u5230\u5b83\uff0c\u4f46\u8fd9\u5728\u6570\u5b66\u4e0a\u662f\u7b49\u4ef7\u7684\uff09\u3002 P1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7b49\u4e8e 0 \u3002\u56e0\u4e3a\u5b83\u7684\u5207\u5e73\u9762\u5782\u76f4\u4e8e\u5149\u6e90\uff0c\u6240\u4ee5 P1 \u5c06\u662f\u6700\u4eae\u7684\u70b9\u3002 P2 \u70b9\u7684\u6cd5\u7ebf N2 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7ea6\u4e3a30\u5ea6\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u6bd4 P1 \u66f4\u6697\u3002\u6700\u540e\uff0c P3 \u7684\u6cd5\u7ebf N3 \u4e5f\u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u4f46\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\u3002 P3 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u7684\u89d2\u5ea6\u4e3a180\u5ea6\uff0c\u6240\u4ee5\u6839\u672c\u4e0d\u5e94\u8be5\u63a5\u6536\u5230\u4efb\u4f55\u5149\u7ebf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u4f3c\u4e4e\u5f97\u5230\u4e86\u4e00\u4e2a\u8ba1\u7b97\u67d0\u70b9\u7684\u5149\u7167\u5f3a\u5ea6\u7684\u597d\u65b9\u6cd5\uff0c\u5149\u5f3a\u4e0e\u8be5\u70b9\u7684\u6cd5\u7ebf\u548c\u8be5\u70b9\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u4e4b\u95f4\u7684\u5939\u89d2\u5927\u5c0f\u6709\u5173\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u8ba1\u7b97\u5b83\u5462\uff1f \u6709\u4e00\u4e2a\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u7684\u6570\u5b66\u8fd0\u7b97\u2014\u2014\u2014\u2014\u6570\u91cf\u79ef\uff08\u53c8\u79f0\u4e3a\u70b9\u79ef\uff09\u3002\u8be5\u8fd0\u7b97\u9700\u8981\u4e24\u4e2a\u5411\u91cf\u5e76\u5f97\u5230\u4e00\u4e2a\u6570\u5b57\uff08\u6807\u91cf\uff09\uff0c\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u8f83\u5c0f\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u6b63\u6570\uff1b\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u5f88\u5927\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u8d1f\u6570\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u88ab\u5f52\u4e00\u5316\uff0c\u5373\u4e24\u8005\u7684\u957f\u5ea6\u90fd\u7b49\u4e8e1\uff0c\u90a3\u4e48\u6570\u91cf\u79ef\u7684\u7ed3\u679c\u5c06\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u540c\uff08\u5373\u5939\u89d2\u4e3a 0 \uff09\uff0c\u5219\u6570\u91cf\u79ef\u4e3a1\uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u5939\u89d2\u4e3a\u76f4\u89d2\uff0c\u5219\u5b83\u7684\u503c\u4e3a 0 \uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\uff0c\u5219\u4e3a -1 \u3002 \u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u5411\u91cf\uff0c v1 \u548c v2 \uff0c\u5e76\u4ee5 \u03b1 \u4f5c\u4e3a\u5b83\u4eec\u4e4b\u95f4\u7684\u5939\u89d2\u3002\u6570\u91cf\u79ef\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a \u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u5f52\u4e00\u5316\uff0c\u5373\u5b83\u4eec\u7684\u957f\u5ea6\uff0c\u6216\u5b83\u4eec\u7684\u6a21\u957f\u7b49\u4e8e1\uff0c\u5b83\u4eec\u7684\u6570\u91cf\u79ef\u5373\u4e3a\u5939\u89d2\u7684\u4f59\u5f26\u503c\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u8fd0\u7b97\u6765\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff0c\u8be5\u600e\u4e48\u505a\u5462\uff1f\u5047\u5982\u6211\u4eec\u6709\u6bcf\u4e2a\u70b9\u7684\u4f4d\u7f6e\uff08\u5373\u9876\u70b9\u4f4d\u7f6e\uff09\u548c\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u9996\u5148\uff0c\u8fd9\u4e24\u4e2a\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u540c\u4e00\u4e2a\u5750\u6807\u7a7a\u95f4\u4e2d\u3002\u4e3a\u4e86\u7b80\u5316\uff0c\u6211\u4eec\u5047\u8bbe\u5b83\u4eec\u90fd\u5904\u4e8e\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\uff0c\u90a3\u4e48\u8fd9\u4e9b\u4f4d\u7f6e\u662f\u6307\u5411\u9876\u70b9\u4f4d\u7f6e\uff08 VP \uff09\u548c\u5149\u6e90\uff08 VS \uff09\u7684\u5411\u91cf\u7684\u5750\u6807\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u679c\u6211\u4eec\u4ece VP \u4e2d\u51cf\u53bb VS \uff0c\u5c31\u4f1a\u5f97\u5230\u6211\u4eec\u6240\u9700\u7684\u5411\u91cf\uff0c\u79f0\u4e3a L \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u6307\u5411\u5149\u6e90\u7684\u77e2\u91cf\u548c\u6cd5\u7ebf\u4e4b\u95f4\u505a\u6570\u91cf\u79ef\uff0c\u56e0\u4e3aJohann Lambert\u662f\u7b2c\u4e00\u4e2a\u63d0\u51fa\u8fd9\u79cd\u5173\u7cfb\u6765\u6a21\u62df\u5e73\u9762\u4eae\u5ea6\u7684\uff0c\u6240\u4ee5\u8be5\u4e58\u79ef\u88ab\u79f0\u4e3a\u5170\u4f2f\u7279\u9879\u3002 \u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\uff0c\u5b9a\u4e49\u4ee5\u4e0b\u53d8\u91cf\uff1a vPos \uff1a\u6211\u4eec\u7684\u9876\u70b9\u5728\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 lPos \uff1a\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5149\u6e90\u4f4d\u7f6e\u3002 intensity \uff1a\u5149\u7684\u5f3a\u5ea6\uff08\u4ece0\u52301\uff09\u3002 lCourour \uff1a\u5149\u7684\u989c\u8272\u3002 normal \uff1a\u9876\u70b9\u6cd5\u7ebf\u3002 \u9996\u5148\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4ece\u5f53\u524d\u4f4d\u7f6e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff1a toLightDirection = lPos - vPos \uff0c\u8be5\u8fd0\u7b97\u7684\u7ed3\u679c\u9700\u8981\u5f52\u4e00\u5316\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6f2b\u53cd\u5c04\u56e0\u6570\uff08\u6807\u91cf\uff09\uff1a diffuseFactor = normal \\cdot toLightDirection \u3002\u8ba1\u7b97\u4e24\u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\uff0c\u6211\u4eec\u5e0c\u671b\u503c\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u4e24\u4e2a\u5411\u91cf\u90fd\u9700\u8981\u5f52\u4e00\u5316\u3002\u989c\u8272\u9700\u8981\u4ecb\u4e8e 0 \u5230 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u503c\u4f4e\u4e8e 0 \uff0c\u6211\u4eec\u5c06\u5176\u8bbe\u4e3a 0 \u3002 \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u901a\u8fc7\u6f2b\u53cd\u5c04\u56e0\u6570\u548c\u5149\u7684\u5f3a\u5ea6\u6765\u8c03\u8282\u5149\u7684\u989c\u8272\uff1a color = diffuseColour * lColour * diffuseFactor * intensity \u955c\u9762\u53cd\u5c04 \u73b0\u5728\u770b\u5230\u955c\u9762\u53cd\u5c04\uff0c\u4f46\u9996\u5148\u6211\u4eec\u9700\u8981\u77e5\u9053\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002\u5f53\u5149\u7167\u5c04\u5230\u4e00\u4e2a\u8868\u9762\u65f6\uff0c\u5b83\u7684\u4e00\u90e8\u5206\u88ab\u5438\u6536\uff0c\u53e6\u4e00\u90e8\u5206\u88ab\u53cd\u5c04\uff0c\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u4f60\u7684\u7269\u7406\u8bfe\u77e5\u8bc6\uff0c\u53cd\u5c04\u5c31\u662f\u5149\u4ece\u7269\u4f53\u53cd\u5f39\u56de\u6765\u3002 \u5f53\u7136\uff0c\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u629b\u5149\u7684\uff0c\u5982\u679c\u4f60\u4ed4\u7ec6\u89c2\u5bdf\uff0c\u4f60\u4f1a\u770b\u5230\u5f88\u591a\u4e0d\u5e73\u6574\u7684\u5730\u65b9\u3002\u6b64\u5916\u8fd8\u6709\u8bb8\u591a\u5149\u7ebf\uff08\u5b9e\u9645\u4e0a\u662f\u5149\u5b50\uff09\uff0c\u4f1a\u649e\u51fb\u8fd9\u4e2a\u8868\u9762\uff0c\u5e76\u4e14\u4f1a\u4ee5\u4e0d\u540c\u7684\u89d2\u5ea6\u8fdb\u884c\u53cd\u5c04\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u770b\u5230\u7684\u5c31\u50cf\u662f\u4e00\u675f\u5149\u7167\u5c04\u8868\u9762\u5e76\u6563\u5c04\u56de\u6765\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5149\u5728\u649e\u51fb\u8868\u9762\u65f6\u4f1a\u53d1\u6563\uff0c\u8fd9\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8ba8\u8bba\u8fc7\u7684\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u4f46\u662f\uff0c\u5f53\u5149\u7ebf\u7167\u5c04\u629b\u5149\u8868\u9762\u65f6\uff0c\u4f8b\u5982\u91d1\u5c5e\uff0c\u5149\u7ebf\u4f1a\u53d7\u5230\u8f83\u4f4e\u7684\u6269\u6563\u5f71\u54cd\uff0c\u5e76\u4e14\u5728\u5b83\u649e\u5230\u8868\u9762\u65f6\uff0c\u5927\u90e8\u5206\u4f1a\u5411\u53cd\u65b9\u5411\u53cd\u5c04\u3002 \u8fd9\u5c31\u662f\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u6a21\u578b\uff0c\u5b83\u53d6\u51b3\u4e8e\u6750\u8d28\u5c5e\u6027\u3002\u5bf9\u4e8e\u955c\u9762\u53cd\u5c04\uff0c\u91cd\u8981\u7684\u662f\u53ea\u6709\u5f53\u6444\u50cf\u673a\u5904\u4e8e\u6070\u5f53\u7684\u4f4d\u7f6e\u65f6\uff0c\u5373\u53cd\u5c04\u5149\u7684\u53cd\u5c04\u533a\u57df\u5185\uff0c\u53cd\u5c04\u5149\u624d\u53ef\u89c1\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u4e86\u955c\u9762\u53cd\u5c04\u4e4b\u4e2d\u7684\u673a\u7406\uff0c\u6211\u4eec\u63a5\u4e0b\u6765\u51c6\u5907\u8ba1\u7b97\u8fd9\u4e2a\u5206\u91cf\u3002\u9996\u5148\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u4ece\u5149\u6e90\u6307\u5411\u9876\u70b9\u7684\u5411\u91cf\u3002\u5f53\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65b9\u5411\u4e0e\u4e4b\u76f8\u53cd\u7684\u5411\u91cf\uff0c\u5b83\u6307\u5411\u7684\u662f\u5149\u6e90\uff0c\u5373 toLightDirection \u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u8ba1\u7b97\u4e3a fromLightDirection = -(toLightDirection) \u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8003\u8651\u5230\u8868\u9762\u7684\u6cd5\u7ebf\uff0c\u6765\u8ba1\u7b97\u7531 fromLightDirection \u5c04\u51fa\u7684\u5149\u7ebf\u649e\u51fb\u8868\u9762\u6240\u4ea7\u751f\u7684\u53cd\u5c04\u5149\u3002\u6709\u4e00\u4e2a\u540d\u4e3a reflect \u7684GLSL\u51fd\u6570\u5b9e\u73b0\u4e86\u8be5\u529f\u80fd\u3002\u6240\u4ee5\uff0c reflectLight = reflect(fromLightSource, normal) \u3002 \u6211\u4eec\u8fd8\u9700\u8981\u4e00\u4e2a\u6307\u5411\u6444\u50cf\u673a\u7684\u5411\u91cf\uff0c\u5e76\u5c06\u5176\u547d\u540d\u4e3a cameraDirection \uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u6444\u50cf\u673a\u4f4d\u7f6e\u548c\u9876\u70b9\u4f4d\u7f6e\u4e4b\u95f4\u7684\u5dee\u503c\uff1a cameraDirection = cameraPos - vPos \u3002\u6444\u50cf\u673a\u4f4d\u7f6e\u5411\u91cf\u548c\u9876\u70b9\u4f4d\u7f6e\u9700\u8981\u5904\u4e8e\u76f8\u540c\u7684\u5750\u6807\u7cfb\u4e2d\uff0c\u5e76\u4e14\u5f97\u5230\u7684\u5411\u91cf\u9700\u8981\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u6982\u8ff0\u4e86\u6211\u4eec\u76ee\u524d\u8ba1\u7b97\u7684\u4e3b\u8981\u5206\u91cf\uff1a \u73b0\u5728\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5149\u5f3a\uff0c\u5373 specularFactor \u3002\u5982\u679c cameraDirection \u548c reflectLight \u5411\u91cf\u6307\u5411\u76f8\u540c\u7684\u65b9\u5411\uff0c\u8be5\u503c\u5c31\u8d8a\u9ad8\uff0c\u5982\u679c\u5b83\u4eec\u65b9\u5411\u76f8\u53cd\u5176\u503c\u5219\u8d8a\u4f4e\u3002\u4e3a\u4e86\u8ba1\u7b97\u8be5\u503c\u6211\u4eec\u5c06\u518d\u6b21\u8fd0\u7528\u6570\u91cf\u79ef\u3002 specularFactor = cameraDirection \\cdot reflectLight \u3002\u6211\u4eec\u53ea\u5e0c\u671b\u8be5\u503c\u4f4d\u4e8e 0 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u5b83\u4f4e\u4e8e 0 \uff0c\u5c31\u5c06\u5b83\u8bbe\u4e3a0\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u8003\u8651\u5230\uff0c\u5982\u679c\u6444\u50cf\u673a\u6307\u5411\u53cd\u5c04\u5149\u9525\uff0c\u5219\u8be5\u5149\u66f4\u5f3a\u70c8\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97 specularFactor \u7684 specularPower \u6b21\u5e42\u6765\u5b9e\u73b0\uff0c\u5176\u4e2d specularPower \u4e3a\u7ed9\u5b9a\u7684\u53c2\u6570\uff1a specularFactor = specularFactor^{specularPower} \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u6750\u8d28\u7684\u53cd\u5c04\u7387\u8fdb\u884c\u5efa\u6a21\uff0c\u5982\u679c\u5149\u7ebf\u53cd\u5c04\uff0c\u53cd\u5c04\u7387\u5c06\u8c03\u8282\u53cd\u5c04\u5149\u7684\u5f3a\u5ea6\uff0c\u8fd9\u5c06\u7528\u5230\u4e00\u4e2a\u540d\u4e3a reflectance \u7684\u53c2\u6570\u3002\u6240\u4ee5\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u4e3a\uff1a specularColour * lColour * reflectance * specularFactor * intensity \u8870\u51cf \u6211\u4eec\u73b0\u5728\u77e5\u9053\u5982\u4f55\u8ba1\u7b97\u8fd9\u4e09\u4e2a\u5206\u91cf\u4e86\uff0c\u8fd9\u4e9b\u5206\u91cf\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u7528\u73af\u5883\u5149\u6a21\u62df\u70b9\u5149\u6e90\u3002\u4f46\u662f\u6211\u4eec\u7684\u5149\u7167\u6a21\u578b\u8fd8\u4e0d\u5b8c\u6574\uff0c\u56e0\u4e3a\u7269\u4f53\u53cd\u5c04\u7684\u5149\u4e0e\u5149\u6e90\u7684\u8ddd\u79bb\u65e0\u5173\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u5149\u7ebf\u8870\u51cf\u3002 \u8870\u51cf\u662f\u4e00\u4e2a\u4e0e\u8ddd\u79bb\u548c\u5149\u6709\u5173\u7684\u51fd\u6570\u3002\u5149\u7684\u5f3a\u5ea6\u4e0e\u8ddd\u79bb\u7684\u5e73\u65b9\u6210\u53cd\u6bd4\u3002\u8fd9\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u968f\u7740\u5149\u7ebf\u7684\u4f20\u64ad\uff0c\u5176\u80fd\u91cf\u6cbf\u7740\u7403\u4f53\u8868\u9762\u5206\u5e03\uff0c\u5176\u534a\u5f84\u7b49\u4e8e\u5149\u7ebf\u884c\u8fdb\u7684\u8ddd\u79bb\uff0c\u800c\u7403\u7684\u8868\u9762\u79ef\u4e0e\u5176\u534a\u5f84\u7684\u5e73\u65b9\u6210\u6b63\u6bd4\u3002\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u5f0f\u6765\u8ba1\u7b97\u8870\u51cf\u56e0\u5b50\uff1a 1.0 /(atConstant + atLineardist + atExponentdist ^ {2}) \u3002 \u4e3a\u4e86\u6a21\u62df\u8870\u51cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u8870\u51cf\u56e0\u6570\u4e58\u4ee5\u6700\u7ec8\u989c\u8272\u5373\u53ef\u3002 \u5b9e\u73b0 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u7f16\u7a0b\u5b9e\u73b0\u4e0a\u8ff0\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u4ece\u7740\u8272\u5668\u5f00\u59cb\u3002\u5927\u90e8\u5206\u5de5\u4f5c\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u4f46\u6211\u4eec\u8fd8\u9700\u8981\u5c06\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u4e00\u4e9b\u6570\u636e\u4f20\u9012\u7ed9\u5b83\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u7247\u5143\u7740\u8272\u5668\u4ec5\u63a5\u6536\u7eb9\u7406\u5750\u6807\uff0c\u73b0\u5728\u6211\u4eec\u8fd8\u5c06\u4f20\u9012\u4e24\u4e2a\u53c2\u6570\uff1a \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u5e76\u5df2\u5f52\u4e00\u5316\u7684\u9876\u70b9\u6cd5\u7ebf\u3002 \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; } \u5728\u6211\u4eec\u7ee7\u7eed\u8bb2\u89e3\u7247\u5143\u7740\u8272\u5668\u4e4b\u524d\uff0c\u5fc5\u987b\u5f3a\u8c03\u4e00\u4e2a\u975e\u5e38\u91cd\u8981\u7684\u6982\u5ff5\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u5230\uff0c mvVertexNormal \uff0c\u8be5\u53d8\u91cf\u5305\u542b\u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7684\u9876\u70b9\u6cd5\u7ebf\u3002\u8fd9\u662f\u901a\u8fc7\u5c06 vertexNormal \u4e58\u4e0a modelViewMatrix \u6765\u5b9e\u73b0\u7684\uff0c\u5c31\u50cf\u9876\u70b9\u4f4d\u7f6e\u4e00\u6837\u3002\u4f46\u6709\u4e00\u4e2a\u7ec6\u5fae\u7684\u533a\u522b\uff0c\u8be5\u9876\u70b9\u6cd5\u7ebf\u7684w\u5206\u91cf\u5728\u4e58\u4ee5\u77e9\u9635\u4e4b\u524d\u88ab\u8bbe\u7f6e\u4e3a0\uff1a vec4(vertexNormal, 0.0) \u3002\u6211\u4eec\u4e3a\u4ec0\u4e48\u8981\u8fd9\u6837\u505a\u5462?\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u6cd5\u7ebf\u88ab\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u4f46\u6211\u4eec\u4e0d\u5e0c\u671b\u5b83\u88ab\u5e73\u79fb\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u5bf9\u5b83\u7684\u65b9\u5411\u611f\u5174\u8da3\uff0c\u800c\u4e0d\u662f\u5b83\u7684\u4f4d\u7f6e\u3002\u800c\u8fd9\u662f\u901a\u8fc7\u5c06w\u5206\u91cf\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\uff0c\u8fd9\u4e5f\u662f\u662f\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u7684\u4f18\u70b9\u4e4b\u4e00\uff0c\u901a\u8fc7\u8bbe\u7f6ew\u5206\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u63a7\u5236\u5e94\u7528\u7684\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u5728\u7eb8\u4e0a\u505a\u77e9\u9635\u4e58\u6cd5\uff0c\u770b\u770b\u4e3a\u4ec0\u4e48\u662f\u8fd9\u6837\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5f00\u5de5\u4e86\uff0c\u9664\u4e86\u5c06\u6765\u81ea\u9876\u70b9\u7740\u8272\u5668\u7684\u503c\u58f0\u660e\u4e3a\u8f93\u5165\u53c2\u6570\u4e4b\u5916\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e9b\u6709\u7528\u7684\u7ed3\u6784\u4f53\u6765\u5efa\u6a21\u5149\u7167\u548c\u6750\u8d28\u5c5e\u6027\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u7528\u4e8e\u5efa\u6a21\u5149\u7684\u7ed3\u6784\u4f53\u3002 struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // \u5149\u6e90\u4f4d\u7f6e\u662f\u5728\u89c2\u5bdf\u5750\u6807\u7cfb\u4e2d\u7684 vec3 position; float intensity; Attenuation att; }; \u70b9\u5149\u6e90\u7531\u4e00\u4e2a\u989c\u8272\uff0c\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4ee5\u53ca\u4e00\u4e2a\u4ecb\u4e8e 0 \u548c 1 \u4e4b\u95f4\u7684\u6570\u5b57\uff08\u7528\u4e8e\u6a21\u62df\u5149\u7167\u5f3a\u5ea6\uff09\u548c\u4e00\u7ec4\u7528\u4e8e\u6a21\u62df\u8870\u51cf\u65b9\u7a0b\u7684\u53c2\u6570\u5b9a\u4e49\u3002 \u5efa\u6a21\u6750\u8d28\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u5982\u4e0b\uff1a struct Material { vec4 ambient; vec4 diffuse; vec4 specular; int hasTexture; float reflectance; }; \u6750\u8d28\u7531\u4e00\u7ec4\u989c\u8272\u5b9a\u4e49\uff08\u5047\u5982\u6211\u4eec\u4e0d\u4f7f\u7528\u7eb9\u7406\u4e3a\u7247\u5143\u7740\u8272\uff09\uff1a \u7528\u4e8e\u73af\u5883\u5149\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u6750\u8d28\u8fd8\u7531\u4e00\u4e2a\u6807\u5fd7\u63a7\u5236\u5b83\u662f\u5426\u62e5\u6709\u5173\u8054\u7684\u7eb9\u7406\u548c\u53cd\u5c04\u7387\u6307\u6570\u5b9a\u4e49\u3002\u6211\u4eec\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4ee5\u4e0bUniform\u3002 uniform sampler2D texture_sampler; uniform vec3 ambientLight; uniform float specularPower; uniform Material material; uniform PointLight pointLight; uniform vec3 camera_pos; \u6211\u4eec\u7528\u65b0\u5efa\u7684Uniform\u8bbe\u7f6e\u4ee5\u4e0b\u53d8\u91cf\uff1a \u73af\u5883\u5149\uff1a\u50a8\u5b58\u989c\u8272\uff0c\u4ee5\u540c\u6837\u65b9\u5f0f\u5f71\u54cd\u6bcf\u4e2a\u7247\u5143\u3002 \u955c\u9762\u53cd\u5c04\u5f3a\u5ea6\uff08\u5728\u8ba8\u8bba\u955c\u9762\u53cd\u5c04\u5149\u65f6\u7ed9\u51fa\u7684\u65b9\u7a0b\u5f0f\u4e2d\u4f7f\u7528\u7684\u6307\u6570\uff09\u3002 \u4e00\u4e2a\u70b9\u5149\u6e90\u3002 \u6750\u8d28\u5c5e\u6027\u3002 \u6444\u50cf\u673a\u5728\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 \u6211\u4eec\u8fd8\u5c06\u5b9a\u4e49\u4e00\u4e9b\u5168\u5c40\u53d8\u91cf\uff0c\u5b83\u4eec\u5c06\u50a8\u5b58\u8981\u5728\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u4e2d\u4f7f\u7528\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u53d8\u91cf\u662f\u56e0\u4e3a\u5982\u679c\u5206\u91cf\u5177\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u5c06\u5bf9\u6240\u6709\u5206\u91cf\u4f7f\u7528\u76f8\u540c\u7684\u989c\u8272\uff0c\u5e76\u4e14\u6211\u4eec\u4e0d\u5e0c\u671b\u8fdb\u884c\u5197\u4f59\u7684\u7eb9\u7406\u67e5\u627e\u3002\u8fd9\u4e9b\u53d8\u91cf\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a vec4 ambientC; vec4 diffuseC; vec4 speculrC; \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u6765\u6839\u636e\u6750\u8d28\u5c5e\u6027\u8bbe\u7f6e\u8fd9\u4e9b\u53d8\u91cf\uff1a void setupColours(Material material, vec2 textCoord) { if (material.hasTexture == 1) { ambientC = texture(texture_sampler, textCoord); diffuseC = ambientC; speculrC = ambientC; } else { ambientC = material.ambient; diffuseC = material.diffuse; speculrC = material.specular; } } \u73b0\u5728\u6211\u4eec\u8981\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u5b83\u4ee5\u70b9\u5149\u6e90\u3001\u9876\u70b9\u4f4d\u7f6e\u53ca\u5176\u6cd5\u7ebf\u4e3a\u8f93\u5165\u5e76\u8fd4\u56de\u6b64\u524d\u63cf\u8ff0\u7684\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u8ba1\u7b97\u7684\u989c\u8272\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04 vec3 light_direction = light.position - position; vec3 to_light_source = normalize(light_direction); float diffuseFactor = max(dot(normal, to_light_source ), 0.0); diffuseColour = diffuseC * vec4(light.colour, 1.0) * light.intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04 vec3 camera_direction = normalize(-position); vec3 from_light_source = -to_light_source; vec3 reflected_light = normalize(reflect(from_light_source, normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * specularFactor * material.reflectance * vec4(light.colour, 1.0); // \u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return (diffuseColour + specColour) / attenuationInv; } \u4e0a\u8ff0\u4ee3\u7801\u76f8\u5bf9\u6bd4\u8f83\u76f4\u767d\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u8ba1\u7b97\u4e86\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\uff0c\u53e6\u4e00\u4e2a\u662f\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u7684\u989c\u8272\uff0c\u5e76\u901a\u8fc7\u5149\u7ebf\u5728\u5230\u8fbe\u6211\u4eec\u6b63\u5728\u5904\u7406\u7684\u9876\u70b9\u65f6\u53d7\u5230\u7684\u8870\u51cf\u6765\u8c03\u6574\u5b83\u4eec\u3002 \u8bf7\u6ce8\u610f\uff0c\u9876\u70b9\u5750\u6807\u662f\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u7684\u3002\u5728\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u65f6\uff0c\u6211\u4eec\u5f97\u51fa\u5230\u89c2\u5bdf\u70b9\uff08\u5373\u6444\u50cf\u673a\u4f4d\u7f6e\uff09\u7684\u65b9\u5411\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a vec3 camera_direction = normalize(camera_pos - position); \u4f46\u662f\uff0c\u7531\u4e8e position \u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\uff0c\u6444\u50cf\u673a\u4f4d\u7f6e\u59cb\u7ec8\u4f4d\u4e8e\u539f\u70b9\uff0c\u5373 (0, 0, 0) \uff0c\u6240\u4ee5\u6211\u4eec\u6309\u5982\u4e0b\u4ee3\u7801\u8ba1\u7b97\u5b83\uff1a vec3 camera_direction = normalize(vec3(0, 0, 0) - position); \u53ef\u4ee5\u7b80\u5316\u4e3a\uff1a vec3 camera_direction = normalize(-position); \u6709\u4e86\u4e0a\u8ff0\u51fd\u6570\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u4e3b\u51fd\u6570\u5c31\u53d8\u5f97\u975e\u5e38\u7b80\u5355\u4e86\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u8c03\u7528 setupColours \u51fd\u6570\u5c06\u4f7f\u7528\u9002\u5f53\u7684\u989c\u8272\u6765\u8bbe\u7f6e\u53d8\u91cf ambientC \u3001 diffuseC \u548c speculrC \u3002\u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u8003\u8651\u5230\u8870\u51cf\u3002\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\uff0c\u6211\u4eec\u4f7f\u7528\u5355\u4e2a\u51fd\u6570\u8c03\u7528\u6765\u5b9e\u73b0\u6b64\u64cd\u4f5c\uff0c\u5982\u4e0a\u6240\u8ff0\u3002\u6700\u7ec8\u7684\u989c\u8272\u662f\u901a\u8fc7\u6dfb\u52a0\u73af\u5883\u5149\u5206\u91cf\u6765\u8ba1\u7b97\u7684\uff08\u5c06 ambientC \u4e58\u4ee5\u73af\u5883\u5149\uff09\u3002\u5982\u4f60\u6240\u89c1\uff0c\u73af\u5883\u5149\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002 \u5728\u7740\u8272\u5668\u4e2d\u6211\u4eec\u5f15\u5165\u4e86\u4e00\u4e9b\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u65b0\u6982\u5ff5\uff0c\u6211\u4eec\u6b63\u5728\u5b9a\u4e49\u7ed3\u6784\u4f53\u5e76\u5c06\u5b83\u4eec\u7528\u4f5cUniform\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u4f20\u9012\u8fd9\u4e9b\u7ed3\u6784\u4f53\uff1f\u9996\u5148\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e24\u4e2a\u65b0\u7c7b\uff0c\u5b83\u4eec\u5efa\u6a21\u70b9\u5149\u6e90\u548c\u6750\u8d28\u5c5e\u6027\uff0c\u540d\u4e3a PointLight \u548c Material \u3002\u5b83\u4eec\u53ea\u662f\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u4eec\u3002\u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u65b0\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u80fd\u591f\u4e3a\u70b9\u5149\u6e90\u548c\u6750\u8d28\u7ed3\u6784\u4f53\u521b\u5efaUniform\u3002 public void createPointLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".position\"); createUniform(uniformName + \".intensity\"); createUniform(uniformName + \".att.constant\"); createUniform(uniformName + \".att.linear\"); createUniform(uniformName + \".att.exponent\"); } public void createMaterialUniform(String uniformName) throws Exception { createUniform(uniformName + \".ambient\"); createUniform(uniformName + \".diffuse\"); createUniform(uniformName + \".specular\"); createUniform(uniformName + \".hasTexture\"); createUniform(uniformName + \".reflectance\"); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4e3a\u6784\u6210\u7ed3\u6784\u4f53\u7684\u6240\u6709\u5c5e\u6027\u521b\u5efa\u4e00\u4e2a\u5355\u72ec\u7684Uniform\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u5916\u4e24\u4e2a\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff0c\u5e76\u5c06 PointLight \u548c Material \u7684\u5b9e\u4f8b\u4f5c\u4e3a\u53c2\u6570\u3002 public void setUniform(String uniformName, PointLight pointLight) { setUniform(uniformName + \".colour\", pointLight.getColor() ); setUniform(uniformName + \".position\", pointLight.getPosition()); setUniform(uniformName + \".intensity\", pointLight.getIntensity()); PointLight.Attenuation att = pointLight.getAttenuation(); setUniform(uniformName + \".att.constant\", att.getConstant()); setUniform(uniformName + \".att.linear\", att.getLinear()); setUniform(uniformName + \".att.exponent\", att.getExponent()); } public void setUniform(String uniformName, Material material) { setUniform(uniformName + \".ambient\", material.getAmbientColour()); setUniform(uniformName + \".diffuse\", material.getDiffuseColour()); setUniform(uniformName + \".specular\", material.getSpecularColour()); setUniform(uniformName + \".hasTexture\", material.isTextured() ? 1 : 0); setUniform(uniformName + \".reflectance\", material.getReflectance()); } \u5728\u672c\u7ae0\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u8fd8\u5c06\u770b\u5230\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 Mesh \u7c7b\u6765\u50a8\u5b58\u6750\u8d28\u5b9e\u4f8b\uff0c\u5e76\u4e14\u521b\u5efa\u4e86\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u5728\u5176\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u53ef\u7528\u201cN\u201d\u548c\u201cM\u201d\u952e\u63a7\u5236\u79fb\u52a8\u7684\u70b9\u5149\u6e90\uff0c\u4ee5\u663e\u793a\u70b9\u5149\u6e90\u805a\u7126\u5728\u53cd\u5c04\u7387\u503c\u9ad8\u4e8e0\u7684\u7f51\u683c\u4e0a\u65f6\u662f\u600e\u6837\u7684\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u7247\u5143\u7740\u8272\u5668\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u9700\u8981\u53e6\u4e00\u4e2a\u50a8\u5b58\u6444\u50cf\u673a\u4f4d\u7f6e camera_pos \u7684Uniform\u3002\u8fd9\u4e9b\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u3002\u901a\u5e38\u6211\u4eec\u5c06\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u8bbe\u7f6e\u5149\u6e90\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u89c2\u5bdf\u77e9\u9635\uff0c\u4ee5\u4fbf\u80fd\u591f\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\uff0c\u6240\u4ee5\u9700\u8981\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u89c2\u5bdf\u77e9\u9635\u4ee5\u4fbf\u53d8\u6362\u5149\u6e90\u5750\u6807\u3002 // \u83b7\u5f97\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5b83\u7684\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLight); Vector3f lightPos = currPointLight.getPosition(); Vector4f aux = new Vector4f(lightPos, 1); aux.mul(viewMatrix); lightPos.x = aux.x; lightPos.y = aux.y; lightPos.z = aux.z; shaderProgram.setUniform(\"pointLight\", currPointLight); \u6211\u4eec\u4e0d\u4f1a\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5982\u679c\u8fd9\u6837\u8fd9\u4e00\u7ae0\u5c31\u592a\u957f\u4e86\uff0c\u4e14\u5bf9\u4e8e\u89e3\u91ca\u6e05\u695a\u6982\u5ff5\u6ca1\u6709\u592a\u591a\u7684\u5e2e\u52a9\uff0c\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6e90\u4ee3\u7801\u3002","title":"\u8981\u6709\u5149"},{"location":"10-let-there-be-light/#let-there-be-light","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4e3a3D\u6e38\u620f\u5f15\u64ce\u6dfb\u52a0\u5149\u7167\u3002\u6211\u4eec\u4e0d\u4f1a\u53bb\u5b9e\u73b0\u4e00\u4e2a\u5b8c\u7f8e\u7684\u5149\u7167\u6a21\u578b\uff0c\u56e0\u4e3a\u629b\u5f00\u590d\u6742\u6027\u4e0d\u8c08\uff0c\u5b83\u8fd8\u9700\u8981\u6d88\u8017\u5927\u91cf\u7684\u8ba1\u7b97\u673a\u8d44\u6e90\uff0c\u76f8\u53cd\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u8fd1\u4f3c\u7684\u3001\u50cf\u6837\u7684\u5149\u7167\u6548\u679c\uff1a\u6211\u4eec\u5c06\u4f7f\u7528\u540d\u4e3a Phong \u7684\u7740\u8272\u7b97\u6cd5\uff08\u7531Bui Tuong Phong\u5f00\u53d1\uff09\u3002\u53e6\u4e00\u4e2a\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u5c06\u53ea\u6a21\u62df\u5149\u7167\uff0c\u4f46\u4e0d\u4f1a\u6a21\u62df\u8fd9\u4e9b\u5149\u7167\u6240\u4ea7\u751f\u7684\u9634\u5f71\uff08\u8fd9\u5c06\u5728\u540e\u7eed\u7ae0\u8282\u4e2d\u5b9e\u73b0\uff09\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5148\u5b9a\u4e49\u51e0\u4e2a\u5149\u7167\u7c7b\u578b\uff1a \u70b9\u5149\u6e90\uff08Point Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u6a21\u62df\u5149\u7167\uff0c\u6211\u4eec\u9700\u8981\u8003\u8651\u5149\u7167\u7684\u7c7b\u578b\u3001\u4f4d\u7f6e\u548c\u5176\u4ed6\u4e00\u4e9b\u53c2\u6570\uff0c\u5982\u989c\u8272\u3002\u5f53\u7136\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u8003\u8651\u7269\u4f53\u5982\u4f55\u53d7\u5149\u7167\u5f71\u54cd\u5438\u6536\u548c\u53cd\u5c04\u5149\u3002 Phong\u7740\u8272\u7b97\u6cd5\u5c06\u6a21\u62df\u5149\u7ebf\u5bf9\u6211\u4eec\u6a21\u578b\u4e2d\u6bcf\u4e2a\u70b9\u7684\u5f71\u54cd\uff0c\u5373\u5bf9\u6bcf\u4e2a\u9876\u70b9\u7684\u5f71\u54cd\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5b83\u88ab\u79f0\u4e3a\u5c40\u90e8\u5149\u7167\u6a21\u578b\u7684\u539f\u56e0\uff0c\u8fd9\u4e5f\u662f\u8be5\u7b97\u6cd5\u4e0d\u80fd\u8ba1\u7b97\u9634\u5f71\u7684\u539f\u56e0\uff1a\u5b83\u53ea\u4f1a\u8ba1\u7b97\u5e94\u7528\u5230\u6bcf\u4e2a\u9876\u70b9\u7684\u5149\u7167\uff0c\u800c\u4e0d\u8003\u8651\u9876\u70b9\u662f\u5426\u4f4d\u4e8e\u906e\u5149\u7269\u4f53\u4e4b\u540e\u3002\u6211\u4eec\u5c06\u5728\u6b64\u540e\u7684\u7ae0\u8282\u4e2d\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\u3002\u4f46\u6b63\u56e0\u5982\u6b64\uff0c\u5b83\u662f\u4e00\u79cd\u975e\u5e38\u7b80\u5355\u5feb\u901f\u7684\u7b97\u6cd5\uff0c\u5e76\u4e14\u53ef\u4ee5\u63d0\u4f9b\u975e\u5e38\u597d\u7684\u6548\u679c\u3002\u6211\u4eec\u5c06\u5728\u6b64\u5b9e\u73b0\u4e00\u4e2a\u6ca1\u6709\u6df1\u5165\u8003\u8651\u6750\u8d28\u5f71\u54cd\u7684\u7b80\u5316\u7248\u672c\u3002 Phong\u7b97\u6cd5\u63d0\u4f9b\u4e86\u4e09\u79cd\u5149\u7167\u5206\u91cf\uff1a \u73af\u5883\u5149\uff08Ambient Light\uff09 \uff1a\u6a21\u62df\u6765\u81ea\u4efb\u4f55\u65b9\u5411\u7684\u5149\u7167\uff0c\u5b83\u5c06\u7167\u4eae\uff08\u9700\u8981\u5bf9\u5e94\u5f3a\u5ea6\u503c\uff09\u672a\u53d7\u4efb\u4f55\u5149\u7ebf\u7167\u5c04\u7684\u533a\u57df\uff0c\u5c31\u50cf\u80cc\u666f\u5149\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09 \uff1a\u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09 \uff1a\u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 \u6700\u540e\uff0c\u6211\u4eec\u8981\u5f97\u5230\u4e00\u4e2a\u56e0\u6570\uff0c\u5c06\u5b83\u4e0e\u6307\u5b9a\u7247\u5143\u7684\u989c\u8272\u76f8\u4e58\uff0c\u6839\u636e\u5b83\u6240\u53d7\u7684\u5149\u7167\u5c06\u8be5\u989c\u8272\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u4ee4 A \u4e3a\u73af\u5883\u5149\u3001 D \u4e3a\u6f2b\u53cd\u5c04\u5149\u3001 S \u4e3a\u955c\u9762\u53cd\u5c04\u5149\uff0c\u76ee\u6807\u56e0\u6570\u5c06\u662f\u4e0a\u8ff0\u5206\u91cf\u7684\u603b\u548c\uff1a L = A + D + S \u8fd9\u4e9b\u5206\u91cf\u5176\u5b9e\u5c31\u662f\u989c\u8272\uff0c\u4e5f\u5c31\u662f\u6bcf\u4e2a\u5149\u7167\u5206\u91cf\u6240\u8d21\u732e\u7684\u989c\u8272\u5206\u91cf\u3002\u8fd9\u662f\u56e0\u4e3a\u5149\u7167\u5206\u91cf\u4e0d\u4ec5\u4f1a\u63d0\u4f9b\u4e00\u5b9a\u7a0b\u5ea6\u7684\u4eae\u5ea6\uff0c\u8fd8\u4f1a\u6539\u53d8\u6a21\u578b\u7684\u989c\u8272\u3002\u5728\u6211\u4eec\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u53ea\u9700\u5c06\u8be5\u5149\u7167\u7684\u989c\u8272\u4e0e\u539f\u59cb\u7247\u5143\u989c\u8272\uff08\u4ece\u7eb9\u7406\u6216\u57fa\u8272\u83b7\u5f97\u7684\uff09\u76f8\u4e58\u5373\u53ef\u3002 \u6211\u4eec\u8fd8\u53ef\u4ee5\u4e3a\u76f8\u540c\u7684\u6750\u8d28\u6307\u5b9a\u4e0d\u540c\u7684\u989c\u8272\uff0c\u8fd9\u4e9b\u989c\u8272\u5c06\u7528\u4e8e\u73af\u5883\u5149\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002\u56e0\u6b64\uff0c\u8fd9\u4e9b\u5206\u91cf\u5c06\u7531\u6750\u8d28\u5173\u8054\u7684\u989c\u8272\u8c03\u6574\u3002\u5982\u679c\u6750\u8d28\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u5206\u91cf\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u3002 \u6240\u4ee5\u5bf9\u4e8e\u65e0\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u73af\u5883\u5149\u7684\u989c\u8272 + D * \u6f2b\u53cd\u5c04\u7684\u989c\u8272 + S * \u955c\u9762\u53cd\u5c04\u7684\u989c\u8272 \u5bf9\u4e8e\u6709\u7eb9\u7406\u7684\u6750\u8d28\u7684\u6700\u7ec8\u989c\u8272\u5c06\u662f\uff1a L = A * \u7eb9\u7406\u989c\u8272 + D * \u7eb9\u7406\u989c\u8272 + S * \u7eb9\u7406\u989c\u8272","title":"\u8981\u6709\u5149\uff08Let there be light\uff09"},{"location":"10-let-there-be-light/#_1","text":"\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7b2c\u4e00\u4e2a\u5206\u91cf\uff0c\u5373\u73af\u5883\u5149\u5206\u91cf\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u5e38\u91cf\uff0c\u4f1a\u4f7f\u6211\u4eec\u7684\u6240\u6709\u7269\u4f53\u53d8\u5f97\u66f4\u4eae\u6216\u66f4\u6697\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5b83\u6765\u6a21\u62df\u4e00\u5929\u4e2d\u7279\u5b9a\u65f6\u95f4\u6bb5\u5185\u7684\u5149\u7167\uff08\u9ece\u660e\u3001\u9ec4\u660f\u7b49\uff09\uff0c\u4e5f\u53ef\u4ee5\u7528\u5b83\u6765\u6dfb\u52a0\u4e00\u4e9b\u4e0d\u76f4\u63a5\u88ab\u5149\u7ebf\u7167\u5c04\u5230\uff0c\u4f46\u53ef\u4ee5\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u88ab\u95f4\u63a5\u5149\u7ebf\u7167\u5c04\uff08\u6bd4\u5982\u53cd\u5c04\uff09\u5230\u7684\u70b9\u7684\u5149\u7167\u3002 \u73af\u5883\u5149\u662f\u6700\u5bb9\u6613\u8ba1\u7b97\u7684\u5206\u91cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u4e00\u79cd\u989c\u8272\uff0c\u5b83\u5c06\u4e0e\u57fa\u8272\u76f8\u4e58\uff0c\u4ee5\u8c03\u6574\u8be5\u57fa\u8272\u3002\u5047\u5982\u6211\u4eec\u5df2\u7ecf\u786e\u5b9a\u7247\u5143\u7684\u989c\u8272\u662f (1.0, 0.0, 0.0) \uff0c\u5373\u7ea2\u8272\u3002\u5982\u679c\u6ca1\u6709\u73af\u5883\u5149\u65f6\uff0c\u5b83\u5c06\u663e\u793a\u4e3a\u5b8c\u5168\u7ea2\u8272\u7684\u7247\u5143\u3002\u5982\u679c\u6211\u4eec\u5c06\u73af\u5883\u5149\u8bbe\u7f6e\u4e3a (0.5, 0.5, 0.5) \uff0c\u5219\u6700\u7ec8\u989c\u8272\u5c06\u4e3a (0.5, 0.0, 0.0) \uff0c\u5176\u5b9e\u5c31\u662f\u53d8\u6697\u7684\u7ea2\u8272\u3002\u8fd9\u79cd\u5149\u7167\u4f1a\u4ee5\u76f8\u540c\u7684\u65b9\u5f0f\u4f7f\u6240\u6709\u7247\u5143\u53d8\u6697\uff08\u79f0\u5176\u4e3a\u4f7f\u7269\u4f53\u53d8\u6697\u7684\u5149\u4f3c\u4e4e\u6709\u70b9\u5947\u602a\uff0c\u4e8b\u5b9e\u4e0a\u8fd9\u5c31\u662f\u6211\u4eec\u5f97\u5230\u7684\u6548\u679c\uff09\u3002\u6b64\u5916\uff0c\u5982\u679c\u5149\u8272\u7684RGB\u5206\u91cf\u4e0d\u76f8\u540c\uff0c\u5b83\u8fd8\u53ef\u4ee5\u4e3a\u7247\u5143\u6dfb\u52a0\u4e00\u4e9b\u989c\u8272\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4e00\u4e2a\u77e2\u91cf\u6765\u8c03\u8282\u73af\u5883\u5149\u5f3a\u5ea6\u548c\u989c\u8272\u3002","title":"\u73af\u5883\u5149\u5206\u91cf"},{"location":"10-let-there-be-light/#_2","text":"\u73b0\u5728\u6211\u4eec\u6765\u8c08\u8c08\u6f2b\u53cd\u5c04\uff0c\u5b83\u6a21\u62df\u4e86\u8fd9\u6837\u4e00\u4e2a\u73b0\u8c61\uff1a\u4e0e\u5149\u7ebf\u5782\u76f4\u7684\u9762\u770b\u8d77\u6765\u6bd4\u4ee5\u66f4\u63a5\u8fd1\u4e0e\u5149\u7ebf\u5e73\u884c\u7684\u89d2\u5ea6\u63a5\u6536\u5149\u7ebf\u7684\u9762\u66f4\u4eae\u3002\u4e00\u4e2a\u7269\u4f53\u63a5\u6536\u5230\u7684\u5149\u8d8a\u591a\uff0c\u5176\u5149\u5bc6\u5ea6\uff08\u5728\u6b64\u8fd9\u6837\u79f0\u547c\uff09\u5c31\u8d8a\u9ad8\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\uff1f\u4f60\u8fd8\u8bb0\u5f97\u4e0a\u4e00\u7ae0\u4e2d\u6211\u4eec\u4ecb\u7ecd\u8fc7\u7684\u6cd5\u7ebf\u7684\u6982\u5ff5\u5417\uff1f\u6cd5\u7ebf\u662f\u5782\u76f4\u4e8e\u5e73\u9762\u5e76\u4e14\u957f\u5ea6\u4e3a1\u7684\u5411\u91cf\u3002\u56e0\u6b64\uff0c\u8ba9\u6211\u4eec\u4e3a\u4e0a\u56fe\u4e2d\u7684\u4e09\u4e2a\u70b9\u7684\u7ed8\u5236\u6cd5\u7ebf\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6bcf\u4e2a\u70b9\u7684\u6cd5\u7ebf\u5c06\u662f\u5782\u76f4\u4e8e\u6bcf\u4e2a\u70b9\u7684\u5207\u5e73\u9762\u7684\u5411\u91cf\u3002\u6211\u4eec\u4e0d\u7528\u7ed8\u5236\u6765\u81ea\u5149\u6e90\u7684\u5149\u7ebf\uff0c\u800c\u662f\u7ed8\u5236\u4ece\u6bcf\u4e2a\u70b9\u5230\u5149\u6e90\uff08\u5373\u76f8\u53cd\u7684\u65b9\u5411\uff09\u7684\u5411\u91cf\u3002 \u5982\u4f60\u6240\u89c1\uff0c P1 \u70b9\u7684\u6cd5\u7ebf N1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u8be5\u6cd5\u7ebf\u7684\u65b9\u5411\u4e0e\u5149\u7ebf\u7684\u65b9\u5411\u76f8\u53cd\uff08 N1 \u5df2\u88ab\u79fb\u52a8\uff0c\u4ee5\u4fbf\u4f60\u53ef\u4ee5\u770b\u5230\u5b83\uff0c\u4f46\u8fd9\u5728\u6570\u5b66\u4e0a\u662f\u7b49\u4ef7\u7684\uff09\u3002 P1 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7b49\u4e8e 0 \u3002\u56e0\u4e3a\u5b83\u7684\u5207\u5e73\u9762\u5782\u76f4\u4e8e\u5149\u6e90\uff0c\u6240\u4ee5 P1 \u5c06\u662f\u6700\u4eae\u7684\u70b9\u3002 P2 \u70b9\u7684\u6cd5\u7ebf N2 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u6240\u6210\u7684\u5939\u89d2\u7ea6\u4e3a30\u5ea6\uff0c\u6240\u4ee5\u5b83\u5e94\u8be5\u6bd4 P1 \u66f4\u6697\u3002\u6700\u540e\uff0c P3 \u7684\u6cd5\u7ebf N3 \u4e5f\u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u5e73\u884c\uff0c\u4f46\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\u3002 P3 \u4e0e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u7684\u89d2\u5ea6\u4e3a180\u5ea6\uff0c\u6240\u4ee5\u6839\u672c\u4e0d\u5e94\u8be5\u63a5\u6536\u5230\u4efb\u4f55\u5149\u7ebf\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u4f3c\u4e4e\u5f97\u5230\u4e86\u4e00\u4e2a\u8ba1\u7b97\u67d0\u70b9\u7684\u5149\u7167\u5f3a\u5ea6\u7684\u597d\u65b9\u6cd5\uff0c\u5149\u5f3a\u4e0e\u8be5\u70b9\u7684\u6cd5\u7ebf\u548c\u8be5\u70b9\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\u4e4b\u95f4\u7684\u5939\u89d2\u5927\u5c0f\u6709\u5173\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u8ba1\u7b97\u5b83\u5462\uff1f \u6709\u4e00\u4e2a\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u7684\u6570\u5b66\u8fd0\u7b97\u2014\u2014\u2014\u2014\u6570\u91cf\u79ef\uff08\u53c8\u79f0\u4e3a\u70b9\u79ef\uff09\u3002\u8be5\u8fd0\u7b97\u9700\u8981\u4e24\u4e2a\u5411\u91cf\u5e76\u5f97\u5230\u4e00\u4e2a\u6570\u5b57\uff08\u6807\u91cf\uff09\uff0c\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u8f83\u5c0f\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u6b63\u6570\uff1b\u5982\u679c\u5b83\u4eec\u4e4b\u95f4\u7684\u89d2\u5ea6\u5f88\u5927\uff0c\u5219\u5f97\u5230\u4e00\u4e2a\u8d1f\u6570\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u88ab\u5f52\u4e00\u5316\uff0c\u5373\u4e24\u8005\u7684\u957f\u5ea6\u90fd\u7b49\u4e8e1\uff0c\u90a3\u4e48\u6570\u91cf\u79ef\u7684\u7ed3\u679c\u5c06\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\u3002\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u540c\uff08\u5373\u5939\u89d2\u4e3a 0 \uff09\uff0c\u5219\u6570\u91cf\u79ef\u4e3a1\uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u5939\u89d2\u4e3a\u76f4\u89d2\uff0c\u5219\u5b83\u7684\u503c\u4e3a 0 \uff1b\u5982\u679c\u4e24\u4e2a\u5411\u91cf\u7684\u65b9\u5411\u76f8\u53cd\uff0c\u5219\u4e3a -1 \u3002 \u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u5411\u91cf\uff0c v1 \u548c v2 \uff0c\u5e76\u4ee5 \u03b1 \u4f5c\u4e3a\u5b83\u4eec\u4e4b\u95f4\u7684\u5939\u89d2\u3002\u6570\u91cf\u79ef\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a \u5982\u679c\u4e24\u4e2a\u5411\u91cf\u90fd\u5f52\u4e00\u5316\uff0c\u5373\u5b83\u4eec\u7684\u957f\u5ea6\uff0c\u6216\u5b83\u4eec\u7684\u6a21\u957f\u7b49\u4e8e1\uff0c\u5b83\u4eec\u7684\u6570\u91cf\u79ef\u5373\u4e3a\u5939\u89d2\u7684\u4f59\u5f26\u503c\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u8fd0\u7b97\u6765\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff0c\u8be5\u600e\u4e48\u505a\u5462\uff1f\u5047\u5982\u6211\u4eec\u6709\u6bcf\u4e2a\u70b9\u7684\u4f4d\u7f6e\uff08\u5373\u9876\u70b9\u4f4d\u7f6e\uff09\u548c\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u9996\u5148\uff0c\u8fd9\u4e24\u4e2a\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u540c\u4e00\u4e2a\u5750\u6807\u7a7a\u95f4\u4e2d\u3002\u4e3a\u4e86\u7b80\u5316\uff0c\u6211\u4eec\u5047\u8bbe\u5b83\u4eec\u90fd\u5904\u4e8e\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\uff0c\u90a3\u4e48\u8fd9\u4e9b\u4f4d\u7f6e\u662f\u6307\u5411\u9876\u70b9\u4f4d\u7f6e\uff08 VP \uff09\u548c\u5149\u6e90\uff08 VS \uff09\u7684\u5411\u91cf\u7684\u5750\u6807\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u679c\u6211\u4eec\u4ece VP \u4e2d\u51cf\u53bb VS \uff0c\u5c31\u4f1a\u5f97\u5230\u6211\u4eec\u6240\u9700\u7684\u5411\u91cf\uff0c\u79f0\u4e3a L \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u5728\u6307\u5411\u5149\u6e90\u7684\u77e2\u91cf\u548c\u6cd5\u7ebf\u4e4b\u95f4\u505a\u6570\u91cf\u79ef\uff0c\u56e0\u4e3aJohann Lambert\u662f\u7b2c\u4e00\u4e2a\u63d0\u51fa\u8fd9\u79cd\u5173\u7cfb\u6765\u6a21\u62df\u5e73\u9762\u4eae\u5ea6\u7684\uff0c\u6240\u4ee5\u8be5\u4e58\u79ef\u88ab\u79f0\u4e3a\u5170\u4f2f\u7279\u9879\u3002 \u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\uff0c\u5b9a\u4e49\u4ee5\u4e0b\u53d8\u91cf\uff1a vPos \uff1a\u6211\u4eec\u7684\u9876\u70b9\u5728\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 lPos \uff1a\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5149\u6e90\u4f4d\u7f6e\u3002 intensity \uff1a\u5149\u7684\u5f3a\u5ea6\uff08\u4ece0\u52301\uff09\u3002 lCourour \uff1a\u5149\u7684\u989c\u8272\u3002 normal \uff1a\u9876\u70b9\u6cd5\u7ebf\u3002 \u9996\u5148\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4ece\u5f53\u524d\u4f4d\u7f6e\u6307\u5411\u5149\u6e90\u7684\u5411\u91cf\uff1a toLightDirection = lPos - vPos \uff0c\u8be5\u8fd0\u7b97\u7684\u7ed3\u679c\u9700\u8981\u5f52\u4e00\u5316\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6f2b\u53cd\u5c04\u56e0\u6570\uff08\u6807\u91cf\uff09\uff1a diffuseFactor = normal \\cdot toLightDirection \u3002\u8ba1\u7b97\u4e24\u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\uff0c\u6211\u4eec\u5e0c\u671b\u503c\u4ecb\u4e8e -1 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u4e24\u4e2a\u5411\u91cf\u90fd\u9700\u8981\u5f52\u4e00\u5316\u3002\u989c\u8272\u9700\u8981\u4ecb\u4e8e 0 \u5230 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u503c\u4f4e\u4e8e 0 \uff0c\u6211\u4eec\u5c06\u5176\u8bbe\u4e3a 0 \u3002 \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u901a\u8fc7\u6f2b\u53cd\u5c04\u56e0\u6570\u548c\u5149\u7684\u5f3a\u5ea6\u6765\u8c03\u8282\u5149\u7684\u989c\u8272\uff1a color = diffuseColour * lColour * diffuseFactor * intensity","title":"\u6f2b\u53cd\u5c04"},{"location":"10-let-there-be-light/#_3","text":"\u73b0\u5728\u770b\u5230\u955c\u9762\u53cd\u5c04\uff0c\u4f46\u9996\u5148\u6211\u4eec\u9700\u8981\u77e5\u9053\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002\u5f53\u5149\u7167\u5c04\u5230\u4e00\u4e2a\u8868\u9762\u65f6\uff0c\u5b83\u7684\u4e00\u90e8\u5206\u88ab\u5438\u6536\uff0c\u53e6\u4e00\u90e8\u5206\u88ab\u53cd\u5c04\uff0c\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u4f60\u7684\u7269\u7406\u8bfe\u77e5\u8bc6\uff0c\u53cd\u5c04\u5c31\u662f\u5149\u4ece\u7269\u4f53\u53cd\u5f39\u56de\u6765\u3002 \u5f53\u7136\uff0c\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u629b\u5149\u7684\uff0c\u5982\u679c\u4f60\u4ed4\u7ec6\u89c2\u5bdf\uff0c\u4f60\u4f1a\u770b\u5230\u5f88\u591a\u4e0d\u5e73\u6574\u7684\u5730\u65b9\u3002\u6b64\u5916\u8fd8\u6709\u8bb8\u591a\u5149\u7ebf\uff08\u5b9e\u9645\u4e0a\u662f\u5149\u5b50\uff09\uff0c\u4f1a\u649e\u51fb\u8fd9\u4e2a\u8868\u9762\uff0c\u5e76\u4e14\u4f1a\u4ee5\u4e0d\u540c\u7684\u89d2\u5ea6\u8fdb\u884c\u53cd\u5c04\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u770b\u5230\u7684\u5c31\u50cf\u662f\u4e00\u675f\u5149\u7167\u5c04\u8868\u9762\u5e76\u6563\u5c04\u56de\u6765\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5149\u5728\u649e\u51fb\u8868\u9762\u65f6\u4f1a\u53d1\u6563\uff0c\u8fd9\u5c31\u662f\u6211\u4eec\u4e4b\u524d\u8ba8\u8bba\u8fc7\u7684\u6f2b\u53cd\u5c04\u5206\u91cf\u3002 \u4f46\u662f\uff0c\u5f53\u5149\u7ebf\u7167\u5c04\u629b\u5149\u8868\u9762\u65f6\uff0c\u4f8b\u5982\u91d1\u5c5e\uff0c\u5149\u7ebf\u4f1a\u53d7\u5230\u8f83\u4f4e\u7684\u6269\u6563\u5f71\u54cd\uff0c\u5e76\u4e14\u5728\u5b83\u649e\u5230\u8868\u9762\u65f6\uff0c\u5927\u90e8\u5206\u4f1a\u5411\u53cd\u65b9\u5411\u53cd\u5c04\u3002 \u8fd9\u5c31\u662f\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u6a21\u578b\uff0c\u5b83\u53d6\u51b3\u4e8e\u6750\u8d28\u5c5e\u6027\u3002\u5bf9\u4e8e\u955c\u9762\u53cd\u5c04\uff0c\u91cd\u8981\u7684\u662f\u53ea\u6709\u5f53\u6444\u50cf\u673a\u5904\u4e8e\u6070\u5f53\u7684\u4f4d\u7f6e\u65f6\uff0c\u5373\u53cd\u5c04\u5149\u7684\u53cd\u5c04\u533a\u57df\u5185\uff0c\u53cd\u5c04\u5149\u624d\u53ef\u89c1\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u4e86\u955c\u9762\u53cd\u5c04\u4e4b\u4e2d\u7684\u673a\u7406\uff0c\u6211\u4eec\u63a5\u4e0b\u6765\u51c6\u5907\u8ba1\u7b97\u8fd9\u4e2a\u5206\u91cf\u3002\u9996\u5148\u6211\u4eec\u9700\u8981\u4e00\u4e2a\u4ece\u5149\u6e90\u6307\u5411\u9876\u70b9\u7684\u5411\u91cf\u3002\u5f53\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u5206\u91cf\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u65b9\u5411\u4e0e\u4e4b\u76f8\u53cd\u7684\u5411\u91cf\uff0c\u5b83\u6307\u5411\u7684\u662f\u5149\u6e90\uff0c\u5373 toLightDirection \u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u8ba1\u7b97\u4e3a fromLightDirection = -(toLightDirection) \u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u8003\u8651\u5230\u8868\u9762\u7684\u6cd5\u7ebf\uff0c\u6765\u8ba1\u7b97\u7531 fromLightDirection \u5c04\u51fa\u7684\u5149\u7ebf\u649e\u51fb\u8868\u9762\u6240\u4ea7\u751f\u7684\u53cd\u5c04\u5149\u3002\u6709\u4e00\u4e2a\u540d\u4e3a reflect \u7684GLSL\u51fd\u6570\u5b9e\u73b0\u4e86\u8be5\u529f\u80fd\u3002\u6240\u4ee5\uff0c reflectLight = reflect(fromLightSource, normal) \u3002 \u6211\u4eec\u8fd8\u9700\u8981\u4e00\u4e2a\u6307\u5411\u6444\u50cf\u673a\u7684\u5411\u91cf\uff0c\u5e76\u5c06\u5176\u547d\u540d\u4e3a cameraDirection \uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u6444\u50cf\u673a\u4f4d\u7f6e\u548c\u9876\u70b9\u4f4d\u7f6e\u4e4b\u95f4\u7684\u5dee\u503c\uff1a cameraDirection = cameraPos - vPos \u3002\u6444\u50cf\u673a\u4f4d\u7f6e\u5411\u91cf\u548c\u9876\u70b9\u4f4d\u7f6e\u9700\u8981\u5904\u4e8e\u76f8\u540c\u7684\u5750\u6807\u7cfb\u4e2d\uff0c\u5e76\u4e14\u5f97\u5230\u7684\u5411\u91cf\u9700\u8981\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u6982\u8ff0\u4e86\u6211\u4eec\u76ee\u524d\u8ba1\u7b97\u7684\u4e3b\u8981\u5206\u91cf\uff1a \u73b0\u5728\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5149\u5f3a\uff0c\u5373 specularFactor \u3002\u5982\u679c cameraDirection \u548c reflectLight \u5411\u91cf\u6307\u5411\u76f8\u540c\u7684\u65b9\u5411\uff0c\u8be5\u503c\u5c31\u8d8a\u9ad8\uff0c\u5982\u679c\u5b83\u4eec\u65b9\u5411\u76f8\u53cd\u5176\u503c\u5219\u8d8a\u4f4e\u3002\u4e3a\u4e86\u8ba1\u7b97\u8be5\u503c\u6211\u4eec\u5c06\u518d\u6b21\u8fd0\u7528\u6570\u91cf\u79ef\u3002 specularFactor = cameraDirection \\cdot reflectLight \u3002\u6211\u4eec\u53ea\u5e0c\u671b\u8be5\u503c\u4f4d\u4e8e 0 \u548c 1 \u4e4b\u95f4\uff0c\u6240\u4ee5\u5982\u679c\u5b83\u4f4e\u4e8e 0 \uff0c\u5c31\u5c06\u5b83\u8bbe\u4e3a0\u3002 \u6211\u4eec\u8fd8\u9700\u8981\u8003\u8651\u5230\uff0c\u5982\u679c\u6444\u50cf\u673a\u6307\u5411\u53cd\u5c04\u5149\u9525\uff0c\u5219\u8be5\u5149\u66f4\u5f3a\u70c8\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97 specularFactor \u7684 specularPower \u6b21\u5e42\u6765\u5b9e\u73b0\uff0c\u5176\u4e2d specularPower \u4e3a\u7ed9\u5b9a\u7684\u53c2\u6570\uff1a specularFactor = specularFactor^{specularPower} \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u6750\u8d28\u7684\u53cd\u5c04\u7387\u8fdb\u884c\u5efa\u6a21\uff0c\u5982\u679c\u5149\u7ebf\u53cd\u5c04\uff0c\u53cd\u5c04\u7387\u5c06\u8c03\u8282\u53cd\u5c04\u5149\u7684\u5f3a\u5ea6\uff0c\u8fd9\u5c06\u7528\u5230\u4e00\u4e2a\u540d\u4e3a reflectance \u7684\u53c2\u6570\u3002\u6240\u4ee5\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u4e3a\uff1a specularColour * lColour * reflectance * specularFactor * intensity","title":"\u955c\u9762\u53cd\u5c04"},{"location":"10-let-there-be-light/#_4","text":"\u6211\u4eec\u73b0\u5728\u77e5\u9053\u5982\u4f55\u8ba1\u7b97\u8fd9\u4e09\u4e2a\u5206\u91cf\u4e86\uff0c\u8fd9\u4e9b\u5206\u91cf\u53ef\u4ee5\u5e2e\u52a9\u6211\u4eec\u7528\u73af\u5883\u5149\u6a21\u62df\u70b9\u5149\u6e90\u3002\u4f46\u662f\u6211\u4eec\u7684\u5149\u7167\u6a21\u578b\u8fd8\u4e0d\u5b8c\u6574\uff0c\u56e0\u4e3a\u7269\u4f53\u53cd\u5c04\u7684\u5149\u4e0e\u5149\u6e90\u7684\u8ddd\u79bb\u65e0\u5173\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u6a21\u62df\u5149\u7ebf\u8870\u51cf\u3002 \u8870\u51cf\u662f\u4e00\u4e2a\u4e0e\u8ddd\u79bb\u548c\u5149\u6709\u5173\u7684\u51fd\u6570\u3002\u5149\u7684\u5f3a\u5ea6\u4e0e\u8ddd\u79bb\u7684\u5e73\u65b9\u6210\u53cd\u6bd4\u3002\u8fd9\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u968f\u7740\u5149\u7ebf\u7684\u4f20\u64ad\uff0c\u5176\u80fd\u91cf\u6cbf\u7740\u7403\u4f53\u8868\u9762\u5206\u5e03\uff0c\u5176\u534a\u5f84\u7b49\u4e8e\u5149\u7ebf\u884c\u8fdb\u7684\u8ddd\u79bb\uff0c\u800c\u7403\u7684\u8868\u9762\u79ef\u4e0e\u5176\u534a\u5f84\u7684\u5e73\u65b9\u6210\u6b63\u6bd4\u3002\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u5f0f\u6765\u8ba1\u7b97\u8870\u51cf\u56e0\u5b50\uff1a 1.0 /(atConstant + atLineardist + atExponentdist ^ {2}) \u3002 \u4e3a\u4e86\u6a21\u62df\u8870\u51cf\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u8870\u51cf\u56e0\u6570\u4e58\u4ee5\u6700\u7ec8\u989c\u8272\u5373\u53ef\u3002","title":"\u8870\u51cf"},{"location":"10-let-there-be-light/#_5","text":"\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u7f16\u7a0b\u5b9e\u73b0\u4e0a\u8ff0\u7684\u6240\u6709\u6982\u5ff5\uff0c\u6211\u4eec\u5c06\u4ece\u7740\u8272\u5668\u5f00\u59cb\u3002\u5927\u90e8\u5206\u5de5\u4f5c\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u4f46\u6211\u4eec\u8fd8\u9700\u8981\u5c06\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u4e00\u4e9b\u6570\u636e\u4f20\u9012\u7ed9\u5b83\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u7247\u5143\u7740\u8272\u5668\u4ec5\u63a5\u6536\u7eb9\u7406\u5750\u6807\uff0c\u73b0\u5728\u6211\u4eec\u8fd8\u5c06\u4f20\u9012\u4e24\u4e2a\u53c2\u6570\uff1a \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u5e76\u5df2\u5f52\u4e00\u5316\u7684\u9876\u70b9\u6cd5\u7ebf\u3002 \u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; } \u5728\u6211\u4eec\u7ee7\u7eed\u8bb2\u89e3\u7247\u5143\u7740\u8272\u5668\u4e4b\u524d\uff0c\u5fc5\u987b\u5f3a\u8c03\u4e00\u4e2a\u975e\u5e38\u91cd\u8981\u7684\u6982\u5ff5\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u5230\uff0c mvVertexNormal \uff0c\u8be5\u53d8\u91cf\u5305\u542b\u5df2\u8f6c\u6362\u4e3a\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7684\u9876\u70b9\u6cd5\u7ebf\u3002\u8fd9\u662f\u901a\u8fc7\u5c06 vertexNormal \u4e58\u4e0a modelViewMatrix \u6765\u5b9e\u73b0\u7684\uff0c\u5c31\u50cf\u9876\u70b9\u4f4d\u7f6e\u4e00\u6837\u3002\u4f46\u6709\u4e00\u4e2a\u7ec6\u5fae\u7684\u533a\u522b\uff0c\u8be5\u9876\u70b9\u6cd5\u7ebf\u7684w\u5206\u91cf\u5728\u4e58\u4ee5\u77e9\u9635\u4e4b\u524d\u88ab\u8bbe\u7f6e\u4e3a0\uff1a vec4(vertexNormal, 0.0) \u3002\u6211\u4eec\u4e3a\u4ec0\u4e48\u8981\u8fd9\u6837\u505a\u5462?\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u6cd5\u7ebf\u88ab\u65cb\u8f6c\u548c\u7f29\u653e\uff0c\u4f46\u6211\u4eec\u4e0d\u5e0c\u671b\u5b83\u88ab\u5e73\u79fb\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u5bf9\u5b83\u7684\u65b9\u5411\u611f\u5174\u8da3\uff0c\u800c\u4e0d\u662f\u5b83\u7684\u4f4d\u7f6e\u3002\u800c\u8fd9\u662f\u901a\u8fc7\u5c06w\u5206\u91cf\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\uff0c\u8fd9\u4e5f\u662f\u662f\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u7684\u4f18\u70b9\u4e4b\u4e00\uff0c\u901a\u8fc7\u8bbe\u7f6ew\u5206\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u63a7\u5236\u5e94\u7528\u7684\u53d8\u6362\u3002\u4f60\u53ef\u4ee5\u5728\u7eb8\u4e0a\u505a\u77e9\u9635\u4e58\u6cd5\uff0c\u770b\u770b\u4e3a\u4ec0\u4e48\u662f\u8fd9\u6837\u3002 \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5f00\u5de5\u4e86\uff0c\u9664\u4e86\u5c06\u6765\u81ea\u9876\u70b9\u7740\u8272\u5668\u7684\u503c\u58f0\u660e\u4e3a\u8f93\u5165\u53c2\u6570\u4e4b\u5916\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e9b\u6709\u7528\u7684\u7ed3\u6784\u4f53\u6765\u5efa\u6a21\u5149\u7167\u548c\u6750\u8d28\u5c5e\u6027\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u7528\u4e8e\u5efa\u6a21\u5149\u7684\u7ed3\u6784\u4f53\u3002 struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // \u5149\u6e90\u4f4d\u7f6e\u662f\u5728\u89c2\u5bdf\u5750\u6807\u7cfb\u4e2d\u7684 vec3 position; float intensity; Attenuation att; }; \u70b9\u5149\u6e90\u7531\u4e00\u4e2a\u989c\u8272\uff0c\u4e00\u4e2a\u4f4d\u7f6e\uff0c\u4ee5\u53ca\u4e00\u4e2a\u4ecb\u4e8e 0 \u548c 1 \u4e4b\u95f4\u7684\u6570\u5b57\uff08\u7528\u4e8e\u6a21\u62df\u5149\u7167\u5f3a\u5ea6\uff09\u548c\u4e00\u7ec4\u7528\u4e8e\u6a21\u62df\u8870\u51cf\u65b9\u7a0b\u7684\u53c2\u6570\u5b9a\u4e49\u3002 \u5efa\u6a21\u6750\u8d28\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u5982\u4e0b\uff1a struct Material { vec4 ambient; vec4 diffuse; vec4 specular; int hasTexture; float reflectance; }; \u6750\u8d28\u7531\u4e00\u7ec4\u989c\u8272\u5b9a\u4e49\uff08\u5047\u5982\u6211\u4eec\u4e0d\u4f7f\u7528\u7eb9\u7406\u4e3a\u7247\u5143\u7740\u8272\uff09\uff1a \u7528\u4e8e\u73af\u5883\u5149\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u7528\u4e8e\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\u3002 \u6750\u8d28\u8fd8\u7531\u4e00\u4e2a\u6807\u5fd7\u63a7\u5236\u5b83\u662f\u5426\u62e5\u6709\u5173\u8054\u7684\u7eb9\u7406\u548c\u53cd\u5c04\u7387\u6307\u6570\u5b9a\u4e49\u3002\u6211\u4eec\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u4ee5\u4e0bUniform\u3002 uniform sampler2D texture_sampler; uniform vec3 ambientLight; uniform float specularPower; uniform Material material; uniform PointLight pointLight; uniform vec3 camera_pos; \u6211\u4eec\u7528\u65b0\u5efa\u7684Uniform\u8bbe\u7f6e\u4ee5\u4e0b\u53d8\u91cf\uff1a \u73af\u5883\u5149\uff1a\u50a8\u5b58\u989c\u8272\uff0c\u4ee5\u540c\u6837\u65b9\u5f0f\u5f71\u54cd\u6bcf\u4e2a\u7247\u5143\u3002 \u955c\u9762\u53cd\u5c04\u5f3a\u5ea6\uff08\u5728\u8ba8\u8bba\u955c\u9762\u53cd\u5c04\u5149\u65f6\u7ed9\u51fa\u7684\u65b9\u7a0b\u5f0f\u4e2d\u4f7f\u7528\u7684\u6307\u6570\uff09\u3002 \u4e00\u4e2a\u70b9\u5149\u6e90\u3002 \u6750\u8d28\u5c5e\u6027\u3002 \u6444\u50cf\u673a\u5728\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u4f4d\u7f6e\u3002 \u6211\u4eec\u8fd8\u5c06\u5b9a\u4e49\u4e00\u4e9b\u5168\u5c40\u53d8\u91cf\uff0c\u5b83\u4eec\u5c06\u50a8\u5b58\u8981\u5728\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u4e2d\u4f7f\u7528\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u53d8\u91cf\u662f\u56e0\u4e3a\u5982\u679c\u5206\u91cf\u5177\u6709\u7eb9\u7406\uff0c\u6211\u4eec\u5c06\u5bf9\u6240\u6709\u5206\u91cf\u4f7f\u7528\u76f8\u540c\u7684\u989c\u8272\uff0c\u5e76\u4e14\u6211\u4eec\u4e0d\u5e0c\u671b\u8fdb\u884c\u5197\u4f59\u7684\u7eb9\u7406\u67e5\u627e\u3002\u8fd9\u4e9b\u53d8\u91cf\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a vec4 ambientC; vec4 diffuseC; vec4 speculrC; \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u6765\u6839\u636e\u6750\u8d28\u5c5e\u6027\u8bbe\u7f6e\u8fd9\u4e9b\u53d8\u91cf\uff1a void setupColours(Material material, vec2 textCoord) { if (material.hasTexture == 1) { ambientC = texture(texture_sampler, textCoord); diffuseC = ambientC; speculrC = ambientC; } else { ambientC = material.ambient; diffuseC = material.diffuse; speculrC = material.specular; } } \u73b0\u5728\u6211\u4eec\u8981\u5b9a\u4e49\u4e00\u4e2a\u51fd\u6570\uff0c\u5b83\u4ee5\u70b9\u5149\u6e90\u3001\u9876\u70b9\u4f4d\u7f6e\u53ca\u5176\u6cd5\u7ebf\u4e3a\u8f93\u5165\u5e76\u8fd4\u56de\u6b64\u524d\u63cf\u8ff0\u7684\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u8ba1\u7b97\u7684\u989c\u8272\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04 vec3 light_direction = light.position - position; vec3 to_light_source = normalize(light_direction); float diffuseFactor = max(dot(normal, to_light_source ), 0.0); diffuseColour = diffuseC * vec4(light.colour, 1.0) * light.intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04 vec3 camera_direction = normalize(-position); vec3 from_light_source = -to_light_source; vec3 reflected_light = normalize(reflect(from_light_source, normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * specularFactor * material.reflectance * vec4(light.colour, 1.0); // \u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return (diffuseColour + specColour) / attenuationInv; } \u4e0a\u8ff0\u4ee3\u7801\u76f8\u5bf9\u6bd4\u8f83\u76f4\u767d\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u8ba1\u7b97\u4e86\u6f2b\u53cd\u5c04\u5206\u91cf\u7684\u989c\u8272\uff0c\u53e6\u4e00\u4e2a\u662f\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u7684\u989c\u8272\uff0c\u5e76\u901a\u8fc7\u5149\u7ebf\u5728\u5230\u8fbe\u6211\u4eec\u6b63\u5728\u5904\u7406\u7684\u9876\u70b9\u65f6\u53d7\u5230\u7684\u8870\u51cf\u6765\u8c03\u6574\u5b83\u4eec\u3002 \u8bf7\u6ce8\u610f\uff0c\u9876\u70b9\u5750\u6807\u662f\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u7684\u3002\u5728\u8ba1\u7b97\u955c\u9762\u53cd\u5c04\u65f6\uff0c\u6211\u4eec\u5f97\u51fa\u5230\u89c2\u5bdf\u70b9\uff08\u5373\u6444\u50cf\u673a\u4f4d\u7f6e\uff09\u7684\u65b9\u5411\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a vec3 camera_direction = normalize(camera_pos - position); \u4f46\u662f\uff0c\u7531\u4e8e position \u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\uff0c\u6444\u50cf\u673a\u4f4d\u7f6e\u59cb\u7ec8\u4f4d\u4e8e\u539f\u70b9\uff0c\u5373 (0, 0, 0) \uff0c\u6240\u4ee5\u6211\u4eec\u6309\u5982\u4e0b\u4ee3\u7801\u8ba1\u7b97\u5b83\uff1a vec3 camera_direction = normalize(vec3(0, 0, 0) - position); \u53ef\u4ee5\u7b80\u5316\u4e3a\uff1a vec3 camera_direction = normalize(-position); \u6709\u4e86\u4e0a\u8ff0\u51fd\u6570\uff0c\u9876\u70b9\u7740\u8272\u5668\u7684\u4e3b\u51fd\u6570\u5c31\u53d8\u5f97\u975e\u5e38\u7b80\u5355\u4e86\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u8c03\u7528 setupColours \u51fd\u6570\u5c06\u4f7f\u7528\u9002\u5f53\u7684\u989c\u8272\u6765\u8bbe\u7f6e\u53d8\u91cf ambientC \u3001 diffuseC \u548c speculrC \u3002\u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u8003\u8651\u5230\u8870\u51cf\u3002\u4e3a\u4e86\u65b9\u4fbf\u8d77\u89c1\uff0c\u6211\u4eec\u4f7f\u7528\u5355\u4e2a\u51fd\u6570\u8c03\u7528\u6765\u5b9e\u73b0\u6b64\u64cd\u4f5c\uff0c\u5982\u4e0a\u6240\u8ff0\u3002\u6700\u7ec8\u7684\u989c\u8272\u662f\u901a\u8fc7\u6dfb\u52a0\u73af\u5883\u5149\u5206\u91cf\u6765\u8ba1\u7b97\u7684\uff08\u5c06 ambientC \u4e58\u4ee5\u73af\u5883\u5149\uff09\u3002\u5982\u4f60\u6240\u89c1\uff0c\u73af\u5883\u5149\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002 \u5728\u7740\u8272\u5668\u4e2d\u6211\u4eec\u5f15\u5165\u4e86\u4e00\u4e9b\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u65b0\u6982\u5ff5\uff0c\u6211\u4eec\u6b63\u5728\u5b9a\u4e49\u7ed3\u6784\u4f53\u5e76\u5c06\u5b83\u4eec\u7528\u4f5cUniform\u3002\u4f46\u6211\u4eec\u8981\u600e\u4e48\u4f20\u9012\u8fd9\u4e9b\u7ed3\u6784\u4f53\uff1f\u9996\u5148\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e24\u4e2a\u65b0\u7c7b\uff0c\u5b83\u4eec\u5efa\u6a21\u70b9\u5149\u6e90\u548c\u6750\u8d28\u5c5e\u6027\uff0c\u540d\u4e3a PointLight \u548c Material \u3002\u5b83\u4eec\u53ea\u662f\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u4eec\u3002\u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 ShaderProgram \u7c7b\u4e2d\u521b\u5efa\u65b0\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u80fd\u591f\u4e3a\u70b9\u5149\u6e90\u548c\u6750\u8d28\u7ed3\u6784\u4f53\u521b\u5efaUniform\u3002 public void createPointLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".position\"); createUniform(uniformName + \".intensity\"); createUniform(uniformName + \".att.constant\"); createUniform(uniformName + \".att.linear\"); createUniform(uniformName + \".att.exponent\"); } public void createMaterialUniform(String uniformName) throws Exception { createUniform(uniformName + \".ambient\"); createUniform(uniformName + \".diffuse\"); createUniform(uniformName + \".specular\"); createUniform(uniformName + \".hasTexture\"); createUniform(uniformName + \".reflectance\"); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4e3a\u6784\u6210\u7ed3\u6784\u4f53\u7684\u6240\u6709\u5c5e\u6027\u521b\u5efa\u4e00\u4e2a\u5355\u72ec\u7684Uniform\u3002\u73b0\u5728\u6211\u4eec\u9700\u8981\u521b\u5efa\u53e6\u5916\u4e24\u4e2a\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff0c\u5e76\u5c06 PointLight \u548c Material \u7684\u5b9e\u4f8b\u4f5c\u4e3a\u53c2\u6570\u3002 public void setUniform(String uniformName, PointLight pointLight) { setUniform(uniformName + \".colour\", pointLight.getColor() ); setUniform(uniformName + \".position\", pointLight.getPosition()); setUniform(uniformName + \".intensity\", pointLight.getIntensity()); PointLight.Attenuation att = pointLight.getAttenuation(); setUniform(uniformName + \".att.constant\", att.getConstant()); setUniform(uniformName + \".att.linear\", att.getLinear()); setUniform(uniformName + \".att.exponent\", att.getExponent()); } public void setUniform(String uniformName, Material material) { setUniform(uniformName + \".ambient\", material.getAmbientColour()); setUniform(uniformName + \".diffuse\", material.getDiffuseColour()); setUniform(uniformName + \".specular\", material.getSpecularColour()); setUniform(uniformName + \".hasTexture\", material.isTextured() ? 1 : 0); setUniform(uniformName + \".reflectance\", material.getReflectance()); } \u5728\u672c\u7ae0\u6e90\u4ee3\u7801\u4e2d\uff0c\u4f60\u8fd8\u5c06\u770b\u5230\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 Mesh \u7c7b\u6765\u50a8\u5b58\u6750\u8d28\u5b9e\u4f8b\uff0c\u5e76\u4e14\u521b\u5efa\u4e86\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u5728\u5176\u4e2d\u521b\u5efa\u4e86\u4e00\u4e2a\u53ef\u7528\u201cN\u201d\u548c\u201cM\u201d\u952e\u63a7\u5236\u79fb\u52a8\u7684\u70b9\u5149\u6e90\uff0c\u4ee5\u663e\u793a\u70b9\u5149\u6e90\u805a\u7126\u5728\u53cd\u5c04\u7387\u503c\u9ad8\u4e8e0\u7684\u7f51\u683c\u4e0a\u65f6\u662f\u600e\u6837\u7684\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u7247\u5143\u7740\u8272\u5668\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u9700\u8981\u53e6\u4e00\u4e2a\u50a8\u5b58\u6444\u50cf\u673a\u4f4d\u7f6e camera_pos \u7684Uniform\u3002\u8fd9\u4e9b\u5750\u6807\u5fc5\u987b\u4f4d\u4e8e\u89c2\u5bdf\u7a7a\u95f4\u4e2d\u3002\u901a\u5e38\u6211\u4eec\u5c06\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u8bbe\u7f6e\u5149\u6e90\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u89c2\u5bdf\u77e9\u9635\uff0c\u4ee5\u4fbf\u80fd\u591f\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\uff0c\u6240\u4ee5\u9700\u8981\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u8fd4\u56de\u89c2\u5bdf\u77e9\u9635\u4ee5\u4fbf\u53d8\u6362\u5149\u6e90\u5750\u6807\u3002 // \u83b7\u5f97\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5b83\u7684\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLight); Vector3f lightPos = currPointLight.getPosition(); Vector4f aux = new Vector4f(lightPos, 1); aux.mul(viewMatrix); lightPos.x = aux.x; lightPos.y = aux.y; lightPos.z = aux.z; shaderProgram.setUniform(\"pointLight\", currPointLight); \u6211\u4eec\u4e0d\u4f1a\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5982\u679c\u8fd9\u6837\u8fd9\u4e00\u7ae0\u5c31\u592a\u957f\u4e86\uff0c\u4e14\u5bf9\u4e8e\u89e3\u91ca\u6e05\u695a\u6982\u5ff5\u6ca1\u6709\u592a\u591a\u7684\u5e2e\u52a9\uff0c\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u9644\u5e26\u7684\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6e90\u4ee3\u7801\u3002","title":"\u5b9e\u73b0"},{"location":"11-let-there-be-even-more-light/","text":"\u8981\u6709\u66f4\u591a\u7684\u5149\uff08Let there be even more light\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9e\u73b0\u5728\u6b64\u524d\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u3002\u6211\u4eec\u5148\u4ece\u5e73\u884c\u5149\u5f00\u59cb\u3002 \u5e73\u884c\u5149 \u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\uff0c\u5e73\u884c\u5149\u4ece\u540c\u4e00\u65b9\u5411\u7167\u5c04\u5230\u6240\u6709\u7269\u4f53\u4e0a\u3002\u5b83\u7528\u6765\u6a21\u62df\u9065\u8fdc\u4f46\u5149\u5f3a\u5f88\u9ad8\u7684\u5149\u6e90\uff0c\u6bd4\u5982\u592a\u9633\u3002 \u5e73\u884c\u5149\u7684\u53e6\u4e00\u4e2a\u7279\u70b9\u662f\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u8054\u60f3\u592a\u9633\u5149\uff0c\u6240\u6709\u88ab\u9633\u5149\u7167\u5c04\u7684\u7269\u4f53\u90fd\u4ee5\u76f8\u540c\u7684\u5149\u5f3a\u88ab\u7167\u5c04\uff0c\u56e0\u4e3a\u79bb\u592a\u9633\u7684\u8ddd\u79bb\u592a\u5927\uff0c\u4ee5\u81f3\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u76f8\u5bf9\u4f4d\u7f6e\u90fd\u662f\u65e0\u5173\u7d27\u8981\u7684\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5e73\u884c\u5149\u88ab\u6a21\u62df\u4e3a\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u7684\u5149\u6e90\uff0c\u5982\u679c\u5b83\u53d7\u5230\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u90a3\u4e48\u5b83\u5c06\u5bf9\u4efb\u4f55\u7269\u4f53\u90fd\u6ca1\u6709\u5f71\u54cd\uff08\u5b83\u5bf9\u7269\u4f53\u989c\u8272\u7684\u5f71\u54cd\u5c06\u7b49\u4e8e0\uff09\u3002 \u6b64\u5916\uff0c\u5e73\u884c\u5149\u4e5f\u7531\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7ec4\u6210\uff0c\u4e0e\u70b9\u5149\u6e90\u7684\u533a\u522b\u5728\u4e8e\u5b83\u6ca1\u6709\u4f4d\u7f6e\uff0c\u4f46\u6709\u65b9\u5411\uff0c\u5e76\u4e14\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002\u56de\u5230\u5e73\u884c\u5149\u7684\u5c5e\u6027\uff0c\u60f3\u8c61\u6211\u4eec\u6b63\u5728\u6a21\u62df\u592a\u9633\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\uff0c\u4e0b\u56fe\u5c55\u793a\u4e86\u9ece\u660e\u3001\u6b63\u5348\u548c\u9ec4\u660f\u65f6\u7684\u5149\u7ebf\u65b9\u5411\u3002 \u4e0a\u56fe\u4e2d\u7684\u5149\u7ebf\u7684\u65b9\u5411\u4e3a\uff1a \u9ece\u660e: -1, 0, 0 \u6b63\u5348: 0, 1, 0 \u9ec4\u660f: 1, 0, 0 \u6ce8\u610f\uff1a\u4f60\u53ef\u80fd\u8ba4\u4e3a\u4e0a\u8ff0\u5750\u6807\u662f\u4f4d\u7f6e\u5750\u6807\uff0c\u4f46\u5b83\u4eec\u53ea\u662f\u4e00\u4e2a\u77e2\u91cf\uff0c\u4e00\u4e2a\u65b9\u5411\uff0c\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u4ee5\u6570\u5b66\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u77e2\u91cf\u548c\u4f4d\u7f6e\u662f\u4e0d\u53ef\u5206\u8fa8\u7684\uff0c\u4f46\u5b83\u4eec\u6709\u7740\u5b8c\u5168\u4e0d\u540c\u7684\u542b\u4e49\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u6a21\u62df\u8fd9\u4e2a\u5149\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528 w \u5206\u91cf\uff0c\u5373\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u5e76\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u9ece\u660e: -1, 0, 0, 0 \u6b63\u5348: 0, 1, 0, 0 \u9ec4\u660f: 1, 0, 0, 0 \u8fd9\u5c31\u5982\u540c\u6211\u4eec\u5728\u4f20\u9012\u6cd5\u7ebf\u3002\u5bf9\u4e8e\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c06\u5176 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \uff0c\u8868\u793a\u6211\u4eec\u5bf9\u5176\u4f4d\u79fb\u4e0d\u611f\u5174\u8da3\uff0c\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u6b64\u5916\uff0c\u5f53\u6211\u4eec\u5904\u7406\u5e73\u884c\u5149\u65f6\uff0c\u4e5f\u9700\u8981\u8fd9\u6837\u505a\uff0c\u6444\u50cf\u673a\u7684\u4f4d\u79fb\u4e0d\u5e94\u5f71\u54cd\u5e73\u884c\u5149\u7684\u65b9\u5411\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5b9e\u73b0\u548c\u6a21\u62df\u5e73\u884c\u5149\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2a\u7c7b\u6765\u50a8\u5b58\u5b83\u7684\u5c5e\u6027\u3002\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u5176\u5177\u6709\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u5e76\u50a8\u5b58\u5149\u7684\u65b9\u5411\u3001\u989c\u8272\u548c\u5f3a\u5ea6\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class DirectionalLight { private Vector3f color; private Vector3f direction; private float intensity; public DirectionalLight(Vector3f color, Vector3f direction, float intensity) { this.color = color; this.direction = direction; this.intensity = intensity; } public DirectionalLight(DirectionalLight light) { this(new Vector3f(light.getColor()), new Vector3f(light.getDirection()), light.getIntensity()); } // \u63a5\u4e0b\u6765\u662fGetter\u548cSetter... \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528 Vector3f \u6765\u50a8\u5b58\u65b9\u5411\u3002\u4fdd\u6301\u51b7\u9759\uff0c\u5f53\u5c06\u5e73\u884c\u5149\u4f20\u9012\u5230\u7740\u8272\u5668\u65f6\uff0c\u6211\u4eec\u5c06\u5904\u7406 w \u5206\u91cf\u3002\u987a\u4fbf\u4e00\u63d0\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u5c31\u662f\u66f4\u65b0 ShaderProgram \u6765\u521b\u5efa\u548c\u66f4\u65b0\u50a8\u5b58\u5e73\u884c\u5149\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\u3002 struct DirectionalLight { vec3 colour; vec3 direction; float intensity; }; \u6709\u4e86\u4e0a\u8ff0\u5b9a\u4e49\uff0c ShaderProgram \u7c7b\u4e2d\u7684\u65b0\u65b9\u6cd5\u5c31\u5f88\u7b80\u5355\u4e86\u3002 // ... public void createDirectionalLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".direction\"); createUniform(uniformName + \".intensity\"); } // ... public void setUniform(String uniformName, DirectionalLight dirLight) { setUniform(uniformName + \".colour\", dirLight.getColor() ); setUniform(uniformName + \".direction\", dirLight.getDirection()); setUniform(uniformName + \".intensity\", dirLight.getIntensity()); } \u6211\u4eec\u73b0\u5728\u9700\u8981\u4f7f\u7528Uniform\uff0c\u901a\u8fc7 DummyGame \u7c7b\u63a7\u5236\u592a\u9633\u7684\u89d2\u5ea6\u6765\u6a21\u62df\u5b83\u662f\u5982\u4f55\u5728\u5929\u4e0a\u79fb\u52a8\u7684\u3002 \u6211\u4eec\u9700\u8981\u66f4\u65b0\u5149\u7684\u65b9\u5411\uff0c\u6240\u4ee5\u592a\u9633\u5728\u9ece\u660e\u65f6\uff08 -90\u00b0 \uff09\uff0c\u5149\u7ebf\u5728 (-1, 0, 0) \u65b9\u5411\u4e0a\uff0c\u5176 x \u5206\u91cf\u4ece -1 \u9010\u6e10\u589e\u52a0\u5230 0 \uff0c y \u5206\u91cf\u9010\u6e10\u4ece 0 \u589e\u52a0\u5230 1 \u3002\u63a5\u4e0b\u6765\uff0c x \u5206\u91cf\u589e\u52a0\u5230 1 \uff0c y \u5206\u91cf\u51cf\u5c11\u5230 0 \u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06 x \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u6b63\u5f26\u548c\u5c06 y \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u4f59\u5f26\u6765\u5b9e\u73b0\u3002 \u6211\u4eec\u4e5f\u4f1a\u8c03\u8282\u5149\u5f3a\uff0c\u5f53\u5b83\u8fdc\u79bb\u9ece\u660e\u65f6\u5f3a\u5ea6\u5c06\u589e\u5f3a\uff0c\u5f53\u5b83\u4e34\u8fd1\u9ec4\u660f\u65f6\u5f3a\u5ea6\u5c06\u51cf\u5f31\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u5f3a\u5ea6\u8bbe\u7f6e\u4e3a 0 \u6765\u6a21\u62df\u591c\u665a\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u8c03\u8282\u989c\u8272\uff0c\u4f7f\u5149\u5728\u9ece\u660e\u548c\u9ec4\u660f\u65f6\u53d8\u5f97\u66f4\u7ea2\u3002\u8fd9\u5c06\u5728 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u4e2d\u5b9e\u73b0\u3002 // \u66f4\u65b0\u5e73\u884c\u5149\u7684\u65b9\u5411\uff0c\u5f3a\u5ea6\u548c\u989c\u8272 lightAngle += 1.1f; if (lightAngle > 90) { directionalLight.setIntensity(0); if (lightAngle >= 360) { lightAngle = -90; } } else if (lightAngle <= -80 || lightAngle >= 80) { float factor = 1 - (float)(Math.abs(lightAngle) - 80)/ 10.0f; directionalLight.setIntensity(factor); directionalLight.getColor().y = Math.max(factor, 0.9f); directionalLight.getColor().z = Math.max(factor, 0.5f); } else { directionalLight.setIntensity(1); directionalLight.getColor().x = 1; directionalLight.getColor().y = 1; directionalLight.getColor().z = 1; } double angRad = Math.toRadians(lightAngle); directionalLight.getDirection().x = (float) Math.sin(angRad); directionalLight.getDirection().y = (float) Math.cos(angRad); \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u7684 render \u65b9\u6cd5\u4e2d\u5c06\u5e73\u884c\u5149\u4f20\u7ed9\u7740\u8272\u5668\u3002 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(directionalLight); Vector4f dir = new Vector4f(currDirLight.getDirection(), 0); dir.mul(viewMatrix); currDirLight.setDirection(new Vector3f(dir.x, dir.y, dir.z)); shaderProgram.setUniform(\"directionalLight\", currDirLight); \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u53d8\u6362\u5149\u7684\u65b9\u5411\u5230\u89c2\u5bdf\u7a7a\u95f4\uff0c\u4f46\u6211\u4eec\u4e0d\u60f3\u5e94\u7528\u4f4d\u79fb\uff0c\u6240\u4ee5\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u5728\u7247\u5143\u7740\u8272\u5668\u4e0a\u5b8c\u6210\u5269\u4e0b\u7684\u5de5\u4f5c\u4e86\uff0c\u56e0\u4e3a\u9876\u70b9\u7740\u8272\u5668\u4e0d\u9700\u8981\u4fee\u6539\u3002\u6b64\u524d\u5df2\u7ecf\u8bf4\u8fc7\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a DirectionalLight \u7684\u65b0\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\uff0c\u6240\u4ee5\u9700\u8981\u4e00\u4e2a\u65b0\u7684Uniform\u3002 uniform DirectionalLight directionalLight; \u6211\u4eec\u9700\u8981\u91cd\u6784\u4e00\u4e0b\u4ee3\u7801\uff0c\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a calcPointLight \u7684\u51fd\u6570\uff0c\u5b83\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u5e94\u7528\u8870\u51cf\u3002\u4f46\u5982\u4e0a\u6240\u8ff0\uff0c\u5e73\u884c\u5149\u4f7f\u7528\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u4f46\u4e0d\u53d7\u8870\u51cf\u5f71\u54cd\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcLightColour \u7684\u65b0\u51fd\u6570\u6765\u8ba1\u7b97\u90a3\u4e9b\u5206\u91cf\u3002 vec4 calcLightColour(vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04\u5149 float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04\u5149 vec3 camera_direction = normalize(camera_pos - position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * material.reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } \u7136\u540e\uff0c calcPointLight \u65b9\u6cd5\u5c06\u8870\u51cf\u56e0\u6570\u5e94\u7528\u5230\u4e0a\u8ff0\u51fd\u6570\u8ba1\u7b97\u7684\u7ed3\u679c\u4e0a\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(light.colour, light.intensity, position, to_light_dir, normal); // \u5e94\u7528\u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u5e73\u884c\u5149\u7684\u6548\u679c\uff0c\u5b83\u53ea\u8c03\u7528\u4ec5\u9700\u5149\u7167\u65b9\u5411\u7684 calcLightColour \u65b9\u6cd5\u3002 vec4 calcDirectionalLight(DirectionalLight light, vec3 position, vec3 normal) { return calcLightColour(light.colour, light.intensity, position, normalize(light.direction), normal); } \u6700\u540e\uff0c main \u65b9\u6cd5\u901a\u8fc7\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u7684\u989c\u8272\u5206\u91cf\u7efc\u5408\u8d77\u6765\u8ba1\u7b97\u7247\u5143\u989c\u8272\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcDirectionalLight(directionalLight, mvVertexPos, mvVertexNormal); diffuseSpecularComp += calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u5c31\u8fd9\u6837\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u6a21\u62df\u592a\u9633\u5728\u5929\u7a7a\u4e2d\u7684\u8fd0\u52a8\uff0c\u5982\u4e0b\u6240\u793a\uff08\u5728\u793a\u4f8b\u4ee3\u7801\u4e2d\u8fd0\u52a8\u901f\u5ea6\u52a0\u5feb\uff0c\u4e0d\u7528\u7b49\u5f85\u592a\u4e45\u5c31\u53ef\u4ee5\u770b\u5230\uff09\u3002 \u805a\u5149\u6e90 \u73b0\u5728\u6211\u4eec\u5c06\u5b9e\u73b0\u4e0e\u70b9\u5149\u6e90\u975e\u5e38\u76f8\u4f3c\u7684\u805a\u5149\u6e90\uff0c\u4f46\u662f\u5b83\u53d1\u5c04\u7684\u5149\u4ec5\u9650\u4e8e\u4e09\u7ef4\u5706\u9525\u4f53\u4e2d\u3002\u5b83\u6a21\u62df\u4ece\u7126\u70b9\u6216\u4efb\u4f55\u5176\u4ed6\u4e0d\u5411\u6240\u6709\u65b9\u5411\u53d1\u5c04\u5149\u7684\u5149\u6e90\u3002\u805a\u5149\u6e90\u6709\u7740\u548c\u70b9\u5149\u6e90\u4e00\u6837\u7684\u5c5e\u6027\uff0c\u4f46\u5b83\u6dfb\u52a0\u4e86\u4e24\u4e2a\u65b0\u7684\u53c2\u6570\uff0c\u5706\u9525\u89d2\u548c\u5706\u9525\u65b9\u5411\u3002 \u805a\u5149\u6e90\u4e0e\u70b9\u5149\u6e90\u7684\u8ba1\u7b97\u65b9\u6cd5\u76f8\u540c\uff0c\u4f46\u6709\u4e00\u4e9b\u4e0d\u540c\u3002\u4ece\u9876\u70b9\u4f4d\u7f6e\u5230\u5149\u6e90\u7684\u77e2\u91cf\u4e0d\u5728\u5149\u9525\u5185\u7684\u70b9\u4e0d\u53d7\u5149\u7167\u7684\u5f71\u54cd\u3002 \u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\u662f\u5426\u5728\u5149\u9525\u5185\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u548c\u5706\u9525\u65b9\u5411\u77e2\u91cf\uff08\u4e24\u8005\u90fd\u5f52\u4e00\u5316\u4e86\uff09\u4e4b\u95f4\u518d\u505a\u6b21\u6570\u91cf\u79ef\u3002 L \u548c C \u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\u7b49\u4e8e\uff1a \\vec{L}\\cdot\\vec{C}=|\\vec{L}|\\cdot|\\vec{C}|\\cdot Cos(\\alpha) \u3002\u5728\u805a\u5149\u6e90\u7684\u5b9a\u4e49\u4e2d\uff0c\u6211\u4eec\u50a8\u5b58\u9525\u89d2\u7684\u4f59\u5f26\u503c\uff0c\u5982\u679c\u6570\u91cf\u79ef\u9ad8\u4e8e\u8be5\u503c\uff0c\u6211\u4eec\u5c31\u77e5\u9053\u5b83\u4f4d\u4e8e\u5149\u9525\u5185\u90e8\uff08\u60f3\u60f3\u4f59\u5f26\u56fe\uff0c\u5f53 \u03b1 \u89d2\u4e3a 0 \u65f6\uff0c\u5176\u4f59\u5f26\u503c\u4e3a 1 \u3002\u57280\u00b0~180\u00b0\u65f6\uff0c\u89d2\u5ea6\u8d8a\u5c0f\u4f59\u5f26\u503c\u8d8a\u5927\uff09\u3002 \u7b2c\u4e8c\u4e2a\u4e0d\u540c\u4e4b\u5904\u662f\u8fdc\u79bb\u5149\u9525\u65b9\u5411\u7684\u70b9\u5c06\u53d7\u5230\u66f4\u5c11\u7684\u5149\u7167\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u8870\u51cf\u5f71\u54cd\u5c06\u66f4\u5f3a\u3002\u6709\u51e0\u79cd\u8ba1\u7b97\u65b9\u6cd5\uff0c\u6211\u4eec\u5c06\u9009\u62e9\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u5c06\u8870\u51cf\u4e0e\u4e0b\u8ff0\u516c\u5f0f\u76f8\u4e58\uff1a 1 - (1-Cos(\\alpha))/(1-Cos(cutOffAngle) (\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u6ca1\u6709\u4f20\u9012\u89d2\u5ea6\uff0c\u800c\u662f\u4f20\u9012\u89d2\u5ea6\u7684\u4f59\u5f26\u503c\u3002\u4f60\u53ef\u4ee5\u68c0\u67e5\u4e0a\u9762\u7684\u516c\u5f0f\u7684\u7ed3\u679c\u662f\u5426\u4f4d\u4e8e0\u52301\u4e4b\u95f4\uff0c\u5f53\u89d2\u5ea6\u4e3a0\u65f6\uff0c\u4f59\u5f26\u503c\u4e3a1\u3002) \u5b9e\u73b0\u975e\u5e38\u7c7b\u4f3c\u4e8e\u5176\u4ed6\u7684\u5149\u6e90\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SpotLight \u7684\u7c7b\uff0c\u8bbe\u7f6e\u9002\u5f53\u7684Uniform\uff0c\u5c06\u5176\u4f20\u9012\u7ed9\u7740\u8272\u5668\u5e76\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u4ee5\u83b7\u53d6\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u3002 \u5f53\u4f20\u9012Uniform\u65f6\uff0c\u53e6\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u662f\u4f4d\u79fb\u4e0d\u5e94\u8be5\u5e94\u7528\u5230\u5149\u9525\u65b9\u5411\u4e0a\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u56e0\u6b64\uff0c\u548c\u5e73\u884c\u5149\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u5f53\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u65f6\uff0c\u5fc5\u987b\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u591a\u5149\u6e90 \u6211\u4eec\u7ec8\u4e8e\u5b9e\u73b0\u4e86\u56db\u79cd\u7c7b\u578b\u7684\u5149\u6e90\uff0c\u4f46\u662f\u76ee\u524d\u6bcf\u79cd\u7c7b\u578b\u7684\u5149\u6e90\u53ea\u80fd\u4f7f\u7528\u4e00\u4e2a\u5b9e\u4f8b\u3002\u8fd9\u5bf9\u4e8e\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8bf4\u6ca1\u95ee\u9898\uff0c\u4f46\u662f\u6211\u4eec\u786e\u5b9e\u5e0c\u671b\u4f7f\u7528\u591a\u4e2a\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u6765\u63a5\u6536\u5149\u6e90\u5217\u8868\uff0c\u6240\u4ee5\u4f7f\u7528\u6570\u7ec4\u6765\u50a8\u5b58\u8fd9\u4e9b\u6570\u636e\u3002\u6765\u770b\u770b\u600e\u4e48\u5b9e\u73b0\u5427\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5728GLSL\u4e2d\uff0c\u6570\u7ec4\u7684\u957f\u5ea6\u5fc5\u987b\u5728\u7f16\u8bd1\u65f6\u8bbe\u7f6e\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u8db3\u591f\u5927\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u80fd\u591f\u50a8\u5b58\u6240\u9700\u7684\u6240\u6709\u5bf9\u8c61\u3002\u9996\u5148\u662f\u5b9a\u4e49\u4e00\u4e9b\u5e38\u91cf\u6765\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u6700\u5927\u70b9\u5149\u6e90\u6570\u548c\u805a\u5149\u6e90\u6570\u3002 const int MAX_POINT_LIGHTS = 5; const int MAX_SPOT_LIGHTS = 5; \u7136\u540e\u6211\u4eec\u9700\u8981\u4fee\u6539\u6b64\u524d\u53ea\u50a8\u5b58\u4e00\u4e2a\u70b9\u5149\u6e90\u548c\u4e00\u4e2a\u805a\u5149\u6e90\u7684Uniform\uff0c\u4ee5\u4fbf\u4f7f\u7528\u6570\u7ec4\u3002 uniform PointLight pointLights[MAX_POINT_LIGHTS]; uniform SpotLight spotLights[MAX_SPOT_LIGHTS]; \u5728main\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5bf9\u8fd9\u4e9b\u6570\u7ec4\u8fdb\u884c\u8fed\u4ee3\uff0c\u4ee5\u4f7f\u7528\u73b0\u6709\u51fd\u6570\u8ba1\u7b97\u6bcf\u4e2a\u5bf9\u8c61\u5bf9\u989c\u8272\u7684\u5f71\u54cd\u3002\u6211\u4eec\u53ef\u80fd\u4e0d\u4f1a\u50cfUniform\u6570\u7ec4\u957f\u5ea6\u90a3\u6837\u4f20\u9012\u5f88\u591a\u5149\u6e90\uff0c\u6240\u4ee5\u9700\u8981\u63a7\u5236\u5b83\u3002\u6709\u5f88\u591a\u53ef\u884c\u7684\u65b9\u6cd5\uff0c\u4f46\u8fd9\u53ef\u80fd\u4e0d\u9002\u7528\u4e8e\u65e7\u7684\u663e\u5361\u3002\u6700\u7ec8\u6211\u4eec\u9009\u62e9\u68c0\u67e5\u5149\u5f3a\uff08\u5728\u6570\u7ec4\u4e2d\u7684\u7a7a\u4f4d\uff0c\u5149\u5f3a\u4e3a0\uff09\u3002 for (int i=0; i<MAX_POINT_LIGHTS; i++) { if ( pointLights[i].intensity > 0 ) { diffuseSpecularComp += calcPointLight(pointLights[i], mvVertexPos, mvVertexNormal); } } for (int i=0; i<MAX_SPOT_LIGHTS; i++) { if ( spotLights[i].pl.intensity > 0 ) { diffuseSpecularComp += calcSpotLight(spotLights[i], mvVertexPos, mvVertexNormal); } } \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728 Render \u7c7b\u4e2d\u521b\u5efa\u8fd9\u4e9bUniform\u3002\u5f53\u4f7f\u7528\u6570\u7ec4\u65f6\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u5217\u8868\u4e2d\u7684\u6bcf\u4e2a\u5143\u7d20\u521b\u5efa\u4e00\u4e2aUniform\u3002\u4f8b\u5982\uff0c\u5bf9\u4e8e pointLights \u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u540d\u4e3a pointLights[0] \u3001 pointLights[1] \u4e4b\u7c7b\u7684Uniform\u3002\u5f53\u7136\uff0c\u8fd9\u4e5f\u9002\u7528\u4e8e\u7ed3\u6784\u4f53\u5c5e\u6027\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa pointLights[0].colour \u3001 pointLights[1].colour \u7b49\u7b49\u3002\u521b\u5efa\u8fd9\u4e9bUniform\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a public void createPointLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createPointLightUniform(uniformName + \"[\" + i + \"]\"); } } public void createSpotLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createSpotLightUniform(uniformName + \"[\" + i + \"]\"); } } \u6211\u4eec\u4e5f\u9700\u8981\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff1a public void setUniform(String uniformName, PointLight[] pointLights) { int numLights = pointLights != null ? pointLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, pointLights[i], i); } } public void setUniform(String uniformName, PointLight pointLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", pointLight); } public void setUniform(String uniformName, SpotLight[] spotLights) { int numLights = spotLights != null ? spotLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, spotLights[i], i); } } public void setUniform(String uniformName, SpotLight spotLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", spotLight); } \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u66f4\u65b0 Render \u7c7b\u6765\u63a5\u6536\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u5217\u8868\uff0c\u5e76\u76f8\u5e94\u5730\u4fee\u6539 DummyGame \u7c7b\u4ee5\u521b\u5efa\u8fd9\u4e9b\u5217\u8868\uff0c\u6700\u7ec8\u6548\u679c\u5982\u4e0b\u6240\u793a\u3002","title":"\u8981\u6709\u66f4\u591a\u7684\u5149"},{"location":"11-let-there-be-even-more-light/#let-there-be-even-more-light","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9e\u73b0\u5728\u6b64\u524d\u7ae0\u8282\u4e2d\u4ecb\u7ecd\u7684\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u3002\u6211\u4eec\u5148\u4ece\u5e73\u884c\u5149\u5f00\u59cb\u3002","title":"\u8981\u6709\u66f4\u591a\u7684\u5149\uff08Let there be even more light\uff09"},{"location":"11-let-there-be-even-more-light/#_1","text":"\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\uff0c\u5e73\u884c\u5149\u4ece\u540c\u4e00\u65b9\u5411\u7167\u5c04\u5230\u6240\u6709\u7269\u4f53\u4e0a\u3002\u5b83\u7528\u6765\u6a21\u62df\u9065\u8fdc\u4f46\u5149\u5f3a\u5f88\u9ad8\u7684\u5149\u6e90\uff0c\u6bd4\u5982\u592a\u9633\u3002 \u5e73\u884c\u5149\u7684\u53e6\u4e00\u4e2a\u7279\u70b9\u662f\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u8054\u60f3\u592a\u9633\u5149\uff0c\u6240\u6709\u88ab\u9633\u5149\u7167\u5c04\u7684\u7269\u4f53\u90fd\u4ee5\u76f8\u540c\u7684\u5149\u5f3a\u88ab\u7167\u5c04\uff0c\u56e0\u4e3a\u79bb\u592a\u9633\u7684\u8ddd\u79bb\u592a\u5927\uff0c\u4ee5\u81f3\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u76f8\u5bf9\u4f4d\u7f6e\u90fd\u662f\u65e0\u5173\u7d27\u8981\u7684\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5e73\u884c\u5149\u88ab\u6a21\u62df\u4e3a\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u7684\u5149\u6e90\uff0c\u5982\u679c\u5b83\u53d7\u5230\u8870\u51cf\u7684\u5f71\u54cd\uff0c\u90a3\u4e48\u5b83\u5c06\u5bf9\u4efb\u4f55\u7269\u4f53\u90fd\u6ca1\u6709\u5f71\u54cd\uff08\u5b83\u5bf9\u7269\u4f53\u989c\u8272\u7684\u5f71\u54cd\u5c06\u7b49\u4e8e0\uff09\u3002 \u6b64\u5916\uff0c\u5e73\u884c\u5149\u4e5f\u7531\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\u7ec4\u6210\uff0c\u4e0e\u70b9\u5149\u6e90\u7684\u533a\u522b\u5728\u4e8e\u5b83\u6ca1\u6709\u4f4d\u7f6e\uff0c\u4f46\u6709\u65b9\u5411\uff0c\u5e76\u4e14\u5b83\u4e0d\u53d7\u8870\u51cf\u7684\u5f71\u54cd\u3002\u56de\u5230\u5e73\u884c\u5149\u7684\u5c5e\u6027\uff0c\u60f3\u8c61\u6211\u4eec\u6b63\u5728\u6a21\u62df\u592a\u9633\u5728\u4e09\u7ef4\u4e16\u754c\u4e2d\u8fd0\u52a8\uff0c\u4e0b\u56fe\u5c55\u793a\u4e86\u9ece\u660e\u3001\u6b63\u5348\u548c\u9ec4\u660f\u65f6\u7684\u5149\u7ebf\u65b9\u5411\u3002 \u4e0a\u56fe\u4e2d\u7684\u5149\u7ebf\u7684\u65b9\u5411\u4e3a\uff1a \u9ece\u660e: -1, 0, 0 \u6b63\u5348: 0, 1, 0 \u9ec4\u660f: 1, 0, 0 \u6ce8\u610f\uff1a\u4f60\u53ef\u80fd\u8ba4\u4e3a\u4e0a\u8ff0\u5750\u6807\u662f\u4f4d\u7f6e\u5750\u6807\uff0c\u4f46\u5b83\u4eec\u53ea\u662f\u4e00\u4e2a\u77e2\u91cf\uff0c\u4e00\u4e2a\u65b9\u5411\uff0c\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u4ee5\u6570\u5b66\u7684\u89d2\u5ea6\u6765\u770b\uff0c\u77e2\u91cf\u548c\u4f4d\u7f6e\u662f\u4e0d\u53ef\u5206\u8fa8\u7684\uff0c\u4f46\u5b83\u4eec\u6709\u7740\u5b8c\u5168\u4e0d\u540c\u7684\u542b\u4e49\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u6a21\u62df\u8fd9\u4e2a\u5149\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528 w \u5206\u91cf\uff0c\u5373\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u5e76\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u9ece\u660e: -1, 0, 0, 0 \u6b63\u5348: 0, 1, 0, 0 \u9ec4\u660f: 1, 0, 0, 0 \u8fd9\u5c31\u5982\u540c\u6211\u4eec\u5728\u4f20\u9012\u6cd5\u7ebf\u3002\u5bf9\u4e8e\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c06\u5176 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \uff0c\u8868\u793a\u6211\u4eec\u5bf9\u5176\u4f4d\u79fb\u4e0d\u611f\u5174\u8da3\uff0c\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u6b64\u5916\uff0c\u5f53\u6211\u4eec\u5904\u7406\u5e73\u884c\u5149\u65f6\uff0c\u4e5f\u9700\u8981\u8fd9\u6837\u505a\uff0c\u6444\u50cf\u673a\u7684\u4f4d\u79fb\u4e0d\u5e94\u5f71\u54cd\u5e73\u884c\u5149\u7684\u65b9\u5411\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5b9e\u73b0\u548c\u6a21\u62df\u5e73\u884c\u5149\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2a\u7c7b\u6765\u50a8\u5b58\u5b83\u7684\u5c5e\u6027\u3002\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u666e\u901a\u7684Java\u5bf9\u8c61\uff0c\u5176\u5177\u6709\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u5e76\u50a8\u5b58\u5149\u7684\u65b9\u5411\u3001\u989c\u8272\u548c\u5f3a\u5ea6\u3002 package org.lwjglb.engine.graph; import org.joml.Vector3f; public class DirectionalLight { private Vector3f color; private Vector3f direction; private float intensity; public DirectionalLight(Vector3f color, Vector3f direction, float intensity) { this.color = color; this.direction = direction; this.intensity = intensity; } public DirectionalLight(DirectionalLight light) { this(new Vector3f(light.getColor()), new Vector3f(light.getDirection()), light.getIntensity()); } // \u63a5\u4e0b\u6765\u662fGetter\u548cSetter... \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u7528 Vector3f \u6765\u50a8\u5b58\u65b9\u5411\u3002\u4fdd\u6301\u51b7\u9759\uff0c\u5f53\u5c06\u5e73\u884c\u5149\u4f20\u9012\u5230\u7740\u8272\u5668\u65f6\uff0c\u6211\u4eec\u5c06\u5904\u7406 w \u5206\u91cf\u3002\u987a\u4fbf\u4e00\u63d0\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u5c31\u662f\u66f4\u65b0 ShaderProgram \u6765\u521b\u5efa\u548c\u66f4\u65b0\u50a8\u5b58\u5e73\u884c\u5149\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u5b9a\u4e49\u4e00\u4e2a\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\u3002 struct DirectionalLight { vec3 colour; vec3 direction; float intensity; }; \u6709\u4e86\u4e0a\u8ff0\u5b9a\u4e49\uff0c ShaderProgram \u7c7b\u4e2d\u7684\u65b0\u65b9\u6cd5\u5c31\u5f88\u7b80\u5355\u4e86\u3002 // ... public void createDirectionalLightUniform(String uniformName) throws Exception { createUniform(uniformName + \".colour\"); createUniform(uniformName + \".direction\"); createUniform(uniformName + \".intensity\"); } // ... public void setUniform(String uniformName, DirectionalLight dirLight) { setUniform(uniformName + \".colour\", dirLight.getColor() ); setUniform(uniformName + \".direction\", dirLight.getDirection()); setUniform(uniformName + \".intensity\", dirLight.getIntensity()); } \u6211\u4eec\u73b0\u5728\u9700\u8981\u4f7f\u7528Uniform\uff0c\u901a\u8fc7 DummyGame \u7c7b\u63a7\u5236\u592a\u9633\u7684\u89d2\u5ea6\u6765\u6a21\u62df\u5b83\u662f\u5982\u4f55\u5728\u5929\u4e0a\u79fb\u52a8\u7684\u3002 \u6211\u4eec\u9700\u8981\u66f4\u65b0\u5149\u7684\u65b9\u5411\uff0c\u6240\u4ee5\u592a\u9633\u5728\u9ece\u660e\u65f6\uff08 -90\u00b0 \uff09\uff0c\u5149\u7ebf\u5728 (-1, 0, 0) \u65b9\u5411\u4e0a\uff0c\u5176 x \u5206\u91cf\u4ece -1 \u9010\u6e10\u589e\u52a0\u5230 0 \uff0c y \u5206\u91cf\u9010\u6e10\u4ece 0 \u589e\u52a0\u5230 1 \u3002\u63a5\u4e0b\u6765\uff0c x \u5206\u91cf\u589e\u52a0\u5230 1 \uff0c y \u5206\u91cf\u51cf\u5c11\u5230 0 \u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06 x \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u6b63\u5f26\u548c\u5c06 y \u5206\u91cf\u8bbe\u7f6e\u4e3a\u89d2\u7684\u4f59\u5f26\u6765\u5b9e\u73b0\u3002 \u6211\u4eec\u4e5f\u4f1a\u8c03\u8282\u5149\u5f3a\uff0c\u5f53\u5b83\u8fdc\u79bb\u9ece\u660e\u65f6\u5f3a\u5ea6\u5c06\u589e\u5f3a\uff0c\u5f53\u5b83\u4e34\u8fd1\u9ec4\u660f\u65f6\u5f3a\u5ea6\u5c06\u51cf\u5f31\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u5f3a\u5ea6\u8bbe\u7f6e\u4e3a 0 \u6765\u6a21\u62df\u591c\u665a\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u8c03\u8282\u989c\u8272\uff0c\u4f7f\u5149\u5728\u9ece\u660e\u548c\u9ec4\u660f\u65f6\u53d8\u5f97\u66f4\u7ea2\u3002\u8fd9\u5c06\u5728 DummyGame \u7c7b\u7684 update \u65b9\u6cd5\u4e2d\u5b9e\u73b0\u3002 // \u66f4\u65b0\u5e73\u884c\u5149\u7684\u65b9\u5411\uff0c\u5f3a\u5ea6\u548c\u989c\u8272 lightAngle += 1.1f; if (lightAngle > 90) { directionalLight.setIntensity(0); if (lightAngle >= 360) { lightAngle = -90; } } else if (lightAngle <= -80 || lightAngle >= 80) { float factor = 1 - (float)(Math.abs(lightAngle) - 80)/ 10.0f; directionalLight.setIntensity(factor); directionalLight.getColor().y = Math.max(factor, 0.9f); directionalLight.getColor().z = Math.max(factor, 0.5f); } else { directionalLight.setIntensity(1); directionalLight.getColor().x = 1; directionalLight.getColor().y = 1; directionalLight.getColor().z = 1; } double angRad = Math.toRadians(lightAngle); directionalLight.getDirection().x = (float) Math.sin(angRad); directionalLight.getDirection().y = (float) Math.cos(angRad); \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u7684 render \u65b9\u6cd5\u4e2d\u5c06\u5e73\u884c\u5149\u4f20\u7ed9\u7740\u8272\u5668\u3002 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(directionalLight); Vector4f dir = new Vector4f(currDirLight.getDirection(), 0); dir.mul(viewMatrix); currDirLight.setDirection(new Vector3f(dir.x, dir.y, dir.z)); shaderProgram.setUniform(\"directionalLight\", currDirLight); \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u53d8\u6362\u5149\u7684\u65b9\u5411\u5230\u89c2\u5bdf\u7a7a\u95f4\uff0c\u4f46\u6211\u4eec\u4e0d\u60f3\u5e94\u7528\u4f4d\u79fb\uff0c\u6240\u4ee5\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002 \u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u51c6\u5907\u597d\u5728\u7247\u5143\u7740\u8272\u5668\u4e0a\u5b8c\u6210\u5269\u4e0b\u7684\u5de5\u4f5c\u4e86\uff0c\u56e0\u4e3a\u9876\u70b9\u7740\u8272\u5668\u4e0d\u9700\u8981\u4fee\u6539\u3002\u6b64\u524d\u5df2\u7ecf\u8bf4\u8fc7\uff0c\u6211\u4eec\u9700\u8981\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a DirectionalLight \u7684\u65b0\u7ed3\u6784\u4f53\u6765\u6a21\u62df\u5e73\u884c\u5149\uff0c\u6240\u4ee5\u9700\u8981\u4e00\u4e2a\u65b0\u7684Uniform\u3002 uniform DirectionalLight directionalLight; \u6211\u4eec\u9700\u8981\u91cd\u6784\u4e00\u4e0b\u4ee3\u7801\uff0c\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a calcPointLight \u7684\u51fd\u6570\uff0c\u5b83\u8ba1\u7b97\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u5e76\u5e94\u7528\u8870\u51cf\u3002\u4f46\u5982\u4e0a\u6240\u8ff0\uff0c\u5e73\u884c\u5149\u4f7f\u7528\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u5206\u91cf\uff0c\u4f46\u4e0d\u53d7\u8870\u51cf\u5f71\u54cd\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcLightColour \u7684\u65b0\u51fd\u6570\u6765\u8ba1\u7b97\u90a3\u4e9b\u5206\u91cf\u3002 vec4 calcLightColour(vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 0); vec4 specColour = vec4(0, 0, 0, 0); // \u6f2b\u53cd\u5c04\u5149 float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // \u955c\u9762\u53cd\u5c04\u5149 vec3 camera_direction = normalize(camera_pos - position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * material.reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } \u7136\u540e\uff0c calcPointLight \u65b9\u6cd5\u5c06\u8870\u51cf\u56e0\u6570\u5e94\u7528\u5230\u4e0a\u8ff0\u51fd\u6570\u8ba1\u7b97\u7684\u7ed3\u679c\u4e0a\u3002 vec4 calcPointLight(PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(light.colour, light.intensity, position, to_light_dir, normal); // \u5e94\u7528\u8870\u51cf float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u5e73\u884c\u5149\u7684\u6548\u679c\uff0c\u5b83\u53ea\u8c03\u7528\u4ec5\u9700\u5149\u7167\u65b9\u5411\u7684 calcLightColour \u65b9\u6cd5\u3002 vec4 calcDirectionalLight(DirectionalLight light, vec3 position, vec3 normal) { return calcLightColour(light.colour, light.intensity, position, normalize(light.direction), normal); } \u6700\u540e\uff0c main \u65b9\u6cd5\u901a\u8fc7\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u7684\u989c\u8272\u5206\u91cf\u7efc\u5408\u8d77\u6765\u8ba1\u7b97\u7247\u5143\u989c\u8272\u3002 void main() { setupColours(material, outTexCoord); vec4 diffuseSpecularComp = calcDirectionalLight(directionalLight, mvVertexPos, mvVertexNormal); diffuseSpecularComp += calcPointLight(pointLight, mvVertexPos, mvVertexNormal); fragColor = ambientC * vec4(ambientLight, 1) + diffuseSpecularComp; } \u5c31\u8fd9\u6837\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u6a21\u62df\u592a\u9633\u5728\u5929\u7a7a\u4e2d\u7684\u8fd0\u52a8\uff0c\u5982\u4e0b\u6240\u793a\uff08\u5728\u793a\u4f8b\u4ee3\u7801\u4e2d\u8fd0\u52a8\u901f\u5ea6\u52a0\u5feb\uff0c\u4e0d\u7528\u7b49\u5f85\u592a\u4e45\u5c31\u53ef\u4ee5\u770b\u5230\uff09\u3002","title":"\u5e73\u884c\u5149"},{"location":"11-let-there-be-even-more-light/#_2","text":"\u73b0\u5728\u6211\u4eec\u5c06\u5b9e\u73b0\u4e0e\u70b9\u5149\u6e90\u975e\u5e38\u76f8\u4f3c\u7684\u805a\u5149\u6e90\uff0c\u4f46\u662f\u5b83\u53d1\u5c04\u7684\u5149\u4ec5\u9650\u4e8e\u4e09\u7ef4\u5706\u9525\u4f53\u4e2d\u3002\u5b83\u6a21\u62df\u4ece\u7126\u70b9\u6216\u4efb\u4f55\u5176\u4ed6\u4e0d\u5411\u6240\u6709\u65b9\u5411\u53d1\u5c04\u5149\u7684\u5149\u6e90\u3002\u805a\u5149\u6e90\u6709\u7740\u548c\u70b9\u5149\u6e90\u4e00\u6837\u7684\u5c5e\u6027\uff0c\u4f46\u5b83\u6dfb\u52a0\u4e86\u4e24\u4e2a\u65b0\u7684\u53c2\u6570\uff0c\u5706\u9525\u89d2\u548c\u5706\u9525\u65b9\u5411\u3002 \u805a\u5149\u6e90\u4e0e\u70b9\u5149\u6e90\u7684\u8ba1\u7b97\u65b9\u6cd5\u76f8\u540c\uff0c\u4f46\u6709\u4e00\u4e9b\u4e0d\u540c\u3002\u4ece\u9876\u70b9\u4f4d\u7f6e\u5230\u5149\u6e90\u7684\u77e2\u91cf\u4e0d\u5728\u5149\u9525\u5185\u7684\u70b9\u4e0d\u53d7\u5149\u7167\u7684\u5f71\u54cd\u3002 \u8be5\u5982\u4f55\u8ba1\u7b97\u5b83\u662f\u5426\u5728\u5149\u9525\u5185\u5462\uff1f\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u548c\u5706\u9525\u65b9\u5411\u77e2\u91cf\uff08\u4e24\u8005\u90fd\u5f52\u4e00\u5316\u4e86\uff09\u4e4b\u95f4\u518d\u505a\u6b21\u6570\u91cf\u79ef\u3002 L \u548c C \u5411\u91cf\u4e4b\u95f4\u7684\u6570\u91cf\u79ef\u7b49\u4e8e\uff1a \\vec{L}\\cdot\\vec{C}=|\\vec{L}|\\cdot|\\vec{C}|\\cdot Cos(\\alpha) \u3002\u5728\u805a\u5149\u6e90\u7684\u5b9a\u4e49\u4e2d\uff0c\u6211\u4eec\u50a8\u5b58\u9525\u89d2\u7684\u4f59\u5f26\u503c\uff0c\u5982\u679c\u6570\u91cf\u79ef\u9ad8\u4e8e\u8be5\u503c\uff0c\u6211\u4eec\u5c31\u77e5\u9053\u5b83\u4f4d\u4e8e\u5149\u9525\u5185\u90e8\uff08\u60f3\u60f3\u4f59\u5f26\u56fe\uff0c\u5f53 \u03b1 \u89d2\u4e3a 0 \u65f6\uff0c\u5176\u4f59\u5f26\u503c\u4e3a 1 \u3002\u57280\u00b0~180\u00b0\u65f6\uff0c\u89d2\u5ea6\u8d8a\u5c0f\u4f59\u5f26\u503c\u8d8a\u5927\uff09\u3002 \u7b2c\u4e8c\u4e2a\u4e0d\u540c\u4e4b\u5904\u662f\u8fdc\u79bb\u5149\u9525\u65b9\u5411\u7684\u70b9\u5c06\u53d7\u5230\u66f4\u5c11\u7684\u5149\u7167\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u8870\u51cf\u5f71\u54cd\u5c06\u66f4\u5f3a\u3002\u6709\u51e0\u79cd\u8ba1\u7b97\u65b9\u6cd5\uff0c\u6211\u4eec\u5c06\u9009\u62e9\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u5c06\u8870\u51cf\u4e0e\u4e0b\u8ff0\u516c\u5f0f\u76f8\u4e58\uff1a 1 - (1-Cos(\\alpha))/(1-Cos(cutOffAngle) (\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u6ca1\u6709\u4f20\u9012\u89d2\u5ea6\uff0c\u800c\u662f\u4f20\u9012\u89d2\u5ea6\u7684\u4f59\u5f26\u503c\u3002\u4f60\u53ef\u4ee5\u68c0\u67e5\u4e0a\u9762\u7684\u516c\u5f0f\u7684\u7ed3\u679c\u662f\u5426\u4f4d\u4e8e0\u52301\u4e4b\u95f4\uff0c\u5f53\u89d2\u5ea6\u4e3a0\u65f6\uff0c\u4f59\u5f26\u503c\u4e3a1\u3002) \u5b9e\u73b0\u975e\u5e38\u7c7b\u4f3c\u4e8e\u5176\u4ed6\u7684\u5149\u6e90\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SpotLight \u7684\u7c7b\uff0c\u8bbe\u7f6e\u9002\u5f53\u7684Uniform\uff0c\u5c06\u5176\u4f20\u9012\u7ed9\u7740\u8272\u5668\u5e76\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u4ee5\u83b7\u53d6\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u3002 \u5f53\u4f20\u9012Uniform\u65f6\uff0c\u53e6\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u662f\u4f4d\u79fb\u4e0d\u5e94\u8be5\u5e94\u7528\u5230\u5149\u9525\u65b9\u5411\u4e0a\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\u3002\u56e0\u6b64\uff0c\u548c\u5e73\u884c\u5149\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u5f53\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u7cfb\u65f6\uff0c\u5fc5\u987b\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002","title":"\u805a\u5149\u6e90"},{"location":"11-let-there-be-even-more-light/#_3","text":"\u6211\u4eec\u7ec8\u4e8e\u5b9e\u73b0\u4e86\u56db\u79cd\u7c7b\u578b\u7684\u5149\u6e90\uff0c\u4f46\u662f\u76ee\u524d\u6bcf\u79cd\u7c7b\u578b\u7684\u5149\u6e90\u53ea\u80fd\u4f7f\u7528\u4e00\u4e2a\u5b9e\u4f8b\u3002\u8fd9\u5bf9\u4e8e\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8bf4\u6ca1\u95ee\u9898\uff0c\u4f46\u662f\u6211\u4eec\u786e\u5b9e\u5e0c\u671b\u4f7f\u7528\u591a\u4e2a\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u7247\u5143\u7740\u8272\u5668\u6765\u63a5\u6536\u5149\u6e90\u5217\u8868\uff0c\u6240\u4ee5\u4f7f\u7528\u6570\u7ec4\u6765\u50a8\u5b58\u8fd9\u4e9b\u6570\u636e\u3002\u6765\u770b\u770b\u600e\u4e48\u5b9e\u73b0\u5427\u3002 \u5728\u5f00\u59cb\u4e4b\u524d\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5728GLSL\u4e2d\uff0c\u6570\u7ec4\u7684\u957f\u5ea6\u5fc5\u987b\u5728\u7f16\u8bd1\u65f6\u8bbe\u7f6e\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u8db3\u591f\u5927\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u80fd\u591f\u50a8\u5b58\u6240\u9700\u7684\u6240\u6709\u5bf9\u8c61\u3002\u9996\u5148\u662f\u5b9a\u4e49\u4e00\u4e9b\u5e38\u91cf\u6765\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u6700\u5927\u70b9\u5149\u6e90\u6570\u548c\u805a\u5149\u6e90\u6570\u3002 const int MAX_POINT_LIGHTS = 5; const int MAX_SPOT_LIGHTS = 5; \u7136\u540e\u6211\u4eec\u9700\u8981\u4fee\u6539\u6b64\u524d\u53ea\u50a8\u5b58\u4e00\u4e2a\u70b9\u5149\u6e90\u548c\u4e00\u4e2a\u805a\u5149\u6e90\u7684Uniform\uff0c\u4ee5\u4fbf\u4f7f\u7528\u6570\u7ec4\u3002 uniform PointLight pointLights[MAX_POINT_LIGHTS]; uniform SpotLight spotLights[MAX_SPOT_LIGHTS]; \u5728main\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5bf9\u8fd9\u4e9b\u6570\u7ec4\u8fdb\u884c\u8fed\u4ee3\uff0c\u4ee5\u4f7f\u7528\u73b0\u6709\u51fd\u6570\u8ba1\u7b97\u6bcf\u4e2a\u5bf9\u8c61\u5bf9\u989c\u8272\u7684\u5f71\u54cd\u3002\u6211\u4eec\u53ef\u80fd\u4e0d\u4f1a\u50cfUniform\u6570\u7ec4\u957f\u5ea6\u90a3\u6837\u4f20\u9012\u5f88\u591a\u5149\u6e90\uff0c\u6240\u4ee5\u9700\u8981\u63a7\u5236\u5b83\u3002\u6709\u5f88\u591a\u53ef\u884c\u7684\u65b9\u6cd5\uff0c\u4f46\u8fd9\u53ef\u80fd\u4e0d\u9002\u7528\u4e8e\u65e7\u7684\u663e\u5361\u3002\u6700\u7ec8\u6211\u4eec\u9009\u62e9\u68c0\u67e5\u5149\u5f3a\uff08\u5728\u6570\u7ec4\u4e2d\u7684\u7a7a\u4f4d\uff0c\u5149\u5f3a\u4e3a0\uff09\u3002 for (int i=0; i<MAX_POINT_LIGHTS; i++) { if ( pointLights[i].intensity > 0 ) { diffuseSpecularComp += calcPointLight(pointLights[i], mvVertexPos, mvVertexNormal); } } for (int i=0; i<MAX_SPOT_LIGHTS; i++) { if ( spotLights[i].pl.intensity > 0 ) { diffuseSpecularComp += calcSpotLight(spotLights[i], mvVertexPos, mvVertexNormal); } } \u73b0\u5728\u6211\u4eec\u9700\u8981\u5728 Render \u7c7b\u4e2d\u521b\u5efa\u8fd9\u4e9bUniform\u3002\u5f53\u4f7f\u7528\u6570\u7ec4\u65f6\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u5217\u8868\u4e2d\u7684\u6bcf\u4e2a\u5143\u7d20\u521b\u5efa\u4e00\u4e2aUniform\u3002\u4f8b\u5982\uff0c\u5bf9\u4e8e pointLights \u6570\u7ec4\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u540d\u4e3a pointLights[0] \u3001 pointLights[1] \u4e4b\u7c7b\u7684Uniform\u3002\u5f53\u7136\uff0c\u8fd9\u4e5f\u9002\u7528\u4e8e\u7ed3\u6784\u4f53\u5c5e\u6027\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u521b\u5efa pointLights[0].colour \u3001 pointLights[1].colour \u7b49\u7b49\u3002\u521b\u5efa\u8fd9\u4e9bUniform\u7684\u65b9\u6cd5\u5982\u4e0b\u6240\u793a\uff1a public void createPointLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createPointLightUniform(uniformName + \"[\" + i + \"]\"); } } public void createSpotLightListUniform(String uniformName, int size) throws Exception { for (int i = 0; i < size; i++) { createSpotLightUniform(uniformName + \"[\" + i + \"]\"); } } \u6211\u4eec\u4e5f\u9700\u8981\u65b9\u6cd5\u6765\u8bbe\u7f6e\u8fd9\u4e9bUniform\u7684\u503c\uff1a public void setUniform(String uniformName, PointLight[] pointLights) { int numLights = pointLights != null ? pointLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, pointLights[i], i); } } public void setUniform(String uniformName, PointLight pointLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", pointLight); } public void setUniform(String uniformName, SpotLight[] spotLights) { int numLights = spotLights != null ? spotLights.length : 0; for (int i = 0; i < numLights; i++) { setUniform(uniformName, spotLights[i], i); } } public void setUniform(String uniformName, SpotLight spotLight, int pos) { setUniform(uniformName + \"[\" + pos + \"]\", spotLight); } \u6700\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u66f4\u65b0 Render \u7c7b\u6765\u63a5\u6536\u70b9\u5149\u6e90\u548c\u805a\u5149\u6e90\u5217\u8868\uff0c\u5e76\u76f8\u5e94\u5730\u4fee\u6539 DummyGame \u7c7b\u4ee5\u521b\u5efa\u8fd9\u4e9b\u5217\u8868\uff0c\u6700\u7ec8\u6548\u679c\u5982\u4e0b\u6240\u793a\u3002","title":"\u591a\u5149\u6e90"},{"location":"12-game-hud/","text":"\u6e38\u620fHUD\uff08Game HUD\uff09 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\uff08Heads-Up Display\uff0c\u5e73\u89c6\u663e\u793a\u5668\uff09\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5c31\u662f\u4e00\u7ec4\u7528\u4e8e\u5728\u4e09\u7ef4\u573a\u666f\u4e0a\uff0c\u968f\u65f6\u663e\u793a\u76f8\u5173\u4fe1\u606f\u7684\u4e8c\u7ef4\u56fe\u5f62\u548c\u6587\u672c\u3002\u672c\u4f8b\u4e2d\u5c06\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684HUD\uff0c\u8fd9\u53ef\u4e3a\u6211\u4eec\u5c55\u73b0\u4e00\u4e9b\u663e\u793a\u4fe1\u606f\u7684\u57fa\u672c\u6280\u672f\u3002 \u5f53\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u65f6\uff0c\u8fd8\u5c06\u53d1\u73b0\u6211\u4eec\u5bf9\u6e90\u4ee3\u7801\u505a\u4e86\u4e00\u4e9b\u5c0f\u7684\u91cd\u6784\uff0c\u7279\u522b\u662f Renderer \u7c7b\uff0c\u4ee5\u4fbf\u4e3aHUD\u6e32\u67d3\u505a\u597d\u51c6\u5907\u3002 \u6587\u672c\u6e32\u67d3 \u521b\u5efaHUD\u6240\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6e32\u67d3\u6587\u672c\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u50a8\u5b58\u5b57\u7b26\u7684\u7eb9\u7406\u6620\u5c04\u5230\u4e00\u4e2a\u65b9\u5f62\u4e2d\uff0c\u8be5\u65b9\u5f62\u5c06\u88ab\u5206\u5272\u4e3a\u4e00\u7ec4\u8868\u793a\u6bcf\u4e2a\u5b57\u7b26\u7684\u7247\u6bb5\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u7eb9\u7406\u5728\u5c4f\u5e55\u4e0a\u7ed8\u5236\u6587\u672c\u3002\u6240\u4ee5\u9996\u5148\u521b\u5efa\u542b\u6709\u6240\u6709\u5b57\u6bcd\u7684\u7eb9\u7406\uff0c\u8fd9\u9879\u5de5\u4f5c\u53ef\u4ee5\u4f7f\u7528\u5f88\u591a\u8f6f\u4ef6\u6765\u505a\uff0c\u4f8b\u5982 CBFG \u3001 F2IBuilder \u7b49\u7b49\u3002\u672c\u4f8b\u4f7f\u7528Codehead\u7684\u4f4d\u56fe\u5b57\u4f53\u751f\u6210\u5668\uff08Codehead\u2019s Bitmap Font Generator\uff0cCBFG\uff09\u3002 CBFG\u5141\u8bb8\u4f60\u914d\u7f6e\u5f88\u591a\u9009\u9879\uff0c\u5982\u7eb9\u7406\u5927\u5c0f\u3001\u5b57\u4f53\u7c7b\u578b\u3001\u8981\u4f7f\u7528\u7684\u6297\u952f\u9f7f\u7b49\u7b49\u3002\u4e0b\u56fe\u662f\u672c\u4f8b\u5c06\u7528\u6765\u751f\u6210\u7eb9\u7406\u6587\u4ef6\u7684\u914d\u7f6e\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u6587\u672c\u7f16\u7801\u4e3aISO-8859-1\uff0c\u5982\u679c\u4f60\u9700\u8981\u5904\u7406\u5176\u4ed6\u7684\u5b57\u7b26\u96c6\uff0c\u5219\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u4ee3\u7801\u3002 \u5f53\u8bbe\u7f6e\u597dCBFG\u7684\u6240\u6709\u9009\u9879\u540e\uff0c\u53ef\u4ee5\u5c06\u5176\u5bfc\u51fa\u4e3a\u591a\u79cd\u56fe\u7247\u683c\u5f0f\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5176\u5bfc\u51fa\u4e3aBMP\u6587\u4ef6\uff0c\u7136\u540e\u518d\u8f6c\u6362\u4e3aPNG\u6587\u4ef6\uff0c\u4ee5\u4fbf\u5c06\u5176\u4f5c\u4e3a\u7eb9\u7406\u52a0\u8f7d\u3002\u5f53\u8f6c\u6362\u4e3aPNG\u683c\u5f0f\u65f6\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u5c06\u9ed1\u8272\u80cc\u666f\u8bbe\u7f6e\u4e3a\u900f\u660e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5c06\u9ed1\u8272\u8bbe\u4e3aAlpha\u503c\u7b49\u4e8e0\uff08\u53ef\u4ee5\u4f7f\u7528GIMP\u8fd9\u6837\u7684\u5de5\u5177\u6765\u5b9e\u73b0\uff09\u3002\u6700\u7ec8\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u56fe\u50cf\u4e2d\u7684\u6240\u6709\u5b57\u7b26\u90fd\u4ee5\u884c\u548c\u5217\u7684\u5f62\u5f0f\u6392\u5217\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u56fe\u50cf\u753115\u5217\u548c17\u884c\u5b57\u7b26\u7ec4\u6210\u3002\u901a\u8fc7\u4f7f\u7528\u7279\u5b9a\u5b57\u7b26\u7684\u7f16\u53f7\uff0c\u6211\u4eec\u53ef\u4ee5\u8ba1\u7b97\u5176\u5bf9\u5e94\u50a8\u5b58\u5728\u56fe\u50cf\u4e2d\u7684\u884c\u548c\u5217\u3002\u6240\u5728\u5217\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u5217\u6570 = \u5b57\u7b26\u7f16\u53f7 \\space mod \\space \u5217\u603b\u6570 \uff0c\u5176\u4e2d mod \u662f\u53d6\u4f59\u8fd0\u7b97\u7b26\uff0c\u6240\u5728\u884c\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u6240\u5728\u884c = \u5b57\u7b26\u7f16\u53f7 / \u884c\u603b\u6570 \u3002\u5728\u672c\u4f8b\u4e2d\u6211\u4eec\u5c06\u6574\u6570\u9664\u4ee5\u6574\u6570\uff0c\u4ee5\u4fbf\u5ffd\u7565\u5c0f\u6570\u90e8\u5206\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a TextItem \u7684\u65b0\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6e32\u67d3\u6587\u672c\u6240\u9700\u7684\u56fe\u5143\u3002\u8fd9\u662f\u4e00\u4e2a\u4e0d\u8003\u8651\u591a\u884c\u6587\u672c\u7684\u7b80\u5316\u5b9e\u73b0\uff0c\u4f46\u662f\u5b83\u80fd\u5728HUD\u4e2d\u663e\u793a\u6587\u672c\u4fe1\u606f\u3002\u4e0b\u5217\u4ee3\u7801\u662f\u8be5\u7c7b\u7684\u58f0\u660e\u4e0e\u6784\u9020\u51fd\u6570\uff1a package org.lwjglb.engine; import java.nio.charset.Charset; import java.util.ArrayList; import java.util.List; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; public class TextItem extends GameItem { private static final float ZPOS = 0.0f; private static final int VERTICES_PER_QUAD = 4; private String text; private final int numCols; private final int numRows; public TextItem(String text, String fontFileName, int numCols, int numRows) throws Exception { super(); this.text = text; this.numCols = numCols; this.numRows = numRows; Texture texture = new Texture(fontFileName); this.setMesh(buildMesh(texture, numCols, numRows)); } \u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u6539\u53d8\u5728\u5c4f\u5e55\u4e0a\u6587\u672c\u7684\u4f4d\u7f6e\uff0c\u4e5f\u53ef\u80fd\u9700\u8981\u7f29\u653e\u548c\u65cb\u8f6c\u5b83\u3002\u6784\u9020\u51fd\u6570\u63a5\u6536\u8981\u6e32\u67d3\u7684\u6587\u672c\u548c\u7528\u4e8e\u6e32\u67d3\u7684\u7eb9\u7406\u7684\u6587\u4ef6\u548c\u76f8\u5173\u6570\u636e\uff08\u50a8\u5b58\u56fe\u50cf\u7684\u6587\u4ef6\u53ca\u884c\u5217\u6570\uff09\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\uff0c\u5e76\u8c03\u7528\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u4e3a\u6587\u672c\u5efa\u6a21\u3002\u8ba9\u6211\u4eec\u770b\u5230 buildMesh \u65b9\u6cd5\uff1a private Mesh buildMesh(Texture texture, int numCols, int numRows) { byte[] chars = text.getBytes(Charset.forName(\"ISO-8859-1\")); int numChars = chars.length; List<Float> positions = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); float[] normals = new float[0]; List<Integer> indices = new ArrayList<>(); float tileWidth = (float)texture.getWidth() / (float)numCols; float tileHeight = (float)texture.getHeight() / (float)numRows; \u4ee3\u7801\u521b\u5efa\u4e86\u7528\u4e8e\u50a8\u5b58Mesh\u7684\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u7d22\u5f15\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u6211\u4eec\u4e0d\u4f7f\u7528\u5149\u7167\uff0c\u56e0\u6b64\u6cd5\u7ebf\u6570\u5217\u662f\u7a7a\u7684\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u7ec4\u5b57\u7b26\u7247\u6bb5\uff0c\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u4ee3\u8868\u4e00\u4e2a\u5b57\u7b26\u3002\u6211\u4eec\u8fd8\u9700\u8981\u6839\u636e\u6bcf\u4e2a\u7247\u6bb5\u5bf9\u5e94\u7684\u5b57\u7b26\u6765\u5206\u914d\u5bf9\u5e94\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u6587\u672c\u77e9\u5f62\u548c\u5b57\u7b26\u7247\u6bb5\u7684\u5173\u7cfb\uff1a \u56e0\u6b64\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u5b57\u7b26\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u6784\u6210\u7684\u5b57\u7b26\u7247\u6bb5\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u53ef\u4ee5\u7528\u56db\u4e2a\u9876\u70b9\uff08V1\u3001V2\u3001V3\u548cV4\uff09\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff08\u5de6\u4e0b\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(0, 1, 2)\uff0c\u800c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u53f3\u4e0a\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(3, 0, 2)\u3002\u7eb9\u7406\u5750\u6807\u662f\u57fa\u4e8e\u4e0e\u7eb9\u7406\u56fe\u50cf\u4e2d\u6bcf\u4e2a\u5b57\u7b26\u76f8\u5173\u7684\u884c\u5217\u8ba1\u7b97\u7684\uff0c\u7eb9\u7406\u5750\u6807\u7684\u8303\u56f4\u4e3a[0, 1]\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5f53\u524d\u884c\u6216\u5f53\u524d\u5217\u9664\u4ee5\u603b\u884c\u6570\u548c\u603b\u5217\u6570\u5c31\u53ef\u4ee5\u83b7\u5f97V1\u7684\u5750\u6807\u3002\u5bf9\u4e8e\u5176\u4ed6\u9876\u70b9\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9002\u5f53\u52a0\u4e0a\u884c\u5bbd\u6216\u5217\u5bbd\u5c31\u53ef\u4ee5\u5f97\u5230\u5bf9\u5e94\u5750\u6807\u3002 \u4e0b\u8ff0\u7684\u5faa\u73af\u8bed\u53e5\u5757\u521b\u5efa\u4e86\u4e0e\u6e32\u67d3\u6587\u672c\u77e9\u5f62\u76f8\u5173\u7684\u6240\u6709\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002 for(int i=0; i<numChars; i++) { byte currChar = chars[i]; int col = currChar % numCols; int row = currChar / numCols; // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD); // \u5de6\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 1); // \u53f3\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 2); // \u53f3\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 3); // \u6dfb\u52a0\u5de6\u4e0a\u89d2\u548c\u53f3\u4e0b\u89d2\u9876\u70b9\u7684\u7d22\u5f15 indices.add(i*VERTICES_PER_QUAD); indices.add(i*VERTICES_PER_QUAD + 2); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u9700\u8981\u6ce8\u610f\u7684\u4e00\u4e9b\u4e8b\u9879\uff1a \u6211\u4eec\u5c06\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u6765\u8868\u793a\u9876\u70b9\uff08\u8bb0\u4f4f\u5c4f\u5e55\u5750\u6807\u7cfb\u7684\u539f\u70b9\u4f4d\u4e8e\u5c4f\u5e55\u5de6\u4e0a\u89d2\uff09\u3002\u4e09\u89d2\u5f62\u4e0a\u9876\u70b9\u7684Y\u5750\u6807\u5c0f\u4e8e\u4e09\u89d2\u5f62\u4e0b\u9876\u70b9\u7684Y\u5750\u6807\u3002 \u6211\u4eec\u4e0d\u7f29\u653e\u56fe\u5f62\uff0c\u56e0\u6b64\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u7684X\u8ddd\u79bb\u5c31\u7b49\u4e8e\u5b57\u7b26\u5bbd\u5ea6\uff0c\u4e09\u89d2\u5f62\u7684\u9ad8\u5ea6\u5c31\u662f\u6bcf\u4e2a\u5b57\u7b26\u7684\u9ad8\u5ea6\u3002\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u5c3d\u53ef\u80fd\u5730\u4f7f\u6e32\u67d3\u6587\u672c\u4e0e\u539f\u59cb\u7eb9\u7406\u76f8\u4f3c\uff08\u4e0d\u7ba1\u600e\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u7a0d\u540e\u7f29\u653e\u5b83\uff0c\u56e0\u4e3a TextItem \u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff09\u3002 Z\u5750\u6807\u4e3a\u56fa\u5b9a\u503c\uff0c\u56e0\u4e3a\u5b83\u4e0e\u7ed8\u5236\u8be5\u56fe\u50cf\u65e0\u5173\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e9b\u9876\u70b9\u7684\u5750\u6807\uff1a \u4e3a\u4ec0\u4e48\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u7cfb\uff1f\u9996\u5148\uff0c\u56e0\u4e3a\u672c\u4f8b\u5c06\u5728HUD\u4e2d\u6e32\u67d32D\u5bf9\u8c61\uff0c\u5e76\u4e14\u901a\u5e38\u8fd9\u6837\u4f7f\u7528\u5b83\u4eec\u66f4\u65b9\u4fbf\u3002\u5176\u6b21\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u7ed8\u5236\u5b83\u4eec\uff0c\u7a0d\u540e\u518d\u89e3\u91ca\u4ec0\u4e48\u662f\u6b63\u4ea4\u6295\u5f71\u3002 TextItem \u7c7b\u6700\u540e\u8fd8\u9700\u6dfb\u52a0\u4e00\u4e9b\u65b9\u6cd5\uff0c\u4ee5\u83b7\u53d6\u6587\u672c\u5e76\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u6587\u672c\u3002\u6bcf\u5f53\u6587\u672c\u88ab\u66f4\u6539\u65f6\uff0c\u9700\u8981\u6e05\u7406\u6b64\u524d\u7684VAO\uff08\u50a8\u5b58\u5728 Mesh \u5b9e\u4f8b\u4e2d\uff09\u5e76\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VAO\u3002\u6211\u4eec\u4e0d\u9700\u8981\u5220\u9664\u7eb9\u7406\uff0c\u6240\u4ee5\u5728 Mesh \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u5220\u9664\u8fd9\u4e9b\u6570\u636e\u3002 public String getText() { return text; } public void setText(String text) { this.text = text; Texture texture = this.getMesh().getMaterial().getTexture(); this.getMesh().deleteBuffers(); this.setMesh(buildMesh(texture, numCols, numRows)); } \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u5efa\u7acb\u4e86\u6e32\u67d3\u6587\u672c\u6240\u9700\u8981\u7684\u57fa\u7840\u7ed3\u6784\uff0c\u63a5\u4e0b\u6765\u8be5\u600e\u4e48\u505a\u5462\uff1f\u9996\u5148\u5982\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\uff0c\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\uff0c\u7136\u540e\u5728\u5176\u4e0a\u6e32\u67d3\u4e8c\u7ef4\u7684HUD\u3002\u4e3a\u4e86\u6e32\u67d3HUD\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08\u4e5f\u79f0\u4e3a\u6b63\u4ea4\u6295\u5f71\uff09\u3002\u6b63\u4ea4\u6295\u5f71\u662f\u4e09\u7ef4\u7269\u4f53\u7684\u4e00\u79cd\u4e8c\u7ef4\u8868\u793a\u65b9\u5f0f\uff0c\u4f60\u53ef\u80fd\u5df2\u7ecf\u5728\u4e09\u7ef4\u6a21\u578b\u7684\u84dd\u56fe\u4e2d\u770b\u5230\u4e86\u4e00\u4e9b\u4f8b\u5b50\uff0c\u5b83\u4eec\u7528\u6765\u8868\u793a\u67d0\u4e9b\u7269\u4f53\u4ece\u9876\u90e8\u6216\u67d0\u4e9b\u4fa7\u9762\u770b\u5230\u7684\u6837\u5b50\u3002\u4e0b\u56fe\u662f\u5706\u67f1\u4f53\u4ece\u9876\u90e8\u548c\u524d\u9762\u7684\u6b63\u4ea4\u6295\u5f71\uff1a \u8fd9\u79cd\u6295\u5f71\u5bf9\u4e8e\u7ed8\u5236\u4e8c\u7ef4\u7269\u4f53\u662f\u975e\u5e38\u65b9\u4fbf\u7684\uff0c\u56e0\u4e3a\u5b83\u201c\u5ffd\u7565\u201d\u4e86Z\u5750\u6807\u7684\u503c\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5ffd\u7565\u4e86\u5230\u5c4f\u5e55\u7684\u8ddd\u79bb\u3002\u4f7f\u7528\u8fd9\u79cd\u6295\u5f71\uff0c\u7269\u4f53\u5927\u5c0f\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u7684\u589e\u5927\u800c\u51cf\u5c0f\uff08\u4e0d\u540c\u4e8e\u900f\u89c6\u6295\u5f71\uff09\u3002\u4e3a\u4e86\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u6295\u5f71\u7269\u4f53\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u516c\u5f0f\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u4e2a\u77e9\u9635\u8fd8\u77eb\u6b63\u4e86\u5931\u771f\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7a97\u53e3\u5e76\u4e0d\u603b\u662f\u5b8c\u7f8e\u7684\u6b63\u65b9\u5f62\uff0c\u800c\u662f\u4e00\u4e2a\u77e9\u5f62\u3002 right \u548c bottom \u662f\u5c4f\u5e55\u5927\u5c0f\uff0c\u800c left \u548c top \u662f\u539f\u70b9\u5750\u6807\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7528\u4e8e\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u8be5\u6295\u5f71\u7684\u6620\u5c04\u8fc7\u7a0b\uff1a \u8be5\u77e9\u9635\u5c06\u5141\u8bb8\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7ee7\u7eed\u5b9e\u73b0HUD\u4e86\u3002\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u521b\u5efa\u53e6\u4e00\u7ec4\u7740\u8272\u5668\uff0c\u4e00\u4e2a\u9876\u70b9\u7740\u8272\u5668\u548c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\uff0c\u6765\u7ed8\u5236HUD\u3002\u9876\u70b9\u7740\u8272\u5668\u5f88\u7b80\u5355\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 projModelMatrix; void main() { gl_Position = projModelMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5b83\u4ec5\u63a5\u6536\u9876\u70b9\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u6cd5\u7ebf\uff0c\u5e76\u5c06\u4f7f\u7528\u77e9\u9635\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\uff0c\u8be5\u77e9\u9635\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u7684\u4e58\u79ef\uff0c\u5373 projModelMatrix = \u6b63\u4ea4\u6295\u5f71\u77e9\u9635 \\cdot \u6a21\u578b\u77e9\u9635 \u3002\u7531\u4e8e\u6211\u4eec\u6ca1\u6709\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\u5bf9\u5750\u6807\u505a\u4efb\u4f55\u5904\u7406\uff0c\u6240\u4ee5\u5728Java\u4ee3\u7801\u4e2d\u5c06\u4e24\u4e2a\u77e9\u9635\u76f8\u4e58\u6bd4\u5728\u7740\u8272\u5668\u4e2d\u76f8\u4e58\u66f4\u9ad8\u6548\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u9879\u76ee\u505a\u4e00\u6b21\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\uff0c\u800c\u4e0d\u662f\u4e3a\u6bcf\u4e2a\u9876\u70b9\u505a\u4e00\u6b21\u3002\u8fd8\u5e94\u8bb0\u4f4f\u9876\u70b9\u5e94\u8be5\u7528\u5c4f\u5e55\u5750\u6807\u8868\u793a\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; void main() { fragColor = colour * texture(texture_sampler, outTexCoord); } \u5b83\u53ea\u662f\u5c06\u57fa\u672c\u989c\u8272\u4e0e\u7eb9\u7406\u989c\u8272\u76f8\u4e58\uff0c\u8fd9\u6837\u53ef\u4ee5\u6539\u53d8\u6e32\u67d3\u6587\u672c\u7684\u989c\u8272\uff0c\u800c\u4e0d\u9700\u8981\u521b\u5efa\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u73b0\u5728\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u7ec4\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IHud \u7684\u63a5\u53e3\uff0c\u8be5\u63a5\u53e3\u50a8\u5b58\u6240\u6709\u8981\u5728HUD\u4e0a\u663e\u793a\u7684\u5143\u7d20\uff0c\u5e76\u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u7684 cleanup \u65b9\u6cd5\u3002 package org.lwjglb.engine; public interface IHud { GameItem[] getGameItems(); default void cleanup() { GameItem[] gameItems = getGameItems(); for (GameItem gameItem : gameItems) { gameItem.getMesh().cleanUp(); } } } \u901a\u8fc7\u8be5\u63a5\u53e3\uff0c\u4e0d\u540c\u7684\u6e38\u620f\u53ef\u4ee5\u5b9a\u4e49\u81ea\u5b9a\u4e49\u7684HUD\uff0c\u800c\u4e0d\u9700\u8981\u6539\u53d8\u6e32\u67d3\u673a\u5236\u3002\u73b0\u5728\u56de\u5230 Renderer \u7c7b\uff0c\u987a\u4fbf\u4e00\u63d0\uff0c\u5b83\u5df2\u7ecf\u88ab\u79fb\u52a8\u5230 engine.graph \u5305\u4e0b\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u7684\u901a\u7528\u6027\u8db3\u4ee5\u4e0d\u4f9d\u8d56\u4efb\u4f55\u6e38\u620f\u7684\u5177\u4f53\u5b9e\u73b0\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u521b\u5efa\u3001\u8fde\u63a5\u548c\u521d\u59cb\u5316\u4e00\u4e2a\u65b0\u7684 ShaderProgram \uff0c\u4ee5\u4fbf\u4f7f\u7528\u4e0a\u8ff0\u6240\u793a\u7684\u7740\u8272\u5668\u3002 private void setupHudShader() throws Exception { hudShaderProgram = new ShaderProgram(); hudShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/hud_vertex.vs\")); hudShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/hud_fragment.fs\")); hudShaderProgram.link(); // \u4e3a\u6b63\u4ea4\u6295\u5f71\u6a21\u578b\u77e9\u9635\u548c\u989c\u8272\u521b\u5efaUniform hudShaderProgram.createUniform(\"projModelMatrix\"); hudShaderProgram.createUniform(\"colour\"); } render \u65b9\u6cd5\u9996\u5148\u4f1a\u8c03\u7528 renderScene \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\u7684\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u4ee3\u7801\uff0c\u7136\u540e\u8c03\u7528\u4e00\u4e2a\u540d\u4e3a renderHud \u7684\u65b0\u65b9\u6cd5\uff0c\u7528\u4e8e\u6e32\u67d3HUD\u3002 public void render(Window window, Camera camera, GameItem[] gameItems, SceneLight sceneLight, IHud hud) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } renderScene(window, camera, gameItems, sceneLight); renderHud(window, hud); } renderHud \u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\uff1a private void renderHud(Window window, IHud hud) { hudShaderProgram.bind(); Matrix4f ortho = transformation.getOrthoProjectionMatrix(0, window.getWidth(), window.getHeight(), 0); for (GameItem gameItem : hud.getGameItems()) { Mesh mesh = gameItem.getMesh(); // HUD\u5143\u7d20\u7684\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58 Matrix4f projModelMatrix = transformation.getOrtoProjModelMatrix(gameItem, ortho); hudShaderProgram.setUniform(\"projModelMatrix\", projModelMatrix); hudShaderProgram.setUniform(\"colour\", gameItem.getMesh().getMaterial().getAmbientColour()); // \u6e32\u67d3\u6b64HUD\u9879\u76ee\u7684\u7f51\u683c mesh.render(); } hudShaderProgram.unbind(); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u904d\u5386\u4e86HUD\u7684\u6240\u6709\u5143\u7d20\uff0c\u5e76\u5c06\u4e0e\u6bcf\u4e2a\u5143\u7d20\u5173\u8054\u7684\u6a21\u578b\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u76f8\u4e58\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5728\u6bcf\u6b21 render \u8c03\u7528\u65f6\u88ab\u5237\u65b0\uff08\u56e0\u4e3a\u5c4f\u5e55\u5927\u5c0f\u53ef\u4ee5\u88ab\u6539\u53d8\uff09\uff0c\u5e76\u4e14\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a public final Matrix4f getOrthoProjectionMatrix(float left, float right, float bottom, float top) { orthoMatrix.identity(); orthoMatrix.setOrtho2D(left, right, bottom, top); return orthoMatrix; } \u6211\u4eec\u5c06\u5728 game \u5305\u4e2d\u521b\u5efa\u4e00\u4e2a Hud \u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86 IHud \u63a5\u53e3\uff0c\u5e76\u5728\u6784\u9020\u51fd\u6570\u63a5\u6536\u4e00\u4e2a\u6587\u672c\uff0c\u7528\u4e8e\u5728\u5176\u4e2d\u521b\u5efa TextItem \u5b9e\u4f8b\u3002 package org.lwjglb.game; import org.joml.Vector4f; import org.lwjglb.engine.GameItem; import org.lwjglb.engine.IHud; import org.lwjglb.engine.TextItem; public class Hud implements IHud { private static final int FONT_COLS = 15; private static final int FONT_ROWS = 17; private static final String FONT_TEXTURE = \"textures/font_texture.png\"; private final GameItem[] gameItems; private final TextItem statusTextItem; public Hud(String statusText) throws Exception { this.statusTextItem = new TextItem(statusText, FONT_TEXTURE, FONT_COLS, FONT_ROWS); this.statusTextItem.getMesh().getMaterial().setColour(new Vector4f(1, 1, 1, 1)); gameItems = new GameItem[]{statusTextItem}; } public void setStatusText(String statusText) { this.statusTextItem.setText(statusText); } @Override public GameItem[] getGameItems() { return gameItems; } public void updateSize(Window window) { this.statusTextItem.setPosition(10f, window.getHeight() - 50f, 0); } } \u5728 DummyGame \u7c7b\u4e2d\u6211\u4eec\u521b\u5efa\u8be5\u7c7b\u7684\u5b9e\u4f8b\uff0c\u5e76\u7528\u9ed8\u8ba4\u6587\u672c\u521d\u59cb\u5316\u5b83\uff0c\u6700\u540e\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\uff1a \u5728 Texture \u7c7b\u4e2d\u53ef\u4ee5\u901a\u8fc7\u4fee\u6539\u7eb9\u7406\u7684\u8fc7\u6ee4\u65b9\u5f0f\u6765\u63d0\u5347\u6587\u672c\u7684\u53ef\u8bfb\u6027\uff08\u5982\u679c\u9700\u8981\u6587\u672c\u7f29\u653e\u7684\u8bdd\u9700\u8981\u6ce8\u610f\u6b64\u4e8b\uff09\u3002 glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u4f46\u662f\u672c\u4f8b\u8fd8\u6ca1\u6709\u505a\u5b8c\u3002\u5982\u679c\u7528\u7f29\u653e\u4f7f\u6587\u672c\u4e0e\u7acb\u65b9\u4f53\u91cd\u53e0\u65f6\uff0c\u5c31\u4f1a\u770b\u5230\u5982\u4e0b\u6548\u679c\uff1a \u7ed8\u5236\u7684\u6587\u672c\u80cc\u666f\u4e0d\u900f\u660e\u3002\u4e3a\u4e86\u5b9e\u73b0\u80cc\u666f\u900f\u660e\uff0c\u6211\u4eec\u5fc5\u987b\u660e\u786e\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u4f7f\u7528Alpha\u5206\u91cf\u3002\u672c\u4f8b\u5c06\u5728 Window \u7c7b\u4e2d\u7528\u4e0b\u8ff0\u4ee3\u7801\u8bbe\u7f6e\u5176\u521d\u59cb\u5316\u53c2\u6570\uff1a // \u652f\u6301\u900f\u660e glEnable(GL_BLEND); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6587\u672c\u4ee5\u900f\u660e\u80cc\u666f\u7ed8\u5236\u4e86\u3002 \u5b8c\u5584HUD \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6e32\u67d3\u4e86\u4e00\u4e9b\u6587\u672c\uff0c\u4f46\u8fd8\u53ef\u4ee5\u5411HUD\u6dfb\u52a0\u66f4\u591a\u7684\u5143\u7d20\u3002\u672c\u4f8b\u5c06\u6dfb\u52a0\u4e00\u4e2a\u6839\u636e\u6444\u50cf\u673a\u671d\u5411\u65cb\u8f6c\u7684\u6307\u9488\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5411 Hud \u7c7b\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 GameItem \uff0c\u5b83\u5c06\u5305\u542b\u4e00\u4e2a\u6307\u9488\u7684\u6a21\u578b\u7f51\u683c\u3002 \u6307\u9488\u7684\u6a21\u578b\u662f.obj\u6587\u4ef6\uff0c\u4f46\u5b83\u4e0d\u4f1a\u5173\u8054\u4efb\u4f55\u7eb9\u7406\uff0c\u76f8\u53cd\uff0c\u5b83\u53ea\u6709\u4e00\u4e2a\u57fa\u7840\u8272\u3002\u6240\u4ee5\u9700\u8981\u4fee\u6539HUD\u7684\u7247\u5143\u7740\u8272\u5668\uff0c\u4ee5\u786e\u8ba4\u662f\u5426\u4f7f\u7528\u7eb9\u7406\u3002\u672c\u4f8b\u5c06\u901a\u8fc7\u8bbe\u7f6e\u4e00\u4e2a\u540d\u4e3a hasTexture \u7684\u65b0Uniform\u6765\u5b9e\u73b0\u5b83\u3002 #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; uniform int hasTexture; void main() { if ( hasTexture == 1 ) { fragColor = colour * texture(texture_sampler, outTexCoord); } else { fragColor = colour; } } \u8981\u5c06\u6307\u9488\u6dfb\u52a0\u5230HUD\u4e0a\uff0c\u53ea\u9700\u5728 Hud \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 GameItem \u5b9e\u4f8b\u3002\u5b83\u52a0\u8f7d\u6307\u9488\u6a21\u578b\uff0c\u5e76\u5c06\u5176\u6dfb\u52a0\u5230\u9879\u76ee\u5217\u8868\u4e2d\u3002\u5728\u672c\u4f8b\u4e2d\u9700\u8981\u653e\u5927\u6307\u9488\uff0c\u56e0\u4e3a\u5b83\u5728\u5c4f\u5e55\u5750\u6807\u7cfb\u4e2d\u6e32\u67d3\uff0c\u6240\u4ee5\u901a\u5e38\u4f60\u9700\u8981\u653e\u5927\u5b83\u3002 // \u521b\u5efa\u6307\u9488 Mesh mesh = OBJLoader.loadMesh(\"/models/compass.obj\"); Material material = new Material(); material.setAmbientColour(new Vector4f(1, 0, 0, 1)); mesh.setMaterial(material); compassItem = new GameItem(mesh); compassItem.setScale(40.0f); // \u65cb\u8f6c\u4ee5\u5c06\u5176\u53d8\u6362\u5230\u5c4f\u5e55\u5750\u6807\u7cfb compassItem.setRotation(0f, 0f, 180f); // \u521b\u5efa\u4e00\u4e2a\u6570\u7ec4\uff0c\u7528\u4e8e\u50a8\u5b58HUD\u9879\u76ee gameItems = new GameItem[]{statusTextItem, compassItem}; \u8fd8\u8981\u6ce8\u610f\uff0c\u4e3a\u4e86\u4f7f\u6307\u9488\u6307\u5411\u4e0a\u65b9\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u65cb\u8f6c180\u00b0\uff0c\u56e0\u4e3a\u6a21\u578b\u901a\u5e38\u503e\u5411\u4e8e\u4f7f\u7528OpenGL\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u5982\u679c\u6211\u4eec\u8981\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\uff0c\u5b83\u4f1a\u6307\u5411\u4e0b\u65b9\u3002 Hud \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u6765\u66f4\u65b0\u6307\u9488\u7684\u6307\u5411\uff0c\u8be5\u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8fd9\u4e00\u70b9\u3002 public void rotateCompass(float angle) { this.compassItem.setRotation(0, 0, 180 + angle); } \u5728 DummyGame \u7c7b\u4e2d\uff0c\u6bcf\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u6211\u4eec\u9700\u8981\u7528Y\u89d2\u65cb\u8f6c\u66f4\u65b0\u89d2\u5ea6\u3002 // \u6839\u636e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); // \u66f4\u65b0HUD\u6307\u9488 hud.rotateCompass(camera.getRotation().y); } \u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff08\u8bb0\u4f4f\u8fd9\u53ea\u662f\u4e2a\u793a\u4f8b\uff0c\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u4f60\u53ef\u80fd\u60f3\u4f7f\u7528\u4e00\u4e9b\u7eb9\u7406\u8bbe\u7f6e\u6307\u9488\u7684\u5916\u89c2\uff09\u3002 \u518d\u8c08\u6587\u672c\u6e32\u67d3 \u5728\u56de\u987e\u5176\u4ed6\u4e3b\u9898\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u518d\u8c08\u8c08\u4e4b\u524d\u4ecb\u7ecd\u7684\u6587\u672c\u6e32\u67d3\u65b9\u6cd5\u3002\u8be5\u65b9\u6848\u975e\u5e38\u7b80\u6d01\u5730\u4ecb\u7ecd\u4e86\u6e32\u67d3HUD\u6240\u6d89\u53ca\u7684\u6982\u5ff5\uff0c\u4f46\u5b83\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\uff1a \u5b83\u4e0d\u652f\u6301\u975e\u62c9\u4e01\u5b57\u7b26\u3002 \u5982\u679c\u4f60\u60f3\u4f7f\u7528\u591a\u79cd\u5b57\u4f53\uff0c\u5219\u9700\u8981\u4e3a\u6bcf\u79cd\u5b57\u4f53\u521b\u5efa\u5355\u72ec\u7684\u7eb9\u7406\u6587\u4ef6\u3002\u6b64\u5916\uff0c\u6539\u53d8\u6587\u672c\u5927\u5c0f\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u7f29\u653e\uff0c\u8fd9\u4f1a\u5bfc\u81f4\u6e32\u67d3\u6587\u672c\u7684\u8d28\u91cf\u8f83\u5dee\uff0c\u6216\u8005\u9700\u8981\u521b\u5efa\u989d\u5916\u7684\u7eb9\u7406\u6587\u4ef6\u3002 \u6700\u91cd\u8981\u7684\u662f\uff0c\u5927\u591a\u6570\u5b57\u4f53\u4e2d\u7684\u5b57\u7b26\u4e4b\u95f4\u7684\u5927\u5c0f\u5e76\u4e0d\u540c\uff0c\u800c\u6211\u4eec\u5c06\u5b57\u4f53\u7eb9\u7406\u5206\u5272\u6210\u540c\u6837\u5927\u5c0f\u7684\u5143\u7d20\u3002\u6211\u4eec\u4f7f\u7528\u4e86 Monospaced \u98ce\u683c\uff08\u5373\u6240\u6709\u5b57\u7b26\u5177\u6709\u76f8\u540c\u7684\u5bbd\u5ea6\uff09\u7684\u201cConsolas\u201d\u5b57\u4f53\uff0c\u4f46\u5982\u679c\u4f7f\u7528\u975eMonospaced\u7684\u5b57\u4f53\uff0c\u5c31\u4f1a\u770b\u5230\u5b57\u7b26\u4e4b\u95f4\u607c\u4eba\u7684\u7a7a\u767d\u3002 \u6211\u4eec\u9700\u8981\u66f4\u6539\u65b9\u6cd5\uff0c\u5e76\u63d0\u4f9b\u4e00\u79cd\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u6587\u672c\u65b9\u5f0f\u3002\u5982\u679c\u4f60\u4ed4\u7ec6\u60f3\u60f3\uff0c\u6574\u4f53\u60f3\u6cd5\u662f\u53ef\u884c\u7684\uff0c\u4e5f\u5c31\u662f\u901a\u8fc7\u5355\u72ec\u6e32\u67d3\u6bcf\u4e2a\u5b57\u7b26\u7684\u77e9\u5f62\u6765\u6e32\u67d3\u6587\u672c\u3002\u8fd9\u91cc\u7684\u95ee\u9898\u5c31\u662f\u8be5\u5982\u4f55\u751f\u6210\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u7cfb\u7edf\u4e2d\u53ef\u7528\u7684\u5b57\u4f53\u52a8\u6001\u5730\u751f\u6210\u8fd9\u4e9b\u7eb9\u7406\u3002 \u8fd9\u5c31\u9700\u8981 java.awt.Font \u51fa\u624b\u4e86\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u6307\u5b9a\u5b57\u4f53\u7cfb\u5217\u548c\u5927\u5c0f\u52a8\u6001\u5730\u7ed8\u5236\u6bcf\u4e00\u4e2a\u5b57\u7b26\u6765\u751f\u6210\u7eb9\u7406\u3002\u8be5\u7eb9\u7406\u7684\u4f7f\u7528\u65b9\u5f0f\u4e0e\u4e4b\u524d\u63cf\u8ff0\u7684\u76f8\u540c\uff0c\u4f46\u5b83\u5c06\u5b8c\u7f8e\u5730\u89e3\u51b3\u4e0a\u8ff0\u6240\u6709\u95ee\u9898\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FontTexture \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u63a5\u6536 Font \u5b9e\u4f8b\u548c\u5b57\u7b26\u96c6\u540d\u79f0\uff0c\u5e76\u5c06\u52a8\u6001\u5730\u521b\u5efa\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u7eb9\u7406\u3002\u6784\u9020\u51fd\u6570\u5982\u4e0b\u6240\u793a\uff1a public FontTexture(Font font, String charSetName) throws Exception { this.font = font; this.charSetName = charSetName; charMap = new HashMap<>(); buildTexture(); } \u9996\u5148\u8981\u5904\u7406\u975e\u62c9\u4e01\u5b57\u7b26\u95ee\u9898\u3002\u7ed9\u5b9a\u5b57\u7b26\u96c6\u548c\u5b57\u4f53\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u4e00\u4e2a\u5305\u542b\u6240\u6709\u53ef\u6e32\u67d3\u5b57\u7b26\u7684 String \u3002 private String getAllAvailableChars(String charsetName) { CharsetEncoder ce = Charset.forName(charsetName).newEncoder(); StringBuilder result = new StringBuilder(); for (char c = 0; c < Character.MAX_VALUE; c++) { if (ce.canEncode(c)) { result.append(c); } } return result.toString(); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5b9e\u9645\u521b\u5efa\u7eb9\u7406\u7684 buildTexture \u65b9\u6cd5\uff1a private void buildTexture() throws Exception { // \u4f7f\u7528FontMetrics\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u4fe1\u606f BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB); Graphics2D g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); FontMetrics fontMetrics = g2D.getFontMetrics(); String allChars = getAllAvailableChars(charSetName); this.width = 0; this.height = fontMetrics.getHeight(); for (char c : allChars.toCharArray()) { // \u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5927\u5c0f\uff0c\u5e76\u66f4\u65b0\u56fe\u50cf\u7684\u5927\u5c0f CharInfo charInfo = new CharInfo(width, fontMetrics.charWidth(c)); charMap.put(c, charInfo); width += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u9996\u5148\u901a\u8fc7\u521b\u5efa\u4e34\u65f6\u56fe\u50cf\u6765\u83b7\u5f97 FontMetrics \uff0c\u7136\u540e\u904d\u5386\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684 String \uff0c\u5e76\u5728 FontMetrics \u7684\u5e2e\u52a9\u4e0b\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5bbd\u5ea6\u3002\u6211\u4eec\u5c06\u8fd9\u4e9b\u4fe1\u606f\u50a8\u5b58\u5728\u4e00\u4e2a charMap \u6620\u5c04\u4e0a\uff0c\u4ee5\u5b57\u7b26\u4f5c\u4e3a\u6620\u5c04\u7684\u952e\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u786e\u5b9a\u4e86\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u56fe\u50cf\u7684\u9ad8\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u6700\u5927\u9ad8\u5ea6\uff0c\u800c\u5bbd\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u5bbd\u5ea6\u603b\u548c\uff09\u3002 ChatSet \u662f\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u50a8\u5b58\u6709\u5173\u5b57\u7b26\u7684\u4fe1\u606f\uff08\u5b83\u7684\u5bbd\u5ea6\u548c\u5b83\u5728\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u8d77\u70b9\uff09\u3002 public static class CharInfo { private final int startX; private final int width; public CharInfo(int startX, int width) { this.startX = startX; this.width = width; } public int getStartX() { return startX; } public int getWidth() { return width; } } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u56fe\u50cf\uff0c\u53ea\u9700\u5728 BufferedImage \u4e0a\u7ed8\u5236\u5b57\u7b26\u4e32\u5373\u53ef\u3002 // \u521b\u5efa\u4e0e\u5b57\u7b26\u96c6\u76f8\u5173\u7684\u56fe\u50cf img = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB); g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); fontMetrics = g2D.getFontMetrics(); g2D.setColor(Color.WHITE); int startX = 0; for (char c : allChars.toCharArray()) { CharInfo charInfo = charMap.get(c); g2D.drawString(\"\" + c, startX, fontMetrics.getAscent()); startX += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u6b63\u5728\u751f\u6210\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5b57\u7b26\u7684\u5355\u884c\u56fe\u50cf\uff08\u53ef\u80fd\u4e0d\u6ee1\u8db3\u7eb9\u7406\u5927\u5c0f\u5e94\u8be5\u4e3a\u4e8c\u7684\u5e42\u7684\u524d\u63d0\uff0c\u4f46\u662f\u5b83\u4ecd\u9002\u7528\u4e8e\u5927\u591a\u6570\u73b0\u4ee3\u663e\u5361\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u989d\u5916\u7684\u7a7a\u767d\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff09\u3002\u4f60\u4e5f\u53ef\u4ee5\u67e5\u770b\u751f\u6210\u7684\u56fe\u50cf\uff0c\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e4b\u540e\uff0c\u6dfb\u52a0\u4e0b\u8ff0\u7684\u4e00\u884c\u4ee3\u7801\uff1a ImageIO.write(img, IMAGE_FORMAT, new java.io.File(\"Temp.png\")); \u56fe\u50cf\u5c06\u88ab\u5199\u5165\u4e00\u4e2a\u4e34\u65f6\u6587\u4ef6\u3002\u8be5\u6587\u4ef6\u5c06\u5305\u542b\u4e00\u4e2a\u5728\u767d\u8272\u80cc\u666f\u4e0b\uff0c\u4f7f\u7528\u6297\u952f\u9f7f\u7ed8\u5236\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u957f\u6761\u3002 \u6700\u540e\u53ea\u9700\u8981\u4ece\u8be5\u56fe\u50cf\u521b\u5efa\u4e00\u4e2a Texture \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ea\u9700\u4f7f\u7528PNG\u683c\u5f0f\uff08\u8fd9\u5c31\u662f Texture \u7c7b\u6240\u671f\u671b\u7684\uff09\u8f6c\u50a8\u56fe\u50cf\u5b57\u8282\u3002 ByteBuffer buf = null; try ( ByteArrayOutputStream out = new ByteArrayOutputStream()) { ImageIO.write(img, IMAGE_FORMAT, out); out.flush(); byte[] data = out.toByteArray(); buf = ByteBuffer.allocateDirect(data.length); buf.put(data, 0, data.length); buf.flip(); } texture = new Texture(buf); } \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u5df2\u7ecf\u7a0d\u5fae\u4fee\u6539\u4e86 Texture \u7c7b\uff0c\u4f7f\u5176\u5177\u6709\u4e00\u4e2a\u63a5\u6536 ByteBuffer \u7684\u6784\u9020\u51fd\u6570\u3002\u5176\u4e2d\u8fd9\u4e2a\u65b0\u7684\u6784\u9020\u51fd\u6570\u4f7f\u7528 stbi_load_from_memory \u52a0\u8f7d\u56fe\u7247\u3002\u73b0\u5728\u6211\u4eec\u53ea\u9700\u66f4\u6539 TextItem \u7c7b\uff0c\u4ee5\u4fbf\u5728\u5176\u6784\u9020\u51fd\u6570\u4e2d\u63a5\u6536 FontTexture \u5b9e\u4f8b\u3002 public TextItem(String text, FontTexture fontTexture) throws Exception { super(); this.text = text; this.fontTexture = fontTexture; setMesh(buildMesh()); } \u53ea\u9700\u8981\u5728\u8bbe\u7f6e\u7247\u6bb5\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u65f6\u7a0d\u7a0d\u4fee\u6539 buildMesh \u65b9\u6cd5\uff0c\u4e0b\u8ff0\u4ee3\u7801\u662f\u5176\u4e2d\u4e00\u4e2a\u9876\u70b9\u7684\u793a\u4f8b\uff1a float startx = 0; for(int i=0; i<numChars; i++) { FontTexture.CharInfo charInfo = fontTexture.getCharInfo(characters[i]); // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u9876\u70b9 positions.add(startx); // x positions.add(0.0f); // y positions.add(ZPOS); // z textCoords.add( (float)charInfo.getStartX() / (float)fontTexture.getWidth()); textCoords.add(0.0f); indices.add(i*VERTICES_PER_QUAD); // \u66f4\u591a\u4ee3\u7801... startx += charInfo.getWidth(); } \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u5176\u4ed6\u66f4\u6539\u3002\u4e0b\u56fe\u662f\u4e00\u4e2a\u5927\u5c0f\u4e3a20\u7684Arial\u5b57\u4f53\u7684\u6e32\u67d3\u6548\u679c\uff1a \u5982\u4f60\u6240\u89c1\u6587\u672c\u6e32\u67d3\u7684\u8d28\u91cf\u5df2\u7ecf\u6709\u4e86\u5f88\u5927\u7684\u63d0\u5347\uff0c\u4f60\u53ef\u4ee5\u7528\u4e0d\u540c\u7684\u5b57\u4f53\u548c\u5927\u5c0f\u6765\u6e32\u67d3\u3002\u8fd9\u4ecd\u7136\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4(\u5982\u652f\u6301\u591a\u884c\u6587\u672c\u3001\u7279\u6548\u7b49)\uff0c\u4f46\u8fd9\u5c06\u7559\u7ed9\u5404\u4f4d\u8bfb\u8005\u4f5c\u4e3a\u7ec3\u4e60\u3002 \u4f60\u53ef\u80fd\u8fd8\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u4ecd\u7136\u80fd\u591f\u7f29\u653e\u6587\u672c\uff08\u901a\u8fc7\u7740\u8272\u5668\u4e2d\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002\u73b0\u5728\u7684\u6587\u672c\u53ef\u80fd\u4e0d\u9700\u8981\u7f29\u653e\uff0c\u4f46\u5bf9\u5176\u4ed6\u7684HUD\u5143\u7d20\u53ef\u80fd\u4f1a\u6709\u7528\u3002 \u6211\u4eec\u5df2\u7ecf\u786e\u7acb\u4e86\u6240\u6709\u7684\u57fa\u672c\u6570\u636e\u7ed3\u6784\uff0c\u4ee5\u4fbf\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\u3002\u73b0\u5728\uff0c\u53ea\u5269\u4e00\u4e2a\u95ee\u9898\uff0c\u90a3\u5c31\u662f\u521b\u5efa\u6240\u6709\u7684\u5143\u7d20\uff0c\u4f20\u9012\u76f8\u5173\u4fe1\u606f\u7ed9\u7528\u6237\uff0c\u5e76\u7ed9\u4ed6\u4eec\u4e00\u4e2a\u4e13\u4e1a\u7684\u5916\u89c2\u3002 OSX \u5982\u679c\u4f60\u8bd5\u56fe\u8fd0\u884c\u672c\u7ae0\u4e2d\u7684\u793a\u4f8b\uff0c\u4ee5\u53ca\u4e0b\u4e00\u4e2a\u6e32\u67d3\u6587\u672c\u7684\u793a\u4f8b\uff0c\u5219\u53ef\u80fd\u4f1a\u53d1\u73b0\u5e94\u7528\u7a0b\u5e8f\u963b\u585e\uff0c\u5c4f\u5e55\u4e0a\u4e0d\u4f1a\u663e\u793a\u4efb\u4f55\u5185\u5bb9\u3002\u8fd9\u662f\u7531\u4e8eAWT\u548cGLFW\u5728OSX\u4e0b\u76f8\u5904\u5f97\u4e0d\u592a\u597d\uff0c\u4f46\u8fd9\u548cAWT\u6709\u4ec0\u4e48\u5173\u7cfb\u5462\uff1f\u6211\u4eec\u4f7f\u7528\u7684\u662f Font \u7c7b\uff0c\u5b83\u5c5e\u4e8eAWT\uff0c\u5982\u679c\u8981\u5b9e\u4f8b\u5316\u5b83\uff0cAWT\u4e5f\u9700\u8981\u521d\u59cb\u5316\u3002\u5728OSX\u4e2d\uff0cAWT\u8bd5\u56fe\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u4f46GLFW\u4e5f\u9700\u8981\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u8fd9\u5c31\u662f\u9020\u6210\u6b64\u95ee\u9898\u7684\u539f\u56e0\u3002 \u4e3a\u4e86\u80fd\u591f\u4f7f\u7528 Font \u7c7b\uff0cGLFW\u5fc5\u987b\u5728AWT\u4e4b\u524d\u521d\u59cb\u5316\uff0c\u5e76\u4e14\u793a\u4f8b\u9700\u8981\u4ee5Headless\u6a21\u5f0f\u8fd0\u884c\u3002\u4f60\u9700\u8981\u5728\u4efb\u4f55\u4e1c\u897f\u88ab\u521d\u59cb\u5316\u4e4b\u524d\u8bbe\u7f6e\u6b64\u5c5e\u6027\uff1a System.setProperty(\"java.awt.headless\", \"true\"); \u4f60\u4e5f\u8bb8\u4f1a\u6536\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u4f46\u793a\u4f8b\u6210\u529f\u8fd0\u884c\u4e86\u3002 \u4e00\u4e2a\u66f4\u7b80\u6d01\u7684\u65b9\u6cd5\u662f\u4f7f\u7528 stb \u5e93\u6765\u6e32\u67d3\u6587\u672c\u3002","title":"\u6e38\u620fHUD"},{"location":"12-game-hud/#hudgame-hud","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\uff08Heads-Up Display\uff0c\u5e73\u89c6\u663e\u793a\u5668\uff09\u3002\u6362\u53e5\u8bdd\u8bf4\uff0c\u5c31\u662f\u4e00\u7ec4\u7528\u4e8e\u5728\u4e09\u7ef4\u573a\u666f\u4e0a\uff0c\u968f\u65f6\u663e\u793a\u76f8\u5173\u4fe1\u606f\u7684\u4e8c\u7ef4\u56fe\u5f62\u548c\u6587\u672c\u3002\u672c\u4f8b\u4e2d\u5c06\u521b\u5efa\u4e00\u4e2a\u7b80\u5355\u7684HUD\uff0c\u8fd9\u53ef\u4e3a\u6211\u4eec\u5c55\u73b0\u4e00\u4e9b\u663e\u793a\u4fe1\u606f\u7684\u57fa\u672c\u6280\u672f\u3002 \u5f53\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\u65f6\uff0c\u8fd8\u5c06\u53d1\u73b0\u6211\u4eec\u5bf9\u6e90\u4ee3\u7801\u505a\u4e86\u4e00\u4e9b\u5c0f\u7684\u91cd\u6784\uff0c\u7279\u522b\u662f Renderer \u7c7b\uff0c\u4ee5\u4fbf\u4e3aHUD\u6e32\u67d3\u505a\u597d\u51c6\u5907\u3002","title":"\u6e38\u620fHUD\uff08Game HUD\uff09"},{"location":"12-game-hud/#_1","text":"\u521b\u5efaHUD\u6240\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6e32\u67d3\u6587\u672c\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u50a8\u5b58\u5b57\u7b26\u7684\u7eb9\u7406\u6620\u5c04\u5230\u4e00\u4e2a\u65b9\u5f62\u4e2d\uff0c\u8be5\u65b9\u5f62\u5c06\u88ab\u5206\u5272\u4e3a\u4e00\u7ec4\u8868\u793a\u6bcf\u4e2a\u5b57\u7b26\u7684\u7247\u6bb5\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u7eb9\u7406\u5728\u5c4f\u5e55\u4e0a\u7ed8\u5236\u6587\u672c\u3002\u6240\u4ee5\u9996\u5148\u521b\u5efa\u542b\u6709\u6240\u6709\u5b57\u6bcd\u7684\u7eb9\u7406\uff0c\u8fd9\u9879\u5de5\u4f5c\u53ef\u4ee5\u4f7f\u7528\u5f88\u591a\u8f6f\u4ef6\u6765\u505a\uff0c\u4f8b\u5982 CBFG \u3001 F2IBuilder \u7b49\u7b49\u3002\u672c\u4f8b\u4f7f\u7528Codehead\u7684\u4f4d\u56fe\u5b57\u4f53\u751f\u6210\u5668\uff08Codehead\u2019s Bitmap Font Generator\uff0cCBFG\uff09\u3002 CBFG\u5141\u8bb8\u4f60\u914d\u7f6e\u5f88\u591a\u9009\u9879\uff0c\u5982\u7eb9\u7406\u5927\u5c0f\u3001\u5b57\u4f53\u7c7b\u578b\u3001\u8981\u4f7f\u7528\u7684\u6297\u952f\u9f7f\u7b49\u7b49\u3002\u4e0b\u56fe\u662f\u672c\u4f8b\u5c06\u7528\u6765\u751f\u6210\u7eb9\u7406\u6587\u4ef6\u7684\u914d\u7f6e\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u6587\u672c\u7f16\u7801\u4e3aISO-8859-1\uff0c\u5982\u679c\u4f60\u9700\u8981\u5904\u7406\u5176\u4ed6\u7684\u5b57\u7b26\u96c6\uff0c\u5219\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u4ee3\u7801\u3002 \u5f53\u8bbe\u7f6e\u597dCBFG\u7684\u6240\u6709\u9009\u9879\u540e\uff0c\u53ef\u4ee5\u5c06\u5176\u5bfc\u51fa\u4e3a\u591a\u79cd\u56fe\u7247\u683c\u5f0f\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5176\u5bfc\u51fa\u4e3aBMP\u6587\u4ef6\uff0c\u7136\u540e\u518d\u8f6c\u6362\u4e3aPNG\u6587\u4ef6\uff0c\u4ee5\u4fbf\u5c06\u5176\u4f5c\u4e3a\u7eb9\u7406\u52a0\u8f7d\u3002\u5f53\u8f6c\u6362\u4e3aPNG\u683c\u5f0f\u65f6\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u5c06\u9ed1\u8272\u80cc\u666f\u8bbe\u7f6e\u4e3a\u900f\u660e\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u5c06\u9ed1\u8272\u8bbe\u4e3aAlpha\u503c\u7b49\u4e8e0\uff08\u53ef\u4ee5\u4f7f\u7528GIMP\u8fd9\u6837\u7684\u5de5\u5177\u6765\u5b9e\u73b0\uff09\u3002\u6700\u7ec8\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u56fe\u50cf\u4e2d\u7684\u6240\u6709\u5b57\u7b26\u90fd\u4ee5\u884c\u548c\u5217\u7684\u5f62\u5f0f\u6392\u5217\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u56fe\u50cf\u753115\u5217\u548c17\u884c\u5b57\u7b26\u7ec4\u6210\u3002\u901a\u8fc7\u4f7f\u7528\u7279\u5b9a\u5b57\u7b26\u7684\u7f16\u53f7\uff0c\u6211\u4eec\u53ef\u4ee5\u8ba1\u7b97\u5176\u5bf9\u5e94\u50a8\u5b58\u5728\u56fe\u50cf\u4e2d\u7684\u884c\u548c\u5217\u3002\u6240\u5728\u5217\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u5217\u6570 = \u5b57\u7b26\u7f16\u53f7 \\space mod \\space \u5217\u603b\u6570 \uff0c\u5176\u4e2d mod \u662f\u53d6\u4f59\u8fd0\u7b97\u7b26\uff0c\u6240\u5728\u884c\u7684\u8ba1\u7b97\u65b9\u6cd5\u4e3a\uff1a \u6240\u5728\u884c = \u5b57\u7b26\u7f16\u53f7 / \u884c\u603b\u6570 \u3002\u5728\u672c\u4f8b\u4e2d\u6211\u4eec\u5c06\u6574\u6570\u9664\u4ee5\u6574\u6570\uff0c\u4ee5\u4fbf\u5ffd\u7565\u5c0f\u6570\u90e8\u5206\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a TextItem \u7684\u65b0\u7c7b\uff0c\u5b83\u5c06\u50a8\u5b58\u6e32\u67d3\u6587\u672c\u6240\u9700\u7684\u56fe\u5143\u3002\u8fd9\u662f\u4e00\u4e2a\u4e0d\u8003\u8651\u591a\u884c\u6587\u672c\u7684\u7b80\u5316\u5b9e\u73b0\uff0c\u4f46\u662f\u5b83\u80fd\u5728HUD\u4e2d\u663e\u793a\u6587\u672c\u4fe1\u606f\u3002\u4e0b\u5217\u4ee3\u7801\u662f\u8be5\u7c7b\u7684\u58f0\u660e\u4e0e\u6784\u9020\u51fd\u6570\uff1a package org.lwjglb.engine; import java.nio.charset.Charset; import java.util.ArrayList; import java.util.List; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; public class TextItem extends GameItem { private static final float ZPOS = 0.0f; private static final int VERTICES_PER_QUAD = 4; private String text; private final int numCols; private final int numRows; public TextItem(String text, String fontFileName, int numCols, int numRows) throws Exception { super(); this.text = text; this.numCols = numCols; this.numRows = numRows; Texture texture = new Texture(fontFileName); this.setMesh(buildMesh(texture, numCols, numRows)); } \u8fd9\u4e2a\u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u6539\u53d8\u5728\u5c4f\u5e55\u4e0a\u6587\u672c\u7684\u4f4d\u7f6e\uff0c\u4e5f\u53ef\u80fd\u9700\u8981\u7f29\u653e\u548c\u65cb\u8f6c\u5b83\u3002\u6784\u9020\u51fd\u6570\u63a5\u6536\u8981\u6e32\u67d3\u7684\u6587\u672c\u548c\u7528\u4e8e\u6e32\u67d3\u7684\u7eb9\u7406\u7684\u6587\u4ef6\u548c\u76f8\u5173\u6570\u636e\uff08\u50a8\u5b58\u56fe\u50cf\u7684\u6587\u4ef6\u53ca\u884c\u5217\u6570\uff09\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u56fe\u50cf\u6587\u4ef6\uff0c\u5e76\u8c03\u7528\u4e00\u4e2a\u65b9\u6cd5\u6765\u521b\u5efa\u4e00\u4e2a Mesh \u5b9e\u4f8b\u4e3a\u6587\u672c\u5efa\u6a21\u3002\u8ba9\u6211\u4eec\u770b\u5230 buildMesh \u65b9\u6cd5\uff1a private Mesh buildMesh(Texture texture, int numCols, int numRows) { byte[] chars = text.getBytes(Charset.forName(\"ISO-8859-1\")); int numChars = chars.length; List<Float> positions = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); float[] normals = new float[0]; List<Integer> indices = new ArrayList<>(); float tileWidth = (float)texture.getWidth() / (float)numCols; float tileHeight = (float)texture.getHeight() / (float)numRows; \u4ee3\u7801\u521b\u5efa\u4e86\u7528\u4e8e\u50a8\u5b58Mesh\u7684\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u6cd5\u7ebf\u548c\u7d22\u5f15\u7684\u6570\u636e\u7ed3\u6784\u3002\u73b0\u5728\u6211\u4eec\u4e0d\u4f7f\u7528\u5149\u7167\uff0c\u56e0\u6b64\u6cd5\u7ebf\u6570\u5217\u662f\u7a7a\u7684\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u7ec4\u5b57\u7b26\u7247\u6bb5\uff0c\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u4ee3\u8868\u4e00\u4e2a\u5b57\u7b26\u3002\u6211\u4eec\u8fd8\u9700\u8981\u6839\u636e\u6bcf\u4e2a\u7247\u6bb5\u5bf9\u5e94\u7684\u5b57\u7b26\u6765\u5206\u914d\u5bf9\u5e94\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u6587\u672c\u77e9\u5f62\u548c\u5b57\u7b26\u7247\u6bb5\u7684\u5173\u7cfb\uff1a \u56e0\u6b64\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u5b57\u7b26\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u6784\u6210\u7684\u5b57\u7b26\u7247\u6bb5\uff0c\u8fd9\u4e24\u4e2a\u4e09\u89d2\u5f62\u53ef\u4ee5\u7528\u56db\u4e2a\u9876\u70b9\uff08V1\u3001V2\u3001V3\u548cV4\uff09\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u4e09\u89d2\u5f62\uff08\u5de6\u4e0b\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(0, 1, 2)\uff0c\u800c\u7b2c\u4e8c\u4e2a\u4e09\u89d2\u5f62\uff08\u53f3\u4e0a\u89d2\u7684\u90a3\u4e2a\uff09\u7684\u7d22\u5f15\u4e3a(3, 0, 2)\u3002\u7eb9\u7406\u5750\u6807\u662f\u57fa\u4e8e\u4e0e\u7eb9\u7406\u56fe\u50cf\u4e2d\u6bcf\u4e2a\u5b57\u7b26\u76f8\u5173\u7684\u884c\u5217\u8ba1\u7b97\u7684\uff0c\u7eb9\u7406\u5750\u6807\u7684\u8303\u56f4\u4e3a[0, 1]\uff0c\u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5f53\u524d\u884c\u6216\u5f53\u524d\u5217\u9664\u4ee5\u603b\u884c\u6570\u548c\u603b\u5217\u6570\u5c31\u53ef\u4ee5\u83b7\u5f97V1\u7684\u5750\u6807\u3002\u5bf9\u4e8e\u5176\u4ed6\u9876\u70b9\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9002\u5f53\u52a0\u4e0a\u884c\u5bbd\u6216\u5217\u5bbd\u5c31\u53ef\u4ee5\u5f97\u5230\u5bf9\u5e94\u5750\u6807\u3002 \u4e0b\u8ff0\u7684\u5faa\u73af\u8bed\u53e5\u5757\u521b\u5efa\u4e86\u4e0e\u6e32\u67d3\u6587\u672c\u77e9\u5f62\u76f8\u5173\u7684\u6240\u6709\u9876\u70b9\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002 for(int i=0; i<numChars; i++) { byte currChar = chars[i]; int col = currChar % numCols; int row = currChar / numCols; // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD); // \u5de6\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)col / (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 1); // \u53f3\u4e0b\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(tileHeight); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)(row + 1) / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 2); // \u53f3\u4e0a\u89d2\u7684\u9876\u70b9 positions.add((float)i*tileWidth + tileWidth); // x positions.add(0.0f); //y positions.add(ZPOS); //z textCoords.add((float)(col + 1)/ (float)numCols ); textCoords.add((float)row / (float)numRows ); indices.add(i*VERTICES_PER_QUAD + 3); // \u6dfb\u52a0\u5de6\u4e0a\u89d2\u548c\u53f3\u4e0b\u89d2\u9876\u70b9\u7684\u7d22\u5f15 indices.add(i*VERTICES_PER_QUAD); indices.add(i*VERTICES_PER_QUAD + 2); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u9700\u8981\u6ce8\u610f\u7684\u4e00\u4e9b\u4e8b\u9879\uff1a \u6211\u4eec\u5c06\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u6765\u8868\u793a\u9876\u70b9\uff08\u8bb0\u4f4f\u5c4f\u5e55\u5750\u6807\u7cfb\u7684\u539f\u70b9\u4f4d\u4e8e\u5c4f\u5e55\u5de6\u4e0a\u89d2\uff09\u3002\u4e09\u89d2\u5f62\u4e0a\u9876\u70b9\u7684Y\u5750\u6807\u5c0f\u4e8e\u4e09\u89d2\u5f62\u4e0b\u9876\u70b9\u7684Y\u5750\u6807\u3002 \u6211\u4eec\u4e0d\u7f29\u653e\u56fe\u5f62\uff0c\u56e0\u6b64\u6bcf\u4e2a\u5b57\u7b26\u7247\u6bb5\u7684X\u8ddd\u79bb\u5c31\u7b49\u4e8e\u5b57\u7b26\u5bbd\u5ea6\uff0c\u4e09\u89d2\u5f62\u7684\u9ad8\u5ea6\u5c31\u662f\u6bcf\u4e2a\u5b57\u7b26\u7684\u9ad8\u5ea6\u3002\u8fd9\u662f\u56e0\u4e3a\u672c\u4f8b\u5e0c\u671b\u5c3d\u53ef\u80fd\u5730\u4f7f\u6e32\u67d3\u6587\u672c\u4e0e\u539f\u59cb\u7eb9\u7406\u76f8\u4f3c\uff08\u4e0d\u7ba1\u600e\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u7a0d\u540e\u7f29\u653e\u5b83\uff0c\u56e0\u4e3a TextItem \u7c7b\u7ee7\u627f\u4e86 GameItem \u7c7b\uff09\u3002 Z\u5750\u6807\u4e3a\u56fa\u5b9a\u503c\uff0c\u56e0\u4e3a\u5b83\u4e0e\u7ed8\u5236\u8be5\u56fe\u50cf\u65e0\u5173\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e9b\u9876\u70b9\u7684\u5750\u6807\uff1a \u4e3a\u4ec0\u4e48\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u7cfb\uff1f\u9996\u5148\uff0c\u56e0\u4e3a\u672c\u4f8b\u5c06\u5728HUD\u4e2d\u6e32\u67d32D\u5bf9\u8c61\uff0c\u5e76\u4e14\u901a\u5e38\u8fd9\u6837\u4f7f\u7528\u5b83\u4eec\u66f4\u65b9\u4fbf\u3002\u5176\u6b21\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u7ed8\u5236\u5b83\u4eec\uff0c\u7a0d\u540e\u518d\u89e3\u91ca\u4ec0\u4e48\u662f\u6b63\u4ea4\u6295\u5f71\u3002 TextItem \u7c7b\u6700\u540e\u8fd8\u9700\u6dfb\u52a0\u4e00\u4e9b\u65b9\u6cd5\uff0c\u4ee5\u83b7\u53d6\u6587\u672c\u5e76\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u6587\u672c\u3002\u6bcf\u5f53\u6587\u672c\u88ab\u66f4\u6539\u65f6\uff0c\u9700\u8981\u6e05\u7406\u6b64\u524d\u7684VAO\uff08\u50a8\u5b58\u5728 Mesh \u5b9e\u4f8b\u4e2d\uff09\u5e76\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VAO\u3002\u6211\u4eec\u4e0d\u9700\u8981\u5220\u9664\u7eb9\u7406\uff0c\u6240\u4ee5\u5728 Mesh \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u5220\u9664\u8fd9\u4e9b\u6570\u636e\u3002 public String getText() { return text; } public void setText(String text) { this.text = text; Texture texture = this.getMesh().getMaterial().getTexture(); this.getMesh().deleteBuffers(); this.setMesh(buildMesh(texture, numCols, numRows)); } \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u5efa\u7acb\u4e86\u6e32\u67d3\u6587\u672c\u6240\u9700\u8981\u7684\u57fa\u7840\u7ed3\u6784\uff0c\u63a5\u4e0b\u6765\u8be5\u600e\u4e48\u505a\u5462\uff1f\u9996\u5148\u5982\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\uff0c\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\uff0c\u7136\u540e\u5728\u5176\u4e0a\u6e32\u67d3\u4e8c\u7ef4\u7684HUD\u3002\u4e3a\u4e86\u6e32\u67d3HUD\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\uff08\u4e5f\u79f0\u4e3a\u6b63\u4ea4\u6295\u5f71\uff09\u3002\u6b63\u4ea4\u6295\u5f71\u662f\u4e09\u7ef4\u7269\u4f53\u7684\u4e00\u79cd\u4e8c\u7ef4\u8868\u793a\u65b9\u5f0f\uff0c\u4f60\u53ef\u80fd\u5df2\u7ecf\u5728\u4e09\u7ef4\u6a21\u578b\u7684\u84dd\u56fe\u4e2d\u770b\u5230\u4e86\u4e00\u4e9b\u4f8b\u5b50\uff0c\u5b83\u4eec\u7528\u6765\u8868\u793a\u67d0\u4e9b\u7269\u4f53\u4ece\u9876\u90e8\u6216\u67d0\u4e9b\u4fa7\u9762\u770b\u5230\u7684\u6837\u5b50\u3002\u4e0b\u56fe\u662f\u5706\u67f1\u4f53\u4ece\u9876\u90e8\u548c\u524d\u9762\u7684\u6b63\u4ea4\u6295\u5f71\uff1a \u8fd9\u79cd\u6295\u5f71\u5bf9\u4e8e\u7ed8\u5236\u4e8c\u7ef4\u7269\u4f53\u662f\u975e\u5e38\u65b9\u4fbf\u7684\uff0c\u56e0\u4e3a\u5b83\u201c\u5ffd\u7565\u201d\u4e86Z\u5750\u6807\u7684\u503c\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5ffd\u7565\u4e86\u5230\u5c4f\u5e55\u7684\u8ddd\u79bb\u3002\u4f7f\u7528\u8fd9\u79cd\u6295\u5f71\uff0c\u7269\u4f53\u5927\u5c0f\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u7684\u589e\u5927\u800c\u51cf\u5c0f\uff08\u4e0d\u540c\u4e8e\u900f\u89c6\u6295\u5f71\uff09\u3002\u4e3a\u4e86\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u6295\u5f71\u7269\u4f53\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u4e2a\u77e9\u9635\uff0c\u5373\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u516c\u5f0f\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u4e2a\u77e9\u9635\u8fd8\u77eb\u6b63\u4e86\u5931\u771f\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7a97\u53e3\u5e76\u4e0d\u603b\u662f\u5b8c\u7f8e\u7684\u6b63\u65b9\u5f62\uff0c\u800c\u662f\u4e00\u4e2a\u77e9\u5f62\u3002 right \u548c bottom \u662f\u5c4f\u5e55\u5927\u5c0f\uff0c\u800c left \u548c top \u662f\u539f\u70b9\u5750\u6807\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7528\u4e8e\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u8be5\u6295\u5f71\u7684\u6620\u5c04\u8fc7\u7a0b\uff1a \u8be5\u77e9\u9635\u5c06\u5141\u8bb8\u6211\u4eec\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7ee7\u7eed\u5b9e\u73b0HUD\u4e86\u3002\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u521b\u5efa\u53e6\u4e00\u7ec4\u7740\u8272\u5668\uff0c\u4e00\u4e2a\u9876\u70b9\u7740\u8272\u5668\u548c\u4e00\u4e2a\u7247\u5143\u7740\u8272\u5668\uff0c\u6765\u7ed8\u5236HUD\u3002\u9876\u70b9\u7740\u8272\u5668\u5f88\u7b80\u5355\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 projModelMatrix; void main() { gl_Position = projModelMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u5b83\u4ec5\u63a5\u6536\u9876\u70b9\u5750\u6807\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u6cd5\u7ebf\uff0c\u5e76\u5c06\u4f7f\u7528\u77e9\u9635\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u4e09\u7ef4\u7a7a\u95f4\u5750\u6807\uff0c\u8be5\u77e9\u9635\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u7684\u4e58\u79ef\uff0c\u5373 projModelMatrix = \u6b63\u4ea4\u6295\u5f71\u77e9\u9635 \\cdot \u6a21\u578b\u77e9\u9635 \u3002\u7531\u4e8e\u6211\u4eec\u6ca1\u6709\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d\u5bf9\u5750\u6807\u505a\u4efb\u4f55\u5904\u7406\uff0c\u6240\u4ee5\u5728Java\u4ee3\u7801\u4e2d\u5c06\u4e24\u4e2a\u77e9\u9635\u76f8\u4e58\u6bd4\u5728\u7740\u8272\u5668\u4e2d\u76f8\u4e58\u66f4\u9ad8\u6548\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u4e3a\u6bcf\u4e2a\u9879\u76ee\u505a\u4e00\u6b21\u77e9\u9635\u4e58\u6cd5\u8fd0\u7b97\uff0c\u800c\u4e0d\u662f\u4e3a\u6bcf\u4e2a\u9876\u70b9\u505a\u4e00\u6b21\u3002\u8fd8\u5e94\u8bb0\u4f4f\u9876\u70b9\u5e94\u8be5\u7528\u5c4f\u5e55\u5750\u6807\u8868\u793a\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; void main() { fragColor = colour * texture(texture_sampler, outTexCoord); } \u5b83\u53ea\u662f\u5c06\u57fa\u672c\u989c\u8272\u4e0e\u7eb9\u7406\u989c\u8272\u76f8\u4e58\uff0c\u8fd9\u6837\u53ef\u4ee5\u6539\u53d8\u6e32\u67d3\u6587\u672c\u7684\u989c\u8272\uff0c\u800c\u4e0d\u9700\u8981\u521b\u5efa\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u73b0\u5728\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u7ec4\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a IHud \u7684\u63a5\u53e3\uff0c\u8be5\u63a5\u53e3\u50a8\u5b58\u6240\u6709\u8981\u5728HUD\u4e0a\u663e\u793a\u7684\u5143\u7d20\uff0c\u5e76\u63d0\u4f9b\u4e00\u4e2a\u9ed8\u8ba4\u7684 cleanup \u65b9\u6cd5\u3002 package org.lwjglb.engine; public interface IHud { GameItem[] getGameItems(); default void cleanup() { GameItem[] gameItems = getGameItems(); for (GameItem gameItem : gameItems) { gameItem.getMesh().cleanUp(); } } } \u901a\u8fc7\u8be5\u63a5\u53e3\uff0c\u4e0d\u540c\u7684\u6e38\u620f\u53ef\u4ee5\u5b9a\u4e49\u81ea\u5b9a\u4e49\u7684HUD\uff0c\u800c\u4e0d\u9700\u8981\u6539\u53d8\u6e32\u67d3\u673a\u5236\u3002\u73b0\u5728\u56de\u5230 Renderer \u7c7b\uff0c\u987a\u4fbf\u4e00\u63d0\uff0c\u5b83\u5df2\u7ecf\u88ab\u79fb\u52a8\u5230 engine.graph \u5305\u4e0b\uff0c\u56e0\u4e3a\u73b0\u5728\u5b83\u7684\u901a\u7528\u6027\u8db3\u4ee5\u4e0d\u4f9d\u8d56\u4efb\u4f55\u6e38\u620f\u7684\u5177\u4f53\u5b9e\u73b0\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u521b\u5efa\u3001\u8fde\u63a5\u548c\u521d\u59cb\u5316\u4e00\u4e2a\u65b0\u7684 ShaderProgram \uff0c\u4ee5\u4fbf\u4f7f\u7528\u4e0a\u8ff0\u6240\u793a\u7684\u7740\u8272\u5668\u3002 private void setupHudShader() throws Exception { hudShaderProgram = new ShaderProgram(); hudShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/hud_vertex.vs\")); hudShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/hud_fragment.fs\")); hudShaderProgram.link(); // \u4e3a\u6b63\u4ea4\u6295\u5f71\u6a21\u578b\u77e9\u9635\u548c\u989c\u8272\u521b\u5efaUniform hudShaderProgram.createUniform(\"projModelMatrix\"); hudShaderProgram.createUniform(\"colour\"); } render \u65b9\u6cd5\u9996\u5148\u4f1a\u8c03\u7528 renderScene \u65b9\u6cd5\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6b64\u524d\u7ae0\u8282\u6240\u8ff0\u7684\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u4ee3\u7801\uff0c\u7136\u540e\u8c03\u7528\u4e00\u4e2a\u540d\u4e3a renderHud \u7684\u65b0\u65b9\u6cd5\uff0c\u7528\u4e8e\u6e32\u67d3HUD\u3002 public void render(Window window, Camera camera, GameItem[] gameItems, SceneLight sceneLight, IHud hud) { clear(); if ( window.isResized() ) { glViewport(0, 0, window.getWidth(), window.getHeight()); window.setResized(false); } renderScene(window, camera, gameItems, sceneLight); renderHud(window, hud); } renderHud \u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\uff1a private void renderHud(Window window, IHud hud) { hudShaderProgram.bind(); Matrix4f ortho = transformation.getOrthoProjectionMatrix(0, window.getWidth(), window.getHeight(), 0); for (GameItem gameItem : hud.getGameItems()) { Mesh mesh = gameItem.getMesh(); // HUD\u5143\u7d20\u7684\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58 Matrix4f projModelMatrix = transformation.getOrtoProjModelMatrix(gameItem, ortho); hudShaderProgram.setUniform(\"projModelMatrix\", projModelMatrix); hudShaderProgram.setUniform(\"colour\", gameItem.getMesh().getMaterial().getAmbientColour()); // \u6e32\u67d3\u6b64HUD\u9879\u76ee\u7684\u7f51\u683c mesh.render(); } hudShaderProgram.unbind(); } \u4e0a\u8ff0\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u904d\u5386\u4e86HUD\u7684\u6240\u6709\u5143\u7d20\uff0c\u5e76\u5c06\u4e0e\u6bcf\u4e2a\u5143\u7d20\u5173\u8054\u7684\u6a21\u578b\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u76f8\u4e58\u3002\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5728\u6bcf\u6b21 render \u8c03\u7528\u65f6\u88ab\u5237\u65b0\uff08\u56e0\u4e3a\u5c4f\u5e55\u5927\u5c0f\u53ef\u4ee5\u88ab\u6539\u53d8\uff09\uff0c\u5e76\u4e14\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a public final Matrix4f getOrthoProjectionMatrix(float left, float right, float bottom, float top) { orthoMatrix.identity(); orthoMatrix.setOrtho2D(left, right, bottom, top); return orthoMatrix; } \u6211\u4eec\u5c06\u5728 game \u5305\u4e2d\u521b\u5efa\u4e00\u4e2a Hud \u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86 IHud \u63a5\u53e3\uff0c\u5e76\u5728\u6784\u9020\u51fd\u6570\u63a5\u6536\u4e00\u4e2a\u6587\u672c\uff0c\u7528\u4e8e\u5728\u5176\u4e2d\u521b\u5efa TextItem \u5b9e\u4f8b\u3002 package org.lwjglb.game; import org.joml.Vector4f; import org.lwjglb.engine.GameItem; import org.lwjglb.engine.IHud; import org.lwjglb.engine.TextItem; public class Hud implements IHud { private static final int FONT_COLS = 15; private static final int FONT_ROWS = 17; private static final String FONT_TEXTURE = \"textures/font_texture.png\"; private final GameItem[] gameItems; private final TextItem statusTextItem; public Hud(String statusText) throws Exception { this.statusTextItem = new TextItem(statusText, FONT_TEXTURE, FONT_COLS, FONT_ROWS); this.statusTextItem.getMesh().getMaterial().setColour(new Vector4f(1, 1, 1, 1)); gameItems = new GameItem[]{statusTextItem}; } public void setStatusText(String statusText) { this.statusTextItem.setText(statusText); } @Override public GameItem[] getGameItems() { return gameItems; } public void updateSize(Window window) { this.statusTextItem.setPosition(10f, window.getHeight() - 50f, 0); } } \u5728 DummyGame \u7c7b\u4e2d\u6211\u4eec\u521b\u5efa\u8be5\u7c7b\u7684\u5b9e\u4f8b\uff0c\u5e76\u7528\u9ed8\u8ba4\u6587\u672c\u521d\u59cb\u5316\u5b83\uff0c\u6700\u540e\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7ed3\u679c\uff1a \u5728 Texture \u7c7b\u4e2d\u53ef\u4ee5\u901a\u8fc7\u4fee\u6539\u7eb9\u7406\u7684\u8fc7\u6ee4\u65b9\u5f0f\u6765\u63d0\u5347\u6587\u672c\u7684\u53ef\u8bfb\u6027\uff08\u5982\u679c\u9700\u8981\u6587\u672c\u7f29\u653e\u7684\u8bdd\u9700\u8981\u6ce8\u610f\u6b64\u4e8b\uff09\u3002 glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); \u4f46\u662f\u672c\u4f8b\u8fd8\u6ca1\u6709\u505a\u5b8c\u3002\u5982\u679c\u7528\u7f29\u653e\u4f7f\u6587\u672c\u4e0e\u7acb\u65b9\u4f53\u91cd\u53e0\u65f6\uff0c\u5c31\u4f1a\u770b\u5230\u5982\u4e0b\u6548\u679c\uff1a \u7ed8\u5236\u7684\u6587\u672c\u80cc\u666f\u4e0d\u900f\u660e\u3002\u4e3a\u4e86\u5b9e\u73b0\u80cc\u666f\u900f\u660e\uff0c\u6211\u4eec\u5fc5\u987b\u660e\u786e\u542f\u7528\u6df7\u5408\uff08Blend\uff09\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u4f7f\u7528Alpha\u5206\u91cf\u3002\u672c\u4f8b\u5c06\u5728 Window \u7c7b\u4e2d\u7528\u4e0b\u8ff0\u4ee3\u7801\u8bbe\u7f6e\u5176\u521d\u59cb\u5316\u53c2\u6570\uff1a // \u652f\u6301\u900f\u660e glEnable(GL_BLEND); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u4f60\u53ef\u4ee5\u770b\u5230\u6587\u672c\u4ee5\u900f\u660e\u80cc\u666f\u7ed8\u5236\u4e86\u3002","title":"\u6587\u672c\u6e32\u67d3"},{"location":"12-game-hud/#hud","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6e32\u67d3\u4e86\u4e00\u4e9b\u6587\u672c\uff0c\u4f46\u8fd8\u53ef\u4ee5\u5411HUD\u6dfb\u52a0\u66f4\u591a\u7684\u5143\u7d20\u3002\u672c\u4f8b\u5c06\u6dfb\u52a0\u4e00\u4e2a\u6839\u636e\u6444\u50cf\u673a\u671d\u5411\u65cb\u8f6c\u7684\u6307\u9488\u3002\u73b0\u5728\u6211\u4eec\u5c06\u5411 Hud \u7c7b\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 GameItem \uff0c\u5b83\u5c06\u5305\u542b\u4e00\u4e2a\u6307\u9488\u7684\u6a21\u578b\u7f51\u683c\u3002 \u6307\u9488\u7684\u6a21\u578b\u662f.obj\u6587\u4ef6\uff0c\u4f46\u5b83\u4e0d\u4f1a\u5173\u8054\u4efb\u4f55\u7eb9\u7406\uff0c\u76f8\u53cd\uff0c\u5b83\u53ea\u6709\u4e00\u4e2a\u57fa\u7840\u8272\u3002\u6240\u4ee5\u9700\u8981\u4fee\u6539HUD\u7684\u7247\u5143\u7740\u8272\u5668\uff0c\u4ee5\u786e\u8ba4\u662f\u5426\u4f7f\u7528\u7eb9\u7406\u3002\u672c\u4f8b\u5c06\u901a\u8fc7\u8bbe\u7f6e\u4e00\u4e2a\u540d\u4e3a hasTexture \u7684\u65b0Uniform\u6765\u5b9e\u73b0\u5b83\u3002 #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec4 colour; uniform int hasTexture; void main() { if ( hasTexture == 1 ) { fragColor = colour * texture(texture_sampler, outTexCoord); } else { fragColor = colour; } } \u8981\u5c06\u6307\u9488\u6dfb\u52a0\u5230HUD\u4e0a\uff0c\u53ea\u9700\u5728 Hud \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684 GameItem \u5b9e\u4f8b\u3002\u5b83\u52a0\u8f7d\u6307\u9488\u6a21\u578b\uff0c\u5e76\u5c06\u5176\u6dfb\u52a0\u5230\u9879\u76ee\u5217\u8868\u4e2d\u3002\u5728\u672c\u4f8b\u4e2d\u9700\u8981\u653e\u5927\u6307\u9488\uff0c\u56e0\u4e3a\u5b83\u5728\u5c4f\u5e55\u5750\u6807\u7cfb\u4e2d\u6e32\u67d3\uff0c\u6240\u4ee5\u901a\u5e38\u4f60\u9700\u8981\u653e\u5927\u5b83\u3002 // \u521b\u5efa\u6307\u9488 Mesh mesh = OBJLoader.loadMesh(\"/models/compass.obj\"); Material material = new Material(); material.setAmbientColour(new Vector4f(1, 0, 0, 1)); mesh.setMaterial(material); compassItem = new GameItem(mesh); compassItem.setScale(40.0f); // \u65cb\u8f6c\u4ee5\u5c06\u5176\u53d8\u6362\u5230\u5c4f\u5e55\u5750\u6807\u7cfb compassItem.setRotation(0f, 0f, 180f); // \u521b\u5efa\u4e00\u4e2a\u6570\u7ec4\uff0c\u7528\u4e8e\u50a8\u5b58HUD\u9879\u76ee gameItems = new GameItem[]{statusTextItem, compassItem}; \u8fd8\u8981\u6ce8\u610f\uff0c\u4e3a\u4e86\u4f7f\u6307\u9488\u6307\u5411\u4e0a\u65b9\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u65cb\u8f6c180\u00b0\uff0c\u56e0\u4e3a\u6a21\u578b\u901a\u5e38\u503e\u5411\u4e8e\u4f7f\u7528OpenGL\u7a7a\u95f4\u5750\u6807\u7cfb\u3002\u5982\u679c\u6211\u4eec\u8981\u4f7f\u7528\u5c4f\u5e55\u5750\u6807\uff0c\u5b83\u4f1a\u6307\u5411\u4e0b\u65b9\u3002 Hud \u7c7b\u8fd8\u63d0\u4f9b\u4e00\u4e2a\u65b9\u6cd5\u6765\u66f4\u65b0\u6307\u9488\u7684\u6307\u5411\uff0c\u8be5\u65b9\u6cd5\u4e5f\u5fc5\u987b\u8003\u8651\u5230\u8fd9\u4e00\u70b9\u3002 public void rotateCompass(float angle) { this.compassItem.setRotation(0, 0, 180 + angle); } \u5728 DummyGame \u7c7b\u4e2d\uff0c\u6bcf\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u6211\u4eec\u9700\u8981\u7528Y\u89d2\u65cb\u8f6c\u66f4\u65b0\u89d2\u5ea6\u3002 // \u6839\u636e\u9f20\u6807\u66f4\u65b0\u6444\u50cf\u673a if (mouseInput.isRightButtonPressed()) { Vector2f rotVec = mouseInput.getDisplVec(); camera.moveRotation(rotVec.x * MOUSE_SENSITIVITY, rotVec.y * MOUSE_SENSITIVITY, 0); // \u66f4\u65b0HUD\u6307\u9488 hud.rotateCompass(camera.getRotation().y); } \u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff08\u8bb0\u4f4f\u8fd9\u53ea\u662f\u4e2a\u793a\u4f8b\uff0c\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u4f60\u53ef\u80fd\u60f3\u4f7f\u7528\u4e00\u4e9b\u7eb9\u7406\u8bbe\u7f6e\u6307\u9488\u7684\u5916\u89c2\uff09\u3002","title":"\u5b8c\u5584HUD"},{"location":"12-game-hud/#_2","text":"\u5728\u56de\u987e\u5176\u4ed6\u4e3b\u9898\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u518d\u8c08\u8c08\u4e4b\u524d\u4ecb\u7ecd\u7684\u6587\u672c\u6e32\u67d3\u65b9\u6cd5\u3002\u8be5\u65b9\u6848\u975e\u5e38\u7b80\u6d01\u5730\u4ecb\u7ecd\u4e86\u6e32\u67d3HUD\u6240\u6d89\u53ca\u7684\u6982\u5ff5\uff0c\u4f46\u5b83\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\uff1a \u5b83\u4e0d\u652f\u6301\u975e\u62c9\u4e01\u5b57\u7b26\u3002 \u5982\u679c\u4f60\u60f3\u4f7f\u7528\u591a\u79cd\u5b57\u4f53\uff0c\u5219\u9700\u8981\u4e3a\u6bcf\u79cd\u5b57\u4f53\u521b\u5efa\u5355\u72ec\u7684\u7eb9\u7406\u6587\u4ef6\u3002\u6b64\u5916\uff0c\u6539\u53d8\u6587\u672c\u5927\u5c0f\u7684\u552f\u4e00\u65b9\u6cd5\u662f\u7f29\u653e\uff0c\u8fd9\u4f1a\u5bfc\u81f4\u6e32\u67d3\u6587\u672c\u7684\u8d28\u91cf\u8f83\u5dee\uff0c\u6216\u8005\u9700\u8981\u521b\u5efa\u989d\u5916\u7684\u7eb9\u7406\u6587\u4ef6\u3002 \u6700\u91cd\u8981\u7684\u662f\uff0c\u5927\u591a\u6570\u5b57\u4f53\u4e2d\u7684\u5b57\u7b26\u4e4b\u95f4\u7684\u5927\u5c0f\u5e76\u4e0d\u540c\uff0c\u800c\u6211\u4eec\u5c06\u5b57\u4f53\u7eb9\u7406\u5206\u5272\u6210\u540c\u6837\u5927\u5c0f\u7684\u5143\u7d20\u3002\u6211\u4eec\u4f7f\u7528\u4e86 Monospaced \u98ce\u683c\uff08\u5373\u6240\u6709\u5b57\u7b26\u5177\u6709\u76f8\u540c\u7684\u5bbd\u5ea6\uff09\u7684\u201cConsolas\u201d\u5b57\u4f53\uff0c\u4f46\u5982\u679c\u4f7f\u7528\u975eMonospaced\u7684\u5b57\u4f53\uff0c\u5c31\u4f1a\u770b\u5230\u5b57\u7b26\u4e4b\u95f4\u607c\u4eba\u7684\u7a7a\u767d\u3002 \u6211\u4eec\u9700\u8981\u66f4\u6539\u65b9\u6cd5\uff0c\u5e76\u63d0\u4f9b\u4e00\u79cd\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u6587\u672c\u65b9\u5f0f\u3002\u5982\u679c\u4f60\u4ed4\u7ec6\u60f3\u60f3\uff0c\u6574\u4f53\u60f3\u6cd5\u662f\u53ef\u884c\u7684\uff0c\u4e5f\u5c31\u662f\u901a\u8fc7\u5355\u72ec\u6e32\u67d3\u6bcf\u4e2a\u5b57\u7b26\u7684\u77e9\u5f62\u6765\u6e32\u67d3\u6587\u672c\u3002\u8fd9\u91cc\u7684\u95ee\u9898\u5c31\u662f\u8be5\u5982\u4f55\u751f\u6210\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u7cfb\u7edf\u4e2d\u53ef\u7528\u7684\u5b57\u4f53\u52a8\u6001\u5730\u751f\u6210\u8fd9\u4e9b\u7eb9\u7406\u3002 \u8fd9\u5c31\u9700\u8981 java.awt.Font \u51fa\u624b\u4e86\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u6307\u5b9a\u5b57\u4f53\u7cfb\u5217\u548c\u5927\u5c0f\u52a8\u6001\u5730\u7ed8\u5236\u6bcf\u4e00\u4e2a\u5b57\u7b26\u6765\u751f\u6210\u7eb9\u7406\u3002\u8be5\u7eb9\u7406\u7684\u4f7f\u7528\u65b9\u5f0f\u4e0e\u4e4b\u524d\u63cf\u8ff0\u7684\u76f8\u540c\uff0c\u4f46\u5b83\u5c06\u5b8c\u7f8e\u5730\u89e3\u51b3\u4e0a\u8ff0\u6240\u6709\u95ee\u9898\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FontTexture \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u63a5\u6536 Font \u5b9e\u4f8b\u548c\u5b57\u7b26\u96c6\u540d\u79f0\uff0c\u5e76\u5c06\u52a8\u6001\u5730\u521b\u5efa\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u7eb9\u7406\u3002\u6784\u9020\u51fd\u6570\u5982\u4e0b\u6240\u793a\uff1a public FontTexture(Font font, String charSetName) throws Exception { this.font = font; this.charSetName = charSetName; charMap = new HashMap<>(); buildTexture(); } \u9996\u5148\u8981\u5904\u7406\u975e\u62c9\u4e01\u5b57\u7b26\u95ee\u9898\u3002\u7ed9\u5b9a\u5b57\u7b26\u96c6\u548c\u5b57\u4f53\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u4e00\u4e2a\u5305\u542b\u6240\u6709\u53ef\u6e32\u67d3\u5b57\u7b26\u7684 String \u3002 private String getAllAvailableChars(String charsetName) { CharsetEncoder ce = Charset.forName(charsetName).newEncoder(); StringBuilder result = new StringBuilder(); for (char c = 0; c < Character.MAX_VALUE; c++) { if (ce.canEncode(c)) { result.append(c); } } return result.toString(); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5b9e\u9645\u521b\u5efa\u7eb9\u7406\u7684 buildTexture \u65b9\u6cd5\uff1a private void buildTexture() throws Exception { // \u4f7f\u7528FontMetrics\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u4fe1\u606f BufferedImage img = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB); Graphics2D g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); FontMetrics fontMetrics = g2D.getFontMetrics(); String allChars = getAllAvailableChars(charSetName); this.width = 0; this.height = fontMetrics.getHeight(); for (char c : allChars.toCharArray()) { // \u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5927\u5c0f\uff0c\u5e76\u66f4\u65b0\u56fe\u50cf\u7684\u5927\u5c0f CharInfo charInfo = new CharInfo(width, fontMetrics.charWidth(c)); charMap.put(c, charInfo); width += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u9996\u5148\u901a\u8fc7\u521b\u5efa\u4e34\u65f6\u56fe\u50cf\u6765\u83b7\u5f97 FontMetrics \uff0c\u7136\u540e\u904d\u5386\u5305\u542b\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684 String \uff0c\u5e76\u5728 FontMetrics \u7684\u5e2e\u52a9\u4e0b\u83b7\u53d6\u6bcf\u4e2a\u5b57\u7b26\u7684\u5bbd\u5ea6\u3002\u6211\u4eec\u5c06\u8fd9\u4e9b\u4fe1\u606f\u50a8\u5b58\u5728\u4e00\u4e2a charMap \u6620\u5c04\u4e0a\uff0c\u4ee5\u5b57\u7b26\u4f5c\u4e3a\u6620\u5c04\u7684\u952e\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u5c31\u786e\u5b9a\u4e86\u7eb9\u7406\u56fe\u50cf\u7684\u5927\u5c0f\uff08\u56fe\u50cf\u7684\u9ad8\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u6700\u5927\u9ad8\u5ea6\uff0c\u800c\u5bbd\u5ea6\u7b49\u4e8e\u6240\u6709\u5b57\u7b26\u7684\u5bbd\u5ea6\u603b\u548c\uff09\u3002 ChatSet \u662f\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u50a8\u5b58\u6709\u5173\u5b57\u7b26\u7684\u4fe1\u606f\uff08\u5b83\u7684\u5bbd\u5ea6\u548c\u5b83\u5728\u7eb9\u7406\u56fe\u50cf\u4e2d\u7684\u8d77\u70b9\uff09\u3002 public static class CharInfo { private final int startX; private final int width; public CharInfo(int startX, int width) { this.startX = startX; this.width = width; } public int getStartX() { return startX; } public int getWidth() { return width; } } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u56fe\u50cf\uff0c\u53ea\u9700\u5728 BufferedImage \u4e0a\u7ed8\u5236\u5b57\u7b26\u4e32\u5373\u53ef\u3002 // \u521b\u5efa\u4e0e\u5b57\u7b26\u96c6\u76f8\u5173\u7684\u56fe\u50cf img = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB); g2D = img.createGraphics(); g2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2D.setFont(font); fontMetrics = g2D.getFontMetrics(); g2D.setColor(Color.WHITE); int startX = 0; for (char c : allChars.toCharArray()) { CharInfo charInfo = charMap.get(c); g2D.drawString(\"\" + c, startX, fontMetrics.getAscent()); startX += charInfo.getWidth() + CHAR_PADDING; } g2D.dispose(); \u6211\u4eec\u6b63\u5728\u751f\u6210\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5b57\u7b26\u7684\u5355\u884c\u56fe\u50cf\uff08\u53ef\u80fd\u4e0d\u6ee1\u8db3\u7eb9\u7406\u5927\u5c0f\u5e94\u8be5\u4e3a\u4e8c\u7684\u5e42\u7684\u524d\u63d0\uff0c\u4f46\u662f\u5b83\u4ecd\u9002\u7528\u4e8e\u5927\u591a\u6570\u73b0\u4ee3\u663e\u5361\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u989d\u5916\u7684\u7a7a\u767d\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff09\u3002\u4f60\u4e5f\u53ef\u4ee5\u67e5\u770b\u751f\u6210\u7684\u56fe\u50cf\uff0c\u5728\u4e0a\u8ff0\u4ee3\u7801\u4e4b\u540e\uff0c\u6dfb\u52a0\u4e0b\u8ff0\u7684\u4e00\u884c\u4ee3\u7801\uff1a ImageIO.write(img, IMAGE_FORMAT, new java.io.File(\"Temp.png\")); \u56fe\u50cf\u5c06\u88ab\u5199\u5165\u4e00\u4e2a\u4e34\u65f6\u6587\u4ef6\u3002\u8be5\u6587\u4ef6\u5c06\u5305\u542b\u4e00\u4e2a\u5728\u767d\u8272\u80cc\u666f\u4e0b\uff0c\u4f7f\u7528\u6297\u952f\u9f7f\u7ed8\u5236\u6240\u6709\u53ef\u7528\u5b57\u7b26\u7684\u957f\u6761\u3002 \u6700\u540e\u53ea\u9700\u8981\u4ece\u8be5\u56fe\u50cf\u521b\u5efa\u4e00\u4e2a Texture \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ea\u9700\u4f7f\u7528PNG\u683c\u5f0f\uff08\u8fd9\u5c31\u662f Texture \u7c7b\u6240\u671f\u671b\u7684\uff09\u8f6c\u50a8\u56fe\u50cf\u5b57\u8282\u3002 ByteBuffer buf = null; try ( ByteArrayOutputStream out = new ByteArrayOutputStream()) { ImageIO.write(img, IMAGE_FORMAT, out); out.flush(); byte[] data = out.toByteArray(); buf = ByteBuffer.allocateDirect(data.length); buf.put(data, 0, data.length); buf.flip(); } texture = new Texture(buf); } \u4f60\u53ef\u80fd\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u5df2\u7ecf\u7a0d\u5fae\u4fee\u6539\u4e86 Texture \u7c7b\uff0c\u4f7f\u5176\u5177\u6709\u4e00\u4e2a\u63a5\u6536 ByteBuffer \u7684\u6784\u9020\u51fd\u6570\u3002\u5176\u4e2d\u8fd9\u4e2a\u65b0\u7684\u6784\u9020\u51fd\u6570\u4f7f\u7528 stbi_load_from_memory \u52a0\u8f7d\u56fe\u7247\u3002\u73b0\u5728\u6211\u4eec\u53ea\u9700\u66f4\u6539 TextItem \u7c7b\uff0c\u4ee5\u4fbf\u5728\u5176\u6784\u9020\u51fd\u6570\u4e2d\u63a5\u6536 FontTexture \u5b9e\u4f8b\u3002 public TextItem(String text, FontTexture fontTexture) throws Exception { super(); this.text = text; this.fontTexture = fontTexture; setMesh(buildMesh()); } \u53ea\u9700\u8981\u5728\u8bbe\u7f6e\u7247\u6bb5\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u65f6\u7a0d\u7a0d\u4fee\u6539 buildMesh \u65b9\u6cd5\uff0c\u4e0b\u8ff0\u4ee3\u7801\u662f\u5176\u4e2d\u4e00\u4e2a\u9876\u70b9\u7684\u793a\u4f8b\uff1a float startx = 0; for(int i=0; i<numChars; i++) { FontTexture.CharInfo charInfo = fontTexture.getCharInfo(characters[i]); // \u6784\u9020\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u5b57\u7b26\u7247\u6bb5 // \u5de6\u4e0a\u89d2\u9876\u70b9 positions.add(startx); // x positions.add(0.0f); // y positions.add(ZPOS); // z textCoords.add( (float)charInfo.getStartX() / (float)fontTexture.getWidth()); textCoords.add(0.0f); indices.add(i*VERTICES_PER_QUAD); // \u66f4\u591a\u4ee3\u7801... startx += charInfo.getWidth(); } \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u5176\u4ed6\u66f4\u6539\u3002\u4e0b\u56fe\u662f\u4e00\u4e2a\u5927\u5c0f\u4e3a20\u7684Arial\u5b57\u4f53\u7684\u6e32\u67d3\u6548\u679c\uff1a \u5982\u4f60\u6240\u89c1\u6587\u672c\u6e32\u67d3\u7684\u8d28\u91cf\u5df2\u7ecf\u6709\u4e86\u5f88\u5927\u7684\u63d0\u5347\uff0c\u4f60\u53ef\u4ee5\u7528\u4e0d\u540c\u7684\u5b57\u4f53\u548c\u5927\u5c0f\u6765\u6e32\u67d3\u3002\u8fd9\u4ecd\u7136\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4(\u5982\u652f\u6301\u591a\u884c\u6587\u672c\u3001\u7279\u6548\u7b49)\uff0c\u4f46\u8fd9\u5c06\u7559\u7ed9\u5404\u4f4d\u8bfb\u8005\u4f5c\u4e3a\u7ec3\u4e60\u3002 \u4f60\u53ef\u80fd\u8fd8\u6ce8\u610f\u5230\uff0c\u6211\u4eec\u4ecd\u7136\u80fd\u591f\u7f29\u653e\u6587\u672c\uff08\u901a\u8fc7\u7740\u8272\u5668\u4e2d\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002\u73b0\u5728\u7684\u6587\u672c\u53ef\u80fd\u4e0d\u9700\u8981\u7f29\u653e\uff0c\u4f46\u5bf9\u5176\u4ed6\u7684HUD\u5143\u7d20\u53ef\u80fd\u4f1a\u6709\u7528\u3002 \u6211\u4eec\u5df2\u7ecf\u786e\u7acb\u4e86\u6240\u6709\u7684\u57fa\u672c\u6570\u636e\u7ed3\u6784\uff0c\u4ee5\u4fbf\u4e3a\u6e38\u620f\u521b\u5efa\u4e00\u4e2aHUD\u3002\u73b0\u5728\uff0c\u53ea\u5269\u4e00\u4e2a\u95ee\u9898\uff0c\u90a3\u5c31\u662f\u521b\u5efa\u6240\u6709\u7684\u5143\u7d20\uff0c\u4f20\u9012\u76f8\u5173\u4fe1\u606f\u7ed9\u7528\u6237\uff0c\u5e76\u7ed9\u4ed6\u4eec\u4e00\u4e2a\u4e13\u4e1a\u7684\u5916\u89c2\u3002","title":"\u518d\u8c08\u6587\u672c\u6e32\u67d3"},{"location":"12-game-hud/#osx","text":"\u5982\u679c\u4f60\u8bd5\u56fe\u8fd0\u884c\u672c\u7ae0\u4e2d\u7684\u793a\u4f8b\uff0c\u4ee5\u53ca\u4e0b\u4e00\u4e2a\u6e32\u67d3\u6587\u672c\u7684\u793a\u4f8b\uff0c\u5219\u53ef\u80fd\u4f1a\u53d1\u73b0\u5e94\u7528\u7a0b\u5e8f\u963b\u585e\uff0c\u5c4f\u5e55\u4e0a\u4e0d\u4f1a\u663e\u793a\u4efb\u4f55\u5185\u5bb9\u3002\u8fd9\u662f\u7531\u4e8eAWT\u548cGLFW\u5728OSX\u4e0b\u76f8\u5904\u5f97\u4e0d\u592a\u597d\uff0c\u4f46\u8fd9\u548cAWT\u6709\u4ec0\u4e48\u5173\u7cfb\u5462\uff1f\u6211\u4eec\u4f7f\u7528\u7684\u662f Font \u7c7b\uff0c\u5b83\u5c5e\u4e8eAWT\uff0c\u5982\u679c\u8981\u5b9e\u4f8b\u5316\u5b83\uff0cAWT\u4e5f\u9700\u8981\u521d\u59cb\u5316\u3002\u5728OSX\u4e2d\uff0cAWT\u8bd5\u56fe\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u4f46GLFW\u4e5f\u9700\u8981\u5728\u4e3b\u7ebf\u7a0b\u8fd0\u884c\uff0c\u8fd9\u5c31\u662f\u9020\u6210\u6b64\u95ee\u9898\u7684\u539f\u56e0\u3002 \u4e3a\u4e86\u80fd\u591f\u4f7f\u7528 Font \u7c7b\uff0cGLFW\u5fc5\u987b\u5728AWT\u4e4b\u524d\u521d\u59cb\u5316\uff0c\u5e76\u4e14\u793a\u4f8b\u9700\u8981\u4ee5Headless\u6a21\u5f0f\u8fd0\u884c\u3002\u4f60\u9700\u8981\u5728\u4efb\u4f55\u4e1c\u897f\u88ab\u521d\u59cb\u5316\u4e4b\u524d\u8bbe\u7f6e\u6b64\u5c5e\u6027\uff1a System.setProperty(\"java.awt.headless\", \"true\"); \u4f60\u4e5f\u8bb8\u4f1a\u6536\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u4f46\u793a\u4f8b\u6210\u529f\u8fd0\u884c\u4e86\u3002 \u4e00\u4e2a\u66f4\u7b80\u6d01\u7684\u65b9\u6cd5\u662f\u4f7f\u7528 stb \u5e93\u6765\u6e32\u67d3\u6587\u672c\u3002","title":"OSX"},{"location":"13-sky-box-and-some-optimizations/","text":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316 (Sky Box and some optimizations) \u5929\u7a7a\u76d2 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\u5c06\u7528\u4e8e\u4e3a\u4e09\u7ef4\u4e16\u754c\u8bbe\u7f6e\u80cc\u666f\uff0c\u7ed9\u4eba\u4e00\u79cd\u4e16\u754c\u5e7f\u9614\u7684\u9519\u89c9\u3002\u8fd9\u4e2a\u80cc\u666f\u5c06\u6444\u50cf\u673a\u6240\u5904\u4f4d\u7f6e\u5305\u8d77\u6765\uff0c\u7f69\u4f4f\u6574\u4e2a\u7a7a\u95f4\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u4e2a\u6e32\u67d3\u5728\u4e09\u7ef4\u573a\u666f\u5468\u56f4\u7684\u7acb\u65b9\u4f53\uff0c\u5373\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u5c06\u4f4d\u4e8e\u7acb\u65b9\u4f53\u7684\u4e2d\u5fc3\u3002\u8be5\u7acb\u65b9\u4f53\u7684\u9762\u5c06\u5305\u7740\u4e00\u5c42\u7eb9\u7406\uff0c\u7eb9\u7406\u4e0a\u6709\u5c71\u3001\u84dd\u5929\u548c\u4e91\u5f69\uff0c\u5b83\u5c06\u4ee5\u4e00\u79cd\u56fe\u50cf\u770b\u8d77\u6765\u50cf\u662f\u4e00\u4e2a\u8fde\u7eed\u7684\u98ce\u666f\u7684\u65b9\u5f0f\u8fdb\u884c\u6620\u5c04\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002 \u521b\u5efa\u5929\u7a7a\u76d2\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u51e0\u6b65\uff1a \u521b\u5efa\u4e00\u4e2a\u5927\u7acb\u65b9\u4f53\u3002 \u5bf9\u5b83\u5e94\u7528\u7eb9\u7406\uff0c\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u6e32\u67d3\u7acb\u65b9\u4f53\uff0c\u5b83\u7684\u539f\u70b9\u4f4d\u4e8e\u6444\u50cf\u673a\u6240\u5904\u7684\u4f4d\u7f6e\uff0c\u5b83\u7684\u9762\u8ddd\u79bb\u539f\u70b9\u5f88\u8fdc\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u7eb9\u7406\u5f00\u59cb\u3002\u4f60\u4f1a\u53d1\u73b0\u4e92\u8054\u7f51\u4e0a\u6709\u5f88\u591a\u9884\u5148\u751f\u6210\u7684\u7eb9\u7406\u53ef\u4f9b\u4f7f\u7528\uff0c\u672c\u7ae0\u793a\u4f8b\u4e2d\u4f7f\u7528\u7684\u7eb9\u7406\u4ece\u6b64\u5904\u4e0b\u8f7d\uff1a http://www.custommapmakers.org/skyboxes.php \u3002\u672c\u7ae0\u4e2d\u5177\u4f53\u4f7f\u7528\u7684\u7eb9\u7406\u662f\uff1a http://www.custommapmakers.org/skyboxes/zips/ely_hills.zip \uff0c\u4f5c\u8005\u662fColin Lowndes\u3002 \u8be5\u7f51\u7ad9\u7684\u7eb9\u7406\u90fd\u662f\u7531\u5355\u72ec\u7684TGA\u6587\u4ef6\u7ec4\u6210\uff0c\u6bcf\u4e2a\u6587\u4ef6\u90fd\u662f\u7acb\u65b9\u4f53\u7684\u4e00\u9762\u3002\u6211\u4eec\u7684\u7eb9\u7406\u52a0\u8f7d\u5668\u5e0c\u671b\u6587\u4ef6\u683c\u5f0f\u4e3aPNG\uff0c\u6240\u4ee5\u9700\u8981\u5c06\u6bcf\u4e00\u9762\u7684\u56fe\u50cf\u7ec4\u5408\u6210\u4e00\u4e2aPNG\u56fe\u50cf\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5176\u4ed6\u65b9\u6cd5\uff0c\u4f8b\u5982\u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff0c\u4f7f\u5176\u81ea\u52a8\u5e94\u7528\u7eb9\u7406\u3002\u4f46\u4e3a\u4e86\u4f7f\u672c\u7ae0\u5c3d\u53ef\u80fd\u7b80\u6d01\u6613\u61c2\uff0c\u4f60\u5fc5\u987b\u624b\u52a8\u628a\u5b83\u4eec\u6392\u5217\u4e3a\u4e00\u5f20\u56fe\u7247\uff0c\u6700\u7ec8\u56fe\u50cf\u5982\u4e0b\u6240\u793a\uff1a \u63a5\u4e0b\u6765\u9700\u8981\u521b\u5efa\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u542b\u6709\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6b63\u786e\u5730\u8bbe\u7f6e\u6bcf\u4e00\u9762\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u7eb9\u7406\u4e0e\u7acb\u65b9\u4f53\u5404\u9762\u7684\u5173\u7cfb\uff08\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u672c\u7ae0\u4f7f\u7528\u7684OBJ\u6587\u4ef6\uff09\uff1a \u5f53\u76f8\u5173\u8d44\u6e90\u51c6\u5907\u5c31\u7eea\uff0c\u5c31\u53ef\u4ee5\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\u4e86\u3002\u9996\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SkyBox \u7684\u65b0\u7c7b\uff0c\u5b83\u7684\u6784\u9020\u51fd\u6570\u63a5\u6536OBJ\u6a21\u578b\u8def\u5f84\u548c\u5929\u7a7a\u76d2\u7eb9\u7406\u6587\u4ef6\u8def\u5f84\u3002\u5982\u540c\u6b64\u524d\u4e00\u7ae0\u7684HUD\uff0c\u8fd9\u4e2a\u7c7b\u4e5f\u7ee7\u627f GameItem \u7c7b\u3002\u4e3a\u4ec0\u4e48\u5b83\u8981\u7ee7\u627f GameItem \u7c7b\uff1f\u9996\u5148\uff0c\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u91cd\u7528\u5927\u90e8\u5206\u5904\u7406\u7f51\u683c\u548c\u7eb9\u7406\u7684\u4ee3\u7801\uff1b\u7b2c\u4e8c\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u4e0d\u4f1a\u79fb\u52a8\uff0c\u6211\u4eec\u53ea\u60f3\u5e94\u7528\u65cb\u8f6c\u548c\u7f29\u653e\u3002\u8fd9\u6837\u60f3\u60f3 SkyBox \u786e\u5b9e\u662f\u4e00\u4e2a GameItem \u3002 SkyBox \u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.OBJLoader; import org.lwjglb.engine.graph.Texture; public class SkyBox extends GameItem { public SkyBox(String objModel, String textureFile) throws Exception { super(); Mesh skyBoxMesh = OBJLoader.loadMesh(objModel); Texture skyBoxtexture = new Texture(textureFile); skyBoxMesh.setMaterial(new Material(skyBoxtexture, 0.0f)); setMesh(skyBoxMesh); setPosition(0, 0, 0); } } \u5982\u679c\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u53d1\u73b0\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Scene \u7684\u7c7b\uff0c\u5b83\u5c06\u6574\u7406\u4e0e\u4e09\u7ef4\u4e16\u754c\u76f8\u5173\u7684\u6240\u6709\u6570\u636e\u3002 Scene \u7c7b\u7684\u5b9a\u4e49\u548c\u5c5e\u6027\u5982\u4e0b\u6240\u793a\uff0c\u5176\u4e2d\u5305\u542b SkyBox \u7c7b\u7684\u5b9e\u4f8b\uff1a package org.lwjglb.engine; public class Scene { private GameItem[] gameItems; private SkyBox skyBox; private SceneLight sceneLight; public GameItem[] getGameItems() { return gameItems; } // \u66f4\u591a\u4ee3\u7801... \u63a5\u4e0b\u6765\u662f\u4e3a\u5929\u7a7a\u76d2\u521b\u5efa\u53e6\u4e00\u7ec4\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\uff0c\u4f46\u4e3a\u4ec0\u4e48\u4e0d\u91cd\u7528\u5df2\u6709\u7684\u573a\u666f\u7740\u8272\u5668\u5462\uff1f\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u6240\u9700\u7684\u7740\u8272\u5668\u662f\u539f\u6709\u7740\u8272\u5668\u7684\u7b80\u5316\u7248\uff0c\u4e0d\u9700\u8981\u8ba9\u5149\u7167\u5f71\u54cd\u5929\u7a7a\u76d2\uff08\u66f4\u51c6\u786e\u7684\u8bf4\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u70b9\u5149\u6e90\uff0c\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\uff09\u3002\u5929\u7a7a\u76d2\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4ecd\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u7f29\u653e\u5929\u7a7a\u76d2\uff0c\u6240\u4ee5\u9700\u8981\u53d8\u6362\u77e9\u9635\u3002\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5230\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\uff0c\u5728\u521d\u59cb\u5316\u65f6\u5c31\u653e\u5927\u4e86\u7acb\u65b9\u4f53\u6a21\u578b\u7684\u5927\u5c0f\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\u3002\u4f46\u6211\u4eec\u9009\u62e9\u524d\u4e00\u79cd\u65b9\u6cd5\uff0c\u56e0\u4e3a\u5b83\u66f4\u7075\u6d3b\uff0c\u5b83\u5141\u8bb8\u5728\u8fd0\u884c\u65f6\u6539\u53d8\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u3002\u4f46\u5982\u679c\u4f60\u60f3\uff0c\u4f60\u5c31\u53ef\u4ee5\u8f7b\u677e\u6539\u6362\u5230\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u975e\u5e38\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 ambientLight; void main() { fragColor = vec4(ambientLight, 1) * texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u7740\u8272\u5668\u6dfb\u52a0\u4e86\u4e00\u4e2a\u73af\u5883\u5149\uff0c\u8be5Uniform\u7684\u76ee\u7684\u662f\u4fee\u6539\u5929\u7a7a\u76d2\u7684\u989c\u8272\u4ee5\u6a21\u62df\u663c\u591c\uff08\u5982\u679c\u4e0d\u8fd9\u6837\u505a\uff0c\u5728\u4e16\u754c\u7684\u5176\u4ed6\u5730\u65b9\u90fd\u662f\u9ed1\u6697\u7684\u65f6\u5019\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u5c31\u50cf\u662f\u5728\u4e2d\u5348\uff09\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u521a\u521a\u6dfb\u52a0\u4e86\u65b0\u7684\u65b9\u6cd5\u6765\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u5e76\u8bbe\u7f6eUniform\uff08\u8fd9\u4e0d\u662f\u4ec0\u4e48\u65b0\u7684\u6982\u5ff5\uff09\u3002 private void setupSkyBoxShader() throws Exception { skyBoxShaderProgram = new ShaderProgram(); skyBoxShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/sb_vertex.vs\")); skyBoxShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/sb_fragment.fs\")); skyBoxShaderProgram.link(); skyBoxShaderProgram.createUniform(\"projectionMatrix\"); skyBoxShaderProgram.createUniform(\"modelViewMatrix\"); skyBoxShaderProgram.createUniform(\"texture_sampler\"); skyBoxShaderProgram.createUniform(\"ambientLight\"); } \u5f53\u7136\uff0c\u6211\u4eec\u9700\u8981\u5728\u5168\u5c40\u6e32\u67d3\u4e2d\u4e3a\u6e32\u67d3\u5929\u7a7a\u76d2\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u6e32\u67d3\u65b9\u6cd5\u3002 private void renderSkyBox(Window window, Camera camera, Scene scene) { skyBoxShaderProgram.bind(); skyBoxShaderProgram.setUniform(\"texture_sampler\", 0); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); skyBoxShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); SkyBox skyBox = scene.getSkyBox(); Matrix4f viewMatrix = transformation.getViewMatrix(camera); viewMatrix.m30(0); viewMatrix.m31(0); viewMatrix.m32(0); Matrix4f modelViewMatrix = transformation.getModelViewMatrix(skyBox, viewMatrix); skyBoxShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); skyBoxShaderProgram.setUniform(\"ambientLight\", scene.getSceneLight().getAmbientLight()); scene.getSkyBox().getMesh().render(); skyBoxShaderProgram.unbind(); } \u4e0a\u8ff0\u65b9\u6cd5\u4e0e\u5176\u4ed6\u6e32\u67d3\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u4e00\u4e2a\u4e0d\u540c\u4e4b\u5904\u9700\u8981\u89e3\u91ca\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u50cf\u5e73\u5e38\u4e00\u6837\u4f20\u9012\u6295\u5f71\u77e9\u9635\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u4f46\u5f53\u53d6\u5f97\u89c2\u5bdf\u77e9\u9635\u65f6\uff0c\u6211\u4eec\u5c06\u5176\u4e00\u4e9b\u6570\u503c\u8bbe\u7f6e\u4e3a0\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u5176\u4e2d\u7684\u539f\u56e0\u662f\u6211\u4eec\u4e0d\u5e0c\u671b\u5929\u7a7a\u76d2\u88ab\u79fb\u52a8\u3002 \u8bf7\u8bb0\u4f4f\uff0c\u5f53\u6211\u4eec\u5728\u79fb\u52a8\u6444\u50cf\u673a\u65f6\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58\uff0c\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u5929\u7a7a\u76d2\u4e5f\u5c06\u79fb\u52a8\u3002\u4f46\u662f\u6211\u4eec\u4e0d\u60f3\u8fd9\u6837\uff0c\u6211\u4eec\u60f3\u628a\u5b83\u56fa\u5b9a\u5728\u5750\u6807\u539f\u70b9(0, 0, 0)\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u79fb\u589e\u91cf\u90e8\u5206\uff08 m30 , m31 \u548c m32 \uff09\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u8ba4\u4e3a\u53ef\u4ee5\u907f\u514d\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u5fc5\u987b\u56fa\u5b9a\u5728\u539f\u70b9\u3002\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u5929\u7a7a\u76d2\u4e0d\u4f1a\u968f\u7740\u6444\u50cf\u673a\u65cb\u8f6c\uff0c\u8fd9\u4e0d\u662f\u6211\u4eec\u60f3\u8981\u7684\u3002\u56e0\u6b64\u6211\u4eec\u9700\u8981\u65cb\u8f6c\u5b83\u4f46\u4e0d\u8981\u79fb\u52a8\u5b83\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\uff0c\u4f60\u53ef\u4ee5\u67e5\u9605\u672c\u7ae0\u6e90\u4ee3\u7801\uff0c\u672c\u4f8b\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e86\u66f4\u591a\u7684\u65b9\u5757\u5b9e\u4f8b\u6765\u6a21\u62df\u5730\u9762\u548c\u5929\u7a7a\u76d2\u3002\u4f60\u4e5f\u53ef\u4ee5\u6539\u53d8\u73af\u5883\u5149\u6765\u6a21\u62df\u5149\u7167\u548c\u663c\u591c\u4ea4\u66ff\u3002\u6700\u7ec8\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u6548\u679c\uff1a \u5929\u7a7a\u76d2\u662f\u4e00\u4e2a\u5c0f\u7acb\u65b9\u4f53\uff08\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u5b83\u5e94\u8be5\u5927\u5f97\u591a\uff09\uff0c\u6240\u4ee5\u4f60\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u65f6\uff0c\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u770b\u5230\u5176\u6548\u679c\u3002\u4f60\u8fd8\u53ef\u4ee5\u770b\u5230\uff0c\u6784\u6210\u5730\u9762\u7684\u65b9\u5757\u6bd4\u5929\u7a7a\u76d2\u5927\uff0c\u6240\u4ee5\u5f53\u4f60\u79fb\u52a8\u65f6\uff0c\u4f60\u4f1a\u770b\u5230\u4ece\u5c71\u4e2d\u5192\u51fa\u7684\u65b9\u5757\u3002\u8fd9\u5f88\u660e\u663e\uff0c\u56e0\u4e3a\u6211\u4eec\u8bbe\u7f6e\u7684\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u3002\u4f46\u65e0\u8bba\u5982\u4f55\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u9690\u85cf\u548c\u6a21\u7cca\u8fdc\u5904\u7684\u7269\u4f53\u7684\u6548\u679c\uff08\u4f8b\u5982\u4f7f\u7528\u96fe\u6548\u679c\uff09\u6765\u51cf\u8f7b\u8fd9\u79cd\u5f71\u54cd\u3002 \u4e0d\u521b\u5efa\u66f4\u5927\u7684\u5929\u7a7a\u76d2\u7684\u53e6\u4e00\u4e2a\u539f\u56e0\u662f\u6211\u4eec\u9700\u8981\u51e0\u4e2a\u4f18\u5316\u6765\u63d0\u5347\u6548\u7387\uff08\u7a0d\u540e\u5bf9\u6b64\u8fdb\u884c\u89e3\u91ca\uff09\u3002 \u53ef\u4ee5\u6ce8\u91ca\u6e32\u67d3\u65b9\u6cd5\u4e2d\u9632\u6b62\u5929\u7a7a\u76d2\u79fb\u52a8\u7684\u4ee3\u7801\uff0c\u7136\u540e\u4f60\u5c31\u53ef\u4ee5\u5728\u5929\u7a7a\u76d2\u5916\u770b\u5230\u5982\u4e0b\u6240\u793a\u56fe\u50cf\uff1a \u867d\u7136\u8fd9\u4e0d\u662f\u5929\u7a7a\u76d2\u8be5\u505a\u7684\uff0c\u4f46\u8fd9\u53ef\u4ee5\u5e2e\u52a9\u4f60\u7406\u89e3\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u5176\u4ed6\u6548\u679c\u6765\u6539\u5584\u5b83\uff0c\u6bd4\u5982\u592a\u9633\u5728\u5929\u7a79\u79fb\u52a8\u6216\u4e91\u5c42\u79fb\u52a8\u3002\u6b64\u5916\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u4e16\u754c\uff0c\u4f60\u9700\u8981\u5c06\u4e16\u754c\u5206\u5272\u6210\u533a\u57df\uff0c\u53ea\u52a0\u8f7d\u90a3\u4e9b\u4e0e\u73a9\u5bb6\u6240\u5904\u7684\u533a\u57df\u76f8\u90bb\u7684\u533a\u57df\u3002 \u53e6\u5916\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff1a\u4ec0\u4e48\u65f6\u5019\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u8fd8\u662f\u4e4b\u540e\uff1f\u5728\u6e32\u67d3\u573a\u666f\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\u66f4\u4f18\uff0c\u56e0\u4e3a\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5927\u591a\u6570\u7247\u5143\u5c06\u88ab\u4e22\u5f03\u3002\u5f53OpenGL\u5c1d\u8bd5\u6e32\u67d3\u5b83\u4eec\uff0c\u5e76\u4e14\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u65f6\uff0c\u5c06\u4e22\u5f03\u4e00\u4e9b\u4f4d\u4e8e\u5148\u524d\u6e32\u67d3\u7684\u7247\u5143\u4e4b\u540e\u7684\u7247\u5143\uff0c\u8fd9\u4e9b\u7247\u5143\u7684\u6df1\u5ea6\u503c\u66f4\u4f4e\u3002\u6240\u4ee5\u7b54\u6848\u5f88\u660e\u663e\uff0c\u5bf9\u5427\uff1f\u6e32\u67d3\u573a\u666f\u540e\uff0c\u518d\u6e32\u67d3\u5929\u7a7a\u76d2\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5728\u5904\u7406\u900f\u660e\u7eb9\u7406\u65f6\uff0c\u5982\u679c\u5728\u573a\u666f\u4e2d\u6211\u4eec\u6709\u5e94\u7528\u900f\u660e\u7eb9\u7406\u7684\u7269\u4f53\uff0c\u5b83\u4eec\u5c06\u4f7f\u7528\u201c\u80cc\u666f\u201d\u8272\u7ed8\u5236\uff0c\u672c\u4f8b\u4e2d\u662f\u9ed1\u8272\u3002\u4f46\u5982\u679c\u6211\u4eec\u5148\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u90a3\u4e48\u5c06\u4f1a\u6b63\u786e\u5730\u5e94\u7528\u900f\u660e\u6548\u679c\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5e94\u8be5\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\u5417\uff1f\u5173\u952e\u5728\u4e8e\u4f60\u7684\u9009\u62e9\u3002\u5982\u679c\u4f60\u5728\u6e32\u67d3\u573a\u666f\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u53ef\u4ee5\u89e3\u51b3\u900f\u660e\u7eb9\u7406\u95ee\u9898\uff0c\u4f46\u662f\u4f1a\u5f71\u54cd\u6027\u80fd\u3002\u5b9e\u9645\u4e0a\uff0c\u5c31\u7b97\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f60\u4e5f\u53ef\u80fd\u9762\u4e34\u900f\u660e\u95ee\u9898\u3002\u5047\u8bbe\u4f60\u6709\u4e00\u4e2a\u900f\u660e\u7684\u7269\u4f53\uff0c\u5b83\u4e0e\u8fdc\u5904\u7684\u7269\u4f53\u91cd\u53e0\uff0c\u5982\u679c\u9996\u5148\u6e32\u67d3\u900f\u660e\u5bf9\u8c61\uff0c\u90a3\u4e48\u4e5f\u4f1a\u51fa\u73b0\u900f\u660e\u95ee\u9898\u3002\u56e0\u6b64\uff0c\u4e5f\u8bb8\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u5728\u6240\u6709\u5176\u4ed6\u9879\u88ab\u6e32\u67d3\u540e\uff0c\u5355\u72ec\u7ed8\u5236\u900f\u660e\u7684\u9879\u3002\u8fd9\u662f\u4e00\u4e9b\u5546\u4e1a\u6e38\u620f\u4f7f\u7528\u7684\u65b9\u6cd5\u3002\u4e0d\u8fc7\u73b0\u5728\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u4ee5\u83b7\u5f97\u66f4\u9ad8\u7684\u6027\u80fd\u3002 \u4e00\u4e9b\u4f18\u5316 \u4ece\u4e0a\u8ff0\u793a\u4f8b\u6765\u770b\uff0c\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u4f7f\u5f97\u5176\u6548\u679c\u6709\u70b9\u5947\u602a\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u7269\u4f53\u795e\u5947\u5730\u4ece\u5c71\u4f53\u51fa\u73b0\uff09\u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u589e\u52a0\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u548c\u4e16\u754c\u7684\u5927\u5c0f\uff0c\u5c06\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u653e\u592750\u500d\uff0c\u8fd9\u6837\u4e16\u754c\u753140,000\u4e2a\u6e38\u620f\u9879\u5b9e\u4f8b\uff08\u65b9\u5757\uff09\u7ec4\u6210\u3002 \u5982\u679c\u4f60\u66f4\u6539\u7f29\u653e\u5e76\u91cd\u65b0\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u53d1\u73b0\u5f00\u59cb\u51fa\u73b0\u6027\u80fd\u95ee\u9898\uff0c\u5e76\u4e14\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u4e0d\u987a\u7545\u3002\u73b0\u5728\u662f\u65f6\u5019\u5173\u6ce8\u4e00\u4e0b\u6027\u80fd\u4e86\uff08\u4f60\u53ef\u80fd\u542c\u8fc7\u4e00\u53e5\u8001\u8bdd\uff1a\u201c\u8fc7\u65e9\u7684\u4f18\u5316\u662f\u4e07\u6076\u4e4b\u6e90\u201d\uff0c\u4f46\u662f\u4ece\u672c\u7ae0\u5f00\u59cb\uff0c\u6211\u5e0c\u671b\u6ca1\u6709\u4eba\u4f1a\u8bf4\u8fd9\u662f\u8fc7\u65e9\u7684\uff09\u3002 \u8ba9\u6211\u6765\u4ecb\u7ecd\u4e00\u4e2a\u6982\u5ff5\uff0c\u5b83\u80fd\u51cf\u5c11\u6b63\u5728\u6e32\u67d3\u7684\u6570\u636e\u6570\u91cf\uff0c\u5b83\u53eb\u505a\u9762\u5254\u9664\uff08Face Culling\uff09\u3002\u5728\u793a\u4f8b\u4e2d\uff0c\u6211\u4eec\u6e32\u67d3\u4e86\u6210\u5343\u4e0a\u4e07\u4e2a\u7acb\u65b9\u4f53\uff0c\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u7ec4\u6210\u7684\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u6bcf\u4e2a\u7acb\u65b9\u4f53\u7684\u516d\u4e2a\u9762\uff0c\u5373\u4f7f\u5b83\u4eec\u6709\u4e9b\u662f\u770b\u4e0d\u5230\u7684\u3002\u8fdb\u5165\u4e00\u4e2a\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4f60\u4f1a\u770b\u5230\u5b83\u7684\u5185\u90e8\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4e0d\u80fd\u88ab\u770b\u5230\u7684\u9762\u5e94\u8be5\u7acb\u5373\u820d\u5f03\uff0c\u8fd9\u5c31\u662f\u9762\u5254\u9664\u7684\u4f5c\u7528\u3002\u5b9e\u9645\u4e0a\uff0c\u5bf9\u4e8e\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u4f60\u6700\u591a\u53ea\u80fd\u540c\u65f6\u770b\u5230\u4e09\u4e2a\u9762\uff0c\u6240\u4ee5\u53ea\u80fd\u901a\u8fc7\u4f7f\u7528\u9762\u5254\u9664\uff08\u5982\u679c\u4f60\u7684\u6e38\u620f\u4e0d\u8981\u6c42\u4f60\u8fdb\u5165\u6a21\u578b\u7684\u5185\u90e8\uff0c\u8fd9\u6837\u505a\u624d\u662f\u9ad8\u6548\u7684\uff0c\u7a0d\u540e\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\uff09\u6765\u820d\u5f03\u4e00\u534a\u7684\u9762\uff0840,000\u00d73\u00d72\u4e2a\u4e09\u89d2\u5f62\uff09\u3002 \u9762\u5254\u9664\u68c0\u67e5\u6bcf\u4e2a\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e22\u5f03\u90a3\u4e9b\u4e0d\u9762\u5411\u6444\u50cf\u673a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u662f\uff0c\u5982\u4f55\u77e5\u9053\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\u5462\uff1f\u597d\u5427\uff0cOpenGL\u5b9e\u73b0\u5b83\u7684\u65b9\u5f0f\u662f\u901a\u8fc7\u68c0\u67e5\u7ec4\u6210\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002 \u8bb0\u5f97\u4ece\u7b2c\u4e00\u7ae0\u5f00\u59cb\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u4ee5\u987a\u65f6\u9488\u6216\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u3002\u5728OpenGL\u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u6444\u50cf\u673a\uff0c\u800c\u4ee5\u987a\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u76f8\u53cd\u7684\u65b9\u5411\u3002\u5173\u952e\u662f\u5728\u8003\u8651\u6444\u50cf\u673a\u7684\u60c5\u51b5\u4e0b\uff0c\u68c0\u67e5\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002\u56e0\u6b64\uff0c\u6309\u7167\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u4e09\u89d2\u5f62\u53ef\u4ee5\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u5b9e\u73b0\u5b83\uff0c\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e0b\u8ff0\u4ee3\u7801\uff1a glEnable(GL_CULL_FACE); glCullFace(GL_BACK); \u7b2c\u4e00\u884c\u4ee3\u7801\u5c06\u542f\u7528\u9762\u5254\u9664\uff0c\u7b2c\u4e8c\u884c\u4ee3\u7801\u8bbe\u7f6e\u80cc\u5411\u9762\u4e3a\u9700\u8981\u5254\u9664\u7684\u9762\u3002\u5982\u679c\u5411\u4e0a\u770b\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u60c5\u666f\uff1a \u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u5982\u679c\u4f60\u67e5\u770b\u9876\u9762\u7684\u9876\u70b9\u987a\u5e8f\uff0c\u5c06\u770b\u5230\u5b83\u662f\u6309\u9006\u65f6\u9488\u5b9a\u4e49\u7684\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u73af\u7ed5\u987a\u5e8f\u662f\u4ee5\u6444\u50cf\u673a\u4e3a\u89c6\u89d2\u3002\u5b9e\u9645\u4e0a\uff0c\u5982\u679c\u4f60\u8ba9\u4f4d\u79fb\u5f71\u54cd\u5929\u7a7a\u76d2\u4ee5\u4fbf\u80fd\u4ece\u5176\u4e0a\u65b9\u89c2\u5bdf\u5b83\u65f6\uff0c\u5219\u5f53\u4f60\u5728\u5929\u7a7a\u76d2\u5916\u65f6\uff0c\u5c06\u770b\u5230\u9876\u9762\u518d\u6b21\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u63cf\u8ff0\u4e00\u4e0b\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5929\u7a7a\u76d2\u7acb\u65b9\u4f53\u7684\u9876\u9762\u4e09\u89d2\u5f62\u4e2d\u7684\u4e00\u4e2a\u4e09\u89d2\u5f62\uff0c\u5b83\u7531\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u7684\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\uff1a \u4f46\u8981\u8bb0\u4f4f\uff0c\u6211\u4eec\u662f\u5728\u5929\u7a7a\u76d2\u91cc\uff0c\u5982\u679c\u4ece\u5185\u90e8\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u4f1a\u770b\u5230\u9876\u70b9\u662f\u6309\u987a\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u3002 \u8fd9\u662f\u56e0\u4e3a\u5929\u7a7a\u76d2\u88ab\u5b9a\u4e49\u4e3a\u4ece\u5916\u90e8\u89c2\u5bdf\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u7ffb\u8f6c\u4e00\u4e9b\u9762\u7684\u5b9a\u4e49\uff0c\u4ee5\u4fbf\u5728\u542f\u7528\u9762\u5254\u9664\u65f6\u80fd\u6b63\u786e\u5730\u6e32\u67d3\u5b83\u3002 \u4f46\u8fd9\u4ecd\u6709\u66f4\u5927\u7684\u4f18\u5316\u7a7a\u95f4\u3002\u56de\u987e\u4e00\u4e0b\u6e32\u67d3\u6d41\u7a0b\uff0c\u5728 Renderer \u7c7b render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u904d\u5386 GameItem \u6570\u7ec4\u5e76\u6e32\u67d3\u76f8\u5173\u7684 Mesh \u3002\u5bf9\u6bcf\u4e2a GameItem \uff0c\u6211\u4eec\u505a\u4e86\u4e0b\u8ff0\u5de5\u4f5c\uff1a \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u7684\u552f\u4e00\u503c\uff09\u3002 \u83b7\u53d6 GameItem \u50a8\u5b58\u7684 Mesh \u5e76\u7ed1\u5b9a\u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u6267\u884c\u8c03\u7528\u4ee5\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u505c\u7528\u7eb9\u7406\u548cVAO\u3002 \u4f46\u5728\u73b0\u5728\u7684\u6e38\u620f\u4e2d\uff0c40,000\u4e2a GameItem \u90fd\u4f7f\u7528\u76f8\u540c\u7684 Mesh \uff0c\u800c\u6211\u4eec\u4e00\u6b21\u53c8\u4e00\u6b21\u5730\u91cd\u590d\u7b2c\u4e8c\u9879\u5230\u7b2c\u56db\u9879\u7684\u64cd\u4f5c\u3002\u8fd9\u4e0d\u662f\u5f88\u9ad8\u6548\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u5bf9OpenGL\u51fd\u6570\u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u662f\u6709\u6027\u80fd\u5f00\u9500\u7684\u672c\u5730\u8c03\u7528\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5e94\u8be5\u5c3d\u91cf\u9650\u5236OpenGL\u4e2d\u7684\u72b6\u6001\u53d8\u5316\uff08\u7ed1\u5b9a\u548c\u505c\u7528\u7eb9\u7406\u3001VAO\u90fd\u662f\u72b6\u6001\u53d8\u5316\uff09\u3002 \u6211\u4eec\u9700\u8981\u6539\u53d8\u5f00\u53d1\u7684\u65b9\u5f0f\uff0c\u56f4\u7ed5\u7f51\u683c\u7ec4\u7ec7\u4ee3\u7801\u7ed3\u6784\uff0c\u56e0\u4e3a\u7ecf\u5e38\u6709\u8bb8\u591a\u6e38\u620f\u9879\u4f7f\u7528\u76f8\u540c\u7684\u7f51\u683c\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e00\u4e2a\u6e38\u620f\u9879\u6570\u7ec4\uff0c\u6bcf\u9879\u90fd\u6307\u5411\u540c\u4e00\u4e2a\u7f51\u683c\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4f5c\u4e3a\u66ff\u4ee3\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5176\u4e2d\u5305\u62ec\u50a8\u5b58\u5171\u4eab\u8be5\u7f51\u683c\u7684\u6240\u6709\u6e38\u620f\u9879\u3002 \u5bf9\u4e8e\u6bcf\u4e00\u4e2a Mesh \uff0c\u6e32\u67d3\u6b65\u9aa4\u5c06\u4f1a\u662f\uff1a \u83b7\u53d6\u4e0e GameItem \u76f8\u5173\u8054\u7684 Mesh \u5e76\u7ed1\u5b9a Mesh \u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u76f8\u5173\u7684 GameItem \uff1a a. \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u552f\u4e00\u7684\uff09\u3002 b. \u8c03\u7528\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u89e3\u7ed1\u7eb9\u7406\u548cVAO\u3002 \u5728 Scene \u7c7b\u4e2d\u50a8\u5b58\u4e0b\u8ff0 Map \uff1a private Map<Mesh, List<GameItem>> meshMap; \u6211\u4eec\u4ecd\u6709 setGameItems \u65b9\u6cd5\uff0c\u4f46\u6211\u4eec\u4e0d\u53ea\u662f\u50a8\u5b58\u6570\u7ec4\uff0c\u800c\u662f\u6784\u9020\u7f51\u683c\u6620\u5c04\u8868\u3002 public void setGameItems(GameItem[] gameItems) { int numGameItems = gameItems != null ? gameItems.length : 0; for (int i=0; i<numGameItems; i++) { GameItem gameItem = gameItems[i]; Mesh mesh = gameItem.getMesh(); List<GameItem> list = meshMap.get(mesh); if ( list == null ) { list = new ArrayList<>(); meshMap.put(mesh, list); } list.add(gameItem); } } Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u6e32\u67d3\u4e0e\u5176\u76f8\u5173\u7684 GameItem \u5217\u8868\uff0c\u7136\u540e\u5c06\u7ed1\u5b9a\u548c\u89e3\u7ed1\u4ee3\u7801\u5206\u4e3a\u4e0d\u540c\u7684\u65b9\u6cd5\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } private void endRender() { // \u6062\u590d\u72b6\u6001 glDisableVertexAttribArray(0); glDisableVertexAttribArray(1); glDisableVertexAttribArray(2); glBindVertexArray(0); glBindTexture(GL_TEXTURE_2D, 0); } public void render() { initRender(); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); endRender(); } public void renderList(List<GameItem> gameItems, Consumer<GameItem> consumer) { initRender(); for (GameItem gameItem : gameItems) { // \u8bbe\u7f6e\u6e38\u620f\u9879\u76ee\u6240\u9700\u7684\u6e32\u67d3\u6570\u636e consumer.accept(gameItem); // \u6e32\u67d3\u6e38\u620f\u9879\u76ee glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); } endRender(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4ecd\u7136\u4fdd\u7559\u4e86\u65e7\u65b9\u6cd5\uff0c\u5b83\u8fd4\u56de\u4e00\u4e2a Mesh \uff0c\u8fd9\u662f\u8003\u8651\u5230\u5982\u679c\u53ea\u6709\u4e00\u4e2a GameItem \u7684\u60c5\u51b5\uff08\u8fd9\u53ef\u80fd\u5728\u5176\u4ed6\u60c5\u51b5\u4e0b\u4f7f\u7528\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0d\u79fb\u9664\u5b83\uff09\u3002\u65b0\u7684\u65b9\u6cd5\u6e32\u67d3\u4e00\u4e2a List<GameItem> \uff0c\u5e76\u63a5\u53d7\u4e00\u4e2a Counsumer \u7c7b\u578b\u7684\u53c2\u6570\uff08\u4e00\u4e2a\u51fd\u6570\uff0c\u4f7f\u7528\u4e86Java8\u5f15\u5165\u7684\u51fd\u6570\u5f0f\u7f16\u7a0b\uff09\uff0c\u5b83\u5c06\u7528\u4e8e\u5728\u7ed8\u5236\u4e09\u89d2\u5f62\u4e4b\u524d\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u7279\u5b9a\u7684\u5185\u5bb9\uff0c\u56e0\u4e3a\u4e0d\u5e0c\u671b Mesh \u7c7b\u4e0eUniform\u7684\u540d\u79f0\u548c\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u65f6\u6240\u6d89\u53ca\u7684\u53c2\u6570\u76f8\u8026\u5408\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u6765\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u4e2d\u7684 renderScene \u65b9\u6cd5\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u9700\u904d\u5386\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5e76\u901a\u8fc7Lambda\u8868\u8fbe\u5f0f\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002 for (Mesh mesh : mapMeshes.keySet()) { sceneShaderProgram.setUniform(\"material\", mesh.getMaterial()); mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); sceneShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u53ef\u4ee5\u505a\u7684\u53e6\u4e00\u9879\u4f18\u5316\u662f\uff0c\u6211\u4eec\u5728\u6e32\u67d3\u5468\u671f\u4e2d\u521b\u5efa\u4e86\u5927\u91cf\u5bf9\u8c61\u3002\u7279\u522b\u662f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u592a\u591a\u7684 Matrix4f \u5b9e\u4f8b\uff0c\u5b83\u4eec\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u4fdd\u5b58\u4e86\u4e00\u4e2a\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002\u6211\u4eec\u5e94\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u7279\u5b9a\u7684\u77e9\u9635\uff0c\u5e76\u91cd\u7528\u76f8\u540c\u7684\u5b9e\u4f8b\u3002\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f1a\u770b\u5230\u6211\u4eec\u5df2\u7ecf\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u540d\u79f0\uff0c getXX \u65b9\u6cd5\u53ea\u8fd4\u56de\u50a8\u5b58\u7684\u77e9\u9635\u5b9e\u4f8b\uff0c\u5e76\u4e14\u4efb\u4f55\u66f4\u6539\u77e9\u9635\u503c\u7684\u65b9\u6cd5\u90fd\u79f0\u4e3a buildXX \uff0c\u4ee5\u9610\u660e\u5176\u7528\u9014\u3002 \u6211\u4eec\u4e5f\u907f\u514d\u4e86\u6bcf\u6b21\u4e3a\u77e9\u9635\u8bbe\u7f6eUniform\u65f6\u6784\u9020\u65b0\u7684 FloatBuffer \u5b9e\u4f8b\uff0c\u5e76\u79fb\u9664\u4e86\u5176\u4ed6\u4e00\u4e9b\u65e0\u7528\u7684\u5b9e\u4f8b\u5316\u64cd\u4f5c\u3002\u6709\u4e86\u8fd9\u4e9b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u66f4\u6d41\u7545\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u4e86\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6240\u6709\u7ec6\u8282\u3002","title":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316"},{"location":"13-sky-box-and-some-optimizations/#sky-box-and-some-optimizations","text":"","title":"\u5929\u7a7a\u76d2\u4e0e\u4e00\u4e9b\u4f18\u5316 (Sky Box and some optimizations)"},{"location":"13-sky-box-and-some-optimizations/#_1","text":"\u5929\u7a7a\u76d2\uff08Sky Box\uff09\u5c06\u7528\u4e8e\u4e3a\u4e09\u7ef4\u4e16\u754c\u8bbe\u7f6e\u80cc\u666f\uff0c\u7ed9\u4eba\u4e00\u79cd\u4e16\u754c\u5e7f\u9614\u7684\u9519\u89c9\u3002\u8fd9\u4e2a\u80cc\u666f\u5c06\u6444\u50cf\u673a\u6240\u5904\u4f4d\u7f6e\u5305\u8d77\u6765\uff0c\u7f69\u4f4f\u6574\u4e2a\u7a7a\u95f4\u3002\u6211\u4eec\u8981\u505a\u7684\u662f\u6784\u9020\u4e00\u4e2a\u6e32\u67d3\u5728\u4e09\u7ef4\u573a\u666f\u5468\u56f4\u7684\u7acb\u65b9\u4f53\uff0c\u5373\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u5c06\u4f4d\u4e8e\u7acb\u65b9\u4f53\u7684\u4e2d\u5fc3\u3002\u8be5\u7acb\u65b9\u4f53\u7684\u9762\u5c06\u5305\u7740\u4e00\u5c42\u7eb9\u7406\uff0c\u7eb9\u7406\u4e0a\u6709\u5c71\u3001\u84dd\u5929\u548c\u4e91\u5f69\uff0c\u5b83\u5c06\u4ee5\u4e00\u79cd\u56fe\u50cf\u770b\u8d77\u6765\u50cf\u662f\u4e00\u4e2a\u8fde\u7eed\u7684\u98ce\u666f\u7684\u65b9\u5f0f\u8fdb\u884c\u6620\u5c04\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002 \u521b\u5efa\u5929\u7a7a\u76d2\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u51e0\u6b65\uff1a \u521b\u5efa\u4e00\u4e2a\u5927\u7acb\u65b9\u4f53\u3002 \u5bf9\u5b83\u5e94\u7528\u7eb9\u7406\uff0c\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u6e32\u67d3\u7acb\u65b9\u4f53\uff0c\u5b83\u7684\u539f\u70b9\u4f4d\u4e8e\u6444\u50cf\u673a\u6240\u5904\u7684\u4f4d\u7f6e\uff0c\u5b83\u7684\u9762\u8ddd\u79bb\u539f\u70b9\u5f88\u8fdc\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u7eb9\u7406\u5f00\u59cb\u3002\u4f60\u4f1a\u53d1\u73b0\u4e92\u8054\u7f51\u4e0a\u6709\u5f88\u591a\u9884\u5148\u751f\u6210\u7684\u7eb9\u7406\u53ef\u4f9b\u4f7f\u7528\uff0c\u672c\u7ae0\u793a\u4f8b\u4e2d\u4f7f\u7528\u7684\u7eb9\u7406\u4ece\u6b64\u5904\u4e0b\u8f7d\uff1a http://www.custommapmakers.org/skyboxes.php \u3002\u672c\u7ae0\u4e2d\u5177\u4f53\u4f7f\u7528\u7684\u7eb9\u7406\u662f\uff1a http://www.custommapmakers.org/skyboxes/zips/ely_hills.zip \uff0c\u4f5c\u8005\u662fColin Lowndes\u3002 \u8be5\u7f51\u7ad9\u7684\u7eb9\u7406\u90fd\u662f\u7531\u5355\u72ec\u7684TGA\u6587\u4ef6\u7ec4\u6210\uff0c\u6bcf\u4e2a\u6587\u4ef6\u90fd\u662f\u7acb\u65b9\u4f53\u7684\u4e00\u9762\u3002\u6211\u4eec\u7684\u7eb9\u7406\u52a0\u8f7d\u5668\u5e0c\u671b\u6587\u4ef6\u683c\u5f0f\u4e3aPNG\uff0c\u6240\u4ee5\u9700\u8981\u5c06\u6bcf\u4e00\u9762\u7684\u56fe\u50cf\u7ec4\u5408\u6210\u4e00\u4e2aPNG\u56fe\u50cf\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u5176\u4ed6\u65b9\u6cd5\uff0c\u4f8b\u5982\u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff0c\u4f7f\u5176\u81ea\u52a8\u5e94\u7528\u7eb9\u7406\u3002\u4f46\u4e3a\u4e86\u4f7f\u672c\u7ae0\u5c3d\u53ef\u80fd\u7b80\u6d01\u6613\u61c2\uff0c\u4f60\u5fc5\u987b\u624b\u52a8\u628a\u5b83\u4eec\u6392\u5217\u4e3a\u4e00\u5f20\u56fe\u7247\uff0c\u6700\u7ec8\u56fe\u50cf\u5982\u4e0b\u6240\u793a\uff1a \u63a5\u4e0b\u6765\u9700\u8981\u521b\u5efa\u4e00\u4e2aOBJ\u6587\u4ef6\uff0c\u5176\u4e2d\u542b\u6709\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u6b63\u786e\u5730\u8bbe\u7f6e\u6bcf\u4e00\u9762\u7684\u7eb9\u7406\u5750\u6807\u3002\u4e0b\u56fe\u5c55\u73b0\u4e86\u7eb9\u7406\u4e0e\u7acb\u65b9\u4f53\u5404\u9762\u7684\u5173\u7cfb\uff08\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u6e90\u4ee3\u7801\u4e2d\u627e\u5230\u672c\u7ae0\u4f7f\u7528\u7684OBJ\u6587\u4ef6\uff09\uff1a \u5f53\u76f8\u5173\u8d44\u6e90\u51c6\u5907\u5c31\u7eea\uff0c\u5c31\u53ef\u4ee5\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\u4e86\u3002\u9996\u5148\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SkyBox \u7684\u65b0\u7c7b\uff0c\u5b83\u7684\u6784\u9020\u51fd\u6570\u63a5\u6536OBJ\u6a21\u578b\u8def\u5f84\u548c\u5929\u7a7a\u76d2\u7eb9\u7406\u6587\u4ef6\u8def\u5f84\u3002\u5982\u540c\u6b64\u524d\u4e00\u7ae0\u7684HUD\uff0c\u8fd9\u4e2a\u7c7b\u4e5f\u7ee7\u627f GameItem \u7c7b\u3002\u4e3a\u4ec0\u4e48\u5b83\u8981\u7ee7\u627f GameItem \u7c7b\uff1f\u9996\u5148\uff0c\u4e3a\u4e86\u65b9\u4fbf\u6211\u4eec\u91cd\u7528\u5927\u90e8\u5206\u5904\u7406\u7f51\u683c\u548c\u7eb9\u7406\u7684\u4ee3\u7801\uff1b\u7b2c\u4e8c\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u4e0d\u4f1a\u79fb\u52a8\uff0c\u6211\u4eec\u53ea\u60f3\u5e94\u7528\u65cb\u8f6c\u548c\u7f29\u653e\u3002\u8fd9\u6837\u60f3\u60f3 SkyBox \u786e\u5b9e\u662f\u4e00\u4e2a GameItem \u3002 SkyBox \u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine; import org.lwjglb.engine.graph.Material; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.OBJLoader; import org.lwjglb.engine.graph.Texture; public class SkyBox extends GameItem { public SkyBox(String objModel, String textureFile) throws Exception { super(); Mesh skyBoxMesh = OBJLoader.loadMesh(objModel); Texture skyBoxtexture = new Texture(textureFile); skyBoxMesh.setMaterial(new Material(skyBoxtexture, 0.0f)); setMesh(skyBoxMesh); setPosition(0, 0, 0); } } \u5982\u679c\u4f60\u67e5\u9605\u672c\u7ae0\u7684\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u53d1\u73b0\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a Scene \u7684\u7c7b\uff0c\u5b83\u5c06\u6574\u7406\u4e0e\u4e09\u7ef4\u4e16\u754c\u76f8\u5173\u7684\u6240\u6709\u6570\u636e\u3002 Scene \u7c7b\u7684\u5b9a\u4e49\u548c\u5c5e\u6027\u5982\u4e0b\u6240\u793a\uff0c\u5176\u4e2d\u5305\u542b SkyBox \u7c7b\u7684\u5b9e\u4f8b\uff1a package org.lwjglb.engine; public class Scene { private GameItem[] gameItems; private SkyBox skyBox; private SceneLight sceneLight; public GameItem[] getGameItems() { return gameItems; } // \u66f4\u591a\u4ee3\u7801... \u63a5\u4e0b\u6765\u662f\u4e3a\u5929\u7a7a\u76d2\u521b\u5efa\u53e6\u4e00\u7ec4\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\uff0c\u4f46\u4e3a\u4ec0\u4e48\u4e0d\u91cd\u7528\u5df2\u6709\u7684\u573a\u666f\u7740\u8272\u5668\u5462\uff1f\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u6240\u9700\u7684\u7740\u8272\u5668\u662f\u539f\u6709\u7740\u8272\u5668\u7684\u7b80\u5316\u7248\uff0c\u4e0d\u9700\u8981\u8ba9\u5149\u7167\u5f71\u54cd\u5929\u7a7a\u76d2\uff08\u66f4\u51c6\u786e\u7684\u8bf4\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u70b9\u5149\u6e90\uff0c\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\uff09\u3002\u5929\u7a7a\u76d2\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4ecd\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u7f29\u653e\u5929\u7a7a\u76d2\uff0c\u6240\u4ee5\u9700\u8981\u53d8\u6362\u77e9\u9635\u3002\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u5230\u4e00\u4e9b\u5176\u4ed6\u5b9e\u73b0\uff0c\u5728\u521d\u59cb\u5316\u65f6\u5c31\u653e\u5927\u4e86\u7acb\u65b9\u4f53\u6a21\u578b\u7684\u5927\u5c0f\uff0c\u5e76\u4e14\u4e0d\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u548c\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\u3002\u4f46\u6211\u4eec\u9009\u62e9\u524d\u4e00\u79cd\u65b9\u6cd5\uff0c\u56e0\u4e3a\u5b83\u66f4\u7075\u6d3b\uff0c\u5b83\u5141\u8bb8\u5728\u8fd0\u884c\u65f6\u6539\u53d8\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u3002\u4f46\u5982\u679c\u4f60\u60f3\uff0c\u4f60\u5c31\u53ef\u4ee5\u8f7b\u677e\u6539\u6362\u5230\u53e6\u4e00\u79cd\u65b9\u6cd5\u3002 \u7247\u5143\u7740\u8272\u5668\u4e5f\u975e\u5e38\u7b80\u5355\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; uniform vec3 ambientLight; void main() { fragColor = vec4(ambientLight, 1) * texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u7740\u8272\u5668\u6dfb\u52a0\u4e86\u4e00\u4e2a\u73af\u5883\u5149\uff0c\u8be5Uniform\u7684\u76ee\u7684\u662f\u4fee\u6539\u5929\u7a7a\u76d2\u7684\u989c\u8272\u4ee5\u6a21\u62df\u663c\u591c\uff08\u5982\u679c\u4e0d\u8fd9\u6837\u505a\uff0c\u5728\u4e16\u754c\u7684\u5176\u4ed6\u5730\u65b9\u90fd\u662f\u9ed1\u6697\u7684\u65f6\u5019\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u5c31\u50cf\u662f\u5728\u4e2d\u5348\uff09\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u521a\u521a\u6dfb\u52a0\u4e86\u65b0\u7684\u65b9\u6cd5\u6765\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u5e76\u8bbe\u7f6eUniform\uff08\u8fd9\u4e0d\u662f\u4ec0\u4e48\u65b0\u7684\u6982\u5ff5\uff09\u3002 private void setupSkyBoxShader() throws Exception { skyBoxShaderProgram = new ShaderProgram(); skyBoxShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/sb_vertex.vs\")); skyBoxShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/sb_fragment.fs\")); skyBoxShaderProgram.link(); skyBoxShaderProgram.createUniform(\"projectionMatrix\"); skyBoxShaderProgram.createUniform(\"modelViewMatrix\"); skyBoxShaderProgram.createUniform(\"texture_sampler\"); skyBoxShaderProgram.createUniform(\"ambientLight\"); } \u5f53\u7136\uff0c\u6211\u4eec\u9700\u8981\u5728\u5168\u5c40\u6e32\u67d3\u4e2d\u4e3a\u6e32\u67d3\u5929\u7a7a\u76d2\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u6e32\u67d3\u65b9\u6cd5\u3002 private void renderSkyBox(Window window, Camera camera, Scene scene) { skyBoxShaderProgram.bind(); skyBoxShaderProgram.setUniform(\"texture_sampler\", 0); // \u66f4\u65b0\u6295\u5f71\u77e9\u9635 Matrix4f projectionMatrix = transformation.getProjectionMatrix(FOV, window.getWidth(), window.getHeight(), Z_NEAR, Z_FAR); skyBoxShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); SkyBox skyBox = scene.getSkyBox(); Matrix4f viewMatrix = transformation.getViewMatrix(camera); viewMatrix.m30(0); viewMatrix.m31(0); viewMatrix.m32(0); Matrix4f modelViewMatrix = transformation.getModelViewMatrix(skyBox, viewMatrix); skyBoxShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); skyBoxShaderProgram.setUniform(\"ambientLight\", scene.getSceneLight().getAmbientLight()); scene.getSkyBox().getMesh().render(); skyBoxShaderProgram.unbind(); } \u4e0a\u8ff0\u65b9\u6cd5\u4e0e\u5176\u4ed6\u6e32\u67d3\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u4e00\u4e2a\u4e0d\u540c\u4e4b\u5904\u9700\u8981\u89e3\u91ca\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u50cf\u5e73\u5e38\u4e00\u6837\u4f20\u9012\u6295\u5f71\u77e9\u9635\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u4f46\u5f53\u53d6\u5f97\u89c2\u5bdf\u77e9\u9635\u65f6\uff0c\u6211\u4eec\u5c06\u5176\u4e00\u4e9b\u6570\u503c\u8bbe\u7f6e\u4e3a0\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u5176\u4e2d\u7684\u539f\u56e0\u662f\u6211\u4eec\u4e0d\u5e0c\u671b\u5929\u7a7a\u76d2\u88ab\u79fb\u52a8\u3002 \u8bf7\u8bb0\u4f4f\uff0c\u5f53\u6211\u4eec\u5728\u79fb\u52a8\u6444\u50cf\u673a\u65f6\uff0c\u5b9e\u9645\u4e0a\u662f\u5728\u79fb\u52a8\u6574\u4e2a\u4e16\u754c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u76f4\u63a5\u5c06\u89c2\u5bdf\u77e9\u9635\u4e0e\u6a21\u578b\u77e9\u9635\u76f8\u4e58\uff0c\u5f53\u6444\u50cf\u673a\u79fb\u52a8\u65f6\uff0c\u5929\u7a7a\u76d2\u4e5f\u5c06\u79fb\u52a8\u3002\u4f46\u662f\u6211\u4eec\u4e0d\u60f3\u8fd9\u6837\uff0c\u6211\u4eec\u60f3\u628a\u5b83\u56fa\u5b9a\u5728\u5750\u6807\u539f\u70b9(0, 0, 0)\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u79fb\u589e\u91cf\u90e8\u5206\uff08 m30 , m31 \u548c m32 \uff09\u8bbe\u7f6e\u4e3a0\u6765\u5b9e\u73b0\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u8ba4\u4e3a\u53ef\u4ee5\u907f\u514d\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u5929\u7a7a\u76d2\u5fc5\u987b\u56fa\u5b9a\u5728\u539f\u70b9\u3002\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u5929\u7a7a\u76d2\u4e0d\u4f1a\u968f\u7740\u6444\u50cf\u673a\u65cb\u8f6c\uff0c\u8fd9\u4e0d\u662f\u6211\u4eec\u60f3\u8981\u7684\u3002\u56e0\u6b64\u6211\u4eec\u9700\u8981\u65cb\u8f6c\u5b83\u4f46\u4e0d\u8981\u79fb\u52a8\u5b83\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\uff0c\u4f60\u53ef\u4ee5\u67e5\u9605\u672c\u7ae0\u6e90\u4ee3\u7801\uff0c\u672c\u4f8b\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e86\u66f4\u591a\u7684\u65b9\u5757\u5b9e\u4f8b\u6765\u6a21\u62df\u5730\u9762\u548c\u5929\u7a7a\u76d2\u3002\u4f60\u4e5f\u53ef\u4ee5\u6539\u53d8\u73af\u5883\u5149\u6765\u6a21\u62df\u5149\u7167\u548c\u663c\u591c\u4ea4\u66ff\u3002\u6700\u7ec8\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u6548\u679c\uff1a \u5929\u7a7a\u76d2\u662f\u4e00\u4e2a\u5c0f\u7acb\u65b9\u4f53\uff08\u5728\u5b9e\u9645\u7684\u6e38\u620f\u4e2d\uff0c\u5b83\u5e94\u8be5\u5927\u5f97\u591a\uff09\uff0c\u6240\u4ee5\u4f60\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u65f6\uff0c\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u770b\u5230\u5176\u6548\u679c\u3002\u4f60\u8fd8\u53ef\u4ee5\u770b\u5230\uff0c\u6784\u6210\u5730\u9762\u7684\u65b9\u5757\u6bd4\u5929\u7a7a\u76d2\u5927\uff0c\u6240\u4ee5\u5f53\u4f60\u79fb\u52a8\u65f6\uff0c\u4f60\u4f1a\u770b\u5230\u4ece\u5c71\u4e2d\u5192\u51fa\u7684\u65b9\u5757\u3002\u8fd9\u5f88\u660e\u663e\uff0c\u56e0\u4e3a\u6211\u4eec\u8bbe\u7f6e\u7684\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u3002\u4f46\u65e0\u8bba\u5982\u4f55\uff0c\u6211\u4eec\u9700\u8981\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u9690\u85cf\u548c\u6a21\u7cca\u8fdc\u5904\u7684\u7269\u4f53\u7684\u6548\u679c\uff08\u4f8b\u5982\u4f7f\u7528\u96fe\u6548\u679c\uff09\u6765\u51cf\u8f7b\u8fd9\u79cd\u5f71\u54cd\u3002 \u4e0d\u521b\u5efa\u66f4\u5927\u7684\u5929\u7a7a\u76d2\u7684\u53e6\u4e00\u4e2a\u539f\u56e0\u662f\u6211\u4eec\u9700\u8981\u51e0\u4e2a\u4f18\u5316\u6765\u63d0\u5347\u6548\u7387\uff08\u7a0d\u540e\u5bf9\u6b64\u8fdb\u884c\u89e3\u91ca\uff09\u3002 \u53ef\u4ee5\u6ce8\u91ca\u6e32\u67d3\u65b9\u6cd5\u4e2d\u9632\u6b62\u5929\u7a7a\u76d2\u79fb\u52a8\u7684\u4ee3\u7801\uff0c\u7136\u540e\u4f60\u5c31\u53ef\u4ee5\u5728\u5929\u7a7a\u76d2\u5916\u770b\u5230\u5982\u4e0b\u6240\u793a\u56fe\u50cf\uff1a \u867d\u7136\u8fd9\u4e0d\u662f\u5929\u7a7a\u76d2\u8be5\u505a\u7684\uff0c\u4f46\u8fd9\u53ef\u4ee5\u5e2e\u52a9\u4f60\u7406\u89e3\u5929\u7a7a\u76d2\u7684\u6982\u5ff5\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u4e00\u4e2a\u7b80\u5355\u7684\u793a\u4f8b\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u5176\u4ed6\u6548\u679c\u6765\u6539\u5584\u5b83\uff0c\u6bd4\u5982\u592a\u9633\u5728\u5929\u7a79\u79fb\u52a8\u6216\u4e91\u5c42\u79fb\u52a8\u3002\u6b64\u5916\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u4e16\u754c\uff0c\u4f60\u9700\u8981\u5c06\u4e16\u754c\u5206\u5272\u6210\u533a\u57df\uff0c\u53ea\u52a0\u8f7d\u90a3\u4e9b\u4e0e\u73a9\u5bb6\u6240\u5904\u7684\u533a\u57df\u76f8\u90bb\u7684\u533a\u57df\u3002 \u53e6\u5916\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff1a\u4ec0\u4e48\u65f6\u5019\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u8fd8\u662f\u4e4b\u540e\uff1f\u5728\u6e32\u67d3\u573a\u666f\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\u66f4\u4f18\uff0c\u56e0\u4e3a\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u5927\u591a\u6570\u7247\u5143\u5c06\u88ab\u4e22\u5f03\u3002\u5f53OpenGL\u5c1d\u8bd5\u6e32\u67d3\u5b83\u4eec\uff0c\u5e76\u4e14\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u65f6\uff0c\u5c06\u4e22\u5f03\u4e00\u4e9b\u4f4d\u4e8e\u5148\u524d\u6e32\u67d3\u7684\u7247\u5143\u4e4b\u540e\u7684\u7247\u5143\uff0c\u8fd9\u4e9b\u7247\u5143\u7684\u6df1\u5ea6\u503c\u66f4\u4f4e\u3002\u6240\u4ee5\u7b54\u6848\u5f88\u660e\u663e\uff0c\u5bf9\u5427\uff1f\u6e32\u67d3\u573a\u666f\u540e\uff0c\u518d\u6e32\u67d3\u5929\u7a7a\u76d2\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5728\u5904\u7406\u900f\u660e\u7eb9\u7406\u65f6\uff0c\u5982\u679c\u5728\u573a\u666f\u4e2d\u6211\u4eec\u6709\u5e94\u7528\u900f\u660e\u7eb9\u7406\u7684\u7269\u4f53\uff0c\u5b83\u4eec\u5c06\u4f7f\u7528\u201c\u80cc\u666f\u201d\u8272\u7ed8\u5236\uff0c\u672c\u4f8b\u4e2d\u662f\u9ed1\u8272\u3002\u4f46\u5982\u679c\u6211\u4eec\u5148\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u90a3\u4e48\u5c06\u4f1a\u6b63\u786e\u5730\u5e94\u7528\u900f\u660e\u6548\u679c\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5e94\u8be5\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\u5417\uff1f\u5173\u952e\u5728\u4e8e\u4f60\u7684\u9009\u62e9\u3002\u5982\u679c\u4f60\u5728\u6e32\u67d3\u573a\u666f\u524d\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u53ef\u4ee5\u89e3\u51b3\u900f\u660e\u7eb9\u7406\u95ee\u9898\uff0c\u4f46\u662f\u4f1a\u5f71\u54cd\u6027\u80fd\u3002\u5b9e\u9645\u4e0a\uff0c\u5c31\u7b97\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f60\u4e5f\u53ef\u80fd\u9762\u4e34\u900f\u660e\u95ee\u9898\u3002\u5047\u8bbe\u4f60\u6709\u4e00\u4e2a\u900f\u660e\u7684\u7269\u4f53\uff0c\u5b83\u4e0e\u8fdc\u5904\u7684\u7269\u4f53\u91cd\u53e0\uff0c\u5982\u679c\u9996\u5148\u6e32\u67d3\u900f\u660e\u5bf9\u8c61\uff0c\u90a3\u4e48\u4e5f\u4f1a\u51fa\u73b0\u900f\u660e\u95ee\u9898\u3002\u56e0\u6b64\uff0c\u4e5f\u8bb8\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u5728\u6240\u6709\u5176\u4ed6\u9879\u88ab\u6e32\u67d3\u540e\uff0c\u5355\u72ec\u7ed8\u5236\u900f\u660e\u7684\u9879\u3002\u8fd9\u662f\u4e00\u4e9b\u5546\u4e1a\u6e38\u620f\u4f7f\u7528\u7684\u65b9\u6cd5\u3002\u4e0d\u8fc7\u73b0\u5728\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u4e4b\u540e\u6e32\u67d3\u5929\u7a7a\u76d2\uff0c\u4ee5\u83b7\u5f97\u66f4\u9ad8\u7684\u6027\u80fd\u3002","title":"\u5929\u7a7a\u76d2"},{"location":"13-sky-box-and-some-optimizations/#_2","text":"\u4ece\u4e0a\u8ff0\u793a\u4f8b\u6765\u770b\uff0c\u5929\u7a7a\u76d2\u76f8\u5bf9\u8f83\u5c0f\u4f7f\u5f97\u5176\u6548\u679c\u6709\u70b9\u5947\u602a\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u7269\u4f53\u795e\u5947\u5730\u4ece\u5c71\u4f53\u51fa\u73b0\uff09\u3002\u6240\u4ee5\u8ba9\u6211\u4eec\u589e\u52a0\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u548c\u4e16\u754c\u7684\u5927\u5c0f\uff0c\u5c06\u5929\u7a7a\u76d2\u7684\u5927\u5c0f\u653e\u592750\u500d\uff0c\u8fd9\u6837\u4e16\u754c\u753140,000\u4e2a\u6e38\u620f\u9879\u5b9e\u4f8b\uff08\u65b9\u5757\uff09\u7ec4\u6210\u3002 \u5982\u679c\u4f60\u66f4\u6539\u7f29\u653e\u5e76\u91cd\u65b0\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u53d1\u73b0\u5f00\u59cb\u51fa\u73b0\u6027\u80fd\u95ee\u9898\uff0c\u5e76\u4e14\u5728\u4e16\u754c\u4e2d\u79fb\u52a8\u4e0d\u987a\u7545\u3002\u73b0\u5728\u662f\u65f6\u5019\u5173\u6ce8\u4e00\u4e0b\u6027\u80fd\u4e86\uff08\u4f60\u53ef\u80fd\u542c\u8fc7\u4e00\u53e5\u8001\u8bdd\uff1a\u201c\u8fc7\u65e9\u7684\u4f18\u5316\u662f\u4e07\u6076\u4e4b\u6e90\u201d\uff0c\u4f46\u662f\u4ece\u672c\u7ae0\u5f00\u59cb\uff0c\u6211\u5e0c\u671b\u6ca1\u6709\u4eba\u4f1a\u8bf4\u8fd9\u662f\u8fc7\u65e9\u7684\uff09\u3002 \u8ba9\u6211\u6765\u4ecb\u7ecd\u4e00\u4e2a\u6982\u5ff5\uff0c\u5b83\u80fd\u51cf\u5c11\u6b63\u5728\u6e32\u67d3\u7684\u6570\u636e\u6570\u91cf\uff0c\u5b83\u53eb\u505a\u9762\u5254\u9664\uff08Face Culling\uff09\u3002\u5728\u793a\u4f8b\u4e2d\uff0c\u6211\u4eec\u6e32\u67d3\u4e86\u6210\u5343\u4e0a\u4e07\u4e2a\u7acb\u65b9\u4f53\uff0c\u7acb\u65b9\u4f53\u662f\u7531\u516d\u4e2a\u9762\u7ec4\u6210\u7684\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u6bcf\u4e2a\u7acb\u65b9\u4f53\u7684\u516d\u4e2a\u9762\uff0c\u5373\u4f7f\u5b83\u4eec\u6709\u4e9b\u662f\u770b\u4e0d\u5230\u7684\u3002\u8fdb\u5165\u4e00\u4e2a\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4f60\u4f1a\u770b\u5230\u5b83\u7684\u5185\u90e8\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4e0d\u80fd\u88ab\u770b\u5230\u7684\u9762\u5e94\u8be5\u7acb\u5373\u820d\u5f03\uff0c\u8fd9\u5c31\u662f\u9762\u5254\u9664\u7684\u4f5c\u7528\u3002\u5b9e\u9645\u4e0a\uff0c\u5bf9\u4e8e\u4e00\u4e2a\u7acb\u65b9\u4f53\uff0c\u4f60\u6700\u591a\u53ea\u80fd\u540c\u65f6\u770b\u5230\u4e09\u4e2a\u9762\uff0c\u6240\u4ee5\u53ea\u80fd\u901a\u8fc7\u4f7f\u7528\u9762\u5254\u9664\uff08\u5982\u679c\u4f60\u7684\u6e38\u620f\u4e0d\u8981\u6c42\u4f60\u8fdb\u5165\u6a21\u578b\u7684\u5185\u90e8\uff0c\u8fd9\u6837\u505a\u624d\u662f\u9ad8\u6548\u7684\uff0c\u7a0d\u540e\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\uff09\u6765\u820d\u5f03\u4e00\u534a\u7684\u9762\uff0840,000\u00d73\u00d72\u4e2a\u4e09\u89d2\u5f62\uff09\u3002 \u9762\u5254\u9664\u68c0\u67e5\u6bcf\u4e2a\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e22\u5f03\u90a3\u4e9b\u4e0d\u9762\u5411\u6444\u50cf\u673a\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u662f\uff0c\u5982\u4f55\u77e5\u9053\u4e09\u89d2\u5f62\u662f\u5426\u9762\u5411\u6444\u50cf\u673a\u5462\uff1f\u597d\u5427\uff0cOpenGL\u5b9e\u73b0\u5b83\u7684\u65b9\u5f0f\u662f\u901a\u8fc7\u68c0\u67e5\u7ec4\u6210\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002 \u8bb0\u5f97\u4ece\u7b2c\u4e00\u7ae0\u5f00\u59cb\uff0c\u6211\u4eec\u53ef\u4ee5\u5b9a\u4e49\u4e00\u4e2a\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u4ee5\u987a\u65f6\u9488\u6216\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u3002\u5728OpenGL\u4e2d\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u4ee5\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u6444\u50cf\u673a\uff0c\u800c\u4ee5\u987a\u65f6\u9488\u987a\u5e8f\u6392\u5217\u9876\u70b9\u7684\u4e09\u89d2\u5f62\u9762\u5411\u76f8\u53cd\u7684\u65b9\u5411\u3002\u5173\u952e\u662f\u5728\u8003\u8651\u6444\u50cf\u673a\u7684\u60c5\u51b5\u4e0b\uff0c\u68c0\u67e5\u9876\u70b9\u7684\u73af\u7ed5\u987a\u5e8f\u3002\u56e0\u6b64\uff0c\u6309\u7167\u9006\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u4e09\u89d2\u5f62\u53ef\u4ee5\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u5b9e\u73b0\u5b83\uff0c\u5728 Window \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e0b\u8ff0\u4ee3\u7801\uff1a glEnable(GL_CULL_FACE); glCullFace(GL_BACK); \u7b2c\u4e00\u884c\u4ee3\u7801\u5c06\u542f\u7528\u9762\u5254\u9664\uff0c\u7b2c\u4e8c\u884c\u4ee3\u7801\u8bbe\u7f6e\u80cc\u5411\u9762\u4e3a\u9700\u8981\u5254\u9664\u7684\u9762\u3002\u5982\u679c\u5411\u4e0a\u770b\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u60c5\u666f\uff1a \u53d1\u751f\u4e86\u4ec0\u4e48\uff1f\u5982\u679c\u4f60\u67e5\u770b\u9876\u9762\u7684\u9876\u70b9\u987a\u5e8f\uff0c\u5c06\u770b\u5230\u5b83\u662f\u6309\u9006\u65f6\u9488\u5b9a\u4e49\u7684\u3002\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u73af\u7ed5\u987a\u5e8f\u662f\u4ee5\u6444\u50cf\u673a\u4e3a\u89c6\u89d2\u3002\u5b9e\u9645\u4e0a\uff0c\u5982\u679c\u4f60\u8ba9\u4f4d\u79fb\u5f71\u54cd\u5929\u7a7a\u76d2\u4ee5\u4fbf\u80fd\u4ece\u5176\u4e0a\u65b9\u89c2\u5bdf\u5b83\u65f6\uff0c\u5219\u5f53\u4f60\u5728\u5929\u7a7a\u76d2\u5916\u65f6\uff0c\u5c06\u770b\u5230\u9876\u9762\u518d\u6b21\u6e32\u67d3\u3002 \u8ba9\u6211\u4eec\u6765\u63cf\u8ff0\u4e00\u4e0b\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5929\u7a7a\u76d2\u7acb\u65b9\u4f53\u7684\u9876\u9762\u4e09\u89d2\u5f62\u4e2d\u7684\u4e00\u4e2a\u4e09\u89d2\u5f62\uff0c\u5b83\u7531\u9006\u65f6\u9488\u987a\u5e8f\u6392\u5217\u7684\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\uff1a \u4f46\u8981\u8bb0\u4f4f\uff0c\u6211\u4eec\u662f\u5728\u5929\u7a7a\u76d2\u91cc\uff0c\u5982\u679c\u4ece\u5185\u90e8\u89c2\u5bdf\u7acb\u65b9\u4f53\uff0c\u4f1a\u770b\u5230\u9876\u70b9\u662f\u6309\u987a\u65f6\u9488\u987a\u5e8f\u5b9a\u4e49\u7684\u3002 \u8fd9\u662f\u56e0\u4e3a\u5929\u7a7a\u76d2\u88ab\u5b9a\u4e49\u4e3a\u4ece\u5916\u90e8\u89c2\u5bdf\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u7ffb\u8f6c\u4e00\u4e9b\u9762\u7684\u5b9a\u4e49\uff0c\u4ee5\u4fbf\u5728\u542f\u7528\u9762\u5254\u9664\u65f6\u80fd\u6b63\u786e\u5730\u6e32\u67d3\u5b83\u3002 \u4f46\u8fd9\u4ecd\u6709\u66f4\u5927\u7684\u4f18\u5316\u7a7a\u95f4\u3002\u56de\u987e\u4e00\u4e0b\u6e32\u67d3\u6d41\u7a0b\uff0c\u5728 Renderer \u7c7b render \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u904d\u5386 GameItem \u6570\u7ec4\u5e76\u6e32\u67d3\u76f8\u5173\u7684 Mesh \u3002\u5bf9\u6bcf\u4e2a GameItem \uff0c\u6211\u4eec\u505a\u4e86\u4e0b\u8ff0\u5de5\u4f5c\uff1a \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u7684\u552f\u4e00\u503c\uff09\u3002 \u83b7\u53d6 GameItem \u50a8\u5b58\u7684 Mesh \u5e76\u7ed1\u5b9a\u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u6267\u884c\u8c03\u7528\u4ee5\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u505c\u7528\u7eb9\u7406\u548cVAO\u3002 \u4f46\u5728\u73b0\u5728\u7684\u6e38\u620f\u4e2d\uff0c40,000\u4e2a GameItem \u90fd\u4f7f\u7528\u76f8\u540c\u7684 Mesh \uff0c\u800c\u6211\u4eec\u4e00\u6b21\u53c8\u4e00\u6b21\u5730\u91cd\u590d\u7b2c\u4e8c\u9879\u5230\u7b2c\u56db\u9879\u7684\u64cd\u4f5c\u3002\u8fd9\u4e0d\u662f\u5f88\u9ad8\u6548\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u5bf9OpenGL\u51fd\u6570\u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u662f\u6709\u6027\u80fd\u5f00\u9500\u7684\u672c\u5730\u8c03\u7528\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5e94\u8be5\u5c3d\u91cf\u9650\u5236OpenGL\u4e2d\u7684\u72b6\u6001\u53d8\u5316\uff08\u7ed1\u5b9a\u548c\u505c\u7528\u7eb9\u7406\u3001VAO\u90fd\u662f\u72b6\u6001\u53d8\u5316\uff09\u3002 \u6211\u4eec\u9700\u8981\u6539\u53d8\u5f00\u53d1\u7684\u65b9\u5f0f\uff0c\u56f4\u7ed5\u7f51\u683c\u7ec4\u7ec7\u4ee3\u7801\u7ed3\u6784\uff0c\u56e0\u4e3a\u7ecf\u5e38\u6709\u8bb8\u591a\u6e38\u620f\u9879\u4f7f\u7528\u76f8\u540c\u7684\u7f51\u683c\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e00\u4e2a\u6e38\u620f\u9879\u6570\u7ec4\uff0c\u6bcf\u9879\u90fd\u6307\u5411\u540c\u4e00\u4e2a\u7f51\u683c\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u4f5c\u4e3a\u66ff\u4ee3\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5176\u4e2d\u5305\u62ec\u50a8\u5b58\u5171\u4eab\u8be5\u7f51\u683c\u7684\u6240\u6709\u6e38\u620f\u9879\u3002 \u5bf9\u4e8e\u6bcf\u4e00\u4e2a Mesh \uff0c\u6e32\u67d3\u6b65\u9aa4\u5c06\u4f1a\u662f\uff1a \u83b7\u53d6\u4e0e GameItem \u76f8\u5173\u8054\u7684 Mesh \u5e76\u7ed1\u5b9a Mesh \u7eb9\u7406\uff0c\u7ed1\u5b9aVAO\u5e76\u542f\u7528\u5176\u5c5e\u6027\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u76f8\u5173\u7684 GameItem \uff1a a. \u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08\u6bcf\u4e2a GameItem \u552f\u4e00\u7684\uff09\u3002 b. \u8c03\u7528\u7ed8\u5236\u4e09\u89d2\u5f62\u3002 \u89e3\u7ed1\u7eb9\u7406\u548cVAO\u3002 \u5728 Scene \u7c7b\u4e2d\u50a8\u5b58\u4e0b\u8ff0 Map \uff1a private Map<Mesh, List<GameItem>> meshMap; \u6211\u4eec\u4ecd\u6709 setGameItems \u65b9\u6cd5\uff0c\u4f46\u6211\u4eec\u4e0d\u53ea\u662f\u50a8\u5b58\u6570\u7ec4\uff0c\u800c\u662f\u6784\u9020\u7f51\u683c\u6620\u5c04\u8868\u3002 public void setGameItems(GameItem[] gameItems) { int numGameItems = gameItems != null ? gameItems.length : 0; for (int i=0; i<numGameItems; i++) { GameItem gameItem = gameItems[i]; Mesh mesh = gameItem.getMesh(); List<GameItem> list = meshMap.get(mesh); if ( list == null ) { list = new ArrayList<>(); meshMap.put(mesh, list); } list.add(gameItem); } } Mesh \u7c7b\u73b0\u5728\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u6e32\u67d3\u4e0e\u5176\u76f8\u5173\u7684 GameItem \u5217\u8868\uff0c\u7136\u540e\u5c06\u7ed1\u5b9a\u548c\u89e3\u7ed1\u4ee3\u7801\u5206\u4e3a\u4e0d\u540c\u7684\u65b9\u6cd5\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u4e2a\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } private void endRender() { // \u6062\u590d\u72b6\u6001 glDisableVertexAttribArray(0); glDisableVertexAttribArray(1); glDisableVertexAttribArray(2); glBindVertexArray(0); glBindTexture(GL_TEXTURE_2D, 0); } public void render() { initRender(); glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); endRender(); } public void renderList(List<GameItem> gameItems, Consumer<GameItem> consumer) { initRender(); for (GameItem gameItem : gameItems) { // \u8bbe\u7f6e\u6e38\u620f\u9879\u76ee\u6240\u9700\u7684\u6e32\u67d3\u6570\u636e consumer.accept(gameItem); // \u6e32\u67d3\u6e38\u620f\u9879\u76ee glDrawElements(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0); } endRender(); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4ecd\u7136\u4fdd\u7559\u4e86\u65e7\u65b9\u6cd5\uff0c\u5b83\u8fd4\u56de\u4e00\u4e2a Mesh \uff0c\u8fd9\u662f\u8003\u8651\u5230\u5982\u679c\u53ea\u6709\u4e00\u4e2a GameItem \u7684\u60c5\u51b5\uff08\u8fd9\u53ef\u80fd\u5728\u5176\u4ed6\u60c5\u51b5\u4e0b\u4f7f\u7528\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0d\u79fb\u9664\u5b83\uff09\u3002\u65b0\u7684\u65b9\u6cd5\u6e32\u67d3\u4e00\u4e2a List<GameItem> \uff0c\u5e76\u63a5\u53d7\u4e00\u4e2a Counsumer \u7c7b\u578b\u7684\u53c2\u6570\uff08\u4e00\u4e2a\u51fd\u6570\uff0c\u4f7f\u7528\u4e86Java8\u5f15\u5165\u7684\u51fd\u6570\u5f0f\u7f16\u7a0b\uff09\uff0c\u5b83\u5c06\u7528\u4e8e\u5728\u7ed8\u5236\u4e09\u89d2\u5f62\u4e4b\u524d\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u7279\u5b9a\u7684\u5185\u5bb9\uff0c\u56e0\u4e3a\u4e0d\u5e0c\u671b Mesh \u7c7b\u4e0eUniform\u7684\u540d\u79f0\u548c\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u65f6\u6240\u6d89\u53ca\u7684\u53c2\u6570\u76f8\u8026\u5408\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u6765\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002 \u5728 Renderer \u7c7b\u4e2d\u7684 renderScene \u65b9\u6cd5\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u9700\u904d\u5386\u7f51\u683c\u6620\u5c04\u8868\uff0c\u5e76\u901a\u8fc7Lambda\u8868\u8fbe\u5f0f\u8bbe\u7f6e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002 for (Mesh mesh : mapMeshes.keySet()) { sceneShaderProgram.setUniform(\"material\", mesh.getMaterial()); mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); sceneShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u53ef\u4ee5\u505a\u7684\u53e6\u4e00\u9879\u4f18\u5316\u662f\uff0c\u6211\u4eec\u5728\u6e32\u67d3\u5468\u671f\u4e2d\u521b\u5efa\u4e86\u5927\u91cf\u5bf9\u8c61\u3002\u7279\u522b\u662f\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u592a\u591a\u7684 Matrix4f \u5b9e\u4f8b\uff0c\u5b83\u4eec\u4e3a\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u90fd\u4fdd\u5b58\u4e86\u4e00\u4e2a\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002\u6211\u4eec\u5e94\u5728 Transformation \u7c7b\u4e2d\u521b\u5efa\u7279\u5b9a\u7684\u77e9\u9635\uff0c\u5e76\u91cd\u7528\u76f8\u540c\u7684\u5b9e\u4f8b\u3002\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f1a\u770b\u5230\u6211\u4eec\u5df2\u7ecf\u66f4\u6539\u4e86\u65b9\u6cd5\u7684\u540d\u79f0\uff0c getXX \u65b9\u6cd5\u53ea\u8fd4\u56de\u50a8\u5b58\u7684\u77e9\u9635\u5b9e\u4f8b\uff0c\u5e76\u4e14\u4efb\u4f55\u66f4\u6539\u77e9\u9635\u503c\u7684\u65b9\u6cd5\u90fd\u79f0\u4e3a buildXX \uff0c\u4ee5\u9610\u660e\u5176\u7528\u9014\u3002 \u6211\u4eec\u4e5f\u907f\u514d\u4e86\u6bcf\u6b21\u4e3a\u77e9\u9635\u8bbe\u7f6eUniform\u65f6\u6784\u9020\u65b0\u7684 FloatBuffer \u5b9e\u4f8b\uff0c\u5e76\u79fb\u9664\u4e86\u5176\u4ed6\u4e00\u4e9b\u65e0\u7528\u7684\u5b9e\u4f8b\u5316\u64cd\u4f5c\u3002\u6709\u4e86\u8fd9\u4e9b\uff0c\u4f60\u73b0\u5728\u53ef\u4ee5\u770b\u5230\u66f4\u6d41\u7545\u66f4\u7075\u6d3b\u7684\u6e32\u67d3\u4e86\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u9605\u6240\u6709\u7ec6\u8282\u3002","title":"\u4e00\u4e9b\u4f18\u5316"},{"location":"14-height-maps/","text":"\u9ad8\u5ea6\u56fe\uff08Height Maps\uff09 \u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u9ad8\u5ea6\u56fe\u521b\u5efa\u590d\u6742\u7684\u5730\u5f62\u3002\u5728\u5f00\u59cb\u524d\uff0c\u4f60\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e9b\u65b0\u7684\u5305\u548c\u79fb\u52a8\u4e86\u4e00\u4e9b\u7c7b\u4ee5\u66f4\u597d\u5730\u7ec4\u7ec7\u5b83\u4eec\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u8fd9\u4e9b\u6539\u53d8\u3002 \u6240\u4ee5\u4ec0\u4e48\u662f\u9ad8\u5ea6\u56fe\uff1f\u9ad8\u5ea6\u56fe\u662f\u7528\u4e8e\u751f\u6210\u4e09\u7ef4\u5730\u5f62\u7684\u56fe\u50cf\uff0c\u5b83\u4f7f\u7528\u50cf\u7d20\u989c\u8272\u6765\u83b7\u53d6\u8868\u9762\u9ad8\u5ea6\u3002\u9ad8\u5ea6\u56fe\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5b83\u53ef\u4ee5\u7531 Terragen \u7b49\u8f6f\u4ef6\u751f\u6210\u3002\u4e00\u5f20\u9ad8\u5ea6\u56fe\u56fe\u50cf\u770b\u8d77\u6765\u5c31\u50cf\u8fd9\u6837\u3002 \u4e0a\u56fe\u5c31\u50cf\u4f60\u4fef\u89c6\u4e00\u7247\u9646\u5730\u4e00\u6837\u3002\u5229\u7528\u4e0a\u56fe\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u7531\u9876\u70b9\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u6240\u7ec4\u6210\u7684\u7f51\u683c\u3002\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u5c06\u6839\u636e\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u3002\u9ed1\u8272\u662f\u6700\u4f4e\uff0c\u767d\u8272\u662f\u6700\u9ad8\u3002 \u6211\u4eec\u5c06\u4e3a\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u7ec4\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5c06\u7ec4\u6210\u4e09\u89d2\u5f62\uff0c\u8fd9\u4e9b\u4e09\u89d2\u5f62\u5c06\u7ec4\u6210\u4e0b\u56fe\u6240\u793a\u7684\u7f51\u683c\u3002 \u7f51\u683c\u5c06\u7ec4\u6210\u4e00\u4e2a\u5de8\u5927\u7684\u56db\u8fb9\u5f62\uff0c\u5b83\u5c06\u4f1a\u5728X\u548cZ\u8f74\u4e0a\u6e32\u67d3\uff0c\u5e76\u6839\u636e\u50cf\u7d20\u989c\u8272\u6765\u6539\u53d8\u5b83\u7684Y\u8f74\u9ad8\u5ea6\u3002 \u7531\u9ad8\u5ea6\u56fe\u521b\u5efa\u4e09\u7ef4\u5730\u5f62\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u6b65\u9aa4\uff1a * \u52a0\u8f7d\u50a8\u5b58\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf(\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a BufferedImage \u5b9e\u4f8b\u4ee5\u83b7\u53d6\u6bcf\u4e2a\u50cf\u7d20)\u3002 * \u4e3a\u6bcf\u4e2a\u56fe\u50cf\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u5176\u9ad8\u5ea6\u57fa\u4e8e\u50cf\u7d20\u989c\u8272\u3002 * \u5c06\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u9876\u70b9\u3002 * \u8bbe\u7f6e\u7d22\u5f15\u4ee5\u7ed8\u5236\u4e0e\u9876\u70b9\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a HeightMapMesh \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u6309\u4ee5\u4e0a\u6b65\u9aa4\u521b\u5efa\u4e00\u4e2a Mesh \u3002\u8ba9\u6211\u4eec\u5148\u770b\u770b\u8be5\u7c7b\u5b9a\u4e49\u7684\u5e38\u91cf\uff1a private static final int MAX_COLOUR = 255 * 255 * 255; \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u3002\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5bf9\u4e8ePNG\u56fe\u50cf\u6765\u8bf4\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u50cf\u7d20\u7684\u6bcf\u4e2aRGB\u503c\u53ef\u4ee5\u57280\u5230255\u4e4b\u95f4\u53d8\u5316\uff0c\u56e0\u6b64\u6211\u4eec\u6709256\u4e2a\u503c\u6765\u8868\u793a\u4e0d\u540c\u7684\u9ad8\u5ea6\u3002\u8fd9\u53ef\u80fd\u8db3\u591f\u4e86\uff0c\u4f46\u5982\u679c\u7cbe\u5ea6\u4e0d\u591f\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e09\u4e2aRGB\u503c\u4ee5\u6709\u66f4\u591a\u7684\u503c\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9ad8\u5ea6\u8ba1\u7b97\u8303\u56f4\u4e3a0\u5230255^3\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u5c40\u9650\u4e8e\u7070\u5ea6\u56fe\u3002 \u63a5\u4e0b\u6765\u7684\u5e38\u91cf\u662f\uff1a private static final float STARTX = -0.5f; private static final float STARTZ = -0.5f; \u7f51\u683c\u5c06\u7531\u4e00\u7ec4\u9876\u70b9\uff08\u4e00\u4e2a\u9876\u70b9\u5bf9\u5e94\u4e00\u4e2a\u50cf\u7d20\uff09\u6784\u6210\uff0c\u5176X\u548cZ\u5750\u6807\u7684\u8303\u56f4\u5982\u4e0b * X\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTX , -STARTX ]\u3002 * Z\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTZ , -STARTZ ]\u3002 \u4e0d\u7528\u592a\u8fc7\u62c5\u5fc3\u8fd9\u4e9b\u503c\uff0c\u7a0d\u540e\u5f97\u5230\u7684\u7f51\u683c\u53ef\u4ee5\u88ab\u7f29\u653e\u4ee5\u9002\u5e94\u4e16\u754c\u7684\u5927\u5c0f\u3002\u5173\u4e8eY\u8f74\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e minY \u548c maxY \u4e24\u4e2a\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6eY\u5750\u6807\u7684\u6700\u4f4e\u548c\u6700\u9ad8\u503c\u3002\u8fd9\u4e9b\u53c2\u6570\u5e76\u4e0d\u662f\u5e38\u6570\uff0c\u56e0\u4e3a\u6211\u4eec\u53ef\u80fd\u5e0c\u671b\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u5b83\u4eec\uff0c\u800c\u4e0d\u4f7f\u7528\u7f29\u653e\u3002\u6700\u540e\uff0c\u5730\u5f62\u5c06\u5305\u542b\u5728\u8303\u56f4\u4e3a [STARTX, -STARTX] \uff0c [minY, maxY] \uff0c [STARTZ, -STARTZ] \u7684\u7acb\u65b9\u4f53\u5185\u3002 \u7f51\u683c\u5c06\u4f1a\u5728 HeightMapMesh \u7c7b\u7684\u6784\u9020\u51fd\u6570\u4e2d\u521b\u5efa\uff0c\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u3002 public HeightMapMesh(float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { \u5b83\u63a5\u6536Y\u8f74\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\uff0c\u88ab\u7528\u4f5c\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf\u6587\u4ef6\u540d\u548c\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u6587\u4ef6\u540d\u3002\u5b83\u8fd8\u63a5\u53d7\u4e00\u4e2a\u540d\u4e3a textInc \u7684\u6574\u6570\uff0c\u8fd9\u7a0d\u540e\u518d\u8bf4\u660e\u3002 \u6211\u4eec\u5728\u6784\u9020\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5c06\u9ad8\u5ea6\u56fe\u56fe\u50cf\u52a0\u8f7d\u5230 BufferedImage \u5b9e\u4f8b\u4e2d\u3002 this.minY = minY; this.maxY = maxY; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); \u7136\u540e\uff0c\u6211\u4eec\u5c06\u7eb9\u7406\u6587\u4ef6\u8f7d\u5165\u5230\u4e00\u4e2a ByteBuffer \u4e2d\uff0c\u5e76\u8bbe\u7f6e\u6784\u9020 Mesh \u6240\u9700\u7684\u53d8\u91cf\u3002 incx \u548c incz \u53d8\u91cf\u5c06\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684X\u6216Z\u5750\u6807\u4e4b\u95f4\u7684\u6700\u5c0f\u95f4\u9694\uff0c\u56e0\u6b64 Mesh \u5305\u542b\u5728\u4e0a\u8ff0\u533a\u57df\u4e2d\u3002 Texture texture = new Texture(textureFile); float incx = getWidth() / (width - 1); float incz = Math.abs(STARTZ * 2) / (height - 1); List<Float> positions = new ArrayList(); List<Float> textCoords = new ArrayList(); List<Integer> indices = new ArrayList(); \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u904d\u5386\u56fe\u50cf\uff0c\u4e3a\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u8bbe\u7f6e\u5176\u7eb9\u7406\u5750\u6807\u4e0e\u7d22\u5f15\uff0c\u4ee5\u6b63\u786e\u5730\u5b9a\u4e49\u7ec4\u6210 Mesh \u7684\u4e09\u89d2\u5f62\u3002 for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { // \u4e3a\u5f53\u524d\u4f4d\u7f6e\u521b\u5efa\u9876\u70b9 positions.add(STARTX + col * incx); // x positions.add(getHeight(col, row, width, buf)); // y positions.add(STARTZ + row * incz); // z // \u8bbe\u7f6e\u7eb9\u7406\u5750\u6807 textCoords.add((float) textInc * (float) col / (float) width); textCoords.add((float) textInc * (float) row / (float) height); // \u521b\u5efa\u7d22\u5f15 if (col < width - 1 && row < height - 1) { int leftTop = row * width + col; int leftBottom = (row + 1) * width + col; int rightBottom = (row + 1) * width + col + 1; int rightTop = row * width + col + 1; indices.add(rightTop); indices.add(leftBottom); indices.add(leftTop); indices.add(rightBottom); indices.add(leftBottom); indices.add(rightTop); } } } \u521b\u5efa\u9876\u70b9\u5750\u6807\u7684\u8fc7\u7a0b\u662f\u4e0d\u9700\u8981\u89e3\u91ca\u7684\u3002\u73b0\u5728\u5148\u522b\u7ba1\u4e3a\u4ec0\u4e48\u6211\u4eec\u7528\u4e00\u4e2a\u6570\u5b57\u4e58\u4ee5\u7eb9\u7406\u5750\u6807\u4ee5\u53ca\u5982\u4f55\u8ba1\u7b97\u9ad8\u5ea6\u3002\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15(\u9664\u975e\u73b0\u5728\u662f\u6700\u540e\u4e00\u884c\u6216\u6700\u540e\u4e00\u5217)\u3002\u8ba9\u6211\u4eec\u7528\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u6765\u60f3\u8c61\u5b83\u4eec\u662f\u5982\u4f55\u6784\u9020\u7684\u3002\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u5305\u542b9\u4e2a\u9876\u70b9\uff0c\u6bcf\u56e0\u6b64\u6709 2\u00d74 \u4e2a\u4e09\u89d2\u5f62\u7ec4\u62104\u4e2a\u6b63\u65b9\u5f62\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u88ab\u547d\u540d\u4e3a Vrc (r\uff1a\u884c\uff0cc\uff1a\u5217)\u3002 \u5f53\u5904\u7406\u7b2c\u4e00\u4e2a\u9876\u70b9(V00)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002 \u5f53\u5904\u7406\u7b2c\u4e8c\u4e2a\u9876\u70b9(V01)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u53c8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002\u4f46\u5f53\u5904\u7406\u7b2c\u4e09\u4e2a\u9876\u70b9(V02)\u65f6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5b9a\u4e49\u66f4\u591a\u7684\u7d22\u5f15\uff0c\u8be5\u884c\u7684\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5df2\u88ab\u5b9a\u4e49\u3002 \u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u60f3\u5230\u5176\u4ed6\u9876\u70b9\u7684\u5904\u7406\u8fc7\u7a0b\u662f\u5982\u4f55\u8fdb\u884c\u7684\u3002\u73b0\u5728\uff0c\u4e00\u65e6\u521b\u5efa\u4e86\u6240\u6709\u7684\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u7528\u6240\u6709\u8fd9\u4e9b\u6570\u636e\u521b\u5efa Mesh \u548c\u76f8\u5173\u7684 Material \u3002 float[] posArr = Utils.listToArray(positions); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = calcNormals(posArr, width, height); this.mesh = new Mesh(posArr, textCoordsArr, normalsArr, indicesArr); Material material = new Material(texture, 0.0f); mesh.setMaterial(material); \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6839\u636e\u9876\u70b9\u4f4d\u7f6e\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5728\u770b\u5982\u4f55\u8ba1\u7b97\u6cd5\u7ebf\u4e4b\u524d\uff0c\u6765\u770b\u770b\u5982\u4f55\u83b7\u53d6\u9ad8\u5ea6\u5427\u3002\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a getHeight \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u8ba1\u7b97\u9876\u70b9\u7684\u9ad8\u5ea6\u3002 private float getHeight(int x, int z, int width, ByteBuffer buffer) { byte r = buffer.get(x * 4 + 0 + z * 4 * width); byte g = buffer.get(x * 4 + 1 + z * 4 * width); byte b = buffer.get(x * 4 + 2 + z * 4 * width); byte a = buffer.get(x * 4 + 3 + z * 4 * width); int argb = ((0xFF & a) << 24) | ((0xFF & r) << 16) | ((0xFF & g) << 8) | (0xFF & b); return this.minY + Math.abs(this.maxY - this.minY) * ((float) argb / (float) MAX_COLOUR); } \u8be5\u65b9\u6cd5\u63a5\u53d7\u50cf\u7d20\u7684X\u548cY\u5750\u6807\uff0c\u56fe\u50cf\u7684\u5bbd\u5ea6\u4ee5\u53ca\u4e0e\u4e4b\u76f8\u5173\u7684 ByteBuffer \uff0c\u8fd4\u56deRGB\u989c\u8272(R\u3001G\u3001B\u5206\u91cf\u4e4b\u548c)\u5e76\u8ba1\u7b97\u5305\u542b\u5728 minY \u548c maxY \u4e4b\u95f4\u7684\u503c( minY \u4e3a\u9ed1\u8272\uff0c maxY \u4e3a\u767d\u8272)\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528 BufferedImage \u6765\u7f16\u5199\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u5b83\u6709\u66f4\u65b9\u4fbf\u7684\u65b9\u6cd5\u6765\u83b7\u5f97RGB\u503c\uff0c\u4f46\u8fd9\u5c06\u4f7f\u7528AWT\u3002\u8bb0\u4f4fAWT\u4e0d\u80fd\u5f88\u597d\u7684\u517c\u5bb9OSX\uff0c\u6240\u4ee5\u5c3d\u91cf\u907f\u514d\u4f7f\u7528\u5b83\u7684\u7c7b\u3002 \u73b0\u5728\u6765\u770b\u770b\u5982\u4f55\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f\u5c06\u7eb9\u7406\u8986\u76d6\u6574\u4e2a\u7f51\u683c\uff0c\u5de6\u4e0a\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(0, 0)\uff0c\u53f3\u4e0b\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(1, 1)\u3002\u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u7eb9\u7406\u5fc5\u987b\u662f\u5de8\u5927\u7684\uff0c\u4ee5\u4fbf\u83b7\u5f97\u826f\u597d\u7684\u6e32\u67d3\u6548\u679c\uff0c\u5426\u5219\u7eb9\u7406\u5c06\u4f1a\u88ab\u8fc7\u5ea6\u62c9\u4f38\u3002 \u4f46\u6211\u4eec\u4ecd\u7136\u53ef\u4ee5\u4f7f\u7528\u975e\u5e38\u5c0f\u7684\u7eb9\u7406\uff0c\u901a\u8fc7\u4f7f\u7528\u9ad8\u6548\u7684\u6280\u672f\u6765\u83b7\u5f97\u5f88\u597d\u7684\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u8bbe\u7f6e\u8d85\u51fa[1, 1]\u8303\u56f4\u7684\u7eb9\u7406\u5750\u6807\uff0c\u6211\u4eec\u5c06\u56de\u5230\u539f\u70b9\u5e76\u91cd\u65b0\u5f00\u59cb\u8ba1\u7b97\u3002\u4e0b\u56fe\u8868\u793a\u5728\u51e0\u4e2a\u6b63\u65b9\u5f62\u4e2d\u5e73\u94fa\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u5e76\u8d85\u51fa\u4e86[1, 1]\u8303\u56f4\u3002 \u8fd9\u662f\u6211\u4eec\u5728\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\u65f6\u6240\u8981\u505a\u7684\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u53c2\u6570\u4e58\u4ee5\u7eb9\u7406\u5750\u6807(\u8ba1\u7b97\u597d\u50cf\u6574\u4e2a\u7f51\u683c\u88ab\u7eb9\u7406\u5305\u88f9\u7684\u60c5\u51b5)\uff0c\u5373 textInc \u53c2\u6570\uff0c\u4ee5\u589e\u52a0\u5728\u76f8\u90bb\u9876\u70b9\u4e4b\u95f4\u4f7f\u7528\u7684\u7eb9\u7406\u50cf\u7d20\u6570\u3002 \u76ee\u524d\u552f\u4e00\u6ca1\u6709\u89e3\u51b3\u7684\u662f\u6cd5\u7ebf\u8ba1\u7b97\u3002\u8bb0\u4f4f\u6211\u4eec\u9700\u8981\u6cd5\u7ebf\uff0c\u5149\u7167\u624d\u80fd\u6b63\u786e\u5730\u5e94\u7528\u4e8e\u5730\u5f62\u3002\u6ca1\u6709\u6cd5\u7ebf\uff0c\u65e0\u8bba\u5149\u7167\u5982\u4f55\uff0c\u5730\u5f62\u5c06\u4ee5\u76f8\u540c\u7684\u989c\u8272\u6e32\u67d3\u3002\u6211\u4eec\u5728\u8fd9\u91cc\u4f7f\u7528\u7684\u65b9\u6cd5\u4e0d\u4e00\u5b9a\u662f\u6700\u9ad8\u6548\u7684\uff0c\u4f46\u5b83\u5c06\u5e2e\u52a9\u4f60\u7406\u89e3\u5982\u4f55\u81ea\u52a8\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5982\u679c\u4f60\u641c\u7d22\u5176\u4ed6\u89e3\u51b3\u65b9\u6848\uff0c\u53ef\u80fd\u4f1a\u53d1\u73b0\u66f4\u6709\u6548\u7684\u65b9\u6cd5\uff0c\u53ea\u4f7f\u7528\u76f8\u90bb\u70b9\u7684\u9ad8\u5ea6\u800c\u4e0d\u9700\u8981\u505a\u4ea4\u53c9\u76f8\u4e58\u64cd\u4f5c\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u4ec5\u9700\u8981\u5728\u542f\u52a8\u65f6\u5b8c\u6210\uff0c\u8fd9\u91cc\u7684\u65b9\u6cd5\u4e0d\u4f1a\u5bf9\u6027\u80fd\u9020\u6210\u592a\u5927\u7684\u635f\u5bb3\u3002 \u8ba9\u6211\u4eec\u7528\u56fe\u89e3\u7684\u65b9\u5f0f\u89e3\u91ca\u5982\u4f55\u8ba1\u7b97\u4e00\u4e2a\u6cd5\u7ebf\u503c\u3002\u5047\u8bbe\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a P0 \u7684\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5176\u5468\u56f4\u6bcf\u4e2a\u9876\u70b9( P1 , P2 , P3 , P4 )\u548c\u4e0e\u8fde\u63a5\u8fd9\u4e9b\u70b9\u7684\u9762\u76f8\u5207\u7684\u5411\u91cf\u3002\u8fd9\u4e9b\u5411\u91cf( V1 , V2 , V3 , V4 )\u662f\u901a\u8fc7\u5c06\u6bcf\u4e2a\u76f8\u90bb\u70b9\u4e0e P0 \u76f8\u51cf(\u4f8b\u5982 V1 = P1 - P0 )\u5f97\u5230\u7684\u3002 \u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u8fde\u63a5\u6bcf\u4e00\u4e2a\u76f8\u90bb\u70b9\u7684\u5e73\u9762\u7684\u6cd5\u7ebf\u3002\u8fd9\u662f\u4e0e\u4e4b\u524d\u8ba1\u7b97\u5f97\u5230\u7684\u5411\u91cf\u4ea4\u53c9\u76f8\u4e58\u8ba1\u7b97\u7684\u3002\u4f8b\u5982\uff0c\u5411\u91cf V1 \u4e0e V2 \u6240\u5728\u7684\u5e73\u9762(\u84dd\u8272\u9634\u5f71\u90e8\u5206)\u7684\u6cd5\u7ebf\u662f\u7531 V1 \u548c V2 \u4ea4\u53c9\u76f8\u4e58\u5f97\u5230\u7684\uff0c\u5373 V12 = V1 \u00d7 V2 \u3002 \u5982\u679c\u6211\u4eec\u8ba1\u7b97\u5b8c\u6bd5\u5176\u4ed6\u5e73\u9762\u7684\u6cd5\u7ebf( V23 = V2 \u00d7 V3 \uff0c V34 = V3 \u00d7 V4 \uff0c V41 = V4 \u00d7 V1 )\uff0c\u5219\u6cd5\u7ebf P0 \u5c31\u662f\u5468\u56f4\u6240\u6709\u5e73\u9762\u6cd5\u7ebf(\u5f52\u4e00\u5316\u540e)\u4e4b\u548c\uff1a N0 = V12 + V23 + V34 + V41 \u3002 \u6cd5\u7ebf\u8ba1\u7b97\u7684\u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\u6240\u793a\u3002 private float[] calcNormals(float[] posArr, int width, int height) { Vector3f v0 = new Vector3f(); Vector3f v1 = new Vector3f(); Vector3f v2 = new Vector3f(); Vector3f v3 = new Vector3f(); Vector3f v4 = new Vector3f(); Vector3f v12 = new Vector3f(); Vector3f v23 = new Vector3f(); Vector3f v34 = new Vector3f(); Vector3f v41 = new Vector3f(); List<Float> normals = new ArrayList<>(); Vector3f normal = new Vector3f(); for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { if (row > 0 && row < height -1 && col > 0 && col < width -1) { int i0 = row*width*3 + col*3; v0.x = posArr[i0]; v0.y = posArr[i0 + 1]; v0.z = posArr[i0 + 2]; int i1 = row*width*3 + (col-1)*3; v1.x = posArr[i1]; v1.y = posArr[i1 + 1]; v1.z = posArr[i1 + 2]; v1 = v1.sub(v0); int i2 = (row+1)*width*3 + col*3; v2.x = posArr[i2]; v2.y = posArr[i2 + 1]; v2.z = posArr[i2 + 2]; v2 = v2.sub(v0); int i3 = (row)*width*3 + (col+1)*3; v3.x = posArr[i3]; v3.y = posArr[i3 + 1]; v3.z = posArr[i3 + 2]; v3 = v3.sub(v0); int i4 = (row-1)*width*3 + col*3; v4.x = posArr[i4]; v4.y = posArr[i4 + 1]; v4.z = posArr[i4 + 2]; v4 = v4.sub(v0); v1.cross(v2, v12); v12.normalize(); v2.cross(v3, v23); v23.normalize(); v3.cross(v4, v34); v34.normalize(); v4.cross(v1, v41); v41.normalize(); normal = v12.add(v23).add(v34).add(v41); normal.normalize(); } else { normal.x = 0; normal.y = 1; normal.z = 0; } normal.normalize(); normals.add(normal.x); normals.add(normal.y); normals.add(normal.z); } } return Utils.listToArray(normals); } \u6700\u540e\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u5730\u5f62\uff0c\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u62e9\uff1a * \u521b\u5efa\u66f4\u5927\u7684\u9ad8\u5ea6\u56fe * \u91cd\u7528\u9ad8\u5ea6\u56fe\u5e76\u5c06\u5176\u5e73\u94fa\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u9ad8\u5ea6\u56fe\u5c06\u50cf\u4e00\u4e2a\u5730\u5f62\u5757\uff0c\u5728\u4e16\u754c\u4e0a\u50cf\u74f7\u7816\u4e00\u6837\u5e73\u79fb\u3002\u4e3a\u4e86\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u9ad8\u5ea6\u56fe\u8fb9\u7f18\u7684\u50cf\u7d20\u5fc5\u987b\u662f\u76f8\u540c\u7684(\u5de6\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u53f3\u4fa7\u76f8\u540c\uff0c\u4e0a\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u4e0b\u4fa7\u76f8\u540c)\uff0c\u4ee5\u907f\u514d\u5757\u4e4b\u95f4\u7684\u95f4\u9699\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5(\u5e76\u9009\u62e9\u9002\u5f53\u7684\u9ad8\u5ea6\u56fe)\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Terrain \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u521b\u5efa\u4e00\u4e2a\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u56fe\u5757\uff0c\u5b9a\u4e49\u5982\u4e0b\u3002 package org.lwjglb.engine.items; import org.lwjglb.engine.graph.HeightMapMesh; public class Terrain { private final GameItem[] gameItems; public Terrain(int blocksPerRow, float scale, float minY, float maxY, String heightMap, String textureFile, int textInc) throws Exception { gameItems = new GameItem[blocksPerRow * blocksPerRow]; HeightMapMesh heightMapMesh = new HeightMapMesh(minY, maxY, heightMap, textureFile, textInc); for (int row = 0; row < blocksPerRow; row++) { for (int col = 0; col < blocksPerRow; col++) { float xDisplacement = (col - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * blocksPerRow + col] = terrainBlock; } } } public GameItem[] getGameItems() { return gameItems; } } \u8ba9\u6211\u4eec\u8be6\u89e3\u6574\u4e2a\u8fc7\u7a0b\uff0c\u6211\u4eec\u62e5\u6709\u7531\u4ee5\u4e0b\u5750\u6807\u5b9a\u4e49\u7684\u5757(X\u548cZ\u4f7f\u7528\u4e4b\u524d\u5b9a\u4e49\u7684\u5e38\u91cf)\u3002 \u5047\u8bbe\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u75313\u00d73\u5757\u7f51\u683c\u6784\u6210\u7684\u5730\u5f62\u3002\u6211\u4eec\u5047\u8bbe\u6211\u4eec\u4e0d\u4f1a\u7f29\u653e\u5730\u5f62\u5757(\u4e5f\u5c31\u662f\u8bf4\uff0c\u53d8\u91cf blocksPerRow \u662f 3 \u800c\u53d8\u91cf scale \u5c06\u4f1a\u662f 1 )\u3002\u6211\u4eec\u5e0c\u671b\u7f51\u683c\u7684\u4e2d\u592e\u5728\u5750\u6807\u7cfb\u7684(0, 0)\u3002 \u6211\u4eec\u9700\u8981\u79fb\u52a8\u5757\uff0c\u8fd9\u6837\u9876\u70b9\u5c31\u53d8\u6210\u5982\u4e0b\u5750\u6807\u3002 \u79fb\u52a8\u662f\u901a\u8fc7\u8c03\u7528 setPosition \u65b9\u6cd5\u5b9e\u73b0\u7684\uff0c\u4f46\u8bb0\u4f4f\uff0c\u6211\u4eec\u6240\u8bbe\u7f6e\u7684\u662f\u4e00\u4e2a\u4f4d\u79fb\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u5982\u679c\u4f60\u770b\u5230\u4e0a\u56fe\uff0c\u4f60\u4f1a\u53d1\u73b0\u4e2d\u592e\u5757\u4e0d\u9700\u8981\u4efb\u4f55\u79fb\u52a8\uff0c\u5b83\u5df2\u7ecf\u5b9a\u4f4d\u5728\u9002\u5f53\u7684\u5750\u6807\u4e0a\u3002\u7ed8\u5236\u7eff\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb -1 \uff0c\u800c\u7ed8\u5236\u84dd\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb +1 \u3002\u8ba1\u7b97X\u4f4d\u79fb\u7684\u516c\u5f0f\uff0c\u8981\u8003\u8651\u5230\u7f29\u653e\u548c\u5757\u7684\u5bbd\u5ea6\uff0c\u516c\u5f0f\u5982\u4e0b\uff1a xDisplacement=(col - (blocksPerRow -1 ) / 2) \\times scale \\times width Z\u4f4d\u79fb\u7684\u516c\u5f0f\u4e3a\uff1a zDisplacement=(row - (blocksPerRow -1 ) / 2) \\times scale \\times height \u5982\u679c\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a Terrain \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ef\u4ee5\u5f97\u5230\u5982\u56fe\u6240\u793a\u7684\u6548\u679c\u3002 \u4f60\u53ef\u4ee5\u5728\u5730\u5f62\u5468\u56f4\u79fb\u52a8\u76f8\u673a\uff0c\u770b\u770b\u5b83\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002\u7531\u4e8e\u8fd8\u6ca1\u6709\u5b9e\u73b0\u78b0\u649e\u68c0\u6d4b\uff0c\u4f60\u53ef\u4ee5\u7a7f\u8fc7\u5b83\u5e76\u4ece\u4e0a\u9762\u770b\u5b83\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u9762\u5254\u9664\uff0c\u5f53\u4ece\u4e0b\u9762\u89c2\u5bdf\u65f6\uff0c\u5730\u5f62\u7684\u67d0\u4e9b\u90e8\u5206\u4e0d\u4f1a\u6e32\u67d3\u3002","title":"\u9ad8\u5ea6\u56fe"},{"location":"14-height-maps/#height-maps","text":"\u672c\u7ae0\u4e2d\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u9ad8\u5ea6\u56fe\u521b\u5efa\u590d\u6742\u7684\u5730\u5f62\u3002\u5728\u5f00\u59cb\u524d\uff0c\u4f60\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u505a\u4e86\u4e00\u4e9b\u91cd\u6784\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e9b\u65b0\u7684\u5305\u548c\u79fb\u52a8\u4e86\u4e00\u4e9b\u7c7b\u4ee5\u66f4\u597d\u5730\u7ec4\u7ec7\u5b83\u4eec\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u8fd9\u4e9b\u6539\u53d8\u3002 \u6240\u4ee5\u4ec0\u4e48\u662f\u9ad8\u5ea6\u56fe\uff1f\u9ad8\u5ea6\u56fe\u662f\u7528\u4e8e\u751f\u6210\u4e09\u7ef4\u5730\u5f62\u7684\u56fe\u50cf\uff0c\u5b83\u4f7f\u7528\u50cf\u7d20\u989c\u8272\u6765\u83b7\u53d6\u8868\u9762\u9ad8\u5ea6\u3002\u9ad8\u5ea6\u56fe\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5b83\u53ef\u4ee5\u7531 Terragen \u7b49\u8f6f\u4ef6\u751f\u6210\u3002\u4e00\u5f20\u9ad8\u5ea6\u56fe\u56fe\u50cf\u770b\u8d77\u6765\u5c31\u50cf\u8fd9\u6837\u3002 \u4e0a\u56fe\u5c31\u50cf\u4f60\u4fef\u89c6\u4e00\u7247\u9646\u5730\u4e00\u6837\u3002\u5229\u7528\u4e0a\u56fe\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u7531\u9876\u70b9\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u6240\u7ec4\u6210\u7684\u7f51\u683c\u3002\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u5c06\u6839\u636e\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u3002\u9ed1\u8272\u662f\u6700\u4f4e\uff0c\u767d\u8272\u662f\u6700\u9ad8\u3002 \u6211\u4eec\u5c06\u4e3a\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u7ec4\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5c06\u7ec4\u6210\u4e09\u89d2\u5f62\uff0c\u8fd9\u4e9b\u4e09\u89d2\u5f62\u5c06\u7ec4\u6210\u4e0b\u56fe\u6240\u793a\u7684\u7f51\u683c\u3002 \u7f51\u683c\u5c06\u7ec4\u6210\u4e00\u4e2a\u5de8\u5927\u7684\u56db\u8fb9\u5f62\uff0c\u5b83\u5c06\u4f1a\u5728X\u548cZ\u8f74\u4e0a\u6e32\u67d3\uff0c\u5e76\u6839\u636e\u50cf\u7d20\u989c\u8272\u6765\u6539\u53d8\u5b83\u7684Y\u8f74\u9ad8\u5ea6\u3002 \u7531\u9ad8\u5ea6\u56fe\u521b\u5efa\u4e09\u7ef4\u5730\u5f62\u7684\u8fc7\u7a0b\u53ef\u6982\u62ec\u4e3a\u4ee5\u4e0b\u6b65\u9aa4\uff1a * \u52a0\u8f7d\u50a8\u5b58\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf(\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a BufferedImage \u5b9e\u4f8b\u4ee5\u83b7\u53d6\u6bcf\u4e2a\u50cf\u7d20)\u3002 * \u4e3a\u6bcf\u4e2a\u56fe\u50cf\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u5176\u9ad8\u5ea6\u57fa\u4e8e\u50cf\u7d20\u989c\u8272\u3002 * \u5c06\u6b63\u786e\u7684\u7eb9\u7406\u5750\u6807\u5206\u914d\u7ed9\u9876\u70b9\u3002 * \u8bbe\u7f6e\u7d22\u5f15\u4ee5\u7ed8\u5236\u4e0e\u9876\u70b9\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a HeightMapMesh \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u6309\u4ee5\u4e0a\u6b65\u9aa4\u521b\u5efa\u4e00\u4e2a Mesh \u3002\u8ba9\u6211\u4eec\u5148\u770b\u770b\u8be5\u7c7b\u5b9a\u4e49\u7684\u5e38\u91cf\uff1a private static final int MAX_COLOUR = 255 * 255 * 255; \u5982\u4e0a\u6240\u8ff0\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u9ad8\u5ea6\u56fe\u56fe\u50cf\u7684\u6bcf\u4e2a\u50cf\u7d20\u7684\u989c\u8272\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u3002\u56fe\u50cf\u901a\u5e38\u662f\u7070\u5ea6\u56fe\uff0c\u5bf9\u4e8ePNG\u56fe\u50cf\u6765\u8bf4\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u50cf\u7d20\u7684\u6bcf\u4e2aRGB\u503c\u53ef\u4ee5\u57280\u5230255\u4e4b\u95f4\u53d8\u5316\uff0c\u56e0\u6b64\u6211\u4eec\u6709256\u4e2a\u503c\u6765\u8868\u793a\u4e0d\u540c\u7684\u9ad8\u5ea6\u3002\u8fd9\u53ef\u80fd\u8db3\u591f\u4e86\uff0c\u4f46\u5982\u679c\u7cbe\u5ea6\u4e0d\u591f\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e09\u4e2aRGB\u503c\u4ee5\u6709\u66f4\u591a\u7684\u503c\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u9ad8\u5ea6\u8ba1\u7b97\u8303\u56f4\u4e3a0\u5230255^3\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u5c40\u9650\u4e8e\u7070\u5ea6\u56fe\u3002 \u63a5\u4e0b\u6765\u7684\u5e38\u91cf\u662f\uff1a private static final float STARTX = -0.5f; private static final float STARTZ = -0.5f; \u7f51\u683c\u5c06\u7531\u4e00\u7ec4\u9876\u70b9\uff08\u4e00\u4e2a\u9876\u70b9\u5bf9\u5e94\u4e00\u4e2a\u50cf\u7d20\uff09\u6784\u6210\uff0c\u5176X\u548cZ\u5750\u6807\u7684\u8303\u56f4\u5982\u4e0b * X\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTX , -STARTX ]\u3002 * Z\u8f74\u7684\u8303\u56f4\u4e3a[-0.5, 0.5]\uff0c\u5373[ STARTZ , -STARTZ ]\u3002 \u4e0d\u7528\u592a\u8fc7\u62c5\u5fc3\u8fd9\u4e9b\u503c\uff0c\u7a0d\u540e\u5f97\u5230\u7684\u7f51\u683c\u53ef\u4ee5\u88ab\u7f29\u653e\u4ee5\u9002\u5e94\u4e16\u754c\u7684\u5927\u5c0f\u3002\u5173\u4e8eY\u8f74\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e minY \u548c maxY \u4e24\u4e2a\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6eY\u5750\u6807\u7684\u6700\u4f4e\u548c\u6700\u9ad8\u503c\u3002\u8fd9\u4e9b\u53c2\u6570\u5e76\u4e0d\u662f\u5e38\u6570\uff0c\u56e0\u4e3a\u6211\u4eec\u53ef\u80fd\u5e0c\u671b\u5728\u8fd0\u884c\u65f6\u66f4\u6539\u5b83\u4eec\uff0c\u800c\u4e0d\u4f7f\u7528\u7f29\u653e\u3002\u6700\u540e\uff0c\u5730\u5f62\u5c06\u5305\u542b\u5728\u8303\u56f4\u4e3a [STARTX, -STARTX] \uff0c [minY, maxY] \uff0c [STARTZ, -STARTZ] \u7684\u7acb\u65b9\u4f53\u5185\u3002 \u7f51\u683c\u5c06\u4f1a\u5728 HeightMapMesh \u7c7b\u7684\u6784\u9020\u51fd\u6570\u4e2d\u521b\u5efa\uff0c\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u3002 public HeightMapMesh(float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { \u5b83\u63a5\u6536Y\u8f74\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\uff0c\u88ab\u7528\u4f5c\u9ad8\u5ea6\u56fe\u7684\u56fe\u50cf\u6587\u4ef6\u540d\u548c\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u6587\u4ef6\u540d\u3002\u5b83\u8fd8\u63a5\u53d7\u4e00\u4e2a\u540d\u4e3a textInc \u7684\u6574\u6570\uff0c\u8fd9\u7a0d\u540e\u518d\u8bf4\u660e\u3002 \u6211\u4eec\u5728\u6784\u9020\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5c06\u9ad8\u5ea6\u56fe\u56fe\u50cf\u52a0\u8f7d\u5230 BufferedImage \u5b9e\u4f8b\u4e2d\u3002 this.minY = minY; this.maxY = maxY; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); \u7136\u540e\uff0c\u6211\u4eec\u5c06\u7eb9\u7406\u6587\u4ef6\u8f7d\u5165\u5230\u4e00\u4e2a ByteBuffer \u4e2d\uff0c\u5e76\u8bbe\u7f6e\u6784\u9020 Mesh \u6240\u9700\u7684\u53d8\u91cf\u3002 incx \u548c incz \u53d8\u91cf\u5c06\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684X\u6216Z\u5750\u6807\u4e4b\u95f4\u7684\u6700\u5c0f\u95f4\u9694\uff0c\u56e0\u6b64 Mesh \u5305\u542b\u5728\u4e0a\u8ff0\u533a\u57df\u4e2d\u3002 Texture texture = new Texture(textureFile); float incx = getWidth() / (width - 1); float incz = Math.abs(STARTZ * 2) / (height - 1); List<Float> positions = new ArrayList(); List<Float> textCoords = new ArrayList(); List<Integer> indices = new ArrayList(); \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u904d\u5386\u56fe\u50cf\uff0c\u4e3a\u6bcf\u4e2a\u50cf\u7d20\u521b\u5efa\u4e00\u4e2a\u9876\u70b9\uff0c\u8bbe\u7f6e\u5176\u7eb9\u7406\u5750\u6807\u4e0e\u7d22\u5f15\uff0c\u4ee5\u6b63\u786e\u5730\u5b9a\u4e49\u7ec4\u6210 Mesh \u7684\u4e09\u89d2\u5f62\u3002 for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { // \u4e3a\u5f53\u524d\u4f4d\u7f6e\u521b\u5efa\u9876\u70b9 positions.add(STARTX + col * incx); // x positions.add(getHeight(col, row, width, buf)); // y positions.add(STARTZ + row * incz); // z // \u8bbe\u7f6e\u7eb9\u7406\u5750\u6807 textCoords.add((float) textInc * (float) col / (float) width); textCoords.add((float) textInc * (float) row / (float) height); // \u521b\u5efa\u7d22\u5f15 if (col < width - 1 && row < height - 1) { int leftTop = row * width + col; int leftBottom = (row + 1) * width + col; int rightBottom = (row + 1) * width + col + 1; int rightTop = row * width + col + 1; indices.add(rightTop); indices.add(leftBottom); indices.add(leftTop); indices.add(rightBottom); indices.add(leftBottom); indices.add(rightTop); } } } \u521b\u5efa\u9876\u70b9\u5750\u6807\u7684\u8fc7\u7a0b\u662f\u4e0d\u9700\u8981\u89e3\u91ca\u7684\u3002\u73b0\u5728\u5148\u522b\u7ba1\u4e3a\u4ec0\u4e48\u6211\u4eec\u7528\u4e00\u4e2a\u6570\u5b57\u4e58\u4ee5\u7eb9\u7406\u5750\u6807\u4ee5\u53ca\u5982\u4f55\u8ba1\u7b97\u9ad8\u5ea6\u3002\u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u5b9a\u4e49\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15(\u9664\u975e\u73b0\u5728\u662f\u6700\u540e\u4e00\u884c\u6216\u6700\u540e\u4e00\u5217)\u3002\u8ba9\u6211\u4eec\u7528\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u6765\u60f3\u8c61\u5b83\u4eec\u662f\u5982\u4f55\u6784\u9020\u7684\u3002\u4e00\u4e2a 3\u00d73 \u7684\u56fe\u50cf\u5305\u542b9\u4e2a\u9876\u70b9\uff0c\u6bcf\u56e0\u6b64\u6709 2\u00d74 \u4e2a\u4e09\u89d2\u5f62\u7ec4\u62104\u4e2a\u6b63\u65b9\u5f62\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u88ab\u547d\u540d\u4e3a Vrc (r\uff1a\u884c\uff0cc\uff1a\u5217)\u3002 \u5f53\u5904\u7406\u7b2c\u4e00\u4e2a\u9876\u70b9(V00)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002 \u5f53\u5904\u7406\u7b2c\u4e8c\u4e2a\u9876\u70b9(V01)\u65f6\uff0c\u6211\u4eec\u5728\u7ea2\u8272\u9634\u5f71\u5904\u53c8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u7d22\u5f15\u3002\u4f46\u5f53\u5904\u7406\u7b2c\u4e09\u4e2a\u9876\u70b9(V02)\u65f6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5b9a\u4e49\u66f4\u591a\u7684\u7d22\u5f15\uff0c\u8be5\u884c\u7684\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5df2\u88ab\u5b9a\u4e49\u3002 \u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u60f3\u5230\u5176\u4ed6\u9876\u70b9\u7684\u5904\u7406\u8fc7\u7a0b\u662f\u5982\u4f55\u8fdb\u884c\u7684\u3002\u73b0\u5728\uff0c\u4e00\u65e6\u521b\u5efa\u4e86\u6240\u6709\u7684\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u7528\u6240\u6709\u8fd9\u4e9b\u6570\u636e\u521b\u5efa Mesh \u548c\u76f8\u5173\u7684 Material \u3002 float[] posArr = Utils.listToArray(positions); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = calcNormals(posArr, width, height); this.mesh = new Mesh(posArr, textCoordsArr, normalsArr, indicesArr); Material material = new Material(texture, 0.0f); mesh.setMaterial(material); \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6839\u636e\u9876\u70b9\u4f4d\u7f6e\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5728\u770b\u5982\u4f55\u8ba1\u7b97\u6cd5\u7ebf\u4e4b\u524d\uff0c\u6765\u770b\u770b\u5982\u4f55\u83b7\u53d6\u9ad8\u5ea6\u5427\u3002\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a getHeight \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u8ba1\u7b97\u9876\u70b9\u7684\u9ad8\u5ea6\u3002 private float getHeight(int x, int z, int width, ByteBuffer buffer) { byte r = buffer.get(x * 4 + 0 + z * 4 * width); byte g = buffer.get(x * 4 + 1 + z * 4 * width); byte b = buffer.get(x * 4 + 2 + z * 4 * width); byte a = buffer.get(x * 4 + 3 + z * 4 * width); int argb = ((0xFF & a) << 24) | ((0xFF & r) << 16) | ((0xFF & g) << 8) | (0xFF & b); return this.minY + Math.abs(this.maxY - this.minY) * ((float) argb / (float) MAX_COLOUR); } \u8be5\u65b9\u6cd5\u63a5\u53d7\u50cf\u7d20\u7684X\u548cY\u5750\u6807\uff0c\u56fe\u50cf\u7684\u5bbd\u5ea6\u4ee5\u53ca\u4e0e\u4e4b\u76f8\u5173\u7684 ByteBuffer \uff0c\u8fd4\u56deRGB\u989c\u8272(R\u3001G\u3001B\u5206\u91cf\u4e4b\u548c)\u5e76\u8ba1\u7b97\u5305\u542b\u5728 minY \u548c maxY \u4e4b\u95f4\u7684\u503c( minY \u4e3a\u9ed1\u8272\uff0c maxY \u4e3a\u767d\u8272)\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528 BufferedImage \u6765\u7f16\u5199\u4e00\u4e2a\u66f4\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u5b83\u6709\u66f4\u65b9\u4fbf\u7684\u65b9\u6cd5\u6765\u83b7\u5f97RGB\u503c\uff0c\u4f46\u8fd9\u5c06\u4f7f\u7528AWT\u3002\u8bb0\u4f4fAWT\u4e0d\u80fd\u5f88\u597d\u7684\u517c\u5bb9OSX\uff0c\u6240\u4ee5\u5c3d\u91cf\u907f\u514d\u4f7f\u7528\u5b83\u7684\u7c7b\u3002 \u73b0\u5728\u6765\u770b\u770b\u5982\u4f55\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f\u5c06\u7eb9\u7406\u8986\u76d6\u6574\u4e2a\u7f51\u683c\uff0c\u5de6\u4e0a\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(0, 0)\uff0c\u53f3\u4e0b\u89d2\u7684\u9876\u70b9\u7eb9\u7406\u5750\u6807\u4e3a(1, 1)\u3002\u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u7eb9\u7406\u5fc5\u987b\u662f\u5de8\u5927\u7684\uff0c\u4ee5\u4fbf\u83b7\u5f97\u826f\u597d\u7684\u6e32\u67d3\u6548\u679c\uff0c\u5426\u5219\u7eb9\u7406\u5c06\u4f1a\u88ab\u8fc7\u5ea6\u62c9\u4f38\u3002 \u4f46\u6211\u4eec\u4ecd\u7136\u53ef\u4ee5\u4f7f\u7528\u975e\u5e38\u5c0f\u7684\u7eb9\u7406\uff0c\u901a\u8fc7\u4f7f\u7528\u9ad8\u6548\u7684\u6280\u672f\u6765\u83b7\u5f97\u5f88\u597d\u7684\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u8bbe\u7f6e\u8d85\u51fa[1, 1]\u8303\u56f4\u7684\u7eb9\u7406\u5750\u6807\uff0c\u6211\u4eec\u5c06\u56de\u5230\u539f\u70b9\u5e76\u91cd\u65b0\u5f00\u59cb\u8ba1\u7b97\u3002\u4e0b\u56fe\u8868\u793a\u5728\u51e0\u4e2a\u6b63\u65b9\u5f62\u4e2d\u5e73\u94fa\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u5e76\u8d85\u51fa\u4e86[1, 1]\u8303\u56f4\u3002 \u8fd9\u662f\u6211\u4eec\u5728\u8bbe\u7f6e\u7eb9\u7406\u5750\u6807\u65f6\u6240\u8981\u505a\u7684\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u53c2\u6570\u4e58\u4ee5\u7eb9\u7406\u5750\u6807(\u8ba1\u7b97\u597d\u50cf\u6574\u4e2a\u7f51\u683c\u88ab\u7eb9\u7406\u5305\u88f9\u7684\u60c5\u51b5)\uff0c\u5373 textInc \u53c2\u6570\uff0c\u4ee5\u589e\u52a0\u5728\u76f8\u90bb\u9876\u70b9\u4e4b\u95f4\u4f7f\u7528\u7684\u7eb9\u7406\u50cf\u7d20\u6570\u3002 \u76ee\u524d\u552f\u4e00\u6ca1\u6709\u89e3\u51b3\u7684\u662f\u6cd5\u7ebf\u8ba1\u7b97\u3002\u8bb0\u4f4f\u6211\u4eec\u9700\u8981\u6cd5\u7ebf\uff0c\u5149\u7167\u624d\u80fd\u6b63\u786e\u5730\u5e94\u7528\u4e8e\u5730\u5f62\u3002\u6ca1\u6709\u6cd5\u7ebf\uff0c\u65e0\u8bba\u5149\u7167\u5982\u4f55\uff0c\u5730\u5f62\u5c06\u4ee5\u76f8\u540c\u7684\u989c\u8272\u6e32\u67d3\u3002\u6211\u4eec\u5728\u8fd9\u91cc\u4f7f\u7528\u7684\u65b9\u6cd5\u4e0d\u4e00\u5b9a\u662f\u6700\u9ad8\u6548\u7684\uff0c\u4f46\u5b83\u5c06\u5e2e\u52a9\u4f60\u7406\u89e3\u5982\u4f55\u81ea\u52a8\u8ba1\u7b97\u6cd5\u7ebf\u3002\u5982\u679c\u4f60\u641c\u7d22\u5176\u4ed6\u89e3\u51b3\u65b9\u6848\uff0c\u53ef\u80fd\u4f1a\u53d1\u73b0\u66f4\u6709\u6548\u7684\u65b9\u6cd5\uff0c\u53ea\u4f7f\u7528\u76f8\u90bb\u70b9\u7684\u9ad8\u5ea6\u800c\u4e0d\u9700\u8981\u505a\u4ea4\u53c9\u76f8\u4e58\u64cd\u4f5c\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u4ec5\u9700\u8981\u5728\u542f\u52a8\u65f6\u5b8c\u6210\uff0c\u8fd9\u91cc\u7684\u65b9\u6cd5\u4e0d\u4f1a\u5bf9\u6027\u80fd\u9020\u6210\u592a\u5927\u7684\u635f\u5bb3\u3002 \u8ba9\u6211\u4eec\u7528\u56fe\u89e3\u7684\u65b9\u5f0f\u89e3\u91ca\u5982\u4f55\u8ba1\u7b97\u4e00\u4e2a\u6cd5\u7ebf\u503c\u3002\u5047\u8bbe\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a P0 \u7684\u9876\u70b9\u3002\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5176\u5468\u56f4\u6bcf\u4e2a\u9876\u70b9( P1 , P2 , P3 , P4 )\u548c\u4e0e\u8fde\u63a5\u8fd9\u4e9b\u70b9\u7684\u9762\u76f8\u5207\u7684\u5411\u91cf\u3002\u8fd9\u4e9b\u5411\u91cf( V1 , V2 , V3 , V4 )\u662f\u901a\u8fc7\u5c06\u6bcf\u4e2a\u76f8\u90bb\u70b9\u4e0e P0 \u76f8\u51cf(\u4f8b\u5982 V1 = P1 - P0 )\u5f97\u5230\u7684\u3002 \u7136\u540e\uff0c\u6211\u4eec\u8ba1\u7b97\u8fde\u63a5\u6bcf\u4e00\u4e2a\u76f8\u90bb\u70b9\u7684\u5e73\u9762\u7684\u6cd5\u7ebf\u3002\u8fd9\u662f\u4e0e\u4e4b\u524d\u8ba1\u7b97\u5f97\u5230\u7684\u5411\u91cf\u4ea4\u53c9\u76f8\u4e58\u8ba1\u7b97\u7684\u3002\u4f8b\u5982\uff0c\u5411\u91cf V1 \u4e0e V2 \u6240\u5728\u7684\u5e73\u9762(\u84dd\u8272\u9634\u5f71\u90e8\u5206)\u7684\u6cd5\u7ebf\u662f\u7531 V1 \u548c V2 \u4ea4\u53c9\u76f8\u4e58\u5f97\u5230\u7684\uff0c\u5373 V12 = V1 \u00d7 V2 \u3002 \u5982\u679c\u6211\u4eec\u8ba1\u7b97\u5b8c\u6bd5\u5176\u4ed6\u5e73\u9762\u7684\u6cd5\u7ebf( V23 = V2 \u00d7 V3 \uff0c V34 = V3 \u00d7 V4 \uff0c V41 = V4 \u00d7 V1 )\uff0c\u5219\u6cd5\u7ebf P0 \u5c31\u662f\u5468\u56f4\u6240\u6709\u5e73\u9762\u6cd5\u7ebf(\u5f52\u4e00\u5316\u540e)\u4e4b\u548c\uff1a N0 = V12 + V23 + V34 + V41 \u3002 \u6cd5\u7ebf\u8ba1\u7b97\u7684\u65b9\u6cd5\u5b9e\u73b0\u5982\u4e0b\u6240\u793a\u3002 private float[] calcNormals(float[] posArr, int width, int height) { Vector3f v0 = new Vector3f(); Vector3f v1 = new Vector3f(); Vector3f v2 = new Vector3f(); Vector3f v3 = new Vector3f(); Vector3f v4 = new Vector3f(); Vector3f v12 = new Vector3f(); Vector3f v23 = new Vector3f(); Vector3f v34 = new Vector3f(); Vector3f v41 = new Vector3f(); List<Float> normals = new ArrayList<>(); Vector3f normal = new Vector3f(); for (int row = 0; row < height; row++) { for (int col = 0; col < width; col++) { if (row > 0 && row < height -1 && col > 0 && col < width -1) { int i0 = row*width*3 + col*3; v0.x = posArr[i0]; v0.y = posArr[i0 + 1]; v0.z = posArr[i0 + 2]; int i1 = row*width*3 + (col-1)*3; v1.x = posArr[i1]; v1.y = posArr[i1 + 1]; v1.z = posArr[i1 + 2]; v1 = v1.sub(v0); int i2 = (row+1)*width*3 + col*3; v2.x = posArr[i2]; v2.y = posArr[i2 + 1]; v2.z = posArr[i2 + 2]; v2 = v2.sub(v0); int i3 = (row)*width*3 + (col+1)*3; v3.x = posArr[i3]; v3.y = posArr[i3 + 1]; v3.z = posArr[i3 + 2]; v3 = v3.sub(v0); int i4 = (row-1)*width*3 + col*3; v4.x = posArr[i4]; v4.y = posArr[i4 + 1]; v4.z = posArr[i4 + 2]; v4 = v4.sub(v0); v1.cross(v2, v12); v12.normalize(); v2.cross(v3, v23); v23.normalize(); v3.cross(v4, v34); v34.normalize(); v4.cross(v1, v41); v41.normalize(); normal = v12.add(v23).add(v34).add(v41); normal.normalize(); } else { normal.x = 0; normal.y = 1; normal.z = 0; } normal.normalize(); normals.add(normal.x); normals.add(normal.y); normals.add(normal.z); } } return Utils.listToArray(normals); } \u6700\u540e\uff0c\u4e3a\u4e86\u521b\u5efa\u66f4\u5927\u7684\u5730\u5f62\uff0c\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u62e9\uff1a * \u521b\u5efa\u66f4\u5927\u7684\u9ad8\u5ea6\u56fe * \u91cd\u7528\u9ad8\u5ea6\u56fe\u5e76\u5c06\u5176\u5e73\u94fa\u5728\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u3002\u9ad8\u5ea6\u56fe\u5c06\u50cf\u4e00\u4e2a\u5730\u5f62\u5757\uff0c\u5728\u4e16\u754c\u4e0a\u50cf\u74f7\u7816\u4e00\u6837\u5e73\u79fb\u3002\u4e3a\u4e86\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u9ad8\u5ea6\u56fe\u8fb9\u7f18\u7684\u50cf\u7d20\u5fc5\u987b\u662f\u76f8\u540c\u7684(\u5de6\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u53f3\u4fa7\u76f8\u540c\uff0c\u4e0a\u4fa7\u8fb9\u7f18\u5fc5\u987b\u4e0e\u4e0b\u4fa7\u76f8\u540c)\uff0c\u4ee5\u907f\u514d\u5757\u4e4b\u95f4\u7684\u95f4\u9699\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u7b2c\u4e8c\u79cd\u65b9\u6cd5(\u5e76\u9009\u62e9\u9002\u5f53\u7684\u9ad8\u5ea6\u56fe)\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Terrain \u7684\u7c7b\uff0c\u8be5\u7c7b\u5c06\u521b\u5efa\u4e00\u4e2a\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u56fe\u5757\uff0c\u5b9a\u4e49\u5982\u4e0b\u3002 package org.lwjglb.engine.items; import org.lwjglb.engine.graph.HeightMapMesh; public class Terrain { private final GameItem[] gameItems; public Terrain(int blocksPerRow, float scale, float minY, float maxY, String heightMap, String textureFile, int textInc) throws Exception { gameItems = new GameItem[blocksPerRow * blocksPerRow]; HeightMapMesh heightMapMesh = new HeightMapMesh(minY, maxY, heightMap, textureFile, textInc); for (int row = 0; row < blocksPerRow; row++) { for (int col = 0; col < blocksPerRow; col++) { float xDisplacement = (col - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) blocksPerRow - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * blocksPerRow + col] = terrainBlock; } } } public GameItem[] getGameItems() { return gameItems; } } \u8ba9\u6211\u4eec\u8be6\u89e3\u6574\u4e2a\u8fc7\u7a0b\uff0c\u6211\u4eec\u62e5\u6709\u7531\u4ee5\u4e0b\u5750\u6807\u5b9a\u4e49\u7684\u5757(X\u548cZ\u4f7f\u7528\u4e4b\u524d\u5b9a\u4e49\u7684\u5e38\u91cf)\u3002 \u5047\u8bbe\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u75313\u00d73\u5757\u7f51\u683c\u6784\u6210\u7684\u5730\u5f62\u3002\u6211\u4eec\u5047\u8bbe\u6211\u4eec\u4e0d\u4f1a\u7f29\u653e\u5730\u5f62\u5757(\u4e5f\u5c31\u662f\u8bf4\uff0c\u53d8\u91cf blocksPerRow \u662f 3 \u800c\u53d8\u91cf scale \u5c06\u4f1a\u662f 1 )\u3002\u6211\u4eec\u5e0c\u671b\u7f51\u683c\u7684\u4e2d\u592e\u5728\u5750\u6807\u7cfb\u7684(0, 0)\u3002 \u6211\u4eec\u9700\u8981\u79fb\u52a8\u5757\uff0c\u8fd9\u6837\u9876\u70b9\u5c31\u53d8\u6210\u5982\u4e0b\u5750\u6807\u3002 \u79fb\u52a8\u662f\u901a\u8fc7\u8c03\u7528 setPosition \u65b9\u6cd5\u5b9e\u73b0\u7684\uff0c\u4f46\u8bb0\u4f4f\uff0c\u6211\u4eec\u6240\u8bbe\u7f6e\u7684\u662f\u4e00\u4e2a\u4f4d\u79fb\u800c\u4e0d\u662f\u4e00\u4e2a\u4f4d\u7f6e\u3002\u5982\u679c\u4f60\u770b\u5230\u4e0a\u56fe\uff0c\u4f60\u4f1a\u53d1\u73b0\u4e2d\u592e\u5757\u4e0d\u9700\u8981\u4efb\u4f55\u79fb\u52a8\uff0c\u5b83\u5df2\u7ecf\u5b9a\u4f4d\u5728\u9002\u5f53\u7684\u5750\u6807\u4e0a\u3002\u7ed8\u5236\u7eff\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb -1 \uff0c\u800c\u7ed8\u5236\u84dd\u8272\u9876\u70b9\u9700\u8981\u5728X\u8f74\u4e0a\u4f4d\u79fb +1 \u3002\u8ba1\u7b97X\u4f4d\u79fb\u7684\u516c\u5f0f\uff0c\u8981\u8003\u8651\u5230\u7f29\u653e\u548c\u5757\u7684\u5bbd\u5ea6\uff0c\u516c\u5f0f\u5982\u4e0b\uff1a xDisplacement=(col - (blocksPerRow -1 ) / 2) \\times scale \\times width Z\u4f4d\u79fb\u7684\u516c\u5f0f\u4e3a\uff1a zDisplacement=(row - (blocksPerRow -1 ) / 2) \\times scale \\times height \u5982\u679c\u5728 DummyGame \u7c7b\u4e2d\u521b\u5efa\u4e00\u4e2a Terrain \u5b9e\u4f8b\uff0c\u6211\u4eec\u53ef\u4ee5\u5f97\u5230\u5982\u56fe\u6240\u793a\u7684\u6548\u679c\u3002 \u4f60\u53ef\u4ee5\u5728\u5730\u5f62\u5468\u56f4\u79fb\u52a8\u76f8\u673a\uff0c\u770b\u770b\u5b83\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002\u7531\u4e8e\u8fd8\u6ca1\u6709\u5b9e\u73b0\u78b0\u649e\u68c0\u6d4b\uff0c\u4f60\u53ef\u4ee5\u7a7f\u8fc7\u5b83\u5e76\u4ece\u4e0a\u9762\u770b\u5b83\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u9762\u5254\u9664\uff0c\u5f53\u4ece\u4e0b\u9762\u89c2\u5bdf\u65f6\uff0c\u5730\u5f62\u7684\u67d0\u4e9b\u90e8\u5206\u4e0d\u4f1a\u6e32\u67d3\u3002","title":"\u9ad8\u5ea6\u56fe\uff08Height Maps\uff09"},{"location":"15-terrain-collisions/","text":"\u5730\u5f62\u78b0\u649e\uff08Terrain Collisions\uff09 \u6b64\u524d\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u5730\u5f62\uff0c\u63a5\u4e0b\u6765\u5c31\u662f\u68c0\u6d4b\u78b0\u649e\u4ee5\u907f\u514d\u7a7f\u8fc7\u5b83\u3002\u56de\u5fc6\u4e00\u4e0b\u4e4b\u524d\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u5730\u5f62\u662f\u7531\u5730\u5f62\u5757\u7ec4\u6210\u7684\uff0c\u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u9ad8\u5ea6\u56fe\u751f\u6210\u7684\uff0c\u9ad8\u5ea6\u56fe\u7528\u4e8e\u8bbe\u7f6e\u6784\u6210\u5730\u5f62\u7684\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u9ad8\u5ea6\u3002 \u4e3a\u4e86\u68c0\u6d4b\u78b0\u649e\uff0c\u6211\u4eec\u5fc5\u987b\u5c06\u5f53\u524d\u6240\u5728\u4f4d\u7f6e\u7684 Y \u503c\u4e0e\u5f53\u524d\u5730\u5f62\u70b9\u7684 Y \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u6709\u78b0\u649e\uff0c\u6211\u4eec\u9700\u8981\u56de\u5230\u5730\u5f62\u4e0a\u65b9\u3002\u5f88\u7b80\u5355\u7684\u60f3\u6cd5\uff0c\u662f\u5417\uff1f\u786e\u5b9e\u662f\u8fd9\u6837\uff0c\u4f46\u5728\u6bd4\u8f83\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u51e0\u6b21\u8ba1\u7b97\u3002 \u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u6982\u5ff5\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u201c\u73a9\u5bb6\u201d\u7684\u6982\u5ff5\uff0c\u5f53\u524d\u4f4d\u7f6e\u5c06\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002\u8fd9\u6837\u6211\u4eec\u5c31\u6709\u4e86\u6bd4\u8f83\u7684\u4e00\u65b9\uff0c\u56e0\u6b64\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u5730\u5f62\u7531\u5730\u5f62\u5757\u7ec4\u6210\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u76f8\u540c\u7684\u9ad8\u5ea6\u56fe\u7f51\u683c\u6784\u6210\uff0c\u4f46\u88ab\u7cbe\u786e\u5730\u7f29\u653e\u548c\u4f4d\u79fb\uff0c\u4ee5\u5f62\u6210\u770b\u8d77\u6765\u50cf\u662f\u8fde\u7eed\u7684\u666f\u89c2\u7684\u5730\u5f62\u7f51\u683c\u3002 \u6240\u4ee5\u9996\u5148\u8981\u505a\u7684\u662f\u786e\u5b9a\u5f53\u524d\u4f4d\u7f6e(\u6444\u50cf\u673a\u4f4d\u7f6e)\u5728\u54ea\u4e2a\u5730\u5f62\u5757\u3002\u4e3a\u4e86\u5f97\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4f4d\u79fb\u548c\u7f29\u653e\u6765\u8ba1\u7b97\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2( BoundingBox )\u3002\u56e0\u4e3a\u5730\u5f62\u5728\u8fd0\u884c\u65f6\u4e0d\u4f1a\u79fb\u52a8\u6216\u7f29\u653e\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\u3002\u8fd9\u6837\u5c31\u53ef\u4ee5\u5728\u4efb\u4f55\u65f6\u5019\u8bbf\u95ee\u5b83\u4eec\uff0c\u800c\u4e0d\u9700\u8981\u5728\u6bcf\u4e2a\u6e38\u620f\u5faa\u73af\u5468\u671f\u4e2d\u91cd\u590d\u8fd9\u4e9b\u8ba1\u7b97\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u4e00\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u540d\u4e3a getBoundingBox \u3002 private Box2D getBoundingBox(GameItem terrainBlock) { float scale = terrainBlock.getScale(); Vector3f position = terrainBlock.getPosition(); float topLeftX = HeightMapMesh.STARTX * scale + position.x; float topLeftZ = HeightMapMesh.STARTZ * scale + position.z; float width = Math.abs(HeightMapMesh.STARTX * 2) * scale; float height = Math.abs(HeightMapMesh.STARTZ * 2) * scale; Box2D boundingBox = new Box2D(topLeftX, topLeftZ, width, height); return boundingBox; } Box2D \u662f java.awt.Rectangle2D.Float \u7c7b\u7684\u7b80\u5316\u7248\u672c\uff0c\u4e3a\u4e86\u907f\u514d\u4f7f\u7528AWT\u800c\u521b\u5efa\u3002 \u9650\u5236\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5730\u5f62\u5757\u7684\u4e16\u754c\u5750\u6807\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u4f60\u770b\u5230\u6240\u6709\u7684\u5730\u5f62\u7f51\u683c\u90fd\u662f\u5728\u4e00\u4e2a\u6b63\u65b9\u5f62\u4e2d\u521b\u5efa\u7684\uff0c\u5b83\u7684\u539f\u70b9\u8bbe\u7f6e\u4e3a [STARTX, STARTZ] \u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\uff0c\u8fd9\u8981\u8003\u8651\u4e0b\u56fe\u6240\u793a\u7684\u4f4d\u79fb\u4e0e\u7f29\u653e\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u8fd9\u53ef\u4ee5\u5728 Terrain \u7c7b\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u56e0\u4e3a\u5b83\u4e0d\u4f1a\u5728\u8fd0\u884c\u65f6\u53d1\u751f\u53d8\u5316\uff0c\u6240\u4ee5\u6211\u4eec\u8981\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027\u6765\u4fdd\u5b58\u5305\u56f4\u76d2\uff1a private final Box2D[][] boundingBoxes; \u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u5f53\u6211\u4eec\u521b\u5efa\u5730\u5f62\u5757\u65f6\uff0c\u53ea\u9700\u8c03\u7528\u8ba1\u7b97\u5305\u56f4\u76d2\u7684\u65b9\u6cd5\u3002 public Terrain(int terrainSize, float scale, float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { this.terrainSize = terrainSize; gameItems = new GameItem[terrainSize * terrainSize]; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); // \u6bcf\u884c\u4e0e\u6bcf\u5217\u7684\u9876\u70b9\u6570 verticesPerCol = heightMapImage.getWidth(); verticesPerRow = heightMapImage.getHeight(); heightMapMesh = new HeightMapMesh(minY, maxY, buf, width, textureFile, textInc); boundingBoxes = new Box2D[terrainSize][terrainSize]; for (int row = 0; row < terrainSize; row++) { for (int col = 0; col < terrainSize; col++) { float xDisplacement = (col - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * terrainSize + col] = terrainBlock; boundingBoxes[row][col] = getBoundingBox(terrainBlock); } } } \u56e0\u6b64\uff0c\u6709\u4e86\u6240\u6709\u9884\u5148\u8ba1\u7b97\u7684\u5305\u56f4\u76d2\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u4ee5\u5f53\u524d\u4f4d\u7f6e\u4e3a\u53c2\u6570\uff0c\u8fd4\u56de\u5bf9\u5e94\u5730\u5f62\u9ad8\u5ea6\u3002\u8be5\u65b9\u6cd5\u540d\u4e3a getHeight \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u3002 public float getHeight(Vector3f position) { float result = Float.MIN_VALUE; // \u5bf9\u4e8e\u6bcf\u4e2a\u5730\u5f62\u5757\uff0c\u6211\u4eec\u83b7\u53d6\u5305\u56f4\u76d2\uff0c\u5c06\u5176\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb // \u68c0\u67e5\u5750\u6807\u662f\u5426\u5305\u542b\u5728\u5305\u56f4\u76d2\u4e2d Box2D boundingBox = null; boolean found = false; GameItem terrainBlock = null; for (int row = 0; row < terrainSize && !found; row++) { for (int col = 0; col < terrainSize && !found; col++) { terrainBlock = gameItems[row * terrainSize + col]; boundingBox = boundingBoxes[row][col]; found = boundingBox.contains(position.x, position.z); } } // \u5982\u679c\u6211\u4eec\u627e\u5230\u4e86\u4e00\u4e2a\u5305\u542b\u6211\u4eec\u4f4d\u7f6e\u7684\u5730\u5f62\u5757 // \u8ba1\u7b97\u8be5\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6 if (found) { Vector3f[] triangle = getTriangle(position, boundingBox, terrainBlock); result = interpolateHeight(triangle[0], triangle[1], triangle[2], position.x, position.z); } return result; } \u5728\u6b64\u65b9\u6cd5\u4e2d\u7b2c\u4e00\u4ef6\u4e8b\u662f\u786e\u5b9a\u6211\u4eec\u6240\u5728\u7684\u5730\u5f62\u5757\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u6240\u4ee5\u7b97\u6cd5\u5f88\u7b80\u5355\u3002\u6211\u4eec\u53ea\u9700\u8981\u8fed\u4ee3\u5305\u56f4\u76d2\u6570\u7ec4\uff0c\u5e76\u68c0\u67e5\u5f53\u524d\u4f4d\u7f6e\u662f\u5426\u4f4d\u4e8e\u5176\u4e2d( Box2D \u63d0\u4f9b\u4e86\u8be5\u65b9\u6cd5)\u3002 \u4e00\u65e6\u627e\u5230\u4e86\u5730\u5f62\u5757\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6240\u5904\u7684\u4e09\u89d2\u5f62\uff0c\u8fd9\u662f\u7531\u4e4b\u540e\u7684 getTriangle \u65b9\u6cd5\u8ba1\u7b97\u7684\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6240\u5728\u4e09\u89d2\u5f62\u7684\u5750\u6807\uff0c\u5305\u62ec\u5b83\u7684\u9ad8\u5ea6\u3002\u4f46\u662f\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u4e00\u4e2a\u70b9\u7684\u9ad8\u5ea6\uff0c\u8fd9\u4e2a\u70b9\u4e0d\u4f4d\u4e8e\u8fd9\u4e9b\u9876\u70b9\u4e2d\u7684\u4efb\u4f55\u4e00\u70b9\uff0c\u800c\u4f4d\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u4f4d\u7f6e\u3002\u8fd9\u5c06\u5728 interpolateHeight \u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u6211\u4eec\u4e5f\u5c06\u89e3\u91ca\u8fd9\u662f\u5982\u4f55\u8ba1\u7b97\u7684\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u786e\u5b9a\u6240\u5904\u7684\u4e09\u89d2\u5f62\u5f00\u59cb\u3002\u6784\u6210\u5730\u5f62\u5757\u7684\u6b63\u65b9\u5f62\u53ef\u4ee5\u770b\u4f5c\u4e00\u4e2a\u7f51\u683c\uff0c\u5176\u4e2d\u6bcf\u4e2a\u5355\u5143\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e00\u4e9b\u53d8\u91cf\uff1a boundingBox.x \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f x \u5750\u6807\u3002 boundingBox.y \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f z \u5750\u6807(\u5373\u4f7f\u4f60\u770b\u5230\u4e00\u4e2a y \uff0c\u4f46\u5b83\u662f\u5728 z \u8f74\u7684)\u3002 boundingBox.width \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u5bbd\u5ea6\u3002 boundingBox.height \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u3002 cellWidth \u662f\u4e00\u4e2a\u5355\u5143\u7684\u5bbd\u5ea6\u3002 cellHeight \u662f\u4e00\u4e2a\u5355\u5143\u7684\u9ad8\u5ea6\u3002 \u4e0a\u9762\u5b9a\u4e49\u7684\u6240\u6709\u53d8\u91cf\u90fd\u7528\u4e16\u754c\u5750\u6807\u6765\u8868\u793a\u3002\u4e3a\u4e86\u8ba1\u7b97\u5355\u5143\u7684\u5bbd\u5ea6\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5305\u56f4\u76d2\u5bbd\u5ea6\u9664\u4ee5\u6bcf\u5217\u7684\u9876\u70b9\u6570\uff1a cellWidth = \\frac{boundingBox.width}{verticesPerCol} cellHeight \u7684\u8ba1\u7b97\u4e5f\u76f8\u4f3c\uff1a cellHeight = \\frac{boundingBox.height}{verticesPerRow} \u4e00\u65e6\u6709\u4e86\u8fd9\u4e9b\u53d8\u91cf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6240\u5728\u7684\u5355\u5143\u683c\u7684\u884c\u548c\u5217\u4e86\uff1a col = \\frac{position.x - boundingBox.x}{boundingBox.width} row = \\frac{position.z - boundingBox.y}{boundingBox.height} \u4e0b\u56fe\u5728\u793a\u4f8b\u5730\u5f62\u5757\u5c55\u793a\u4e86\u6b64\u524d\u63cf\u8ff0\u7684\u6240\u6709\u53d8\u91cf\u3002 \u6709\u4e86\u8fd9\u4e9b\u4fe1\u606f\uff0c\u5c31\u53ef\u4ee5\u8ba1\u7b97\u5355\u5143\u683c\u4e2d\u5305\u542b\u7684\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u4f4d\u7f6e\u3002\u6211\u4eec\u600e\u4e48\u624d\u80fd\u505a\u5230\u5462\uff1f\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7ec4\u6210\u4e00\u4e2a\u5355\u5143\u683c\u7684\u4e09\u89d2\u5f62\u3002 \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5355\u5143\u683c\u662f\u88ab\u4e00\u4e2a\u5bf9\u89d2\u7ebf\u5206\u5f00\u4e3a\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u3002\u786e\u5b9a\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u662f\u68c0\u67e5 z \u5750\u6807\u5728\u5bf9\u89d2\u7ebf\u7684\u4e0a\u65b9\u8fd8\u662f\u4e0b\u65b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5c06\u5bf9\u89d2\u7ebf\u7684 x \u503c\u8bbe\u7f6e\u4e3a\u5f53\u524d\u4f4d\u7f6e\u7684 x \u503c\uff0c\u6c42\u51fa\u5bf9\u5e94\u7684\u5bf9\u89d2\u7ebf z \u503c\uff0c\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5c0f\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u90a3\u4e48\u6211\u4eec\u5728 T1 \u4e2d\u3002\u53cd\u4e4b\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5927\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u6211\u4eec\u5c31\u5728 T2 \u4e2d\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u4e0e\u5bf9\u89d2\u7ebf\u76f8\u5339\u914d\u7684\u76f4\u7ebf\u65b9\u7a0b\u6765\u786e\u5b9a\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u5b66\u6821\u7684\u6570\u5b66\u8bfe\uff0c\u4ece\u4e24\u70b9\u901a\u8fc7\u7684\u76f4\u7ebf(\u5728\u4e8c\u7ef4\u4e2d)\u7684\u65b9\u7a0b\u4e3a: y-y1=m\\cdot(x-x1) \u5176\u4e2dm\u662f\u76f4\u7ebf\u7684\u659c\u7387\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5f53\u6cbf x \u8f74\u79fb\u52a8\u65f6\uff0c\u5176\u9ad8\u5ea6\u4f1a\u53d1\u751f\u53d8\u5316\u3002\u8bf7\u6ce8\u610f\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c y \u5750\u6807\u5176\u5b9e\u662f\u4e00\u4e2a z \u3002\u8fd8\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u4e8c\u7ef4\u5750\u6807\uff0c\u56e0\u4e3a\u5728\u8fd9\u91cc\u4e0d\u8ba1\u7b97\u9ad8\u5ea6\uff0c\u53ea\u8981 x \u5750\u6807\u548c z \u5750\u6807\u5c31\u8db3\u591f\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u76f4\u7ebf\u65b9\u7a0b\u5e94\u8be5\u662f\u8fd9\u6837\u3002 z-z1=m\\cdot(x-x1) \u659c\u7387\u53ef\u4ee5\u6309\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a m=\\frac{z1-z2}{x1-x2} \u6240\u4ee5\u7ed9\u5b9a\u4e00\u4e2a x \u5750\u6807\u5f97\u5230\u4e00\u4e2a z \u503c\u7684\u5bf9\u89d2\u7ebf\u65b9\u7a0b\u5c31\u50cf\u8fd9\u6837\uff1a z=m\\cdot(xpos-x1)+z1=\\frac{z1-z2}{x1-x2}\\cdot(zpos-x1)+z1 \u5176\u4e2d x1 \u3001 x2 \u3001 z1 \u548c z2 \u5206\u522b\u662f\u9876\u70b9 V1 \u548c V2 \u7684 x \u548c z \u5750\u6807\u3002 \u56e0\u6b64\uff0c\u901a\u8fc7\u4e0a\u8ff0\u65b9\u5f0f\u6765\u83b7\u5f97\u5f53\u524d\u4f4d\u7f6e\u6240\u5728\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getTriangle \uff0c\u5176\u5b9e\u73b0\u5982\u4e0b\uff1a protected Vector3f[] getTriangle(Vector3f position, Box2D boundingBox, GameItem terrainBlock) { // \u83b7\u5f97\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u9ad8\u5ea6\u56fe\u7684\u884c\u5217 float cellWidth = boundingBox.width / (float) verticesPerCol; float cellHeight = boundingBox.height / (float) verticesPerRow; int col = (int) ((position.x - boundingBox.x) / cellWidth); int row = (int) ((position.z - boundingBox.y) / cellHeight); Vector3f[] triangle = new Vector3f[3]; triangle[1] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row + 1, col, terrainBlock), boundingBox.y + (row + 1) * cellHeight); triangle[2] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row, col + 1, terrainBlock), boundingBox.y + row * cellHeight); if (position.z < getDiagonalZCoord(triangle[1].x, triangle[1].z, triangle[2].x, triangle[2].z, position.x)) { triangle[0] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row, col, terrainBlock), boundingBox.y + row * cellHeight); } else { triangle[0] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row + 2, col + 1, terrainBlock), boundingBox.y + (row + 1) * cellHeight); } return triangle; } protected float getDiagonalZCoord(float x1, float z1, float x2, float z2, float x) { float z = ((z1 - z2) / (x1 - x2)) * (x - x1) + z1; return z; } protected float getWorldHeight(int row, int col, GameItem gameItem) { float y = heightMapMesh.getHeight(row, col); return y * gameItem.getScale() + gameItem.getPosition().y; } \u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6709\u53e6\u5916\u4e24\u4e2a\u53cd\u590d\u3002\u7b2c\u4e00\u4e2a\u540d\u4e3a getDiagonalZCoord \uff0c\u7ed9\u5b9a x \u4f4d\u7f6e\u548c\u4e24\u4e2a\u9876\u70b9\u8ba1\u7b97\u5bf9\u89d2\u7ebf\u7684 z \u5750\u6807\u3002\u53e6\u4e00\u4e2a\u540d\u4e3a getWorldHeight \uff0c\u7528\u6765\u83b7\u5f97\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u9ad8\u5ea6(\u5373 y \u5750\u6807)\u3002\u5f53\u5730\u5f62\u7f51\u683c\u88ab\u521b\u5efa\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u90fd\u88ab\u9884\u5148\u8ba1\u7b97\u548c\u50a8\u5b58\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002 \u597d\uff0c\u6211\u4eec\u6709\u5f53\u524d\u4f4d\u7f6e\u7684\u4e09\u89d2\u5f62\u5750\u6807\u3002\u6700\u540e\uff0c\u6211\u4eec\u51c6\u5907\u5728\u5f53\u524d\u4f4d\u7f6e\u8ba1\u7b97\u5730\u5f62\u9ad8\u5ea6\u3002\u600e\u4e48\u505a\u5462\uff1f\u6211\u4eec\u7684\u4e09\u89d2\u5f62\u5728\u4e00\u4e2a\u5e73\u9762\u4e0a\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u7531\u4e09\u4e2a\u70b9\u5b9a\u4e49\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002 \u5e73\u9762\u65b9\u7a0b\u5982\u4e0b\uff1a a\\cdot x+b\\cdot y+c\\cdot z+d=0 \u4e0a\u8ff0\u65b9\u7a0b\u7684\u5e38\u6570\u503c\u662f\uff1a a=(B_{y}-A_{y}) \\cdot (C_{z} - A_{z}) - (C_{y} - A_{y}) \\cdot (B_{z}-A_{z}) b=(B_{z}-A_{z}) \\cdot (C_{x} - A_{x}) - (C_{z} - A_{z}) \\cdot (B_{z}-A_{z}) c=(B_{x}-A_{x}) \\cdot (C_{y} - A_{y}) - (C_{x} - A_{x}) \\cdot (B_{y}-A_{y}) \u5176\u4e2d A \u3001 B \u548c C \u662f\u5b9a\u4e49\u5e73\u9762\u6240\u9700\u7684\u4e09\u4e2a\u9876\u70b9\u3002 \u7136\u540e\uff0c\u5229\u7528\u4e4b\u524d\u7684\u65b9\u7a0b\u4ee5\u53ca\u5f53\u524d\u4f4d\u7f6e\u7684 x \u548c z \u5750\u6807\u503c\uff0c\u6211\u4eec\u80fd\u591f\u8ba1\u7b97 y \u503c\uff0c\u5373\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\uff1a y = (-d - a \\cdot x - c \\cdot z) / b \u5b9e\u73b0\u4e86\u5982\u4e0a\u8fd0\u7b97\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a protected float interpolateHeight(Vector3f pA, Vector3f pB, Vector3f pC, float x, float z) { // \u5e73\u9762\u65b9\u7a0b ax+by+cz+d=0 float a = (pB.y - pA.y) * (pC.z - pA.z) - (pC.y - pA.y) * (pB.z - pA.z); float b = (pB.z - pA.z) * (pC.x - pA.x) - (pC.z - pA.z) * (pB.x - pA.x); float c = (pB.x - pA.x) * (pC.y - pA.y) - (pC.x - pA.x) * (pB.y - pA.y); float d = -(a * pA.x + b * pA.y + c * pA.z); // y = (-d -ax -cz) / b float y = (-d - a * x - c * z) / b; return y; } \u8fd9\u5c31\u5b8c\u4e86\uff01\u73b0\u5728\u6211\u4eec\u80fd\u591f\u68c0\u6d4b\u78b0\u649e\uff0c\u6240\u4ee5\u5728 DummyGame \u7c7b\u4e2d\uff0c\u5728\u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e\u65f6\uff0c\u4fee\u6539\u5982\u4e0b\u4ee3\u7801\uff1a // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e Vector3f prevPos = new Vector3f(camera.getPosition()); camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u68c0\u67e5\u662f\u5426\u53d1\u751f\u78b0\u649e\u3002\u5982\u679c\u4e3atrue\uff0c\u5c06y\u5750\u6807\u8bbe\u7f6e\u4e3a // \u6700\u5927\u9ad8\u5ea6 float height = terrain.getHeight(camera.getPosition()); if ( camera.getPosition().y <= height ) { camera.setPosition(prevPos.x, prevPos.y, prevPos.z); } \u5982\u4f60\u6240\u89c1\uff0c\u68c0\u6d4b\u5730\u5f62\u78b0\u649e\u7684\u6982\u5ff5\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ed4\u7ec6\u5730\u8fdb\u884c\u8ba1\u7b97\u5e76\u4e86\u89e3\u6b63\u5904\u7406\u7684\u4e0d\u540c\u5750\u6807\u7cfb\u3002 \u6b64\u5916\uff0c\u867d\u7136\u8fd9\u91cc\u7ed9\u51fa\u7684\u7b97\u6cd5\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u662f\u53ef\u7528\u7684\uff0c\u4f46\u4ecd\u5b58\u5728\u9700\u8981\u4ed4\u7ec6\u5904\u7406\u7684\u60c5\u51b5\u3002\u4f60\u53ef\u4ee5\u53d1\u73b0\u7684\u4e00\u4e2a\u95ee\u9898\u662f\u96a7\u9053\u6548\u5e94( Tunnelling )\u3002\u8bbe\u60f3\u4e00\u4e2a\u60c5\u51b5\uff0c\u6211\u4eec\u6b63\u4ee5\u9ad8\u901f\u7a7f\u8fc7\u5730\u5f62\uff0c\u6b63\u56e0\u5982\u6b64\uff0c\u4f4d\u7f6e\u589e\u91cf\u503c\u8f83\u9ad8\u3002\u8fd9\u4e2a\u503c\u53d8\u5f97\u5982\u6b64\u4e4b\u9ad8\uff0c\u4ee5\u81f3\u4e8e\u56e0\u4e3a\u6211\u4eec\u68c0\u6d4b\u7684\u662f\u6700\u7ec8\u4f4d\u7f6e\u7684\u78b0\u649e\uff0c\u6240\u4ee5\u53ef\u80fd\u5df2\u7ecf\u7a7f\u8fc7\u4e86\u4f4d\u4e8e\u4e24\u70b9\u4e4b\u95f4\u7684\u969c\u788d\u3002 \u6709\u8bb8\u591a\u53ef\u884c\u7684\u89e3\u51b3\u65b9\u6848\u53ef\u4ee5\u907f\u514d\u8fd9\u4e2a\u6548\u5e94\uff0c\u6700\u7b80\u5355\u7684\u89e3\u51b3\u65b9\u6cd5\u662f\u5c06\u8981\u8fdb\u884c\u7684\u8ba1\u7b97\u5206\u6210\u589e\u91cf\u8f83\u5c0f\u7684\u591a\u4efd\u3002","title":"\u5730\u5f62\u78b0\u649e"},{"location":"15-terrain-collisions/#terrain-collisions","text":"\u6b64\u524d\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u5730\u5f62\uff0c\u63a5\u4e0b\u6765\u5c31\u662f\u68c0\u6d4b\u78b0\u649e\u4ee5\u907f\u514d\u7a7f\u8fc7\u5b83\u3002\u56de\u5fc6\u4e00\u4e0b\u4e4b\u524d\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u5730\u5f62\u662f\u7531\u5730\u5f62\u5757\u7ec4\u6210\u7684\uff0c\u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u9ad8\u5ea6\u56fe\u751f\u6210\u7684\uff0c\u9ad8\u5ea6\u56fe\u7528\u4e8e\u8bbe\u7f6e\u6784\u6210\u5730\u5f62\u7684\u4e09\u89d2\u5f62\u7684\u9876\u70b9\u9ad8\u5ea6\u3002 \u4e3a\u4e86\u68c0\u6d4b\u78b0\u649e\uff0c\u6211\u4eec\u5fc5\u987b\u5c06\u5f53\u524d\u6240\u5728\u4f4d\u7f6e\u7684 Y \u503c\u4e0e\u5f53\u524d\u5730\u5f62\u70b9\u7684 Y \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u6709\u78b0\u649e\uff0c\u6211\u4eec\u9700\u8981\u56de\u5230\u5730\u5f62\u4e0a\u65b9\u3002\u5f88\u7b80\u5355\u7684\u60f3\u6cd5\uff0c\u662f\u5417\uff1f\u786e\u5b9e\u662f\u8fd9\u6837\uff0c\u4f46\u5728\u6bd4\u8f83\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u51e0\u6b21\u8ba1\u7b97\u3002 \u9996\u5148\u8981\u5b9a\u4e49\u7684\u662f\u201c\u5f53\u524d\u4f4d\u7f6e\u201d\u8fd9\u4e2a\u8bcd\u7684\u6982\u5ff5\u3002\u7531\u4e8e\u6211\u4eec\u8fd8\u6ca1\u6709\u4e00\u4e2a\u201c\u73a9\u5bb6\u201d\u7684\u6982\u5ff5\uff0c\u5f53\u524d\u4f4d\u7f6e\u5c06\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002\u8fd9\u6837\u6211\u4eec\u5c31\u6709\u4e86\u6bd4\u8f83\u7684\u4e00\u65b9\uff0c\u56e0\u6b64\u63a5\u4e0b\u6765\u8981\u8ba1\u7b97\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u5730\u5f62\u7531\u5730\u5f62\u5757\u7ec4\u6210\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u6bcf\u4e2a\u5730\u5f62\u5757\u90fd\u662f\u7531\u76f8\u540c\u7684\u9ad8\u5ea6\u56fe\u7f51\u683c\u6784\u6210\uff0c\u4f46\u88ab\u7cbe\u786e\u5730\u7f29\u653e\u548c\u4f4d\u79fb\uff0c\u4ee5\u5f62\u6210\u770b\u8d77\u6765\u50cf\u662f\u8fde\u7eed\u7684\u666f\u89c2\u7684\u5730\u5f62\u7f51\u683c\u3002 \u6240\u4ee5\u9996\u5148\u8981\u505a\u7684\u662f\u786e\u5b9a\u5f53\u524d\u4f4d\u7f6e(\u6444\u50cf\u673a\u4f4d\u7f6e)\u5728\u54ea\u4e2a\u5730\u5f62\u5757\u3002\u4e3a\u4e86\u5f97\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4f4d\u79fb\u548c\u7f29\u653e\u6765\u8ba1\u7b97\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2( BoundingBox )\u3002\u56e0\u4e3a\u5730\u5f62\u5728\u8fd0\u884c\u65f6\u4e0d\u4f1a\u79fb\u52a8\u6216\u7f29\u653e\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\u3002\u8fd9\u6837\u5c31\u53ef\u4ee5\u5728\u4efb\u4f55\u65f6\u5019\u8bbf\u95ee\u5b83\u4eec\uff0c\u800c\u4e0d\u9700\u8981\u5728\u6bcf\u4e2a\u6e38\u620f\u5faa\u73af\u5468\u671f\u4e2d\u91cd\u590d\u8fd9\u4e9b\u8ba1\u7b97\u3002 \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u4e00\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u540d\u4e3a getBoundingBox \u3002 private Box2D getBoundingBox(GameItem terrainBlock) { float scale = terrainBlock.getScale(); Vector3f position = terrainBlock.getPosition(); float topLeftX = HeightMapMesh.STARTX * scale + position.x; float topLeftZ = HeightMapMesh.STARTZ * scale + position.z; float width = Math.abs(HeightMapMesh.STARTX * 2) * scale; float height = Math.abs(HeightMapMesh.STARTZ * 2) * scale; Box2D boundingBox = new Box2D(topLeftX, topLeftZ, width, height); return boundingBox; } Box2D \u662f java.awt.Rectangle2D.Float \u7c7b\u7684\u7b80\u5316\u7248\u672c\uff0c\u4e3a\u4e86\u907f\u514d\u4f7f\u7528AWT\u800c\u521b\u5efa\u3002 \u9650\u5236\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u5730\u5f62\u5757\u7684\u4e16\u754c\u5750\u6807\u3002\u5728\u4e0a\u4e00\u7ae0\u4e2d\uff0c\u4f60\u770b\u5230\u6240\u6709\u7684\u5730\u5f62\u7f51\u683c\u90fd\u662f\u5728\u4e00\u4e2a\u6b63\u65b9\u5f62\u4e2d\u521b\u5efa\u7684\uff0c\u5b83\u7684\u539f\u70b9\u8bbe\u7f6e\u4e3a [STARTX, STARTZ] \u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\uff0c\u8fd9\u8981\u8003\u8651\u4e0b\u56fe\u6240\u793a\u7684\u4f4d\u79fb\u4e0e\u7f29\u653e\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u8fd9\u53ef\u4ee5\u5728 Terrain \u7c7b\u6784\u9020\u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u56e0\u4e3a\u5b83\u4e0d\u4f1a\u5728\u8fd0\u884c\u65f6\u53d1\u751f\u53d8\u5316\uff0c\u6240\u4ee5\u6211\u4eec\u8981\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027\u6765\u4fdd\u5b58\u5305\u56f4\u76d2\uff1a private final Box2D[][] boundingBoxes; \u5728 Terrain \u7c7b\u7684\u6784\u9020\u65b9\u6cd5\u4e2d\uff0c\u5f53\u6211\u4eec\u521b\u5efa\u5730\u5f62\u5757\u65f6\uff0c\u53ea\u9700\u8c03\u7528\u8ba1\u7b97\u5305\u56f4\u76d2\u7684\u65b9\u6cd5\u3002 public Terrain(int terrainSize, float scale, float minY, float maxY, String heightMapFile, String textureFile, int textInc) throws Exception { this.terrainSize = terrainSize; gameItems = new GameItem[terrainSize * terrainSize]; PNGDecoder decoder = new PNGDecoder(getClass().getResourceAsStream(heightMapFile)); int height = decoder.getHeight(); int width = decoder.getWidth(); ByteBuffer buf = ByteBuffer.allocateDirect( 4 * decoder.getWidth() * decoder.getHeight()); decoder.decode(buf, decoder.getWidth() * 4, PNGDecoder.Format.RGBA); buf.flip(); // \u6bcf\u884c\u4e0e\u6bcf\u5217\u7684\u9876\u70b9\u6570 verticesPerCol = heightMapImage.getWidth(); verticesPerRow = heightMapImage.getHeight(); heightMapMesh = new HeightMapMesh(minY, maxY, buf, width, textureFile, textInc); boundingBoxes = new Box2D[terrainSize][terrainSize]; for (int row = 0; row < terrainSize; row++) { for (int col = 0; col < terrainSize; col++) { float xDisplacement = (col - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getXLength(); float zDisplacement = (row - ((float) terrainSize - 1) / (float) 2) * scale * HeightMapMesh.getZLength(); GameItem terrainBlock = new GameItem(heightMapMesh.getMesh()); terrainBlock.setScale(scale); terrainBlock.setPosition(xDisplacement, 0, zDisplacement); gameItems[row * terrainSize + col] = terrainBlock; boundingBoxes[row][col] = getBoundingBox(terrainBlock); } } } \u56e0\u6b64\uff0c\u6709\u4e86\u6240\u6709\u9884\u5148\u8ba1\u7b97\u7684\u5305\u56f4\u76d2\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u4ee5\u5f53\u524d\u4f4d\u7f6e\u4e3a\u53c2\u6570\uff0c\u8fd4\u56de\u5bf9\u5e94\u5730\u5f62\u9ad8\u5ea6\u3002\u8be5\u65b9\u6cd5\u540d\u4e3a getHeight \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u3002 public float getHeight(Vector3f position) { float result = Float.MIN_VALUE; // \u5bf9\u4e8e\u6bcf\u4e2a\u5730\u5f62\u5757\uff0c\u6211\u4eec\u83b7\u53d6\u5305\u56f4\u76d2\uff0c\u5c06\u5176\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb // \u68c0\u67e5\u5750\u6807\u662f\u5426\u5305\u542b\u5728\u5305\u56f4\u76d2\u4e2d Box2D boundingBox = null; boolean found = false; GameItem terrainBlock = null; for (int row = 0; row < terrainSize && !found; row++) { for (int col = 0; col < terrainSize && !found; col++) { terrainBlock = gameItems[row * terrainSize + col]; boundingBox = boundingBoxes[row][col]; found = boundingBox.contains(position.x, position.z); } } // \u5982\u679c\u6211\u4eec\u627e\u5230\u4e86\u4e00\u4e2a\u5305\u542b\u6211\u4eec\u4f4d\u7f6e\u7684\u5730\u5f62\u5757 // \u8ba1\u7b97\u8be5\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6 if (found) { Vector3f[] triangle = getTriangle(position, boundingBox, terrainBlock); result = interpolateHeight(triangle[0], triangle[1], triangle[2], position.x, position.z); } return result; } \u5728\u6b64\u65b9\u6cd5\u4e2d\u7b2c\u4e00\u4ef6\u4e8b\u662f\u786e\u5b9a\u6211\u4eec\u6240\u5728\u7684\u5730\u5f62\u5757\u3002\u7531\u4e8e\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u6bcf\u4e2a\u5730\u5f62\u5757\u7684\u5305\u56f4\u76d2\uff0c\u6240\u4ee5\u7b97\u6cd5\u5f88\u7b80\u5355\u3002\u6211\u4eec\u53ea\u9700\u8981\u8fed\u4ee3\u5305\u56f4\u76d2\u6570\u7ec4\uff0c\u5e76\u68c0\u67e5\u5f53\u524d\u4f4d\u7f6e\u662f\u5426\u4f4d\u4e8e\u5176\u4e2d( Box2D \u63d0\u4f9b\u4e86\u8be5\u65b9\u6cd5)\u3002 \u4e00\u65e6\u627e\u5230\u4e86\u5730\u5f62\u5757\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6240\u5904\u7684\u4e09\u89d2\u5f62\uff0c\u8fd9\u662f\u7531\u4e4b\u540e\u7684 getTriangle \u65b9\u6cd5\u8ba1\u7b97\u7684\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6240\u5728\u4e09\u89d2\u5f62\u7684\u5750\u6807\uff0c\u5305\u62ec\u5b83\u7684\u9ad8\u5ea6\u3002\u4f46\u662f\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u4e00\u4e2a\u70b9\u7684\u9ad8\u5ea6\uff0c\u8fd9\u4e2a\u70b9\u4e0d\u4f4d\u4e8e\u8fd9\u4e9b\u9876\u70b9\u4e2d\u7684\u4efb\u4f55\u4e00\u70b9\uff0c\u800c\u4f4d\u4e8e\u5b83\u4eec\u4e4b\u95f4\u7684\u4f4d\u7f6e\u3002\u8fd9\u5c06\u5728 interpolateHeight \u65b9\u6cd5\u4e2d\u8ba1\u7b97\uff0c\u6211\u4eec\u4e5f\u5c06\u89e3\u91ca\u8fd9\u662f\u5982\u4f55\u8ba1\u7b97\u7684\u3002 \u8ba9\u6211\u4eec\u5148\u4ece\u786e\u5b9a\u6240\u5904\u7684\u4e09\u89d2\u5f62\u5f00\u59cb\u3002\u6784\u6210\u5730\u5f62\u5757\u7684\u6b63\u65b9\u5f62\u53ef\u4ee5\u770b\u4f5c\u4e00\u4e2a\u7f51\u683c\uff0c\u5176\u4e2d\u6bcf\u4e2a\u5355\u5143\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u3002\u9996\u5148\u6211\u4eec\u5b9a\u4e49\u4e00\u4e9b\u53d8\u91cf\uff1a boundingBox.x \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f x \u5750\u6807\u3002 boundingBox.y \u662f\u4e0e\u5305\u56f4\u76d2\u76f8\u5173\u8054\u7684\u5730\u5f62\u5757\u7684\u539f z \u5750\u6807(\u5373\u4f7f\u4f60\u770b\u5230\u4e00\u4e2a y \uff0c\u4f46\u5b83\u662f\u5728 z \u8f74\u7684)\u3002 boundingBox.width \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u5bbd\u5ea6\u3002 boundingBox.height \u662f\u5730\u5f62\u5757\u6b63\u65b9\u5f62\u7684\u9ad8\u5ea6\u3002 cellWidth \u662f\u4e00\u4e2a\u5355\u5143\u7684\u5bbd\u5ea6\u3002 cellHeight \u662f\u4e00\u4e2a\u5355\u5143\u7684\u9ad8\u5ea6\u3002 \u4e0a\u9762\u5b9a\u4e49\u7684\u6240\u6709\u53d8\u91cf\u90fd\u7528\u4e16\u754c\u5750\u6807\u6765\u8868\u793a\u3002\u4e3a\u4e86\u8ba1\u7b97\u5355\u5143\u7684\u5bbd\u5ea6\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5305\u56f4\u76d2\u5bbd\u5ea6\u9664\u4ee5\u6bcf\u5217\u7684\u9876\u70b9\u6570\uff1a cellWidth = \\frac{boundingBox.width}{verticesPerCol} cellHeight \u7684\u8ba1\u7b97\u4e5f\u76f8\u4f3c\uff1a cellHeight = \\frac{boundingBox.height}{verticesPerRow} \u4e00\u65e6\u6709\u4e86\u8fd9\u4e9b\u53d8\u91cf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6240\u5728\u7684\u5355\u5143\u683c\u7684\u884c\u548c\u5217\u4e86\uff1a col = \\frac{position.x - boundingBox.x}{boundingBox.width} row = \\frac{position.z - boundingBox.y}{boundingBox.height} \u4e0b\u56fe\u5728\u793a\u4f8b\u5730\u5f62\u5757\u5c55\u793a\u4e86\u6b64\u524d\u63cf\u8ff0\u7684\u6240\u6709\u53d8\u91cf\u3002 \u6709\u4e86\u8fd9\u4e9b\u4fe1\u606f\uff0c\u5c31\u53ef\u4ee5\u8ba1\u7b97\u5355\u5143\u683c\u4e2d\u5305\u542b\u7684\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u4f4d\u7f6e\u3002\u6211\u4eec\u600e\u4e48\u624d\u80fd\u505a\u5230\u5462\uff1f\u8ba9\u6211\u4eec\u6765\u770b\u770b\u7ec4\u6210\u4e00\u4e2a\u5355\u5143\u683c\u7684\u4e09\u89d2\u5f62\u3002 \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u5355\u5143\u683c\u662f\u88ab\u4e00\u4e2a\u5bf9\u89d2\u7ebf\u5206\u5f00\u4e3a\u4e24\u4e2a\u4e09\u89d2\u5f62\u7684\u3002\u786e\u5b9a\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u662f\u68c0\u67e5 z \u5750\u6807\u5728\u5bf9\u89d2\u7ebf\u7684\u4e0a\u65b9\u8fd8\u662f\u4e0b\u65b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5c06\u5bf9\u89d2\u7ebf\u7684 x \u503c\u8bbe\u7f6e\u4e3a\u5f53\u524d\u4f4d\u7f6e\u7684 x \u503c\uff0c\u6c42\u51fa\u5bf9\u5e94\u7684\u5bf9\u89d2\u7ebf z \u503c\uff0c\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5c0f\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u90a3\u4e48\u6211\u4eec\u5728 T1 \u4e2d\u3002\u53cd\u4e4b\u5982\u679c\u5f53\u524d\u4f4d\u7f6e\u7684 z \u503c\u5927\u4e8e\u5bf9\u89d2\u7ebf\u7684 z \u503c\uff0c\u6211\u4eec\u5c31\u5728 T2 \u4e2d\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u4e0e\u5bf9\u89d2\u7ebf\u76f8\u5339\u914d\u7684\u76f4\u7ebf\u65b9\u7a0b\u6765\u786e\u5b9a\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u5b66\u6821\u7684\u6570\u5b66\u8bfe\uff0c\u4ece\u4e24\u70b9\u901a\u8fc7\u7684\u76f4\u7ebf(\u5728\u4e8c\u7ef4\u4e2d)\u7684\u65b9\u7a0b\u4e3a: y-y1=m\\cdot(x-x1) \u5176\u4e2dm\u662f\u76f4\u7ebf\u7684\u659c\u7387\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5f53\u6cbf x \u8f74\u79fb\u52a8\u65f6\uff0c\u5176\u9ad8\u5ea6\u4f1a\u53d1\u751f\u53d8\u5316\u3002\u8bf7\u6ce8\u610f\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c y \u5750\u6807\u5176\u5b9e\u662f\u4e00\u4e2a z \u3002\u8fd8\u8981\u6ce8\u610f\u7684\u662f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u4e8c\u7ef4\u5750\u6807\uff0c\u56e0\u4e3a\u5728\u8fd9\u91cc\u4e0d\u8ba1\u7b97\u9ad8\u5ea6\uff0c\u53ea\u8981 x \u5750\u6807\u548c z \u5750\u6807\u5c31\u8db3\u591f\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u76f4\u7ebf\u65b9\u7a0b\u5e94\u8be5\u662f\u8fd9\u6837\u3002 z-z1=m\\cdot(x-x1) \u659c\u7387\u53ef\u4ee5\u6309\u5982\u4e0b\u65b9\u5f0f\u8ba1\u7b97\uff1a m=\\frac{z1-z2}{x1-x2} \u6240\u4ee5\u7ed9\u5b9a\u4e00\u4e2a x \u5750\u6807\u5f97\u5230\u4e00\u4e2a z \u503c\u7684\u5bf9\u89d2\u7ebf\u65b9\u7a0b\u5c31\u50cf\u8fd9\u6837\uff1a z=m\\cdot(xpos-x1)+z1=\\frac{z1-z2}{x1-x2}\\cdot(zpos-x1)+z1 \u5176\u4e2d x1 \u3001 x2 \u3001 z1 \u548c z2 \u5206\u522b\u662f\u9876\u70b9 V1 \u548c V2 \u7684 x \u548c z \u5750\u6807\u3002 \u56e0\u6b64\uff0c\u901a\u8fc7\u4e0a\u8ff0\u65b9\u5f0f\u6765\u83b7\u5f97\u5f53\u524d\u4f4d\u7f6e\u6240\u5728\u7684\u4e09\u89d2\u5f62\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getTriangle \uff0c\u5176\u5b9e\u73b0\u5982\u4e0b\uff1a protected Vector3f[] getTriangle(Vector3f position, Box2D boundingBox, GameItem terrainBlock) { // \u83b7\u5f97\u4e0e\u5f53\u524d\u4f4d\u7f6e\u76f8\u5173\u7684\u9ad8\u5ea6\u56fe\u7684\u884c\u5217 float cellWidth = boundingBox.width / (float) verticesPerCol; float cellHeight = boundingBox.height / (float) verticesPerRow; int col = (int) ((position.x - boundingBox.x) / cellWidth); int row = (int) ((position.z - boundingBox.y) / cellHeight); Vector3f[] triangle = new Vector3f[3]; triangle[1] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row + 1, col, terrainBlock), boundingBox.y + (row + 1) * cellHeight); triangle[2] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row, col + 1, terrainBlock), boundingBox.y + row * cellHeight); if (position.z < getDiagonalZCoord(triangle[1].x, triangle[1].z, triangle[2].x, triangle[2].z, position.x)) { triangle[0] = new Vector3f( boundingBox.x + col * cellWidth, getWorldHeight(row, col, terrainBlock), boundingBox.y + row * cellHeight); } else { triangle[0] = new Vector3f( boundingBox.x + (col + 1) * cellWidth, getWorldHeight(row + 2, col + 1, terrainBlock), boundingBox.y + (row + 1) * cellHeight); } return triangle; } protected float getDiagonalZCoord(float x1, float z1, float x2, float z2, float x) { float z = ((z1 - z2) / (x1 - x2)) * (x - x1) + z1; return z; } protected float getWorldHeight(int row, int col, GameItem gameItem) { float y = heightMapMesh.getHeight(row, col); return y * gameItem.getScale() + gameItem.getPosition().y; } \u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u6709\u53e6\u5916\u4e24\u4e2a\u53cd\u590d\u3002\u7b2c\u4e00\u4e2a\u540d\u4e3a getDiagonalZCoord \uff0c\u7ed9\u5b9a x \u4f4d\u7f6e\u548c\u4e24\u4e2a\u9876\u70b9\u8ba1\u7b97\u5bf9\u89d2\u7ebf\u7684 z \u5750\u6807\u3002\u53e6\u4e00\u4e2a\u540d\u4e3a getWorldHeight \uff0c\u7528\u6765\u83b7\u5f97\u4e09\u89d2\u5f62\u9876\u70b9\u7684\u9ad8\u5ea6(\u5373 y \u5750\u6807)\u3002\u5f53\u5730\u5f62\u7f51\u683c\u88ab\u521b\u5efa\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u9ad8\u5ea6\u90fd\u88ab\u9884\u5148\u8ba1\u7b97\u548c\u50a8\u5b58\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u5750\u6807\u3002 \u597d\uff0c\u6211\u4eec\u6709\u5f53\u524d\u4f4d\u7f6e\u7684\u4e09\u89d2\u5f62\u5750\u6807\u3002\u6700\u540e\uff0c\u6211\u4eec\u51c6\u5907\u5728\u5f53\u524d\u4f4d\u7f6e\u8ba1\u7b97\u5730\u5f62\u9ad8\u5ea6\u3002\u600e\u4e48\u505a\u5462\uff1f\u6211\u4eec\u7684\u4e09\u89d2\u5f62\u5728\u4e00\u4e2a\u5e73\u9762\u4e0a\uff0c\u4e00\u4e2a\u5e73\u9762\u53ef\u4ee5\u7531\u4e09\u4e2a\u70b9\u5b9a\u4e49\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u4e09\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u4e00\u4e2a\u4e09\u89d2\u5f62\u3002 \u5e73\u9762\u65b9\u7a0b\u5982\u4e0b\uff1a a\\cdot x+b\\cdot y+c\\cdot z+d=0 \u4e0a\u8ff0\u65b9\u7a0b\u7684\u5e38\u6570\u503c\u662f\uff1a a=(B_{y}-A_{y}) \\cdot (C_{z} - A_{z}) - (C_{y} - A_{y}) \\cdot (B_{z}-A_{z}) b=(B_{z}-A_{z}) \\cdot (C_{x} - A_{x}) - (C_{z} - A_{z}) \\cdot (B_{z}-A_{z}) c=(B_{x}-A_{x}) \\cdot (C_{y} - A_{y}) - (C_{x} - A_{x}) \\cdot (B_{y}-A_{y}) \u5176\u4e2d A \u3001 B \u548c C \u662f\u5b9a\u4e49\u5e73\u9762\u6240\u9700\u7684\u4e09\u4e2a\u9876\u70b9\u3002 \u7136\u540e\uff0c\u5229\u7528\u4e4b\u524d\u7684\u65b9\u7a0b\u4ee5\u53ca\u5f53\u524d\u4f4d\u7f6e\u7684 x \u548c z \u5750\u6807\u503c\uff0c\u6211\u4eec\u80fd\u591f\u8ba1\u7b97 y \u503c\uff0c\u5373\u5f53\u524d\u4f4d\u7f6e\u7684\u5730\u5f62\u9ad8\u5ea6\uff1a y = (-d - a \\cdot x - c \\cdot z) / b \u5b9e\u73b0\u4e86\u5982\u4e0a\u8fd0\u7b97\u7684\u65b9\u6cd5\u5982\u4e0b\uff1a protected float interpolateHeight(Vector3f pA, Vector3f pB, Vector3f pC, float x, float z) { // \u5e73\u9762\u65b9\u7a0b ax+by+cz+d=0 float a = (pB.y - pA.y) * (pC.z - pA.z) - (pC.y - pA.y) * (pB.z - pA.z); float b = (pB.z - pA.z) * (pC.x - pA.x) - (pC.z - pA.z) * (pB.x - pA.x); float c = (pB.x - pA.x) * (pC.y - pA.y) - (pC.x - pA.x) * (pB.y - pA.y); float d = -(a * pA.x + b * pA.y + c * pA.z); // y = (-d -ax -cz) / b float y = (-d - a * x - c * z) / b; return y; } \u8fd9\u5c31\u5b8c\u4e86\uff01\u73b0\u5728\u6211\u4eec\u80fd\u591f\u68c0\u6d4b\u78b0\u649e\uff0c\u6240\u4ee5\u5728 DummyGame \u7c7b\u4e2d\uff0c\u5728\u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e\u65f6\uff0c\u4fee\u6539\u5982\u4e0b\u4ee3\u7801\uff1a // \u66f4\u65b0\u6444\u50cf\u673a\u4f4d\u7f6e Vector3f prevPos = new Vector3f(camera.getPosition()); camera.movePosition(cameraInc.x * CAMERA_POS_STEP, cameraInc.y * CAMERA_POS_STEP, cameraInc.z * CAMERA_POS_STEP); // \u68c0\u67e5\u662f\u5426\u53d1\u751f\u78b0\u649e\u3002\u5982\u679c\u4e3atrue\uff0c\u5c06y\u5750\u6807\u8bbe\u7f6e\u4e3a // \u6700\u5927\u9ad8\u5ea6 float height = terrain.getHeight(camera.getPosition()); if ( camera.getPosition().y <= height ) { camera.setPosition(prevPos.x, prevPos.y, prevPos.z); } \u5982\u4f60\u6240\u89c1\uff0c\u68c0\u6d4b\u5730\u5f62\u78b0\u649e\u7684\u6982\u5ff5\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u4ed4\u7ec6\u5730\u8fdb\u884c\u8ba1\u7b97\u5e76\u4e86\u89e3\u6b63\u5904\u7406\u7684\u4e0d\u540c\u5750\u6807\u7cfb\u3002 \u6b64\u5916\uff0c\u867d\u7136\u8fd9\u91cc\u7ed9\u51fa\u7684\u7b97\u6cd5\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u662f\u53ef\u7528\u7684\uff0c\u4f46\u4ecd\u5b58\u5728\u9700\u8981\u4ed4\u7ec6\u5904\u7406\u7684\u60c5\u51b5\u3002\u4f60\u53ef\u4ee5\u53d1\u73b0\u7684\u4e00\u4e2a\u95ee\u9898\u662f\u96a7\u9053\u6548\u5e94( Tunnelling )\u3002\u8bbe\u60f3\u4e00\u4e2a\u60c5\u51b5\uff0c\u6211\u4eec\u6b63\u4ee5\u9ad8\u901f\u7a7f\u8fc7\u5730\u5f62\uff0c\u6b63\u56e0\u5982\u6b64\uff0c\u4f4d\u7f6e\u589e\u91cf\u503c\u8f83\u9ad8\u3002\u8fd9\u4e2a\u503c\u53d8\u5f97\u5982\u6b64\u4e4b\u9ad8\uff0c\u4ee5\u81f3\u4e8e\u56e0\u4e3a\u6211\u4eec\u68c0\u6d4b\u7684\u662f\u6700\u7ec8\u4f4d\u7f6e\u7684\u78b0\u649e\uff0c\u6240\u4ee5\u53ef\u80fd\u5df2\u7ecf\u7a7f\u8fc7\u4e86\u4f4d\u4e8e\u4e24\u70b9\u4e4b\u95f4\u7684\u969c\u788d\u3002 \u6709\u8bb8\u591a\u53ef\u884c\u7684\u89e3\u51b3\u65b9\u6848\u53ef\u4ee5\u907f\u514d\u8fd9\u4e2a\u6548\u5e94\uff0c\u6700\u7b80\u5355\u7684\u89e3\u51b3\u65b9\u6cd5\u662f\u5c06\u8981\u8fdb\u884c\u7684\u8ba1\u7b97\u5206\u6210\u589e\u91cf\u8f83\u5c0f\u7684\u591a\u4efd\u3002","title":"\u5730\u5f62\u78b0\u649e\uff08Terrain Collisions\uff09"},{"location":"16-fog/","text":"\u96fe\uff08Fog\uff09 \u5728\u5904\u7406\u66f4\u590d\u6742\u7684\u95ee\u9898\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u521b\u5efa\u96fe\u7279\u6548\u3002\u6709\u4e86\u8fd9\u4e2a\u7279\u6548\uff0c\u5c31\u53ef\u4ee5\u6a21\u62df\u9065\u8fdc\u7684\u7269\u4f53\u53d8\u6697\uff0c\u4f3c\u4e4e\u6d88\u5931\u5728\u6d53\u96fe\u4e2d\u3002 \u8ba9\u6211\u4eec\u6765\u786e\u5b9a\u5b9a\u4e49\u96fe\u7684\u5c5e\u6027\u662f\u4ec0\u4e48\u3002\u7b2c\u4e00\u4e2a\u662f\u96fe\u7684\u989c\u8272\u3002\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\uff0c\u96fe\u662f\u7070\u8272\u7684\uff0c\u4f46\u6211\u4eec\u53ef\u4ee5\u5229\u7528\u8fd9\u4e2a\u7279\u6548\u6765\u6a21\u62df\u4e0d\u540c\u989c\u8272\u7684\u96fe\u8986\u76d6\u7684\u533a\u57df\u3002\u8fd8\u6709\u4e00\u4e2a\u5c5e\u6027\u662f\u96fe\u7684\u6d53\u5ea6\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u4f7f\u7528\u96fe\u7279\u6548\uff0c\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\uff0c\u5f533D\u573a\u666f\u7684\u7269\u4f53\u8fdc\u79bb\u6444\u50cf\u673a\u65f6\uff0c\u4f7f\u5b83\u4eec\u892a\u8272\u5230\u96fe\u7684\u989c\u8272\u3002\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4f46\u8fdc\u5904\u7684\u7269\u4f53\u5c06\u65e0\u6cd5\u5206\u8fa8\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4e00\u4e2a\u53c2\u6570\uff0c\u53ef\u4ee5\u7528\u6765\u6df7\u5408\u96fe\u7684\u989c\u8272\u4e0e\u6bcf\u4e2a\u7247\u5143\u7684\u989c\u8272\uff0c\u4ee5\u6a21\u62df\u96fe\u7279\u6548\u3002\u8fd9\u4e2a\u53c2\u6570\u53d6\u51b3\u4e8e\u4e0e\u6444\u50cf\u673a\u76f8\u8ddd\u7684\u8ddd\u79bb\u3002 \u8ba9\u6211\u4eec\u628a\u8fd9\u4e2a\u53c2\u6570\u547d\u540d\u4e3a fogFactor \uff0c\u5e76\u8bbe\u5b9a\u5b83\u7684\u8303\u56f4\u4e3a0\u52301\u3002\u5f53 fogFactor \u4e3a1\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u662f\u8f83\u8fd1\u7684\u7269\u4f53\u3002\u5f53 fogFactor \u4e3a0\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u9690\u85cf\u5728\u96fe\u4e2d\u3002 \u7136\u540e\uff0c\u8ba1\u7b97\u96fe\u8272\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a finalColour = (1 - fogFactor) \\cdot fogColour + fogFactor \\cdot framentColour finalColour \u662f\u4f7f\u7528\u96fe\u7279\u6548\u7684\u6700\u7ec8\u989c\u8272\u3002 fogFactor \u662f\u63a7\u5236\u96fe\u7684\u989c\u8272\u4e0e\u7247\u5143\u7684\u989c\u8272\u5982\u4f55\u6df7\u5408\u7684\u53c2\u6570\uff0c\u5b83\u57fa\u672c\u4e0a\u63a7\u5236\u7269\u4f53\u7684\u53ef\u89c1\u6027\u3002 fogColour \u662f\u96fe\u7684\u989c\u8272\u3002 fragmentColour \u6ca1\u6709\u4f7f\u7528\u96fe\u7279\u6548\u7684\u7247\u5143\u989c\u8272\u3002 \u73b0\u5728\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\u6765\u57fa\u4e8e\u8ddd\u79bb\u8ba1\u7b97 fogFactor \u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4e0d\u540c\u7684\u6a21\u578b\uff0c\u9996\u5148\u4f7f\u7528\u7ebf\u6027\u6a21\u578b\u3002\u8fd9\u662f\u4e00\u4e2a\u7ed9\u5b9a\u8ddd\u79bb\u4ee5\u7ebf\u6027\u65b9\u5f0f\u6539\u53d8 fogFactor \u7684\u6a21\u578b\u3002 \u7ebf\u6027\u6a21\u578b\u7531\u4ee5\u4e0b\u53c2\u6570\u5b9a\u4e49\uff1a fogStart : \u5f00\u59cb\u4f7f\u7528\u96fe\u7279\u6548\u7684\u8ddd\u79bb\u3002 fogFinish : \u96fe\u7279\u6548\u8fbe\u5230\u6700\u5927\u503c\u7684\u8ddd\u79bb\u3002 distance : \u5230\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u3002 \u6709\u4e86\u8fd9\u4e9b\u53c2\u6570\uff0c\u65b9\u7a0b\u5c31\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\displaystyle fogFactor = \\frac{(fogFinish - distance)}{(fogFinish - fogStart)} \u5bf9\u4e8e\u8ddd\u79bb\u4f4e\u4e8e fogStart \u7684\u7269\u4f53\u6211\u4eec\u7b80\u5355\u5730\u8bbe\u7f6e fogFactor \u4e3a 1 \u3002\u4e0b\u56fe\u8868\u660e\u4e86 fogFactor \u662f\u5982\u4f55\u968f\u7740\u8ddd\u79bb\u53d8\u5316\u800c\u53d8\u5316\u7684\u3002 \u7ebf\u6027\u6a21\u578b\u6613\u4e8e\u8ba1\u7b97\uff0c\u4f46\u4e0d\u592a\u771f\u5b9e\uff0c\u56e0\u4e3a\u5b83\u4e0d\u8003\u8651\u96fe\u6c14\u6d53\u5ea6\u3002\u5b9e\u9645\u4e0a\u96fe\u5f80\u5f80\u4ee5\u66f4\u5e73\u6ed1\u7684\u65b9\u5f0f\u589e\u52a0\u3002\u6240\u4ee5\u4e0b\u4e00\u4e2a\u5408\u9002\u7684\u6a21\u578b\u662f\u6307\u6570\u6a21\u578b\u3002\u8be5\u6a21\u578b\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a \\displaystyle focFactor = e^{-(distance \\cdot fogDensity)^{exponent}} = \\frac{1}{e^{(distance \\cdot fogDensity)^{exponent}}} \u5176\u4e2d\u7684\u65b0\u53d8\u91cf\u5982\u4e0b\u6240\u8ff0\uff1a fogDensity \u662f\u96fe\u7684\u539a\u5ea6\u6216\u6d53\u5ea6\u3002 exponent \u7528\u6765\u63a7\u5236\u96fe\u968f\u7740\u8ddd\u79bb\u7684\u589e\u52a0\u589e\u957f\u7684\u901f\u5ea6\u3002 \u4e0b\u56fe\u663e\u793a\u4e86\u4e24\u4e2a\u56fe\u5f62\uff0c\u5206\u522b\u8bbe\u7f6e\u4e86\u4e0d\u540c\u7684 exponent \u503c\uff08\u84dd\u7ebf\u4e3a 2 \uff0c\u7ea2\u7ebf\u4e3a 4 \uff09\u3002 \u5728\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a\u516c\u5f0f\uff0c\u8ba9\u5b83\u53ef\u4ee5\u4e3a exponent \u8bbe\u7f6e\u4e0d\u540c\u7684\u503c\uff08\u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u4fee\u6539\u793a\u4f8b\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u503c\uff09\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u8fc7\u8fd9\u4e2a\u539f\u7406\u4e86\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u5b83\u3002\u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b9e\u73b0\u96fe\u7279\u6548\uff0c\u56e0\u4e3a\u8fd9\u6709\u6211\u4eec\u9700\u8981\u7684\u6240\u6709\u53d8\u91cf\u3002\u6211\u4eec\u5c06\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u96fe\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u3002 struct Fog { int active; vec3 colour; float density; }; active \u5c5e\u6027\u7528\u4e8e\u6fc0\u6d3b\u6216\u5173\u95ed\u96fe\u7279\u6548\u3002\u96fe\u5c5e\u6027\u5c06\u901a\u8fc7\u53e6\u4e00\u4e2a\u88ab\u79f0\u4f5c fog \u7684Uniform\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002 uniform Fog fog; \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u7740\u96fe\u5c5e\u6027\u7684\u540d\u4e3a Fog \u7684\u65b0\u7c7b\uff0c\u5b83\u662f\u53e6\u4e00\u4e2aPOJO\uff08Plain Ordinary Java Object\uff0c\u7b80\u5355\u7684Java\u5bf9\u8c61\uff09\u3002 package org.lwjglb.engine.graph.weather; import org.joml.Vector3f; public class Fog { private boolean active; private Vector3f colour; private float density; public static Fog NOFOG = new Fog(); public Fog() { active = false; this.colour = new Vector3f(0, 0, 0); this.density = 0; } public Fog(boolean active, Vector3f colour, float density) { this.colour = colour; this.density = density; this.active = active; } // Getters and setters here\u2026. \u6211\u4eec\u5c06\u5728 Scene \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a Fog \u793a\u4f8b\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c Scene \u7c7b\u5c06\u521d\u59cb\u5316\u4e00\u4e2a Fog \u793a\u4f8b\u5230\u5e38\u91cf NOFOG \uff0c\u7528\u4e8e\u6a21\u62df\u5173\u95ed\u96fe\u7279\u6548\u7684\u60c5\u51b5\u3002 \u56e0\u4e3a\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684Uniform\u7c7b\u578b\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539 ShaderProgram \u7c7b\u6765\u521b\u5efa\u548c\u521d\u59cb\u5316\u96fe\u7684Uniform\u3002 public void createFogUniform(String uniformName) throws Exception { createUniform(uniformName + \".active\"); createUniform(uniformName + \".colour\"); createUniform(uniformName + \".density\"); } public void setUniform(String uniformName, Fog fog) { setUniform(uniformName + \".activeFog\", fog.isActive() ? 1 : 0); setUniform(uniformName + \".colour\", fog.getColour() ); setUniform(uniformName + \".density\", fog.getDensity()); } \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 setupSceneShader \u65b9\u6cd5\u4e2d\u521b\u5efaUniform\uff1a sceneShaderProgram.createFogUniform(\"fog\"); \u7136\u540e\u5728 renderScene \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff1a sceneShaderProgram.setUniform(\"fog\", scene.getFog()); \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5728\u6e38\u620f\u4e2d\u5b9a\u4e49\u96fe\u7279\u6548\uff0c\u4f46\u662f\u9700\u8981\u56de\u5230\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u96fe\u7279\u6548\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcFog \u7684\u51fd\u6570\uff0c\u51fd\u6570\u5b9a\u4e49\u5982\u4e0b\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog) { float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fog.colour, colour.xyz, fogFactor); return vec4(resultColour.xyz, colour.w); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5230\u9876\u70b9\u7684\u8ddd\u79bb\u3002\u9876\u70b9\u5750\u6807\u5b9a\u4e49\u5728 pos \u53d8\u91cf\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u957f\u5ea6\u3002\u7136\u540e\u5229\u7528 exponent \u4e3a2\u7684\u6307\u6570\u6a21\u578b\uff08\u76f8\u5f53\u4e8e\u4e58\u4ee5\u4e24\u6b21\uff09\u8ba1\u7b97\u96fe\u53c2\u6570\u3002\u6211\u4eec\u5f97\u5230\u7684 fogFactor \u7684\u8303\u56f4\u5728 0 \u5230 1 \u4e4b\u95f4\uff0c\u5e76\u4f7f\u7528 mix \u51fd\u6570\u3002\u5728GLSL\u4e2d\uff0c min \u51fd\u6570\u88ab\u7528\u4e8e\u6df7\u5408\u96fe\u8272\u548c\u56fe\u5143\u989c\u8272\uff08\u7531\u989c\u8272\u53d8\u91cf\u5b9a\u4e49\uff09\u3002\u76f8\u5f53\u4e8e\u4f7f\u7528\u5982\u4e0b\u65b9\u7a0b\uff1a resultColour = (1 - fogFactor) \\cdot fog.colour + fogFactor \\cdot colour \u6211\u4eec\u8fd8\u4e3a\u989c\u8272\u4fdd\u7559\u4e86 w \u5143\u7d20\uff0c\u5373\u900f\u660e\u5ea6\u3002\u6211\u4eec\u4e0d\u5e0c\u671b\u8fd9\u4e2a\u5143\u7d20\u53d7\u5230\u5f71\u54cd\uff0c\u7247\u5143\u5e94\u8be5\u4fdd\u6301\u5b83\u7684\u900f\u660e\u7a0b\u5ea6\u4e0d\u53d8\u3002 \u5728\u5e94\u7528\u4e86\u6240\u6709\u7684\u5149\u6548\u4e4b\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u6700\u540e\uff0c\u5982\u679c\u96fe\u7279\u6548\u542f\u7528\u7684\u8bdd\uff0c\u6211\u4eec\u5c06\u7b80\u5355\u5730\u628a\u8fd4\u56de\u503c\u8bbe\u7f6e\u4e3a\u7247\u5143\u989c\u8272\u3002 if ( fog.activeFog == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog); } \u6240\u6709\u8fd9\u4e9b\u4ee3\u7801\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u6570\u636e\u8bbe\u7f6e\u4e00\u4e2a\u96fe\u7279\u6548\uff1a scene.setFog(new Fog(true, new Vector3f(0.5f, 0.5f, 0.5f), 0.15f)); \u7136\u540e\u6211\u4eec\u5c06\u83b7\u5f97\u50cf\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f60\u4f1a\u770b\u5230\u8fdc\u5904\u7684\u7269\u4f53\u892a\u8272\uff0c\u5f53\u4f60\u9760\u8fd1\u5b83\u4eec\u65f6\uff0c\u96fe\u5f00\u59cb\u6d88\u5931\u3002\u4f46\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u5730\u5e73\u7ebf\u4e0d\u53d7\u96fe\u7684\u5f71\u54cd\u3002\u6709\u51e0\u79cd\u65b9\u6cd5\u53ef\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1a \u4f7f\u7528\u53ea\u80fd\u770b\u5230\u5929\u7a7a\u7684\u53e6\u4e00\u4e2a\u4e0d\u540c\u7684\u5929\u7a7a\u76d2\u3002 \u5220\u9664\u5929\u7a7a\u76d2\uff0c\u56e0\u4e3a\u6709\u6d53\u96fe\uff0c\u4f60\u4e0d\u5e94\u8be5\u80fd\u591f\u770b\u5230\u4e00\u4e2a\u80cc\u666f\u3002 \u4e5f\u53ef\u80fd\u8fd9\u4e24\u4e2a\u89e3\u51b3\u65b9\u6848\u6ca1\u6709\u9002\u5408\u4f60\u7684\uff0c\u4f60\u53ef\u4ee5\u8bd5\u7740\u5c06\u96fe\u8272\u4e0e\u5929\u7a7a\u76d2\u7684\u80cc\u666f\u76f8\u5339\u914d\uff0c\u4f46\u8fd9\u6837\u4f60\u4f1a\u505a\u590d\u6742\u7684\u8ba1\u7b97\uff0c\u7ed3\u679c\u4e5f\u8bb8\u4e0d\u4f1a\u66f4\u597d\u3002 \u5982\u679c\u4f60\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u611f\u5230\u5e73\u884c\u5149\u53d8\u5f97\u6697\u6de1\uff0c\u573a\u666f\u53d8\u6697\uff0c\u4f46\u96fe\u770b\u8d77\u6765\u6709\u95ee\u9898\uff0c\u56e0\u4e3a\u5b83\u4e0d\u53d7\u5149\u7684\u5f71\u54cd\uff0c\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u8fdc\u5904\u7684\u7269\u4f53\u53d8\u4e3a\u96fe\u8272\uff0c\u8fd9\u662f\u4e00\u4e2a\u4e0d\u53d7\u5149\u5f71\u54cd\u7684\u5e38\u6570\u3002\u8fd9\u9020\u6210\u4e86\u4e00\u4e2a\u5728\u9ed1\u6697\u4e2d\u53d1\u5149\u7684\u6548\u679c\uff08\u8fd9\u53ef\u80fd\u5e76\u4e0d\u597d\uff09\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u8ba1\u7b97\u96fe\u7684\u51fd\u6570\uff0c\u8ba9\u5176\u8003\u8651\u5149\u7167\u3002\u8be5\u51fd\u6570\u5c06\u63a5\u6536\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8c03\u6574\u96fe\u8272\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog, vec3 ambientLight, DirectionalLight dirLight) { vec3 fogColor = fog.colour * (ambientLight + dirLight.colour * dirLight.intensity); float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fogColor, colour.xyz, fogFactor); return vec4(resultColour.xyz, 1); } \u5982\u4f60\u6240\u89c1\uff0c\u5e73\u884c\u5149\u6211\u4eec\u4ec5\u4f7f\u7528\u4e86\u989c\u8272\u548c\u5f3a\u5ea6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5173\u6ce8\u5b83\u7684\u65b9\u5411\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u51fd\u6570\u7684\u8c03\u7528\uff1a if ( fog.active == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog, ambientLight, directionalLight); } \u5728\u591c\u665a\u65f6\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u6548\u679c\u3002 \u4e00\u4e2a\u8981\u5f3a\u8c03\u7684\u91cd\u8981\u7684\u4e8b\u60c5\u662f\uff0c\u6211\u4eec\u5fc5\u987b\u806a\u660e\u5730\u9009\u62e9\u96fe\u8272\u3002\u8fd9\u662f\u5f88\u91cd\u8981\u7684\uff0c\u5f53\u6211\u4eec\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f46\u6709\u56fa\u5b9a\u7684\u989c\u8272\u80cc\u666f\uff0c\u5e94\u8be5\u628a\u96fe\u8272\u8bbe\u7f6e\u4e3a\u80cc\u666f\u8272\u3002\u5982\u679c\u4f60\u5220\u9664\u4e86\u5929\u7a7a\u76d2\u7684\u4ee3\u7801\u5e76\u91cd\u65b0\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\u3002 \u4f46\u5982\u679c\u6211\u4eec\u628a\u80cc\u666f\u8272\u4fee\u6539\u4e3a\uff080.5, 0.5, 0.5\uff09\uff0c\u6700\u7ec8\u7ed3\u679c\u770b\u8d77\u6765\u5c31\u662f\u5982\u4e0b\u6240\u793a\u3002","title":"\u96fe"},{"location":"16-fog/#fog","text":"\u5728\u5904\u7406\u66f4\u590d\u6742\u7684\u95ee\u9898\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u521b\u5efa\u96fe\u7279\u6548\u3002\u6709\u4e86\u8fd9\u4e2a\u7279\u6548\uff0c\u5c31\u53ef\u4ee5\u6a21\u62df\u9065\u8fdc\u7684\u7269\u4f53\u53d8\u6697\uff0c\u4f3c\u4e4e\u6d88\u5931\u5728\u6d53\u96fe\u4e2d\u3002 \u8ba9\u6211\u4eec\u6765\u786e\u5b9a\u5b9a\u4e49\u96fe\u7684\u5c5e\u6027\u662f\u4ec0\u4e48\u3002\u7b2c\u4e00\u4e2a\u662f\u96fe\u7684\u989c\u8272\u3002\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\uff0c\u96fe\u662f\u7070\u8272\u7684\uff0c\u4f46\u6211\u4eec\u53ef\u4ee5\u5229\u7528\u8fd9\u4e2a\u7279\u6548\u6765\u6a21\u62df\u4e0d\u540c\u989c\u8272\u7684\u96fe\u8986\u76d6\u7684\u533a\u57df\u3002\u8fd8\u6709\u4e00\u4e2a\u5c5e\u6027\u662f\u96fe\u7684\u6d53\u5ea6\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u4f7f\u7528\u96fe\u7279\u6548\uff0c\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\uff0c\u5f533D\u573a\u666f\u7684\u7269\u4f53\u8fdc\u79bb\u6444\u50cf\u673a\u65f6\uff0c\u4f7f\u5b83\u4eec\u892a\u8272\u5230\u96fe\u7684\u989c\u8272\u3002\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4f46\u8fdc\u5904\u7684\u7269\u4f53\u5c06\u65e0\u6cd5\u5206\u8fa8\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u4e00\u4e2a\u53c2\u6570\uff0c\u53ef\u4ee5\u7528\u6765\u6df7\u5408\u96fe\u7684\u989c\u8272\u4e0e\u6bcf\u4e2a\u7247\u5143\u7684\u989c\u8272\uff0c\u4ee5\u6a21\u62df\u96fe\u7279\u6548\u3002\u8fd9\u4e2a\u53c2\u6570\u53d6\u51b3\u4e8e\u4e0e\u6444\u50cf\u673a\u76f8\u8ddd\u7684\u8ddd\u79bb\u3002 \u8ba9\u6211\u4eec\u628a\u8fd9\u4e2a\u53c2\u6570\u547d\u540d\u4e3a fogFactor \uff0c\u5e76\u8bbe\u5b9a\u5b83\u7684\u8303\u56f4\u4e3a0\u52301\u3002\u5f53 fogFactor \u4e3a1\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u4e0d\u4f1a\u53d7\u5230\u96fe\u7684\u5f71\u54cd\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u662f\u8f83\u8fd1\u7684\u7269\u4f53\u3002\u5f53 fogFactor \u4e3a0\u65f6\uff0c\u610f\u5473\u7740\u7269\u4f53\u5b8c\u5168\u9690\u85cf\u5728\u96fe\u4e2d\u3002 \u7136\u540e\uff0c\u8ba1\u7b97\u96fe\u8272\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a finalColour = (1 - fogFactor) \\cdot fogColour + fogFactor \\cdot framentColour finalColour \u662f\u4f7f\u7528\u96fe\u7279\u6548\u7684\u6700\u7ec8\u989c\u8272\u3002 fogFactor \u662f\u63a7\u5236\u96fe\u7684\u989c\u8272\u4e0e\u7247\u5143\u7684\u989c\u8272\u5982\u4f55\u6df7\u5408\u7684\u53c2\u6570\uff0c\u5b83\u57fa\u672c\u4e0a\u63a7\u5236\u7269\u4f53\u7684\u53ef\u89c1\u6027\u3002 fogColour \u662f\u96fe\u7684\u989c\u8272\u3002 fragmentColour \u6ca1\u6709\u4f7f\u7528\u96fe\u7279\u6548\u7684\u7247\u5143\u989c\u8272\u3002 \u73b0\u5728\u6211\u4eec\u9700\u8981\u627e\u5230\u4e00\u79cd\u65b9\u6cd5\u6765\u57fa\u4e8e\u8ddd\u79bb\u8ba1\u7b97 fogFactor \u3002\u6211\u4eec\u53ef\u4ee5\u9009\u62e9\u4e0d\u540c\u7684\u6a21\u578b\uff0c\u9996\u5148\u4f7f\u7528\u7ebf\u6027\u6a21\u578b\u3002\u8fd9\u662f\u4e00\u4e2a\u7ed9\u5b9a\u8ddd\u79bb\u4ee5\u7ebf\u6027\u65b9\u5f0f\u6539\u53d8 fogFactor \u7684\u6a21\u578b\u3002 \u7ebf\u6027\u6a21\u578b\u7531\u4ee5\u4e0b\u53c2\u6570\u5b9a\u4e49\uff1a fogStart : \u5f00\u59cb\u4f7f\u7528\u96fe\u7279\u6548\u7684\u8ddd\u79bb\u3002 fogFinish : \u96fe\u7279\u6548\u8fbe\u5230\u6700\u5927\u503c\u7684\u8ddd\u79bb\u3002 distance : \u5230\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u3002 \u6709\u4e86\u8fd9\u4e9b\u53c2\u6570\uff0c\u65b9\u7a0b\u5c31\u4f1a\u662f\u8fd9\u6837\u7684\uff1a \\displaystyle fogFactor = \\frac{(fogFinish - distance)}{(fogFinish - fogStart)} \u5bf9\u4e8e\u8ddd\u79bb\u4f4e\u4e8e fogStart \u7684\u7269\u4f53\u6211\u4eec\u7b80\u5355\u5730\u8bbe\u7f6e fogFactor \u4e3a 1 \u3002\u4e0b\u56fe\u8868\u660e\u4e86 fogFactor \u662f\u5982\u4f55\u968f\u7740\u8ddd\u79bb\u53d8\u5316\u800c\u53d8\u5316\u7684\u3002 \u7ebf\u6027\u6a21\u578b\u6613\u4e8e\u8ba1\u7b97\uff0c\u4f46\u4e0d\u592a\u771f\u5b9e\uff0c\u56e0\u4e3a\u5b83\u4e0d\u8003\u8651\u96fe\u6c14\u6d53\u5ea6\u3002\u5b9e\u9645\u4e0a\u96fe\u5f80\u5f80\u4ee5\u66f4\u5e73\u6ed1\u7684\u65b9\u5f0f\u589e\u52a0\u3002\u6240\u4ee5\u4e0b\u4e00\u4e2a\u5408\u9002\u7684\u6a21\u578b\u662f\u6307\u6570\u6a21\u578b\u3002\u8be5\u6a21\u578b\u7684\u65b9\u7a0b\u5982\u4e0b\uff1a \\displaystyle focFactor = e^{-(distance \\cdot fogDensity)^{exponent}} = \\frac{1}{e^{(distance \\cdot fogDensity)^{exponent}}} \u5176\u4e2d\u7684\u65b0\u53d8\u91cf\u5982\u4e0b\u6240\u8ff0\uff1a fogDensity \u662f\u96fe\u7684\u539a\u5ea6\u6216\u6d53\u5ea6\u3002 exponent \u7528\u6765\u63a7\u5236\u96fe\u968f\u7740\u8ddd\u79bb\u7684\u589e\u52a0\u589e\u957f\u7684\u901f\u5ea6\u3002 \u4e0b\u56fe\u663e\u793a\u4e86\u4e24\u4e2a\u56fe\u5f62\uff0c\u5206\u522b\u8bbe\u7f6e\u4e86\u4e0d\u540c\u7684 exponent \u503c\uff08\u84dd\u7ebf\u4e3a 2 \uff0c\u7ea2\u7ebf\u4e3a 4 \uff09\u3002 \u5728\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u4e2a\u516c\u5f0f\uff0c\u8ba9\u5b83\u53ef\u4ee5\u4e3a exponent \u8bbe\u7f6e\u4e0d\u540c\u7684\u503c\uff08\u4f60\u53ef\u4ee5\u5f88\u5bb9\u6613\u5730\u4fee\u6539\u793a\u4f8b\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u503c\uff09\u3002 \u65e2\u7136\u5df2\u7ecf\u89e3\u91ca\u8fc7\u8fd9\u4e2a\u539f\u7406\u4e86\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5b9e\u73b0\u5b83\u3002\u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b9e\u73b0\u96fe\u7279\u6548\uff0c\u56e0\u4e3a\u8fd9\u6709\u6211\u4eec\u9700\u8981\u7684\u6240\u6709\u53d8\u91cf\u3002\u6211\u4eec\u5c06\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u50a8\u5b58\u96fe\u5c5e\u6027\u7684\u7ed3\u6784\u4f53\u3002 struct Fog { int active; vec3 colour; float density; }; active \u5c5e\u6027\u7528\u4e8e\u6fc0\u6d3b\u6216\u5173\u95ed\u96fe\u7279\u6548\u3002\u96fe\u5c5e\u6027\u5c06\u901a\u8fc7\u53e6\u4e00\u4e2a\u88ab\u79f0\u4f5c fog \u7684Uniform\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002 uniform Fog fog; \u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u7740\u96fe\u5c5e\u6027\u7684\u540d\u4e3a Fog \u7684\u65b0\u7c7b\uff0c\u5b83\u662f\u53e6\u4e00\u4e2aPOJO\uff08Plain Ordinary Java Object\uff0c\u7b80\u5355\u7684Java\u5bf9\u8c61\uff09\u3002 package org.lwjglb.engine.graph.weather; import org.joml.Vector3f; public class Fog { private boolean active; private Vector3f colour; private float density; public static Fog NOFOG = new Fog(); public Fog() { active = false; this.colour = new Vector3f(0, 0, 0); this.density = 0; } public Fog(boolean active, Vector3f colour, float density) { this.colour = colour; this.density = density; this.active = active; } // Getters and setters here\u2026. \u6211\u4eec\u5c06\u5728 Scene \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a Fog \u793a\u4f8b\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c Scene \u7c7b\u5c06\u521d\u59cb\u5316\u4e00\u4e2a Fog \u793a\u4f8b\u5230\u5e38\u91cf NOFOG \uff0c\u7528\u4e8e\u6a21\u62df\u5173\u95ed\u96fe\u7279\u6548\u7684\u60c5\u51b5\u3002 \u56e0\u4e3a\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684Uniform\u7c7b\u578b\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u4fee\u6539 ShaderProgram \u7c7b\u6765\u521b\u5efa\u548c\u521d\u59cb\u5316\u96fe\u7684Uniform\u3002 public void createFogUniform(String uniformName) throws Exception { createUniform(uniformName + \".active\"); createUniform(uniformName + \".colour\"); createUniform(uniformName + \".density\"); } public void setUniform(String uniformName, Fog fog) { setUniform(uniformName + \".activeFog\", fog.isActive() ? 1 : 0); setUniform(uniformName + \".colour\", fog.getColour() ); setUniform(uniformName + \".density\", fog.getDensity()); } \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 setupSceneShader \u65b9\u6cd5\u4e2d\u521b\u5efaUniform\uff1a sceneShaderProgram.createFogUniform(\"fog\"); \u7136\u540e\u5728 renderScene \u65b9\u6cd5\u4e2d\u4f7f\u7528\u5b83\uff1a sceneShaderProgram.setUniform(\"fog\", scene.getFog()); \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u5728\u6e38\u620f\u4e2d\u5b9a\u4e49\u96fe\u7279\u6548\uff0c\u4f46\u662f\u9700\u8981\u56de\u5230\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u96fe\u7279\u6548\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a calcFog \u7684\u51fd\u6570\uff0c\u51fd\u6570\u5b9a\u4e49\u5982\u4e0b\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog) { float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fog.colour, colour.xyz, fogFactor); return vec4(resultColour.xyz, colour.w); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9996\u5148\u8ba1\u7b97\u5230\u9876\u70b9\u7684\u8ddd\u79bb\u3002\u9876\u70b9\u5750\u6807\u5b9a\u4e49\u5728 pos \u53d8\u91cf\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u957f\u5ea6\u3002\u7136\u540e\u5229\u7528 exponent \u4e3a2\u7684\u6307\u6570\u6a21\u578b\uff08\u76f8\u5f53\u4e8e\u4e58\u4ee5\u4e24\u6b21\uff09\u8ba1\u7b97\u96fe\u53c2\u6570\u3002\u6211\u4eec\u5f97\u5230\u7684 fogFactor \u7684\u8303\u56f4\u5728 0 \u5230 1 \u4e4b\u95f4\uff0c\u5e76\u4f7f\u7528 mix \u51fd\u6570\u3002\u5728GLSL\u4e2d\uff0c min \u51fd\u6570\u88ab\u7528\u4e8e\u6df7\u5408\u96fe\u8272\u548c\u56fe\u5143\u989c\u8272\uff08\u7531\u989c\u8272\u53d8\u91cf\u5b9a\u4e49\uff09\u3002\u76f8\u5f53\u4e8e\u4f7f\u7528\u5982\u4e0b\u65b9\u7a0b\uff1a resultColour = (1 - fogFactor) \\cdot fog.colour + fogFactor \\cdot colour \u6211\u4eec\u8fd8\u4e3a\u989c\u8272\u4fdd\u7559\u4e86 w \u5143\u7d20\uff0c\u5373\u900f\u660e\u5ea6\u3002\u6211\u4eec\u4e0d\u5e0c\u671b\u8fd9\u4e2a\u5143\u7d20\u53d7\u5230\u5f71\u54cd\uff0c\u7247\u5143\u5e94\u8be5\u4fdd\u6301\u5b83\u7684\u900f\u660e\u7a0b\u5ea6\u4e0d\u53d8\u3002 \u5728\u5e94\u7528\u4e86\u6240\u6709\u7684\u5149\u6548\u4e4b\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u6700\u540e\uff0c\u5982\u679c\u96fe\u7279\u6548\u542f\u7528\u7684\u8bdd\uff0c\u6211\u4eec\u5c06\u7b80\u5355\u5730\u628a\u8fd4\u56de\u503c\u8bbe\u7f6e\u4e3a\u7247\u5143\u989c\u8272\u3002 if ( fog.activeFog == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog); } \u6240\u6709\u8fd9\u4e9b\u4ee3\u7801\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u53ef\u4ee5\u7528\u4e0b\u9762\u7684\u6570\u636e\u8bbe\u7f6e\u4e00\u4e2a\u96fe\u7279\u6548\uff1a scene.setFog(new Fog(true, new Vector3f(0.5f, 0.5f, 0.5f), 0.15f)); \u7136\u540e\u6211\u4eec\u5c06\u83b7\u5f97\u50cf\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f60\u4f1a\u770b\u5230\u8fdc\u5904\u7684\u7269\u4f53\u892a\u8272\uff0c\u5f53\u4f60\u9760\u8fd1\u5b83\u4eec\u65f6\uff0c\u96fe\u5f00\u59cb\u6d88\u5931\u3002\u4f46\u6709\u4e00\u4e2a\u95ee\u9898\uff0c\u5929\u7a7a\u76d2\u770b\u8d77\u6765\u6709\u70b9\u5947\u602a\uff0c\u5730\u5e73\u7ebf\u4e0d\u53d7\u96fe\u7684\u5f71\u54cd\u3002\u6709\u51e0\u79cd\u65b9\u6cd5\u53ef\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1a \u4f7f\u7528\u53ea\u80fd\u770b\u5230\u5929\u7a7a\u7684\u53e6\u4e00\u4e2a\u4e0d\u540c\u7684\u5929\u7a7a\u76d2\u3002 \u5220\u9664\u5929\u7a7a\u76d2\uff0c\u56e0\u4e3a\u6709\u6d53\u96fe\uff0c\u4f60\u4e0d\u5e94\u8be5\u80fd\u591f\u770b\u5230\u4e00\u4e2a\u80cc\u666f\u3002 \u4e5f\u53ef\u80fd\u8fd9\u4e24\u4e2a\u89e3\u51b3\u65b9\u6848\u6ca1\u6709\u9002\u5408\u4f60\u7684\uff0c\u4f60\u53ef\u4ee5\u8bd5\u7740\u5c06\u96fe\u8272\u4e0e\u5929\u7a7a\u76d2\u7684\u80cc\u666f\u76f8\u5339\u914d\uff0c\u4f46\u8fd9\u6837\u4f60\u4f1a\u505a\u590d\u6742\u7684\u8ba1\u7b97\uff0c\u7ed3\u679c\u4e5f\u8bb8\u4e0d\u4f1a\u66f4\u597d\u3002 \u5982\u679c\u4f60\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u4f1a\u611f\u5230\u5e73\u884c\u5149\u53d8\u5f97\u6697\u6de1\uff0c\u573a\u666f\u53d8\u6697\uff0c\u4f46\u96fe\u770b\u8d77\u6765\u6709\u95ee\u9898\uff0c\u56e0\u4e3a\u5b83\u4e0d\u53d7\u5149\u7684\u5f71\u54cd\uff0c\u4f1a\u770b\u5230\u5982\u4e0b\u56fe\u6240\u793a\u7684\u7ed3\u679c\u3002 \u8fdc\u5904\u7684\u7269\u4f53\u53d8\u4e3a\u96fe\u8272\uff0c\u8fd9\u662f\u4e00\u4e2a\u4e0d\u53d7\u5149\u5f71\u54cd\u7684\u5e38\u6570\u3002\u8fd9\u9020\u6210\u4e86\u4e00\u4e2a\u5728\u9ed1\u6697\u4e2d\u53d1\u5149\u7684\u6548\u679c\uff08\u8fd9\u53ef\u80fd\u5e76\u4e0d\u597d\uff09\u3002\u6211\u4eec\u9700\u8981\u4fee\u6539\u8ba1\u7b97\u96fe\u7684\u51fd\u6570\uff0c\u8ba9\u5176\u8003\u8651\u5149\u7167\u3002\u8be5\u51fd\u6570\u5c06\u63a5\u6536\u73af\u5883\u5149\u548c\u5e73\u884c\u5149\u6765\u8c03\u6574\u96fe\u8272\u3002 vec4 calcFog(vec3 pos, vec4 colour, Fog fog, vec3 ambientLight, DirectionalLight dirLight) { vec3 fogColor = fog.colour * (ambientLight + dirLight.colour * dirLight.intensity); float distance = length(pos); float fogFactor = 1.0 / exp( (distance * fog.density)* (distance * fog.density)); fogFactor = clamp( fogFactor, 0.0, 1.0 ); vec3 resultColour = mix(fogColor, colour.xyz, fogFactor); return vec4(resultColour.xyz, 1); } \u5982\u4f60\u6240\u89c1\uff0c\u5e73\u884c\u5149\u6211\u4eec\u4ec5\u4f7f\u7528\u4e86\u989c\u8272\u548c\u5f3a\u5ea6\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u5173\u6ce8\u5b83\u7684\u65b9\u5411\u3002\u8fd9\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7a0d\u5fae\u4fee\u6539\u51fd\u6570\u7684\u8c03\u7528\uff1a if ( fog.active == 1 ) { fragColor = calcFog(mvVertexPos, fragColor, fog, ambientLight, directionalLight); } \u5728\u591c\u665a\u65f6\uff0c\u6211\u4eec\u4f1a\u770b\u5230\u8fd9\u6837\u7684\u6548\u679c\u3002 \u4e00\u4e2a\u8981\u5f3a\u8c03\u7684\u91cd\u8981\u7684\u4e8b\u60c5\u662f\uff0c\u6211\u4eec\u5fc5\u987b\u806a\u660e\u5730\u9009\u62e9\u96fe\u8272\u3002\u8fd9\u662f\u5f88\u91cd\u8981\u7684\uff0c\u5f53\u6211\u4eec\u6ca1\u6709\u5929\u7a7a\u76d2\uff0c\u4f46\u6709\u56fa\u5b9a\u7684\u989c\u8272\u80cc\u666f\uff0c\u5e94\u8be5\u628a\u96fe\u8272\u8bbe\u7f6e\u4e3a\u80cc\u666f\u8272\u3002\u5982\u679c\u4f60\u5220\u9664\u4e86\u5929\u7a7a\u76d2\u7684\u4ee3\u7801\u5e76\u91cd\u65b0\u8fd0\u884c\u793a\u4f8b\u4ee3\u7801\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\u3002 \u4f46\u5982\u679c\u6211\u4eec\u628a\u80cc\u666f\u8272\u4fee\u6539\u4e3a\uff080.5, 0.5, 0.5\uff09\uff0c\u6700\u7ec8\u7ed3\u679c\u770b\u8d77\u6765\u5c31\u662f\u5982\u4e0b\u6240\u793a\u3002","title":"\u96fe\uff08Fog\uff09"},{"location":"17-normal-mapping/","text":"\u6cd5\u7ebf\u8d34\u56fe\uff08Normal Mapping\uff09 \u672c\u7ae0\u4e2d\u5c06\u8bb2\u89e3\u4e00\u9879\u6280\u672f\uff0c\u5b83\u5c06\u6781\u5927\u5730\u6539\u5584\u6211\u4eec\u76843D\u6a21\u578b\u7684\u5916\u89c2\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u80fd\u591f\u5c06\u7eb9\u7406\u4f7f\u7528\u5230\u590d\u6742\u76843D\u6a21\u578b\u4e0a\uff0c\u4f46\u8fd9\u8fd8\u79bb\u771f\u5b9e\u7269\u4f53\u7684\u6837\u5b50\u5f88\u8fdc\u3002\u73b0\u5b9e\u4e16\u754c\u4e2d\u7684\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u5149\u6ed1\u7684\uff0c\u5b83\u4eec\u6709\u6211\u4eec\u76843D\u6a21\u578b\u76ee\u524d\u6240\u4e0d\u5177\u6709\u7684\u7455\u75b5\u3002 \u4e3a\u4e86\u6e32\u67d3\u66f4\u771f\u5b9e\u7684\u573a\u666f\uff0c\u6211\u4eec\u5c06\u6e32\u67d3 \u6cd5\u7ebf\u8d34\u56fe(Normal Mapping) \u3002\u5982\u679c\u4f60\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\u770b\u5230\u4e00\u4e2a\u5e73\u9762\uff0c\u4f60\u4f1a\u53d1\u73b0\u90a3\u4e9b\u7455\u75b5\u751a\u81f3\u53ef\u4ee5\u5728\u5f88\u8fdc\u7684\u8ddd\u79bb\u770b\u5230\u3002\u57283D\u573a\u666f\u4e2d\uff0c\u5e73\u9762\u6ca1\u6709\u7455\u75b5\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u7eb9\u7406\u5e94\u7528\u5728\u5b83\u4e4b\u4e0a\uff0c\u4f46\u8fd9\u4e0d\u4f1a\u6539\u53d8\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0e\u73b0\u5b9e\u6709\u533a\u522b\u7684\u539f\u56e0\u3002 \u6211\u4eec\u53ef\u4ee5\u8003\u8651\u901a\u8fc7\u589e\u52a0\u4e09\u89d2\u5f62\u6570\u91cf\u6765\u589e\u52a0\u6a21\u578b\u7684\u7ec6\u8282\u5e76\u53cd\u6620\u51fa\u8fd9\u4e9b\u7455\u75b5\uff0c\u4f46\u6027\u80fd\u4f1a\u4e0b\u964d\u3002\u6211\u4eec\u9700\u8981\u7684\u662f\u6539\u53d8\u8868\u9762\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u6765\u589e\u52a0\u771f\u5b9e\u611f\u3002\u8fd9\u5c31\u662f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6280\u672f\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u5149\u6ed1\u5e73\u9762\u7684\u4f8b\u5b50\uff0c\u4e00\u4e2a\u5e73\u9762\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u4e3a\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002\u56de\u5fc6\u4e4b\u524d\u7684\u5149\u7167\u7ae0\u8282\uff0c\u6a21\u578b\u7684\u5149\u53cd\u5c04\u7684\u8981\u7d20\u662f\u5e73\u9762\u6cd5\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u6574\u4e2a\u5e73\u9762\u4ec5\u6709\u5355\u4e00\u7684\u6cd5\u7ebf\uff0c\u5f53\u8ba1\u7b97\u5149\u5982\u4f55\u5f71\u54cd\u7247\u5143\u65f6\uff0c\u6bcf\u4e2a\u7247\u5143\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u6cd5\u7ebf\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u5982\u679c\u53ef\u4ee5\u6539\u53d8\u5e73\u9762\u7684\u6bcf\u4e2a\u7247\u5143\u7684\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6a21\u62df\u5e73\u9762\u7684\u7455\u75b5\uff0c\u4f7f\u5b83\u4eec\u66f4\u903c\u771f\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u8981\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u6211\u4eec\u8981\u52a0\u8f7d\u53e6\u4e00\u4e2a\u7eb9\u7406\uff0c\u5b83\u50a8\u5b58\u9762\u7684\u6cd5\u7ebf\u3002\u6cd5\u7ebf\u7eb9\u7406\u7684\u6bcf\u4e2a\u50cf\u7d20\u5c06\u4ee5RGB\u503c\u50a8\u5b58\u6cd5\u7ebf\u7684 x \u3001 y \u548c z \u5750\u6807\u503c\u3002 \u8ba9\u6211\u4eec\u7528\u4e0b\u9762\u7684\u7eb9\u7406\u7ed8\u5236\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002 \u4e0a\u56fe\u7684\u6cd5\u7ebf\u7eb9\u7406\u5982\u4e0b\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5982\u679c\u6211\u4eec\u628a\u989c\u8272\u53d8\u6362\u5e94\u7528\u5230\u539f\u59cb\u7eb9\u7406\uff0c\u6bcf\u4e2a\u50cf\u7d20\u4f7f\u7528\u989c\u8272\u5206\u91cf\u50a8\u5b58\u6cd5\u7ebf\u4fe1\u606f\u3002\u5728\u770b\u5230\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u4f60\u5e38\u5e38\u4f1a\u770b\u5230\u4e3b\u8272\u8c03\u503e\u5411\u4e8e\u84dd\u8272\uff0c\u8fd9\u662f\u7531\u4e8e\u5927\u591a\u6570\u6cd5\u7ebf\u6307\u5411\u8f6c\u6362\u6b63 z \u8f74\u6240\u81f4\u3002\u5728\u4e00\u4e2a\u5e73\u9762\u8868\u9762\u7684\u77e2\u91cf\u4e2d\uff0c z \u5206\u91cf\u901a\u5e38\u6bd4 x \u548c y \u5206\u91cf\u7684\u503c\u9ad8\u5f97\u591a\u3002\u7531\u4e8e x \u3001 y \u3001 z \u5750\u6807\u88ab\u6620\u5c04\u5230RGB\uff0c\u5bfc\u81f4\u84dd\u8272\u5206\u91cf\u4e5f\u6709\u7740\u66f4\u9ad8\u7684\u503c\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6e32\u67d3\u5bf9\u8c61\u53ea\u9700\u8981\u4e00\u4e2a\u989d\u5916\u7684\u7eb9\u7406\uff0c\u5e76\u540c\u65f6\u4f7f\u7528\u5b83\u6e32\u67d3\u7247\u5143\u4ee5\u83b7\u5f97\u9002\u5f53\u7684\u6cd5\u7ebf\u503c\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u6cd5\u7ebf\u8d34\u56fe\u3002\u6211\u4eec\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 Texture \u5b9e\u4f8b\u5230 Material \u7c7b\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u628a\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u6dfb\u52a0\u5230\u6e38\u620f\u9879\u76ee\u4e0a\u3002\u6b64\u5b9e\u4f8b\u5c06\u6709\u81ea\u5df1\u7684 get \u548c set \u65b9\u6cd5\uff0c\u5e76\u6709\u65b9\u6cd5\u53ef\u4ee5\u68c0\u67e5 Material \u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002 public class Material { private static final Vector4f DEFAULT_COLOUR = new Vector3f(1.0f, 1.0f, 1.0f, 10.f); private Vector3f ambientColour; private Vector3f diffuseColour; private Vector3f specularColour; private float reflectance; private Texture texture; private Texture normalMap; // \u2026 Previous code here public boolean hasNormalMap() { return this.normalMap != null; } public Texture getNormalMap() { return normalMap; } public void setNormalMap(Texture normalMap) { this.normalMap = normalMap; } } \u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u4f46\u662f\uff0c\u7531\u4e8e\u6211\u4eec\u5728\u89c2\u5bdf\u5750\u6807\u7a7a\u95f4\u64cd\u4f5c\uff0c\u6240\u4ee5\u9700\u8981\u901a\u8fc7\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6765\u8fdb\u884c\u9002\u5f53\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; outModelViewMatrix = modelViewMatrix; } \u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u8f93\u5165\u53c2\u6570\u3002 in mat4 outModelViewMatrix; \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u91c7\u6837\u5668\u4f20\u9012\u4e00\u4e2a\u65b0\u7684Uniform\uff1a uniform sampler2D texture_sampler; \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u8ba1\u7b97\u5f53\u524d\u7247\u5143\u7684\u6cd5\u7ebf\u3002 vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelViewMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(modelViewMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } \u8be5\u51fd\u6570\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * Material \u5b9e\u4f8b\u3002 * \u9876\u70b9\u6cd5\u7ebf\u3002 * \u7eb9\u7406\u5750\u6807\u3002 * \u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002 \u6211\u4eec\u5728\u6b64\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u68c0\u67e5\u8fd9\u4e2a Material \u5b9e\u4f8b\u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u6ca1\u6709\uff0c\u6211\u4eec\u5c31\u50cf\u5e73\u5e38\u4e00\u6837\u7b80\u5355\u5730\u4f7f\u7528\u9876\u70b9\u6cd5\u7ebf\u3002\u5982\u679c\u5b83\u6709\u6cd5\u7ebf\u8d34\u56fe\uff0c\u6211\u4eec\u4f7f\u7528\u50a8\u5b58\u7740\u6cd5\u7ebf\u6570\u636e\u7684\u6cd5\u7ebf\u7eb9\u7406\u5173\u8054\u5230\u5f53\u524d\u7eb9\u7406\u5750\u6807\u3002 \u8bb0\u4f4f\u6211\u4eec\u53d6\u5f97\u7684\u989c\u8272\u662f\u6cd5\u7ebf\u5750\u6807\uff0c\u4f46\u56e0\u4e3a\u5b83\u4eec\u88ab\u50a8\u5b58\u4e3aRGB\u503c\uff0c\u6240\u4ee5\u5b83\u4eec\u7684\u503c\u5728\u8303\u56f4 0, 1 \u4e2d\u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8303\u56f4\u8f6c\u6362\u4e3a -1, 1 \uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u5176\u4e58\u4ee52\u7136\u540e\u51cf\u53bb1\u3002\u7136\u540e\uff0c\u6211\u4eec\u5c06\u5b83\u5f52\u4e00\u5316\uff0c\u5e76\u5c06\u5176\u8f6c\u6362\u5230\u6a21\u578b\u89c2\u5bdf\u5750\u6807\u7cfb\uff08\u5c31\u50cf\u9876\u70b9\u6cd5\u7ebf\u90a3\u6837\uff09\u3002 \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd4\u56de\u503c\u4f5c\u4e3a\u7247\u5143\u6240\u6709\u5149\u7167\u8ba1\u7b97\u4e2d\u7684\u6cd5\u7ebf\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u6cd5\u7ebf\u8d34\u56fe\uff0c\u5728 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u505a\u5982\u4e0b\u8bbe\u7f6e\uff1a //... sceneShaderProgram.setUniform(\"fog\", scene.getFog()); sceneShaderProgram.setUniform(\"texture_sampler\", 0); sceneShaderProgram.setUniform(\"normalMap\", 1); //... \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e00\u4e9b\u6709\u8da3\u7684\u4e8b\u60c5\u3002\u6211\u4eec\u5c06\u6750\u8d28\u7eb9\u7406Uniform\uff08 texture_sampler \uff09\u8bbe\u7f6e\u4e3a 0 \uff0c\u7136\u540e\u5c06\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\uff08 normalMap \uff09\u8bbe\u7f6e\u4e3a 1 \u3002\u5982\u679c\u4f60\u56de\u60f3\u7eb9\u7406\u7ae0\u8282\uff0c\u6211\u4eec\u4e0d\u6b62\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u4e3a\u6bcf\u4e2a\u5355\u72ec\u7684\u7eb9\u7406\u8bbe\u7f6e\u7eb9\u7406\u5355\u5143\u3002 \u5f53\u6211\u4eec\u6e32\u67d3 Mesh \u65f6\uff0c\u4e5f\u9700\u8981\u8003\u8651\u8fd9\u4e00\u70b9\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } Texture normalMap = material.getNormalMap(); if ( normalMap != null ) { // \u6fc0\u6d3b\u7b2c\u4e8c\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE1); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, normalMap.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u6bcf\u4e2a\u53ef\u7528\u7684\u7eb9\u7406\uff0c\u5e76\u6fc0\u6d3b\u76f8\u5173\u7684\u7eb9\u7406\u5355\u5143\uff0c\u4ee5\u4fbf\u591a\u4e2a\u7eb9\u7406\u80fd\u591f\u540c\u65f6\u5de5\u4f5c\u3002\u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u663e\u5f0f\u8bbe\u7f6e\u7eb9\u7406\u7684Uniform\uff0c\u56e0\u4e3a\u5b83\u5df2\u7ecf\u5305\u542b\u5728 Material \u4e2d\u3002 \u4e3a\u4e86\u5c55\u793a\u6cd5\u7ebf\u8d34\u56fe\u5e26\u6765\u7684\u63d0\u5347\uff0c\u6211\u5df2\u7ecf\u521b\u5efa\u4e86\u4e24\u4e2a\u5e76\u6392\u663e\u793a\u7684\u56db\u8fb9\u5f62\u793a\u4f8b\u3002\u53f3\u8fb9\u7684\u6709\u4e00\u5f20\u6cd5\u7ebf\u8d34\u56fe\uff0c\u800c\u5de6\u8fb9\u6ca1\u6709\u3002\u6211\u4eec\u8fd8\u5220\u9664\u4e86\u5730\u5f62\u3001\u5929\u7a7a\u76d2\u548cHUD\uff0c\u5e76\u8bbe\u7f6e\u4e86\u5e73\u884c\u5149\u7167\uff0c\u53ef\u4ee5\u7528\u9f20\u6807\u5de6\u53f3\u952e\u6539\u53d8\u65b9\u5411\uff0c\u8fd9\u6837\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\u4e86\u3002\u6211\u5df2\u7ecf\u4fee\u6539\u4e86\u57fa\u672c\u6e90\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u5173\u95ed\u5929\u7a7a\u76d2\u548c\u5730\u5f62\u3002\u6211\u4eec\u8fd8\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u8bbe\u7f6e\u4e86\u5149\u6548\u679c\u7684\u8303\u56f4\u4e3a 0, 1 \uff0c\u4ee5\u907f\u514d\u56fe\u50cf\u8fc7\u5ea6\u66dd\u5149\u3002 \u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5177\u6709\u6cd5\u7ebf\u8d34\u56fe\u7684\u56db\u8fb9\u5f62\u611f\u89c9\u66f4\u5927\u3002\u867d\u7136\u5b83\u672c\u8d28\u4e0a\u662f\u4e00\u4e2a\u50cf\u5176\u4ed6\u56db\u8fb9\u5f62\u4e00\u6837\u7684\u5e73\u9762\uff0c\u4f46\u4f60\u53ef\u4ee5\u770b\u5230\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002 \u5c3d\u7ba1\u6211\u4eec\u5df2\u7ecf\u7f16\u5199\u7684\u4ee3\u7801\u5b8c\u5168\u7b26\u5408\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f46\u4f60\u9700\u8981\u77e5\u9053\u5b83\u7684\u5c40\u9650\u6027\u3002\u8be5\u4ee3\u7801\u4ec5\u9002\u7528\u4e0e\u4f7f\u7528\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u521b\u5efa\u7684\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u5982\u679c\u662f\u8fd9\u79cd\u60c5\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u6765\u5c06\u6cd5\u7ebf\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002 \u4f46\u901a\u5e38\u6cd5\u7ebf\u8d34\u56fe\u4e0d\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\u3002\u5b83\u4eec\u901a\u5e38\u88ab\u5b9a\u4e49\u5728\u6240\u8c13\u7684 \u5207\u7ebf\u7a7a\u95f4\uff08 Tangent Space \uff09 \u4e2d\u3002\u5207\u7ebf\u7a7a\u95f4\u662f\u4e00\u4e2a\u5750\u6807\u7cfb\uff0c\u5b83\u5b9a\u4f4d\u5728\u6a21\u578b\u7684\u6bcf\u4e2a\u4e09\u89d2\u5f62\uff0c\u5176\u5750\u6807\u7cfb\u7684 z \u8f74\u603b\u662f\u5782\u76f4\u4e8e\u8868\u9762\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5f53\u4f60\u770b\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u5b83\u901a\u5e38\u662f\u84dd\u8272\u7684\uff0c\u751a\u81f3\u5bf9\u4e8e\u9762\u76f8\u5bf9\u590d\u6742\u7684\u6a21\u578b\u4e5f\u662f\u5982\u6b64\u3002 \u6211\u4eec\u73b0\u5728\u4ecd\u4f7f\u7528\u8fd9\u4e2a\u7b80\u5355\u7684\u5b9e\u73b0\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5fc5\u987b\u603b\u662f\u4f7f\u7528\u5728\u6a21\u578b\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u4f7f\u7528\u5207\u7ebf\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u8d34\u56fe\uff0c\u5c31\u4f1a\u53d8\u5f97\u5f88\u5947\u602a\u3002\u4e3a\u4e86\u80fd\u591f\u8ba9\u5b83\u4eec\u4e00\u540c\u5de5\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u7279\u5b9a\u7684\u77e9\u9635\u6765\u5c06\u5750\u6807\u53d8\u6362\u5230\u5207\u7ebf\u7a7a\u95f4\u3002","title":"\u6cd5\u7ebf\u8d34\u56fe"},{"location":"17-normal-mapping/#normal-mapping","text":"\u672c\u7ae0\u4e2d\u5c06\u8bb2\u89e3\u4e00\u9879\u6280\u672f\uff0c\u5b83\u5c06\u6781\u5927\u5730\u6539\u5584\u6211\u4eec\u76843D\u6a21\u578b\u7684\u5916\u89c2\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u80fd\u591f\u5c06\u7eb9\u7406\u4f7f\u7528\u5230\u590d\u6742\u76843D\u6a21\u578b\u4e0a\uff0c\u4f46\u8fd9\u8fd8\u79bb\u771f\u5b9e\u7269\u4f53\u7684\u6837\u5b50\u5f88\u8fdc\u3002\u73b0\u5b9e\u4e16\u754c\u4e2d\u7684\u7269\u4f53\u8868\u9762\u4e0d\u662f\u5b8c\u5168\u5149\u6ed1\u7684\uff0c\u5b83\u4eec\u6709\u6211\u4eec\u76843D\u6a21\u578b\u76ee\u524d\u6240\u4e0d\u5177\u6709\u7684\u7455\u75b5\u3002 \u4e3a\u4e86\u6e32\u67d3\u66f4\u771f\u5b9e\u7684\u573a\u666f\uff0c\u6211\u4eec\u5c06\u6e32\u67d3 \u6cd5\u7ebf\u8d34\u56fe(Normal Mapping) \u3002\u5982\u679c\u4f60\u5728\u73b0\u5b9e\u4e16\u754c\u4e2d\u770b\u5230\u4e00\u4e2a\u5e73\u9762\uff0c\u4f60\u4f1a\u53d1\u73b0\u90a3\u4e9b\u7455\u75b5\u751a\u81f3\u53ef\u4ee5\u5728\u5f88\u8fdc\u7684\u8ddd\u79bb\u770b\u5230\u3002\u57283D\u573a\u666f\u4e2d\uff0c\u5e73\u9762\u6ca1\u6709\u7455\u75b5\uff0c\u6211\u4eec\u53ef\u4ee5\u5c06\u7eb9\u7406\u5e94\u7528\u5728\u5b83\u4e4b\u4e0a\uff0c\u4f46\u8fd9\u4e0d\u4f1a\u6539\u53d8\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u4e0e\u73b0\u5b9e\u6709\u533a\u522b\u7684\u539f\u56e0\u3002 \u6211\u4eec\u53ef\u4ee5\u8003\u8651\u901a\u8fc7\u589e\u52a0\u4e09\u89d2\u5f62\u6570\u91cf\u6765\u589e\u52a0\u6a21\u578b\u7684\u7ec6\u8282\u5e76\u53cd\u6620\u51fa\u8fd9\u4e9b\u7455\u75b5\uff0c\u4f46\u6027\u80fd\u4f1a\u4e0b\u964d\u3002\u6211\u4eec\u9700\u8981\u7684\u662f\u6539\u53d8\u8868\u9762\u5149\u53cd\u5c04\u7684\u65b9\u5f0f\u6765\u589e\u52a0\u771f\u5b9e\u611f\u3002\u8fd9\u5c31\u662f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6280\u672f\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u770b\u770b\u5149\u6ed1\u5e73\u9762\u7684\u4f8b\u5b50\uff0c\u4e00\u4e2a\u5e73\u9762\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u4e3a\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002\u56de\u5fc6\u4e4b\u524d\u7684\u5149\u7167\u7ae0\u8282\uff0c\u6a21\u578b\u7684\u5149\u53cd\u5c04\u7684\u8981\u7d20\u662f\u5e73\u9762\u6cd5\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u6574\u4e2a\u5e73\u9762\u4ec5\u6709\u5355\u4e00\u7684\u6cd5\u7ebf\uff0c\u5f53\u8ba1\u7b97\u5149\u5982\u4f55\u5f71\u54cd\u7247\u5143\u65f6\uff0c\u6bcf\u4e2a\u7247\u5143\u90fd\u4f7f\u7528\u76f8\u540c\u7684\u6cd5\u7ebf\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u5982\u679c\u53ef\u4ee5\u6539\u53d8\u5e73\u9762\u7684\u6bcf\u4e2a\u7247\u5143\u7684\u6cd5\u7ebf\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6a21\u62df\u5e73\u9762\u7684\u7455\u75b5\uff0c\u4f7f\u5b83\u4eec\u66f4\u903c\u771f\u3002\u770b\u8d77\u6765\u5c31\u50cf\u4e0b\u56fe\u90a3\u6837\u3002 \u8981\u505a\u5230\u8fd9\u4e00\u70b9\uff0c\u6211\u4eec\u8981\u52a0\u8f7d\u53e6\u4e00\u4e2a\u7eb9\u7406\uff0c\u5b83\u50a8\u5b58\u9762\u7684\u6cd5\u7ebf\u3002\u6cd5\u7ebf\u7eb9\u7406\u7684\u6bcf\u4e2a\u50cf\u7d20\u5c06\u4ee5RGB\u503c\u50a8\u5b58\u6cd5\u7ebf\u7684 x \u3001 y \u548c z \u5750\u6807\u503c\u3002 \u8ba9\u6211\u4eec\u7528\u4e0b\u9762\u7684\u7eb9\u7406\u7ed8\u5236\u4e00\u4e2a\u56db\u8fb9\u5f62\u3002 \u4e0a\u56fe\u7684\u6cd5\u7ebf\u7eb9\u7406\u5982\u4e0b\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5982\u679c\u6211\u4eec\u628a\u989c\u8272\u53d8\u6362\u5e94\u7528\u5230\u539f\u59cb\u7eb9\u7406\uff0c\u6bcf\u4e2a\u50cf\u7d20\u4f7f\u7528\u989c\u8272\u5206\u91cf\u50a8\u5b58\u6cd5\u7ebf\u4fe1\u606f\u3002\u5728\u770b\u5230\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u4f60\u5e38\u5e38\u4f1a\u770b\u5230\u4e3b\u8272\u8c03\u503e\u5411\u4e8e\u84dd\u8272\uff0c\u8fd9\u662f\u7531\u4e8e\u5927\u591a\u6570\u6cd5\u7ebf\u6307\u5411\u8f6c\u6362\u6b63 z \u8f74\u6240\u81f4\u3002\u5728\u4e00\u4e2a\u5e73\u9762\u8868\u9762\u7684\u77e2\u91cf\u4e2d\uff0c z \u5206\u91cf\u901a\u5e38\u6bd4 x \u548c y \u5206\u91cf\u7684\u503c\u9ad8\u5f97\u591a\u3002\u7531\u4e8e x \u3001 y \u3001 z \u5750\u6807\u88ab\u6620\u5c04\u5230RGB\uff0c\u5bfc\u81f4\u84dd\u8272\u5206\u91cf\u4e5f\u6709\u7740\u66f4\u9ad8\u7684\u503c\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u6e32\u67d3\u5bf9\u8c61\u53ea\u9700\u8981\u4e00\u4e2a\u989d\u5916\u7684\u7eb9\u7406\uff0c\u5e76\u540c\u65f6\u4f7f\u7528\u5b83\u6e32\u67d3\u7247\u5143\u4ee5\u83b7\u5f97\u9002\u5f53\u7684\u6cd5\u7ebf\u503c\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u6cd5\u7ebf\u8d34\u56fe\u3002\u6211\u4eec\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684 Texture \u5b9e\u4f8b\u5230 Material \u7c7b\uff0c\u8fd9\u6837\u5c31\u53ef\u4ee5\u628a\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u6dfb\u52a0\u5230\u6e38\u620f\u9879\u76ee\u4e0a\u3002\u6b64\u5b9e\u4f8b\u5c06\u6709\u81ea\u5df1\u7684 get \u548c set \u65b9\u6cd5\uff0c\u5e76\u6709\u65b9\u6cd5\u53ef\u4ee5\u68c0\u67e5 Material \u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002 public class Material { private static final Vector4f DEFAULT_COLOUR = new Vector3f(1.0f, 1.0f, 1.0f, 10.f); private Vector3f ambientColour; private Vector3f diffuseColour; private Vector3f specularColour; private float reflectance; private Texture texture; private Texture normalMap; // \u2026 Previous code here public boolean hasNormalMap() { return this.normalMap != null; } public Texture getNormalMap() { return normalMap; } public void setNormalMap(Texture normalMap) { this.normalMap = normalMap; } } \u6211\u4eec\u5c06\u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u4f46\u662f\uff0c\u7531\u4e8e\u6211\u4eec\u5728\u89c2\u5bdf\u5750\u6807\u7a7a\u95f4\u64cd\u4f5c\uff0c\u6240\u4ee5\u9700\u8981\u901a\u8fc7\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6765\u8fdb\u884c\u9002\u5f53\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002 #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; outModelViewMatrix = modelViewMatrix; } \u5728\u573a\u666f\u7684\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u53e6\u4e00\u4e2a\u8f93\u5165\u53c2\u6570\u3002 in mat4 outModelViewMatrix; \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u91c7\u6837\u5668\u4f20\u9012\u4e00\u4e2a\u65b0\u7684Uniform\uff1a uniform sampler2D texture_sampler; \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u51fd\u6570\uff0c\u8be5\u51fd\u6570\u8ba1\u7b97\u5f53\u524d\u7247\u5143\u7684\u6cd5\u7ebf\u3002 vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelViewMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(modelViewMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } \u8be5\u51fd\u6570\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * Material \u5b9e\u4f8b\u3002 * \u9876\u70b9\u6cd5\u7ebf\u3002 * \u7eb9\u7406\u5750\u6807\u3002 * \u6a21\u578b\u89c6\u56fe\u77e9\u9635\u3002 \u6211\u4eec\u5728\u6b64\u51fd\u6570\u4e2d\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u68c0\u67e5\u8fd9\u4e2a Material \u5b9e\u4f8b\u662f\u5426\u6709\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u6ca1\u6709\uff0c\u6211\u4eec\u5c31\u50cf\u5e73\u5e38\u4e00\u6837\u7b80\u5355\u5730\u4f7f\u7528\u9876\u70b9\u6cd5\u7ebf\u3002\u5982\u679c\u5b83\u6709\u6cd5\u7ebf\u8d34\u56fe\uff0c\u6211\u4eec\u4f7f\u7528\u50a8\u5b58\u7740\u6cd5\u7ebf\u6570\u636e\u7684\u6cd5\u7ebf\u7eb9\u7406\u5173\u8054\u5230\u5f53\u524d\u7eb9\u7406\u5750\u6807\u3002 \u8bb0\u4f4f\u6211\u4eec\u53d6\u5f97\u7684\u989c\u8272\u662f\u6cd5\u7ebf\u5750\u6807\uff0c\u4f46\u56e0\u4e3a\u5b83\u4eec\u88ab\u50a8\u5b58\u4e3aRGB\u503c\uff0c\u6240\u4ee5\u5b83\u4eec\u7684\u503c\u5728\u8303\u56f4 0, 1 \u4e2d\u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8303\u56f4\u8f6c\u6362\u4e3a -1, 1 \uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u5176\u4e58\u4ee52\u7136\u540e\u51cf\u53bb1\u3002\u7136\u540e\uff0c\u6211\u4eec\u5c06\u5b83\u5f52\u4e00\u5316\uff0c\u5e76\u5c06\u5176\u8f6c\u6362\u5230\u6a21\u578b\u89c2\u5bdf\u5750\u6807\u7cfb\uff08\u5c31\u50cf\u9876\u70b9\u6cd5\u7ebf\u90a3\u6837\uff09\u3002 \u5c31\u8fd9\u6837\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd4\u56de\u503c\u4f5c\u4e3a\u7247\u5143\u6240\u6709\u5149\u7167\u8ba1\u7b97\u4e2d\u7684\u6cd5\u7ebf\u3002 \u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u6cd5\u7ebf\u8d34\u56fe\uff0c\u5728 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u505a\u5982\u4e0b\u8bbe\u7f6e\uff1a //... sceneShaderProgram.setUniform(\"fog\", scene.getFog()); sceneShaderProgram.setUniform(\"texture_sampler\", 0); sceneShaderProgram.setUniform(\"normalMap\", 1); //... \u4e0a\u8ff0\u4ee3\u7801\u4e2d\u4f60\u53ef\u80fd\u6ce8\u610f\u5230\u4e00\u4e9b\u6709\u8da3\u7684\u4e8b\u60c5\u3002\u6211\u4eec\u5c06\u6750\u8d28\u7eb9\u7406Uniform\uff08 texture_sampler \uff09\u8bbe\u7f6e\u4e3a 0 \uff0c\u7136\u540e\u5c06\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\uff08 normalMap \uff09\u8bbe\u7f6e\u4e3a 1 \u3002\u5982\u679c\u4f60\u56de\u60f3\u7eb9\u7406\u7ae0\u8282\uff0c\u6211\u4eec\u4e0d\u6b62\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\uff0c\u6240\u4ee5\u6211\u4eec\u5fc5\u987b\u4e3a\u6bcf\u4e2a\u5355\u72ec\u7684\u7eb9\u7406\u8bbe\u7f6e\u7eb9\u7406\u5355\u5143\u3002 \u5f53\u6211\u4eec\u6e32\u67d3 Mesh \u65f6\uff0c\u4e5f\u9700\u8981\u8003\u8651\u8fd9\u4e00\u70b9\u3002 private void initRender() { Texture texture = material.getTexture(); if (texture != null) { // \u6fc0\u6d3b\u7b2c\u4e00\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE0); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, texture.getId()); } Texture normalMap = material.getNormalMap(); if ( normalMap != null ) { // \u6fc0\u6d3b\u7b2c\u4e8c\u7eb9\u7406\u5e93 glActiveTexture(GL_TEXTURE1); // \u7ed1\u5b9a\u7eb9\u7406 glBindTexture(GL_TEXTURE_2D, normalMap.getId()); } // \u7ed8\u5236\u7f51\u683c glBindVertexArray(getVaoId()); glEnableVertexAttribArray(0); glEnableVertexAttribArray(1); glEnableVertexAttribArray(2); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u9700\u8981\u7ed1\u5b9a\u6bcf\u4e2a\u53ef\u7528\u7684\u7eb9\u7406\uff0c\u5e76\u6fc0\u6d3b\u76f8\u5173\u7684\u7eb9\u7406\u5355\u5143\uff0c\u4ee5\u4fbf\u591a\u4e2a\u7eb9\u7406\u80fd\u591f\u540c\u65f6\u5de5\u4f5c\u3002\u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u4e0d\u9700\u8981\u663e\u5f0f\u8bbe\u7f6e\u7eb9\u7406\u7684Uniform\uff0c\u56e0\u4e3a\u5b83\u5df2\u7ecf\u5305\u542b\u5728 Material \u4e2d\u3002 \u4e3a\u4e86\u5c55\u793a\u6cd5\u7ebf\u8d34\u56fe\u5e26\u6765\u7684\u63d0\u5347\uff0c\u6211\u5df2\u7ecf\u521b\u5efa\u4e86\u4e24\u4e2a\u5e76\u6392\u663e\u793a\u7684\u56db\u8fb9\u5f62\u793a\u4f8b\u3002\u53f3\u8fb9\u7684\u6709\u4e00\u5f20\u6cd5\u7ebf\u8d34\u56fe\uff0c\u800c\u5de6\u8fb9\u6ca1\u6709\u3002\u6211\u4eec\u8fd8\u5220\u9664\u4e86\u5730\u5f62\u3001\u5929\u7a7a\u76d2\u548cHUD\uff0c\u5e76\u8bbe\u7f6e\u4e86\u5e73\u884c\u5149\u7167\uff0c\u53ef\u4ee5\u7528\u9f20\u6807\u5de6\u53f3\u952e\u6539\u53d8\u65b9\u5411\uff0c\u8fd9\u6837\u4f60\u5c31\u53ef\u4ee5\u770b\u5230\u6548\u679c\u4e86\u3002\u6211\u5df2\u7ecf\u4fee\u6539\u4e86\u57fa\u672c\u6e90\u4ee3\u7801\uff0c\u4ee5\u652f\u6301\u5173\u95ed\u5929\u7a7a\u76d2\u548c\u5730\u5f62\u3002\u6211\u4eec\u8fd8\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u8bbe\u7f6e\u4e86\u5149\u6548\u679c\u7684\u8303\u56f4\u4e3a 0, 1 \uff0c\u4ee5\u907f\u514d\u56fe\u50cf\u8fc7\u5ea6\u66dd\u5149\u3002 \u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u5177\u6709\u6cd5\u7ebf\u8d34\u56fe\u7684\u56db\u8fb9\u5f62\u611f\u89c9\u66f4\u5927\u3002\u867d\u7136\u5b83\u672c\u8d28\u4e0a\u662f\u4e00\u4e2a\u50cf\u5176\u4ed6\u56db\u8fb9\u5f62\u4e00\u6837\u7684\u5e73\u9762\uff0c\u4f46\u4f60\u53ef\u4ee5\u770b\u5230\u5149\u7ebf\u662f\u5982\u4f55\u53cd\u5c04\u7684\u3002 \u5c3d\u7ba1\u6211\u4eec\u5df2\u7ecf\u7f16\u5199\u7684\u4ee3\u7801\u5b8c\u5168\u7b26\u5408\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f46\u4f60\u9700\u8981\u77e5\u9053\u5b83\u7684\u5c40\u9650\u6027\u3002\u8be5\u4ee3\u7801\u4ec5\u9002\u7528\u4e0e\u4f7f\u7528\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u521b\u5efa\u7684\u6cd5\u7ebf\u8d34\u56fe\u7eb9\u7406\u3002\u5982\u679c\u662f\u8fd9\u79cd\u60c5\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u6a21\u578b\u89c6\u56fe\u77e9\u9635\u6765\u5c06\u6cd5\u7ebf\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002 \u4f46\u901a\u5e38\u6cd5\u7ebf\u8d34\u56fe\u4e0d\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\u3002\u5b83\u4eec\u901a\u5e38\u88ab\u5b9a\u4e49\u5728\u6240\u8c13\u7684 \u5207\u7ebf\u7a7a\u95f4\uff08 Tangent Space \uff09 \u4e2d\u3002\u5207\u7ebf\u7a7a\u95f4\u662f\u4e00\u4e2a\u5750\u6807\u7cfb\uff0c\u5b83\u5b9a\u4f4d\u5728\u6a21\u578b\u7684\u6bcf\u4e2a\u4e09\u89d2\u5f62\uff0c\u5176\u5750\u6807\u7cfb\u7684 z \u8f74\u603b\u662f\u5782\u76f4\u4e8e\u8868\u9762\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u5f53\u4f60\u770b\u4e00\u4e2a\u6cd5\u7ebf\u8d34\u56fe\u65f6\uff0c\u5b83\u901a\u5e38\u662f\u84dd\u8272\u7684\uff0c\u751a\u81f3\u5bf9\u4e8e\u9762\u76f8\u5bf9\u590d\u6742\u7684\u6a21\u578b\u4e5f\u662f\u5982\u6b64\u3002 \u6211\u4eec\u73b0\u5728\u4ecd\u4f7f\u7528\u8fd9\u4e2a\u7b80\u5355\u7684\u5b9e\u73b0\uff0c\u4f46\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5fc5\u987b\u603b\u662f\u4f7f\u7528\u5728\u6a21\u578b\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u6cd5\u7ebf\u8d34\u56fe\u3002\u5982\u679c\u4f7f\u7528\u5207\u7ebf\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u8d34\u56fe\uff0c\u5c31\u4f1a\u53d8\u5f97\u5f88\u5947\u602a\u3002\u4e3a\u4e86\u80fd\u591f\u8ba9\u5b83\u4eec\u4e00\u540c\u5de5\u4f5c\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u7279\u5b9a\u7684\u77e9\u9635\u6765\u5c06\u5750\u6807\u53d8\u6362\u5230\u5207\u7ebf\u7a7a\u95f4\u3002","title":"\u6cd5\u7ebf\u8d34\u56fe\uff08Normal Mapping\uff09"},{"location":"18-shadows/","text":"\u9634\u5f71\uff08Shadows\uff09 \u9634\u5f71\u6620\u5c04 \u76ee\u524d\uff0c\u6211\u4eec\u80fd\u591f\u8868\u73b0\u5149\u7ebf\u5982\u4f55\u5f71\u54cd\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5bf9\u8c61\u3002\u63a5\u6536\u5230\u66f4\u591a\u5149\u7684\u7269\u4f53\u6bd4\u6ca1\u6709\u63a5\u6536\u5149\u7684\u7269\u4f53\u66f4\u4eae\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u65e0\u6cd5\u6295\u5c04\u9634\u5f71\u3002\u9634\u5f71\u80fd\u589e\u52a03D\u573a\u666f\u7684\u771f\u5b9e\u5ea6\uff0c\u56e0\u6b64\u6211\u4eec\u5c06\u5728\u672c\u7ae0\u4e2d\u6dfb\u52a0\u5bf9\u5b83\u7684\u652f\u6301\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u88ab\u79f0\u4e3a\u9634\u5f71\u6620\u5c04\uff08Shadow Mapping\uff09\u7684\u6280\u672f\uff0c\u8fd9\u79cd\u6280\u672f\u88ab\u5e7f\u6cdb\u4f7f\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u4e14\u4e0d\u4f1a\u4e25\u91cd\u5f71\u54cd\u5f15\u64ce\u6027\u80fd\u3002\u9634\u5f71\u6620\u5c04\u770b\u8d77\u6765\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u5f88\u96be\u6b63\u786e\u5730\u5b9e\u73b0\u5b83\u3002\u6216\u8005\u66f4\u51c6\u786e\u5730\u8bf4\uff0c\u5f88\u96be\u7528\u4e00\u79cd\u901a\u7528\u7684\uff0c\u6db5\u76d6\u4e86\u4e00\u5207\u53ef\u80fd\u5e76\u4ea7\u751f\u4e00\u81f4\u7684\u6548\u679c\u7684\u65b9\u6cd5\u53bb\u5b9e\u73b0\u5b83\u3002 \u6211\u4eec\u5c06\u5728\u6b64\u8bf4\u660e\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ef\u4ee5\u4e3a\u4f60\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u6dfb\u52a0\u9634\u5f71\uff0c\u4f46\u66f4\u91cd\u8981\u7684\u662f\uff0c\u5b83\u5c06\u5e2e\u52a9\u4f60\u4e86\u89e3\u5176\u5c40\u9650\u6027\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u4ee3\u7801\u8fdc\u4e0d\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5f88\u5bb9\u6613\u7406\u89e3\u3002\u5b83\u8fd8\u88ab\u8bbe\u8ba1\u7528\u4e8e\u652f\u6301\u6709\u5411\u5149\uff08\u8fd9\u6211\u8ba4\u4e3a\u662f\u66f4\u590d\u6742\u7684\u60c5\u51b5\uff09\uff0c\u4f46\u4f60\u5c06\u4e86\u89e3\u5982\u4f55\u5c06\u5176\u6269\u5c55\u4ee5\u652f\u6301\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u7167\uff08\u4f8b\u5982\u70b9\u5149\u6e90\uff09\u3002\u5982\u679c\u60f3\u83b7\u5f97\u66f4\u9ad8\u7ea7\u7684\u6548\u679c\uff0c\u4f60\u5e94\u8be5\u4f7f\u7528\u66f4\u9ad8\u7ea7\u7684\u6280\u672f\uff0c\u4f8b\u5982\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u8fd9\u91cc\u89e3\u91ca\u7684\u6982\u5ff5\u90fd\u4ec5\u4ec5\u4f5c\u4e3a\u57fa\u7840\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u4ece\u601d\u8003\u5982\u4f55\u68c0\u67e5\u7279\u5b9a\u533a\u57df\uff08\u5b9e\u9645\u4e0a\u662f\u7247\u5143\uff09\u662f\u5426\u5728\u9634\u5f71\u4e2d\u5f00\u59cb\u3002\u5728\u7ed8\u5236\u8fd9\u4e2a\u533a\u57df\u7684\u65f6\u5019\uff0c\u6211\u4eec\u53ef\u4ee5\u53d1\u51fa\u5c04\u7ebf\u6295\u5c04\u5230\u5149\u6e90\u4e0a\uff0c\u5982\u679c\u6211\u4eec\u53ef\u4ee5\u5728\u4e0d\u53d1\u751f\u4efb\u4f55\u78b0\u649e\u7684\u60c5\u51b5\u4e0b\u5230\u8fbe\u5149\u6e90\uff0c\u90a3\u4e48\u50cf\u7d20\u5c31\u5728\u5149\u7167\u4e2d\uff0c\u53cd\u4e4b\uff0c\u50cf\u7d20\u5904\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u70b9\u5149\u6e90\u7684\u60c5\u51b5\uff0c\u70b9PA\u53ef\u4ee5\u5230\u8fbe\u5149\u6e90\uff0c\u4f46\u70b9PB\u548cPC\u4e0d\u884c\uff0c\u56e0\u6b64\u5b83\u4eec\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5982\u4f55\u624d\u80fd\u68c0\u67e5\u662f\u5426\u80fd\u4ee5\u4e00\u79cd\u6709\u6548\u7684\u65b9\u5f0f\u53d1\u5c04\u51fa\u4e0d\u53d1\u751f\u78b0\u649e\u7684\u5c04\u7ebf\u5462\uff1f\u7406\u8bba\u4e0a\uff0c\u5149\u6e90\u53ef\u4ee5\u6295\u5c04\u51fa\u65e0\u9650\u7684\u5149\u7ebf\uff0cName\u6211\u4eec\u5982\u4f55\u68c0\u67e5\u5149\u7ebf\u662f\u5426\u88ab\u906e\u6321\uff1f \u6211\u4eec\u80fd\u505a\u7684\u4e0d\u662f\u6295\u5c04\u5149\u7ebf\uff0c\u800c\u662f\u4ece\u5149\u7ebf\u900f\u89c6\u56fe\u4e2d\u89c2\u5bdf3D\u573a\u666f\uff0c\u5e76\u4ece\u8be5\u4f4d\u7f6e\u6e32\u67d3\u573a\u666f\u3002\u6211\u4eec\u53ef\u4ee5\u5c06\u76f8\u673a\u8bbe\u7f6e\u5728\u5149\u6e90\u4f4d\u7f6e\u5e76\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u50a8\u5b58\u6bcf\u4e2a\u7247\u5143\u7684\u6df1\u5ea6\u3002\u8fd9\u76f8\u5f53\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u6700\u540e\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u5c06\u5149\u7167\u6240\u53ca\u7684\u6700\u5c0f\u8ddd\u79bb\u50a8\u5b58\u4e3a\u9634\u5f71\u56fe\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u60ac\u6d6e\u5728\u5e73\u9762\u4e0a\u5e76\u5782\u76f4\u4e8e\u5149\u7ebf\u7684\u7acb\u65b9\u4f53\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u770b\uff0c\u60c5\u51b5\u662f\u8fd9\u6837\u7684\uff08\u989c\u8272\u8d8a\u6df1\uff0c\u8d8a\u63a5\u8fd1\u5149\u6e90\uff09\u3002 \u5229\u7528\u8fd9\u4e9b\u4fe1\u606f\u3002\u6211\u4eec\u53ef\u4ee5\u50cf\u5f80\u5e38\u4e00\u6837\u6e32\u67d33D\u573a\u666f\uff0c\u5e76\u4ee5\u6700\u5c0f\u50a8\u5b58\u8ddd\u79bb\u68c0\u67e5\u6bcf\u4e2a\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u5982\u679c\u8ddd\u79bb\u5c0f\u4e8e\u9634\u5f71\u8d34\u56fe\u4e2d\u50a8\u5b58\u7684\u503c\uff0c\u5219\u5bf9\u8c61\u4f4d\u4e8e\u5149\u7167\u4e2d\uff0c\u5426\u5219\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002\u6211\u4eec\u53ef\u4ee5\u8ba9\u51e0\u4e2a\u7269\u4f53\u88ab\u540c\u4e00\u5149\u7167\u7167\u5c04\uff0c\u4f46\u6211\u4eec\u50a8\u5b58\u6700\u5c0f\u8ddd\u79bb\u3002 \u56e0\u6b64\uff0c\u9634\u5f71\u6620\u5c04\u5206\u4e3a\u4e24\u6b65\uff1a \u9996\u5148\uff0c\u6211\u4eec\u5c06\u573a\u666f\u4ece\u5149\u7167\u7a7a\u95f4\u6e32\u67d3\u4e3a\u9634\u5f71\u56fe\uff0c\u4ee5\u83b7\u5f97\u6700\u5c0f\u8ddd\u79bb\u3002 \u5176\u6b21\uff0c\u6211\u4eec\u4ece\u6444\u50cf\u673a\u7684\u89c6\u89d2\u6e32\u67d3\u573a\u666f\u3002\u5e76\u4f7f\u7528\u6df1\u5ea6\u56fe\u8ba1\u7b97\u5bf9\u8c61\u662f\u5426\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e3a\u4e86\u6e32\u67d3\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u9700\u8981\u8bf4\u8bf4\u6df1\u5ea6\u7f13\u51b2\u533a\uff08Depth-buffer\uff09\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u65f6\uff0c\u6240\u6709\u6df1\u5ea6\u4fe1\u606f\u90fd\u50a8\u5b58\u5728\u4e00\u4e2a\u540d\u4e3a\u201c\u6df1\u5ea6\u7f13\u51b2\u533a\u201d\uff08\u53c8\u79f0\u201cZ\u7f13\u51b2\u533a\uff08Z-buffer\uff09\u201d\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u6df1\u5ea6\u4fe1\u606f\u662f\u6e32\u67d3\u7684\u6bcf\u4e2a\u7247\u5143\u7684 z \u503c\u3002\u5982\u679c\u4f60\u4ece\u7b2c\u4e00\u7ae0\u56de\u5fc6\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u5c06\u6b63\u5728\u6e32\u67d3\u7684\u573a\u666f\u4ece\u4e16\u754c\u5750\u6807\u8f6c\u6362\u4e3a\u5c4f\u5e55\u5750\u6807\u3002\u6211\u4eec\u6240\u7ed8\u5236\u7684\u5750\u6807\u7a7a\u95f4\uff0c\u5bf9\u4e8e x \u548c y \u8f74\u6765\u8bf4\uff0c\u5750\u6807\u7684\u8303\u56f4\u4e3a 0 \u5230 1 \u3002\u5982\u679c\u4e00\u4e2a\u7269\u4f53\u6bd4\u5176\u4ed6\u5bf9\u8c61\u539f\uff0c\u6211\u4eec\u5fc5\u987b\u901a\u8fc7\u900f\u89c6\u6295\u5f71\u77e9\u9635\u8ba1\u7b97\u5b83\u5982\u4f55\u5f71\u54cd\u5176 x \u548c y \u5750\u6807\u3002\u8fd9\u4e0d\u662f\u6839\u636e z \u503c\u81ea\u52a8\u8ba1\u7b97\u7684\uff0c\u5b83\u5fc5\u987b\u7531\u6211\u4eec\u6765\u505a\u3002\u5b9e\u9645\u50a8\u5b58\u5728 z \u5750\u6807\u4e2d\u7684\u662f\u5b83\u5728\u7247\u5143\u7684\u6df1\u5ea6\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6b64\u5916\uff0c\u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u5982\u4e0b\u884c\uff1a glEnable(GL_DEPTH_TEST); \u901a\u8fc7\u6dfb\u52a0\u8fd9\u884c\uff0c\u6211\u4eec\u53ef\u4ee5\u9632\u6b62\u65e0\u6cd5\u770b\u5230\u7684\u7247\u5143\u88ab\u7ed8\u5236\u51fa\u6765\uff0c\u56e0\u4e3a\u4ed6\u4eec\u4f4d\u4e8e\u5176\u4ed6\u5bf9\u8c61\u4e4b\u540e\u3002\u5728\u7ed8\u5236\u7247\u5143\u4e4b\u524d\uff0c\u5b83\u7684 z \u503c\u5c06\u4e0eZ\u7f13\u51b2\u533a\u4e2d\u7684 z \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u5b83\u7684 z \u503c\uff08\u5b83\u7684\u8ddd\u79bb\uff09\u5927\u4e8e\u7f13\u51b2\u533a\u7684 z \u503c\uff0c\u5219\u4f1a\u88ab\u4e22\u5f03\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u5728\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u5b8c\u6210\u7684\uff0c\u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u5bf9\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u8303\u56f4\u4e3a [0, 1] \u7684 x \u548c y \u5750\u6807\uff0c\u6211\u4eec\u6bd4\u8f83\u5176\u7247\u5143\u7684 z \u503c\u3002\u540c\u6837\uff0c z \u503c\u4e5f\u5728\u6b64\u8303\u56f4\u5185\u3002 \u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u5b58\u5728\u662f\u6211\u4eec\u5728\u6267\u884c\u4efb\u4f55\u6e32\u67d3\u64cd\u4f5c\u4e4b\u524d\u9700\u8981\u6e05\u9664\u5c4f\u5e55\u7684\u539f\u56e0\u3002\u6211\u4eec\u4e0d\u4ec5\u9700\u8981\u6e05\u9664\u989c\u8272\uff0c\u8fd8\u8981\u6e05\u9664\u6df1\u5ea6\u4fe1\u606f\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u4e3a\u4e86\u5f00\u59cb\u6784\u5efa\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5e0c\u671b\u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u83b7\u5f97\u6df1\u5ea6\u4fe1\u606f\u3002\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u4f4d\u7f6e\u8bbe\u7f6e\u4e00\u4e2a\u6444\u50cf\u5934\uff0c\u6e32\u67d3\u573a\u666f\u5e76\u5c06\u6df1\u5ea6\u4fe1\u606f\u50a8\u5b58\u5230\u7eb9\u7406\u4e2d\uff0c\u4ee5\u4fbf\u7a0d\u540e\u8bbf\u95ee\u5b83\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u7684\u662f\u6dfb\u52a0\u5bf9\u521b\u5efa\u8fd9\u4e9b\u7eb9\u7406\u7684\u652f\u6301\u3002\u6211\u4eec\u5c06\u4fee\u6539 Texture \u7c7b\uff0c\u901a\u8fc7\u6dfb\u52a0\u65b0\u7684\u6784\u9020\u51fd\u6570\u6765\u652f\u6301\u521b\u5efa\u7a7a\u7eb9\u7406\u3002\u6b64\u6784\u9020\u51fd\u6570\u9700\u8981\u7eb9\u7406\u7684\u5c3a\u5bf8\u4ee5\u53ca\u5b83\u50a8\u5b58\u7684\u50cf\u7d20\u7684\u683c\u5f0f\u3002 public Texture(int width, int height, int pixelFormat) throws Exception { this.id = glGenTextures(); this.width = width; this.height = height; glBindTexture(GL_TEXTURE_2D, this.id); glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT, this.width, this.height, 0, pixelFormat, GL_FLOAT, (ByteBuffer) null); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); } \u6211\u4eec\u5c06\u7eb9\u7406\u73af\u7ed5\u65b9\u5f0f\u8bbe\u7f6e\u4e3a GL_CLAMP_TO_EDGE \uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u5e0c\u671b\u5728\u8d85\u51fa [0, 1] \u8303\u56f4\u65f6\u91cd\u590d\u7eb9\u7406\u3002 \u6240\u4ee5\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u7a7a\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u5176\u4e2d\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5e27\u7f13\u51b2\u533a\u5bf9\u8c61\uff08Frame Buffers Objects\uff0c\u6216\u79f0FBOs\uff09\u3002\u5e27\u7f13\u51b2\u533a\u662f\u53ef\u4ee5\u4f5c\u4e3a\u6e32\u67d3\u7ec8\u70b9\u7684\u7f13\u51b2\u533a\u96c6\u5408\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL\u7684\u9ed8\u8ba4\u7f13\u51b2\u533a\u3002OpenGL\u5141\u8bb8\u6211\u4eec\u4f7f\u7528FBO\u6e32\u67d3\u5230\u7528\u6237\u5b9a\u4e49\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a ShadowMap \u7684\u65b0\u7c7b\uff0c\u6765\u9694\u79bb\u4e3a\u9634\u5f71\u6620\u5c04\u521b\u5efaFBO\u8fc7\u7a0b\u7684\u5176\u4f59\u4ee3\u7801\u3002\u5982\u4e0b\u5c31\u662f\u90a3\u4e2a\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class ShadowMap { public static final int SHADOW_MAP_WIDTH = 1024; public static final int SHADOW_MAP_HEIGHT = 1024; private final int depthMapFBO; private final Texture depthMap; public ShadowMap() throws Exception { // \u521b\u5efaFBO\u4ee5\u6e32\u67d3\u6df1\u5ea6\u56fe depthMapFBO = glGenFramebuffers(); // \u521b\u5efa\u6df1\u5ea6\u56fe\u7eb9\u7406 depthMap = new Texture(SHADOW_MAP_WIDTH, SHADOW_MAP_HEIGHT, GL_DEPTH_COMPONENT); // \u7ed1\u5b9a\u6df1\u5ea6\u56fe\u7eb9\u7406\u5230FBO glBindFramebuffer(GL_FRAMEBUFFER, depthMapFBO); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthMap.getId(), 0); // \u4ec5\u8bbe\u7f6e\u6df1\u5ea6 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) { throw new Exception(\"Could not create FrameBuffer\"); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public Texture getDepthMapTexture() { return depthMap; } public int getDepthMapFBO() { return depthMapFBO; } public void cleanup() { glDeleteFramebuffers(depthMapFBO); depthMap.cleanup(); } } ShadowMap \u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff0c\u7528\u4e8e\u786e\u5b9a\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5927\u5c0f\u3002\u5b83\u8fd8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5c5e\u6027\uff0c\u4e00\u4e2a\u7528\u4e8eFBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u7eb9\u7406\u3002\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u7684FBO\u548c\u4e00\u4e2a\u65b0\u7684 Texture \u3002\u5bf9\u4e8eFBO\uff0c\u5c06\u4f7f\u7528\u5e38\u91cf GL_DEPTH_COMPONENT \u4f5c\u4e3a\u50cf\u7d20\u683c\u5f0f\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u50a8\u5b58\u6df1\u5ea6\u503c\u611f\u5174\u8da3\uff0c\u7136\u540e\u5c06FBO\u7ed1\u5b9a\u5230\u7eb9\u7406\u5b9e\u4f8b\u3002 \u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\u663e\u5f0f\u5730\u5c06FBO\u8bbe\u7f6e\u4e3a\u4e0d\u6e32\u67d3\u4efb\u4f55\u989c\u8272\u3002FBO\u9700\u8981\u989c\u8272\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u4e0d\u9700\u8981\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u5c06\u989c\u8272\u7f13\u51b2\u533a\u8bbe\u7f6e\u4e3a GL_NONE \u3002 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); \u73b0\u5728\uff0c\u6211\u4eec\u51c6\u5907\u5728 Renderer \u7c7b\u4e2d\u5c06\u573a\u666f\u4ece\u706f\u5149\u900f\u89c6\u6e32\u67d3\u4e3aFBO\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u7ec4\u7279\u6b8a\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u3002 \u540d\u4e3a depth_vertex.vs \u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { gl_Position = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0f); } \u6211\u4eec\u5e0c\u671b\u63a5\u6536\u4e0e\u573a\u666f\u7740\u8272\u5668\u76f8\u540c\u7684\u8f93\u5165\u6570\u636e\u3002\u4f46\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5750\u6807\uff0c\u4f46\u662f\u4e3a\u4e86\u5c3d\u53ef\u80fd\u591a\u5730\u91cd\u7528\u4ee3\u7801\uff0c\u6211\u4eec\u8fd8\u662f\u8981\u4f20\u9001\u5176\u4ed6\u6570\u636e\u3002\u6211\u4eec\u8fd8\u9700\u8981\u4e00\u5bf9\u77e9\u9635\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u4ee5\u5149\u6e90\u7684\u89d2\u5ea6\u6e32\u67d3\u573a\u666f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u6a21\u578b\u8f6c\u6362\u5230\u5149\u6e90\u7684\u5750\u6807\u7a7a\u95f4\u3002\u8fd9\u662f\u901a\u8fc7 modelLightViewMatrix \u77e9\u9635\u5b8c\u6210\u7684\uff0c\u8be5\u77e9\u9635\u7c7b\u4f3c\u4e8e\u7528\u4e8e\u6444\u50cf\u673a\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u73b0\u5728\u5149\u6e90\u662f\u6211\u4eec\u7684\u6444\u50cf\u673a\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u5230\u5c4f\u5e55\u7a7a\u95f4\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u9700\u8981\u6295\u5f71\u5b83\u4eec\u3002\u8fd9\u662f\u8ba1\u7b97\u5e73\u884c\u5149\u4e0e\u70b9\u5149\u6e90\u7684\u9634\u5f71\u56fe\u65f6\u7684\u533a\u522b\u4e4b\u4e00\u3002\u5bf9\u4e8e\u5730\u6602\u626c\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u900f\u89c6\u6295\u5f71\uff08Perspective Projection\uff09\u77e9\u9635\uff0c\u5c31\u50cf\u6211\u4eec\u6b63\u5e38\u6e32\u67d3\u573a\u666f\u4e00\u6837\u3002\u76f8\u53cd\uff0c\u5e73\u884c\u5149\u4ee5\u76f8\u540c\u65b9\u5f0f\u5f71\u54cd\u6240\u6709\u5bf9\u8c61\uff0c\u800c\u4e0e\u8ddd\u79bb\u65e0\u5173\u3002\u5e73\u884c\u5149\u6e90\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u7684\u70b9\u4e0a\uff0c\u6ca1\u6709\u4f4d\u7f6e\uff0c\u53ea\u6709\u65b9\u5411\u3002\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u4e0d\u4f1a\u4f7f\u8fdc\u5904\u7684\u7269\u4f53\u53d8\u5c0f\uff0c\u56e0\u6b64\uff0c\u6b63\u4ea4\u6295\u5f71\u6700\u9002\u5408\u5e73\u884c\u5149\u3002 \u7247\u5143\u7740\u8272\u5668\u66f4\u7b80\u5355\u3002\u5b83\u53ea\u8f93\u51fa z \u5750\u6807\u4f5c\u4e3a\u6df1\u5ea6\u503c\u3002 #version 330 void main() { gl_FragDepth = gl_FragCoord.z; } \u5b9e\u9645\u4e0a\uff0c\u4f60\u53ef\u4ee5\u5220\u6389\u8be5\u884c\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u751f\u6210\u6df1\u5ea6\u503c\uff0c\u6df1\u5ea6\u503c\u5c06\u81ea\u52a8\u8fd4\u56de\u3002 \u4e00\u65e6\u6211\u4eec\u4e3a\u6df1\u5ea6\u6e32\u67d3\u5b9a\u4e49\u4e86\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u4e3a\u521d\u59cb\u5316\u8fd9\u4e9b\u7740\u8272\u5668\u5b9a\u4e49\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u540d\u4e3a setupDepthShader \uff0c\u5b83\u5c06\u5728\u5176\u4ed6\u7740\u8272\u5668\u88ab\u521d\u59cb\u5316\u65f6\u8c03\u7528\u3002 private void setupDepthShader() throws Exception { depthShaderProgram = new ShaderProgram(); depthShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/depth_vertex.vs\")); depthShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/depth_fragment.fs\")); depthShaderProgram.link(); depthShaderProgram.createUniform(\"orthoProjectionMatrix\"); depthShaderProgram.createUniform(\"modelLightViewMatrix\"); } \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528\u90a3\u4e9b\u540d\u4e3a renderDepthMap \u7684\u7740\u8272\u5668\u3002\u8be5\u65b9\u6cd5\u5c06\u5728\u4e3b\u6e32\u67d3\u65b9\u6cd5\u4e2d\u8c03\u7528\u3002 public void render(Window window, Camera camera, Scene scene, IHud hud) { clear(); // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe renderDepthMap(window, camera, scene); glViewport(0, 0, window.getWidth(), window.getHeight()); // \u5176\u4f59\u7684\u4ee3\u7801\u5728\u8fd9... \u5982\u679c\u4f60\u6d4f\u89c8\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\uff0c\u65b0\u65b9\u6cd5\u5c31\u5df2\u7ecf\u88ab\u8c03\u7528\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u65b0\u65b9\u6cd5\u5c06\u66f4\u9ad8\u89c6\u53e3\u4ee5\u5339\u914d\u4fdd\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5c3a\u5bf8\u3002\u56e0\u6b64\uff0c\u5728\u5b8c\u6210 renderDepthMap \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u59cb\u7ec8\u9700\u8981\u8bbe\u7f6e\u5c4f\u5e55\u5c3a\u5bf8\u7684\u89c6\u53e3\uff08\u4e0d\u68c0\u67e5\u7a97\u53e3\u662f\u5426\u5df2\u8c03\u6574\u5927\u5c0f\uff09\u3002 \u73b0\u5728\u8ba9\u6211\u4eec\u5b9a\u4e49\u4e00\u4e0b renderDepthMap \u65b9\u6cd5\u3002\u7b2c\u4e00\u4ef6\u4e8b\u662f\u7ed1\u5b9a\u5728 ShadowMap \u7c7b\u4e2d\u521b\u5efa\u7684FBO\uff0c\u5e76\u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5c3a\u5bf8\u3002 glBindFramebuffer(GL_FRAMEBUFFER, shadowMap.getDepthMapFBO()); glViewport(0, 0, ShadowMap.SHADOW_MAP_WIDTH, ShadowMap.SHADOW_MAP_HEIGHT); \u7136\u540e\uff0c\u6e05\u9664\u6df1\u5ea6\u7f13\u51b2\u533a\u5185\u5bb9\u5e76\u7ed1\u5b9a\u6df1\u5ea6\u7740\u8272\u5668\u3002\u56e0\u4e3a\u6211\u4eec\u53ea\u5904\u7406\u6df1\u5ea6\u503c\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6e05\u9664\u989c\u8272\u4fe1\u606f\u3002 glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); \u73b0\u5728\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u77e9\u9635\uff0c\u63a5\u4e0b\u6765\u662f\u68d8\u624b\u7684\u90e8\u5206\u3002\u6211\u4eec\u4f7f\u7528\u5149\u6e90\u4f5c\u4e3a\u6444\u50cf\u673a\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u9700\u8981\u4e00\u4e2a\u5750\u6807\u548c\u4e09\u4e2a\u89d2\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6b63\u5982\u672c\u7ae0\u5f00\u5934\u6240\u8bf4\uff0c\u6211\u4eec\u53ea\u5b9e\u73b0\u5e73\u884c\u5149\uff0c\u8fd9\u79cd\u7c7b\u578b\u7684\u5149\u4e0d\u5b9a\u4e49\u4f4d\u7f6e\uff0c\u800c\u662f\u5b9a\u4e49\u65b9\u5411\u3002\u5982\u679c\u6211\u4eec\u4f7f\u7528\u70b9\u5149\u6e90\uff0c\u8fd9\u5f88\u5bb9\u6613\uff0c\u5149\u6e90\u7684\u4f4d\u7f6e\u5c31\u662f\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u7f6e\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u4f4d\u7f6e\u3002 \u6211\u4eec\u5c06\u91c7\u7528\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u5149\u7684\u4f4d\u7f6e\u3002\u5e73\u884c\u5149\u662f\u7531\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u7684\uff0c\u901a\u5e38\u662f\u5f52\u4e00\u5316\u7684\uff0c\u5b83\u6307\u5411\u5149\u6e90\u6240\u5728\u7684\u65b9\u5411\u3002\u6211\u4eec\u628a\u8fd9\u4e2a\u65b9\u5411\u5411\u91cf\u4e58\u4ee5\u4e00\u4e2a\u53ef\u914d\u7f6e\u7684\u56e0\u5b50\uff0c\u5728\u8fd9\u6837\u5b83\u5c31\u4e3a\u8981\u7ed8\u5236\u7684\u573a\u666f\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5408\u7406\u8ddd\u79bb\u7684\u70b9\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u65b9\u5411\u6765\u8ba1\u7b97\u8be5\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u8fd9\u662f\u8ba1\u7b97\u706f\u5149\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u89d2\u5ea6\u7684\u4ee3\u7801\u7247\u6bb5\uff1a float lightAngleX = (float)Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float)Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Matrix4f lightViewMatrix = transformation.updateLightViewMatrix(new Vector3f(lightDirection).mul(light.getShadowPosMult()), new Vector3f(lightAngleX, lightAngleY, lightAngleZ)); \u63a5\u4e0b\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff1a Matrix4f orthoProjMatrix = transformation.updateOrthoProjectionMatrix(orthCoords.left, orthCoords.right, orthCoords.bottom, orthCoords.top, orthCoords.near, orthCoords.far); \u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86 Transformation \u7c7b\uff0c\u4ee5\u56ca\u62ec\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6b64\u4eec\u6709\u4e00\u4e2a\u6b63\u4ea4\u7684\u4e8c\u7ef4\u6295\u5f71\u77e9\u9635\uff0c\u6240\u4ee5\u6211\u4eec\u91cd\u547d\u540d\u4e86\u6b64\u524d\u7684\u65b9\u6cd5\u548c\u5c5e\u6027\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u5b9a\u4e49\u3002 \u7136\u540e\uff0c\u6211\u4eec\u6309\u7167 renderScene \u65b9\u6cd5\u6e32\u67d3\u573a\u666f\u5bf9\u8c61\uff0c\u4f46\u5728\u5149\u7167\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u4f7f\u7528\u4e0a\u8ff0\u77e9\u9635\u5de5\u4f5c\u3002 depthShaderProgram.setUniform(\"orthoProjectionMatrix\", orthoProjMatrix); Map<Mesh, List<GameItem>> mapMeshes = scene.getGameMeshes(); for (Mesh mesh : mapMeshes.keySet()) { mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelLightViewMatrix = transformation.buildModelViewMatrix(gameItem, lightViewMatrix); depthShaderProgram.setUniform(\"modelLightViewMatrix\", modelLightViewMatrix); } ); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); \u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u662f\u5728\u5e73\u884c\u5149\u4e2d\u5b9a\u4e49\u7684\u3002\u5c06\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u4e3a\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5176\u4e2d\u5305\u542b\u6211\u4eec\u8981\u6e32\u67d3\u7684\u6240\u6709\u5bf9\u8c61\u3002\u5f53\u53ea\u6295\u5f71\u9002\u5408\u8be5\u8fb9\u754c\u6846\u7684\u5bf9\u8c61\u65f6\uff0c\u5bf9\u8c61\u5c06\u53ef\u89c6\u3002\u8be5\u8fb9\u754c\u6846\u75316\u4e2a\u53c2\u6570\u5b9a\u4e49\uff1a\u5de6\u3001\u53f3\u3001\u4e0a\u3001\u4e0b\u3001\u8fd1\u3001\u8fdc\u3002\u7531\u4e8e\u5149\u6e90\u4f4d\u7f6e\u73b0\u5728\u662f\u539f\u70b9\uff0c\u56e0\u6b64\u8fd9\u4e9b\u53c2\u6570\u5b9a\u4e49\u4e3a\u539f\u70b9\u5230\u5de6\u6216\u53f3\uff08x\u8f74\uff09\u6216\u4e0a\u6216\u4e0b\uff08y\u8f74\uff09\u6216\u8fdc\u6216\u8fd1\uff08z\u8f74\uff09\u7684\u8ddd\u79bb\u3002 \u8981\u4f7f\u9634\u5f71\u56fe\u6b63\u5e38\u5de5\u4f5c\uff0c\u6700\u68d8\u624b\u7684\u4e00\u70b9\u662f\u786e\u5b9a\u706f\u5149\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u3002\u8fd9\u5c31\u662f\u6240\u6709\u8fd9\u4e9b\u53c2\u6570\u73b0\u5728\u5728 DirectionalLight \u7c7b\u4e2d\u5b9a\u4e49\u7684\u65b9\u5f0f\uff0c\u56e0\u6b64\u53ef\u4ee5\u6839\u636e\u6bcf\u4e2a\u573a\u666f\u6b63\u786e\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002 \u4f60\u53ef\u4ee5\u5b9e\u73b0\u4e00\u4e2a\u66f4\u81ea\u52a8\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u8ba1\u7b97\u6444\u50cf\u673a\u622a\u9525\uff08Frustum\uff09\u7684\u4e2d\u5fc3\uff0c\u56de\u5230\u5149\u7684\u65b9\u5411\uff0c\u5efa\u7acb\u4e00\u4e2a\u5305\u542b\u573a\u666f\u4e2d\u6240\u6709\u5bf9\u8c61\u7684\u6b63\u4ea4\u6295\u5f71\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5982\u4e0a\u6240\u8ff0\u7684\u4e09\u7ef4\u573a\u666f\u3001\u76f8\u673a\u4f4d\u7f6e\u3001\u622a\u9525\uff08\u84dd\u8272\uff09\u3001\u6700\u4f73\u5149\u6e90\u4f4d\u7f6e\u4ee5\u53ca\u7ea2\u8272\u7684\u8fb9\u754c\u6846\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5f88\u96be\u8ba1\u7b97\uff0c\u5982\u679c\u4f60\u6709\u5f88\u5c0f\u7684\u7269\u4f53\uff0c\u5e76\u4e14\u8fb9\u754c\u6846\u5f88\u5927\uff0c\u4f60\u53ef\u4ee5\u4f1a\u5f97\u5230\u5947\u602a\u7684\u7ed3\u679c\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u65b9\u6cd5\u5bf9\u4e8e\u5c0f\u573a\u666f\u66f4\u7b80\u5355\uff0c\u4f60\u53ef\u4ee5\u8c03\u6574\u5b83\u4ee5\u5339\u914d\u4f60\u7684\u6a21\u578b\uff08\u5373\u4f7f\u4f60\u53ef\u4ee5\u9009\u62e9\u663e\u5f0f\u8bbe\u7f6e\u706f\u5149\u7684\u4f4d\u7f6e\uff0c\u4ee5\u907f\u514d\u76f8\u673a\u8fdc\u79bb\u539f\u70b9\u79fb\u52a8\u65f6\u4ea7\u751f\u5947\u602a\u7684\u6548\u679c\uff09\u3002\u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u901a\u7528\u7684\u6a21\u677f\uff0c\u53ef\u4ee5\u5e94\u7528\u5230\u4efb\u4f55\u573a\u666f\uff0c\u4f60\u5e94\u8be5\u6269\u5c55\u5b83\uff0c\u4ee5\u652f\u6301\u5c42\u53e0\u9634\u5f71\u56fe\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u3002\u5728\u4f7f\u7528\u6df1\u5ea6\u56fe\u5b9e\u9645\u8ba1\u7b97\u9634\u5f71\u4e4b\u524d\uff0c\u53ef\u4ee5\u4f7f\u7528\u751f\u6210\u7684\u7eb9\u7406\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4ee5\u89c2\u5bdf\u6df1\u5ea6\u56fe\u7684\u5b9e\u9645\u5916\u89c2\u3002\u5728\u6709\u4e00\u4e2a\u65cb\u8f6c\u7acb\u65b9\u4f53\u6f02\u6d6e\u5728\u4e00\u4e2a\u6709\u5782\u76f4\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u7684\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u989c\u8272\u8d8a\u6df1\uff0c\u79bb\u5149\u6e90\u7684\u4f4d\u7f6e\u8d8a\u8fd1\u3002\u6df1\u5ea6\u56fe\u4e2d\u5149\u6e90\u4f4d\u7f6e\u7684\u5f71\u54cd\u662f\u4ec0\u4e48\uff1f\u4f60\u53ef\u4ee5\u4fee\u6539\u5e73\u884c\u5149\u7167\u7684\u500d\u589e\u56e0\u5b50\uff0c\u5c06\u770b\u5230\u5728\u7eb9\u7406\u4e2d\u6e32\u67d3\u7684\u5bf9\u8c61\u7684\u5927\u5c0f\u4e0d\u4f1a\u53d8\u5c0f\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u7269\u4f53\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u589e\u5927\u800c\u53d8\u5c0f\u3002\u4f60\u5c06\u770b\u5230\u7684\u662f\uff0c\u6240\u6709\u7684\u989c\u8272\u90fd\u4f1a\u53d8\u5f97\u66f4\u4eae\uff0c\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u662f\u5426\u610f\u5473\u7740\u6211\u4eec\u53ef\u4ee5\u4e3a\u5149\u6e90\u9009\u62e9\u4e00\u4e2a\u8f83\u8fdc\u7684\u4f4d\u7f6e\u800c\u4e0d\u9020\u6210\u4efb\u4f55\u540e\u679c\u5462\uff1f\u7b54\u6848\u662f\u4e0d\u884c\u3002\u5982\u679c\u5149\u6e90\u79bb\u6211\u4eec\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u592a\u8fdc\uff0c\u8fd9\u4e9b\u5bf9\u8c61\u4f1a\u8d85\u51fa\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u767d\u8272\u7eb9\u7406\uff0c\u4f46\u8fd9\u662f\u6ca1\u7528\u7684\u9634\u5f71\u56fe\u3002\u597d\u7684\uff0c\u90a3\u4e48\u6211\u4eec\u53ea\u9700\u589e\u52a0\u8fb9\u754c\u6846\u7684\u5927\u5c0f\uff0c\u4e00\u5207\u90fd\u4f1a\u597d\u7684\uff0c\u5bf9\u5417\uff1f\u7b54\u6848\u4e5f\u662f\u4e0d\u884c\u3002\u5982\u679c\u4f60\u4e3a\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u9009\u7528\u4e86\u5de8\u5927\u7684\u5c3a\u5bf8\uff0c\u4f60\u7684\u7269\u4f53\u5728\u7eb9\u7406\u4e2d\u4f1a\u88ab\u7ed8\u5236\u5f97\u5f88\u5c0f\uff0c\u6df1\u5ea6\u503c\u751a\u81f3\u4f1a\u91cd\u53e0\uff0c\u9020\u6210\u5947\u602a\u7684\u7ed3\u679c\u3002\u597d\u5427\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u8003\u8651\u589e\u52a0\u7eb9\u7406\u5927\u5c0f\uff0c\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u662f\u6709\u9650\u5236\u7684\uff0c\u7eb9\u7406\u4e0d\u80fd\u56e0\u4f7f\u7528\u5de8\u5927\u7684\u7f16\u8f91\u6846\u800c\u65e0\u9650\u589e\u5927\u3002 \u56e0\u6b64\uff0c\u53ef\u4ee5\u770b\u5230\uff0c\u9009\u62e9\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u7684\u53c2\u6570\u662f\u4e00\u4e2a\u590d\u6742\u7684\u5e73\u8861\uff0c\u8fd9\u4f7f\u5f97\u4f7f\u7528\u9634\u5f71\u56fe\u5f88\u96be\u5f97\u5230\u6b63\u786e\u7684\u6548\u679c\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u6e32\u67d3\u8fc7\u7a0b\uff0c\u4e00\u65e6\u8ba1\u7b97\u4e86\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728\u6e32\u67d3\u573a\u666f\u65f6\u4f7f\u7528\u5b83\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528\u900f\u89c6\u77e9\u9635\u5c06\u9876\u70b9\u5750\u6807\u4ece\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u3002\u73b0\u5728\u8fd8\u9700\u8981\u4f7f\u7528\u6295\u5f71\u77e9\u9635\u4ece\u5149\u7167\u7a7a\u95f4\u5750\u6807\u6295\u5f71\u9876\u70b9\u5750\u6807\uff0c\u4ee5\u7528\u4e8e\u7247\u5143\u7740\u8272\u5668\u4e2d\u8ba1\u7b97\u9634\u5f71\u3002 \u9876\u70b9\u7740\u8272\u5668\u662f\u8fd9\u6837\u4fee\u6539\u7684\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6211\u4eec\u4e3a\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4f7f\u7528\u4e86\u65b0\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u9634\u5f71\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a float calcShadow(vec4 position) { float shadowFactor = 1.0; vec3 projCoords = position.xyz; // \u4ece\u5c4f\u5e55\u5750\u6807\u53d8\u6362\u5230\u7eb9\u7406\u5750\u6807 projCoords = projCoords * 0.5 + 0.5; if ( projCoords.z < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } return 1 - shadowFactor; } \u8be5\u51fd\u6570\u63a5\u6536\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u6295\u5f71\u7684\u5149\u7167\u89c2\u5bdf\u7a7a\u95f4\u7684\u5750\u6807\u3002\u5982\u679c\u5750\u6807\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 0 \uff0c\u5982\u679c\u4e0d\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 1 \u3002\u9996\u5148\uff0c\u5c06\u5750\u6807\u8f6c\u6362\u4e3a\u7eb9\u7406\u5750\u6807\u3002\u5c4f\u5e55\u5750\u6807\u5728 [-1, 1] \u8303\u56f4\u5185\uff0c\u4f46\u7eb9\u7406\u5750\u6807\u5728 [0, 1] \u8303\u56f4\u5185\u3002\u6211\u4eec\u901a\u8fc7\u5750\u6807\u4ece\u7eb9\u7406\u4e2d\u83b7\u53d6\u6df1\u5ea6\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u7247\u5143\u5750\u6807\u7684 z \u503c\u6bd4\u8f83\u3002\u5982\u679c z \u503c\u4f4e\u4e8e\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\u7684\u503c\uff0c\u5219\u8868\u793a\u7247\u5143\u4e0d\u518d\u9634\u5f71\u4e2d\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c calcShadow \u51fd\u6570\u7684\u8fd4\u56de\u503c\uff0c\u7528\u4e8e\u8c03\u8282\u70b9\u5149\u6e90\u3001\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\u5bf9\u5149\u7167\u989c\u8272\u7684\u5171\u4eab\u3002\u73af\u5883\u5149\u4e0d\u53d7\u9634\u5f71\u7684\u5f71\u54cd\u3002 float shadow = calcShadow(mlightviewVertexPos); fragColor = clamp(ambientC * vec4(ambientLight, 1) + diffuseSpecularComp * shadow, 0, 1); \u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u6b63\u4ea4\u6295\u5f71\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5230Uniform\uff08\u6211\u4eec\u8fd8\u9700\u8981\u4fee\u6539\u7740\u8272\u5668\u7684\u521d\u59cb\u5316\u65b9\u6cd5\u4ee5\u521b\u5efa\u65b0\u7684Uniform\uff09\u3002\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u3002 \u5982\u679c\u8fd0\u884c DummyGame \u7c7b\uff0c\u8be5\u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u5728\u5e26\u6709\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u8bbe\u7f6e\u6709\u60ac\u6d6e\u7684\u7acb\u65b9\u4f53\uff0c\u5e76\u53ef\u4f7f\u7528\u4e0a\u4e0b\u952e\u4fee\u6539\u89d2\u5ea6\uff0c\u5219\u5e94\u8be5\u770b\u5230\u5982\u4e0b\u60c5\u51b5\u3002 \u867d\u7136\u9634\u5f71\u5df2\u7ecf\u5de5\u4f5c\u4e86\uff08\u4f60\u53ef\u4ee5\u901a\u8fc7\u79fb\u52a8\u5149\u7167\u65b9\u5411\u6765\u68c0\u67e5\uff09\uff0c\u4f46\u662f\u5b9e\u9645\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u88ab\u7167\u4eae\u7684\u7269\u4f53\u4e2d\u6709\u5947\u602a\u7684\u7ebf\u6761\u3002\u8fd9\u79cd\u60c5\u51b5\u88ab\u79f0\u4e3a\u9634\u5f71\u5931\u771f\uff08Shadow Acne\uff09\uff0c\u5b83\u662f\u7531\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5206\u8fa8\u7387\u6709\u9650\u9020\u6210\u7684\u3002\u7b2c\u4e8c\u4e2a\u95ee\u9898\u662f\uff0c\u9634\u5f71\u7684\u8fb9\u754c\u4e0d\u5e73\u6ed1\uff0c\u770b\u8d77\u6765\u5f88\u7c97\u7cd9\u3002\u539f\u56e0\u540c\u6837\uff0c\u7eb9\u7406\u5206\u8fa8\u7387\u3002\u6211\u4eec\u5c06\u89e3\u51b3\u8fd9\u4e9b\u95ee\u9898\uff0c\u4ee5\u63d0\u9ad8\u9634\u5f71\u8d28\u91cf\u3002 \u6539\u8fdb\u9634\u5f71\u6620\u5c04 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u9634\u5f71\u6620\u5c04\u673a\u5236\uff0c\u90a3\u4e48\u8ba9\u6211\u4eec\u6765\u89e3\u51b3\u73b0\u6709\u7684\u95ee\u9898\u3002\u6211\u4eec\u5148\u4ece\u5931\u771f\u95ee\u9898\u5f00\u59cb\u3002\u6df1\u5ea6\u56fe\u7eb9\u7406\u5927\u5c0f\u6709\u9650\uff0c\u56e0\u6b64\uff0c\u53ef\u4ee5\u5c06\u591a\u4e2a\u7247\u5143\u6620\u5c04\u5230\u8be5\u7eb9\u7406\u6df1\u5ea6\u4e2d\u7684\u540c\u4e00\u50cf\u7d20\u3002\u7eb9\u7406\u6df1\u5ea6\u50a8\u5b58\u6700\u5c0f\u6df1\u5ea6\uff0c\u56e0\u6b64\u5230\u6700\u540e\uff0c\u6211\u4eec\u6709\u51e0\u4e2a\u7247\u5143\u5171\u4eab\u76f8\u540c\u7684\u6df1\u5ea6\uff0c\u5c3d\u7ba1\u5b83\u4eec\u7684\u8ddd\u79bb\u4e0d\u540c\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u7247\u5143\u7740\u8272\u5668\u4e2d\u7684\u6df1\u5ea6\u6bd4\u8f83\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u504f\u79fb\u3002 float bias = 0.05; if ( projCoords.z - bias < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } \u73b0\u5728\uff0c\u9634\u5f71\u5931\u771f\u6d88\u5931\u4e86\u3002 \u8bd1\u8005\u6ce8\uff1a\u4f7f\u7528\u504f\u79fb\u6765\u6d88\u9664\u9634\u5f71\u5931\u771f\u53c8\u4f1a\u9020\u6210\u60ac\u6d6e\uff08Peter Panning\uff09\u95ee\u9898\uff0c\u53e6\u8bf7\u53c2\u9605 LearnOpenGL\u9634\u5f71\u6620\u5c04 \u4e00\u6587\u3002 \u73b0\u5728\u6211\u4eec\u8981\u89e3\u51b3\u7684\u662f\u53bb\u9634\u5f71\u8fb9\u7f18\u95ee\u9898\uff0c\u8fd9\u4e5f\u662f\u7531\u7eb9\u7406\u5206\u8fa8\u7387\u5f15\u8d77\u7684\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7247\u5143\u7684\u5750\u6807\u503c\u548c\u5468\u56f4\u7684\u503c\u5bf9\u6df1\u5ea6\u56fe\u8fdb\u884c\u91c7\u6837\u3002\u7136\u540e\u6211\u4eec\u5c06\u8ba1\u7b97\u5e73\u5747\u503c\u5e76\u5c06\u8be5\u503c\u6307\u5b9a\u4e3a\u9634\u5f71\u503c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5b83\u7684\u503c\u4e0d\u4f1a\u662f 0 \u548c 1 \u4f46\u53ef\u4ee5\u5728\u4e24\u8005\u95f4\u53d6\u503c\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u8fb9\u7f18\u3002 \u5728\u7eb9\u7406\u5750\u6807\u4e2d\uff0c\u5468\u56f4\u503c\u5fc5\u987b\u4e0e\u5f53\u524d\u7247\u5143\u4f4d\u7f6e\u4fdd\u6301\u4e00\u4e2a\u50cf\u7d20\u8ddd\u79bb\u3002\u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u4e2d\u4e00\u4e2a\u50cf\u7d20\u7684\u589e\u91cf\uff0c\u5b83\u7b49\u4e8e 1 / \u7eb9\u7406\u5927\u5c0f \u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u9634\u5f71\u94f6\u5b50\u7684\u8ba1\u7b97\u6765\u5f97\u5230\u4e00\u4e2a\u5e73\u5747\u503c\u3002 float shadowFactor = 0.0; vec2 inc = 1.0 / textureSize(shadowMap, 0); for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth = texture(shadowMap, projCoords.xy + vec2(row, col) * inc).r; shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; \u73b0\u5728\u7ed3\u679c\u770b\u8d77\u6765\u66f4\u5e73\u6ed1\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u7684\u793a\u4f8b\u770b\u8d77\u6765\u597d\u591a\u4e86\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u91cc\u4ecb\u7ecd\u7684\u9634\u5f71\u6620\u5c04\u6280\u672f\u4ecd\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u89e3\u51b3\u60ac\u6d6e\uff08Peter Panning\uff09\u6548\u679c\uff08\u56e0\u504f\u79fb\u5f15\u8d77\uff09\u548c\u5176\u4ed6\u6539\u8fdb\u9634\u5f71\u8fb9\u7f18\u7684\u8ba1\u7b97\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u6709\u4e86\u8fd9\u91cc\u6240\u8bb2\u89e3\u7684\u6982\u5ff5\uff0c\u4f60\u5c31\u6709\u4e86\u5f00\u59cb\u4fee\u6539\u793a\u4f8b\u7684\u826f\u597d\u57fa\u7840\u3002 \u4e3a\u4e86\u6e32\u67d3\u591a\u4e2a\u5149\u6e90\uff0c\u4f60\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u5149\u6e90\u6e32\u67d3\u4e00\u4e2a\u6df1\u5ea6\u56fe\u3002\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u4f60\u9700\u8981\u91c7\u6837\u6240\u6709\u7684\u6df1\u5ea6\u56fe\u6765\u8ba1\u7b97\u5408\u9002\u7684\u9634\u5f71\u7cfb\u6570\u3002","title":"\u9634\u5f71"},{"location":"18-shadows/#shadows","text":"","title":"\u9634\u5f71\uff08Shadows\uff09"},{"location":"18-shadows/#_1","text":"\u76ee\u524d\uff0c\u6211\u4eec\u80fd\u591f\u8868\u73b0\u5149\u7ebf\u5982\u4f55\u5f71\u54cd\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5bf9\u8c61\u3002\u63a5\u6536\u5230\u66f4\u591a\u5149\u7684\u7269\u4f53\u6bd4\u6ca1\u6709\u63a5\u6536\u5149\u7684\u7269\u4f53\u66f4\u4eae\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u65e0\u6cd5\u6295\u5c04\u9634\u5f71\u3002\u9634\u5f71\u80fd\u589e\u52a03D\u573a\u666f\u7684\u771f\u5b9e\u5ea6\uff0c\u56e0\u6b64\u6211\u4eec\u5c06\u5728\u672c\u7ae0\u4e2d\u6dfb\u52a0\u5bf9\u5b83\u7684\u652f\u6301\u3002 \u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u88ab\u79f0\u4e3a\u9634\u5f71\u6620\u5c04\uff08Shadow Mapping\uff09\u7684\u6280\u672f\uff0c\u8fd9\u79cd\u6280\u672f\u88ab\u5e7f\u6cdb\u4f7f\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u4e14\u4e0d\u4f1a\u4e25\u91cd\u5f71\u54cd\u5f15\u64ce\u6027\u80fd\u3002\u9634\u5f71\u6620\u5c04\u770b\u8d77\u6765\u5f88\u5bb9\u6613\u7406\u89e3\uff0c\u4f46\u662f\u5f88\u96be\u6b63\u786e\u5730\u5b9e\u73b0\u5b83\u3002\u6216\u8005\u66f4\u51c6\u786e\u5730\u8bf4\uff0c\u5f88\u96be\u7528\u4e00\u79cd\u901a\u7528\u7684\uff0c\u6db5\u76d6\u4e86\u4e00\u5207\u53ef\u80fd\u5e76\u4ea7\u751f\u4e00\u81f4\u7684\u6548\u679c\u7684\u65b9\u6cd5\u53bb\u5b9e\u73b0\u5b83\u3002 \u6211\u4eec\u5c06\u5728\u6b64\u8bf4\u660e\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ef\u4ee5\u4e3a\u4f60\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u6dfb\u52a0\u9634\u5f71\uff0c\u4f46\u66f4\u91cd\u8981\u7684\u662f\uff0c\u5b83\u5c06\u5e2e\u52a9\u4f60\u4e86\u89e3\u5176\u5c40\u9650\u6027\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u4ee3\u7801\u8fdc\u4e0d\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5f88\u5bb9\u6613\u7406\u89e3\u3002\u5b83\u8fd8\u88ab\u8bbe\u8ba1\u7528\u4e8e\u652f\u6301\u6709\u5411\u5149\uff08\u8fd9\u6211\u8ba4\u4e3a\u662f\u66f4\u590d\u6742\u7684\u60c5\u51b5\uff09\uff0c\u4f46\u4f60\u5c06\u4e86\u89e3\u5982\u4f55\u5c06\u5176\u6269\u5c55\u4ee5\u652f\u6301\u5176\u4ed6\u7c7b\u578b\u7684\u5149\u7167\uff08\u4f8b\u5982\u70b9\u5149\u6e90\uff09\u3002\u5982\u679c\u60f3\u83b7\u5f97\u66f4\u9ad8\u7ea7\u7684\u6548\u679c\uff0c\u4f60\u5e94\u8be5\u4f7f\u7528\u66f4\u9ad8\u7ea7\u7684\u6280\u672f\uff0c\u4f8b\u5982\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u8fd9\u91cc\u89e3\u91ca\u7684\u6982\u5ff5\u90fd\u4ec5\u4ec5\u4f5c\u4e3a\u57fa\u7840\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u4ece\u601d\u8003\u5982\u4f55\u68c0\u67e5\u7279\u5b9a\u533a\u57df\uff08\u5b9e\u9645\u4e0a\u662f\u7247\u5143\uff09\u662f\u5426\u5728\u9634\u5f71\u4e2d\u5f00\u59cb\u3002\u5728\u7ed8\u5236\u8fd9\u4e2a\u533a\u57df\u7684\u65f6\u5019\uff0c\u6211\u4eec\u53ef\u4ee5\u53d1\u51fa\u5c04\u7ebf\u6295\u5c04\u5230\u5149\u6e90\u4e0a\uff0c\u5982\u679c\u6211\u4eec\u53ef\u4ee5\u5728\u4e0d\u53d1\u751f\u4efb\u4f55\u78b0\u649e\u7684\u60c5\u51b5\u4e0b\u5230\u8fbe\u5149\u6e90\uff0c\u90a3\u4e48\u50cf\u7d20\u5c31\u5728\u5149\u7167\u4e2d\uff0c\u53cd\u4e4b\uff0c\u50cf\u7d20\u5904\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u70b9\u5149\u6e90\u7684\u60c5\u51b5\uff0c\u70b9PA\u53ef\u4ee5\u5230\u8fbe\u5149\u6e90\uff0c\u4f46\u70b9PB\u548cPC\u4e0d\u884c\uff0c\u56e0\u6b64\u5b83\u4eec\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u90a3\u4e48\uff0c\u6211\u4eec\u5982\u4f55\u624d\u80fd\u68c0\u67e5\u662f\u5426\u80fd\u4ee5\u4e00\u79cd\u6709\u6548\u7684\u65b9\u5f0f\u53d1\u5c04\u51fa\u4e0d\u53d1\u751f\u78b0\u649e\u7684\u5c04\u7ebf\u5462\uff1f\u7406\u8bba\u4e0a\uff0c\u5149\u6e90\u53ef\u4ee5\u6295\u5c04\u51fa\u65e0\u9650\u7684\u5149\u7ebf\uff0cName\u6211\u4eec\u5982\u4f55\u68c0\u67e5\u5149\u7ebf\u662f\u5426\u88ab\u906e\u6321\uff1f \u6211\u4eec\u80fd\u505a\u7684\u4e0d\u662f\u6295\u5c04\u5149\u7ebf\uff0c\u800c\u662f\u4ece\u5149\u7ebf\u900f\u89c6\u56fe\u4e2d\u89c2\u5bdf3D\u573a\u666f\uff0c\u5e76\u4ece\u8be5\u4f4d\u7f6e\u6e32\u67d3\u573a\u666f\u3002\u6211\u4eec\u53ef\u4ee5\u5c06\u76f8\u673a\u8bbe\u7f6e\u5728\u5149\u6e90\u4f4d\u7f6e\u5e76\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u50a8\u5b58\u6bcf\u4e2a\u7247\u5143\u7684\u6df1\u5ea6\u3002\u8fd9\u76f8\u5f53\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u6700\u540e\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u5c06\u5149\u7167\u6240\u53ca\u7684\u6700\u5c0f\u8ddd\u79bb\u50a8\u5b58\u4e3a\u9634\u5f71\u56fe\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u60ac\u6d6e\u5728\u5e73\u9762\u4e0a\u5e76\u5782\u76f4\u4e8e\u5149\u7ebf\u7684\u7acb\u65b9\u4f53\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u770b\uff0c\u60c5\u51b5\u662f\u8fd9\u6837\u7684\uff08\u989c\u8272\u8d8a\u6df1\uff0c\u8d8a\u63a5\u8fd1\u5149\u6e90\uff09\u3002 \u5229\u7528\u8fd9\u4e9b\u4fe1\u606f\u3002\u6211\u4eec\u53ef\u4ee5\u50cf\u5f80\u5e38\u4e00\u6837\u6e32\u67d33D\u573a\u666f\uff0c\u5e76\u4ee5\u6700\u5c0f\u50a8\u5b58\u8ddd\u79bb\u68c0\u67e5\u6bcf\u4e2a\u6bcf\u4e2a\u7247\u5143\u5230\u5149\u6e90\u7684\u8ddd\u79bb\u3002\u5982\u679c\u8ddd\u79bb\u5c0f\u4e8e\u9634\u5f71\u8d34\u56fe\u4e2d\u50a8\u5b58\u7684\u503c\uff0c\u5219\u5bf9\u8c61\u4f4d\u4e8e\u5149\u7167\u4e2d\uff0c\u5426\u5219\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002\u6211\u4eec\u53ef\u4ee5\u8ba9\u51e0\u4e2a\u7269\u4f53\u88ab\u540c\u4e00\u5149\u7167\u7167\u5c04\uff0c\u4f46\u6211\u4eec\u50a8\u5b58\u6700\u5c0f\u8ddd\u79bb\u3002 \u56e0\u6b64\uff0c\u9634\u5f71\u6620\u5c04\u5206\u4e3a\u4e24\u6b65\uff1a \u9996\u5148\uff0c\u6211\u4eec\u5c06\u573a\u666f\u4ece\u5149\u7167\u7a7a\u95f4\u6e32\u67d3\u4e3a\u9634\u5f71\u56fe\uff0c\u4ee5\u83b7\u5f97\u6700\u5c0f\u8ddd\u79bb\u3002 \u5176\u6b21\uff0c\u6211\u4eec\u4ece\u6444\u50cf\u673a\u7684\u89c6\u89d2\u6e32\u67d3\u573a\u666f\u3002\u5e76\u4f7f\u7528\u6df1\u5ea6\u56fe\u8ba1\u7b97\u5bf9\u8c61\u662f\u5426\u4f4d\u4e8e\u9634\u5f71\u4e2d\u3002 \u4e3a\u4e86\u6e32\u67d3\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u9700\u8981\u8bf4\u8bf4\u6df1\u5ea6\u7f13\u51b2\u533a\uff08Depth-buffer\uff09\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u65f6\uff0c\u6240\u6709\u6df1\u5ea6\u4fe1\u606f\u90fd\u50a8\u5b58\u5728\u4e00\u4e2a\u540d\u4e3a\u201c\u6df1\u5ea6\u7f13\u51b2\u533a\u201d\uff08\u53c8\u79f0\u201cZ\u7f13\u51b2\u533a\uff08Z-buffer\uff09\u201d\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u6df1\u5ea6\u4fe1\u606f\u662f\u6e32\u67d3\u7684\u6bcf\u4e2a\u7247\u5143\u7684 z \u503c\u3002\u5982\u679c\u4f60\u4ece\u7b2c\u4e00\u7ae0\u56de\u5fc6\u6211\u4eec\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u5c06\u6b63\u5728\u6e32\u67d3\u7684\u573a\u666f\u4ece\u4e16\u754c\u5750\u6807\u8f6c\u6362\u4e3a\u5c4f\u5e55\u5750\u6807\u3002\u6211\u4eec\u6240\u7ed8\u5236\u7684\u5750\u6807\u7a7a\u95f4\uff0c\u5bf9\u4e8e x \u548c y \u8f74\u6765\u8bf4\uff0c\u5750\u6807\u7684\u8303\u56f4\u4e3a 0 \u5230 1 \u3002\u5982\u679c\u4e00\u4e2a\u7269\u4f53\u6bd4\u5176\u4ed6\u5bf9\u8c61\u539f\uff0c\u6211\u4eec\u5fc5\u987b\u901a\u8fc7\u900f\u89c6\u6295\u5f71\u77e9\u9635\u8ba1\u7b97\u5b83\u5982\u4f55\u5f71\u54cd\u5176 x \u548c y \u5750\u6807\u3002\u8fd9\u4e0d\u662f\u6839\u636e z \u503c\u81ea\u52a8\u8ba1\u7b97\u7684\uff0c\u5b83\u5fc5\u987b\u7531\u6211\u4eec\u6765\u505a\u3002\u5b9e\u9645\u50a8\u5b58\u5728 z \u5750\u6807\u4e2d\u7684\u662f\u5b83\u5728\u7247\u5143\u7684\u6df1\u5ea6\uff0c\u4ec5\u6b64\u800c\u5df2\u3002 \u6b64\u5916\uff0c\u5728\u6e90\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u542f\u7528\u4e86\u6df1\u5ea6\u6d4b\u8bd5\u3002\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u5982\u4e0b\u884c\uff1a glEnable(GL_DEPTH_TEST); \u901a\u8fc7\u6dfb\u52a0\u8fd9\u884c\uff0c\u6211\u4eec\u53ef\u4ee5\u9632\u6b62\u65e0\u6cd5\u770b\u5230\u7684\u7247\u5143\u88ab\u7ed8\u5236\u51fa\u6765\uff0c\u56e0\u4e3a\u4ed6\u4eec\u4f4d\u4e8e\u5176\u4ed6\u5bf9\u8c61\u4e4b\u540e\u3002\u5728\u7ed8\u5236\u7247\u5143\u4e4b\u524d\uff0c\u5b83\u7684 z \u503c\u5c06\u4e0eZ\u7f13\u51b2\u533a\u4e2d\u7684 z \u503c\u8fdb\u884c\u6bd4\u8f83\u3002\u5982\u679c\u5b83\u7684 z \u503c\uff08\u5b83\u7684\u8ddd\u79bb\uff09\u5927\u4e8e\u7f13\u51b2\u533a\u7684 z \u503c\uff0c\u5219\u4f1a\u88ab\u4e22\u5f03\u3002\u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u662f\u5728\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u5b8c\u6210\u7684\uff0c\u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u5bf9\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u8303\u56f4\u4e3a [0, 1] \u7684 x \u548c y \u5750\u6807\uff0c\u6211\u4eec\u6bd4\u8f83\u5176\u7247\u5143\u7684 z \u503c\u3002\u540c\u6837\uff0c z \u503c\u4e5f\u5728\u6b64\u8303\u56f4\u5185\u3002 \u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u5b58\u5728\u662f\u6211\u4eec\u5728\u6267\u884c\u4efb\u4f55\u6e32\u67d3\u64cd\u4f5c\u4e4b\u524d\u9700\u8981\u6e05\u9664\u5c4f\u5e55\u7684\u539f\u56e0\u3002\u6211\u4eec\u4e0d\u4ec5\u9700\u8981\u6e05\u9664\u989c\u8272\uff0c\u8fd8\u8981\u6e05\u9664\u6df1\u5ea6\u4fe1\u606f\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); } \u4e3a\u4e86\u5f00\u59cb\u6784\u5efa\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5e0c\u671b\u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u83b7\u5f97\u6df1\u5ea6\u4fe1\u606f\u3002\u6211\u4eec\u9700\u8981\u5728\u5149\u6e90\u4f4d\u7f6e\u8bbe\u7f6e\u4e00\u4e2a\u6444\u50cf\u5934\uff0c\u6e32\u67d3\u573a\u666f\u5e76\u5c06\u6df1\u5ea6\u4fe1\u606f\u50a8\u5b58\u5230\u7eb9\u7406\u4e2d\uff0c\u4ee5\u4fbf\u7a0d\u540e\u8bbf\u95ee\u5b83\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u9700\u8981\u505a\u7684\u662f\u6dfb\u52a0\u5bf9\u521b\u5efa\u8fd9\u4e9b\u7eb9\u7406\u7684\u652f\u6301\u3002\u6211\u4eec\u5c06\u4fee\u6539 Texture \u7c7b\uff0c\u901a\u8fc7\u6dfb\u52a0\u65b0\u7684\u6784\u9020\u51fd\u6570\u6765\u652f\u6301\u521b\u5efa\u7a7a\u7eb9\u7406\u3002\u6b64\u6784\u9020\u51fd\u6570\u9700\u8981\u7eb9\u7406\u7684\u5c3a\u5bf8\u4ee5\u53ca\u5b83\u50a8\u5b58\u7684\u50cf\u7d20\u7684\u683c\u5f0f\u3002 public Texture(int width, int height, int pixelFormat) throws Exception { this.id = glGenTextures(); this.width = width; this.height = height; glBindTexture(GL_TEXTURE_2D, this.id); glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT, this.width, this.height, 0, pixelFormat, GL_FLOAT, (ByteBuffer) null); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE); glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE); } \u6211\u4eec\u5c06\u7eb9\u7406\u73af\u7ed5\u65b9\u5f0f\u8bbe\u7f6e\u4e3a GL_CLAMP_TO_EDGE \uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u5e0c\u671b\u5728\u8d85\u51fa [0, 1] \u8303\u56f4\u65f6\u91cd\u590d\u7eb9\u7406\u3002 \u6240\u4ee5\uff0c\u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u7a7a\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u5176\u4e2d\u6e32\u67d3\u4e00\u4e2a\u573a\u666f\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5e27\u7f13\u51b2\u533a\u5bf9\u8c61\uff08Frame Buffers Objects\uff0c\u6216\u79f0FBOs\uff09\u3002\u5e27\u7f13\u51b2\u533a\u662f\u53ef\u4ee5\u4f5c\u4e3a\u6e32\u67d3\u7ec8\u70b9\u7684\u7f13\u51b2\u533a\u96c6\u5408\u3002\u5f53\u6211\u4eec\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\u65f6\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL\u7684\u9ed8\u8ba4\u7f13\u51b2\u533a\u3002OpenGL\u5141\u8bb8\u6211\u4eec\u4f7f\u7528FBO\u6e32\u67d3\u5230\u7528\u6237\u5b9a\u4e49\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u5c06\u901a\u8fc7\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a ShadowMap \u7684\u65b0\u7c7b\uff0c\u6765\u9694\u79bb\u4e3a\u9634\u5f71\u6620\u5c04\u521b\u5efaFBO\u8fc7\u7a0b\u7684\u5176\u4f59\u4ee3\u7801\u3002\u5982\u4e0b\u5c31\u662f\u90a3\u4e2a\u7c7b\u7684\u5b9a\u4e49\u3002 package org.lwjglb.engine.graph; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class ShadowMap { public static final int SHADOW_MAP_WIDTH = 1024; public static final int SHADOW_MAP_HEIGHT = 1024; private final int depthMapFBO; private final Texture depthMap; public ShadowMap() throws Exception { // \u521b\u5efaFBO\u4ee5\u6e32\u67d3\u6df1\u5ea6\u56fe depthMapFBO = glGenFramebuffers(); // \u521b\u5efa\u6df1\u5ea6\u56fe\u7eb9\u7406 depthMap = new Texture(SHADOW_MAP_WIDTH, SHADOW_MAP_HEIGHT, GL_DEPTH_COMPONENT); // \u7ed1\u5b9a\u6df1\u5ea6\u56fe\u7eb9\u7406\u5230FBO glBindFramebuffer(GL_FRAMEBUFFER, depthMapFBO); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, depthMap.getId(), 0); // \u4ec5\u8bbe\u7f6e\u6df1\u5ea6 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE) { throw new Exception(\"Could not create FrameBuffer\"); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public Texture getDepthMapTexture() { return depthMap; } public int getDepthMapFBO() { return depthMapFBO; } public void cleanup() { glDeleteFramebuffers(depthMapFBO); depthMap.cleanup(); } } ShadowMap \u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff0c\u7528\u4e8e\u786e\u5b9a\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5927\u5c0f\u3002\u5b83\u8fd8\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5c5e\u6027\uff0c\u4e00\u4e2a\u7528\u4e8eFBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u7eb9\u7406\u3002\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u521b\u5efa\u4e00\u4e2a\u65b0\u7684FBO\u548c\u4e00\u4e2a\u65b0\u7684 Texture \u3002\u5bf9\u4e8eFBO\uff0c\u5c06\u4f7f\u7528\u5e38\u91cf GL_DEPTH_COMPONENT \u4f5c\u4e3a\u50cf\u7d20\u683c\u5f0f\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u5bf9\u50a8\u5b58\u6df1\u5ea6\u503c\u611f\u5174\u8da3\uff0c\u7136\u540e\u5c06FBO\u7ed1\u5b9a\u5230\u7eb9\u7406\u5b9e\u4f8b\u3002 \u4ee5\u4e0b\u51e0\u884c\u4ee3\u7801\u663e\u5f0f\u5730\u5c06FBO\u8bbe\u7f6e\u4e3a\u4e0d\u6e32\u67d3\u4efb\u4f55\u989c\u8272\u3002FBO\u9700\u8981\u989c\u8272\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u4e0d\u9700\u8981\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u6211\u4eec\u5c06\u989c\u8272\u7f13\u51b2\u533a\u8bbe\u7f6e\u4e3a GL_NONE \u3002 glDrawBuffer(GL_NONE); glReadBuffer(GL_NONE); \u73b0\u5728\uff0c\u6211\u4eec\u51c6\u5907\u5728 Renderer \u7c7b\u4e2d\u5c06\u573a\u666f\u4ece\u706f\u5149\u900f\u89c6\u6e32\u67d3\u4e3aFBO\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u7ec4\u7279\u6b8a\u7684\u9876\u70b9\u548c\u7247\u5143\u7740\u8272\u5668\u3002 \u540d\u4e3a depth_vertex.vs \u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { gl_Position = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0f); } \u6211\u4eec\u5e0c\u671b\u63a5\u6536\u4e0e\u573a\u666f\u7740\u8272\u5668\u76f8\u540c\u7684\u8f93\u5165\u6570\u636e\u3002\u4f46\u5b9e\u9645\u4e0a\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5750\u6807\uff0c\u4f46\u662f\u4e3a\u4e86\u5c3d\u53ef\u80fd\u591a\u5730\u91cd\u7528\u4ee3\u7801\uff0c\u6211\u4eec\u8fd8\u662f\u8981\u4f20\u9001\u5176\u4ed6\u6570\u636e\u3002\u6211\u4eec\u8fd8\u9700\u8981\u4e00\u5bf9\u77e9\u9635\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u4ee5\u5149\u6e90\u7684\u89d2\u5ea6\u6e32\u67d3\u573a\u666f\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5c06\u6a21\u578b\u8f6c\u6362\u5230\u5149\u6e90\u7684\u5750\u6807\u7a7a\u95f4\u3002\u8fd9\u662f\u901a\u8fc7 modelLightViewMatrix \u77e9\u9635\u5b8c\u6210\u7684\uff0c\u8be5\u77e9\u9635\u7c7b\u4f3c\u4e8e\u7528\u4e8e\u6444\u50cf\u673a\u7684\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u73b0\u5728\u5149\u6e90\u662f\u6211\u4eec\u7684\u6444\u50cf\u673a\u3002 \u7136\u540e\u6211\u4eec\u9700\u8981\u5c06\u8fd9\u4e9b\u5750\u6807\u8f6c\u6362\u5230\u5c4f\u5e55\u7a7a\u95f4\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u9700\u8981\u6295\u5f71\u5b83\u4eec\u3002\u8fd9\u662f\u8ba1\u7b97\u5e73\u884c\u5149\u4e0e\u70b9\u5149\u6e90\u7684\u9634\u5f71\u56fe\u65f6\u7684\u533a\u522b\u4e4b\u4e00\u3002\u5bf9\u4e8e\u5730\u6602\u626c\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u900f\u89c6\u6295\u5f71\uff08Perspective Projection\uff09\u77e9\u9635\uff0c\u5c31\u50cf\u6211\u4eec\u6b63\u5e38\u6e32\u67d3\u573a\u666f\u4e00\u6837\u3002\u76f8\u53cd\uff0c\u5e73\u884c\u5149\u4ee5\u76f8\u540c\u65b9\u5f0f\u5f71\u54cd\u6240\u6709\u5bf9\u8c61\uff0c\u800c\u4e0e\u8ddd\u79bb\u65e0\u5173\u3002\u5e73\u884c\u5149\u6e90\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u7684\u70b9\u4e0a\uff0c\u6ca1\u6709\u4f4d\u7f6e\uff0c\u53ea\u6709\u65b9\u5411\u3002\u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff09\u4e0d\u4f1a\u4f7f\u8fdc\u5904\u7684\u7269\u4f53\u53d8\u5c0f\uff0c\u56e0\u6b64\uff0c\u6b63\u4ea4\u6295\u5f71\u6700\u9002\u5408\u5e73\u884c\u5149\u3002 \u7247\u5143\u7740\u8272\u5668\u66f4\u7b80\u5355\u3002\u5b83\u53ea\u8f93\u51fa z \u5750\u6807\u4f5c\u4e3a\u6df1\u5ea6\u503c\u3002 #version 330 void main() { gl_FragDepth = gl_FragCoord.z; } \u5b9e\u9645\u4e0a\uff0c\u4f60\u53ef\u4ee5\u5220\u6389\u8be5\u884c\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u751f\u6210\u6df1\u5ea6\u503c\uff0c\u6df1\u5ea6\u503c\u5c06\u81ea\u52a8\u8fd4\u56de\u3002 \u4e00\u65e6\u6211\u4eec\u4e3a\u6df1\u5ea6\u6e32\u67d3\u5b9a\u4e49\u4e86\u65b0\u7684\u7740\u8272\u5668\uff0c\u5c31\u53ef\u4ee5\u5728 Renderer \u7c7b\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u4e3a\u521d\u59cb\u5316\u8fd9\u4e9b\u7740\u8272\u5668\u5b9a\u4e49\u4e86\u4e00\u4e2a\u65b0\u65b9\u6cd5\uff0c\u540d\u4e3a setupDepthShader \uff0c\u5b83\u5c06\u5728\u5176\u4ed6\u7740\u8272\u5668\u88ab\u521d\u59cb\u5316\u65f6\u8c03\u7528\u3002 private void setupDepthShader() throws Exception { depthShaderProgram = new ShaderProgram(); depthShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/depth_vertex.vs\")); depthShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/depth_fragment.fs\")); depthShaderProgram.link(); depthShaderProgram.createUniform(\"orthoProjectionMatrix\"); depthShaderProgram.createUniform(\"modelLightViewMatrix\"); } \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u65b9\u6cd5\uff0c\u4f7f\u7528\u90a3\u4e9b\u540d\u4e3a renderDepthMap \u7684\u7740\u8272\u5668\u3002\u8be5\u65b9\u6cd5\u5c06\u5728\u4e3b\u6e32\u67d3\u65b9\u6cd5\u4e2d\u8c03\u7528\u3002 public void render(Window window, Camera camera, Scene scene, IHud hud) { clear(); // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe renderDepthMap(window, camera, scene); glViewport(0, 0, window.getWidth(), window.getHeight()); // \u5176\u4f59\u7684\u4ee3\u7801\u5728\u8fd9... \u5982\u679c\u4f60\u6d4f\u89c8\u4e0a\u8ff0\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\uff0c\u65b0\u65b9\u6cd5\u5c31\u5df2\u7ecf\u88ab\u8c03\u7528\u3002\u8fd9\u662f\u56e0\u4e3a\u8fd9\u4e2a\u65b0\u65b9\u6cd5\u5c06\u66f4\u9ad8\u89c6\u53e3\u4ee5\u5339\u914d\u4fdd\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5c3a\u5bf8\u3002\u56e0\u6b64\uff0c\u5728\u5b8c\u6210 renderDepthMap \u4e4b\u540e\uff0c\u6211\u4eec\u5c06\u59cb\u7ec8\u9700\u8981\u8bbe\u7f6e\u5c4f\u5e55\u5c3a\u5bf8\u7684\u89c6\u53e3\uff08\u4e0d\u68c0\u67e5\u7a97\u53e3\u662f\u5426\u5df2\u8c03\u6574\u5927\u5c0f\uff09\u3002 \u73b0\u5728\u8ba9\u6211\u4eec\u5b9a\u4e49\u4e00\u4e0b renderDepthMap \u65b9\u6cd5\u3002\u7b2c\u4e00\u4ef6\u4e8b\u662f\u7ed1\u5b9a\u5728 ShadowMap \u7c7b\u4e2d\u521b\u5efa\u7684FBO\uff0c\u5e76\u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5c3a\u5bf8\u3002 glBindFramebuffer(GL_FRAMEBUFFER, shadowMap.getDepthMapFBO()); glViewport(0, 0, ShadowMap.SHADOW_MAP_WIDTH, ShadowMap.SHADOW_MAP_HEIGHT); \u7136\u540e\uff0c\u6e05\u9664\u6df1\u5ea6\u7f13\u51b2\u533a\u5185\u5bb9\u5e76\u7ed1\u5b9a\u6df1\u5ea6\u7740\u8272\u5668\u3002\u56e0\u4e3a\u6211\u4eec\u53ea\u5904\u7406\u6df1\u5ea6\u503c\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6e05\u9664\u989c\u8272\u4fe1\u606f\u3002 glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); \u73b0\u5728\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u77e9\u9635\uff0c\u63a5\u4e0b\u6765\u662f\u68d8\u624b\u7684\u90e8\u5206\u3002\u6211\u4eec\u4f7f\u7528\u5149\u6e90\u4f5c\u4e3a\u6444\u50cf\u673a\uff0c\u6240\u4ee5\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u9700\u8981\u4e00\u4e2a\u5750\u6807\u548c\u4e09\u4e2a\u89d2\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6b63\u5982\u672c\u7ae0\u5f00\u5934\u6240\u8bf4\uff0c\u6211\u4eec\u53ea\u5b9e\u73b0\u5e73\u884c\u5149\uff0c\u8fd9\u79cd\u7c7b\u578b\u7684\u5149\u4e0d\u5b9a\u4e49\u4f4d\u7f6e\uff0c\u800c\u662f\u5b9a\u4e49\u65b9\u5411\u3002\u5982\u679c\u6211\u4eec\u4f7f\u7528\u70b9\u5149\u6e90\uff0c\u8fd9\u5f88\u5bb9\u6613\uff0c\u5149\u6e90\u7684\u4f4d\u7f6e\u5c31\u662f\u89c2\u5bdf\u77e9\u9635\u7684\u4f4d\u7f6e\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u4f4d\u7f6e\u3002 \u6211\u4eec\u5c06\u91c7\u7528\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u6cd5\u6765\u8ba1\u7b97\u5149\u7684\u4f4d\u7f6e\u3002\u5e73\u884c\u5149\u662f\u7531\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u7684\uff0c\u901a\u5e38\u662f\u5f52\u4e00\u5316\u7684\uff0c\u5b83\u6307\u5411\u5149\u6e90\u6240\u5728\u7684\u65b9\u5411\u3002\u6211\u4eec\u628a\u8fd9\u4e2a\u65b9\u5411\u5411\u91cf\u4e58\u4ee5\u4e00\u4e2a\u53ef\u914d\u7f6e\u7684\u56e0\u5b50\uff0c\u5728\u8fd9\u6837\u5b83\u5c31\u4e3a\u8981\u7ed8\u5236\u7684\u573a\u666f\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5408\u7406\u8ddd\u79bb\u7684\u70b9\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u65b9\u5411\u6765\u8ba1\u7b97\u8be5\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u8fd9\u662f\u8ba1\u7b97\u706f\u5149\u4f4d\u7f6e\u4e0e\u65cb\u8f6c\u89d2\u5ea6\u7684\u4ee3\u7801\u7247\u6bb5\uff1a float lightAngleX = (float)Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float)Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Matrix4f lightViewMatrix = transformation.updateLightViewMatrix(new Vector3f(lightDirection).mul(light.getShadowPosMult()), new Vector3f(lightAngleX, lightAngleY, lightAngleZ)); \u63a5\u4e0b\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff1a Matrix4f orthoProjMatrix = transformation.updateOrthoProjectionMatrix(orthCoords.left, orthCoords.right, orthCoords.bottom, orthCoords.top, orthCoords.near, orthCoords.far); \u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86 Transformation \u7c7b\uff0c\u4ee5\u56ca\u62ec\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6b64\u4eec\u6709\u4e00\u4e2a\u6b63\u4ea4\u7684\u4e8c\u7ef4\u6295\u5f71\u77e9\u9635\uff0c\u6240\u4ee5\u6211\u4eec\u91cd\u547d\u540d\u4e86\u6b64\u524d\u7684\u65b9\u6cd5\u548c\u5c5e\u6027\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u5b9a\u4e49\u3002 \u7136\u540e\uff0c\u6211\u4eec\u6309\u7167 renderScene \u65b9\u6cd5\u6e32\u67d3\u573a\u666f\u5bf9\u8c61\uff0c\u4f46\u5728\u5149\u7167\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u4f7f\u7528\u4e0a\u8ff0\u77e9\u9635\u5de5\u4f5c\u3002 depthShaderProgram.setUniform(\"orthoProjectionMatrix\", orthoProjMatrix); Map<Mesh, List<GameItem>> mapMeshes = scene.getGameMeshes(); for (Mesh mesh : mapMeshes.keySet()) { mesh.renderList(mapMeshes.get(mesh), (GameItem gameItem) -> { Matrix4f modelLightViewMatrix = transformation.buildModelViewMatrix(gameItem, lightViewMatrix); depthShaderProgram.setUniform(\"modelLightViewMatrix\", modelLightViewMatrix); } ); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); \u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u662f\u5728\u5e73\u884c\u5149\u4e2d\u5b9a\u4e49\u7684\u3002\u5c06\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u60f3\u8c61\u4e3a\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5176\u4e2d\u5305\u542b\u6211\u4eec\u8981\u6e32\u67d3\u7684\u6240\u6709\u5bf9\u8c61\u3002\u5f53\u53ea\u6295\u5f71\u9002\u5408\u8be5\u8fb9\u754c\u6846\u7684\u5bf9\u8c61\u65f6\uff0c\u5bf9\u8c61\u5c06\u53ef\u89c6\u3002\u8be5\u8fb9\u754c\u6846\u75316\u4e2a\u53c2\u6570\u5b9a\u4e49\uff1a\u5de6\u3001\u53f3\u3001\u4e0a\u3001\u4e0b\u3001\u8fd1\u3001\u8fdc\u3002\u7531\u4e8e\u5149\u6e90\u4f4d\u7f6e\u73b0\u5728\u662f\u539f\u70b9\uff0c\u56e0\u6b64\u8fd9\u4e9b\u53c2\u6570\u5b9a\u4e49\u4e3a\u539f\u70b9\u5230\u5de6\u6216\u53f3\uff08x\u8f74\uff09\u6216\u4e0a\u6216\u4e0b\uff08y\u8f74\uff09\u6216\u8fdc\u6216\u8fd1\uff08z\u8f74\uff09\u7684\u8ddd\u79bb\u3002 \u8981\u4f7f\u9634\u5f71\u56fe\u6b63\u5e38\u5de5\u4f5c\uff0c\u6700\u68d8\u624b\u7684\u4e00\u70b9\u662f\u786e\u5b9a\u706f\u5149\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u7684\u53c2\u6570\u3002\u8fd9\u5c31\u662f\u6240\u6709\u8fd9\u4e9b\u53c2\u6570\u73b0\u5728\u5728 DirectionalLight \u7c7b\u4e2d\u5b9a\u4e49\u7684\u65b9\u5f0f\uff0c\u56e0\u6b64\u53ef\u4ee5\u6839\u636e\u6bcf\u4e2a\u573a\u666f\u6b63\u786e\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\u3002 \u4f60\u53ef\u4ee5\u5b9e\u73b0\u4e00\u4e2a\u66f4\u81ea\u52a8\u7684\u65b9\u6cd5\uff0c\u901a\u8fc7\u8ba1\u7b97\u6444\u50cf\u673a\u622a\u9525\uff08Frustum\uff09\u7684\u4e2d\u5fc3\uff0c\u56de\u5230\u5149\u7684\u65b9\u5411\uff0c\u5efa\u7acb\u4e00\u4e2a\u5305\u542b\u573a\u666f\u4e2d\u6240\u6709\u5bf9\u8c61\u7684\u6b63\u4ea4\u6295\u5f71\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u5982\u4e0a\u6240\u8ff0\u7684\u4e09\u7ef4\u573a\u666f\u3001\u76f8\u673a\u4f4d\u7f6e\u3001\u622a\u9525\uff08\u84dd\u8272\uff09\u3001\u6700\u4f73\u5149\u6e90\u4f4d\u7f6e\u4ee5\u53ca\u7ea2\u8272\u7684\u8fb9\u754c\u6846\u3002 \u4e0a\u8ff0\u65b9\u6cd5\u7684\u95ee\u9898\u662f\u5f88\u96be\u8ba1\u7b97\uff0c\u5982\u679c\u4f60\u6709\u5f88\u5c0f\u7684\u7269\u4f53\uff0c\u5e76\u4e14\u8fb9\u754c\u6846\u5f88\u5927\uff0c\u4f60\u53ef\u4ee5\u4f1a\u5f97\u5230\u5947\u602a\u7684\u7ed3\u679c\u3002\u8fd9\u91cc\u4ecb\u7ecd\u7684\u65b9\u6cd5\u5bf9\u4e8e\u5c0f\u573a\u666f\u66f4\u7b80\u5355\uff0c\u4f60\u53ef\u4ee5\u8c03\u6574\u5b83\u4ee5\u5339\u914d\u4f60\u7684\u6a21\u578b\uff08\u5373\u4f7f\u4f60\u53ef\u4ee5\u9009\u62e9\u663e\u5f0f\u8bbe\u7f6e\u706f\u5149\u7684\u4f4d\u7f6e\uff0c\u4ee5\u907f\u514d\u76f8\u673a\u8fdc\u79bb\u539f\u70b9\u79fb\u52a8\u65f6\u4ea7\u751f\u5947\u602a\u7684\u6548\u679c\uff09\u3002\u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u901a\u7528\u7684\u6a21\u677f\uff0c\u53ef\u4ee5\u5e94\u7528\u5230\u4efb\u4f55\u573a\u666f\uff0c\u4f60\u5e94\u8be5\u6269\u5c55\u5b83\uff0c\u4ee5\u652f\u6301\u5c42\u53e0\u9634\u5f71\u56fe\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u3002\u5728\u4f7f\u7528\u6df1\u5ea6\u56fe\u5b9e\u9645\u8ba1\u7b97\u9634\u5f71\u4e4b\u524d\uff0c\u53ef\u4ee5\u4f7f\u7528\u751f\u6210\u7684\u7eb9\u7406\u6e32\u67d3\u4e00\u4e2a\u6b63\u65b9\u5f62\uff0c\u4ee5\u89c2\u5bdf\u6df1\u5ea6\u56fe\u7684\u5b9e\u9645\u5916\u89c2\u3002\u5728\u6709\u4e00\u4e2a\u65cb\u8f6c\u7acb\u65b9\u4f53\u6f02\u6d6e\u5728\u4e00\u4e2a\u6709\u5782\u76f4\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u7684\u573a\u666f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\u3002 \u5982\u4e0a\u6240\u8ff0\uff0c\u989c\u8272\u8d8a\u6df1\uff0c\u79bb\u5149\u6e90\u7684\u4f4d\u7f6e\u8d8a\u8fd1\u3002\u6df1\u5ea6\u56fe\u4e2d\u5149\u6e90\u4f4d\u7f6e\u7684\u5f71\u54cd\u662f\u4ec0\u4e48\uff1f\u4f60\u53ef\u4ee5\u4fee\u6539\u5e73\u884c\u5149\u7167\u7684\u500d\u589e\u56e0\u5b50\uff0c\u5c06\u770b\u5230\u5728\u7eb9\u7406\u4e2d\u6e32\u67d3\u7684\u5bf9\u8c61\u7684\u5927\u5c0f\u4e0d\u4f1a\u53d8\u5c0f\u3002\u8bb0\u4f4f\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\uff0c\u7269\u4f53\u4e0d\u4f1a\u968f\u7740\u8ddd\u79bb\u589e\u5927\u800c\u53d8\u5c0f\u3002\u4f60\u5c06\u770b\u5230\u7684\u662f\uff0c\u6240\u6709\u7684\u989c\u8272\u90fd\u4f1a\u53d8\u5f97\u66f4\u4eae\uff0c\u5982\u4e0b\u6240\u793a\uff1a \u8fd9\u662f\u5426\u610f\u5473\u7740\u6211\u4eec\u53ef\u4ee5\u4e3a\u5149\u6e90\u9009\u62e9\u4e00\u4e2a\u8f83\u8fdc\u7684\u4f4d\u7f6e\u800c\u4e0d\u9020\u6210\u4efb\u4f55\u540e\u679c\u5462\uff1f\u7b54\u6848\u662f\u4e0d\u884c\u3002\u5982\u679c\u5149\u6e90\u79bb\u6211\u4eec\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u592a\u8fdc\uff0c\u8fd9\u4e9b\u5bf9\u8c61\u4f1a\u8d85\u51fa\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u767d\u8272\u7eb9\u7406\uff0c\u4f46\u8fd9\u662f\u6ca1\u7528\u7684\u9634\u5f71\u56fe\u3002\u597d\u7684\uff0c\u90a3\u4e48\u6211\u4eec\u53ea\u9700\u589e\u52a0\u8fb9\u754c\u6846\u7684\u5927\u5c0f\uff0c\u4e00\u5207\u90fd\u4f1a\u597d\u7684\uff0c\u5bf9\u5417\uff1f\u7b54\u6848\u4e5f\u662f\u4e0d\u884c\u3002\u5982\u679c\u4f60\u4e3a\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u9009\u7528\u4e86\u5de8\u5927\u7684\u5c3a\u5bf8\uff0c\u4f60\u7684\u7269\u4f53\u5728\u7eb9\u7406\u4e2d\u4f1a\u88ab\u7ed8\u5236\u5f97\u5f88\u5c0f\uff0c\u6df1\u5ea6\u503c\u751a\u81f3\u4f1a\u91cd\u53e0\uff0c\u9020\u6210\u5947\u602a\u7684\u7ed3\u679c\u3002\u597d\u5427\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u8003\u8651\u589e\u52a0\u7eb9\u7406\u5927\u5c0f\uff0c\u4f46\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u662f\u6709\u9650\u5236\u7684\uff0c\u7eb9\u7406\u4e0d\u80fd\u56e0\u4f7f\u7528\u5de8\u5927\u7684\u7f16\u8f91\u6846\u800c\u65e0\u9650\u589e\u5927\u3002 \u56e0\u6b64\uff0c\u53ef\u4ee5\u770b\u5230\uff0c\u9009\u62e9\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u6b63\u4ea4\u6295\u5f71\u7684\u53c2\u6570\u662f\u4e00\u4e2a\u590d\u6742\u7684\u5e73\u8861\uff0c\u8fd9\u4f7f\u5f97\u4f7f\u7528\u9634\u5f71\u56fe\u5f88\u96be\u5f97\u5230\u6b63\u786e\u7684\u6548\u679c\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u6e32\u67d3\u8fc7\u7a0b\uff0c\u4e00\u65e6\u8ba1\u7b97\u4e86\u6df1\u5ea6\u56fe\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5728\u6e32\u67d3\u573a\u666f\u65f6\u4f7f\u7528\u5b83\u3002\u9996\u5148\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528\u900f\u89c6\u77e9\u9635\u5c06\u9876\u70b9\u5750\u6807\u4ece\u6a21\u578b\u89c2\u5bdf\u7a7a\u95f4\u6295\u5f71\u5230\u5c4f\u5e55\u7a7a\u95f4\u3002\u73b0\u5728\u8fd8\u9700\u8981\u4f7f\u7528\u6295\u5f71\u77e9\u9635\u4ece\u5149\u7167\u7a7a\u95f4\u5750\u6807\u6295\u5f71\u9876\u70b9\u5750\u6807\uff0c\u4ee5\u7528\u4e8e\u7247\u5143\u7740\u8272\u5668\u4e2d\u8ba1\u7b97\u9634\u5f71\u3002 \u9876\u70b9\u7740\u8272\u5668\u662f\u8fd9\u6837\u4fee\u6539\u7684\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 mvPos = modelViewMatrix * vec4(position, 1.0); gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6211\u4eec\u4e3a\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u4f7f\u7528\u4e86\u65b0\u7684Uniform\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u51fd\u6570\u6765\u8ba1\u7b97\u9634\u5f71\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a float calcShadow(vec4 position) { float shadowFactor = 1.0; vec3 projCoords = position.xyz; // \u4ece\u5c4f\u5e55\u5750\u6807\u53d8\u6362\u5230\u7eb9\u7406\u5750\u6807 projCoords = projCoords * 0.5 + 0.5; if ( projCoords.z < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } return 1 - shadowFactor; } \u8be5\u51fd\u6570\u63a5\u6536\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u6295\u5f71\u7684\u5149\u7167\u89c2\u5bdf\u7a7a\u95f4\u7684\u5750\u6807\u3002\u5982\u679c\u5750\u6807\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 0 \uff0c\u5982\u679c\u4e0d\u5728\u9634\u5f71\u4e2d\uff0c\u5219\u8fd4\u56de 1 \u3002\u9996\u5148\uff0c\u5c06\u5750\u6807\u8f6c\u6362\u4e3a\u7eb9\u7406\u5750\u6807\u3002\u5c4f\u5e55\u5750\u6807\u5728 [-1, 1] \u8303\u56f4\u5185\uff0c\u4f46\u7eb9\u7406\u5750\u6807\u5728 [0, 1] \u8303\u56f4\u5185\u3002\u6211\u4eec\u901a\u8fc7\u5750\u6807\u4ece\u7eb9\u7406\u4e2d\u83b7\u53d6\u6df1\u5ea6\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u7247\u5143\u5750\u6807\u7684 z \u503c\u6bd4\u8f83\u3002\u5982\u679c z \u503c\u4f4e\u4e8e\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\u7684\u503c\uff0c\u5219\u8868\u793a\u7247\u5143\u4e0d\u518d\u9634\u5f71\u4e2d\u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c calcShadow \u51fd\u6570\u7684\u8fd4\u56de\u503c\uff0c\u7528\u4e8e\u8c03\u8282\u70b9\u5149\u6e90\u3001\u805a\u5149\u6e90\u548c\u5e73\u884c\u5149\u5bf9\u5149\u7167\u989c\u8272\u7684\u5171\u4eab\u3002\u73af\u5883\u5149\u4e0d\u53d7\u9634\u5f71\u7684\u5f71\u54cd\u3002 float shadow = calcShadow(mlightviewVertexPos); fragColor = clamp(ambientC * vec4(ambientLight, 1) + diffuseSpecularComp * shadow, 0, 1); \u5728 Renderer \u7c7b\u7684 renderScene \u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f20\u9012\u6b63\u4ea4\u6295\u5f71\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5230Uniform\uff08\u6211\u4eec\u8fd8\u9700\u8981\u4fee\u6539\u7740\u8272\u5668\u7684\u521d\u59cb\u5316\u65b9\u6cd5\u4ee5\u521b\u5efa\u65b0\u7684Uniform\uff09\u3002\u4f60\u53ef\u4ee5\u5728\u672c\u4e66\u7684\u6e90\u4ee3\u7801\u4e2d\u4e86\u89e3\u3002 \u5982\u679c\u8fd0\u884c DummyGame \u7c7b\uff0c\u8be5\u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u5728\u5e26\u6709\u5e73\u884c\u5149\u7684\u5e73\u9762\u4e0a\u8bbe\u7f6e\u6709\u60ac\u6d6e\u7684\u7acb\u65b9\u4f53\uff0c\u5e76\u53ef\u4f7f\u7528\u4e0a\u4e0b\u952e\u4fee\u6539\u89d2\u5ea6\uff0c\u5219\u5e94\u8be5\u770b\u5230\u5982\u4e0b\u60c5\u51b5\u3002 \u867d\u7136\u9634\u5f71\u5df2\u7ecf\u5de5\u4f5c\u4e86\uff08\u4f60\u53ef\u4ee5\u901a\u8fc7\u79fb\u52a8\u5149\u7167\u65b9\u5411\u6765\u68c0\u67e5\uff09\uff0c\u4f46\u662f\u5b9e\u9645\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u88ab\u7167\u4eae\u7684\u7269\u4f53\u4e2d\u6709\u5947\u602a\u7684\u7ebf\u6761\u3002\u8fd9\u79cd\u60c5\u51b5\u88ab\u79f0\u4e3a\u9634\u5f71\u5931\u771f\uff08Shadow Acne\uff09\uff0c\u5b83\u662f\u7531\u50a8\u5b58\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u7684\u5206\u8fa8\u7387\u6709\u9650\u9020\u6210\u7684\u3002\u7b2c\u4e8c\u4e2a\u95ee\u9898\u662f\uff0c\u9634\u5f71\u7684\u8fb9\u754c\u4e0d\u5e73\u6ed1\uff0c\u770b\u8d77\u6765\u5f88\u7c97\u7cd9\u3002\u539f\u56e0\u540c\u6837\uff0c\u7eb9\u7406\u5206\u8fa8\u7387\u3002\u6211\u4eec\u5c06\u89e3\u51b3\u8fd9\u4e9b\u95ee\u9898\uff0c\u4ee5\u63d0\u9ad8\u9634\u5f71\u8d28\u91cf\u3002","title":"\u9634\u5f71\u6620\u5c04"},{"location":"18-shadows/#_2","text":"\u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u9634\u5f71\u6620\u5c04\u673a\u5236\uff0c\u90a3\u4e48\u8ba9\u6211\u4eec\u6765\u89e3\u51b3\u73b0\u6709\u7684\u95ee\u9898\u3002\u6211\u4eec\u5148\u4ece\u5931\u771f\u95ee\u9898\u5f00\u59cb\u3002\u6df1\u5ea6\u56fe\u7eb9\u7406\u5927\u5c0f\u6709\u9650\uff0c\u56e0\u6b64\uff0c\u53ef\u4ee5\u5c06\u591a\u4e2a\u7247\u5143\u6620\u5c04\u5230\u8be5\u7eb9\u7406\u6df1\u5ea6\u4e2d\u7684\u540c\u4e00\u50cf\u7d20\u3002\u7eb9\u7406\u6df1\u5ea6\u50a8\u5b58\u6700\u5c0f\u6df1\u5ea6\uff0c\u56e0\u6b64\u5230\u6700\u540e\uff0c\u6211\u4eec\u6709\u51e0\u4e2a\u7247\u5143\u5171\u4eab\u76f8\u540c\u7684\u6df1\u5ea6\uff0c\u5c3d\u7ba1\u5b83\u4eec\u7684\u8ddd\u79bb\u4e0d\u540c\u3002 \u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u589e\u52a0\u7247\u5143\u7740\u8272\u5668\u4e2d\u7684\u6df1\u5ea6\u6bd4\u8f83\u6765\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u4e00\u4e2a\u504f\u79fb\u3002 float bias = 0.05; if ( projCoords.z - bias < texture(shadowMap, projCoords.xy).r ) { // \u5f53\u524d\u7247\u5143\u4e0d\u5728\u9634\u5f71\u4e2d shadowFactor = 0; } \u73b0\u5728\uff0c\u9634\u5f71\u5931\u771f\u6d88\u5931\u4e86\u3002 \u8bd1\u8005\u6ce8\uff1a\u4f7f\u7528\u504f\u79fb\u6765\u6d88\u9664\u9634\u5f71\u5931\u771f\u53c8\u4f1a\u9020\u6210\u60ac\u6d6e\uff08Peter Panning\uff09\u95ee\u9898\uff0c\u53e6\u8bf7\u53c2\u9605 LearnOpenGL\u9634\u5f71\u6620\u5c04 \u4e00\u6587\u3002 \u73b0\u5728\u6211\u4eec\u8981\u89e3\u51b3\u7684\u662f\u53bb\u9634\u5f71\u8fb9\u7f18\u95ee\u9898\uff0c\u8fd9\u4e5f\u662f\u7531\u7eb9\u7406\u5206\u8fa8\u7387\u5f15\u8d77\u7684\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7247\u5143\u7684\u5750\u6807\u503c\u548c\u5468\u56f4\u7684\u503c\u5bf9\u6df1\u5ea6\u56fe\u8fdb\u884c\u91c7\u6837\u3002\u7136\u540e\u6211\u4eec\u5c06\u8ba1\u7b97\u5e73\u5747\u503c\u5e76\u5c06\u8be5\u503c\u6307\u5b9a\u4e3a\u9634\u5f71\u503c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5b83\u7684\u503c\u4e0d\u4f1a\u662f 0 \u548c 1 \u4f46\u53ef\u4ee5\u5728\u4e24\u8005\u95f4\u53d6\u503c\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u8fb9\u7f18\u3002 \u5728\u7eb9\u7406\u5750\u6807\u4e2d\uff0c\u5468\u56f4\u503c\u5fc5\u987b\u4e0e\u5f53\u524d\u7247\u5143\u4f4d\u7f6e\u4fdd\u6301\u4e00\u4e2a\u50cf\u7d20\u8ddd\u79bb\u3002\u6240\u4ee5\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\u4e2d\u4e00\u4e2a\u50cf\u7d20\u7684\u589e\u91cf\uff0c\u5b83\u7b49\u4e8e 1 / \u7eb9\u7406\u5927\u5c0f \u3002 \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u9634\u5f71\u94f6\u5b50\u7684\u8ba1\u7b97\u6765\u5f97\u5230\u4e00\u4e2a\u5e73\u5747\u503c\u3002 float shadowFactor = 0.0; vec2 inc = 1.0 / textureSize(shadowMap, 0); for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth = texture(shadowMap, projCoords.xy + vec2(row, col) * inc).r; shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; \u73b0\u5728\u7ed3\u679c\u770b\u8d77\u6765\u66f4\u5e73\u6ed1\u4e86\u3002 \u73b0\u5728\u6211\u4eec\u7684\u793a\u4f8b\u770b\u8d77\u6765\u597d\u591a\u4e86\u3002\u5c3d\u7ba1\u5982\u6b64\uff0c\u8fd9\u91cc\u4ecb\u7ecd\u7684\u9634\u5f71\u6620\u5c04\u6280\u672f\u4ecd\u6709\u5f88\u5927\u7684\u6539\u8fdb\u7a7a\u95f4\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u89e3\u51b3\u60ac\u6d6e\uff08Peter Panning\uff09\u6548\u679c\uff08\u56e0\u504f\u79fb\u5f15\u8d77\uff09\u548c\u5176\u4ed6\u6539\u8fdb\u9634\u5f71\u8fb9\u7f18\u7684\u8ba1\u7b97\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u6709\u4e86\u8fd9\u91cc\u6240\u8bb2\u89e3\u7684\u6982\u5ff5\uff0c\u4f60\u5c31\u6709\u4e86\u5f00\u59cb\u4fee\u6539\u793a\u4f8b\u7684\u826f\u597d\u57fa\u7840\u3002 \u4e3a\u4e86\u6e32\u67d3\u591a\u4e2a\u5149\u6e90\uff0c\u4f60\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u5149\u6e90\u6e32\u67d3\u4e00\u4e2a\u6df1\u5ea6\u56fe\u3002\u5728\u6e32\u67d3\u573a\u666f\u65f6\uff0c\u4f60\u9700\u8981\u91c7\u6837\u6240\u6709\u7684\u6df1\u5ea6\u56fe\u6765\u8ba1\u7b97\u5408\u9002\u7684\u9634\u5f71\u7cfb\u6570\u3002","title":"\u6539\u8fdb\u9634\u5f71\u6620\u5c04"},{"location":"19-animations/","text":"\u52a8\u753b\uff08Animations\uff09 \u5f15\u8a00 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u52a0\u8f7d\u4e86\u9759\u60013D\u6a21\u578b\uff0c\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4e3a\u5b83\u4eec\u8bbe\u7f6e\u52a8\u753b\u3002\u5728\u601d\u8003\u52a8\u753b\u65f6\uff0c\u9996\u5148\u60f3\u5230\u7684\u65b9\u6cd5\u662f\u4e3a\u6bcf\u4e2a\u6a21\u578b\u72b6\u6001\u521b\u5efa\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u5c06\u5b83\u4eec\u52a0\u8f7d\u5230GPU\u4e2d\uff0c\u7136\u540e\u6309\u987a\u5e8f\u7ed8\u5236\uff0c\u4ee5\u6b64\u9020\u6210\u52a8\u753b\u7684\u5047\u8c61\u3002\u867d\u7136\u8fd9\u79cd\u65b9\u6cd5\u5bf9\u4e8e\u67d0\u4e9b\u6e38\u620f\u6765\u8bf4\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u662f\u5b83\u7684\u6548\u7387\u4e0d\u662f\u5f88\u9ad8\uff08\u5c31\u5185\u5b58\u6d88\u8017\u6765\u8bf4\uff09\u3002 \u8fd9\u5c31\u662f\u9aa8\u9abc\u52a8\u753b\uff08Skeletal Animation\uff09\u7684\u7528\u6b66\u4e4b\u5730\u3002\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u6a21\u578b\u7684\u52a8\u753b\u65b9\u5f0f\u7531\u5176\u5e95\u5c42\u9aa8\u67b6\uff08Skeletal\uff09\u5b9a\u4e49\uff0c\u9aa8\u67b6\u662f\u7531\u88ab\u79f0\u4e3a\u5173\u8282\uff08Joints\uff09\u7684\u7279\u6b8a\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u5b9a\u4e49\u7684\uff0c\u8fd9\u4e9b\u5173\u8282\u53c8\u7531\u5b83\u4eec\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u6765\u5b9a\u4e49\u3002\u6211\u4eec\u4e5f\u8bf4\u8fc7\u8fd9\u662f\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u5173\u952e\u7684\u6700\u7ec8\u4f4d\u7f6e\u90fd\u6536\u5230\u5b83\u4eec\u7684\u7236\u5c42\u6b21\u7684\u5f71\u54cd\u3002\u4ee5\u624b\u8155\u4e3a\u4f8b\uff0c\u5982\u679c\u89d2\u8272\u79fb\u52a8\u8098\u90e8\u548c\u80a9\u8180\uff0c\u624b\u8155\u7684\u4f4d\u7f6e\u5c31\u4f1a\u53d1\u751f\u6539\u53d8\u3002 \u5173\u8282\u4e0d\u9700\u8981\u8868\u793a\u4e00\u4e2a\u5408\u4e4e\u73b0\u5b9e\u7684\u9aa8\u9abc\u6216\u5173\u8282\uff0c\u5b83\u4eec\u662f\u4eba\u5de5\u8bbe\u7f6e\u7684\uff0c\u5141\u8bb8\u521b\u4f5c\u8005\u5efa\u6a21\u52a8\u753b\u3002\u9664\u4e86\u5173\u8282\uff0c\u6211\u4eec\u8fd8\u6709\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u9876\u70b9\u662f\u6839\u636e\u4e0e\u4e4b\u76f8\u5173\u7684\u5173\u8282\u7684\u4f4d\u7f6e\u7ed8\u5236\u7684\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528MD5\u683c\u5f0f\u6765\u52a0\u8f7d\u6709\u52a8\u753b\u7684\u6a21\u578b\u3002MD5\u683c\u5f0f\u662f\u7531\u300a\u6bc1\u706d\u6218\u58eb\u300b\u7684\u5f00\u53d1\u5546ID Software\u5236\u5b9a\u7684\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u79cd\u57fa\u4e8e\u6587\u672c\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u6613\u4e8e\u7406\u89e3\u3002\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u4f7f\u7528 Collada \u683c\u5f0f\uff0c\u8fd9\u662f\u8bb8\u591a\u5de5\u5177\u652f\u6301\u7684\u516c\u5171\u6807\u51c6\u3002Collada\u662f\u4e00\u79cd\u57fa\u4e8eXML\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u4f46\u5b83\u7684\u7f3a\u70b9\u662f\u975e\u5e38\u590d\u6742\uff081.5\u7248\u672c\u7684\u89c4\u8303\u5c31\u6709500\u591a\u9875\uff09\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u575a\u6301\u4f7f\u7528\u4e00\u79cd\u66f4\u7b80\u5355\u7684\u683c\u5f0f\uff0cMD5\uff0c\u5b83\u4f7f\u6211\u4eec\u4e13\u6ce8\u4e8e\u9aa8\u9abc\u52a8\u753b\u7684\u6982\u5ff5\u5e76\u521b\u5efa\u4e00\u4e2a\u53ef\u5de5\u4f5c\u7684\u793a\u4f8b\u3002 \u4f60\u8fd8\u53ef\u4ee5\u901a\u8fc7\u5728\u4e92\u8054\u7f51\u4e0a\u627e\u5230 \u7279\u5b9a\u63d2\u4ef6 \u5c06\u4e00\u4e9b\u6a21\u578b\u4eceBlender\u5bfc\u51fa\u4e3aMD5\u683c\u5f0f\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u53c2\u8003\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u8d44\u6599\uff0c\u4f46\u662f\u6211\u53d1\u73b0\u6709\u4e24\u4e2a\u8d44\u6599\u53ef\u4ee5\u5f88\u597d\u5730\u89e3\u91ca\u5982\u4f55\u4f7f\u7528MD5\u6587\u4ef6\u521b\u5efa\u52a8\u753b\u6a21\u578b\u3002\u8fd9\u4e9b\u8d44\u6599\u7684\u6765\u6e90\u5982\u4e0b\uff1a http://www.3dgep.com/gpu-skinning-of-md5-models-in-opengl-and-cg/ http://ogldev.atspace.co.uk/www/tutorial38/tutorial38.html \u8ba9\u6211\u4eec\u4ece\u7f16\u5199\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5f00\u59cb\uff0cMD5\u683c\u5f0f\u5b9a\u4e49\u4e86\u4e24\u79cd\u7c7b\u578b\u7684\u6587\u4ef6\uff1a \u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b83\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u7f51\u683c\u96c6\u7684\u5173\u8282\u3001\u9876\u70b9\u548c\u7eb9\u7406\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5mesh \u7684\u6269\u5c55\u540d\u3002 \u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b9a\u4e49\u53ef\u4f7f\u7528\u4e8e\u6a21\u578b\u7684\u52a8\u753b\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5anim \u7684\u6269\u5c55\u540d\u3002 MD5\u6587\u4ef6\u7531\u5934\uff08Header\uff09\u548c\u5927\u62ec\u53f7\u4e4b\u95f4\u5305\u542b\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u67e5\u770b\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u3002\u5728\u53c2\u8003\u8d44\u6599\u6587\u4ef6\u5939\u4e2d\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u79cdMD5\u683c\u5f0f\u7684\u6a21\u578b\u3002\u5982\u679c\u4f60\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u6784\u3002 \u5728\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e2d\u53ef\u4ee5\u770b\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u5728\u4e0b\u8ff0\u63d0\u4f9b\u7684\u793a\u4f8b\u4e2d\uff0c\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numJoints 33 numMeshes 6 \u5934\u5b9a\u4e49\u4e86\u5982\u4e0b\u5c5e\u6027\uff1a \u5b83\u6240\u9075\u5faa\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\uff08\u4ece3D\u5efa\u6a21\u5de5\u5177\uff09\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\u3002 \u5728\u5173\u8282\u90e8\u5206\u5b9a\u4e49\u7684\u5173\u8282\u6570\u3002 \u7f51\u683c\u6570\uff08\u9700\u8981\u7684\u7f51\u683c\u8282\u6570\uff09\u3002 \u5173\u952e\u90e8\u5206\u5b9a\u4e49\u5173\u8282\u7684\u540d\u79f0\u3001\u72b6\u6001\u3001\u4f4d\u7f6e\u53ca\u5176\u5173\u7cfb\u3002\u4e0b\u9762\u5c55\u793a\u4e86\u4e00\u4e2a\u793a\u4f8b\u6a21\u578b\u7684\u5173\u8282\u90e8\u5206\u7684\u7247\u6bb5\uff1a joints { \"origin\" -1 ( -0.000000 0.016430 -0.006044 ) ( 0.707107 0.000000 0.707107 ) // \"sheath\" 0 ( 11.004813 -3.177138 31.702473 ) ( 0.307041 -0.578614 0.354181 ) // origin \"sword\" 1 ( 9.809593 -9.361549 40.753730 ) ( 0.305557 -0.578155 0.353505 ) // sheath \"pubis\" 0 ( 0.014076 2.064442 26.144581 ) ( -0.466932 -0.531013 -0.466932 ) // origin \u2026\u2026 } \u5173\u8282\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\u79f0\uff0c\u5f15\u53f7\u4e2d\u7684\u6587\u672c\u5c5e\u6027\u3002 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u7236\u5173\u8282\u5728\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u5173\u8282\u7b49\u4e8e-1\u3002 \u5173\u8282\u4f4d\u7f6e\uff0c\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u3002 \u5173\u8282\u65b9\u5411\uff0c\u4e5f\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\uff0c\u65b9\u5411\u5b9e\u9645\u4e0a\u662f\u4e00\u4e2a\u56db\u5143\u6570\uff0c\u4f46\u5176w\u5206\u91cf\u4e0d\u5305\u62ec\u5728\u6b64\u3002 \u5728\u7ee7\u7eed\u89e3\u91ca\u6587\u4ef6\u7684\u5176\u4f59\u90e8\u5206\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u6765\u8c08\u8c08\u56db\u5143\u6570\uff08Quaternions\uff09\u3002\u56db\u5143\u6570\u662f\u7528\u4e8e\u8868\u793a\u65cb\u8f6c\u7684\u56db\u4e2a\u6784\u6210\u5143\u7d20\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e00\u76f4\u5728\u4f7f\u7528\u6b27\u62c9\u89d2\uff08\u504f\u822a\u3001\u4fef\u4ef0\u548c\u6eda\u8f6c\uff09\u6765\u5b9a\u4e49\u65cb\u8f6c\uff0c\u8fd9\u57fa\u672c\u4e0a\u5b9a\u4e49\u4e86\u56f4\u7ed5x\u3001y\u548cz\u53eb\u7684\u65cb\u8f6c\u3002\u4f46\u662f\uff0c\u6b27\u62c9\u89d2\u5728\u5904\u7406\u65cb\u8f6c\u65f6\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\uff0c\u7279\u522b\u662f\u4f60\u5fc5\u987b\u77e5\u9053\u6b63\u786e\u7684\u65cb\u8f6c\u987a\u5e8f\uff0c\u5e76\u4e14\u4e00\u4e9b\u64cd\u4f5c\u4f1a\u53d8\u5f97\u975e\u5e38\u590d\u6742\u3002 \u56db\u5143\u6570\u6709\u52a9\u4e8e\u89e3\u51b3\u8fd9\u79cd\u590d\u6742\u60c5\u51b5\u3002\u6b63\u5982\u4e4b\u524d\u6240\u8bf4\uff0c\u56db\u5143\u6570\u88ab\u5b9a\u4e49\u4e3a4\u4e2a\u6570\u5b57\uff08x\uff0cy\uff0cz\uff0cw\uff09\u4e00\u7ec4\u3002\u56db\u5143\u6570\u5b9a\u4e49\u65cb\u8f6c\u8f74\u548c\u56f4\u7ed5\u8be5\u8f74\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u4f60\u53ef\u4ee5\u5728\u7f51\u7edc\u4e2d\u786e\u8ba4\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b66\u5b9a\u4e49\uff0c\u4f46\u597d\u6d88\u606f\u662f\u6211\u4eec\u4f7f\u7528\u7684\u6570\u5b66\u5e93JOML\u4e3a\u5176\u63d0\u4f9b\u4e86\u652f\u6301\u3002\u6211\u4eec\u53ef\u4ee5\u57fa\u4e8e\u56db\u5143\u6570\u6784\u9020\u65cb\u8f6c\u77e9\u9635\uff0c\u5e76\u7528\u5b83\u4eec\u5bf9\u5411\u91cf\u8fdb\u884c\u53d8\u6362\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u5173\u8282\u7684\u5b9a\u4e49\uff0c\u5176\u7f3a\u5c11 w \u5143\u7d20\uff0c\u4f46\u53ef\u4ee5\u5728\u5176\u4ed6\u503c\u7684\u5e2e\u52a9\u4e0b\u8f7b\u677e\u5730\u8ba1\u7b97\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u770b\u770b\u8fd9\u662f\u5982\u4f55\u505a\u5230\u7684\u3002 \u5728\u5173\u8282\u5b9a\u4e49\u4e4b\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u7ec4\u6210\u6a21\u578b\u7684\u4e0d\u540c\u7f51\u683c\u7684\u5b9a\u4e49\u3002\u63a5\u4e0b\u6765\u4f60\u53ef\u4ee5\u4ece\u5176\u4e2d\u4e00\u4e2a\u793a\u4f8b\u4e2d\u770b\u5230\u7f51\u683c\u5b9a\u4e49\u7684\u7247\u6bb5\uff1a mesh { shader \"/textures/bob/guard1_body.png\" numverts 494 vert 0 ( 0.394531 0.513672 ) 0 1 vert 1 ( 0.447266 0.449219 ) 1 2 ... vert 493 ( 0.683594 0.455078 ) 864 3 numtris 628 tri 0 0 2 1 tri 1 0 1 3 ... tri 627 471 479 493 numweights 867 weight 0 5 1.000000 ( 6.175774 8.105262 -0.023020 ) weight 1 5 0.500000 ( 4.880173 12.805251 4.196980 ) ... weight 866 6 0.333333 ( 1.266308 -0.302701 8.949338 ) } \u8ba9\u6211\u4eec\u770b\u770b\u4e0a\u8ff0\u5c55\u73b0\u7684\u7ed3\u6784\uff1a \u7f51\u683c\u4ece\u5b9a\u4e49\u7eb9\u7406\u6587\u4ef6\u5f00\u59cb\u3002\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5728\u6b64\u5904\u627e\u5230\u7684\u8def\u5f84\u662f\u521b\u5efa\u8be5\u6a21\u578b\u7684\u5de5\u5177\u6240\u4f7f\u7528\u7684\u8def\u5f84\u3002\u8be5\u8def\u5f84\u53ef\u80fd\u4e0e\u7528\u4e8e\u52a0\u8f7d\u8fd9\u4e9b\u6587\u4ef6\u7684\u8def\u5f84\u4e0d\u5339\u914d\u3002\u8fd9\u91cc\u6709\u4e24\u79cd\u65b9\u6cd5\u89e3\u51b3\uff0c\u8981\u4e48\u52a8\u6001\u4fee\u6539\u57fa\u672c\u8def\u5f84\uff0c\u8981\u4e48\u624b\u52a8\u4fee\u6539\u8be5\u8def\u5f84\u3002\u6211\u9009\u62e9\u4e86\u540e\u8005\uff0c\u6bd4\u8f83\u7b80\u5355\u7684\u4e00\u79cd\u3002 \u63a5\u4e0b\u6765\u53ef\u4ee5\u627e\u5230\u9876\u70b9\u5b9a\u4e49\u3002\u9876\u70b9\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u9876\u70b9\u7d22\u5f15\u3002 \u7eb9\u7406\u5750\u6807\u3002 \u5f71\u54cd\u6b64\u9876\u70b9\u7684\u7b2c\u4e00\u4e2a\u6743\u91cd\u5b9a\u4e49\u7684\u7d22\u5f15\u3002 \u8981\u8003\u8651\u7684\u6743\u91cd\u6570\u3002 \u5728\u9876\u70b9\u4e4b\u540e\uff0c\u5c06\u5b9a\u4e49\u6784\u6210\u6b64\u7f51\u683c\u7684\u4e09\u89d2\u5f62\u3002\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e86\u4f7f\u7528\u9876\u70b9\u7d22\u5f15\u7ec4\u7ec7\u9876\u70b9\u7684\u65b9\u5f0f\u3002 \u6700\u540e\uff0c\u5b9a\u4e49\u4e86\u6743\u91cd\u3002\u6743\u91cd\u5b9a\u4e49\u7531\u4ee5\u4e0b\u90e8\u5206\u7ec4\u6210\uff1a \u6743\u91cd\u6307\u6570\u3002 \u5173\u8282\u6307\u6570\uff0c\u6307\u4e0e\u8be5\u6743\u91cd\u76f8\u5173\u7684\u5173\u8282 \u504f\u501a\u7cfb\u6570\uff0c\u7528\u4e8e\u8c03\u8282\u8be5\u6743\u91cd\u7684\u5f71\u54cd\u3002 \u8be5\u6743\u91cd\u7684\u4f4d\u7f6e\u3002 \u4e0b\u56fe\u7528\u793a\u4f8b\u6570\u636e\u8bf4\u660e\u4e86\u4e0a\u8ff0\u7ec4\u5206\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u597d\u4e86\uff0c\u73b0\u5728\u4e86\u89e3\u4e86\u7f51\u683c\u6a21\u578b\u6587\u4ef6\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u6790\u5b83\u4e86\u3002\u5982\u679c\u4f60\u770b\u4e86\u6e90\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5df2\u7ecf\u521b\u5efa\u4e86\u65b0\u7684\u5305\u6765\u5bb9\u7eb3\u6a21\u578b\u683c\u5f0f\u7684\u89e3\u6790\u5668\u3002\u5728 org.lwjglb.engine.loaders.obj \u5305\u4e0b\u6709\u4e00\u4e2a\u89e3\u6790OBJ\u6587\u4ef6\u7684\u4ee3\u7801\uff0c\u800c\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5728 org.lwjglb.engine.loaders.md5 \u5305\u4e0b\u3002 \u6240\u6709\u7684\u89e3\u6790\u4ee3\u7801\u90fd\u57fa\u4e8e\u6b63\u5219\u8868\u8fbe\u5f0f\u4eceMD5\u6587\u672c\u6587\u4ef6\u4e2d\u63d0\u53d6\u4fe1\u606f\u3002\u89e3\u6790\u5668\u5c06\u521b\u5efa\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\u5bf9\u8c61\uff0c\u4ee5\u6a21\u62dfMD5\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u4fe1\u606f\u7ec4\u4ef6\u7684\u7ed3\u6784\u3002\u5b83\u53ef\u80fd\u4e0d\u662f\u4e16\u754c\u4e0a\u6700\u9ad8\u6548\u7684\u89e3\u6790\u5668\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5c06\u6709\u52a9\u4e8e\u66f4\u597d\u5730\u7406\u89e3\u8fd9\u4e2a\u8fc7\u7a0b\u3002 \u89e3\u6790MD5\u6a21\u578b\u6587\u4ef6\u7684\u8d77\u59cb\u7c7b\u662f MD5Model \u7c7b\uff0c\u8be5\u7c7b\u5728\u5176\u89e3\u6790\u65b9\u6cd5\u4e2d\u4f5c\u4e3a\u53c2\u6570\u88ab\u63a5\u6536\u3002MD5\u6587\u4ef6\u7684\u5185\u5bb9\u662f\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u5934\u3001\u8282\u70b9\u5217\u8868\u548c\u6240\u6709\u5b50\u5143\u7d20\u7684\u7f51\u683c\u5217\u8868\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6240\u4ee5\u4e0d\u5305\u542b\u5728\u672c\u6587\u4e2d\u4e86\u3002 \u5173\u4e8e\u89e3\u6790\u4ee3\u7801\u7684\u4e00\u4e9b\u6ce8\u91ca\uff1a \u7f51\u683c\u7684\u5b50\u5143\u7d20\u88ab\u5b9a\u4e49\u4e3a MD5Mesh \u7c7b\u7684\u5185\u90e8\u7c7b\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u5728 MD5Utils \u7c7b\u7684 calculateQuaternion \u65b9\u6cd5\u4e2d\u8ba1\u7b97\u5173\u8282\u65b9\u5411\u7684\u7b2c\u56db\u4e2a\u5206\u91cf\u3002 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u89e3\u6790\u4e86\u4e00\u4e2a\u6587\u4ef6\uff0c\u6211\u4eec\u5fc5\u987b\u8bb2\u8fd9\u4e2a\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u6e38\u620f\u5f15\u64ce\u5904\u7406\u7684\u4e1c\u897f\uff0c\u6211\u4eec\u5fc5\u987b\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MD5Loader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u4f7f\u7528\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u6765\u6784\u9020\u4e00\u4e2a GameItem \u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5982\u4f60\u6240\u6ce8\u610f\u5230\u7684\uff0cMD5\u6a21\u578b\u6709\u597d\u51e0\u4e2a\u7f51\u683c\uff0c\u4f46\u6211\u4eec\u7684 GameItem \u7c7b\u53ea\u652f\u6301\u5355\u4e2a\u7f51\u683c\u3002\u6240\u4ee5\u9996\u5148\u6211\u4eec\u8981\u4fee\u6539\u5b83\uff0c GameItem \u7c7b\u73b0\u5728\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private Mesh[] meshes; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem() { position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public GameItem(Mesh mesh) { this(); this.meshes = new Mesh[]{mesh}; } public GameItem(Mesh[] meshes) { this(); this.meshes = meshes; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return meshes[0]; } public Mesh[] getMeshes() { return meshes; } public void setMeshes(Mesh[] meshes) { this.meshes = meshes; } public void setMesh(Mesh mesh) { if (this.meshes != null) { for (Mesh currMesh : meshes) { currMesh.cleanUp(); } } this.meshes = new Mesh[]{mesh}; } } \u901a\u8fc7\u4e0a\u8ff0\u4fee\u6539\uff0c\u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7f16\u5199 MD5Loader \u7c7b\u7684\u5185\u5bb9\u3002\u8be5\u7c7b\u5c06\u6709\u4e00\u4e2a\u540d\u4e3a process \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u53d7\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u548c\u4e00\u4e2a\u9ed8\u8ba4\u989c\u8272\uff08\u5bf9\u4e8e\u4e0d\u5b9a\u4e49\u7eb9\u7406\u7684\u7f51\u683c\uff09\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u8be5\u65b9\u6cd5\u7684\u65b9\u6cd5\u4f53\u5982\u4e0b\uff1a public static GameItem process(MD5Model md5Model, Vector4f defaultColour) throws Exception { List<MD5Mesh> md5MeshList = md5Model.getMeshes(); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh, defaultColour); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); GameItem gameItem = new GameItem(meshes); return gameItem; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b9a\u4e49\u5728 MD5Model \u7c7b\u4e4b\u5185\u7684\u7f51\u683c\u8fdb\u884c\u904d\u5386\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528 generateMesh \u65b9\u6cd5\uff0c\u5c06\u5176\u8f6c\u6362\u4e3a org.lwjglb.engine.graph.Mesh \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u67e5\u770b\u8be5\u65b9\u6cd5\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u4e3a\u6211\u4eec\u6784\u5efa\u5750\u6807\u548c\u6cd5\u7ebf\u6570\u7ec4\u3002 private static class VertexInfo { public Vector3f position; public Vector3f normal; public VertexInfo(Vector3f position) { this.position = position; normal = new Vector3f(0, 0, 0); } public VertexInfo() { position = new Vector3f(); normal = new Vector3f(); } public static float[] toPositionsArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.position.x; result[i + 1] = v.position.y; result[i + 2] = v.position.z; i += 3; } return result; } public static float[] toNormalArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.normal.x; result[i + 1] = v.normal.y; result[i + 2] = v.normal.z; i += 3; } return result; } } \u56de\u5230 generateMesh \u65b9\u6cd5\uff0c\u9996\u5148\u6211\u4eec\u5f97\u5230\u5173\u8282\u7684\u7f51\u683c\u9876\u70b9\u4fe1\u606f\u3001\u6743\u91cd\u548c\u7ed3\u6784\u3002 private static Mesh generateMesh(MD5Model md5Model, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { List<VertexInfo> vertexInfoList = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); List<Integer> indices = new ArrayList<>(); List<MD5Mesh.MD5Vertex> vertices = md5Mesh.getVertices(); List<MD5Mesh.MD5Weight> weights = md5Mesh.getWeights(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); \u63a5\u4e0b\u6765\u6211\u4eec\u9700\u8981\u6839\u636e\u5305\u542b\u5728\u6743\u91cd\u548c\u5173\u8282\u4e2d\u7684\u4fe1\u606f\u6765\u8ba1\u7b97\u9876\u70b9\u4f4d\u7f6e\u3002\u8fd9\u662f\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\u7684\uff1a for (MD5Mesh.MD5Vertex vertex : vertices) { Vector3f vertexPos = new Vector3f(); Vector2f vertexTextCoords = vertex.getTextCoords(); textCoords.add(vertexTextCoords.x); textCoords.add(vertexTextCoords.y); int startWeight = vertex.getStartWeight(); int numWeights = vertex.getWeightCount(); for (int i = startWeight; i < startWeight + numWeights; i++) { MD5Mesh.MD5Weight weight = weights.get(i); MD5JointInfo.MD5JointData joint = joints.get(weight.getJointIndex()); Vector3f rotatedPos = new Vector3f(weight.getPosition()).rotate(joint.getOrientation()); Vector3f acumPos = new Vector3f(joint.getPosition()).add(rotatedPos); acumPos.mul(weight.getBias()); vertexPos.add(acumPos); } vertexInfoList.add(new VertexInfo(vertexPos)); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5728\u8fd9\u91cc\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u904d\u5386\u4e86\u9876\u70b9\u4fe1\u606f\u5e76\u5c06\u7eb9\u7406\u5750\u6807\u50a8\u5b58\u5728\u5217\u8868\u4e2d\uff0c\u4e0d\u9700\u8981\u5728\u8fd9\u91cc\u5e94\u7528\u4efb\u4f55\u53d8\u6362\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230\u4e86\u8ba1\u7b97\u9876\u70b9\u5750\u6807\u6240\u9700\u8003\u8651\u7684\u8d77\u59cb\u6743\u91cd\u548c\u603b\u6743\u91cd\u3002 \u9876\u70b9\u5750\u6807\u662f\u901a\u8fc7\u4f7f\u7528\u6240\u6709\u4e0e\u4e4b\u76f8\u5173\u7684\u6743\u91cd\u6765\u8ba1\u7b97\u7684\u3002\u6bcf\u4e2a\u6743\u91cd\u90fd\u6709\u4e00\u4e2a\u5750\u6807\u548c\u4e00\u4e2a\u504f\u501a\u3002\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u6240\u6709\u504f\u501a\u4e4b\u548c\u5fc5\u987b\u4e3a1.0\u3002\u6bcf\u4e2a\u6743\u91cd\u4e5f\u6709\u4e00\u4e2a\u5728\u5173\u8282\u7684\u5c40\u90e8\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5173\u8282\u7684\u65b9\u5411\u548c\u5750\u6807\uff08\u5c31\u50cf\u5b83\u662f\u4e00\u4e2a\u8f6c\u6362\u77e9\u9635\u90a3\u6837\uff09\u5c06\u5176\u8f6c\u6362\u4e3a\u5b83\u6240\u5f15\u7528\u7684\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u3002 \u7efc\u4e0a\u6240\u8ff0\uff0c\u9876\u70b9\u5750\u6807\u53ef\u4ee5\u7528\u5982\u4e0b\u516c\u5f0f\u8868\u793a\uff1a Vpos = \\sum\\limits_{i=ws}^{ws + wc} (Jt_{i} \\times Wp_{i}) \\dot Wb_{i} \u53c2\u6570\uff1a \u4ece ws \uff08\u8d77\u59cb\u6743\u91cd\uff09\u5230 wc \uff08\u6743\u91cd\u6570\uff09\u6743\u91cd\u603b\u548c\u3002 Jt_{i} \u662f\u4e0e\u6743\u91cd W_{i} \u76f8\u5173\u7684\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Wp_{i} \u662f\u6743\u91cd\u5750\u6807\u3002 Wb_{i} \u662f\u6743\u91cd\u504f\u501a\u3002 \u8be5\u65b9\u7a0b\u662f\u5728\u5faa\u73af\u4f53\u4e2d\u5b9e\u73b0\u7684\uff08\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u77e9\u9635\uff0c\u4f46\u7ed3\u679c\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u6709\u5355\u72ec\u7684\u5173\u8282\u5750\u6807\u548c\u65cb\u8f6c\uff09\u3002 \u4f7f\u7528\u4e0a\u8ff0\u4ee3\u7801\uff0c\u6211\u4eec\u5c31\u80fd\u591f\u6784\u9020\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u6570\u636e\uff0c\u4f46\u662f\u4ecd\u7136\u9700\u8981\u5efa\u7acb\u7d22\u5f15\u548c\u6cd5\u7ebf\u3002\u7d22\u5f15\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e09\u89d2\u5f62\u7684\u4fe1\u606f\u8ba1\u7b97\uff0c\u53ea\u9700\u904d\u5386\u5305\u542b\u8fd9\u4e9b\u4e09\u89d2\u5f62\u7684\u5217\u8868\u5373\u53ef\u3002 \u6cd5\u7ebf\u4e5f\u53ef\u4ee5\u7528\u4e09\u89d2\u5f62\u4fe1\u606f\u6765\u8ba1\u7b97\uff0c\u4ee4 V_{0} \u3001 V_{1} \u548c V_{2} \u4e3a\u4e09\u89d2\u5f62\u9876\u70b9\uff08\u5728\u7269\u4f53\u7684\u6a21\u578b\u7a7a\u95f4\u4e2d\uff09\u3002\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u53ef\u4ee5\u6839\u636e\u5982\u4e0b\u516c\u5f0f\u8ba1\u7b97\uff1a N=(V_{2}-V_{0})\\times(V_{1}-V_{0}) \u5176\u4e2dN\u5e94\u8be5\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u662f\u4e0a\u8ff0\u516c\u5f0f\u7684\u51e0\u4f55\u89e3\u91ca\uff1a \u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u901a\u8fc7\u5b83\u6240\u5c5e\u7684\u4e09\u89d2\u5f62\u7684\u6240\u6709\u6cd5\u7ebf\u7684\u5f52\u4e00\u5316\u4e4b\u548c\u6765\u8ba1\u7b97\u5b83\u7684\u6cd5\u7ebf\u3002\u8fdb\u884c\u8ba1\u7b97\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a for (MD5Mesh.MD5Triangle tri : md5Mesh.getTriangles()) { indices.add(tri.getVertex0()); indices.add(tri.getVertex1()); indices.add(tri.getVertex2()); // \u6cd5\u7ebf VertexInfo v0 = vertexInfoList.get(tri.getVertex0()); VertexInfo v1 = vertexInfoList.get(tri.getVertex1()); VertexInfo v2 = vertexInfoList.get(tri.getVertex2()); Vector3f pos0 = v0.position; Vector3f pos1 = v1.position; Vector3f pos2 = v2.position; Vector3f normal = (new Vector3f(pos2).sub(pos0)).cross(new Vector3f(pos1).sub(pos0)); v0.normal.add(normal); v1.normal.add(normal); v2.normal.add(normal); } // \u4e00\u65e6\u5b8c\u6210\u4e86\u8ba1\u7b97\uff0c\u5c31\u5c06\u7ed3\u679c\u5f52\u4e00\u5316 for(VertexInfo v : vertexInfoList) { v.normal.normalize(); } \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5217\u8868\u8f6c\u6362\u4e3a\u6570\u7ec4\u5e76\u5904\u7406\u7eb9\u7406\u4fe1\u606f\u3002 float[] positionsArr = VertexInfo.toPositionsArr(vertexInfoList); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = VertexInfo.toNormalArr(vertexInfoList); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); Mesh mesh = new Mesh(positionsArr, textCoordsArr, normalsArr, indicesArr); return mesh; } \u56de\u5230 process \u65b9\u6cd5\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6709\u4e2a\u540d\u4e3a handleTexture \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u52a0\u8f7d\u7eb9\u7406\u3002\u8fd9\u5c31\u662f\u8be5\u65b9\u6cd5\u7684\u5b9a\u4e49\uff1a private static void handleTexture(Mesh mesh, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { String texturePath = md5Mesh.getTexture(); if (texturePath != null && texturePath.length() > 0) { Texture texture = new Texture(texturePath); Material material = new Material(texture); // \u5904\u7406\u6cd5\u7ebf\u56fe int pos = texturePath.lastIndexOf(\".\"); if (pos > 0) { String basePath = texturePath.substring(0, pos); String extension = texturePath.substring(pos, texturePath.length()); String normalMapFileName = basePath + NORMAL_FILE_SUFFIX + extension; if (Utils.existsResourceFile(normalMapFileName)) { Texture normalMap = new Texture(normalMapFileName); material.setNormalMap(normalMap); } } mesh.setMaterial(material); } else { mesh.setMaterial(new Material(defaultColour, 1)); } } \u975e\u5e38\u76f4\u63a5\u7684\u5b9e\u73b0\u3002\u552f\u4e00\u7684\u72ec\u7279\u4e4b\u5904\u5728\u4e8e\u5982\u679c\u4e00\u4e2a\u7f51\u683c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a\u201ctexture.png\u201d\u7684\u7eb9\u7406\uff0c\u5b83\u7684\u6cd5\u7ebf\u7eb9\u7406\u56fe\u5c06\u5728\u6587\u4ef6\u201ctexture_normal.png\u201d\u4e2d\u5b9a\u4e49\u3002\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8be5\u6587\u4ef6\u662f\u5426\u5b58\u5728\u5e76\u76f8\u5e94\u5730\u52a0\u8f7d\u5b83\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u52a0\u8f7d\u4e00\u4e2aMD5\u6587\u4ef6\u5e76\u50cf\u6e32\u67d3\u5176\u4ed6\u6e38\u620f\u9879\u4e00\u6837\u6e32\u67d3\u5b83\uff0c\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u7981\u7528\u9762\u5254\u9664\u6765\u6b63\u786e\u6e32\u67d3\u5b83\uff0c\u56e0\u4e3a\u4e0d\u662f\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5c06\u7ed8\u5236\u5728\u6b63\u786e\u7684\u65b9\u5411\u4e0a\u3002\u6211\u4eec\u5c06\u5411 Window \u7c7b\u6dfb\u52a0\u652f\u6301\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff08\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5176\u53d8\u66f4\uff09\u3002 \u5982\u679c\u52a0\u8f7d\u4e00\u4e9b\u5b9e\u4f8b\u6a21\u578b\uff0c\u5c31\u4f1a\u5f97\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u679c\uff1a \u4f60\u5728\u6b64\u5904\u770b\u5230\u7684\u662f\u7ed1\u5b9a\u7684\u59ff\u52bf\uff0c\u5b83\u662fMD5\u6a21\u578b\u7684\u9759\u6001\u5c55\u793a\uff0c\u4f7f\u52a8\u753b\u5e08\u8f7b\u677e\u5730\u5bf9\u5b83\u4eec\u5efa\u6a21\u3002\u4e3a\u4e86\u8ba9\u52a8\u753b\u5de5\u4f5c\uff0c\u6211\u4eec\u5fc5\u987b\u5904\u7406\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u3002 \u6a21\u578b\u52a8\u753b MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff0c\u5c31\u50cf\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u90a3\u6837\uff0c\u7531\u4e00\u4e2a\u5934\u548c\u4e00\u4e2a\u5305\u542b\u5728\u5927\u62ec\u53f7\u4e4b\u95f4\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u5982\u679c\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\u6587\u4ef6\uff0c\u53ef\u4ee5\u770b\u5230\u7c7b\u4f3c\u7684\u7ed3\u6784\u3002 \u53ef\u4ee5\u5728\u52a8\u753b\u6587\u4ef6\u4e2d\u627e\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\uff08\u5c31\u50cf\u662f\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e00\u6837\uff09\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u4ece\u63a5\u4e0b\u6765\u63d0\u4f9b\u7684\u4e00\u4e2a\u4f8b\u5b50\u4e2d\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numFrames 140 numJoints 33 frameRate 24 numAnimatedComponents 198 \u5934\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u6240\u7b26\u5408\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\uff08\u6765\u81ea3D\u5efa\u6a21\u5de5\u5177\uff09 \u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u5e27\u6570\u3002 \u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u6570\u91cf\u3002 \u5e27\u901f\u7387\uff0c\u6bcf\u79d2\u5e27\u6570\uff0c\u7528\u4e8e\u521b\u5efa\u52a8\u753b\u3002\u8fd9\u4e2a\u53c2\u6570\u53ef\u4ee5\u7528\u6765\u8ba1\u7b97\u5e27\u4e0e\u5e27\u4e4b\u95f4\u7684\u65f6\u95f4\u3002 \u6bcf\u4e2a\u5e27\u5b9a\u4e49\u7684\u5206\u91cf\u6570\u91cf\u3002\uff08\u8bd1\u6ce8\uff1a\u901a\u5e38\u60c5\u51b5\u4e0b\u7b49\u4e8e\u5173\u8282\u6570\u4e58\u4ee5\u516d\uff09 \u9996\u5148\u51fa\u73b0\u7684\u662f\u5c42\u6b21\u7ed3\u6784\uff08Hierarchy\uff09\u90e8\u5206\uff0c\u5b83\u5b9a\u4e49\u4e86\u8be5\u52a8\u753b\u7684\u5173\u8282\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4ee5\u4e0b\u7247\u6bb5\uff1a hierarchy { \"origin\" -1 0 0 // \"body\" 0 63 0 // origin ( Tx Ty Tz Qx Qy Qz ) \"body2\" 1 0 0 // body \"SPINNER\" 2 56 6 // body2 ( Qx Qy Qz ) .... } \u4e00\u4e2a\u5173\u8282\uff0c\u5728\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\uff0c\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\uff0c\u5f15\u53f7\u4e4b\u95f4\u7684\u4e00\u4e2a\u6587\u672c\u5c5e\u6027 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u4e00\u4e2a\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u5176\u5728\u5173\u8282\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u8282\u70b9\u7b49\u4e8e-1\u3002 \u5173\u8282\u6807\u5fd7\uff0c\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\uff0c\u8bbe\u7f6e\u8be5\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u5c06\u5982\u4f55\u6539\u53d8\u3002 \u8d77\u59cb\u7d22\u5f15\uff0c\u5f53\u5e94\u7528\u6807\u5fd7\u65f6\uff0c\u7528\u4e8e\u6bcf\u5e27\u7684\u52a8\u753b\u6570\u636e\u5185\u3002 \u4e0b\u4e00\u8282\u662f\u8fb9\u754c\uff08Bounds\uff09\u3002\u672c\u8282\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u6a21\u578b\u7684\u8fb9\u754c\u6846\u3002\u5b83\u5c06\u4e3a\u6bcf\u4e00\u5e27\u52a8\u753b\u50a8\u5b58\u4e00\u884c\u6570\u636e\uff0c\u770b\u8d77\u6765\u5c31\u50cf\u662f\u8fd9\u6837\uff1a bounds { ( -24.3102264404 -44.2608566284 -0.181215778 ) ( 31.0861988068 38.7131576538 117.7417449951 ) ( -24.3102283478 -44.1887664795 -0.1794649214 ) ( 31.1800289154 38.7173080444 117.7729110718 ) ( -24.3102359772 -44.1144447327 -0.1794776917 ) ( 31.2042789459 38.7091217041 117.8352737427 ) .... } \u6bcf\u4e2a\u8fb9\u754c\u6846\u7531\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u4e24\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5c0f\u503c\uff0c\u7b2c\u4e8c\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5927\u503c\u3002 \u4e0b\u4e00\u8282\u662f\u57fa\u672c\u5e27\uff08Base Frame\uff09\u6570\u636e\u3002\u5728\u672c\u8282\u4e2d\uff0c\u5728\u5e94\u7528\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u5f62\u53d8\u4e4b\u524d\uff0c\u8bbe\u7f6e\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4e0b\u9762\u7684\u7247\u6bb5\uff1a baseframe { ( 0 0 0 ) ( -0.5 -0.5 -0.5 ) ( -0.8947336078 70.7142486572 -6.5027675629 ) ( -0.3258574307 -0.0083037354 0.0313780755 ) ( 0.0000001462 0.0539700091 -0.0137935728 ) ( 0 0 0 ) .... } \u6bcf\u4e00\u884c\u90fd\u4e0e\u4e00\u4e2a\u5173\u8282\u76f8\u5173\u8054\uff0c\u5e76\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u5173\u8282\u7684\u5750\u6807\uff0c\u662f\u4e00\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u3002 \u5173\u8282\u7684\u65b9\u5411\uff0c\u662f\u4e00\u4e2a\u56db\u5143\u6570\u7684\u4e09\u4e2a\u5206\u91cf\uff08\u6b63\u5982\u6a21\u578b\u6587\u4ef6\u91cc\u7684\u90a3\u6837\uff09\u3002 \u5728\u6b64\u4e4b\u540e\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u4e2a\u5e27\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5206\u914d\u7ed9 numFrames \u5934\u5c5e\u6027\u7684\u503c\u3002\u6bcf\u4e2a\u5e27\u7684\u8282\u5c31\u50cf\u662f\u4e00\u4e2a\u5de8\u5927\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u5f53\u5bf9\u6bcf\u4e2a\u5e27\u5e94\u7528\u53d8\u6362\u65f6\uff0c\u8282\u70b9\u5c06\u4f7f\u7528\u8fd9\u4e2a\u6d6e\u70b9\u6570\u7ec4\u3002\u4f60\u53ef\u4ee5\u5728\u63a5\u4e0b\u6765\u770b\u5230\u4e00\u4e2a\u7247\u6bb5\uff1a frame 1 { -0.9279100895 70.682762146 -6.3709330559 -0.3259022534 -0.0100501738 0.0320306309 0.3259022534 0.0100501738 -0.0320306309 -0.1038384438 -0.1639953405 -0.0152553488 0.0299418624 .... } \u89e3\u6790MD5\u52a8\u753b\u6587\u4ef6\u7684\u57fa\u7c7b\u540d\u4e3a MD5AnimModel \u3002\u8be5\u7c7b\u521b\u5efa\u7531\u8be5\u6587\u4ef6\u5185\u5bb9\u6620\u5c04\u7684\u6240\u6709\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4ee5\u83b7\u5f97\u8be6\u7ec6\u4fe1\u606f\u3002\u7ed3\u6784\u7c7b\u4f3c\u4e8eMD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u3002\u73b0\u5728\u6211\u4eec\u80fd\u591f\u52a0\u8f7d\u8fd9\u4e9b\u6570\u636e\uff0c\u5e76\u5c06\u4f7f\u7528\u5b83\u6765\u751f\u6210\u52a8\u753b\u3002 \u6211\u4eec\u5c06\u5728\u7740\u8272\u5668\u4e2d\u751f\u6210\u52a8\u753b\uff0c\u6240\u4ee5\u4e0d\u662f\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6240\u6709\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u51c6\u5907\u6240\u9700\u7684\u6570\u636e\uff0c\u8fd9\u6837\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\u4e2d\u7684 process \u65b9\u6cd5\uff0c\u9700\u8981\u4fee\u6539\u5b83\u4ee5\u8003\u8651\u52a8\u753b\u6570\u636e\u3002\u65b0\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public static AnimGameItem process(MD5Model md5Model, MD5AnimModel animModel, Vector4f defaultColour) throws Exception { List<Matrix4f> invJointMatrices = calcInJointMatrices(md5Model); List<AnimatedFrame> animatedFrames = processAnimationFrames(md5Model, animModel, invJointMatrices); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); AnimGameItem result = new AnimGameItem(meshes, animatedFrames, invJointMatrices); return result; } \u8fd9\u91cc\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u6700\u660e\u663e\u7684\u662f\u8be5\u65b9\u6cd5\u73b0\u5728\u63a5\u6536\u4e00\u4e2a MD5AnimModel \u5b9e\u4f8b\u3002\u6b64\u5916\uff0c\u6211\u4eec\u4e0d\u8fd4\u56de GameItem \u5b9e\u4f8b\uff0c\u800c\u662f\u8fd4\u56de AnimGameItem \u5b9e\u4f8b\u3002\u8be5\u7c7b\u7ee7\u627f\u81ea GameItem \u7c7b\uff0c\u4f46\u6dfb\u52a0\u4e86\u5bf9\u52a8\u753b\u7684\u652f\u6301\u3002\u7a0d\u540e\u6211\u4eec\u5c06\u770b\u5230\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002 \u5982\u679c\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb\u8be5\u5904\u7406\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u8c03\u7528 calcInJointMatrices \u65b9\u6cd5\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private static List<Matrix4f> calcInJointMatrices(MD5Model md5Model) { List<Matrix4f> result = new ArrayList<>(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); for(MD5JointInfo.MD5JointData joint : joints) { Matrix4f translateMat = new Matrix4f().translate(joint.getPosition()); Matrix4f rotationMat = new Matrix4f().rotate(joint.getOrientation()); Matrix4f mat = translateMat.mul(rotationMat); mat.invert(); result.add(mat); } return result; } \u8be5\u65b9\u6cd5\u904d\u5386MD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u8282\u70b9\uff0c\u8ba1\u7b97\u4e0e\u6bcf\u4e2a\u8282\u70b9\u76f8\u5173\u8054\u7684\u8f6c\u6362\u77e9\u9635\uff0c\u7136\u540e\u5f97\u5230\u8fd9\u4e9b\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u6b64\u6570\u636e\u7528\u4e8e\u6784\u9020 AnimGameItem \u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb process \u65b9\u6cd5\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u8c03\u7528 processAnimationFrames \u65b9\u6cd5\u6765\u5904\u7406\u52a8\u753b\u5e27\uff1a private static List<AnimatedFrame> processAnimationFrames(MD5Model md5Model, MD5AnimModel animModel, List<Matrix4f> invJointMatrices) { List<AnimatedFrame> animatedFrames = new ArrayList<>(); List<MD5Frame> frames = animModel.getFrames(); for(MD5Frame frame : frames) { AnimatedFrame data = processAnimationFrame(md5Model, animModel, frame, invJointMatrices); animatedFrames.add(data); } return animatedFrames; } \u8be5\u65b9\u6cd5\u5904\u7406MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\u3002\u771f\u6b63\u7684\u5de5\u4f5c\u662f\u5728 processAnimationFrame \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8ba9\u6211\u6765\u89e3\u91ca\u4e00\u4e0b\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4f5c\u7528\u3002 \u9996\u5148\uff0c\u904d\u5386MD5\u52a8\u753b\u6587\u4ef6\u7684\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u3002 private static AnimatedFrame processAnimationFrame(MD5Model md5Model, MD5AnimModel animModel, MD5Frame frame, List<Matrix4f> invJointMatrices) { AnimatedFrame result = new AnimatedFrame(); MD5BaseFrame baseFrame = animModel.getBaseFrame(); List<MD5Hierarchy.MD5HierarchyData> hierarchyList = animModel.getHierarchy().getHierarchyDataList(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); int numJoints = joints.size(); float[] frameData = frame.getFrameData(); for (int i = 0; i < numJoints; i++) { MD5JointInfo.MD5JointData joint = joints.get(i); \u6211\u4eec\u5f97\u5230\u4e0e\u6bcf\u4e2a\u5173\u8282\u76f8\u5173\u8054\u7684\u57fa\u672c\u5e27\u5143\u7d20\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002 MD5BaseFrame.MD5BaseFrameData baseFrameData = baseFrame.getFrameDataList().get(i); Vector3f position = baseFrameData.getPosition(); Quaternionf orientation = baseFrameData.getOrientation(); \u539f\u5219\u4e0a\uff0c\u8be5\u6570\u636e\u5e94\u5206\u914d\u7ed9\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u4f46\u5b83\u9700\u8981\u6839\u636e\u5173\u8282\u7684\u6807\u5fd7\u8fdb\u884c\u8f6c\u6362\u3002\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\uff0c\u5728\u5c55\u793a\u52a8\u753b\u6587\u4ef6\u7684\u7ed3\u6784\u65f6\uff0c\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u7684\u6bcf\u4e2a\u8282\u70b9\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6807\u5fd7\u3002\u8be5\u6807\u5fd7\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u4fe1\u606f\u51b3\u5b9a\u5efa\u6a21\u4f4d\u7f6e\u548c\u65b9\u5411\u5e94\u8be5\u5982\u4f55\u66f4\u6539\u3002 \u5982\u679c\u6807\u5fd7\u5b57\u6bb5\u7684\u7b2c\u4e00\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u4f7f\u7528\u6b63\u5728\u5904\u7406\u7684\u52a8\u753b\u5e27\u4e2d\u5305\u542b\u7684\u6570\u636e\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684x\u5206\u91cf\u3002\u52a8\u753b\u5e27\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u53d6\u54ea\u4e2a\u5143\u7d20\u5462\uff1f\u7b54\u6848\u4e5f\u5728\u5173\u8282\u5b9a\u4e49\u4e2d\uff0c\u5176\u4e2d\u5305\u542b startIndex \u5c5e\u6027\u3002\u5982\u679c\u6807\u5fd7\u7684\u7b2c\u4e8c\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u7528 startIndex + 1 \u7684\u503c\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684y\u5206\u91cf\uff0c\u4ee5\u6b64\u7c7b\u63a8\uff0c\u63a5\u4e0b\u6765\u7684\u662f\u5750\u6807\u7684z\u5206\u91cf\uff0c\u4ee5\u53ca\u65b9\u5411\u7684x\u3001y\u548cz\u5206\u91cf\u3002 int flags = hierarchyList.get(i).getFlags(); int startIndex = hierarchyList.get(i).getStartIndex(); if ( (flags & 1 ) > 0) { position.x = frameData[startIndex++]; } if ( (flags & 2) > 0) { position.y = frameData[startIndex++]; } if ( (flags & 4) > 0) { position.z = frameData[startIndex++]; } if ( (flags & 8) > 0) { orientation.x = frameData[startIndex++]; } if ( (flags & 16) > 0) { orientation.y = frameData[startIndex++]; } if ( (flags & 32) > 0) { orientation.z = frameData[startIndex++]; } // \u66f4\u65b0\u56db\u5143\u6570\u7684w\u5206\u91cf orientation = MD5Utils.calculateQuaternion(orientation.x, orientation.y, orientation.z); \u73b0\u5728\u6211\u4eec\u6709\u4e86\u8ba1\u7b97\u53d8\u6362\u77e9\u9635\u6240\u9700\u7684\u6240\u6709\u6570\u636e\uff0c\u4ece\u800c\u5f97\u5230\u5f53\u524d\u52a8\u753b\u5e27\u7684\u6bcf\u4e2a\u5173\u8282\u7684\u6700\u7ec8\u4f4d\u7f6e\u3002\u4f46\u662f\u6211\u4eec\u5fc5\u987b\u8003\u8651\u53e6\u4e00\u4ef6\u4e8b\uff0c\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5b83\u7684\u7236\u5173\u8282\u7684\u4f4d\u7f6e\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5f97\u5230\u4e0e\u6bcf\u4e2a\u7236\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u5e76\u7528\u5b83\u6765\u5f97\u5230\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u53d8\u6362\u77e9\u9635\u3002 // \u8ba1\u7b97\u8fd9\u4e2a\u5173\u8282\u7684\u5e73\u79fb\u548c\u65cb\u8f6c\u77e9\u9635 Matrix4f translateMat = new Matrix4f().translate(position); Matrix4f rotationMat = new Matrix4f().rotate(orientation); Matrix4f jointMat = translateMat.mul(rotationMat); // \u5173\u8282\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5173\u8282\u7684\u7236\u7d22\u5f15\u7684\u4f4d\u7f6e\u3002 // \u4f7f\u7528\u7236\u77e9\u9635\u5c06\u5176\u8f6c\u6362\u4e3a\u6a21\u578b\u7a7a\u95f4\u3002 if ( joint.getParentIndex() > -1 ) { Matrix4f parentMatrix = result.getLocalJointMatrices()[joint.getParentIndex()]; jointMat = new Matrix4f(parentMatrix).mul(jointMat); } result.setMatrix(i, jointMat, invJointMatrices.get(i)); } return result; } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u521b\u5efa\u4e86 AnimatedFrame \u7c7b\u7684\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u8be5\u7c7b\u5305\u542b\u5c06\u5728\u52a8\u753b\u671f\u95f4\u4f7f\u7528\u7684\u6570\u636e\u3002\u8fd9\u4e2a\u7c7b\u4e5f\u4f7f\u7528\u9006\u77e9\u9635\uff0c\u7a0d\u540e\u6211\u4eec\u4f1a\u77e5\u9053\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c AnimatedFrame \u7684 setMatrix \u65b9\u6cd5\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a public void setMatrix(int pos, Matrix4f localJointMatrix, Matrix4f invJointMatrix) { localJointMatrices[pos] = localJointMatrix; Matrix4f mat = new Matrix4f(localJointMatrix); mat.mul(invJointMatrix); jointMatrices[pos] = mat; } \u53d8\u91cf localJointMatrix \u50a8\u5b58\u5f53\u524d\u5e27\u4e2d\u5360\u636e\u4f4d\u7f6e\u201ci\u201d\u7684\u5173\u8282\u7684\u65cb\u8f6c\u77e9\u9635\uff0c invJointMatrix \u6301\u6709\u5360\u636e\u7ed1\u5b9a\u59ff\u52bf\u4f4d\u7f6e\u201ci\u201d\u4f4d\u7f6e\u7684\u5173\u8282\u7684\u9006\u53d8\u6362\u77e9\u9635\u3002\u6211\u4eec\u50a8\u5b58\u4e86 localJointMatrix \u4e0e invJointMatrix \u77e9\u9635\u76f8\u4e58\u7684\u7ed3\u679c\u3002\u8fd9\u4e2a\u7ed3\u679c\u5c06\u5728\u7a0d\u540e\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002\u6211\u4eec\u8fd8\u50a8\u5b58\u4e86\u539f\u59cb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\uff0c\u53d8\u91cf localJointMatrix \uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u7528\u5b83\u6765\u8ba1\u7b97\u5b50\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\uff0c generateMesh \u65b9\u6cd5\u4e5f\u53d1\u751f\u4e86\u53d8\u5316\uff0c\u5982\u6211\u4eec\u4e4b\u524d\u8bf4\u660e\u7684\u90a3\u6837\u8ba1\u7b97\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u4f46\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u50a8\u5b58\u4e24\u4e2a\u6570\u7ec4\uff1a \u4e00\u4e2a\u6570\u7ec4\uff0c\u50a8\u5b58\u7740\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u504f\u501a\u3002 \u4e00\u4e2a\u8f93\u51fa\uff0c\u50a8\u5b58\u8fd9\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u5173\u8282\u7d22\u5f15\uff08\u901a\u8fc7\u6743\u91cd\uff09\u3002 \u6211\u4eec\u5c06\u8fd9\u4e9b\u6570\u7ec4\u7684\u5927\u5c0f\u9650\u5236\u4e3a4\u3002 Mesh \u7c7b\u4e5f\u88ab\u4fee\u6539\u4e3a\u63a5\u6536\u8fd9\u4e9b\u53c2\u6570\uff0c\u5e76\u5c06\u5176\u5305\u542b\u5728\u7740\u8272\u5668\u5904\u7406\u7684VAO\u6570\u636e\u4e2d\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u8be6\u7ec6\u5185\u5bb9\uff0c\u4f46\u6765\u56de\u987e\u4e00\u4e0b\u6211\u4eec\u6240\u505a\u7684\uff1a \u6211\u4eec\u4ecd\u5728\u52a0\u8f7d\u7ed1\u5b9a\u59ff\u52bf\uff0c\u901a\u8fc7\u6743\u91cd\u6570\u636e\u8ba1\u7b97\u51fa\u5b83\u4eec\u7684\u6700\u7ec8\u4f4d\u7f6e\uff0c\u5373\u5173\u8282\u5750\u6807\u548c\u65b9\u5411\u7684\u603b\u548c\u3002 \u8fd9\u4e9b\u6570\u636e\u4ee5VBO\u7684\u5f62\u5f0f\u52a0\u8f7d\u5230\u7740\u8272\u5668\u4e2d\uff0c\u4f46\u662f\u5b83\u7531\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u504f\u501a\u548c\u5f71\u54cd\u5b83\u7684\u5173\u8282\u7684\u7d22\u5f15\u6765\u8865\u5145\u3002\u8fd9\u4e2a\u6570\u636e\u5bf9\u6240\u6709\u52a8\u753b\u5e27\u90fd\u662f\u901a\u7528\u7684\uff0c\u56e0\u4e3a\u5b83\u662f\u5728MD5\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9650\u5236\u504f\u501a\u548c\u5173\u8282\u7d22\u5f15\u6570\u7ec4\u5927\u5c0f\u7684\u539f\u56e0\uff0c\u5f53\u6a21\u578b\u88ab\u53d1\u9001\u5230GPU\u65f6\uff0c\u5b83\u4eec\u5c06\u88ab\u52a0\u8f7d\u4e3aVBO\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u6211\u4eec\u6839\u636e\u57fa\u7840\u5e27\u4e2d\u5b9a\u4e49\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u50a8\u5b58\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u5b9a\u4e49\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u77e5\u9053\u5982\u4f55\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u5b8c\u6210\u7684\u53d8\u6362\uff0c\u7a0d\u540e\u5c06\u770b\u5230\u5982\u4f55\u5e94\u7528\u5b83\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u62fc\u56fe\u7684\u6240\u6709\u788e\u7247\uff0c\u53ea\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u9996\u5148\u9700\u8981\u4fee\u6539\u8f93\u5165\u6570\u636e\u6765\u63a5\u6536\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u3002 #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; \u6211\u4eec\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff1a MAX_WEIGHTS \uff0c\u5b9a\u4e49\u6743\u91cdVBO\uff08\u4e00\u4e2a\u5355\u72ec\u7684\u5173\u8282\u7d22\u5f15\uff09\u4e2d\u7684\u6743\u91cd\u7684\u6700\u5927\u6570\u91cf\u3002 MAX_JOINTS \uff0c\u5b9a\u4e49\u4e86\u6211\u4eec\u5c06\u652f\u6301\u7684\u6700\u5927\u5173\u8282\u6570\u91cf\uff08\u7a0d\u540e\u5c06\u8be6\u7ec6\u4ecb\u7ecd\uff09\u3002 \u7136\u540e\u6211\u4eec\u5b9a\u4e49\u8f93\u51fa\u6570\u636e\u548cUniform\u3002 out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a jointsMatrix \u7684\u65b0Uniform\uff0c\u5b83\u662f\u4e00\u4e2a\u77e9\u9635\u6570\u7ec4\uff08\u6700\u5927\u957f\u5ea6\u7531 MAX_JOINTS \u5e38\u91cf\u8bbe\u7f6e\uff09\u3002\u8be5\u77e9\u9635\u6570\u7ec4\u5305\u542b\u5f53\u524d\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u5173\u8282\u77e9\u9635\uff0c\u5e76\u5728\u5904\u7406\u5e27\u65f6\u5728 MD5Loader \u7c7b\u4e2d\u8ba1\u7b97\u3002\u56e0\u6b64\uff0c\u8be5\u6570\u7ec4\u5305\u542b\u9700\u8981\u5e94\u7528\u4e8e\u5f53\u524d\u52a8\u753b\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u53d8\u6362\uff0c\u5e76\u5c06\u4f5c\u4e3a\u8ba1\u7b97\u9876\u70b9\u6700\u7ec8\u5750\u6807\u7684\u57fa\u7840\u3002 \u4f7f\u7528VBO\u4e2d\u7684\u65b0\u6570\u636e\u548c\u8be5Uniform\uff0c\u6211\u4eec\u5c06\u53d8\u6362\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\u3002\u8fd9\u5c06\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\uff1a vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } \u9996\u5148\uff0c\u6211\u4eec\u5f97\u5230\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u904d\u5386\u4e0e\u8fd9\u4e2a\u9876\u70b9\u5173\u8054\u7684\u6743\u91cd\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528\u50a8\u5b58\u5728\u8f93\u5165\u4e2d\u7684\u7d22\u5f15\uff0c\u4f7f\u7528\u8be5\u5e27\uff08\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\uff09\u7684\u6743\u91cd\u548c\u5173\u8282\u77e9\u9635\u4fee\u6539\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u4e2a\u9876\u70b9\u5750\u6807\uff0c\u6211\u4eec\u8ba1\u7b97\u5b83\u7684\u5e27\u5750\u6807\uff1a Vfp = \\sum\\limits_{i=0}^{MAX WEIGTHS} Wb_{i} \\dot (Jfp_{i} \\times Jt^{-1}_{i}) \\times Vpos \u53c2\u6570\uff1a Wfvp \u662f\u9876\u70b9\u7684\u6700\u7ec8\u5750\u6807\u3002 Wb \u662f\u9876\u70b9\u7684\u6743\u91cd\u3002 Jfp \u662f\u8fd9\u4e2a\u5750\u6807\u7cfb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u3002 Jt^{-1} \u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u8fd9\u4e2a\u77e9\u9635\u4e0e Jfp \u7684\u6210\u7ee9\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\u3002 Vpos \u662f\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u7684\u9876\u70b9\u5750\u6807\u3002 Vpos \u7531 Jt \u77e9\u9635\u8ba1\u7b97\uff0c\u8fd9\u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u77e9\u9635\u3002\u6240\u4ee5\uff0c\u6700\u540e\u6211\u4eec\u8981\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u7684\u4fee\u6539\u6765\u5e94\u7528\u8be5\u5750\u6807\u7cfb\u7684\u53d8\u6362\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9700\u8981\u9006\u7ed1\u5b9a\u59ff\u52bf\u77e9\u9635\u7684\u539f\u56e0\u3002 \u7740\u8272\u5668\u652f\u6301\u6743\u91cd\u53ef\u53d8\u7684\u9876\u70b9\uff0c\u6700\u591a\u53ef\u8fbe4\u4e2a\uff0c\u8fd8\u53ef\u4ee5\u6e32\u67d3\u975e\u52a8\u753b\u9879\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6743\u91cd\u7b49\u4e8e0\u6211\u4eec\u5c06\u5f97\u5230\u539f\u59cb\u5750\u6807\u3002 \u7740\u8272\u5668\u7684\u5176\u4f59\u90e8\u5206\u6216\u591a\u6216\u5c11\u4fdd\u6301\u4e0d\u53d8\uff0c\u6211\u4eec\u53ea\u662f\u4f7f\u7528\u66f4\u65b0\u540e\u7684\u5750\u6807\u5e76\u4f20\u9012\u7247\u5143\u7740\u8272\u5668\u8981\u4f7f\u7528\u7684\u6b63\u786e\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6240\u4ee5\uff0c\u4e3a\u4e86\u6d4b\u8bd5\u52a8\u753b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06 jointsMatrix \u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u7531\u4e8e\u6b64\u4fe1\u606f\u4ec5\u50a8\u5b58\u5728 AnimGameItem \u5b9e\u4f8b\u4e2d\uff0c\u56e0\u6b64\u4ee3\u7801\u975e\u5e38\u7b80\u5355\u3002\u5728\u6e32\u67d3\u7f51\u683c\u7684\u5faa\u73af\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u5982\u4e0b\u4ee3\u7801\u7247\u6bb5\uff1a if ( gameItem instanceof AnimGameItem ) { AnimGameItem animGameItem = (AnimGameItem)gameItem; AnimatedFrame frame = animGameItem.getCurrentFrame(); sceneShaderProgram.setUniform(\"jointsMatrix\", frame.getJointMatrices()); } \u5f53\u7136\uff0c\u5728\u4f7f\u7528\u5b83\u4e4b\u524d\uff0c\u4f60\u9700\u8981\u521b\u5efaUniform\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u8be5\u7c7b\u7684\u6e90\u4ee3\u7801\u3002\u5982\u679c\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u5c06\u80fd\u591f\u901a\u8fc7\u6309\u4e0b\u7a7a\u683c\u952e\u6765\u67e5\u770b\u6a21\u578b\u662f\u5982\u4f55\u52a8\u8d77\u6765\u7684\uff08\u6bcf\u6b21\u6309\u4e0b\u8fd9\u4e2a\u952e\uff0c\u90fd\u4f1a\u8bbe\u7f6e\u4e00\u4e2a\u65b0\u7684\u5e27\uff0c\u5e76\u4e14 jointsMatrix Uniform\u4f1a\u53d1\u751f\u53d8\u5316\uff09\u3002 \u4f60\u5c06\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u867d\u7136\u52a8\u753b\u5f88\u6d41\u7545\uff0c\u4f46\u793a\u4f8b\u8fd8\u662f\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u5149\u7167\u6ca1\u6709\u6b63\u5e38\u7684\u5de5\u4f5c\uff0c\u9634\u5f71\u8868\u73b0\u7684\u662f\u7ed1\u5b9a\u59ff\u52bf\uff0c\u800c\u4e0d\u662f\u5f53\u524d\u5e27\u3002\u6211\u4eec\u73b0\u5728\u5c06\u89e3\u51b3\u6240\u6709\u8fd9\u4e9b\u95ee\u9898\u3002 \u4fee\u6b63\u52a8\u753b\u95ee\u9898 \u7b2c\u4e00\u4e2a\u8981\u89e3\u51b3\u7684\u95ee\u9898\u662f\u5149\u7167\u95ee\u9898\u3002\u4f60\u53ef\u80fd\u5df2\u7ecf\u6ce8\u610f\u5230\u8fd9\u79cd\u60c5\u51b5\u4e86\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u6cd5\u7ebf\u3002\u56e0\u6b64\uff0c\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u6cd5\u7ebf\u4e0e\u7ed1\u5b9a\u59ff\u52bf\u76f8\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u50cf\u53d8\u6362\u4f4d\u7f6e\u4e00\u6837\u53d8\u6362\u5b83\u4eec\u3002 \u8fd9\u4e2a\u95ee\u9898\u5f88\u597d\u89e3\u51b3\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728\u5faa\u73af\u4e2d\u5c06\u6cd5\u7ebf\u4e5f\u56ca\u62ec\u5230\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u6743\u91cd\u904d\u5386\u3002 vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u7136\u540e\u6211\u4eec\u50cf\u5f80\u5e38\u4e00\u6837\u8ba1\u7b97\u8f93\u51fa\u9876\u70b9\u6cd5\u7ebf\u5411\u91cf\uff1a mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; \u63a5\u4e0b\u6765\u7684\u95ee\u9898\u662f\u9634\u5f71\u95ee\u9898\u3002\u5982\u679c\u4f60\u8bb0\u5f97\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u9634\u5f71\u56fe\u7ed8\u5236\u9634\u5f71\u3002\u6211\u4eec\u73b0\u5728\u6b63\u4ece\u5149\u7167\u900f\u89c6\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u521b\u5efa\u4e00\u4e2a\u6df1\u5ea6\u56fe\uff0c\u5b83\u544a\u8bc9\u6211\u4eec\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u9634\u5f71\u4e2d\u3002\u4f46\u662f\uff0c\u5728\u6cd5\u7ebf\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u6839\u636e\u5f53\u524d\u5e27\u6765\u6539\u53d8\u5b83\u4eec\u3002\u8fd9\u5c31\u662f\u9634\u5f71\u4e0e\u5f53\u524d\u5750\u6807\u4e0d\u4e00\u81f4\u7684\u539f\u56e0\u3002 \u89e3\u51b3\u65b9\u6cd5\u4e5f\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528 jointsMatrix \u3001\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u6765\u53d8\u6362\u5750\u6807\u3002\u8fd9\u5c31\u662f\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } gl_Position = orthoProjectionMatrix * modelLightViewMatrix * initPos; } \u4f60\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u6765\u4e3a\u8fd9\u4e2a\u7740\u8272\u5668\u8bbe\u7f6e\u65b0\u7684Uniform\uff0c\u6700\u7ec8\u7684\u6548\u679c\u4f1a\u66f4\u597d\u3002\u5149\u7167\u5c06\u88ab\u6b63\u786e\u7684\u5e94\u7528\uff0c\u9634\u5f71\u5c06\u968f\u6bcf\u4e2a\u52a8\u753b\u5e27\u6539\u53d8\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\u4e86\uff0c\u73b0\u5728\u4f60\u5df2\u7ecf\u6709\u4e86\u4e00\u4e2a\u7528\u4e8e\u52a8\u753bMD5\u6a21\u578b\u7684\u53ef\u5de5\u4f5c\u793a\u4f8b\u3002\u6e90\u4ee3\u7801\u4ecd\u80fd\u6539\u8fdb\uff0c\u4f60\u53ef\u4ee5\u4fee\u6539\u5728\u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u4e2d\u52a0\u8f7d\u7684\u77e9\u9635\uff0c\u4ee5\u4fbf\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u4e2d\u4f7f\u7528\u7684\u8d44\u6e90\uff0c\u4e86\u89e3\u5982\u4f55\u5b9e\u73b0\u8be5\u529f\u80fd\u3002","title":"\u52a8\u753b"},{"location":"19-animations/#animations","text":"","title":"\u52a8\u753b\uff08Animations\uff09"},{"location":"19-animations/#_1","text":"\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u52a0\u8f7d\u4e86\u9759\u60013D\u6a21\u578b\uff0c\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4e3a\u5b83\u4eec\u8bbe\u7f6e\u52a8\u753b\u3002\u5728\u601d\u8003\u52a8\u753b\u65f6\uff0c\u9996\u5148\u60f3\u5230\u7684\u65b9\u6cd5\u662f\u4e3a\u6bcf\u4e2a\u6a21\u578b\u72b6\u6001\u521b\u5efa\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u5c06\u5b83\u4eec\u52a0\u8f7d\u5230GPU\u4e2d\uff0c\u7136\u540e\u6309\u987a\u5e8f\u7ed8\u5236\uff0c\u4ee5\u6b64\u9020\u6210\u52a8\u753b\u7684\u5047\u8c61\u3002\u867d\u7136\u8fd9\u79cd\u65b9\u6cd5\u5bf9\u4e8e\u67d0\u4e9b\u6e38\u620f\u6765\u8bf4\u662f\u5b8c\u7f8e\u7684\uff0c\u4f46\u662f\u5b83\u7684\u6548\u7387\u4e0d\u662f\u5f88\u9ad8\uff08\u5c31\u5185\u5b58\u6d88\u8017\u6765\u8bf4\uff09\u3002 \u8fd9\u5c31\u662f\u9aa8\u9abc\u52a8\u753b\uff08Skeletal Animation\uff09\u7684\u7528\u6b66\u4e4b\u5730\u3002\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u6a21\u578b\u7684\u52a8\u753b\u65b9\u5f0f\u7531\u5176\u5e95\u5c42\u9aa8\u67b6\uff08Skeletal\uff09\u5b9a\u4e49\uff0c\u9aa8\u67b6\u662f\u7531\u88ab\u79f0\u4e3a\u5173\u8282\uff08Joints\uff09\u7684\u7279\u6b8a\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u5b9a\u4e49\u7684\uff0c\u8fd9\u4e9b\u5173\u8282\u53c8\u7531\u5b83\u4eec\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u6765\u5b9a\u4e49\u3002\u6211\u4eec\u4e5f\u8bf4\u8fc7\u8fd9\u662f\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u610f\u5473\u7740\u6bcf\u4e2a\u5173\u952e\u7684\u6700\u7ec8\u4f4d\u7f6e\u90fd\u6536\u5230\u5b83\u4eec\u7684\u7236\u5c42\u6b21\u7684\u5f71\u54cd\u3002\u4ee5\u624b\u8155\u4e3a\u4f8b\uff0c\u5982\u679c\u89d2\u8272\u79fb\u52a8\u8098\u90e8\u548c\u80a9\u8180\uff0c\u624b\u8155\u7684\u4f4d\u7f6e\u5c31\u4f1a\u53d1\u751f\u6539\u53d8\u3002 \u5173\u8282\u4e0d\u9700\u8981\u8868\u793a\u4e00\u4e2a\u5408\u4e4e\u73b0\u5b9e\u7684\u9aa8\u9abc\u6216\u5173\u8282\uff0c\u5b83\u4eec\u662f\u4eba\u5de5\u8bbe\u7f6e\u7684\uff0c\u5141\u8bb8\u521b\u4f5c\u8005\u5efa\u6a21\u52a8\u753b\u3002\u9664\u4e86\u5173\u8282\uff0c\u6211\u4eec\u8fd8\u6709\u9876\u70b9\uff0c\u8fd9\u4e9b\u9876\u70b9\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u4e09\u89d2\u5f62\u3002\u4f46\u5728\u9aa8\u9abc\u52a8\u753b\u4e2d\uff0c\u9876\u70b9\u662f\u6839\u636e\u4e0e\u4e4b\u76f8\u5173\u7684\u5173\u8282\u7684\u4f4d\u7f6e\u7ed8\u5236\u7684\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528MD5\u683c\u5f0f\u6765\u52a0\u8f7d\u6709\u52a8\u753b\u7684\u6a21\u578b\u3002MD5\u683c\u5f0f\u662f\u7531\u300a\u6bc1\u706d\u6218\u58eb\u300b\u7684\u5f00\u53d1\u5546ID Software\u5236\u5b9a\u7684\uff0c\u5b83\u57fa\u672c\u4e0a\u662f\u4e00\u79cd\u57fa\u4e8e\u6587\u672c\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u6613\u4e8e\u7406\u89e3\u3002\u53e6\u4e00\u79cd\u65b9\u6cd5\u662f\u4f7f\u7528 Collada \u683c\u5f0f\uff0c\u8fd9\u662f\u8bb8\u591a\u5de5\u5177\u652f\u6301\u7684\u516c\u5171\u6807\u51c6\u3002Collada\u662f\u4e00\u79cd\u57fa\u4e8eXML\u7684\u6587\u4ef6\u683c\u5f0f\uff0c\u4f46\u5b83\u7684\u7f3a\u70b9\u662f\u975e\u5e38\u590d\u6742\uff081.5\u7248\u672c\u7684\u89c4\u8303\u5c31\u6709500\u591a\u9875\uff09\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u575a\u6301\u4f7f\u7528\u4e00\u79cd\u66f4\u7b80\u5355\u7684\u683c\u5f0f\uff0cMD5\uff0c\u5b83\u4f7f\u6211\u4eec\u4e13\u6ce8\u4e8e\u9aa8\u9abc\u52a8\u753b\u7684\u6982\u5ff5\u5e76\u521b\u5efa\u4e00\u4e2a\u53ef\u5de5\u4f5c\u7684\u793a\u4f8b\u3002 \u4f60\u8fd8\u53ef\u4ee5\u901a\u8fc7\u5728\u4e92\u8054\u7f51\u4e0a\u627e\u5230 \u7279\u5b9a\u63d2\u4ef6 \u5c06\u4e00\u4e9b\u6a21\u578b\u4eceBlender\u5bfc\u51fa\u4e3aMD5\u683c\u5f0f\u3002 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u53c2\u8003\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u8d44\u6599\uff0c\u4f46\u662f\u6211\u53d1\u73b0\u6709\u4e24\u4e2a\u8d44\u6599\u53ef\u4ee5\u5f88\u597d\u5730\u89e3\u91ca\u5982\u4f55\u4f7f\u7528MD5\u6587\u4ef6\u521b\u5efa\u52a8\u753b\u6a21\u578b\u3002\u8fd9\u4e9b\u8d44\u6599\u7684\u6765\u6e90\u5982\u4e0b\uff1a http://www.3dgep.com/gpu-skinning-of-md5-models-in-opengl-and-cg/ http://ogldev.atspace.co.uk/www/tutorial38/tutorial38.html \u8ba9\u6211\u4eec\u4ece\u7f16\u5199\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5f00\u59cb\uff0cMD5\u683c\u5f0f\u5b9a\u4e49\u4e86\u4e24\u79cd\u7c7b\u578b\u7684\u6587\u4ef6\uff1a \u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b83\u5b9a\u4e49\u4e86\u6784\u62103D\u6a21\u578b\u7684\u7f51\u683c\u96c6\u7684\u5173\u8282\u3001\u9876\u70b9\u548c\u7eb9\u7406\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5mesh \u7684\u6269\u5c55\u540d\u3002 \u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff1a\u5b9a\u4e49\u53ef\u4f7f\u7528\u4e8e\u6a21\u578b\u7684\u52a8\u753b\u3002\u8fd9\u4e2a\u6587\u4ef6\u901a\u5e38\u6709\u4e00\u4e2a\u540d\u4e3a .md5anim \u7684\u6269\u5c55\u540d\u3002 MD5\u6587\u4ef6\u7531\u5934\uff08Header\uff09\u548c\u5927\u62ec\u53f7\u4e4b\u95f4\u5305\u542b\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u67e5\u770b\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u3002\u5728\u53c2\u8003\u8d44\u6599\u6587\u4ef6\u5939\u4e2d\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u79cdMD5\u683c\u5f0f\u7684\u6a21\u578b\u3002\u5982\u679c\u4f60\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\uff0c\u4f60\u4f1a\u770b\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u6784\u3002 \u5728\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e2d\u53ef\u4ee5\u770b\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u5728\u4e0b\u8ff0\u63d0\u4f9b\u7684\u793a\u4f8b\u4e2d\uff0c\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numJoints 33 numMeshes 6 \u5934\u5b9a\u4e49\u4e86\u5982\u4e0b\u5c5e\u6027\uff1a \u5b83\u6240\u9075\u5faa\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\uff08\u4ece3D\u5efa\u6a21\u5de5\u5177\uff09\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\u3002 \u5728\u5173\u8282\u90e8\u5206\u5b9a\u4e49\u7684\u5173\u8282\u6570\u3002 \u7f51\u683c\u6570\uff08\u9700\u8981\u7684\u7f51\u683c\u8282\u6570\uff09\u3002 \u5173\u952e\u90e8\u5206\u5b9a\u4e49\u5173\u8282\u7684\u540d\u79f0\u3001\u72b6\u6001\u3001\u4f4d\u7f6e\u53ca\u5176\u5173\u7cfb\u3002\u4e0b\u9762\u5c55\u793a\u4e86\u4e00\u4e2a\u793a\u4f8b\u6a21\u578b\u7684\u5173\u8282\u90e8\u5206\u7684\u7247\u6bb5\uff1a joints { \"origin\" -1 ( -0.000000 0.016430 -0.006044 ) ( 0.707107 0.000000 0.707107 ) // \"sheath\" 0 ( 11.004813 -3.177138 31.702473 ) ( 0.307041 -0.578614 0.354181 ) // origin \"sword\" 1 ( 9.809593 -9.361549 40.753730 ) ( 0.305557 -0.578155 0.353505 ) // sheath \"pubis\" 0 ( 0.014076 2.064442 26.144581 ) ( -0.466932 -0.531013 -0.466932 ) // origin \u2026\u2026 } \u5173\u8282\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\u79f0\uff0c\u5f15\u53f7\u4e2d\u7684\u6587\u672c\u5c5e\u6027\u3002 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u7236\u5173\u8282\u5728\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u5173\u8282\u7b49\u4e8e-1\u3002 \u5173\u8282\u4f4d\u7f6e\uff0c\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\u3002 \u5173\u8282\u65b9\u5411\uff0c\u4e5f\u5728\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u5b9a\u4e49\uff0c\u65b9\u5411\u5b9e\u9645\u4e0a\u662f\u4e00\u4e2a\u56db\u5143\u6570\uff0c\u4f46\u5176w\u5206\u91cf\u4e0d\u5305\u62ec\u5728\u6b64\u3002 \u5728\u7ee7\u7eed\u89e3\u91ca\u6587\u4ef6\u7684\u5176\u4f59\u90e8\u5206\u4e4b\u524d\uff0c\u6211\u4eec\u5148\u6765\u8c08\u8c08\u56db\u5143\u6570\uff08Quaternions\uff09\u3002\u56db\u5143\u6570\u662f\u7528\u4e8e\u8868\u793a\u65cb\u8f6c\u7684\u56db\u4e2a\u6784\u6210\u5143\u7d20\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u4e00\u76f4\u5728\u4f7f\u7528\u6b27\u62c9\u89d2\uff08\u504f\u822a\u3001\u4fef\u4ef0\u548c\u6eda\u8f6c\uff09\u6765\u5b9a\u4e49\u65cb\u8f6c\uff0c\u8fd9\u57fa\u672c\u4e0a\u5b9a\u4e49\u4e86\u56f4\u7ed5x\u3001y\u548cz\u53eb\u7684\u65cb\u8f6c\u3002\u4f46\u662f\uff0c\u6b27\u62c9\u89d2\u5728\u5904\u7406\u65cb\u8f6c\u65f6\u4f1a\u51fa\u73b0\u4e00\u4e9b\u95ee\u9898\uff0c\u7279\u522b\u662f\u4f60\u5fc5\u987b\u77e5\u9053\u6b63\u786e\u7684\u65cb\u8f6c\u987a\u5e8f\uff0c\u5e76\u4e14\u4e00\u4e9b\u64cd\u4f5c\u4f1a\u53d8\u5f97\u975e\u5e38\u590d\u6742\u3002 \u56db\u5143\u6570\u6709\u52a9\u4e8e\u89e3\u51b3\u8fd9\u79cd\u590d\u6742\u60c5\u51b5\u3002\u6b63\u5982\u4e4b\u524d\u6240\u8bf4\uff0c\u56db\u5143\u6570\u88ab\u5b9a\u4e49\u4e3a4\u4e2a\u6570\u5b57\uff08x\uff0cy\uff0cz\uff0cw\uff09\u4e00\u7ec4\u3002\u56db\u5143\u6570\u5b9a\u4e49\u65cb\u8f6c\u8f74\u548c\u56f4\u7ed5\u8be5\u8f74\u7684\u65cb\u8f6c\u89d2\u5ea6\u3002 \u4f60\u53ef\u4ee5\u5728\u7f51\u7edc\u4e2d\u786e\u8ba4\u6bcf\u4e2a\u5143\u7d20\u7684\u6570\u5b66\u5b9a\u4e49\uff0c\u4f46\u597d\u6d88\u606f\u662f\u6211\u4eec\u4f7f\u7528\u7684\u6570\u5b66\u5e93JOML\u4e3a\u5176\u63d0\u4f9b\u4e86\u652f\u6301\u3002\u6211\u4eec\u53ef\u4ee5\u57fa\u4e8e\u56db\u5143\u6570\u6784\u9020\u65cb\u8f6c\u77e9\u9635\uff0c\u5e76\u7528\u5b83\u4eec\u5bf9\u5411\u91cf\u8fdb\u884c\u53d8\u6362\u3002 \u8ba9\u6211\u4eec\u56de\u5230\u5173\u8282\u7684\u5b9a\u4e49\uff0c\u5176\u7f3a\u5c11 w \u5143\u7d20\uff0c\u4f46\u53ef\u4ee5\u5728\u5176\u4ed6\u503c\u7684\u5e2e\u52a9\u4e0b\u8f7b\u677e\u5730\u8ba1\u7b97\u5b83\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u770b\u770b\u8fd9\u662f\u5982\u4f55\u505a\u5230\u7684\u3002 \u5728\u5173\u8282\u5b9a\u4e49\u4e4b\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u7ec4\u6210\u6a21\u578b\u7684\u4e0d\u540c\u7f51\u683c\u7684\u5b9a\u4e49\u3002\u63a5\u4e0b\u6765\u4f60\u53ef\u4ee5\u4ece\u5176\u4e2d\u4e00\u4e2a\u793a\u4f8b\u4e2d\u770b\u5230\u7f51\u683c\u5b9a\u4e49\u7684\u7247\u6bb5\uff1a mesh { shader \"/textures/bob/guard1_body.png\" numverts 494 vert 0 ( 0.394531 0.513672 ) 0 1 vert 1 ( 0.447266 0.449219 ) 1 2 ... vert 493 ( 0.683594 0.455078 ) 864 3 numtris 628 tri 0 0 2 1 tri 1 0 1 3 ... tri 627 471 479 493 numweights 867 weight 0 5 1.000000 ( 6.175774 8.105262 -0.023020 ) weight 1 5 0.500000 ( 4.880173 12.805251 4.196980 ) ... weight 866 6 0.333333 ( 1.266308 -0.302701 8.949338 ) } \u8ba9\u6211\u4eec\u770b\u770b\u4e0a\u8ff0\u5c55\u73b0\u7684\u7ed3\u6784\uff1a \u7f51\u683c\u4ece\u5b9a\u4e49\u7eb9\u7406\u6587\u4ef6\u5f00\u59cb\u3002\u8bf7\u8bb0\u4f4f\uff0c\u4f60\u5728\u6b64\u5904\u627e\u5230\u7684\u8def\u5f84\u662f\u521b\u5efa\u8be5\u6a21\u578b\u7684\u5de5\u5177\u6240\u4f7f\u7528\u7684\u8def\u5f84\u3002\u8be5\u8def\u5f84\u53ef\u80fd\u4e0e\u7528\u4e8e\u52a0\u8f7d\u8fd9\u4e9b\u6587\u4ef6\u7684\u8def\u5f84\u4e0d\u5339\u914d\u3002\u8fd9\u91cc\u6709\u4e24\u79cd\u65b9\u6cd5\u89e3\u51b3\uff0c\u8981\u4e48\u52a8\u6001\u4fee\u6539\u57fa\u672c\u8def\u5f84\uff0c\u8981\u4e48\u624b\u52a8\u4fee\u6539\u8be5\u8def\u5f84\u3002\u6211\u9009\u62e9\u4e86\u540e\u8005\uff0c\u6bd4\u8f83\u7b80\u5355\u7684\u4e00\u79cd\u3002 \u63a5\u4e0b\u6765\u53ef\u4ee5\u627e\u5230\u9876\u70b9\u5b9a\u4e49\u3002\u9876\u70b9\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u9876\u70b9\u7d22\u5f15\u3002 \u7eb9\u7406\u5750\u6807\u3002 \u5f71\u54cd\u6b64\u9876\u70b9\u7684\u7b2c\u4e00\u4e2a\u6743\u91cd\u5b9a\u4e49\u7684\u7d22\u5f15\u3002 \u8981\u8003\u8651\u7684\u6743\u91cd\u6570\u3002 \u5728\u9876\u70b9\u4e4b\u540e\uff0c\u5c06\u5b9a\u4e49\u6784\u6210\u6b64\u7f51\u683c\u7684\u4e09\u89d2\u5f62\u3002\u4e09\u89d2\u5f62\u5b9a\u4e49\u4e86\u4f7f\u7528\u9876\u70b9\u7d22\u5f15\u7ec4\u7ec7\u9876\u70b9\u7684\u65b9\u5f0f\u3002 \u6700\u540e\uff0c\u5b9a\u4e49\u4e86\u6743\u91cd\u3002\u6743\u91cd\u5b9a\u4e49\u7531\u4ee5\u4e0b\u90e8\u5206\u7ec4\u6210\uff1a \u6743\u91cd\u6307\u6570\u3002 \u5173\u8282\u6307\u6570\uff0c\u6307\u4e0e\u8be5\u6743\u91cd\u76f8\u5173\u7684\u5173\u8282 \u504f\u501a\u7cfb\u6570\uff0c\u7528\u4e8e\u8c03\u8282\u8be5\u6743\u91cd\u7684\u5f71\u54cd\u3002 \u8be5\u6743\u91cd\u7684\u4f4d\u7f6e\u3002 \u4e0b\u56fe\u7528\u793a\u4f8b\u6570\u636e\u8bf4\u660e\u4e86\u4e0a\u8ff0\u7ec4\u5206\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u597d\u4e86\uff0c\u73b0\u5728\u4e86\u89e3\u4e86\u7f51\u683c\u6a21\u578b\u6587\u4ef6\uff0c\u6211\u4eec\u53ef\u4ee5\u89e3\u6790\u5b83\u4e86\u3002\u5982\u679c\u4f60\u770b\u4e86\u6e90\u4ee3\u7801\uff0c\u5c06\u770b\u5230\u5df2\u7ecf\u521b\u5efa\u4e86\u65b0\u7684\u5305\u6765\u5bb9\u7eb3\u6a21\u578b\u683c\u5f0f\u7684\u89e3\u6790\u5668\u3002\u5728 org.lwjglb.engine.loaders.obj \u5305\u4e0b\u6709\u4e00\u4e2a\u89e3\u6790OBJ\u6587\u4ef6\u7684\u4ee3\u7801\uff0c\u800c\u89e3\u6790MD5\u6587\u4ef6\u7684\u4ee3\u7801\u5728 org.lwjglb.engine.loaders.md5 \u5305\u4e0b\u3002 \u6240\u6709\u7684\u89e3\u6790\u4ee3\u7801\u90fd\u57fa\u4e8e\u6b63\u5219\u8868\u8fbe\u5f0f\u4eceMD5\u6587\u672c\u6587\u4ef6\u4e2d\u63d0\u53d6\u4fe1\u606f\u3002\u89e3\u6790\u5668\u5c06\u521b\u5efa\u4e00\u4e2a\u5c42\u6b21\u7ed3\u6784\u5bf9\u8c61\uff0c\u4ee5\u6a21\u62dfMD5\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u4fe1\u606f\u7ec4\u4ef6\u7684\u7ed3\u6784\u3002\u5b83\u53ef\u80fd\u4e0d\u662f\u4e16\u754c\u4e0a\u6700\u9ad8\u6548\u7684\u89e3\u6790\u5668\uff0c\u4f46\u6211\u8ba4\u4e3a\u5b83\u5c06\u6709\u52a9\u4e8e\u66f4\u597d\u5730\u7406\u89e3\u8fd9\u4e2a\u8fc7\u7a0b\u3002 \u89e3\u6790MD5\u6a21\u578b\u6587\u4ef6\u7684\u8d77\u59cb\u7c7b\u662f MD5Model \u7c7b\uff0c\u8be5\u7c7b\u5728\u5176\u89e3\u6790\u65b9\u6cd5\u4e2d\u4f5c\u4e3a\u53c2\u6570\u88ab\u63a5\u6536\u3002MD5\u6587\u4ef6\u7684\u5185\u5bb9\u662f\u521b\u5efa\u4e00\u4e2a\u5305\u542b\u5934\u3001\u8282\u70b9\u5217\u8868\u548c\u6240\u6709\u5b50\u5143\u7d20\u7684\u7f51\u683c\u5217\u8868\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6240\u4ee5\u4e0d\u5305\u542b\u5728\u672c\u6587\u4e2d\u4e86\u3002 \u5173\u4e8e\u89e3\u6790\u4ee3\u7801\u7684\u4e00\u4e9b\u6ce8\u91ca\uff1a \u7f51\u683c\u7684\u5b50\u5143\u7d20\u88ab\u5b9a\u4e49\u4e3a MD5Mesh \u7c7b\u7684\u5185\u90e8\u7c7b\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u5982\u4f55\u5728 MD5Utils \u7c7b\u7684 calculateQuaternion \u65b9\u6cd5\u4e2d\u8ba1\u7b97\u5173\u8282\u65b9\u5411\u7684\u7b2c\u56db\u4e2a\u5206\u91cf\u3002 \u65e2\u7136\u6211\u4eec\u5df2\u7ecf\u89e3\u6790\u4e86\u4e00\u4e2a\u6587\u4ef6\uff0c\u6211\u4eec\u5fc5\u987b\u8bb2\u8fd9\u4e2a\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\u8f6c\u6362\u6210\u53ef\u4ee5\u7531\u6e38\u620f\u5f15\u64ce\u5904\u7406\u7684\u4e1c\u897f\uff0c\u6211\u4eec\u5fc5\u987b\u521b\u5efa\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a MD5Loader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u4f7f\u7528\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u6765\u6784\u9020\u4e00\u4e2a GameItem \u3002 \u5728\u5f00\u59cb\u4e4b\u524d\uff0c\u5982\u4f60\u6240\u6ce8\u610f\u5230\u7684\uff0cMD5\u6a21\u578b\u6709\u597d\u51e0\u4e2a\u7f51\u683c\uff0c\u4f46\u6211\u4eec\u7684 GameItem \u7c7b\u53ea\u652f\u6301\u5355\u4e2a\u7f51\u683c\u3002\u6240\u4ee5\u9996\u5148\u6211\u4eec\u8981\u4fee\u6539\u5b83\uff0c GameItem \u7c7b\u73b0\u5728\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { private Mesh[] meshes; private final Vector3f position; private float scale; private final Vector3f rotation; public GameItem() { position = new Vector3f(0, 0, 0); scale = 1; rotation = new Vector3f(0, 0, 0); } public GameItem(Mesh mesh) { this(); this.meshes = new Mesh[]{mesh}; } public GameItem(Mesh[] meshes) { this(); this.meshes = meshes; } public Vector3f getPosition() { return position; } public void setPosition(float x, float y, float z) { this.position.x = x; this.position.y = y; this.position.z = z; } public float getScale() { return scale; } public void setScale(float scale) { this.scale = scale; } public Vector3f getRotation() { return rotation; } public void setRotation(float x, float y, float z) { this.rotation.x = x; this.rotation.y = y; this.rotation.z = z; } public Mesh getMesh() { return meshes[0]; } public Mesh[] getMeshes() { return meshes; } public void setMeshes(Mesh[] meshes) { this.meshes = meshes; } public void setMesh(Mesh mesh) { if (this.meshes != null) { for (Mesh currMesh : meshes) { currMesh.cleanUp(); } } this.meshes = new Mesh[]{mesh}; } } \u901a\u8fc7\u4e0a\u8ff0\u4fee\u6539\uff0c\u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u7f16\u5199 MD5Loader \u7c7b\u7684\u5185\u5bb9\u3002\u8be5\u7c7b\u5c06\u6709\u4e00\u4e2a\u540d\u4e3a process \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u53d7\u4e00\u4e2a MD5Model \u5b9e\u4f8b\u548c\u4e00\u4e2a\u9ed8\u8ba4\u989c\u8272\uff08\u5bf9\u4e8e\u4e0d\u5b9a\u4e49\u7eb9\u7406\u7684\u7f51\u683c\uff09\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a GameItem \u5b9e\u4f8b\u3002\u8be5\u65b9\u6cd5\u7684\u65b9\u6cd5\u4f53\u5982\u4e0b\uff1a public static GameItem process(MD5Model md5Model, Vector4f defaultColour) throws Exception { List<MD5Mesh> md5MeshList = md5Model.getMeshes(); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh, defaultColour); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); GameItem gameItem = new GameItem(meshes); return gameItem; } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b9a\u4e49\u5728 MD5Model \u7c7b\u4e4b\u5185\u7684\u7f51\u683c\u8fdb\u884c\u904d\u5386\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528 generateMesh \u65b9\u6cd5\uff0c\u5c06\u5176\u8f6c\u6362\u4e3a org.lwjglb.engine.graph.Mesh \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u67e5\u770b\u8be5\u65b9\u6cd5\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u5185\u90e8\u7c7b\uff0c\u5b83\u5c06\u4e3a\u6211\u4eec\u6784\u5efa\u5750\u6807\u548c\u6cd5\u7ebf\u6570\u7ec4\u3002 private static class VertexInfo { public Vector3f position; public Vector3f normal; public VertexInfo(Vector3f position) { this.position = position; normal = new Vector3f(0, 0, 0); } public VertexInfo() { position = new Vector3f(); normal = new Vector3f(); } public static float[] toPositionsArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.position.x; result[i + 1] = v.position.y; result[i + 2] = v.position.z; i += 3; } return result; } public static float[] toNormalArr(List<VertexInfo> list) { int length = list != null ? list.size() * 3 : 0; float[] result = new float[length]; int i = 0; for (VertexInfo v : list) { result[i] = v.normal.x; result[i + 1] = v.normal.y; result[i + 2] = v.normal.z; i += 3; } return result; } } \u56de\u5230 generateMesh \u65b9\u6cd5\uff0c\u9996\u5148\u6211\u4eec\u5f97\u5230\u5173\u8282\u7684\u7f51\u683c\u9876\u70b9\u4fe1\u606f\u3001\u6743\u91cd\u548c\u7ed3\u6784\u3002 private static Mesh generateMesh(MD5Model md5Model, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { List<VertexInfo> vertexInfoList = new ArrayList<>(); List<Float> textCoords = new ArrayList<>(); List<Integer> indices = new ArrayList<>(); List<MD5Mesh.MD5Vertex> vertices = md5Mesh.getVertices(); List<MD5Mesh.MD5Weight> weights = md5Mesh.getWeights(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); \u63a5\u4e0b\u6765\u6211\u4eec\u9700\u8981\u6839\u636e\u5305\u542b\u5728\u6743\u91cd\u548c\u5173\u8282\u4e2d\u7684\u4fe1\u606f\u6765\u8ba1\u7b97\u9876\u70b9\u4f4d\u7f6e\u3002\u8fd9\u662f\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\u7684\uff1a for (MD5Mesh.MD5Vertex vertex : vertices) { Vector3f vertexPos = new Vector3f(); Vector2f vertexTextCoords = vertex.getTextCoords(); textCoords.add(vertexTextCoords.x); textCoords.add(vertexTextCoords.y); int startWeight = vertex.getStartWeight(); int numWeights = vertex.getWeightCount(); for (int i = startWeight; i < startWeight + numWeights; i++) { MD5Mesh.MD5Weight weight = weights.get(i); MD5JointInfo.MD5JointData joint = joints.get(weight.getJointIndex()); Vector3f rotatedPos = new Vector3f(weight.getPosition()).rotate(joint.getOrientation()); Vector3f acumPos = new Vector3f(joint.getPosition()).add(rotatedPos); acumPos.mul(weight.getBias()); vertexPos.add(acumPos); } vertexInfoList.add(new VertexInfo(vertexPos)); } \u8ba9\u6211\u4eec\u6765\u770b\u770b\u5728\u8fd9\u91cc\u505a\u4e86\u4ec0\u4e48\u3002\u6211\u4eec\u904d\u5386\u4e86\u9876\u70b9\u4fe1\u606f\u5e76\u5c06\u7eb9\u7406\u5750\u6807\u50a8\u5b58\u5728\u5217\u8868\u4e2d\uff0c\u4e0d\u9700\u8981\u5728\u8fd9\u91cc\u5e94\u7528\u4efb\u4f55\u53d8\u6362\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230\u4e86\u8ba1\u7b97\u9876\u70b9\u5750\u6807\u6240\u9700\u8003\u8651\u7684\u8d77\u59cb\u6743\u91cd\u548c\u603b\u6743\u91cd\u3002 \u9876\u70b9\u5750\u6807\u662f\u901a\u8fc7\u4f7f\u7528\u6240\u6709\u4e0e\u4e4b\u76f8\u5173\u7684\u6743\u91cd\u6765\u8ba1\u7b97\u7684\u3002\u6bcf\u4e2a\u6743\u91cd\u90fd\u6709\u4e00\u4e2a\u5750\u6807\u548c\u4e00\u4e2a\u504f\u501a\u3002\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u6240\u6709\u504f\u501a\u4e4b\u548c\u5fc5\u987b\u4e3a1.0\u3002\u6bcf\u4e2a\u6743\u91cd\u4e5f\u6709\u4e00\u4e2a\u5728\u5173\u8282\u7684\u5c40\u90e8\u7a7a\u95f4\u4e2d\u5b9a\u4e49\u7684\u5750\u6807\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u4f7f\u7528\u5173\u8282\u7684\u65b9\u5411\u548c\u5750\u6807\uff08\u5c31\u50cf\u5b83\u662f\u4e00\u4e2a\u8f6c\u6362\u77e9\u9635\u90a3\u6837\uff09\u5c06\u5176\u8f6c\u6362\u4e3a\u5b83\u6240\u5f15\u7528\u7684\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u3002 \u7efc\u4e0a\u6240\u8ff0\uff0c\u9876\u70b9\u5750\u6807\u53ef\u4ee5\u7528\u5982\u4e0b\u516c\u5f0f\u8868\u793a\uff1a Vpos = \\sum\\limits_{i=ws}^{ws + wc} (Jt_{i} \\times Wp_{i}) \\dot Wb_{i} \u53c2\u6570\uff1a \u4ece ws \uff08\u8d77\u59cb\u6743\u91cd\uff09\u5230 wc \uff08\u6743\u91cd\u6570\uff09\u6743\u91cd\u603b\u548c\u3002 Jt_{i} \u662f\u4e0e\u6743\u91cd W_{i} \u76f8\u5173\u7684\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Wp_{i} \u662f\u6743\u91cd\u5750\u6807\u3002 Wb_{i} \u662f\u6743\u91cd\u504f\u501a\u3002 \u8be5\u65b9\u7a0b\u662f\u5728\u5faa\u73af\u4f53\u4e2d\u5b9e\u73b0\u7684\uff08\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u77e9\u9635\uff0c\u4f46\u7ed3\u679c\u662f\u76f8\u540c\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u6709\u5355\u72ec\u7684\u5173\u8282\u5750\u6807\u548c\u65cb\u8f6c\uff09\u3002 \u4f7f\u7528\u4e0a\u8ff0\u4ee3\u7801\uff0c\u6211\u4eec\u5c31\u80fd\u591f\u6784\u9020\u5750\u6807\u548c\u7eb9\u7406\u5750\u6807\u6570\u636e\uff0c\u4f46\u662f\u4ecd\u7136\u9700\u8981\u5efa\u7acb\u7d22\u5f15\u548c\u6cd5\u7ebf\u3002\u7d22\u5f15\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e09\u89d2\u5f62\u7684\u4fe1\u606f\u8ba1\u7b97\uff0c\u53ea\u9700\u904d\u5386\u5305\u542b\u8fd9\u4e9b\u4e09\u89d2\u5f62\u7684\u5217\u8868\u5373\u53ef\u3002 \u6cd5\u7ebf\u4e5f\u53ef\u4ee5\u7528\u4e09\u89d2\u5f62\u4fe1\u606f\u6765\u8ba1\u7b97\uff0c\u4ee4 V_{0} \u3001 V_{1} \u548c V_{2} \u4e3a\u4e09\u89d2\u5f62\u9876\u70b9\uff08\u5728\u7269\u4f53\u7684\u6a21\u578b\u7a7a\u95f4\u4e2d\uff09\u3002\u4e09\u89d2\u5f62\u7684\u6cd5\u7ebf\u53ef\u4ee5\u6839\u636e\u5982\u4e0b\u516c\u5f0f\u8ba1\u7b97\uff1a N=(V_{2}-V_{0})\\times(V_{1}-V_{0}) \u5176\u4e2dN\u5e94\u8be5\u5f52\u4e00\u5316\u3002\u4e0b\u56fe\u662f\u4e0a\u8ff0\u516c\u5f0f\u7684\u51e0\u4f55\u89e3\u91ca\uff1a \u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u901a\u8fc7\u5b83\u6240\u5c5e\u7684\u4e09\u89d2\u5f62\u7684\u6240\u6709\u6cd5\u7ebf\u7684\u5f52\u4e00\u5316\u4e4b\u548c\u6765\u8ba1\u7b97\u5b83\u7684\u6cd5\u7ebf\u3002\u8fdb\u884c\u8ba1\u7b97\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a for (MD5Mesh.MD5Triangle tri : md5Mesh.getTriangles()) { indices.add(tri.getVertex0()); indices.add(tri.getVertex1()); indices.add(tri.getVertex2()); // \u6cd5\u7ebf VertexInfo v0 = vertexInfoList.get(tri.getVertex0()); VertexInfo v1 = vertexInfoList.get(tri.getVertex1()); VertexInfo v2 = vertexInfoList.get(tri.getVertex2()); Vector3f pos0 = v0.position; Vector3f pos1 = v1.position; Vector3f pos2 = v2.position; Vector3f normal = (new Vector3f(pos2).sub(pos0)).cross(new Vector3f(pos1).sub(pos0)); v0.normal.add(normal); v1.normal.add(normal); v2.normal.add(normal); } // \u4e00\u65e6\u5b8c\u6210\u4e86\u8ba1\u7b97\uff0c\u5c31\u5c06\u7ed3\u679c\u5f52\u4e00\u5316 for(VertexInfo v : vertexInfoList) { v.normal.normalize(); } \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u5c06\u5217\u8868\u8f6c\u6362\u4e3a\u6570\u7ec4\u5e76\u5904\u7406\u7eb9\u7406\u4fe1\u606f\u3002 float[] positionsArr = VertexInfo.toPositionsArr(vertexInfoList); float[] textCoordsArr = Utils.listToArray(textCoords); float[] normalsArr = VertexInfo.toNormalArr(vertexInfoList); int[] indicesArr = indices.stream().mapToInt(i -> i).toArray(); Mesh mesh = new Mesh(positionsArr, textCoordsArr, normalsArr, indicesArr); return mesh; } \u56de\u5230 process \u65b9\u6cd5\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u6709\u4e2a\u540d\u4e3a handleTexture \u7684\u65b9\u6cd5\uff0c\u5b83\u8d1f\u8d23\u52a0\u8f7d\u7eb9\u7406\u3002\u8fd9\u5c31\u662f\u8be5\u65b9\u6cd5\u7684\u5b9a\u4e49\uff1a private static void handleTexture(Mesh mesh, MD5Mesh md5Mesh, Vector4f defaultColour) throws Exception { String texturePath = md5Mesh.getTexture(); if (texturePath != null && texturePath.length() > 0) { Texture texture = new Texture(texturePath); Material material = new Material(texture); // \u5904\u7406\u6cd5\u7ebf\u56fe int pos = texturePath.lastIndexOf(\".\"); if (pos > 0) { String basePath = texturePath.substring(0, pos); String extension = texturePath.substring(pos, texturePath.length()); String normalMapFileName = basePath + NORMAL_FILE_SUFFIX + extension; if (Utils.existsResourceFile(normalMapFileName)) { Texture normalMap = new Texture(normalMapFileName); material.setNormalMap(normalMap); } } mesh.setMaterial(material); } else { mesh.setMaterial(new Material(defaultColour, 1)); } } \u975e\u5e38\u76f4\u63a5\u7684\u5b9e\u73b0\u3002\u552f\u4e00\u7684\u72ec\u7279\u4e4b\u5904\u5728\u4e8e\u5982\u679c\u4e00\u4e2a\u7f51\u683c\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a\u201ctexture.png\u201d\u7684\u7eb9\u7406\uff0c\u5b83\u7684\u6cd5\u7ebf\u7eb9\u7406\u56fe\u5c06\u5728\u6587\u4ef6\u201ctexture_normal.png\u201d\u4e2d\u5b9a\u4e49\u3002\u6211\u4eec\u9700\u8981\u68c0\u67e5\u8be5\u6587\u4ef6\u662f\u5426\u5b58\u5728\u5e76\u76f8\u5e94\u5730\u52a0\u8f7d\u5b83\u3002 \u6211\u4eec\u73b0\u5728\u53ef\u4ee5\u52a0\u8f7d\u4e00\u4e2aMD5\u6587\u4ef6\u5e76\u50cf\u6e32\u67d3\u5176\u4ed6\u6e38\u620f\u9879\u4e00\u6837\u6e32\u67d3\u5b83\uff0c\u4f46\u5728\u6b64\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u7981\u7528\u9762\u5254\u9664\u6765\u6b63\u786e\u6e32\u67d3\u5b83\uff0c\u56e0\u4e3a\u4e0d\u662f\u6240\u6709\u4e09\u89d2\u5f62\u90fd\u5c06\u7ed8\u5236\u5728\u6b63\u786e\u7684\u65b9\u5411\u4e0a\u3002\u6211\u4eec\u5c06\u5411 Window \u7c7b\u6dfb\u52a0\u652f\u6301\uff0c\u4ee5\u4fbf\u5728\u8fd0\u884c\u65f6\u8bbe\u7f6e\u8fd9\u4e9b\u53c2\u6570\uff08\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5176\u53d8\u66f4\uff09\u3002 \u5982\u679c\u52a0\u8f7d\u4e00\u4e9b\u5b9e\u4f8b\u6a21\u578b\uff0c\u5c31\u4f1a\u5f97\u5230\u7c7b\u4f3c\u8fd9\u6837\u7684\u7ed3\u679c\uff1a \u4f60\u5728\u6b64\u5904\u770b\u5230\u7684\u662f\u7ed1\u5b9a\u7684\u59ff\u52bf\uff0c\u5b83\u662fMD5\u6a21\u578b\u7684\u9759\u6001\u5c55\u793a\uff0c\u4f7f\u52a8\u753b\u5e08\u8f7b\u677e\u5730\u5bf9\u5b83\u4eec\u5efa\u6a21\u3002\u4e3a\u4e86\u8ba9\u52a8\u753b\u5de5\u4f5c\uff0c\u6211\u4eec\u5fc5\u987b\u5904\u7406\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u3002","title":"\u5f15\u8a00"},{"location":"19-animations/#_2","text":"MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\uff0c\u5c31\u50cf\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u90a3\u6837\uff0c\u7531\u4e00\u4e2a\u5934\u548c\u4e00\u4e2a\u5305\u542b\u5728\u5927\u62ec\u53f7\u4e4b\u95f4\u7684\u4e0d\u540c\u90e8\u5206\u7ec4\u6210\u3002\u5982\u679c\u6253\u5f00\u5176\u4e2d\u4e00\u4e2a\u6587\u4ef6\uff0c\u53ef\u4ee5\u770b\u5230\u7c7b\u4f3c\u7684\u7ed3\u6784\u3002 \u53ef\u4ee5\u5728\u52a8\u753b\u6587\u4ef6\u4e2d\u627e\u5230\u7684\u7b2c\u4e00\u4e2a\u7ed3\u6784\uff08\u5c31\u50cf\u662f\u7f51\u683c\u5b9a\u4e49\u6587\u4ef6\u4e00\u6837\uff09\u662f\u5934\u3002\u4f60\u53ef\u4ee5\u4ece\u63a5\u4e0b\u6765\u63d0\u4f9b\u7684\u4e00\u4e2a\u4f8b\u5b50\u4e2d\u770b\u5230\u5934\u7684\u5185\u5bb9\uff1a MD5Version 10 commandline \"\" numFrames 140 numJoints 33 frameRate 24 numAnimatedComponents 198 \u5934\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u6240\u7b26\u5408\u7684MD5\u89c4\u8303\u7684\u7248\u672c\u3002 \u7528\u4e8e\u751f\u6210\u6b64\u6587\u4ef6\u7684\u547d\u4ee4\uff08\u6765\u81ea3D\u5efa\u6a21\u5de5\u5177\uff09 \u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u5e27\u6570\u3002 \u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u6570\u91cf\u3002 \u5e27\u901f\u7387\uff0c\u6bcf\u79d2\u5e27\u6570\uff0c\u7528\u4e8e\u521b\u5efa\u52a8\u753b\u3002\u8fd9\u4e2a\u53c2\u6570\u53ef\u4ee5\u7528\u6765\u8ba1\u7b97\u5e27\u4e0e\u5e27\u4e4b\u95f4\u7684\u65f6\u95f4\u3002 \u6bcf\u4e2a\u5e27\u5b9a\u4e49\u7684\u5206\u91cf\u6570\u91cf\u3002\uff08\u8bd1\u6ce8\uff1a\u901a\u5e38\u60c5\u51b5\u4e0b\u7b49\u4e8e\u5173\u8282\u6570\u4e58\u4ee5\u516d\uff09 \u9996\u5148\u51fa\u73b0\u7684\u662f\u5c42\u6b21\u7ed3\u6784\uff08Hierarchy\uff09\u90e8\u5206\uff0c\u5b83\u5b9a\u4e49\u4e86\u8be5\u52a8\u753b\u7684\u5173\u8282\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4ee5\u4e0b\u7247\u6bb5\uff1a hierarchy { \"origin\" -1 0 0 // \"body\" 0 63 0 // origin ( Tx Ty Tz Qx Qy Qz ) \"body2\" 1 0 0 // body \"SPINNER\" 2 56 6 // body2 ( Qx Qy Qz ) .... } \u4e00\u4e2a\u5173\u8282\uff0c\u5728\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\uff0c\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u5173\u8282\u540d\uff0c\u5f15\u53f7\u4e4b\u95f4\u7684\u4e00\u4e2a\u6587\u672c\u5c5e\u6027 \u5173\u8282\u7684\u7236\u5173\u8282\uff0c\u4f7f\u7528\u4e00\u4e2a\u7d22\u5f15\uff0c\u8be5\u7d22\u5f15\u4f7f\u7528\u5176\u5728\u5173\u8282\u5217\u8868\u4e2d\u7684\u4f4d\u7f6e\u6307\u5411\u7236\u5173\u8282\u3002\u6839\u5173\u8282\u7684\u7236\u8282\u70b9\u7b49\u4e8e-1\u3002 \u5173\u8282\u6807\u5fd7\uff0c\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u6570\u636e\uff0c\u8bbe\u7f6e\u8be5\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u5c06\u5982\u4f55\u6539\u53d8\u3002 \u8d77\u59cb\u7d22\u5f15\uff0c\u5f53\u5e94\u7528\u6807\u5fd7\u65f6\uff0c\u7528\u4e8e\u6bcf\u5e27\u7684\u52a8\u753b\u6570\u636e\u5185\u3002 \u4e0b\u4e00\u8282\u662f\u8fb9\u754c\uff08Bounds\uff09\u3002\u672c\u8282\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u6a21\u578b\u7684\u8fb9\u754c\u6846\u3002\u5b83\u5c06\u4e3a\u6bcf\u4e00\u5e27\u52a8\u753b\u50a8\u5b58\u4e00\u884c\u6570\u636e\uff0c\u770b\u8d77\u6765\u5c31\u50cf\u662f\u8fd9\u6837\uff1a bounds { ( -24.3102264404 -44.2608566284 -0.181215778 ) ( 31.0861988068 38.7131576538 117.7417449951 ) ( -24.3102283478 -44.1887664795 -0.1794649214 ) ( 31.1800289154 38.7173080444 117.7729110718 ) ( -24.3102359772 -44.1144447327 -0.1794776917 ) ( 31.2042789459 38.7091217041 117.8352737427 ) .... } \u6bcf\u4e2a\u8fb9\u754c\u6846\u7531\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u4e24\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u5b9a\u4e49\u3002\u7b2c\u4e00\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5c0f\u503c\uff0c\u7b2c\u4e8c\u4e2a\u5411\u91cf\u5b9a\u4e49\u4e86\u6700\u5927\u503c\u3002 \u4e0b\u4e00\u8282\u662f\u57fa\u672c\u5e27\uff08Base Frame\uff09\u6570\u636e\u3002\u5728\u672c\u8282\u4e2d\uff0c\u5728\u5e94\u7528\u6bcf\u4e2a\u52a8\u753b\u5e27\u7684\u5f62\u53d8\u4e4b\u524d\uff0c\u8bbe\u7f6e\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u4e0b\u9762\u7684\u7247\u6bb5\uff1a baseframe { ( 0 0 0 ) ( -0.5 -0.5 -0.5 ) ( -0.8947336078 70.7142486572 -6.5027675629 ) ( -0.3258574307 -0.0083037354 0.0313780755 ) ( 0.0000001462 0.0539700091 -0.0137935728 ) ( 0 0 0 ) .... } \u6bcf\u4e00\u884c\u90fd\u4e0e\u4e00\u4e2a\u5173\u8282\u76f8\u5173\u8054\uff0c\u5e76\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5c5e\u6027\uff1a \u5173\u8282\u7684\u5750\u6807\uff0c\u662f\u4e00\u4e2a\u4e09\u5206\u91cf\u5411\u91cf\u3002 \u5173\u8282\u7684\u65b9\u5411\uff0c\u662f\u4e00\u4e2a\u56db\u5143\u6570\u7684\u4e09\u4e2a\u5206\u91cf\uff08\u6b63\u5982\u6a21\u578b\u6587\u4ef6\u91cc\u7684\u90a3\u6837\uff09\u3002 \u5728\u6b64\u4e4b\u540e\uff0c\u4f60\u5c06\u53d1\u73b0\u51e0\u4e2a\u5e27\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5206\u914d\u7ed9 numFrames \u5934\u5c5e\u6027\u7684\u503c\u3002\u6bcf\u4e2a\u5e27\u7684\u8282\u5c31\u50cf\u662f\u4e00\u4e2a\u5de8\u5927\u7684\u6d6e\u70b9\u6570\u7ec4\uff0c\u5f53\u5bf9\u6bcf\u4e2a\u5e27\u5e94\u7528\u53d8\u6362\u65f6\uff0c\u8282\u70b9\u5c06\u4f7f\u7528\u8fd9\u4e2a\u6d6e\u70b9\u6570\u7ec4\u3002\u4f60\u53ef\u4ee5\u5728\u63a5\u4e0b\u6765\u770b\u5230\u4e00\u4e2a\u7247\u6bb5\uff1a frame 1 { -0.9279100895 70.682762146 -6.3709330559 -0.3259022534 -0.0100501738 0.0320306309 0.3259022534 0.0100501738 -0.0320306309 -0.1038384438 -0.1639953405 -0.0152553488 0.0299418624 .... } \u89e3\u6790MD5\u52a8\u753b\u6587\u4ef6\u7684\u57fa\u7c7b\u540d\u4e3a MD5AnimModel \u3002\u8be5\u7c7b\u521b\u5efa\u7531\u8be5\u6587\u4ef6\u5185\u5bb9\u6620\u5c04\u7684\u6240\u6709\u5bf9\u8c61\u5c42\u6b21\u7ed3\u6784\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4ee5\u83b7\u5f97\u8be6\u7ec6\u4fe1\u606f\u3002\u7ed3\u6784\u7c7b\u4f3c\u4e8eMD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u3002\u73b0\u5728\u6211\u4eec\u80fd\u591f\u52a0\u8f7d\u8fd9\u4e9b\u6570\u636e\uff0c\u5e76\u5c06\u4f7f\u7528\u5b83\u6765\u751f\u6210\u52a8\u753b\u3002 \u6211\u4eec\u5c06\u5728\u7740\u8272\u5668\u4e2d\u751f\u6210\u52a8\u753b\uff0c\u6240\u4ee5\u4e0d\u662f\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6240\u6709\u5750\u6807\uff0c\u6211\u4eec\u9700\u8981\u51c6\u5907\u6240\u9700\u7684\u6570\u636e\uff0c\u8fd9\u6837\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u5c31\u53ef\u4ee5\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\u4e2d\u7684 process \u65b9\u6cd5\uff0c\u9700\u8981\u4fee\u6539\u5b83\u4ee5\u8003\u8651\u52a8\u753b\u6570\u636e\u3002\u65b0\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public static AnimGameItem process(MD5Model md5Model, MD5AnimModel animModel, Vector4f defaultColour) throws Exception { List<Matrix4f> invJointMatrices = calcInJointMatrices(md5Model); List<AnimatedFrame> animatedFrames = processAnimationFrames(md5Model, animModel, invJointMatrices); List<Mesh> list = new ArrayList<>(); for (MD5Mesh md5Mesh : md5Model.getMeshes()) { Mesh mesh = generateMesh(md5Model, md5Mesh); handleTexture(mesh, md5Mesh, defaultColour); list.add(mesh); } Mesh[] meshes = new Mesh[list.size()]; meshes = list.toArray(meshes); AnimGameItem result = new AnimGameItem(meshes, animatedFrames, invJointMatrices); return result; } \u8fd9\u91cc\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u6700\u660e\u663e\u7684\u662f\u8be5\u65b9\u6cd5\u73b0\u5728\u63a5\u6536\u4e00\u4e2a MD5AnimModel \u5b9e\u4f8b\u3002\u6b64\u5916\uff0c\u6211\u4eec\u4e0d\u8fd4\u56de GameItem \u5b9e\u4f8b\uff0c\u800c\u662f\u8fd4\u56de AnimGameItem \u5b9e\u4f8b\u3002\u8be5\u7c7b\u7ee7\u627f\u81ea GameItem \u7c7b\uff0c\u4f46\u6dfb\u52a0\u4e86\u5bf9\u52a8\u753b\u7684\u652f\u6301\u3002\u7a0d\u540e\u6211\u4eec\u5c06\u770b\u5230\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002 \u5982\u679c\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb\u8be5\u5904\u7406\u65b9\u6cd5\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u8c03\u7528 calcInJointMatrices \u65b9\u6cd5\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private static List<Matrix4f> calcInJointMatrices(MD5Model md5Model) { List<Matrix4f> result = new ArrayList<>(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); for(MD5JointInfo.MD5JointData joint : joints) { Matrix4f translateMat = new Matrix4f().translate(joint.getPosition()); Matrix4f rotationMat = new Matrix4f().rotate(joint.getOrientation()); Matrix4f mat = translateMat.mul(rotationMat); mat.invert(); result.add(mat); } return result; } \u8be5\u65b9\u6cd5\u904d\u5386MD5\u6a21\u578b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5305\u542b\u7684\u8282\u70b9\uff0c\u8ba1\u7b97\u4e0e\u6bcf\u4e2a\u8282\u70b9\u76f8\u5173\u8054\u7684\u8f6c\u6362\u77e9\u9635\uff0c\u7136\u540e\u5f97\u5230\u8fd9\u4e9b\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u6b64\u6570\u636e\u7528\u4e8e\u6784\u9020 AnimGameItem \u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u9605\u8bfb process \u65b9\u6cd5\uff0c\u63a5\u4e0b\u6765\u8981\u505a\u7684\u662f\u8c03\u7528 processAnimationFrames \u65b9\u6cd5\u6765\u5904\u7406\u52a8\u753b\u5e27\uff1a private static List<AnimatedFrame> processAnimationFrames(MD5Model md5Model, MD5AnimModel animModel, List<Matrix4f> invJointMatrices) { List<AnimatedFrame> animatedFrames = new ArrayList<>(); List<MD5Frame> frames = animModel.getFrames(); for(MD5Frame frame : frames) { AnimatedFrame data = processAnimationFrame(md5Model, animModel, frame, invJointMatrices); animatedFrames.add(data); } return animatedFrames; } \u8be5\u65b9\u6cd5\u5904\u7406MD5\u52a8\u753b\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u5e76\u8fd4\u56de\u4e00\u4e2a AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\u3002\u771f\u6b63\u7684\u5de5\u4f5c\u662f\u5728 processAnimationFrame \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8ba9\u6211\u6765\u89e3\u91ca\u4e00\u4e0b\u8fd9\u4e2a\u65b9\u6cd5\u7684\u4f5c\u7528\u3002 \u9996\u5148\uff0c\u904d\u5386MD5\u52a8\u753b\u6587\u4ef6\u7684\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u5b9a\u4e49\u7684\u5173\u8282\u3002 private static AnimatedFrame processAnimationFrame(MD5Model md5Model, MD5AnimModel animModel, MD5Frame frame, List<Matrix4f> invJointMatrices) { AnimatedFrame result = new AnimatedFrame(); MD5BaseFrame baseFrame = animModel.getBaseFrame(); List<MD5Hierarchy.MD5HierarchyData> hierarchyList = animModel.getHierarchy().getHierarchyDataList(); List<MD5JointInfo.MD5JointData> joints = md5Model.getJointInfo().getJoints(); int numJoints = joints.size(); float[] frameData = frame.getFrameData(); for (int i = 0; i < numJoints; i++) { MD5JointInfo.MD5JointData joint = joints.get(i); \u6211\u4eec\u5f97\u5230\u4e0e\u6bcf\u4e2a\u5173\u8282\u76f8\u5173\u8054\u7684\u57fa\u672c\u5e27\u5143\u7d20\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\u3002 MD5BaseFrame.MD5BaseFrameData baseFrameData = baseFrame.getFrameDataList().get(i); Vector3f position = baseFrameData.getPosition(); Quaternionf orientation = baseFrameData.getOrientation(); \u539f\u5219\u4e0a\uff0c\u8be5\u6570\u636e\u5e94\u5206\u914d\u7ed9\u5173\u8282\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u4f46\u5b83\u9700\u8981\u6839\u636e\u5173\u8282\u7684\u6807\u5fd7\u8fdb\u884c\u8f6c\u6362\u3002\u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\uff0c\u5728\u5c55\u793a\u52a8\u753b\u6587\u4ef6\u7684\u7ed3\u6784\u65f6\uff0c\u5c42\u6b21\u7ed3\u6784\u90e8\u5206\u4e2d\u7684\u6bcf\u4e2a\u8282\u70b9\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6807\u5fd7\u3002\u8be5\u6807\u5fd7\u6839\u636e\u6bcf\u4e2a\u52a8\u753b\u5e27\u4e2d\u5b9a\u4e49\u7684\u4fe1\u606f\u51b3\u5b9a\u5efa\u6a21\u4f4d\u7f6e\u548c\u65b9\u5411\u5e94\u8be5\u5982\u4f55\u66f4\u6539\u3002 \u5982\u679c\u6807\u5fd7\u5b57\u6bb5\u7684\u7b2c\u4e00\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u4f7f\u7528\u6b63\u5728\u5904\u7406\u7684\u52a8\u753b\u5e27\u4e2d\u5305\u542b\u7684\u6570\u636e\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684x\u5206\u91cf\u3002\u52a8\u753b\u5e27\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6d6e\u70b9\u6570\u7ec4\uff0c\u6240\u4ee5\u6211\u4eec\u5e94\u8be5\u53d6\u54ea\u4e2a\u5143\u7d20\u5462\uff1f\u7b54\u6848\u4e5f\u5728\u5173\u8282\u5b9a\u4e49\u4e2d\uff0c\u5176\u4e2d\u5305\u542b startIndex \u5c5e\u6027\u3002\u5982\u679c\u6807\u5fd7\u7684\u7b2c\u4e8c\u4e2a\u4f4d\u7b49\u4e8e1\uff0c\u6211\u4eec\u5e94\u8be5\u7528 startIndex + 1 \u7684\u503c\u66f4\u6539\u57fa\u672c\u5e27\u5750\u6807\u7684y\u5206\u91cf\uff0c\u4ee5\u6b64\u7c7b\u63a8\uff0c\u63a5\u4e0b\u6765\u7684\u662f\u5750\u6807\u7684z\u5206\u91cf\uff0c\u4ee5\u53ca\u65b9\u5411\u7684x\u3001y\u548cz\u5206\u91cf\u3002 int flags = hierarchyList.get(i).getFlags(); int startIndex = hierarchyList.get(i).getStartIndex(); if ( (flags & 1 ) > 0) { position.x = frameData[startIndex++]; } if ( (flags & 2) > 0) { position.y = frameData[startIndex++]; } if ( (flags & 4) > 0) { position.z = frameData[startIndex++]; } if ( (flags & 8) > 0) { orientation.x = frameData[startIndex++]; } if ( (flags & 16) > 0) { orientation.y = frameData[startIndex++]; } if ( (flags & 32) > 0) { orientation.z = frameData[startIndex++]; } // \u66f4\u65b0\u56db\u5143\u6570\u7684w\u5206\u91cf orientation = MD5Utils.calculateQuaternion(orientation.x, orientation.y, orientation.z); \u73b0\u5728\u6211\u4eec\u6709\u4e86\u8ba1\u7b97\u53d8\u6362\u77e9\u9635\u6240\u9700\u7684\u6240\u6709\u6570\u636e\uff0c\u4ece\u800c\u5f97\u5230\u5f53\u524d\u52a8\u753b\u5e27\u7684\u6bcf\u4e2a\u5173\u8282\u7684\u6700\u7ec8\u4f4d\u7f6e\u3002\u4f46\u662f\u6211\u4eec\u5fc5\u987b\u8003\u8651\u53e6\u4e00\u4ef6\u4e8b\uff0c\u6bcf\u4e2a\u5173\u8282\u7684\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5b83\u7684\u7236\u5173\u8282\u7684\u4f4d\u7f6e\u7684\uff0c\u6240\u4ee5\u6211\u4eec\u9700\u8981\u5f97\u5230\u4e0e\u6bcf\u4e2a\u7236\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u5e76\u7528\u5b83\u6765\u5f97\u5230\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u4e2d\u7684\u53d8\u6362\u77e9\u9635\u3002 // \u8ba1\u7b97\u8fd9\u4e2a\u5173\u8282\u7684\u5e73\u79fb\u548c\u65cb\u8f6c\u77e9\u9635 Matrix4f translateMat = new Matrix4f().translate(position); Matrix4f rotationMat = new Matrix4f().rotate(orientation); Matrix4f jointMat = translateMat.mul(rotationMat); // \u5173\u8282\u4f4d\u7f6e\u662f\u76f8\u5bf9\u4e8e\u5173\u8282\u7684\u7236\u7d22\u5f15\u7684\u4f4d\u7f6e\u3002 // \u4f7f\u7528\u7236\u77e9\u9635\u5c06\u5176\u8f6c\u6362\u4e3a\u6a21\u578b\u7a7a\u95f4\u3002 if ( joint.getParentIndex() > -1 ) { Matrix4f parentMatrix = result.getLocalJointMatrices()[joint.getParentIndex()]; jointMat = new Matrix4f(parentMatrix).mul(jointMat); } result.setMatrix(i, jointMat, invJointMatrices.get(i)); } return result; } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u521b\u5efa\u4e86 AnimatedFrame \u7c7b\u7684\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u8be5\u7c7b\u5305\u542b\u5c06\u5728\u52a8\u753b\u671f\u95f4\u4f7f\u7528\u7684\u6570\u636e\u3002\u8fd9\u4e2a\u7c7b\u4e5f\u4f7f\u7528\u9006\u77e9\u9635\uff0c\u7a0d\u540e\u6211\u4eec\u4f1a\u77e5\u9053\u4e3a\u4ec0\u4e48\u8fd9\u6837\u505a\u3002\u9700\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c AnimatedFrame \u7684 setMatrix \u65b9\u6cd5\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff1a public void setMatrix(int pos, Matrix4f localJointMatrix, Matrix4f invJointMatrix) { localJointMatrices[pos] = localJointMatrix; Matrix4f mat = new Matrix4f(localJointMatrix); mat.mul(invJointMatrix); jointMatrices[pos] = mat; } \u53d8\u91cf localJointMatrix \u50a8\u5b58\u5f53\u524d\u5e27\u4e2d\u5360\u636e\u4f4d\u7f6e\u201ci\u201d\u7684\u5173\u8282\u7684\u65cb\u8f6c\u77e9\u9635\uff0c invJointMatrix \u6301\u6709\u5360\u636e\u7ed1\u5b9a\u59ff\u52bf\u4f4d\u7f6e\u201ci\u201d\u4f4d\u7f6e\u7684\u5173\u8282\u7684\u9006\u53d8\u6362\u77e9\u9635\u3002\u6211\u4eec\u50a8\u5b58\u4e86 localJointMatrix \u4e0e invJointMatrix \u77e9\u9635\u76f8\u4e58\u7684\u7ed3\u679c\u3002\u8fd9\u4e2a\u7ed3\u679c\u5c06\u5728\u7a0d\u540e\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u5750\u6807\u3002\u6211\u4eec\u8fd8\u50a8\u5b58\u4e86\u539f\u59cb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\uff0c\u53d8\u91cf localJointMatrix \uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u7528\u5b83\u6765\u8ba1\u7b97\u5b50\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u8ba9\u6211\u4eec\u56de\u5230 MD5Loader \u7c7b\uff0c generateMesh \u65b9\u6cd5\u4e5f\u53d1\u751f\u4e86\u53d8\u5316\uff0c\u5982\u6211\u4eec\u4e4b\u524d\u8bf4\u660e\u7684\u90a3\u6837\u8ba1\u7b97\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u4f46\u5bf9\u4e8e\u6bcf\u4e2a\u9876\u70b9\uff0c\u6211\u4eec\u50a8\u5b58\u4e24\u4e2a\u6570\u7ec4\uff1a \u4e00\u4e2a\u6570\u7ec4\uff0c\u50a8\u5b58\u7740\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u504f\u501a\u3002 \u4e00\u4e2a\u8f93\u51fa\uff0c\u50a8\u5b58\u8fd9\u4e0e\u8be5\u9876\u70b9\u76f8\u5173\u7684\u5173\u8282\u7d22\u5f15\uff08\u901a\u8fc7\u6743\u91cd\uff09\u3002 \u6211\u4eec\u5c06\u8fd9\u4e9b\u6570\u7ec4\u7684\u5927\u5c0f\u9650\u5236\u4e3a4\u3002 Mesh \u7c7b\u4e5f\u88ab\u4fee\u6539\u4e3a\u63a5\u6536\u8fd9\u4e9b\u53c2\u6570\uff0c\u5e76\u5c06\u5176\u5305\u542b\u5728\u7740\u8272\u5668\u5904\u7406\u7684VAO\u6570\u636e\u4e2d\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u8be6\u7ec6\u5185\u5bb9\uff0c\u4f46\u6765\u56de\u987e\u4e00\u4e0b\u6211\u4eec\u6240\u505a\u7684\uff1a \u6211\u4eec\u4ecd\u5728\u52a0\u8f7d\u7ed1\u5b9a\u59ff\u52bf\uff0c\u901a\u8fc7\u6743\u91cd\u6570\u636e\u8ba1\u7b97\u51fa\u5b83\u4eec\u7684\u6700\u7ec8\u4f4d\u7f6e\uff0c\u5373\u5173\u8282\u5750\u6807\u548c\u65b9\u5411\u7684\u603b\u548c\u3002 \u8fd9\u4e9b\u6570\u636e\u4ee5VBO\u7684\u5f62\u5f0f\u52a0\u8f7d\u5230\u7740\u8272\u5668\u4e2d\uff0c\u4f46\u662f\u5b83\u7531\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6743\u91cd\u7684\u504f\u501a\u548c\u5f71\u54cd\u5b83\u7684\u5173\u8282\u7684\u7d22\u5f15\u6765\u8865\u5145\u3002\u8fd9\u4e2a\u6570\u636e\u5bf9\u6240\u6709\u52a8\u753b\u5e27\u90fd\u662f\u901a\u7528\u7684\uff0c\u56e0\u4e3a\u5b83\u662f\u5728MD5\u5b9a\u4e49\u6587\u4ef6\u4e2d\u5b9a\u4e49\u7684\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9650\u5236\u504f\u501a\u548c\u5173\u8282\u7d22\u5f15\u6570\u7ec4\u5927\u5c0f\u7684\u539f\u56e0\uff0c\u5f53\u6a21\u578b\u88ab\u53d1\u9001\u5230GPU\u65f6\uff0c\u5b83\u4eec\u5c06\u88ab\u52a0\u8f7d\u4e3aVBO\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u52a8\u753b\u5e27\uff0c\u6211\u4eec\u6839\u636e\u57fa\u7840\u5e27\u4e2d\u5b9a\u4e49\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u50a8\u5b58\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 \u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u5b9a\u4e49\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u76f8\u5173\u7684\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u77e5\u9053\u5982\u4f55\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u5b8c\u6210\u7684\u53d8\u6362\uff0c\u7a0d\u540e\u5c06\u770b\u5230\u5982\u4f55\u5e94\u7528\u5b83\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u6709\u4e86\u62fc\u56fe\u7684\u6240\u6709\u788e\u7247\uff0c\u53ea\u9700\u8981\u5728\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u9996\u5148\u9700\u8981\u4fee\u6539\u8f93\u5165\u6570\u636e\u6765\u63a5\u6536\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u3002 #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; \u6211\u4eec\u5b9a\u4e49\u4e86\u4e24\u4e2a\u5e38\u91cf\uff1a MAX_WEIGHTS \uff0c\u5b9a\u4e49\u6743\u91cdVBO\uff08\u4e00\u4e2a\u5355\u72ec\u7684\u5173\u8282\u7d22\u5f15\uff09\u4e2d\u7684\u6743\u91cd\u7684\u6700\u5927\u6570\u91cf\u3002 MAX_JOINTS \uff0c\u5b9a\u4e49\u4e86\u6211\u4eec\u5c06\u652f\u6301\u7684\u6700\u5927\u5173\u8282\u6570\u91cf\uff08\u7a0d\u540e\u5c06\u8be6\u7ec6\u4ecb\u7ecd\uff09\u3002 \u7136\u540e\u6211\u4eec\u5b9a\u4e49\u8f93\u51fa\u6570\u636e\u548cUniform\u3002 out vec2 outTexCoord; out vec3 mvVertexNormal; out vec3 mvVertexPos; out vec4 mlightviewVertexPos; out mat4 outModelViewMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u6709\u4e00\u4e2a\u540d\u4e3a jointsMatrix \u7684\u65b0Uniform\uff0c\u5b83\u662f\u4e00\u4e2a\u77e9\u9635\u6570\u7ec4\uff08\u6700\u5927\u957f\u5ea6\u7531 MAX_JOINTS \u5e38\u91cf\u8bbe\u7f6e\uff09\u3002\u8be5\u77e9\u9635\u6570\u7ec4\u5305\u542b\u5f53\u524d\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u5173\u8282\u77e9\u9635\uff0c\u5e76\u5728\u5904\u7406\u5e27\u65f6\u5728 MD5Loader \u7c7b\u4e2d\u8ba1\u7b97\u3002\u56e0\u6b64\uff0c\u8be5\u6570\u7ec4\u5305\u542b\u9700\u8981\u5e94\u7528\u4e8e\u5f53\u524d\u52a8\u753b\u5e27\u4e2d\u6240\u6709\u5173\u8282\u7684\u53d8\u6362\uff0c\u5e76\u5c06\u4f5c\u4e3a\u8ba1\u7b97\u9876\u70b9\u6700\u7ec8\u5750\u6807\u7684\u57fa\u7840\u3002 \u4f7f\u7528VBO\u4e2d\u7684\u65b0\u6570\u636e\u548c\u8be5Uniform\uff0c\u6211\u4eec\u5c06\u53d8\u6362\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\u3002\u8fd9\u5c06\u5728\u4e0b\u8ff0\u4ee3\u7801\u5757\u4e2d\u5b8c\u6210\uff1a vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } \u9996\u5148\uff0c\u6211\u4eec\u5f97\u5230\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u904d\u5386\u4e0e\u8fd9\u4e2a\u9876\u70b9\u5173\u8054\u7684\u6743\u91cd\uff0c\u5e76\u901a\u8fc7\u4f7f\u7528\u50a8\u5b58\u5728\u8f93\u5165\u4e2d\u7684\u7d22\u5f15\uff0c\u4f7f\u7528\u8be5\u5e27\uff08\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\uff09\u7684\u6743\u91cd\u548c\u5173\u8282\u77e9\u9635\u4fee\u6539\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u7ed9\u5b9a\u4e00\u4e2a\u9876\u70b9\u5750\u6807\uff0c\u6211\u4eec\u8ba1\u7b97\u5b83\u7684\u5e27\u5750\u6807\uff1a Vfp = \\sum\\limits_{i=0}^{MAX WEIGTHS} Wb_{i} \\dot (Jfp_{i} \\times Jt^{-1}_{i}) \\times Vpos \u53c2\u6570\uff1a Wfvp \u662f\u9876\u70b9\u7684\u6700\u7ec8\u5750\u6807\u3002 Wb \u662f\u9876\u70b9\u7684\u6743\u91cd\u3002 Jfp \u662f\u8fd9\u4e2a\u5750\u6807\u7cfb\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u3002 Jt^{-1} \u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u9006\u77e9\u9635\u3002\u8fd9\u4e2a\u77e9\u9635\u4e0e Jfp \u7684\u6210\u7ee9\u50a8\u5b58\u5728 jointsMatrix Uniform\u4e2d\u3002 Vpos \u662f\u7ed1\u5b9a\u59ff\u52bf\u4e2d\u7684\u9876\u70b9\u5750\u6807\u3002 Vpos \u7531 Jt \u77e9\u9635\u8ba1\u7b97\uff0c\u8fd9\u662f\u7ed1\u5b9a\u59ff\u52bf\u7684\u5173\u8282\u53d8\u6362\u77e9\u9635\u7684\u77e9\u9635\u3002\u6240\u4ee5\uff0c\u6700\u540e\u6211\u4eec\u8981\u64a4\u9500\u7ed1\u5b9a\u59ff\u52bf\u7684\u4fee\u6539\u6765\u5e94\u7528\u8be5\u5750\u6807\u7cfb\u7684\u53d8\u6362\u3002\u8fd9\u5c31\u662f\u6211\u4eec\u9700\u8981\u9006\u7ed1\u5b9a\u59ff\u52bf\u77e9\u9635\u7684\u539f\u56e0\u3002 \u7740\u8272\u5668\u652f\u6301\u6743\u91cd\u53ef\u53d8\u7684\u9876\u70b9\uff0c\u6700\u591a\u53ef\u8fbe4\u4e2a\uff0c\u8fd8\u53ef\u4ee5\u6e32\u67d3\u975e\u52a8\u753b\u9879\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6743\u91cd\u7b49\u4e8e0\u6211\u4eec\u5c06\u5f97\u5230\u539f\u59cb\u5750\u6807\u3002 \u7740\u8272\u5668\u7684\u5176\u4f59\u90e8\u5206\u6216\u591a\u6216\u5c11\u4fdd\u6301\u4e0d\u53d8\uff0c\u6211\u4eec\u53ea\u662f\u4f7f\u7528\u66f4\u65b0\u540e\u7684\u5750\u6807\u5e76\u4f20\u9012\u7247\u5143\u7740\u8272\u5668\u8981\u4f7f\u7528\u7684\u6b63\u786e\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * vec4(vertexNormal, 0.0)).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * modelLightViewMatrix * vec4(position, 1.0); outModelViewMatrix = modelViewMatrix; } \u6240\u4ee5\uff0c\u4e3a\u4e86\u6d4b\u8bd5\u52a8\u753b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5c06 jointsMatrix \u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u7531\u4e8e\u6b64\u4fe1\u606f\u4ec5\u50a8\u5b58\u5728 AnimGameItem \u5b9e\u4f8b\u4e2d\uff0c\u56e0\u6b64\u4ee3\u7801\u975e\u5e38\u7b80\u5355\u3002\u5728\u6e32\u67d3\u7f51\u683c\u7684\u5faa\u73af\u4e2d\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86\u5982\u4e0b\u4ee3\u7801\u7247\u6bb5\uff1a if ( gameItem instanceof AnimGameItem ) { AnimGameItem animGameItem = (AnimGameItem)gameItem; AnimatedFrame frame = animGameItem.getCurrentFrame(); sceneShaderProgram.setUniform(\"jointsMatrix\", frame.getJointMatrices()); } \u5f53\u7136\uff0c\u5728\u4f7f\u7528\u5b83\u4e4b\u524d\uff0c\u4f60\u9700\u8981\u521b\u5efaUniform\uff0c\u4f60\u53ef\u4ee5\u67e5\u770b\u8be5\u7c7b\u7684\u6e90\u4ee3\u7801\u3002\u5982\u679c\u8fd0\u884c\u8fd9\u4e2a\u793a\u4f8b\uff0c\u4f60\u5c06\u80fd\u591f\u901a\u8fc7\u6309\u4e0b\u7a7a\u683c\u952e\u6765\u67e5\u770b\u6a21\u578b\u662f\u5982\u4f55\u52a8\u8d77\u6765\u7684\uff08\u6bcf\u6b21\u6309\u4e0b\u8fd9\u4e2a\u952e\uff0c\u90fd\u4f1a\u8bbe\u7f6e\u4e00\u4e2a\u65b0\u7684\u5e27\uff0c\u5e76\u4e14 jointsMatrix Uniform\u4f1a\u53d1\u751f\u53d8\u5316\uff09\u3002 \u4f60\u5c06\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u867d\u7136\u52a8\u753b\u5f88\u6d41\u7545\uff0c\u4f46\u793a\u4f8b\u8fd8\u662f\u5b58\u5728\u4e00\u4e9b\u95ee\u9898\u3002\u9996\u5148\uff0c\u5149\u7167\u6ca1\u6709\u6b63\u5e38\u7684\u5de5\u4f5c\uff0c\u9634\u5f71\u8868\u73b0\u7684\u662f\u7ed1\u5b9a\u59ff\u52bf\uff0c\u800c\u4e0d\u662f\u5f53\u524d\u5e27\u3002\u6211\u4eec\u73b0\u5728\u5c06\u89e3\u51b3\u6240\u6709\u8fd9\u4e9b\u95ee\u9898\u3002","title":"\u6a21\u578b\u52a8\u753b"},{"location":"19-animations/#_3","text":"\u7b2c\u4e00\u4e2a\u8981\u89e3\u51b3\u7684\u95ee\u9898\u662f\u5149\u7167\u95ee\u9898\u3002\u4f60\u53ef\u80fd\u5df2\u7ecf\u6ce8\u610f\u5230\u8fd9\u79cd\u60c5\u51b5\u4e86\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u6ca1\u6709\u53d8\u6362\u6cd5\u7ebf\u3002\u56e0\u6b64\uff0c\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u6cd5\u7ebf\u4e0e\u7ed1\u5b9a\u59ff\u52bf\u76f8\u5bf9\u5e94\u3002\u6211\u4eec\u9700\u8981\u50cf\u53d8\u6362\u4f4d\u7f6e\u4e00\u6837\u53d8\u6362\u5b83\u4eec\u3002 \u8fd9\u4e2a\u95ee\u9898\u5f88\u597d\u89e3\u51b3\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728\u5faa\u73af\u4e2d\u5c06\u6cd5\u7ebf\u4e5f\u56ca\u62ec\u5230\u9876\u70b9\u7740\u8272\u5668\u4e2d\u7684\u6743\u91cd\u904d\u5386\u3002 vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u7136\u540e\u6211\u4eec\u50cf\u5f80\u5e38\u4e00\u6837\u8ba1\u7b97\u8f93\u51fa\u9876\u70b9\u6cd5\u7ebf\u5411\u91cf\uff1a mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; \u63a5\u4e0b\u6765\u7684\u95ee\u9898\u662f\u9634\u5f71\u95ee\u9898\u3002\u5982\u679c\u4f60\u8bb0\u5f97\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u9634\u5f71\u56fe\u7ed8\u5236\u9634\u5f71\u3002\u6211\u4eec\u73b0\u5728\u6b63\u4ece\u5149\u7167\u900f\u89c6\u6e32\u67d3\u573a\u666f\uff0c\u4ee5\u4fbf\u521b\u5efa\u4e00\u4e2a\u6df1\u5ea6\u56fe\uff0c\u5b83\u544a\u8bc9\u6211\u4eec\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u9634\u5f71\u4e2d\u3002\u4f46\u662f\uff0c\u5728\u6cd5\u7ebf\u7684\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u7ed1\u5b9a\u59ff\u52bf\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u6839\u636e\u5f53\u524d\u5e27\u6765\u6539\u53d8\u5b83\u4eec\u3002\u8fd9\u5c31\u662f\u9634\u5f71\u4e0e\u5f53\u524d\u5750\u6807\u4e0d\u4e00\u81f4\u7684\u539f\u56e0\u3002 \u89e3\u51b3\u65b9\u6cd5\u4e5f\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\u4f7f\u7528 jointsMatrix \u3001\u6743\u91cd\u548c\u5173\u8282\u7d22\u5f15\u6765\u53d8\u6362\u5750\u6807\u3002\u8fd9\u5c31\u662f\u6df1\u5ea6\u9876\u70b9\u7740\u8272\u5668\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 modelLightViewMatrix; uniform mat4 orthoProjectionMatrix; void main() { vec4 initPos = vec4(0, 0, 0, 0); int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; } } if (count == 0) { initPos = vec4(position, 1.0); } gl_Position = orthoProjectionMatrix * modelLightViewMatrix * initPos; } \u4f60\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u6765\u4e3a\u8fd9\u4e2a\u7740\u8272\u5668\u8bbe\u7f6e\u65b0\u7684Uniform\uff0c\u6700\u7ec8\u7684\u6548\u679c\u4f1a\u66f4\u597d\u3002\u5149\u7167\u5c06\u88ab\u6b63\u786e\u7684\u5e94\u7528\uff0c\u9634\u5f71\u5c06\u968f\u6bcf\u4e2a\u52a8\u753b\u5e27\u6539\u53d8\uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u5185\u5bb9\u4e86\uff0c\u73b0\u5728\u4f60\u5df2\u7ecf\u6709\u4e86\u4e00\u4e2a\u7528\u4e8e\u52a8\u753bMD5\u6a21\u578b\u7684\u53ef\u5de5\u4f5c\u793a\u4f8b\u3002\u6e90\u4ee3\u7801\u4ecd\u80fd\u6539\u8fdb\uff0c\u4f60\u53ef\u4ee5\u4fee\u6539\u5728\u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u4e2d\u52a0\u8f7d\u7684\u77e9\u9635\uff0c\u4ee5\u4fbf\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u672c\u7ae0\u4e2d\u4f7f\u7528\u7684\u8d44\u6e90\uff0c\u4e86\u89e3\u5982\u4f55\u5b9e\u73b0\u8be5\u529f\u80fd\u3002","title":"\u4fee\u6b63\u52a8\u753b\u95ee\u9898"},{"location":"20-particles/","text":"\u7c92\u5b50\uff08Particles\uff09 \u57fa\u7840 \u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u7c92\u5b50\u6548\u679c\u5230\u6e38\u620f\u5f15\u64ce\u4e2d\u3002\u6709\u4e86\u8fd9\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5c31\u80fd\u6a21\u62df\u5173\u7cfb\u3001\u706b\u3001\u7070\u5c18\u548c\u4e91\u3002\u8fd9\u662f\u4e00\u79cd\u7b80\u5355\u7684\u6548\u679c\uff0c\u5c06\u6539\u5584\u5bf9\u4efb\u4f55\u6e38\u620f\u7684\u56fe\u5f62\u65b9\u9762\u3002 \u5728\u6b64\u4e4b\u524d\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u6709\u5f88\u591a\u65b9\u6cd5\u53ef\u4ee5\u5b9e\u73b0\u4e0d\u540c\u6548\u679c\u7684\u7c92\u5b50\u6548\u679c\u3002\u5f53\u524d\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u677f\u7c92\u5b50\uff08Billboard Particle\uff09\u3002\u8be5\u6280\u672f\u4f7f\u7528\u79fb\u52a8\u7684\u7eb9\u7406\u56db\u8fb9\u5f62\u6765\u8868\u793a\u4e00\u4e2a\u7c92\u5b50\uff0c\u5b83\u4eec\u603b\u662f\u9762\u5411\u89c2\u5bdf\u8005\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u5c31\u662f\u6444\u50cf\u673a\u3002\u4f60\u8fd8\u53ef\u4ee5\u4f7f\u7528\u9762\u677f\u6280\u672f\u5728\u6e38\u620f\u9879\u4e0a\u663e\u793a\u4fe1\u606f\u9762\u677f\uff0c\u6bd4\u5982\u8ff7\u4f60HUD\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5b9a\u4e49\u7c92\u5b50\uff0c\u7c92\u5b50\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u7528\u4e8e\u8868\u793a\u56db\u8fb9\u5f62\u9876\u70b9\u7684\u7f51\u683c\u3002 \u4e00\u5f20\u7eb9\u7406\u3002 \u67d0\u4e00\u65f6\u523b\u7684\u5750\u6807\u3002 \u7f29\u653e\u7cfb\u6570\u3002 \u901f\u5ea6\u3002 \u79fb\u52a8\u65b9\u5411\u3002 \u751f\u5b58\u65f6\u95f4\u6216\u5b58\u6d3b\u65f6\u95f4\u3002\u4e00\u65e6\u8be5\u65f6\u95f4\u8fc7\u53bb\uff0c\u7c92\u5b50\u5c31\u4e0d\u518d\u5b58\u5728\u3002 \u524d\u56db\u9879\u662f GameItem \u7c7b\u7684\u4e00\u90e8\u5206\uff0c\u4f46\u540e\u4e09\u9879\u4e0d\u662f\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Particle \u7684\u65b0\u7c7b\uff0c\u5b83\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private Vector3f speed; /** * \u7c92\u5b50\u5b58\u6d3b\u7684\u65f6\u95f4\uff0c\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d */ private long ttl; public Particle(Mesh mesh, Vector3f speed, long ttl) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; } public Particle(Particle baseParticle) { super(baseParticle.getMesh()); Vector3f aux = baseParticle.getPosition(); setPosition(aux.x, aux.y, aux.z); aux = baseParticle.getRotation(); setRotation(aux.x, aux.y, aux.z); setScale(baseParticle.getScale()); this.speed = new Vector3f(baseParticle.speed); this.ttl = baseParticle.geTtl(); } public Vector3f getSpeed() { return speed; } public void setSpeed(Vector3f speed) { this.speed = speed; } public long geTtl() { return ttl; } public void setTtl(long ttl) { this.ttl = ttl; } /** * \u66f4\u65b0\u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 * @param elapsedTime \u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 * @return \u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 */ public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; return this.ttl; } } \u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u51fa\uff0c\u7c92\u5b50\u7684\u901f\u5ea6\u548c\u8fd0\u52a8\u65b9\u5411\u53ef\u4ee5\u8868\u793a\u4e3a\u4e00\u4e2a\u5411\u91cf\u3002\u8be5\u5411\u91cf\u7684\u65b9\u5411\u51b3\u5b9a\u4e86\u7c92\u5b50\u7684\u8fd0\u52a8\u65b9\u5411\u548c\u901f\u5ea6\u3002\u7c92\u5b50\u5b58\u6d3b\u65f6\u95f4\uff08TTL\uff09\u88ab\u8bbe\u5b9a\u4e3a\u6beb\u79d2\u8ba1\u6570\u5668\uff0c\u6bcf\u5f53\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u65f6\uff0c\u5b83\u90fd\u4f1a\u51cf\u5c11\u3002\u8be5\u7c7b\u8fd8\u6709\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u53e6\u4e00\u4e2a\u7c92\u5b50\u5b9e\u4f8b\u6765\u8fdb\u884c\u590d\u5236\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7c92\u5b50\u751f\u6210\u5668\u6216\u7c92\u5b50\u53d1\u5c04\u5668\uff0c\u5373\u4e00\u4e2a\u52a8\u6001\u751f\u6210\u7c92\u5b50\u3001\u63a7\u5236\u5176\u751f\u547d\u5468\u671f\u5e76\u6839\u636e\u7279\u5b9a\u7684\u6a21\u5f0f\u66f4\u65b0\u5176\u4f4d\u7f6e\u7684\u7c7b\u3002\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u5f88\u591a\u5b9e\u73b0\uff0c\u5b83\u4eec\u5728\u7c92\u5b50\u7684\u521b\u5efa\u65b9\u5f0f\u548c\u4f4d\u7f6e\u7684\u66f4\u65b0\u65b9\u5f0f\uff08\u4f8b\u5982\uff0c\u662f\u5426\u8003\u8651\u91cd\u529b\uff09\u65b9\u9762\u5404\u4e0d\u76f8\u540c\u3002\u56e0\u6b64\uff0c\u4e3a\u4e86\u4fdd\u6301\u6e38\u620f\u5f15\u64ce\u7684\u901a\u7528\u6027\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u6240\u6709\u7c92\u5b50\u53d1\u5c04\u5668\u5fc5\u987b\u8981\u5b9e\u73b0\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u540d\u4e3a IParticleEmitter \u7684\u63a5\u53e3\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.List; import org.lwjglb.engine.items.GameItem; public interface IParticleEmitter { void cleanup(); Particle getBaseParticle(); List<GameItem> getParticles(); } IParticleEmitter \u63a5\u53e3\u6709\u4e00\u4e2a\u6e05\u7406\u8d44\u6e90\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a cleanup \uff0c\u8fd8\u6709\u4e00\u4e2a\u83b7\u53d6\u7c92\u5b50\u5217\u8868\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getParticles \u3002\u8fd8\u6709\u4e00\u4e2a\u540d\u4e3a getBaseParticle \u7684\u65b9\u6cd5\uff0c\u4f46\u662f\u8fd9\u4e2a\u65b9\u6cd5\u662f\u505a\u4ec0\u4e48\u7684\u5462\uff1f\u4e00\u4e2a\u7c92\u5b50\u53d1\u5c04\u5668\u5c06\u52a8\u6001\u5730\u4ea7\u751f\u8bb8\u591a\u4f8b\u5b50\u3002\u6bcf\u5f53\u4e00\u4e2a\u7c92\u5b50\u8fc7\u671f\uff0c\u5c31\u4f1a\u521b\u5efa\u65b0\u7684\u7c92\u5b50\u3002\u8be5\u7c92\u5b50\u66f4\u65b0\u5468\u671f\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u4f5c\u4e3a\u6a21\u677f\u521b\u5efa\u65b0\u7684\u52bf\u529b\u3002\u8fd9\u5c31\u662f\u57fa\u7840\u7c92\u5b50\u7684\u7528\u9014\uff0c\u8fd9\u4e5f\u662f\u4e3a\u4ec0\u4e48 Particle \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\u3002 \u5728\u6e38\u620f\u5f15\u64ce\u7684\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u5f15\u7528 IParticleEmitter \u63a5\u53e3\uff0c\u56e0\u6b64\u57fa\u7840\u4ee3\u7801\u5c06\u4e0d\u4f9d\u8d56\u4e8e\u7279\u5b9a\u7684\u5b9e\u73b0\u3002\u4e0d\u8fc7\uff0c\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u5b9e\u73b0\u6765\u6a21\u62df\u4e0d\u53d7\u91cd\u529b\u5f71\u54cd\u7684\u7c92\u5b50\u6d41\u3002\u8fd9\u4e2a\u5b9e\u73b0\u53ef\u4ee5\u7528\u6765\u6a21\u62df\u5149\u7ebf\u6216\u706b\u7130\uff0c\u540d\u4e3a FlowParticleEmitter \u3002 \u8fd9\u4e2a\u7c7b\u7684\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u8fdb\u884c\u8c03\u6574\uff1a \u4e00\u6b21\u80fd\u5b58\u5728\u7684\u6700\u5927\u7c92\u5b50\u6570\u91cf \u521b\u5efa\u7c92\u5b50\u7684\u6700\u77ed\u5468\u671f\u3002\u7c92\u5b50\u5c06\u5728\u6700\u77ed\u7684\u65f6\u95f4\u5185\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5730\u521b\u5efa\uff0c\u4ee5\u907f\u514d\u7c92\u5b50\u7206\u53d1\u6027\u521b\u5efa\u3002 \u4e00\u7ec4\u8303\u56f4\uff0c\u4ee5\u968f\u673a\u7c92\u5b50\u901f\u5ea6\u548c\u4f4d\u7f6e\u3002\u65b0\u7c92\u5b50\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u7684\u4f4d\u7f6e\u548c\u901f\u5ea6\uff0c\u53ef\u4ee5\u5728\u76f8\u5e94\u8303\u56f4\u5185\u53d6\u503c\uff0c\u4ee5\u5206\u6563\u5149\u7ebf\u3002 \u8be5\u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.joml.Vector3f; import org.lwjglb.engine.items.GameItem; public class FlowParticleEmitter implements IParticleEmitter { private int maxParticles; private boolean active; private final List<GameItem> particles; private final Particle baseParticle; private long creationPeriodMillis; private long lastCreationTime; private float speedRndRange; private float positionRndRange; private float scaleRndRange; public FlowParticleEmitter(Particle baseParticle, int maxParticles, long creationPeriodMillis) { particles = new ArrayList<>(); this.baseParticle = baseParticle; this.maxParticles = maxParticles; this.active = false; this.lastCreationTime = 0; this.creationPeriodMillis = creationPeriodMillis; } @Override public Particle getBaseParticle() { return baseParticle; } public long getCreationPeriodMillis() { return creationPeriodMillis; } public int getMaxParticles() { return maxParticles; } @Override public List<GameItem> getParticles() { return particles; } public float getPositionRndRange() { return positionRndRange; } public float getScaleRndRange() { return scaleRndRange; } public float getSpeedRndRange() { return speedRndRange; } public void setCreationPeriodMillis(long creationPeriodMillis) { this.creationPeriodMillis = creationPeriodMillis; } public void setMaxParticles(int maxParticles) { this.maxParticles = maxParticles; } public void setPositionRndRange(float positionRndRange) { this.positionRndRange = positionRndRange; } public void setScaleRndRange(float scaleRndRange) { this.scaleRndRange = scaleRndRange; } public boolean isActive() { return active; } public void setActive(boolean active) { this.active = active; } public void setSpeedRndRange(float speedRndRange) { this.speedRndRange = speedRndRange; } public void update(long ellapsedTime) { long now = System.currentTimeMillis(); if (lastCreationTime == 0) { lastCreationTime = now; } Iterator<? extends GameItem> it = particles.iterator(); while (it.hasNext()) { Particle particle = (Particle) it.next(); if (particle.updateTtl(ellapsedTime) < 0) { it.remove(); } else { updatePosition(particle, ellapsedTime); } } int length = this.getParticles().size(); if (now - lastCreationTime >= this.creationPeriodMillis && length < maxParticles) { createParticle(); this.lastCreationTime = now; } } private void createParticle() { Particle particle = new Particle(this.getBaseParticle()); // \u6dfb\u52a0\u4e00\u4e9b\u968f\u673a\u7684\u7c92\u5b50 float sign = Math.random() > 0.5d ? -1.0f : 1.0f; float speedInc = sign * (float)Math.random() * this.speedRndRange; float posInc = sign * (float)Math.random() * this.positionRndRange; float scaleInc = sign * (float)Math.random() * this.scaleRndRange; particle.getPosition().add(posInc, posInc, posInc); particle.getSpeed().add(speedInc, speedInc, speedInc); particle.setScale(particle.getScale() + scaleInc); particles.add(particle); } /** * \u66f4\u65b0\u4e00\u4e2a\u7c92\u5b50\u7684\u4f4d\u7f6e * @param particle \u9700\u8981\u66f4\u65b0\u7684\u7c92\u5b50 * @param elapsedTime \u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 */ public void updatePosition(Particle particle, long elapsedTime) { Vector3f speed = particle.getSpeed(); float delta = elapsedTime / 1000.0f; float dx = speed.x * delta; float dy = speed.y * delta; float dz = speed.z * delta; Vector3f pos = particle.getPosition(); particle.setPosition(pos.x + dx, pos.y + dy, pos.z + dz); } @Override public void cleanup() { for (GameItem particle : getParticles()) { particle.cleanup(); } } } \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u62d3\u5c55 Scene \u7c7b\u4e2d\u5305\u542b\u7684\u6570\u636e\uff0c\u4f7f\u5176\u5305\u542b\u4e00\u4e2a ParticleEmitter \u7684\u5b9e\u4f8b\u6570\u7ec4\u3002 package org.lwjglb.engine; // \u8fd9\u662f\u5bfc\u5165\u2026\u2026 public class Scene { // \u8fd9\u6709\u66f4\u591a\u5c5e\u6027\u2026\u2026 private IParticleEmitter[] particleEmitters; \u5728\u8be5\u9636\u6bb5\uff0c\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u6e32\u67d3\u7c92\u5b50\u3002\u7c92\u5b50\u4e0d\u4f1a\u53d7\u5230\u5149\u7684\u5f71\u54cd\uff0c\u4e5f\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u97f3\u4e50\u3002\u5b83\u4eec\u4e0d\u4f1a\u6709\u4efb\u4f55\u9aa8\u9abc\u52a8\u753b\uff0c\u6240\u4ee5\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6e32\u67d3\u5b83\u4eec\u662f\u6ca1\u6709\u610f\u4e49\u7684\u3002\u7740\u8272\u5668\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u4f1a\u4f7f\u7528\u6295\u5f71\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6e32\u67d3\u9876\u70b9\uff0c\u5e76\u4f7f\u7528\u7eb9\u7406\u8bbe\u7f6e\u989c\u8272\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u7247\u5143\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u975e\u5e38\u7b80\u5355\uff0c\u5c31\u50cf\u6e32\u67d3\u4e00\u7ae0\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u3002\u73b0\u5728\uff0c\u548c\u5176\u4ed6\u7ae0\u8282\u4e00\u6837\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u8bbe\u7f6e\u548c\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u3002\u7740\u8272\u5668\u7684\u8bbe\u7f6e\u5c06\u5728\u4e00\u4e2a\u540d\u4e3a setupParticlesShader \u7684\u65b9\u6cd5\u4e2d\u5b8c\u6210\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private void setupParticlesShader() throws Exception { particlesShaderProgram = new ShaderProgram(); particlesShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/particles_vertex.vs\")); particlesShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/particles_fragment.fs\")); particlesShaderProgram.link(); particlesShaderProgram.createUniform(\"projectionMatrix\"); particlesShaderProgram.createUniform(\"modelViewMatrix\"); particlesShaderProgram.createUniform(\"texture_sampler\"); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728Renderer\u7c7b\u4e2d\u521b\u5efa\u6e32\u67d3\u65b9\u6cd5 renderParticles \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderParticles(Window window, Camera camera, Scene scene) { particlesShaderProgram.bind(); particlesShaderProgram.setUniform(\"texture_sampler\", 0); Matrix4f projectionMatrix = transformation.getProjectionMatrix(); particlesShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); Matrix4f viewMatrix = transformation.getViewMatrix(); IParticleEmitter[] emitters = scene.getParticleEmitters(); int numEmitters = emitters != null ? emitters.length : 0; for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } particlesShaderProgram.unbind(); } \u5982\u679c\u4f60\u52aa\u529b\u9605\u8bfb\uff0c\u4e0a\u8ff0\u4ee3\u7801\u5e94\u8be5\u662f\u4e0d\u8a00\u81ea\u660e\u7684\uff0c\u5b83\u53ea\u662f\u8bbe\u7f6e\u5fc5\u8981\u7684Uniform\uff0c\u5e76\u6e32\u67d3\u6bcf\u4e2a\u7c92\u5b50\u3002\u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u6d4b\u8bd5\u7c92\u5b50\u6548\u679c\u5b9e\u73b0\u6240\u9700\u7684\u6240\u6709\u65b9\u6cd5\uff0c\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u521b\u5efa\u7c92\u5b50\u53d1\u5c04\u5668\u548c\u57fa\u672c\u7c92\u5b50\u7684\u7279\u6027\u3002 Vector3f particleSpeed = new Vector3f(0, 1, 0); particleSpeed.mul(2.5f); long ttl = 4000; int maxParticles = 200; long creationPeriodMillis = 300; float range = 0.2f; float scale = 0.5f; Mesh partMesh = OBJLoader.loadMesh(\"/models/particle.obj\"); Texture texture = new Texture(\"/textures/particle_tmp.png\"); Material partMaterial = new Material(texture, reflectance); partMesh.setMaterial(partMaterial); Particle particle = new Particle(partMesh, particleSpeed, ttl); particle.setScale(scale); particleEmitter = new FlowParticleEmitter(particle, maxParticles, creationPeriodMillis); particleEmitter.setActive(true); particleEmitter.setPositionRndRange(range); particleEmitter.setSpeedRndRange(range); this.scene.setParticleEmitters(new FlowParticleEmitter[] {particleEmitter}); \u6211\u4eec\u73b0\u5728\u4f7f\u7528\u4e00\u4e2a\u666e\u901a\u586b\u5145\u5706\u4f5c\u4e3a\u7c92\u5b50\u7684\u7eb9\u7406\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u5982\u679c\u4f60\u8fd0\u884c\u5b83\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u4e3a\u4ec0\u4e48\u4e00\u4e9b\u7c92\u5b50\u4f3c\u4e4e\u88ab\u5207\u65ad\u4e86\uff1f\u4e3a\u4ec0\u4e48\u900f\u660e\u7684\u80cc\u666f\u4e0d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1f\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\u3002\u7c92\u5b50\u7684\u4e00\u4e9b\u7247\u5143\u88ab\u4e22\u5f03\uff0c\u56e0\u4e3a\u5b83\u4eec\u5177\u6709\u6bd4\u8be5\u533a\u57df\u7684\u6df1\u5ea6\u7f13\u51b2\u7684\u5f53\u524d\u503c\u9ad8\u7684\u6df1\u5ea6\u503c\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5c06\u5176\u4e0e\u6444\u50cf\u673a\u4e4b\u95f4\u7684\u8ddd\u79bb\u6765\u6392\u5e8f\u7c92\u5b50\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6216\u8005\u6211\u4eec\u53ef\u4ee5\u7981\u7528\u6df1\u5ea6\u5199\u5165\u3002 \u5728\u7ed8\u5236\u7c92\u5b50\u4e4b\u524d\u6211\u4eec\u9700\u8981\u63d2\u5165\u8fd9\u4e00\u884c\u4ee3\u7801\uff1a glDepthMask(false); \u7136\u540e\u5728\u6211\u4eec\u5b8c\u6210\u6e32\u67d3\u4e4b\u540e\u8fd8\u539f\u4e3a\u5148\u524d\u503c\uff1a glDepthMask(true); \u7136\u540e\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u597d\u4e86\uff0c\u95ee\u9898\u89e3\u51b3\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u60f3\u5e94\u7528\u53e6\u4e00\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5e0c\u671b\u989c\u8272\u88ab\u6df7\u5408\uff0c\u56e0\u6b64\u989c\u8272\u5c06\u88ab\u6dfb\u52a0\uff0c\u4ee5\u8fbe\u6210\u66f4\u597d\u7684\u6548\u679c\u3002\u8fd9\u662f\u5728\u6e32\u67d3\u524d\u589e\u52a0\u5982\u4e0b\u4e00\u884c\u4ee3\u7801\u6765\u5b9e\u73b0\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE); \u4e0e\u6df1\u5ea6\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u6e32\u67d3\u5b8c\u6240\u6709\u7c92\u5b50\u540e\uff0c\u6211\u4eec\u5c06\u6df7\u5408\u51fd\u6570\u6062\u590d\u4e3a\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u6211\u4eec\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f46\u6211\u4eec\u8fd8\u6ca1\u6709\u5b8c\u6210\u5b83\u3002\u5982\u679c\u4f60\u628a\u6444\u50cf\u673a\u79fb\u5230\u84dd\u8272\u6b63\u65b9\u5f62\u7684\u4e0a\u65b9\u5f80\u4e0b\u770b\uff0c\u4f60\u53ef\u80fd\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u4e1c\u897f\uff1a \u8fd9\u4e9b\u7c92\u5b50\u770b\u8d77\u6765\u4e0d\u592a\u597d\uff0c\u5b83\u4eec\u5e94\u8be5\u662f\u5706\u7684\uff0c\u4f46\u73b0\u5728\u770b\u8d77\u6765\u50cf\u4e00\u5f20\u7eb8\u3002\u5728\u6b64\u4e4b\u4e0a\uff0c\u6211\u4eec\u5e94\u8be5\u5e94\u7528\u9762\u677f\u6280\u672f\u3002\u7528\u4e8e\u6e32\u67d3\u7c92\u5b50\u7684\u56db\u8fb9\u5f62\u5e94\u8be5\u59cb\u7ec8\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e0e\u6444\u50cf\u673a\u65b9\u5411\u5b8c\u5168\u5782\u76f4\uff0c\u5c31\u597d\u50cf\u6839\u672c\u6ca1\u6709\u65cb\u8f6c\u4e00\u6837\u3002\u6444\u50cf\u673a\u7684\u77e9\u9635\u5c06\u4f4d\u79fb\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u573a\u666f\u4e2d\u7684\u6bcf\u4e00\u4e2a\u5bf9\u8c61\uff0c\u6211\u4eec\u60f3\u8df3\u8fc7\u5c06\u8981\u5e94\u7528\u7684\u65cb\u8f6c\u3002 \u8b66\u544a\uff1a\u5728\u8bb2\u6570\u5b66\u77e5\u8bc6\u65f6\uff0c\u5982\u679c\u4f60\u89c9\u5f97\u4e0d\u8212\u670d\uff0c\u4f60\u53ef\u4ee5\u8df3\u8fc7\u5b83\u3002\u8ba9\u6211\u4eec\u518d\u6b21\u56de\u987e\u90a3\u4e2a\u89c2\u5bdf\u77e9\u9635\u3002\u8be5\u77e9\u9635\u53ef\u4ee5\u50cf\u8fd9\u6837\u8868\u793a\uff08\u6ca1\u6709\u5e94\u7528\u4efb\u4f55\u7f29\u653e\uff09\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{r_{00}} & \\color{red}{r_{10}} & \\color{red}{r_{20}} & \\color{blue}{dx} \\\\ \\color{red}{r_{01}} & \\color{red}{r_{11}} & \\color{red}{r_{21}} & \\color{blue}{dy} \\\\ \\color{red}{r_{02}} & \\color{red}{r_{12}} & \\color{red}{r_{22}} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7ea2\u8272\u7684\u5143\u7d20\u4ee3\u8868\u6444\u50cf\u673a\u7684\u65cb\u8f6c\uff0c\u84dd\u8272\u7684\u5143\u7d20\u4ee3\u8868\u4f4d\u79fb\u3002\u6211\u4eec\u9700\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u4e2d\u7684\u5de6\u4e0a\u89d23x3\u77e9\u9635\u7684\u65cb\u8f6c\u6548\u679c\uff0c\u6240\u4ee5\u5b83\u4f1a\u53d8\u6210\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & \\color{blue}{dx} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & \\color{blue}{dy} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u5728\u5de6\u4e0a\u89d2\u7684\u7ea2\u8272\u90e8\u5206\uff0c\u6211\u4eec\u6709\u4e00\u4e2a3x3\u77e9\u9635\uff0c\u628a\u5b83\u547d\u540d\u4e3a M_{r} \u5e76\u4e14\u6211\u4eec\u60f3\u628a\u5b83\u8f6c\u6362\u6210\u5355\u4f4d\u77e9\u9635\uff1a I \u3002\u4efb\u4f55\u77e9\u9635\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\u90fd\u4f1a\u5f97\u5230\u5355\u4f4d\u77e9\u9635\uff1a M_{r} \\times M_{r}^{-1} = I \u3002\u6211\u4eec\u53ea\u9700\u8981\u4ece\u89c2\u5bdf\u77e9\u9635\u4e2d\u53d6\u5de6\u4e0a\u89d2\u76843x3\u77e9\u9635\uff0c\u7136\u540e\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u8fd8\u53ef\u4ee5\u4f18\u5316\u4ed6\u3002\u4e00\u4e2a\u65cb\u8f6c\u77e9\u9635\u6709\u4e00\u4e2a\u6709\u8da3\u7684\u5b9a\u7406\uff0c\u5b83\u7684\u9006\u77e9\u9635\u4e0e\u5176\u8f6c\u7f6e\u77e9\u9635\u76f8\u7b49\u3002\u5373\uff1a M_{r} \\times M_{r}^{-1} = M_{r} \\times M_{r}^{T} = I \u3002\u8f6c\u7f6e\u77e9\u9635\u6bd4\u9006\u77e9\u9635\u66f4\u5bb9\u6613\u8ba1\u7b97\u3002\u77e9\u9635\u7684\u8f6c\u7f6e\u5c31\u50cf\u5c06\u5176\u53cd\u8f6c\u8fc7\u6765\uff0c\u5c06\u6bcf\u4e00\u5217\u4e0e\u6bcf\u4e00\u884c\u66ff\u6362\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} r_{00} & r_{10} & r_{20} \\\\ r_{01} & r_{11} & r_{21} \\\\ r_{02} & r_{12} & r_{22} \\end{bmatrix} ^{T} = \\begin{bmatrix} r_{00} & r_{01} & r_{02} \\\\ r_{10} & r_{11} & r_{12} \\\\ r_{20} & r_{21} & r_{22} \\end{bmatrix} \u597d\u7684\uff0c\u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\u3002\u6211\u4eec\u6709\u8be5\u53d8\u6362\uff1a V \\times M \uff0c\u5176\u4e2d V \u662f\u89c2\u5bdf\u77e9\u9635\uff0c M \u662f\u6a21\u578b\u77e9\u9635\u3002\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u8868\u8fbe\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{m_{00}} & \\color{red}{m_{10}} & \\color{red}{m_{20}} & m_{30} \\\\ \\color{red}{m_{01}} & \\color{red}{m_{11}} & \\color{red}{m_{21}} & m_{31} \\\\ \\color{red}{m_{02}} & \\color{red}{m_{12}} & \\color{red}{m_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u6211\u4eec\u60f3\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\uff0c\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u4e3a\u89c2\u5bdf\u77e9\u9635\u4e0a3x3\u90e8\u5206\u7684\u8f6c\u7f6e\u77e9\u9635\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{01}} & \\color{red}{v_{02}} & m_{30} \\\\ \\color{red}{v_{10}} & \\color{red}{v_{11}} & \\color{red}{v_{12}} & m_{31} \\\\ \\color{red}{v_{20}} & \\color{red}{v_{21}} & \\color{red}{v_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u4f46\u5728\u8fd9\u4e4b\u540e\uff0c\u6211\u4eec\u53bb\u6389\u4e86\u7f29\u653e\uff0c\u5b9e\u9645\u4e0a\u771f\u6b63\u60f3\u8981\u8fbe\u5230\u7684\u7ed3\u679c\u662f\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{sx} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{sy} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{sz} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u5176\u4e2dsx\uff0csy\u548csz\u5c31\u662f\u7f29\u653e\u7cfb\u6570\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u7f6e\u4e3a\u89c2\u5bdf\u77e9\u9635\u7684\u8f6c\u7f6e\u77e9\u9635\u540e\uff0c\u6211\u4eec\u9700\u8981\u518d\u6b21\u5e94\u7528\u7f29\u653e\u3002 \u5c31\u8fd9\u4e9b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 renderParticlesMethod \u4e2d\u50cf\u8fd9\u6837\u4fee\u6539\uff1a for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); viewMatrix.transpose3x3(modelMatrix); Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.scale(gameItem.getScale()); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u6211\u4eec\u8fd8\u5728 Transformation \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u4f7f\u7528\u4e24\u4e2a\u77e9\u9635\u6765\u6784\u9020\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u800c\u4e0d\u662f\u4f7f\u7528 GameItem \u548c\u89c2\u5bdf\u77e9\u9635\u3002 \u6709\u4e86\u5982\u4e0a\u66f4\u6539\uff0c\u5f53\u4ece\u4e0a\u65b9\u89c2\u5bdf\u7c92\u5b50\u65f6\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a \u73b0\u5728\u96c6\u9f50\u4e86\u521b\u5efa\u4e00\u4e2a\u66f4\u771f\u5b9e\u7684\u7c92\u5b50\u6548\u679c\u6240\u9700\u8981\u7684\u6240\u6709\u8981\u7d20\uff0c\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u6539\u4e3a\u66f4\u7cbe\u7ec6\u7684\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5982\u4e0b\u56fe\u7247\uff08\u5b83\u662f\u7531 GIMP \u521b\u4f5c\u7684\uff0c\u5e26\u6709\u5149\u7167\u548c\u9634\u5f71\u8fc7\u6ee4\u5668\uff09\uff1a \u6709\u4e86\u5982\u4e0a\u7eb9\u7406\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7c92\u5b50\uff1a \u73b0\u5728\u66f4\u597d\u4e86\uff01\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u9700\u8981\u8c03\u6574\u7f29\u653e\uff0c\u56e0\u4e3a\u7c92\u5b50\u73b0\u5728\u603b\u662f\u5bf9\u7740\u6444\u50cf\u673a\uff0c\u663e\u793a\u7684\u9762\u79ef\u603b\u662f\u6700\u5927\u7684\u3002 \u6700\u540e\uff0c\u518d\u63d0\u4e00\u70b9\uff0c\u4e3a\u4e86\u5f97\u5230\u53ef\u4ee5\u5728\u4efb\u4f55\u573a\u666f\u4f7f\u7528\u7684\u5b8c\u7f8e\u7684\u6548\u679c\uff0c\u4f60\u9700\u8981\u5b9e\u73b0\u7c92\u5b50\u6392\u5e8f\u548c\u542f\u7528\u6df1\u5ea6\u7f13\u51b2\u533a\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u8fd9\u91cc\u6709\u4e00\u4e2a\u793a\u4f8b\u53ef\u4ee5\u5c06\u8fd9\u79cd\u6548\u679c\u56ca\u62ec\u5230\u4f60\u7684\u6e38\u620f\u4e2d\u3002 \u7eb9\u7406\u96c6\uff08Texture Atlas\uff09 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u505a\u597d\u4e86\u7c92\u5b50\u6548\u679c\u7684\u57fa\u7840\u5efa\u8bbe\uff0c\u73b0\u5728\u53ef\u4ee5\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e9b\u52a8\u753b\u6548\u679c\u4e86\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u652f\u6301\u7eb9\u7406\u96c6\u3002\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09\u662f\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5c06\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u7684\u5927\u578b\u56fe\u7247\u3002\u4f7f\u7528\u7eb9\u7406\u96c6\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u52a0\u8f7d\u4e00\u4e2a\u5927\u7684\u56fe\u7247\uff0c\u7136\u540e\u518d\u7ed8\u5236\u6e38\u620f\u9879\u65f6\uff0c\u9009\u62e9\u8be5\u56fe\u50cf\u7684\u4e00\u90e8\u5206\u4f5c\u4e3a\u7eb9\u7406\u3002\u4f8b\u5982\uff0c\u5f53\u6211\u4eec\u60f3\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u591a\u6b21\u6e32\u67d3\u76f8\u540c\u7684\u6a21\u578b\u65f6\uff08\u4f8b\u5982\u6811\u6216\u5ca9\u77f3\uff09\uff0c\u53ef\u4ee5\u4f7f\u7528\u8fd9\u79cd\u6280\u672f\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\u96c6\u5e76\u9009\u62e9\u9002\u5f53\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u4f7f\u7528\u5f88\u591a\u7eb9\u7406\u5b9e\u4f8b\u5e76\u5728\u5b83\u4eec\u4e4b\u95f4\u5207\u6362\uff08\u8bb0\u4f4f\uff0c\u5207\u6362\u72b6\u6001\u603b\u662f\u5f88\u6162\u7684\uff09\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6765\u6dfb\u52a0\u7c92\u5b50\u52a8\u753b\u3002\u6211\u4eec\u904d\u5386\u4e0d\u540c\u7684\u7eb9\u7406\u6765\u4e3a\u7c92\u5b50\u52a8\u753b\u5efa\u6a21\uff0c\u6240\u6709\u8fd9\u4e9b\u7eb9\u7406\u5c06\u88ab\u5206\u5230\u4e00\u4e2a\u50cf\u8fd9\u6837\u7684\u7eb9\u7406\u96c6\uff1a \u7eb9\u7406\u96c6\u53ef\u4ee5\u88ab\u5212\u5206\u4e3a\u591a\u4e2a\u65b9\u5f62\u7247\u6bb5\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u65b9\u5f62\u7247\u6bb5\u5750\u6807\u5206\u914d\u5230\u4e00\u4e2a\u7c92\u5b50\u4e0a\uff0c\u5e76\u968f\u7740\u65f6\u95f4\u63a8\u79fb\u6539\u53d8\u5b83\u4ee5\u8868\u793a\u52a8\u753b\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u5427\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u4fee\u6539 Texture \u7c7b\u6765\u6307\u5b9a\u7eb9\u7406\u96c6\u53ef\u4ee5\u62e5\u6709\u7684\u884c\u6570\u548c\u5217\u6570\u3002 package org.lwjglb.engine.graph; // .. \u8fd9\u91cc\u662f\u5bfc\u5165 public class Texture { // \u65e0\u5173\u5c5e\u6027\u7701\u7565 private int numRows = 1; private int numCols = 1; // \u65e0\u5173\u4ee3\u7801\u7701\u7565 public Texture(String fileName, int numCols, int numRows) throws Exception { this(fileName); this.numCols = numCols; this.numRows = numRows; } \u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5904\u7406\u7684\u7eb9\u7406\u7684\u5217\u6570\u548c\u884c\u6570\u7b49\u4e8e1\u3002\u6211\u4eec\u8fd8\u6dfb\u52a0\u4e86\u53e6\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u6765\u6307\u5b9a\u884c\u548c\u5217\u3002 \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ffd\u8e2a\u4e00\u4e2a GameItem \u5728\u7eb9\u7406\u96c6\u4e2d\u7684\u5750\u6807\uff0c\u56e0\u6b64\u53ea\u9700\u5411\u8be5\u7c7b\u6dfb\u52a0\u53e6\u4e00\u4e2a\u5c5e\u6027\uff0c\u9ed8\u8ba4\u503c\u4e3a0\u3002 package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { // \u66f4\u591a\u5c5e\u6027\u7701\u7565 private int textPos; \u7136\u540e\u6211\u4eec\u4fee\u6539 Particle \u7c7b\uff0c\u4ee5\u4fbf\u80fd\u591f\u901a\u8fc7\u7eb9\u7406\u96c6\u81ea\u52a8\u8fed\u4ee3\u3002 package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private long updateTextureMillis; private long currentAnimTimeMillis; \u5c5e\u6027 updateTextureMillis \u5b9a\u4e49\u79fb\u52a8\u5230\u7eb9\u7406\u96c6\u4e2d\u4e0b\u4e00\u4e2a\u5750\u6807\u7684\u65f6\u95f4\uff08\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d\uff09\u3002\u6570\u503c\u6708\u5e95\uff0c\u7c92\u5b50\u5728\u7eb9\u7406\u4e0a\u53d8\u5316\u7684\u901f\u5ea6\u5c31\u8d8a\u5feb\u3002\u5c5e\u6027 currentAnimTimeMillis \u53ea\u662f\u8ddf\u8e2a\u7eb9\u7406\u6301\u7eed\u5f53\u524d\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Particle \u7c7b\u6784\u9020\u51fd\u6570\u6765\u8bbe\u7f6e\u8fd9\u4e9b\u503c\u3002\u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u7eb9\u7406\u96c6\u7684\u7247\u6bb5\u6570\u91cf\uff0c\u5b83\u662f\u7531\u5c5e\u6027 animFrames \u5b9a\u4e49\u7684\u3002 public Particle(Mesh mesh, Vector3f speed, long ttl, long updateTextureMillis) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; this.updateTextureMills = updateTextureMills; this.currentAnimTimeMillis = 0; Texture texture = this.getMesh().getMaterial().getTexture(); this.animFrames = texture.getNumCols() * texture.getNumRows(); } \u73b0\u5728\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u68c0\u67e5\u7c92\u5b50\u662f\u5426\u5df2\u7ecf\u8fc7\u671f\u7684\u65b9\u6cd5\uff0c\u6765\u68c0\u67e5\u662f\u5426\u9700\u8981\u66f4\u65b0\u7eb9\u7406\u5750\u6807\u3002 public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; this.currentAnimTimeMillis += elapsedTime; if ( this.currentAnimTimeMillis >= this.getUpdateTextureMillis() && this.animFrames > 0 ) { this.currentAnimTimeMillis = 0; int pos = this.getTextPos(); pos++; if ( pos < this.animFrames ) { this.setTextPos(pos); } else { this.setTextPos(0); } } return this.ttl; } \u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 FlowRangeEmitter \u7c7b\uff0c\u5728\u5e94\u8be5\u6539\u53d8\u7c92\u5b50\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u5468\u671f\u4e0a\u589e\u52a0\u4e86\u4e00\u4e9b\u968f\u673a\u6027\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e9b\u6570\u636e\u6765\u8bbe\u7f6e\u5408\u9002\u7684\u7eb9\u7406\u5750\u6807\u3002\u6211\u4eec\u5c06\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u8fdb\u884c\u8fd9\u4e00\u64cd\u4f5c\uff0c\u56e0\u4e3a\u5b83\u8f93\u51fa\u4e86\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u90a3\u4e9b\u503c\u3002\u8fd9\u4e2a\u65b0\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform float texXOffset; uniform float texYOffset; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texXOffset); float y = (texCoord.y / numRows + texYOffset); outTexCoord = vec2(x, y); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u73b0\u5728\u6709\u4e09\u4e2a\u65b0Uniform\u3002Uniform numCols \u548c numRows \u53ea\u50a8\u5b58\u7eb9\u7406\u96c6\u7684\u5217\u548c\u884c\u6570\u3002\u4e3a\u4e86\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\uff0c\u9996\u5148\u5fc5\u987b\u7f29\u5c0f\u8fd9\u4e9b\u53c2\u6570\u3002\u6bcf\u4e2a\u7247\u6bb5\u7684\u5bbd\u5ea6\u4e3a 1 / numCols \uff0c\u9ad8\u5ea6\u4e3a 1 / numRows \uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u884c\u548c\u5217\u5e94\u7528\u548c\u504f\u79fb\uff0c\u8fd9\u662f\u7531 texXOffset \u548c texYOffset Uniform\u5b9a\u4e49\u7684\u3002 \u6211\u4eec\u5c06\u5728 Renderer \u7c7b\u4e2d\u8ba1\u7b97\u8fd9\u4e9b\u504f\u79fb\u91cf\uff0c\u5982\u4e0b\u8ff0\u4ee3\u7801\u6240\u793a\u3002\u6211\u4eec\u6839\u636e\u6bcf\u4e2a\u7c92\u5b50\u7684\u5750\u6807\u8ba1\u7b97\u5b83\u4eec\u6240\u5904\u7684\u884c\u548c\u5217\uff0c\u5e76\u5c06\u504f\u79fb\u91cf\u8ba1\u7b97\u4e3a\u7247\u6bb5\u9ad8\u5ea6\u548c\u5bbd\u5ea6\u7684\u500d\u6570\u3002 mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { int col = gameItem.getTextPos() % text.getNumCols(); int row = gameItem.getTextPos() / text.getNumCols(); float textXOffset = (float) col / text.getNumCols(); float textYOffset = (float) row / text.getNumRows(); particlesShaderProgram.setUniform(\"texXOffset\", textXOffset); particlesShaderProgram.setUniform(\"texYOffset\", textYOffset); \u6ce8\u610f\uff0c\u5982\u679c\u4f60\u53ea\u9700\u8981\u652f\u6301\u6b63\u65b9\u5f62\u7eb9\u7406\u96c6\uff0c\u4f60\u53ea\u9700\u8981\u4e24\u4e2aUniform\u3002\u6700\u7ec8\u7684\u6548\u679c\u662f\u8fd9\u6837\u7684\uff1a \u73b0\u5728\uff0c\u6211\u4eec\u6709\u4e86\u7c92\u5b50\u52a8\u753b\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4f18\u5316\u6e32\u67d3\u6d41\u7a0b\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u5177\u6709\u76f8\u540c\u7f51\u683c\u7684\u591a\u4e2a\u5143\u7d20\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u5143\u7d20\u8fdb\u884c\u7ed8\u5236\u8c03\u7528\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u5728\u5355\u4e2a\u8c03\u7528\u4e2d\u6e32\u67d3\u5b83\u4eec\u3002\u8fd9\u79cd\u6280\u672f\u4e0d\u4ec5\u9002\u7528\u4e8e\u7c92\u5b50\uff0c\u4e5f\u9002\u7528\u4e8e\u6e32\u67d3\u5171\u4eab\u540c\u4e00\u6a21\u578b\uff0c\u4f46\u88ab\u653e\u5728\u4e0d\u540c\u4f4d\u7f6e\u6216\u5177\u6709\u4e0d\u540c\u7eb9\u7406\u7684\u591a\u4e2a\u5143\u7d20\u7684\u573a\u666f\u3002","title":"\u7c92\u5b50"},{"location":"20-particles/#particles","text":"","title":"\u7c92\u5b50\uff08Particles\uff09"},{"location":"20-particles/#_1","text":"\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u7c92\u5b50\u6548\u679c\u5230\u6e38\u620f\u5f15\u64ce\u4e2d\u3002\u6709\u4e86\u8fd9\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5c31\u80fd\u6a21\u62df\u5173\u7cfb\u3001\u706b\u3001\u7070\u5c18\u548c\u4e91\u3002\u8fd9\u662f\u4e00\u79cd\u7b80\u5355\u7684\u6548\u679c\uff0c\u5c06\u6539\u5584\u5bf9\u4efb\u4f55\u6e38\u620f\u7684\u56fe\u5f62\u65b9\u9762\u3002 \u5728\u6b64\u4e4b\u524d\u503c\u5f97\u4e00\u63d0\u7684\u662f\uff0c\u6709\u5f88\u591a\u65b9\u6cd5\u53ef\u4ee5\u5b9e\u73b0\u4e0d\u540c\u6548\u679c\u7684\u7c92\u5b50\u6548\u679c\u3002\u5f53\u524d\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u9762\u677f\u7c92\u5b50\uff08Billboard Particle\uff09\u3002\u8be5\u6280\u672f\u4f7f\u7528\u79fb\u52a8\u7684\u7eb9\u7406\u56db\u8fb9\u5f62\u6765\u8868\u793a\u4e00\u4e2a\u7c92\u5b50\uff0c\u5b83\u4eec\u603b\u662f\u9762\u5411\u89c2\u5bdf\u8005\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u5c31\u662f\u6444\u50cf\u673a\u3002\u4f60\u8fd8\u53ef\u4ee5\u4f7f\u7528\u9762\u677f\u6280\u672f\u5728\u6e38\u620f\u9879\u4e0a\u663e\u793a\u4fe1\u606f\u9762\u677f\uff0c\u6bd4\u5982\u8ff7\u4f60HUD\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5b9a\u4e49\u7c92\u5b50\uff0c\u7c92\u5b50\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u7528\u4e8e\u8868\u793a\u56db\u8fb9\u5f62\u9876\u70b9\u7684\u7f51\u683c\u3002 \u4e00\u5f20\u7eb9\u7406\u3002 \u67d0\u4e00\u65f6\u523b\u7684\u5750\u6807\u3002 \u7f29\u653e\u7cfb\u6570\u3002 \u901f\u5ea6\u3002 \u79fb\u52a8\u65b9\u5411\u3002 \u751f\u5b58\u65f6\u95f4\u6216\u5b58\u6d3b\u65f6\u95f4\u3002\u4e00\u65e6\u8be5\u65f6\u95f4\u8fc7\u53bb\uff0c\u7c92\u5b50\u5c31\u4e0d\u518d\u5b58\u5728\u3002 \u524d\u56db\u9879\u662f GameItem \u7c7b\u7684\u4e00\u90e8\u5206\uff0c\u4f46\u540e\u4e09\u9879\u4e0d\u662f\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Particle \u7684\u65b0\u7c7b\uff0c\u5b83\u7ee7\u627f\u4e86 GameItem \u7c7b\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private Vector3f speed; /** * \u7c92\u5b50\u5b58\u6d3b\u7684\u65f6\u95f4\uff0c\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d */ private long ttl; public Particle(Mesh mesh, Vector3f speed, long ttl) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; } public Particle(Particle baseParticle) { super(baseParticle.getMesh()); Vector3f aux = baseParticle.getPosition(); setPosition(aux.x, aux.y, aux.z); aux = baseParticle.getRotation(); setRotation(aux.x, aux.y, aux.z); setScale(baseParticle.getScale()); this.speed = new Vector3f(baseParticle.speed); this.ttl = baseParticle.geTtl(); } public Vector3f getSpeed() { return speed; } public void setSpeed(Vector3f speed) { this.speed = speed; } public long geTtl() { return ttl; } public void setTtl(long ttl) { this.ttl = ttl; } /** * \u66f4\u65b0\u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 * @param elapsedTime \u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 * @return \u7c92\u5b50\u7684\u5b58\u6d3b\u65f6\u95f4 */ public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; return this.ttl; } } \u4ece\u4e0a\u8ff0\u4ee3\u7801\u53ef\u4ee5\u770b\u51fa\uff0c\u7c92\u5b50\u7684\u901f\u5ea6\u548c\u8fd0\u52a8\u65b9\u5411\u53ef\u4ee5\u8868\u793a\u4e3a\u4e00\u4e2a\u5411\u91cf\u3002\u8be5\u5411\u91cf\u7684\u65b9\u5411\u51b3\u5b9a\u4e86\u7c92\u5b50\u7684\u8fd0\u52a8\u65b9\u5411\u548c\u901f\u5ea6\u3002\u7c92\u5b50\u5b58\u6d3b\u65f6\u95f4\uff08TTL\uff09\u88ab\u8bbe\u5b9a\u4e3a\u6beb\u79d2\u8ba1\u6570\u5668\uff0c\u6bcf\u5f53\u66f4\u65b0\u6e38\u620f\u72b6\u6001\u65f6\uff0c\u5b83\u90fd\u4f1a\u51cf\u5c11\u3002\u8be5\u7c7b\u8fd8\u6709\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u63a5\u6536\u53e6\u4e00\u4e2a\u7c92\u5b50\u5b9e\u4f8b\u6765\u8fdb\u884c\u590d\u5236\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u7c92\u5b50\u751f\u6210\u5668\u6216\u7c92\u5b50\u53d1\u5c04\u5668\uff0c\u5373\u4e00\u4e2a\u52a8\u6001\u751f\u6210\u7c92\u5b50\u3001\u63a7\u5236\u5176\u751f\u547d\u5468\u671f\u5e76\u6839\u636e\u7279\u5b9a\u7684\u6a21\u5f0f\u66f4\u65b0\u5176\u4f4d\u7f6e\u7684\u7c7b\u3002\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u5f88\u591a\u5b9e\u73b0\uff0c\u5b83\u4eec\u5728\u7c92\u5b50\u7684\u521b\u5efa\u65b9\u5f0f\u548c\u4f4d\u7f6e\u7684\u66f4\u65b0\u65b9\u5f0f\uff08\u4f8b\u5982\uff0c\u662f\u5426\u8003\u8651\u91cd\u529b\uff09\u65b9\u9762\u5404\u4e0d\u76f8\u540c\u3002\u56e0\u6b64\uff0c\u4e3a\u4e86\u4fdd\u6301\u6e38\u620f\u5f15\u64ce\u7684\u901a\u7528\u6027\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u6240\u6709\u7c92\u5b50\u53d1\u5c04\u5668\u5fc5\u987b\u8981\u5b9e\u73b0\u7684\u63a5\u53e3\u3002\u8fd9\u4e2a\u540d\u4e3a IParticleEmitter \u7684\u63a5\u53e3\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.List; import org.lwjglb.engine.items.GameItem; public interface IParticleEmitter { void cleanup(); Particle getBaseParticle(); List<GameItem> getParticles(); } IParticleEmitter \u63a5\u53e3\u6709\u4e00\u4e2a\u6e05\u7406\u8d44\u6e90\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a cleanup \uff0c\u8fd8\u6709\u4e00\u4e2a\u83b7\u53d6\u7c92\u5b50\u5217\u8868\u7684\u65b9\u6cd5\uff0c\u540d\u4e3a getParticles \u3002\u8fd8\u6709\u4e00\u4e2a\u540d\u4e3a getBaseParticle \u7684\u65b9\u6cd5\uff0c\u4f46\u662f\u8fd9\u4e2a\u65b9\u6cd5\u662f\u505a\u4ec0\u4e48\u7684\u5462\uff1f\u4e00\u4e2a\u7c92\u5b50\u53d1\u5c04\u5668\u5c06\u52a8\u6001\u5730\u4ea7\u751f\u8bb8\u591a\u4f8b\u5b50\u3002\u6bcf\u5f53\u4e00\u4e2a\u7c92\u5b50\u8fc7\u671f\uff0c\u5c31\u4f1a\u521b\u5efa\u65b0\u7684\u7c92\u5b50\u3002\u8be5\u7c92\u5b50\u66f4\u65b0\u5468\u671f\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u4f5c\u4e3a\u6a21\u677f\u521b\u5efa\u65b0\u7684\u52bf\u529b\u3002\u8fd9\u5c31\u662f\u57fa\u7840\u7c92\u5b50\u7684\u7528\u9014\uff0c\u8fd9\u4e5f\u662f\u4e3a\u4ec0\u4e48 Particle \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u590d\u5236\u6784\u9020\u51fd\u6570\u3002 \u5728\u6e38\u620f\u5f15\u64ce\u7684\u4ee3\u7801\u4e2d\uff0c\u6211\u4eec\u5c06\u53ea\u5f15\u7528 IParticleEmitter \u63a5\u53e3\uff0c\u56e0\u6b64\u57fa\u7840\u4ee3\u7801\u5c06\u4e0d\u4f9d\u8d56\u4e8e\u7279\u5b9a\u7684\u5b9e\u73b0\u3002\u4e0d\u8fc7\uff0c\u6211\u4eec\u53ef\u4ee5\u521b\u5efa\u4e00\u4e2a\u5b9e\u73b0\u6765\u6a21\u62df\u4e0d\u53d7\u91cd\u529b\u5f71\u54cd\u7684\u7c92\u5b50\u6d41\u3002\u8fd9\u4e2a\u5b9e\u73b0\u53ef\u4ee5\u7528\u6765\u6a21\u62df\u5149\u7ebf\u6216\u706b\u7130\uff0c\u540d\u4e3a FlowParticleEmitter \u3002 \u8fd9\u4e2a\u7c7b\u7684\u884c\u4e3a\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u8fdb\u884c\u8c03\u6574\uff1a \u4e00\u6b21\u80fd\u5b58\u5728\u7684\u6700\u5927\u7c92\u5b50\u6570\u91cf \u521b\u5efa\u7c92\u5b50\u7684\u6700\u77ed\u5468\u671f\u3002\u7c92\u5b50\u5c06\u5728\u6700\u77ed\u7684\u65f6\u95f4\u5185\u4e00\u4e2a\u63a5\u4e00\u4e2a\u5730\u521b\u5efa\uff0c\u4ee5\u907f\u514d\u7c92\u5b50\u7206\u53d1\u6027\u521b\u5efa\u3002 \u4e00\u7ec4\u8303\u56f4\uff0c\u4ee5\u968f\u673a\u7c92\u5b50\u901f\u5ea6\u548c\u4f4d\u7f6e\u3002\u65b0\u7c92\u5b50\u5c06\u4f7f\u7528\u57fa\u7840\u7c92\u5b50\u7684\u4f4d\u7f6e\u548c\u901f\u5ea6\uff0c\u53ef\u4ee5\u5728\u76f8\u5e94\u8303\u56f4\u5185\u53d6\u503c\uff0c\u4ee5\u5206\u6563\u5149\u7ebf\u3002 \u8be5\u7c7b\u7684\u5b9e\u73b0\u5982\u4e0b\uff1a package org.lwjglb.engine.graph.particles; import java.util.ArrayList; import java.util.Iterator; import java.util.List; import org.joml.Vector3f; import org.lwjglb.engine.items.GameItem; public class FlowParticleEmitter implements IParticleEmitter { private int maxParticles; private boolean active; private final List<GameItem> particles; private final Particle baseParticle; private long creationPeriodMillis; private long lastCreationTime; private float speedRndRange; private float positionRndRange; private float scaleRndRange; public FlowParticleEmitter(Particle baseParticle, int maxParticles, long creationPeriodMillis) { particles = new ArrayList<>(); this.baseParticle = baseParticle; this.maxParticles = maxParticles; this.active = false; this.lastCreationTime = 0; this.creationPeriodMillis = creationPeriodMillis; } @Override public Particle getBaseParticle() { return baseParticle; } public long getCreationPeriodMillis() { return creationPeriodMillis; } public int getMaxParticles() { return maxParticles; } @Override public List<GameItem> getParticles() { return particles; } public float getPositionRndRange() { return positionRndRange; } public float getScaleRndRange() { return scaleRndRange; } public float getSpeedRndRange() { return speedRndRange; } public void setCreationPeriodMillis(long creationPeriodMillis) { this.creationPeriodMillis = creationPeriodMillis; } public void setMaxParticles(int maxParticles) { this.maxParticles = maxParticles; } public void setPositionRndRange(float positionRndRange) { this.positionRndRange = positionRndRange; } public void setScaleRndRange(float scaleRndRange) { this.scaleRndRange = scaleRndRange; } public boolean isActive() { return active; } public void setActive(boolean active) { this.active = active; } public void setSpeedRndRange(float speedRndRange) { this.speedRndRange = speedRndRange; } public void update(long ellapsedTime) { long now = System.currentTimeMillis(); if (lastCreationTime == 0) { lastCreationTime = now; } Iterator<? extends GameItem> it = particles.iterator(); while (it.hasNext()) { Particle particle = (Particle) it.next(); if (particle.updateTtl(ellapsedTime) < 0) { it.remove(); } else { updatePosition(particle, ellapsedTime); } } int length = this.getParticles().size(); if (now - lastCreationTime >= this.creationPeriodMillis && length < maxParticles) { createParticle(); this.lastCreationTime = now; } } private void createParticle() { Particle particle = new Particle(this.getBaseParticle()); // \u6dfb\u52a0\u4e00\u4e9b\u968f\u673a\u7684\u7c92\u5b50 float sign = Math.random() > 0.5d ? -1.0f : 1.0f; float speedInc = sign * (float)Math.random() * this.speedRndRange; float posInc = sign * (float)Math.random() * this.positionRndRange; float scaleInc = sign * (float)Math.random() * this.scaleRndRange; particle.getPosition().add(posInc, posInc, posInc); particle.getSpeed().add(speedInc, speedInc, speedInc); particle.setScale(particle.getScale() + scaleInc); particles.add(particle); } /** * \u66f4\u65b0\u4e00\u4e2a\u7c92\u5b50\u7684\u4f4d\u7f6e * @param particle \u9700\u8981\u66f4\u65b0\u7684\u7c92\u5b50 * @param elapsedTime \u5df2\u7ecf\u8fc7\u7684\u65f6\u95f4\uff08\u6beb\u79d2\uff09 */ public void updatePosition(Particle particle, long elapsedTime) { Vector3f speed = particle.getSpeed(); float delta = elapsedTime / 1000.0f; float dx = speed.x * delta; float dy = speed.y * delta; float dz = speed.z * delta; Vector3f pos = particle.getPosition(); particle.setPosition(pos.x + dx, pos.y + dy, pos.z + dz); } @Override public void cleanup() { for (GameItem particle : getParticles()) { particle.cleanup(); } } } \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u62d3\u5c55 Scene \u7c7b\u4e2d\u5305\u542b\u7684\u6570\u636e\uff0c\u4f7f\u5176\u5305\u542b\u4e00\u4e2a ParticleEmitter \u7684\u5b9e\u4f8b\u6570\u7ec4\u3002 package org.lwjglb.engine; // \u8fd9\u662f\u5bfc\u5165\u2026\u2026 public class Scene { // \u8fd9\u6709\u66f4\u591a\u5c5e\u6027\u2026\u2026 private IParticleEmitter[] particleEmitters; \u5728\u8be5\u9636\u6bb5\uff0c\u6211\u4eec\u53ef\u4ee5\u5f00\u59cb\u6e32\u67d3\u7c92\u5b50\u3002\u7c92\u5b50\u4e0d\u4f1a\u53d7\u5230\u5149\u7684\u5f71\u54cd\uff0c\u4e5f\u4e0d\u4f1a\u4ea7\u751f\u4efb\u4f55\u97f3\u4e50\u3002\u5b83\u4eec\u4e0d\u4f1a\u6709\u4efb\u4f55\u9aa8\u9abc\u52a8\u753b\uff0c\u6240\u4ee5\u7528\u7279\u5b9a\u7684\u7740\u8272\u5668\u6e32\u67d3\u5b83\u4eec\u662f\u6ca1\u6709\u610f\u4e49\u7684\u3002\u7740\u8272\u5668\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u4f1a\u4f7f\u7528\u6295\u5f71\u548c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6e32\u67d3\u9876\u70b9\uff0c\u5e76\u4f7f\u7528\u7eb9\u7406\u8bbe\u7f6e\u989c\u8272\u3002 \u9876\u70b9\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); outTexCoord = texCoord; } \u7247\u5143\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 in vec2 outTexCoord; in vec3 mvPos; out vec4 fragColor; uniform sampler2D texture_sampler; void main() { fragColor = texture(texture_sampler, outTexCoord); } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u975e\u5e38\u7b80\u5355\uff0c\u5c31\u50cf\u6e32\u67d3\u4e00\u7ae0\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u3002\u73b0\u5728\uff0c\u548c\u5176\u4ed6\u7ae0\u8282\u4e00\u6837\uff0c\u6211\u4eec\u9700\u8981\u5728 Renderer \u7c7b\u4e2d\u8bbe\u7f6e\u548c\u4f7f\u7528\u8fd9\u4e9b\u7740\u8272\u5668\u3002\u7740\u8272\u5668\u7684\u8bbe\u7f6e\u5c06\u5728\u4e00\u4e2a\u540d\u4e3a setupParticlesShader \u7684\u65b9\u6cd5\u4e2d\u5b8c\u6210\uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\uff1a private void setupParticlesShader() throws Exception { particlesShaderProgram = new ShaderProgram(); particlesShaderProgram.createVertexShader(Utils.loadResource(\"/shaders/particles_vertex.vs\")); particlesShaderProgram.createFragmentShader(Utils.loadResource(\"/shaders/particles_fragment.fs\")); particlesShaderProgram.link(); particlesShaderProgram.createUniform(\"projectionMatrix\"); particlesShaderProgram.createUniform(\"modelViewMatrix\"); particlesShaderProgram.createUniform(\"texture_sampler\"); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u5728Renderer\u7c7b\u4e2d\u521b\u5efa\u6e32\u67d3\u65b9\u6cd5 renderParticles \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderParticles(Window window, Camera camera, Scene scene) { particlesShaderProgram.bind(); particlesShaderProgram.setUniform(\"texture_sampler\", 0); Matrix4f projectionMatrix = transformation.getProjectionMatrix(); particlesShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); Matrix4f viewMatrix = transformation.getViewMatrix(); IParticleEmitter[] emitters = scene.getParticleEmitters(); int numEmitters = emitters != null ? emitters.length : 0; for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(gameItem, viewMatrix); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } particlesShaderProgram.unbind(); } \u5982\u679c\u4f60\u52aa\u529b\u9605\u8bfb\uff0c\u4e0a\u8ff0\u4ee3\u7801\u5e94\u8be5\u662f\u4e0d\u8a00\u81ea\u660e\u7684\uff0c\u5b83\u53ea\u662f\u8bbe\u7f6e\u5fc5\u8981\u7684Uniform\uff0c\u5e76\u6e32\u67d3\u6bcf\u4e2a\u7c92\u5b50\u3002\u73b0\u5728\uff0c\u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u6d4b\u8bd5\u7c92\u5b50\u6548\u679c\u5b9e\u73b0\u6240\u9700\u7684\u6240\u6709\u65b9\u6cd5\uff0c\u53ea\u9700\u8981\u4fee\u6539 DummyGame \u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u521b\u5efa\u7c92\u5b50\u53d1\u5c04\u5668\u548c\u57fa\u672c\u7c92\u5b50\u7684\u7279\u6027\u3002 Vector3f particleSpeed = new Vector3f(0, 1, 0); particleSpeed.mul(2.5f); long ttl = 4000; int maxParticles = 200; long creationPeriodMillis = 300; float range = 0.2f; float scale = 0.5f; Mesh partMesh = OBJLoader.loadMesh(\"/models/particle.obj\"); Texture texture = new Texture(\"/textures/particle_tmp.png\"); Material partMaterial = new Material(texture, reflectance); partMesh.setMaterial(partMaterial); Particle particle = new Particle(partMesh, particleSpeed, ttl); particle.setScale(scale); particleEmitter = new FlowParticleEmitter(particle, maxParticles, creationPeriodMillis); particleEmitter.setActive(true); particleEmitter.setPositionRndRange(range); particleEmitter.setSpeedRndRange(range); this.scene.setParticleEmitters(new FlowParticleEmitter[] {particleEmitter}); \u6211\u4eec\u73b0\u5728\u4f7f\u7528\u4e00\u4e2a\u666e\u901a\u586b\u5145\u5706\u4f5c\u4e3a\u7c92\u5b50\u7684\u7eb9\u7406\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u5982\u679c\u4f60\u8fd0\u884c\u5b83\uff0c\u4f60\u4f1a\u770b\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u4e3a\u4ec0\u4e48\u4e00\u4e9b\u7c92\u5b50\u4f3c\u4e4e\u88ab\u5207\u65ad\u4e86\uff1f\u4e3a\u4ec0\u4e48\u900f\u660e\u7684\u80cc\u666f\u4e0d\u80fd\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff1f\u539f\u56e0\u662f\u6df1\u5ea6\u6d4b\u8bd5\u3002\u7c92\u5b50\u7684\u4e00\u4e9b\u7247\u5143\u88ab\u4e22\u5f03\uff0c\u56e0\u4e3a\u5b83\u4eec\u5177\u6709\u6bd4\u8be5\u533a\u57df\u7684\u6df1\u5ea6\u7f13\u51b2\u7684\u5f53\u524d\u503c\u9ad8\u7684\u6df1\u5ea6\u503c\u3002\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u5c06\u5176\u4e0e\u6444\u50cf\u673a\u4e4b\u95f4\u7684\u8ddd\u79bb\u6765\u6392\u5e8f\u7c92\u5b50\u4ee5\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6216\u8005\u6211\u4eec\u53ef\u4ee5\u7981\u7528\u6df1\u5ea6\u5199\u5165\u3002 \u5728\u7ed8\u5236\u7c92\u5b50\u4e4b\u524d\u6211\u4eec\u9700\u8981\u63d2\u5165\u8fd9\u4e00\u884c\u4ee3\u7801\uff1a glDepthMask(false); \u7136\u540e\u5728\u6211\u4eec\u5b8c\u6210\u6e32\u67d3\u4e4b\u540e\u8fd8\u539f\u4e3a\u5148\u524d\u503c\uff1a glDepthMask(true); \u7136\u540e\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u4e1c\u897f\uff1a \u597d\u4e86\uff0c\u95ee\u9898\u89e3\u51b3\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u60f3\u5e94\u7528\u53e6\u4e00\u79cd\u6548\u679c\uff0c\u6211\u4eec\u5e0c\u671b\u989c\u8272\u88ab\u6df7\u5408\uff0c\u56e0\u6b64\u989c\u8272\u5c06\u88ab\u6dfb\u52a0\uff0c\u4ee5\u8fbe\u6210\u66f4\u597d\u7684\u6548\u679c\u3002\u8fd9\u662f\u5728\u6e32\u67d3\u524d\u589e\u52a0\u5982\u4e0b\u4e00\u884c\u4ee3\u7801\u6765\u5b9e\u73b0\u7684\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE); \u4e0e\u6df1\u5ea6\u7684\u60c5\u51b5\u4e00\u6837\uff0c\u6e32\u67d3\u5b8c\u6240\u6709\u7c92\u5b50\u540e\uff0c\u6211\u4eec\u5c06\u6df7\u5408\u51fd\u6570\u6062\u590d\u4e3a\uff1a glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); \u73b0\u5728\u6211\u4eec\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a \u4f46\u6211\u4eec\u8fd8\u6ca1\u6709\u5b8c\u6210\u5b83\u3002\u5982\u679c\u4f60\u628a\u6444\u50cf\u673a\u79fb\u5230\u84dd\u8272\u6b63\u65b9\u5f62\u7684\u4e0a\u65b9\u5f80\u4e0b\u770b\uff0c\u4f60\u53ef\u80fd\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u4e1c\u897f\uff1a \u8fd9\u4e9b\u7c92\u5b50\u770b\u8d77\u6765\u4e0d\u592a\u597d\uff0c\u5b83\u4eec\u5e94\u8be5\u662f\u5706\u7684\uff0c\u4f46\u73b0\u5728\u770b\u8d77\u6765\u50cf\u4e00\u5f20\u7eb8\u3002\u5728\u6b64\u4e4b\u4e0a\uff0c\u6211\u4eec\u5e94\u8be5\u5e94\u7528\u9762\u677f\u6280\u672f\u3002\u7528\u4e8e\u6e32\u67d3\u7c92\u5b50\u7684\u56db\u8fb9\u5f62\u5e94\u8be5\u59cb\u7ec8\u9762\u5411\u6444\u50cf\u673a\uff0c\u4e0e\u6444\u50cf\u673a\u65b9\u5411\u5b8c\u5168\u5782\u76f4\uff0c\u5c31\u597d\u50cf\u6839\u672c\u6ca1\u6709\u65cb\u8f6c\u4e00\u6837\u3002\u6444\u50cf\u673a\u7684\u77e9\u9635\u5c06\u4f4d\u79fb\u548c\u65cb\u8f6c\u5e94\u7528\u4e8e\u573a\u666f\u4e2d\u7684\u6bcf\u4e00\u4e2a\u5bf9\u8c61\uff0c\u6211\u4eec\u60f3\u8df3\u8fc7\u5c06\u8981\u5e94\u7528\u7684\u65cb\u8f6c\u3002 \u8b66\u544a\uff1a\u5728\u8bb2\u6570\u5b66\u77e5\u8bc6\u65f6\uff0c\u5982\u679c\u4f60\u89c9\u5f97\u4e0d\u8212\u670d\uff0c\u4f60\u53ef\u4ee5\u8df3\u8fc7\u5b83\u3002\u8ba9\u6211\u4eec\u518d\u6b21\u56de\u987e\u90a3\u4e2a\u89c2\u5bdf\u77e9\u9635\u3002\u8be5\u77e9\u9635\u53ef\u4ee5\u50cf\u8fd9\u6837\u8868\u793a\uff08\u6ca1\u6709\u5e94\u7528\u4efb\u4f55\u7f29\u653e\uff09\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{r_{00}} & \\color{red}{r_{10}} & \\color{red}{r_{20}} & \\color{blue}{dx} \\\\ \\color{red}{r_{01}} & \\color{red}{r_{11}} & \\color{red}{r_{21}} & \\color{blue}{dy} \\\\ \\color{red}{r_{02}} & \\color{red}{r_{12}} & \\color{red}{r_{22}} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u7ea2\u8272\u7684\u5143\u7d20\u4ee3\u8868\u6444\u50cf\u673a\u7684\u65cb\u8f6c\uff0c\u84dd\u8272\u7684\u5143\u7d20\u4ee3\u8868\u4f4d\u79fb\u3002\u6211\u4eec\u9700\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u4e2d\u7684\u5de6\u4e0a\u89d23x3\u77e9\u9635\u7684\u65cb\u8f6c\u6548\u679c\uff0c\u6240\u4ee5\u5b83\u4f1a\u53d8\u6210\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & \\color{blue}{dx} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & \\color{blue}{dy} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & \\color{blue}{dz} \\\\ 0 & 0 & 0 & 1 \\end{bmatrix} \u5728\u5de6\u4e0a\u89d2\u7684\u7ea2\u8272\u90e8\u5206\uff0c\u6211\u4eec\u6709\u4e00\u4e2a3x3\u77e9\u9635\uff0c\u628a\u5b83\u547d\u540d\u4e3a M_{r} \u5e76\u4e14\u6211\u4eec\u60f3\u628a\u5b83\u8f6c\u6362\u6210\u5355\u4f4d\u77e9\u9635\uff1a I \u3002\u4efb\u4f55\u77e9\u9635\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\u90fd\u4f1a\u5f97\u5230\u5355\u4f4d\u77e9\u9635\uff1a M_{r} \\times M_{r}^{-1} = I \u3002\u6211\u4eec\u53ea\u9700\u8981\u4ece\u89c2\u5bdf\u77e9\u9635\u4e2d\u53d6\u5de6\u4e0a\u89d2\u76843x3\u77e9\u9635\uff0c\u7136\u540e\u4e58\u4ee5\u5b83\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u8fd8\u53ef\u4ee5\u4f18\u5316\u4ed6\u3002\u4e00\u4e2a\u65cb\u8f6c\u77e9\u9635\u6709\u4e00\u4e2a\u6709\u8da3\u7684\u5b9a\u7406\uff0c\u5b83\u7684\u9006\u77e9\u9635\u4e0e\u5176\u8f6c\u7f6e\u77e9\u9635\u76f8\u7b49\u3002\u5373\uff1a M_{r} \\times M_{r}^{-1} = M_{r} \\times M_{r}^{T} = I \u3002\u8f6c\u7f6e\u77e9\u9635\u6bd4\u9006\u77e9\u9635\u66f4\u5bb9\u6613\u8ba1\u7b97\u3002\u77e9\u9635\u7684\u8f6c\u7f6e\u5c31\u50cf\u5c06\u5176\u53cd\u8f6c\u8fc7\u6765\uff0c\u5c06\u6bcf\u4e00\u5217\u4e0e\u6bcf\u4e00\u884c\u66ff\u6362\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} r_{00} & r_{10} & r_{20} \\\\ r_{01} & r_{11} & r_{21} \\\\ r_{02} & r_{12} & r_{22} \\end{bmatrix} ^{T} = \\begin{bmatrix} r_{00} & r_{01} & r_{02} \\\\ r_{10} & r_{11} & r_{12} \\\\ r_{20} & r_{21} & r_{22} \\end{bmatrix} \u597d\u7684\uff0c\u8ba9\u6211\u4eec\u603b\u7ed3\u4e00\u4e0b\u3002\u6211\u4eec\u6709\u8be5\u53d8\u6362\uff1a V \\times M \uff0c\u5176\u4e2d V \u662f\u89c2\u5bdf\u77e9\u9635\uff0c M \u662f\u6a21\u578b\u77e9\u9635\u3002\u6211\u4eec\u53ef\u4ee5\u8fd9\u6837\u8868\u8fbe\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{m_{00}} & \\color{red}{m_{10}} & \\color{red}{m_{20}} & m_{30} \\\\ \\color{red}{m_{01}} & \\color{red}{m_{11}} & \\color{red}{m_{21}} & m_{31} \\\\ \\color{red}{m_{02}} & \\color{red}{m_{12}} & \\color{red}{m_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u6211\u4eec\u60f3\u8981\u53d6\u6d88\u89c2\u5bdf\u77e9\u9635\u7684\u65cb\u8f6c\uff0c\u5f97\u5230\u8fd9\u6837\u7684\u7ed3\u679c\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{1} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{1} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{1} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u4e3a\u89c2\u5bdf\u77e9\u9635\u4e0a3x3\u90e8\u5206\u7684\u8f6c\u7f6e\u77e9\u9635\u3002 <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{10}} & \\color{red}{v_{20}} & v_{30} \\\\ \\color{red}{v_{01}} & \\color{red}{v_{11}} & \\color{red}{v_{21}} & v_{31} \\\\ \\color{red}{v_{02}} & \\color{red}{v_{12}} & \\color{red}{v_{22}} & v_{32} \\\\ v_{03} & v_{13} & v_{23} & v_{33} \\end{bmatrix} \\times \\begin{bmatrix} \\color{red}{v_{00}} & \\color{red}{v_{01}} & \\color{red}{v_{02}} & m_{30} \\\\ \\color{red}{v_{10}} & \\color{red}{v_{11}} & \\color{red}{v_{12}} & m_{31} \\\\ \\color{red}{v_{20}} & \\color{red}{v_{21}} & \\color{red}{v_{22}} & m_{32} \\\\ m_{03} & m_{13} & m_{23} & m_{33} \\end{bmatrix} \u4f46\u5728\u8fd9\u4e4b\u540e\uff0c\u6211\u4eec\u53bb\u6389\u4e86\u7f29\u653e\uff0c\u5b9e\u9645\u4e0a\u771f\u6b63\u60f3\u8981\u8fbe\u5230\u7684\u7ed3\u679c\u662f\u8fd9\u6837\uff1a <script type=\"math/tex; mode=display\">\\begin{bmatrix} \\color{red}{sx} & \\color{red}{0} & \\color{red}{0} & mv_{30} \\\\ \\color{red}{0} & \\color{red}{sy} & \\color{red}{0} & mv_{31} \\\\ \\color{red}{0} & \\color{red}{0} & \\color{red}{sz} & mv_{32} \\\\ mv_{03} & mv_{13} & mv_{23} & mv_{33} \\end{bmatrix} \u5176\u4e2dsx\uff0csy\u548csz\u5c31\u662f\u7f29\u653e\u7cfb\u6570\u3002\u56e0\u6b64\uff0c\u5f53\u6211\u4eec\u5c06\u6a21\u578b\u77e9\u9635\u7684\u5de6\u4e0a3x3\u77e9\u9635\u8bbe\u7f6e\u4e3a\u89c2\u5bdf\u77e9\u9635\u7684\u8f6c\u7f6e\u77e9\u9635\u540e\uff0c\u6211\u4eec\u9700\u8981\u518d\u6b21\u5e94\u7528\u7f29\u653e\u3002 \u5c31\u8fd9\u4e9b\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5728 renderParticlesMethod \u4e2d\u50cf\u8fd9\u6837\u4fee\u6539\uff1a for (int i = 0; i < numEmitters; i++) { IParticleEmitter emitter = emitters[i]; Mesh mesh = emitter.getBaseParticle().getMesh(); mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); viewMatrix.transpose3x3(modelMatrix); Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.scale(gameItem.getScale()); particlesShaderProgram.setUniform(\"modelViewMatrix\", modelViewMatrix); } ); } \u6211\u4eec\u8fd8\u5728 Transformation \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u4f7f\u7528\u4e24\u4e2a\u77e9\u9635\u6765\u6784\u9020\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u800c\u4e0d\u662f\u4f7f\u7528 GameItem \u548c\u89c2\u5bdf\u77e9\u9635\u3002 \u6709\u4e86\u5982\u4e0a\u66f4\u6539\uff0c\u5f53\u4ece\u4e0a\u65b9\u89c2\u5bdf\u7c92\u5b50\u65f6\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a \u73b0\u5728\u96c6\u9f50\u4e86\u521b\u5efa\u4e00\u4e2a\u66f4\u771f\u5b9e\u7684\u7c92\u5b50\u6548\u679c\u6240\u9700\u8981\u7684\u6240\u6709\u8981\u7d20\uff0c\u6240\u4ee5\u8ba9\u6211\u4eec\u5c06\u5176\u6539\u4e3a\u66f4\u7cbe\u7ec6\u7684\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5982\u4e0b\u56fe\u7247\uff08\u5b83\u662f\u7531 GIMP \u521b\u4f5c\u7684\uff0c\u5e26\u6709\u5149\u7167\u548c\u9634\u5f71\u8fc7\u6ee4\u5668\uff09\uff1a \u6709\u4e86\u5982\u4e0a\u7eb9\u7406\uff0c\u6211\u4eec\u4f1a\u5f97\u5230\u5982\u4e0b\u6240\u793a\u7684\u7c92\u5b50\uff1a \u73b0\u5728\u66f4\u597d\u4e86\uff01\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u6211\u4eec\u9700\u8981\u8c03\u6574\u7f29\u653e\uff0c\u56e0\u4e3a\u7c92\u5b50\u73b0\u5728\u603b\u662f\u5bf9\u7740\u6444\u50cf\u673a\uff0c\u663e\u793a\u7684\u9762\u79ef\u603b\u662f\u6700\u5927\u7684\u3002 \u6700\u540e\uff0c\u518d\u63d0\u4e00\u70b9\uff0c\u4e3a\u4e86\u5f97\u5230\u53ef\u4ee5\u5728\u4efb\u4f55\u573a\u666f\u4f7f\u7528\u7684\u5b8c\u7f8e\u7684\u6548\u679c\uff0c\u4f60\u9700\u8981\u5b9e\u73b0\u7c92\u5b50\u6392\u5e8f\u548c\u542f\u7528\u6df1\u5ea6\u7f13\u51b2\u533a\u3002\u65e0\u8bba\u5982\u4f55\uff0c\u8fd9\u91cc\u6709\u4e00\u4e2a\u793a\u4f8b\u53ef\u4ee5\u5c06\u8fd9\u79cd\u6548\u679c\u56ca\u62ec\u5230\u4f60\u7684\u6e38\u620f\u4e2d\u3002","title":"\u57fa\u7840"},{"location":"20-particles/#texture-atlas","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u505a\u597d\u4e86\u7c92\u5b50\u6548\u679c\u7684\u57fa\u7840\u5efa\u8bbe\uff0c\u73b0\u5728\u53ef\u4ee5\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e9b\u52a8\u753b\u6548\u679c\u4e86\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u5c06\u652f\u6301\u7eb9\u7406\u96c6\u3002\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09\u662f\u4e00\u4e2a\u5305\u542b\u6240\u6709\u5c06\u8981\u4f7f\u7528\u7684\u7eb9\u7406\u7684\u5927\u578b\u56fe\u7247\u3002\u4f7f\u7528\u7eb9\u7406\u96c6\uff0c\u6211\u4eec\u5c31\u53ea\u9700\u8981\u52a0\u8f7d\u4e00\u4e2a\u5927\u7684\u56fe\u7247\uff0c\u7136\u540e\u518d\u7ed8\u5236\u6e38\u620f\u9879\u65f6\uff0c\u9009\u62e9\u8be5\u56fe\u50cf\u7684\u4e00\u90e8\u5206\u4f5c\u4e3a\u7eb9\u7406\u3002\u4f8b\u5982\uff0c\u5f53\u6211\u4eec\u60f3\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u591a\u6b21\u6e32\u67d3\u76f8\u540c\u7684\u6a21\u578b\u65f6\uff08\u4f8b\u5982\u6811\u6216\u5ca9\u77f3\uff09\uff0c\u53ef\u4ee5\u4f7f\u7528\u8fd9\u79cd\u6280\u672f\u3002\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u76f8\u540c\u7684\u7eb9\u7406\u96c6\u5e76\u9009\u62e9\u9002\u5f53\u7684\u5750\u6807\uff0c\u800c\u4e0d\u662f\u4f7f\u7528\u5f88\u591a\u7eb9\u7406\u5b9e\u4f8b\u5e76\u5728\u5b83\u4eec\u4e4b\u95f4\u5207\u6362\uff08\u8bb0\u4f4f\uff0c\u5207\u6362\u72b6\u6001\u603b\u662f\u5f88\u6162\u7684\uff09\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7eb9\u7406\u5750\u6807\u6765\u6dfb\u52a0\u7c92\u5b50\u52a8\u753b\u3002\u6211\u4eec\u904d\u5386\u4e0d\u540c\u7684\u7eb9\u7406\u6765\u4e3a\u7c92\u5b50\u52a8\u753b\u5efa\u6a21\uff0c\u6240\u6709\u8fd9\u4e9b\u7eb9\u7406\u5c06\u88ab\u5206\u5230\u4e00\u4e2a\u50cf\u8fd9\u6837\u7684\u7eb9\u7406\u96c6\uff1a \u7eb9\u7406\u96c6\u53ef\u4ee5\u88ab\u5212\u5206\u4e3a\u591a\u4e2a\u65b9\u5f62\u7247\u6bb5\u3002\u6211\u4eec\u5c06\u4e00\u4e2a\u65b9\u5f62\u7247\u6bb5\u5750\u6807\u5206\u914d\u5230\u4e00\u4e2a\u7c92\u5b50\u4e0a\uff0c\u5e76\u968f\u7740\u65f6\u95f4\u63a8\u79fb\u6539\u53d8\u5b83\u4ee5\u8868\u793a\u52a8\u753b\u3002\u8ba9\u6211\u4eec\u5f00\u59cb\u5427\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u4fee\u6539 Texture \u7c7b\u6765\u6307\u5b9a\u7eb9\u7406\u96c6\u53ef\u4ee5\u62e5\u6709\u7684\u884c\u6570\u548c\u5217\u6570\u3002 package org.lwjglb.engine.graph; // .. \u8fd9\u91cc\u662f\u5bfc\u5165 public class Texture { // \u65e0\u5173\u5c5e\u6027\u7701\u7565 private int numRows = 1; private int numCols = 1; // \u65e0\u5173\u4ee3\u7801\u7701\u7565 public Texture(String fileName, int numCols, int numRows) throws Exception { this(fileName); this.numCols = numCols; this.numRows = numRows; } \u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5904\u7406\u7684\u7eb9\u7406\u7684\u5217\u6570\u548c\u884c\u6570\u7b49\u4e8e1\u3002\u6211\u4eec\u8fd8\u6dfb\u52a0\u4e86\u53e6\u4e00\u4e2a\u6784\u9020\u51fd\u6570\u6765\u6307\u5b9a\u884c\u548c\u5217\u3002 \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ffd\u8e2a\u4e00\u4e2a GameItem \u5728\u7eb9\u7406\u96c6\u4e2d\u7684\u5750\u6807\uff0c\u56e0\u6b64\u53ea\u9700\u5411\u8be5\u7c7b\u6dfb\u52a0\u53e6\u4e00\u4e2a\u5c5e\u6027\uff0c\u9ed8\u8ba4\u503c\u4e3a0\u3002 package org.lwjglb.engine.items; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; public class GameItem { // \u66f4\u591a\u5c5e\u6027\u7701\u7565 private int textPos; \u7136\u540e\u6211\u4eec\u4fee\u6539 Particle \u7c7b\uff0c\u4ee5\u4fbf\u80fd\u591f\u901a\u8fc7\u7eb9\u7406\u96c6\u81ea\u52a8\u8fed\u4ee3\u3002 package org.lwjglb.engine.graph.particles; import org.joml.Vector3f; import org.lwjglb.engine.graph.Mesh; import org.lwjglb.engine.graph.Texture; import org.lwjglb.engine.items.GameItem; public class Particle extends GameItem { private long updateTextureMillis; private long currentAnimTimeMillis; \u5c5e\u6027 updateTextureMillis \u5b9a\u4e49\u79fb\u52a8\u5230\u7eb9\u7406\u96c6\u4e2d\u4e0b\u4e00\u4e2a\u5750\u6807\u7684\u65f6\u95f4\uff08\u4ee5\u6beb\u79d2\u4e3a\u5355\u4f4d\uff09\u3002\u6570\u503c\u6708\u5e95\uff0c\u7c92\u5b50\u5728\u7eb9\u7406\u4e0a\u53d8\u5316\u7684\u901f\u5ea6\u5c31\u8d8a\u5feb\u3002\u5c5e\u6027 currentAnimTimeMillis \u53ea\u662f\u8ddf\u8e2a\u7eb9\u7406\u6301\u7eed\u5f53\u524d\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Particle \u7c7b\u6784\u9020\u51fd\u6570\u6765\u8bbe\u7f6e\u8fd9\u4e9b\u503c\u3002\u6211\u4eec\u8fd8\u8ba1\u7b97\u4e86\u7eb9\u7406\u96c6\u7684\u7247\u6bb5\u6570\u91cf\uff0c\u5b83\u662f\u7531\u5c5e\u6027 animFrames \u5b9a\u4e49\u7684\u3002 public Particle(Mesh mesh, Vector3f speed, long ttl, long updateTextureMillis) { super(mesh); this.speed = new Vector3f(speed); this.ttl = ttl; this.updateTextureMills = updateTextureMills; this.currentAnimTimeMillis = 0; Texture texture = this.getMesh().getMaterial().getTexture(); this.animFrames = texture.getNumCols() * texture.getNumRows(); } \u73b0\u5728\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4fee\u6539\u68c0\u67e5\u7c92\u5b50\u662f\u5426\u5df2\u7ecf\u8fc7\u671f\u7684\u65b9\u6cd5\uff0c\u6765\u68c0\u67e5\u662f\u5426\u9700\u8981\u66f4\u65b0\u7eb9\u7406\u5750\u6807\u3002 public long updateTtl(long elapsedTime) { this.ttl -= elapsedTime; this.currentAnimTimeMillis += elapsedTime; if ( this.currentAnimTimeMillis >= this.getUpdateTextureMillis() && this.animFrames > 0 ) { this.currentAnimTimeMillis = 0; int pos = this.getTextPos(); pos++; if ( pos < this.animFrames ) { this.setTextPos(pos); } else { this.setTextPos(0); } } return this.ttl; } \u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u8fd8\u4fee\u6539\u4e86 FlowRangeEmitter \u7c7b\uff0c\u5728\u5e94\u8be5\u6539\u53d8\u7c92\u5b50\u7eb9\u7406\u5750\u6807\u7684\u65f6\u95f4\u5468\u671f\u4e0a\u589e\u52a0\u4e86\u4e00\u4e9b\u968f\u673a\u6027\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u73b0\u5728\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u8fd9\u4e9b\u6570\u636e\u6765\u8bbe\u7f6e\u5408\u9002\u7684\u7eb9\u7406\u5750\u6807\u3002\u6211\u4eec\u5c06\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u8fdb\u884c\u8fd9\u4e00\u64cd\u4f5c\uff0c\u56e0\u4e3a\u5b83\u8f93\u51fa\u4e86\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u7684\u90a3\u4e9b\u503c\u3002\u8fd9\u4e2a\u65b0\u7740\u8272\u5668\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; out vec2 outTexCoord; uniform mat4 modelViewMatrix; uniform mat4 projectionMatrix; uniform float texXOffset; uniform float texYOffset; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texXOffset); float y = (texCoord.y / numRows + texYOffset); outTexCoord = vec2(x, y); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u73b0\u5728\u6709\u4e09\u4e2a\u65b0Uniform\u3002Uniform numCols \u548c numRows \u53ea\u50a8\u5b58\u7eb9\u7406\u96c6\u7684\u5217\u548c\u884c\u6570\u3002\u4e3a\u4e86\u8ba1\u7b97\u7eb9\u7406\u5750\u6807\uff0c\u9996\u5148\u5fc5\u987b\u7f29\u5c0f\u8fd9\u4e9b\u53c2\u6570\u3002\u6bcf\u4e2a\u7247\u6bb5\u7684\u5bbd\u5ea6\u4e3a 1 / numCols \uff0c\u9ad8\u5ea6\u4e3a 1 / numRows \uff0c\u5982\u4e0b\u56fe\u6240\u793a\u3002 \u7136\u540e\u6211\u4eec\u53ea\u9700\u8981\u6839\u636e\u884c\u548c\u5217\u5e94\u7528\u548c\u504f\u79fb\uff0c\u8fd9\u662f\u7531 texXOffset \u548c texYOffset Uniform\u5b9a\u4e49\u7684\u3002 \u6211\u4eec\u5c06\u5728 Renderer \u7c7b\u4e2d\u8ba1\u7b97\u8fd9\u4e9b\u504f\u79fb\u91cf\uff0c\u5982\u4e0b\u8ff0\u4ee3\u7801\u6240\u793a\u3002\u6211\u4eec\u6839\u636e\u6bcf\u4e2a\u7c92\u5b50\u7684\u5750\u6807\u8ba1\u7b97\u5b83\u4eec\u6240\u5904\u7684\u884c\u548c\u5217\uff0c\u5e76\u5c06\u504f\u79fb\u91cf\u8ba1\u7b97\u4e3a\u7247\u6bb5\u9ad8\u5ea6\u548c\u5bbd\u5ea6\u7684\u500d\u6570\u3002 mesh.renderList((emitter.getParticles()), (GameItem gameItem) -> { int col = gameItem.getTextPos() % text.getNumCols(); int row = gameItem.getTextPos() / text.getNumCols(); float textXOffset = (float) col / text.getNumCols(); float textYOffset = (float) row / text.getNumRows(); particlesShaderProgram.setUniform(\"texXOffset\", textXOffset); particlesShaderProgram.setUniform(\"texYOffset\", textYOffset); \u6ce8\u610f\uff0c\u5982\u679c\u4f60\u53ea\u9700\u8981\u652f\u6301\u6b63\u65b9\u5f62\u7eb9\u7406\u96c6\uff0c\u4f60\u53ea\u9700\u8981\u4e24\u4e2aUniform\u3002\u6700\u7ec8\u7684\u6548\u679c\u662f\u8fd9\u6837\u7684\uff1a \u73b0\u5728\uff0c\u6211\u4eec\u6709\u4e86\u7c92\u5b50\u52a8\u753b\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u4f18\u5316\u6e32\u67d3\u6d41\u7a0b\u3002\u6211\u4eec\u6b63\u5728\u6e32\u67d3\u5177\u6709\u76f8\u540c\u7f51\u683c\u7684\u591a\u4e2a\u5143\u7d20\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u5143\u7d20\u8fdb\u884c\u7ed8\u5236\u8c03\u7528\u3002\u5728\u4e0b\u7ae0\u4e2d\uff0c\u6211\u4eec\u8bb2\u5b66\u4e60\u5982\u4f55\u5728\u5355\u4e2a\u8c03\u7528\u4e2d\u6e32\u67d3\u5b83\u4eec\u3002\u8fd9\u79cd\u6280\u672f\u4e0d\u4ec5\u9002\u7528\u4e8e\u7c92\u5b50\uff0c\u4e5f\u9002\u7528\u4e8e\u6e32\u67d3\u5171\u4eab\u540c\u4e00\u6a21\u578b\uff0c\u4f46\u88ab\u653e\u5728\u4e0d\u540c\u4f4d\u7f6e\u6216\u5177\u6709\u4e0d\u540c\u7eb9\u7406\u7684\u591a\u4e2a\u5143\u7d20\u7684\u573a\u666f\u3002","title":"\u7eb9\u7406\u96c6\uff08Texture Atlas\uff09"},{"location":"21-instanced-rendering/","text":"\u5b9e\u4f8b\u5316\u6e32\u67d3\uff08Instanced Rendering\uff09 \u5f88\u591a\u5b9e\u4f8b \u5728\u7ed8\u5236\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u7ecf\u5e38\u4f1a\u6709\u8bb8\u591a\u6a21\u578b\u7528\u76f8\u540c\u7684\u7f51\u683c\u8868\u793a\uff0c\u4f46\u5b83\u4eec\u5177\u6709\u4e0d\u540c\u7684\u53d8\u6362\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5c3d\u7ba1\u5b83\u4eec\u53ef\u80fd\u662f\u53ea\u6709\u51e0\u4e2a\u4e09\u89d2\u5f62\u7684\u7b80\u5355\u7269\u4f53\uff0c\u4f46\u6027\u80fd\u4ecd\u53ef\u80fd\u4f1a\u53d7\u5230\u5f71\u54cd\uff0c\u8fd9\u80cc\u540e\u7684\u539f\u56e0\u5c31\u662f\u6211\u4eec\u6e32\u67d3\u5b83\u4eec\u7684\u65b9\u5f0f\u3002 \u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5faa\u73af\u4e2d\u904d\u5386\u6240\u6709\u6e38\u620f\u9879\uff0c\u5e76\u5bf9\u51fd\u6570 glDrawElements \u8fdb\u884c\u8c03\u7528\u3002\u5982\u524d\u51e0\u7ae0\u6240\u8bf4\u7684\uff0c\u5bf9OpenGL\u5e93\u7684\u8c03\u7528\u5e94\u8be5\u6700\u5c0f\u5316\u3002\u5bf9\u51fd\u6570 glDrawElements \u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u9020\u6210\u4e00\u5b9a\u5f00\u9500\u3002\u8fd9\u5bf9\u4e8e\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u4f1a\u53cd\u590d\u4ea7\u751f\u5f00\u9500\u3002 \u5728\u5904\u7406\u5927\u91cf\u76f8\u4f3c\u7269\u4f53\u65f6\uff0c\u4f7f\u7528\u4e00\u6b21\u8c03\u7528\u6e32\u67d3\u6240\u6709\u8fd9\u4e9b\u7269\u4f53\u4f1a\u66f4\u6709\u6548\u3002\u8fd9\u79cd\u6280\u672f\u88ab\u79f0\u4e3a\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u4e3a\u4e86\u5b9e\u73b0\u540c\u65f6\u6e32\u67d3\u4e00\u7ec4\u5143\u7d20\uff0cOpenGL\u63d0\u4f9b\u4e86\u4e00\u7ec4\u540d\u4e3a glDrawXXXInstanced \u7684\u51fd\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u6b63\u5728\u7ed8\u5236\u5143\u7d20\uff0c\u6240\u4ee5\u5c06\u4f7f\u7528\u540d\u4e3a glDrawElementsInstanced \u7684\u51fd\u6570\u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e0e glDrawElements \u76f8\u540c\u7684\u53c2\u6570\uff0c\u5916\u52a0\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6e\u8981\u7ed8\u5236\u7684\u5b9e\u4f8b\u6570\u3002 \u8fd9\u662f\u4e00\u4e2a\u5982\u4f55\u4f7f\u7528 glDrawElements \u7684\u793a\u4f8b\uff1a glDrawElements(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0) \u4ee5\u4e0b\u662f\u5b9e\u4f8b\u5316\u7248\u672c\u7684\u7528\u6cd5: glDrawElementsInstanced(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0, numInstances); \u4f46\u662f\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\uff0c\u5982\u4f55\u4e3a\u6bcf\u4e2a\u5b9e\u4f8b\u8bbe\u7f6e\u4e0d\u540c\u7684\u53d8\u6362\u3002\u73b0\u5728\uff0c\u5728\u7ed8\u5236\u6bcf\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Uniform\u6765\u4f20\u9012\u4e0d\u540c\u7684\u53d8\u6362\u548c\u5b9e\u4f8b\u76f8\u5173\u7684\u6570\u636e\u3002\u5728\u8fdb\u884c\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u9879\u8bbe\u7f6e\u7279\u5b9a\u7684\u6570\u636e\u3002\u5f53\u5b83\u4eec\u5f00\u59cb\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u5982\u4f55\u505a\u5230\u8fd9\u4e00\u70b9\u5462\uff1f \u5f53\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\uff0c\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e2a\u8f93\u5165\u53d8\u91cf\u6765\u50a8\u5b58\u5f53\u524d\u7ed8\u5236\u5b9e\u4f8b\u7684\u7d22\u5f15\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u8fd9\u4e2a\u5185\u7f6e\u53d8\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u4f20\u9012\u4e00\u4e2a\u5305\u542b\u8981\u5e94\u7528\u5230\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u53d8\u6362\u7684Uniform\u6570\u7ec4\uff0c\u5e76\u4ec5\u505a\u4e00\u6b21\u6e32\u67d3\u8c03\u7528\u3002 \u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u5b83\u4ecd\u7136\u4f1a\u5e26\u6765\u592a\u591a\u7684\u5f00\u9500\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u80fd\u591f\u4f20\u9012\u7684Uniform\u6570\u91cf\u662f\u6709\u9650\u7684\u3002\u56e0\u6b64\uff0c\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u800c\u4e0d\u662f\u4f7f\u7528Uniform\u6570\u7ec4\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u524d\u51e0\u7ae0\uff0c\u6bcf\u4e2a\u7f51\u683c\u7684\u6570\u636e\u90fd\u662f\u7531\u4e00\u7ec4\u540d\u4e3aVBO\u7684\u6570\u636e\u6570\u7ec4\u5b9a\u4e49\u7684\u3002\u8fd9\u4e9bVBO\u4e2d\u7684\u6570\u636e\u50a8\u5b58\u5728\u6bcf\u4e2a\u552f\u4e00\u7684 Mesh \u5b9e\u4f8b\u4e2d\u3002 \u4f7f\u7528\u6807\u51c6\u7684VBO\uff0c\u5728\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u4e0e\u6bcf\u4e2a\u9876\u70b9\uff08\u5176\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\uff09\u76f8\u5173\u7684\u6570\u636e\u3002\u65e0\u8bba\u4f55\u65f6\u8fd0\u884c\u7740\u8272\u5668\uff0c\u8f93\u5165\u53d8\u91cf\u90fd\u88ab\u8bbe\u7f6e\u4e3a\u6307\u5411\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6307\u5b9a\u6570\u636e\u3002\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbe\u7f6e\u6bcf\u4e2a\u5b9e\u4f8b\u800c\u4e0d\u662f\u6bcf\u4e2a\u9876\u70b9\u6240\u66f4\u6539\u7684\u6570\u636e\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e24\u79cd\u7c7b\u578b\u7ed3\u5408\u8d77\u6765\uff0c\u5c31\u53ef\u4ee5\u4f7f\u7528\u5e38\u89c4\u7684VBO\u6765\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684\u4fe1\u606f\uff08\u5750\u6807\uff0c\u7eb9\u7406\u5750\u6807\uff09\u548c\u7528VBO\u50a8\u5b58\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u6570\u636e\uff08\u5982\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u7684\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u4e0e\u6cd5\u7ebf\u3002\u6bcf\u4e2a\u5143\u7d20\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u662f\u5b83\u6240\u5c5e\u7684\u5b9e\u4f8b\uff08\u84dd\u8272\uff09\u3002\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u8868\u793a\u5b9e\u4f8b\u4e2d\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u7f51\u683c\u4e5f\u7531\u4e24\u4e2a\u5b9e\u4f8bVBO\u5b9a\u4e49\u3002\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u4e3a\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u6e32\u67d3\u9876\u70b9\uff08\u7b2c1X\u4e2a\uff09\u65f6\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u662f\u76f8\u540c\u7684\uff08\u7b2c1\u4e2a\uff09\u3002\u5f53\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u7684\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002 \u56e0\u6b64\uff0c\u5728\u6e32\u67d3\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e00\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V11\u3001T11\u548cN11\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u5e76\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u6e32\u67d3\u540c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e8c\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V12\u3001T12\u548cN12\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u4ecd\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5728\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u4e0d\u4f1a\u4f7f\u7528MV2\u548cLV2\u3002 \u4e3a\u4e86\u5b9a\u4e49\u6bcf\u4e2a\u5b9e\u4f8b\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\u8c03\u7528\u51fd\u6570 glVertexAttribDivisor \u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e24\u4e2a\u53c2\u6570\uff1a index\uff1a\u9876\u70b9\u5c5e\u6027\u7684\u7d22\u5f15\uff08\u5728 glVertexAttribPointer \u51fd\u6570\u4e2d\u8bbe\u7f6e\u7684\uff09\u3002 divisor: \u5982\u679c\u8fd9\u4e2a\u503c\u4e3a0\uff0c\u90a3\u4e48\u5728\u6e32\u67d3\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u6570\u636e\u90fd\u4f1a\u6539\u53d8\u3002\u5982\u679c\u5c06\u5176\u8bbe\u7f6e\u4e3a1\uff0c\u5219\u6bcf\u6e32\u67d3\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u6570\u636e\u66f4\u6539\u4e00\u6b21\u3002\u5982\u679c\u5b83\u88ab\u8bbe\u7f6e\u4e3a2\uff0c\u5219\u6bcf\u6e32\u67d3\u4e24\u4e2a\u5b9e\u4f8b\u5c31\u4f1a\u66f4\u6539\u4e00\u6b21\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8bbe\u7f6e\u5b9e\u4f8b\u7684\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u6bcf\u4e2a\u5c5e\u6027\u5b9a\u4e49\u4e4b\u540e\u8fdb\u884c\u5982\u4e0b\u8c03\u7528\uff1a glVertexAttribDivisor(index, 1); \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u5e93\uff0c\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u7b2c\u4e00\u6b65\u662f\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a InstancedMesh \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u7ee7\u627f\u81ea Mesh \u7c7b\u3002\u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u7c7b\u4f3c\u4e8e Mesh \u7684\u6784\u9020\u51fd\u6570\uff0c\u4f46\u6709\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u5373\u5b9e\u4f8b\u6570\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u9664\u4e86\u4f9d\u8d56\u8d85\u7c7b\u7684\u6784\u9020\u51fd\u6570\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e24\u4e2a\u65b0\u7684VBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u521b\u5efa\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a modelViewVBO = glGenBuffers(); vboIdList.add(modelViewVBO); this.modelViewBuffer = MemoryUtil.memAllocFloat(numInstances * MATRIX_SIZE_FLOATS); glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); int start = 5; for (int i = 0; i < 4; i++) { glVertexAttribPointer(start, 4, GL_FLOAT, false, MATRIX_SIZE_BYTES, i * VECTOR4F_SIZE_BYTES); glVertexAttribDivisor(start, 1); start++; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VBO\u548c\u4e00\u4e2a\u65b0\u7684 FloatBuffer \u4ee5\u5728\u5176\u5185\u50a8\u5b58\u6570\u636e\u3002\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u662f\u7528\u6d6e\u70b9\u6570\u6570\u91cf\u8ba1\u7b97\u7684\uff0c\u6240\u4ee5\u5b83\u7b49\u4e8e\u5b9e\u4f8b\u6570\u4e58\u4ee54x4\u77e9\u9635\u7684\u6d6e\u70b9\u6570\u5927\u5c0f\uff08\u7b49\u4e8e16\uff09\u3002 \u4e00\u65e6VBO\u88ab\u7ed1\u5b9a\uff0c\u6211\u4eec\u5c31\u5f00\u59cb\u4e3a\u5b83\u5b9a\u4e49\u5c5e\u6027\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u8fd9\u662f\u5728 for \u5faa\u73af\u4e2d\u5b8c\u6210\u7684\uff0c\u5faa\u73af\u8fdb\u884c\u4e86\u56db\u6b21\u3002\u6bcf\u8f6e\u5faa\u73af\u5b9a\u4e49\u4e00\u4e2a\u77e9\u9635\u5411\u91cf\u3002\u4e3a\u4ec0\u4e48\u4e0d\u7b80\u5355\u5730\u4e3a\u6574\u4e2a\u77e9\u9635\u5b9a\u4e49\u4e00\u4e2a\u5c5e\u6027\u5462\uff1f\u539f\u56e0\u662f\u9876\u70b9\u5c5e\u6027\u4e0d\u80fd\u50a8\u5b58\u8d85\u8fc7\u56db\u4e2a\u6d6e\u70b9\u6570\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u77e9\u9635\u5b9a\u4e49\u5206\u4e3a\u56db\u90e8\u5206\u3002\u8ba9\u6211\u4eec\u91cd\u65b0\u8ba4\u8bc6\u4e00\u4e0b glVertexAttribPointer \u7684\u53c2\u6570\uff1a Index: \u8981\u5b9a\u4e49\u7684\u5143\u7d20\u7684\u7d22\u5f15\u3002 Size: \u8be5\u5c5e\u6027\u7684\u5206\u91cf\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5b83\u662f\u56db\u4e2a\u6d6e\u70b9\u6570\uff0c\u8fd9\u662f\u53ef\u63a5\u53d7\u7684\u6700\u5927\u503c\u3002 Type: \u6570\u636e\u7c7b\u578b\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u6d6e\u70b9\u578b\uff09\u3002 Normalize: \u662f\u5426\u5e94\u8be5\u5f52\u4e00\u5316\u6307\u5b9a\u6570\u636e\u3002 Stride\uff08\u6b65\u957f\uff09: \u7406\u89e3\u8fd9\u91cc\u7684\u6982\u5ff5\u5f88\u91cd\u8981\uff0c\u5b83\u8bbe\u7f6e\u4e86\u8fde\u7eed\u5c5e\u6027\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u8bbe\u7f6e\u4e3a\u6574\u4e2a\u77e9\u9635\u7684\u5b57\u8282\u5927\u5c0f\u3002\u8fd9\u5c31\u50cf\u4e00\u4e2a\u7528\u4e8e\u5305\u88c5\u6570\u636e\u7684\u6807\u8bb0\uff0c\u4ece\u800c\u53ef\u4ee5\u5728\u9876\u70b9\u6216\u5b9e\u4f8b\u4e4b\u95f4\u8fdb\u884c\u66f4\u6539\u3002 Pointer: \u6b64\u5c5e\u6027\u5b9a\u4e49\u5e94\u7528\u7684\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u77e9\u9635\u5b9a\u4e49\u62c6\u5206\u4e3a\u56db\u6b21\u8c03\u7528\u3002\u4f9d\u77e9\u9635\u7684\u6bcf\u4e2a\u5411\u91cf\u589e\u52a0\u504f\u79fb\u91cf\u3002 \u5b9a\u4e49\u4e86\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u76f8\u540c\u7684\u7d22\u5f15\u8c03\u7528 glVertexAttribDivisor \u3002 \u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684\u5b9a\u4e49\u4e0e\u4e0a\u8ff0\u8fc7\u7a0b\u7c7b\u4f3c\uff0c\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u3002\u7ee7\u7eed\u8fdb\u884c InstancedMesh \u7c7b\u7684\u5b9a\u4e49\uff0c\u91cd\u5199\u65b9\u6cd5\u4ee5\u5728\u6e32\u67d3\u4e4b\u524d\u542f\u7528\u9876\u70b9\u5c5e\u6027\uff08\u4ee5\u53ca\u5728\u6e32\u67d3\u4e4b\u540e\u8981\u7981\u7528\u5b83\u4eec\uff09\u662f\u5f88\u91cd\u8981\u7684\u3002 @Override protected void initRender() { super.initRender(); int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glEnableVertexAttribArray(start + i); } } @Override protected void endRender() { int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glDisableVertexAttribArray(start + i); } super.endRender(); } InstancedMesh \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a renderListInstanced \u7684\u516c\u5171\u65b9\u6cd5\uff0c\u5b83\u6e32\u67d3\u4e00\u7cfb\u5217\u7684\u6e38\u620f\u9879\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u6e38\u620f\u9879\u5217\u8868\u5206\u5272\u4e3a\u5927\u5c0f\u4e0e\u521b\u5efa InstancedMesh \u6240\u8bbe\u5b9e\u4f8b\u6570\u91cf\u76f8\u7b49\u7684\u5757\u3002\u771f\u6b63\u7684\u6e32\u67d3\u65b9\u6cd5\u662f renderChunkInstanced \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderChunkInstanced(List<GameItem> gameItems, boolean depthMap, Transformation transformation, Matrix4f viewMatrix, Matrix4f lightViewMatrix) { this.modelViewBuffer.clear(); this.modelLightViewBuffer.clear(); int i = 0; for (GameItem gameItem : gameItems) { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); if (!depthMap) { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.get(MATRIX_SIZE_FLOATS * i, modelViewBuffer); } Matrix4f modelLightViewMatrix = transformation.buildModelLightViewMatrix(modelMatrix, lightViewMatrix); modelLightViewMatrix.get(MATRIX_SIZE_FLOATS * i, this.modelLightViewBuffer); i++; } glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); glBufferData(GL_ARRAY_BUFFER, modelViewBuffer, GL_DYNAMIC_DRAW); glBindBuffer(GL_ARRAY_BUFFER, modelLightViewVBO); glBufferData(GL_ARRAY_BUFFER, modelLightViewBuffer, GL_DYNAMIC_DRAW); glDrawElementsInstanced(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0, gameItems.size()); glBindBuffer(GL_ARRAY_BUFFER, 0); } \u8be5\u65b9\u6cd5\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u904d\u5386\u6e38\u620f\u9879\uff0c\u8ba1\u7b97\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u8fd9\u4e9b\u77e9\u9635\u88ab\u8f6c\u50a8\u5230\u5b83\u4eec\u5404\u81ea\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u7684\u5185\u5bb9\u88ab\u53d1\u9001\u5230GPU\uff0c\u6700\u540e\u901a\u8fc7\u5bf9\u65b9\u6cd5 glDrawElementsInstanced \u7684\u8c03\u7528\u6765\u6e32\u67d3\u5b83\u4eec\u3002 \u56de\u5230\u7740\u8272\u5668\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u9996\u5148\u6211\u4eec\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6dfb\u52a0\u65b0\u7684\u8f93\u5165\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u5c06\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\u4f20\u9012\u3002 layout (location=5) in mat4 modelViewInstancedMatrix; layout (location=9) in mat4 modelLightViewInstancedMatrix; \u5982\u4f60\u6240\u89c1\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e5\u5f00\u59cb\u3002\u7531\u4e8e\u77e9\u9635\u662f\u7531\u4e00\u7ec4\u5171\u56db\u4e2a\u5c5e\u6027\uff08\u6bcf\u4e2a\u5c5e\u6027\u50a8\u5b58\u4e00\u4e2a\u5411\u91cf\uff09\u5b9a\u4e49\u7684\uff0c\u6240\u4ee5\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e9\u5f00\u59cb\u3002\u56e0\u4e3a\u6211\u4eec\u60f3\u5728\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u5b9e\u4f8b\u5316\u6e32\u67d3\u4e2d\u4f7f\u7528\u540c\u4e00\u7740\u8272\u5668\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u7ef4\u62a4\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002\u6211\u4eec\u53ea\u9700\u66f4\u6539\u5b83\u4eec\u7684\u540d\u5b57\u3002 uniform int isInstanced; uniform mat4 modelViewNonInstancedMatrix; \u2026 uniform mat4 modelLightViewNonInstancedMatrix; \u6211\u4eec\u521b\u5efa\u4e86\u53e6\u4e00\u4e2aUniform\u6765\u6307\u5b9a\u662f\u5426\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u60c5\u51b5\u4e0b\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8f93\u5165\u53c2\u6570\u4e2d\u7684\u77e9\u9635\u3002 void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelViewMatrix; mat4 lightViewMatrix; if ( isInstanced > 0 ) { modelViewMatrix = modelViewInstancedMatrix; lightViewMatrix = modelLightViewInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u6211\u4eec\u6682\u65f6\u4e0d\u652f\u6301\u52a8\u753b\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u7b80\u5316\u793a\u4f8b\uff0c\u4f46\u662f\u8be5\u6280\u672f\u53ef\u4ee5\u5b8c\u7f8e\u5730\u7528\u4e8e\u6b64\u5904\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u50cf\u5f80\u5e38\u4e00\u6837\u8bbe\u7f6e\u6070\u5f53\u7684\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * lightViewMatrix * initPos; outModelViewMatrix = modelViewMatrix; } \u5f53\u7136\uff0c Renderer \u7c7b\u5df2\u7ecf\u88ab\u4fee\u6539\uff0c\u4ee5\u652f\u6301Uniform\u7684\u4fee\u6539\uff0c\u5e76\u5c06\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u7684\u6e32\u67d3\u4ece\u5b9e\u4f8b\u5316\u7f51\u683c\u4e2d\u5206\u79bb\u51fa\u6765\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u4fee\u6539\u3002 \u6b64\u5916\uff0cJOML\u7684\u4f5c\u8005 Kai Burjack \u8fd8\u5411\u6e90\u4ee3\u7801\u6dfb\u52a0\u4e86\u4e00\u4e9b\u4f18\u5316\u3002\u8fd9\u4e9b\u4f18\u5316\u5df2\u7ecf\u7528\u4e8e Transformation \u7c7b\uff0c\u5e76\u603b\u7ed3\u4e3a\u5982\u4e0b\u51e0\u6761\uff1a \u5220\u9664\u5197\u4f59\u8c03\u7528\uff0c\u4ee5\u8bbe\u7f6e\u5177\u6709\u5355\u4f4d\u503c\u7684\u77e9\u9635\u3002 \u4f7f\u7528\u56db\u5143\u6570\u8fdb\u884c\u66f4\u6709\u6548\u7684\u65cb\u8f6c\u3002 \u4f7f\u7528\u7279\u5b9a\u7684\u65cb\u8f6c\u548c\u5e73\u79fb\u77e9\u9635\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e9b\u65b9\u6cd5\u662f\u9488\u5bf9\u8fd9\u4e9b\u64cd\u4f5c\u4f18\u5316\u7684\u3002 \u56de\u987e\u7c92\u5b50 \u5728\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u652f\u6301\u4e0b\uff0c\u6211\u4eec\u8fd8\u53ef\u4ee5\u63d0\u9ad8\u7c92\u5b50\u6e32\u67d3\u7684\u6027\u80fd\u3002\u7c92\u5b50\u5c31\u662f\u6700\u597d\u7684\u7528\u4f8b\u3002 \u4e3a\u4e86\u5c06\u5b9e\u4f8b\u5316\u6e32\u67d3\u5e94\u7528\u5230\u7c92\u5b50\u4e0a\u6211\u4eec\u5fc5\u987b\u63d0\u4f9b\u5bf9\u7eb9\u7406\u96c6\u7684\u652f\u6301\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u5e26\u6709\u7eb9\u7406\u504f\u79fb\u91cf\u7684VBO\u6765\u5b9e\u73b0\u3002\u7eb9\u7406\u504f\u79fb\u91cf\u53ef\u4ee5\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u7684\u5355\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u50cf\u77e9\u9635\u90a3\u6837\u62c6\u5206\u5b9a\u4e49\u3002 // \u7eb9\u7406\u504f\u79fb\u91cf glVertexAttribPointer(start, 2, GL_FLOAT, false, INSTANCE_SIZE_BYTES, strideStart); glVertexAttribDivisor(start, 1); \u4f46\u662f\uff0c\u6211\u4eec\u5c06\u5728\u5355\u4e2aVBO\u4e2d\u8bbe\u7f6e\u6240\u6709\u5b9e\u4f8b\u5c5e\u6027\uff0c\u800c\u4e0d\u662f\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684VBO\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8fd9\u4e2a\u6982\u5ff5\u3002\u6211\u4eec\u5c06\u6240\u6709\u5c5e\u6027\u6253\u5305\u5728\u4e00\u4e2aVBO\u4e2d\uff0c\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u503c\u90fd\u4f1a\u53d1\u751f\u53d8\u5316\u3002 \u4e3a\u4e86\u4f7f\u7528\u5355\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5b9e\u4f8b\u4e2d\u6240\u6709\u5c5e\u6027\u7684\u5c5e\u6027\u5927\u5c0f\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u53ef\u4ee5\u770b\u5230\uff0c\u7eb9\u7406\u504f\u79fb\u91cf\u7684\u5b9a\u4e49\u4f7f\u7528\u4e86\u4e00\u4e2a\u540d\u4e3a INSTANCE_SIZE_BYTES \u7684\u5e38\u91cf\u3002\u8fd9\u4e2a\u5e38\u91cf\u7b49\u4e8e\u4e24\u4e2a\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff09\u7684\u5b57\u8282\u5927\u5c0f\u518d\u52a0\u4e0a\u4e24\u4e2a\u6d6e\u70b9\u6570\uff08\u7eb9\u7406\u504f\u79fb\u91cf\uff09\u7684\u5b57\u8282\u5927\u5c0f\uff0c\u603b\u5171\u662f136\u3002\u6b65\u957f\u4e5f\u9700\u8981\u9002\u5f53\u5730\u8c03\u6574\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u4fee\u6539\u3002 Renderer \u7c7b\u4e5f\u9700\u8981\u4fee\u6539\uff0c\u4ee5\u5b9e\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7c92\u5b50\u548c\u652f\u6301\u7eb9\u7406\u96c6\u5728\u573a\u666f\u4e2d\u6e32\u67d3\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u652f\u6301\u8fd9\u4e24\u79cd\u7c7b\u578b\uff08\u975e\u5b9e\u4f8b\u5316\u548c\u5b9e\u4f8b\u5316\uff09\u7684\u6e32\u67d3\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6240\u4ee5\u4fee\u6539\u66f4\u7b80\u5355\u3002 \u7c92\u5b50\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=5) in mat4 modelViewMatrix; layout (location=13) in vec2 texOffset; out vec2 outTexCoord; uniform mat4 projectionMatrix; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // \u652f\u6301\u7eb9\u7406\u96c6\uff0c\u66f4\u65b0\u7eb9\u7406\u5750\u6807 float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); outTexCoord = vec2(x, y);} \u4e0a\u8ff0\u4fee\u6539\u7684\u6548\u679c\uff0c\u770b\u8d77\u6765\u548c\u975e\u5b9e\u4f8b\u5316\u7c92\u5b50\u6e32\u67d3\u65f6\u5b8c\u5168\u4e00\u6837\uff0c\u4f46\u6027\u80fd\u66f4\u9ad8\u3002FPS\u8ba1\u6570\u5668\u5df2\u4f5c\u4e3a\u9009\u9879\u6dfb\u52a0\u5230\u7a97\u53e3\u6807\u9898\u4e2d\u3002\u4f60\u53ef\u4ee5\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u6765\u770b\u770b\u81ea\u8eab\u7684\u6027\u80fd\u63d0\u5347\u3002 \u6269\u5c55 \u7ed3\u5408\u6211\u4eec\u73b0\u5728\u6240\u62e5\u6709\u7684\u6240\u6709\u57fa\u7840\u6784\u9020\uff0c\u6211\u5df2\u7ecf\u57fa\u4e8e\u4f7f\u7528\u9ad8\u5ea6\u56fe\u4fee\u6539\u4e86\u6e32\u67d3\u65b9\u5757\u6570\u636e\u7684\u4ee3\u7801\uff0c\u8fd8\u4f7f\u7528\u4e86\u7eb9\u7406\u96c6\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u5b83\u8fd8\u878d\u5408\u4e86\u7c92\u5b50\u6e32\u67d3\u3002\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a \u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u8fd8\u6709\u5f88\u5927\u7684\u4f18\u5316\u7a7a\u95f4\uff0c\u4f46\u8fd9\u672c\u4e66\u7684\u76ee\u7684\u662f\u6307\u5bfc\u4f60\u5b66\u4e60LWJGL\u548cOpenGL\u7684\u6982\u5ff5\u548c\u6280\u672f\u3002\u6211\u4eec\u7684\u76ee\u6807\u4e0d\u662f\u521b\u5efa\u4e00\u4e2a\u5b8c\u6574\u7684\u6e38\u620f\u5f15\u64ce\uff08\u7edd\u5bf9\u4e0d\u662f\u4e00\u4e2a\u4f53\u7d20\u5f15\u64ce\uff0c\u5b83\u9700\u8981\u4e0d\u540c\u7684\u65b9\u6cd5\u548c\u66f4\u591a\u7684\u4f18\u5316\uff09\u3002","title":"\u5b9e\u4f8b\u5316\u6e32\u67d3"},{"location":"21-instanced-rendering/#instanced-rendering","text":"","title":"\u5b9e\u4f8b\u5316\u6e32\u67d3\uff08Instanced Rendering\uff09"},{"location":"21-instanced-rendering/#_1","text":"\u5728\u7ed8\u5236\u4e09\u7ef4\u573a\u666f\u65f6\uff0c\u7ecf\u5e38\u4f1a\u6709\u8bb8\u591a\u6a21\u578b\u7528\u76f8\u540c\u7684\u7f51\u683c\u8868\u793a\uff0c\u4f46\u5b83\u4eec\u5177\u6709\u4e0d\u540c\u7684\u53d8\u6362\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u5c3d\u7ba1\u5b83\u4eec\u53ef\u80fd\u662f\u53ea\u6709\u51e0\u4e2a\u4e09\u89d2\u5f62\u7684\u7b80\u5355\u7269\u4f53\uff0c\u4f46\u6027\u80fd\u4ecd\u53ef\u80fd\u4f1a\u53d7\u5230\u5f71\u54cd\uff0c\u8fd9\u80cc\u540e\u7684\u539f\u56e0\u5c31\u662f\u6211\u4eec\u6e32\u67d3\u5b83\u4eec\u7684\u65b9\u5f0f\u3002 \u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5faa\u73af\u4e2d\u904d\u5386\u6240\u6709\u6e38\u620f\u9879\uff0c\u5e76\u5bf9\u51fd\u6570 glDrawElements \u8fdb\u884c\u8c03\u7528\u3002\u5982\u524d\u51e0\u7ae0\u6240\u8bf4\u7684\uff0c\u5bf9OpenGL\u5e93\u7684\u8c03\u7528\u5e94\u8be5\u6700\u5c0f\u5316\u3002\u5bf9\u51fd\u6570 glDrawElements \u7684\u6bcf\u6b21\u8c03\u7528\u90fd\u4f1a\u9020\u6210\u4e00\u5b9a\u5f00\u9500\u3002\u8fd9\u5bf9\u4e8e\u6bcf\u4e2a GameItem \u5b9e\u4f8b\u4f1a\u53cd\u590d\u4ea7\u751f\u5f00\u9500\u3002 \u5728\u5904\u7406\u5927\u91cf\u76f8\u4f3c\u7269\u4f53\u65f6\uff0c\u4f7f\u7528\u4e00\u6b21\u8c03\u7528\u6e32\u67d3\u6240\u6709\u8fd9\u4e9b\u7269\u4f53\u4f1a\u66f4\u6709\u6548\u3002\u8fd9\u79cd\u6280\u672f\u88ab\u79f0\u4e3a\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u4e3a\u4e86\u5b9e\u73b0\u540c\u65f6\u6e32\u67d3\u4e00\u7ec4\u5143\u7d20\uff0cOpenGL\u63d0\u4f9b\u4e86\u4e00\u7ec4\u540d\u4e3a glDrawXXXInstanced \u7684\u51fd\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7531\u4e8e\u6211\u4eec\u6b63\u5728\u7ed8\u5236\u5143\u7d20\uff0c\u6240\u4ee5\u5c06\u4f7f\u7528\u540d\u4e3a glDrawElementsInstanced \u7684\u51fd\u6570\u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e0e glDrawElements \u76f8\u540c\u7684\u53c2\u6570\uff0c\u5916\u52a0\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u7528\u4e8e\u8bbe\u7f6e\u8981\u7ed8\u5236\u7684\u5b9e\u4f8b\u6570\u3002 \u8fd9\u662f\u4e00\u4e2a\u5982\u4f55\u4f7f\u7528 glDrawElements \u7684\u793a\u4f8b\uff1a glDrawElements(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0) \u4ee5\u4e0b\u662f\u5b9e\u4f8b\u5316\u7248\u672c\u7684\u7528\u6cd5: glDrawElementsInstanced(GL_TRIANGLES, numVertices, GL_UNSIGNED_INT, 0, numInstances); \u4f46\u662f\u4f60\u73b0\u5728\u53ef\u80fd\u60f3\u77e5\u9053\uff0c\u5982\u4f55\u4e3a\u6bcf\u4e2a\u5b9e\u4f8b\u8bbe\u7f6e\u4e0d\u540c\u7684\u53d8\u6362\u3002\u73b0\u5728\uff0c\u5728\u7ed8\u5236\u6bcf\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Uniform\u6765\u4f20\u9012\u4e0d\u540c\u7684\u53d8\u6362\u548c\u5b9e\u4f8b\u76f8\u5173\u7684\u6570\u636e\u3002\u5728\u8fdb\u884c\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6bcf\u9879\u8bbe\u7f6e\u7279\u5b9a\u7684\u6570\u636e\u3002\u5f53\u5b83\u4eec\u5f00\u59cb\u6e32\u67d3\u65f6\uff0c\u6211\u4eec\u5982\u4f55\u505a\u5230\u8fd9\u4e00\u70b9\u5462\uff1f \u5f53\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\uff0c\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e2a\u8f93\u5165\u53d8\u91cf\u6765\u50a8\u5b58\u5f53\u524d\u7ed8\u5236\u5b9e\u4f8b\u7684\u7d22\u5f15\u3002\u4f8b\u5982\uff0c\u4f7f\u7528\u8fd9\u4e2a\u5185\u7f6e\u53d8\u91cf\uff0c\u6211\u4eec\u53ef\u4ee5\u4f20\u9012\u4e00\u4e2a\u5305\u542b\u8981\u5e94\u7528\u5230\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u53d8\u6362\u7684Uniform\u6570\u7ec4\uff0c\u5e76\u4ec5\u505a\u4e00\u6b21\u6e32\u67d3\u8c03\u7528\u3002 \u8fd9\u79cd\u65b9\u6cd5\u7684\u95ee\u9898\u662f\uff0c\u5b83\u4ecd\u7136\u4f1a\u5e26\u6765\u592a\u591a\u7684\u5f00\u9500\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u6211\u4eec\u80fd\u591f\u4f20\u9012\u7684Uniform\u6570\u91cf\u662f\u6709\u9650\u7684\u3002\u56e0\u6b64\uff0c\u9700\u8981\u4f7f\u7528\u53e6\u4e00\u79cd\u65b9\u6cd5\uff0c\u800c\u4e0d\u662f\u4f7f\u7528Uniform\u6570\u7ec4\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\u3002 \u5982\u679c\u4f60\u8fd8\u8bb0\u5f97\u524d\u51e0\u7ae0\uff0c\u6bcf\u4e2a\u7f51\u683c\u7684\u6570\u636e\u90fd\u662f\u7531\u4e00\u7ec4\u540d\u4e3aVBO\u7684\u6570\u636e\u6570\u7ec4\u5b9a\u4e49\u7684\u3002\u8fd9\u4e9bVBO\u4e2d\u7684\u6570\u636e\u50a8\u5b58\u5728\u6bcf\u4e2a\u552f\u4e00\u7684 Mesh \u5b9e\u4f8b\u4e2d\u3002 \u4f7f\u7528\u6807\u51c6\u7684VBO\uff0c\u5728\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u4e0e\u6bcf\u4e2a\u9876\u70b9\uff08\u5176\u4f4d\u7f6e\u3001\u989c\u8272\u3001\u7eb9\u7406\u7b49\uff09\u76f8\u5173\u7684\u6570\u636e\u3002\u65e0\u8bba\u4f55\u65f6\u8fd0\u884c\u7740\u8272\u5668\uff0c\u8f93\u5165\u53d8\u91cf\u90fd\u88ab\u8bbe\u7f6e\u4e3a\u6307\u5411\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u6307\u5b9a\u6570\u636e\u3002\u4f7f\u7528\u5b9e\u4f8b\u5316\u6570\u7ec4\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbe\u7f6e\u6bcf\u4e2a\u5b9e\u4f8b\u800c\u4e0d\u662f\u6bcf\u4e2a\u9876\u70b9\u6240\u66f4\u6539\u7684\u6570\u636e\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e24\u79cd\u7c7b\u578b\u7ed3\u5408\u8d77\u6765\uff0c\u5c31\u53ef\u4ee5\u4f7f\u7528\u5e38\u89c4\u7684VBO\u6765\u50a8\u5b58\u6bcf\u4e2a\u9876\u70b9\u7684\u4fe1\u606f\uff08\u5750\u6807\uff0c\u7eb9\u7406\u5750\u6807\uff09\u548c\u7528VBO\u50a8\u5b58\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u6570\u636e\uff08\u5982\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff09\u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u7531\u4e09\u4e2a\u9876\u70b9\u7ec4\u6210\u7684\u7f51\u683c\uff0c\u6bcf\u4e2a\u9876\u70b9\u5b9a\u4e49\u4e86\u5750\u6807\u3001\u7eb9\u7406\u4e0e\u6cd5\u7ebf\u3002\u6bcf\u4e2a\u5143\u7d20\u7684\u7b2c\u4e00\u4e2a\u7d22\u5f15\u662f\u5b83\u6240\u5c5e\u7684\u5b9e\u4f8b\uff08\u84dd\u8272\uff09\u3002\u7b2c\u4e8c\u4e2a\u7d22\u5f15\u8868\u793a\u5b9e\u4f8b\u4e2d\u7684\u9876\u70b9\u4f4d\u7f6e\u3002 \u7f51\u683c\u4e5f\u7531\u4e24\u4e2a\u5b9e\u4f8bVBO\u5b9a\u4e49\u3002\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u4e3a\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u6e32\u67d3\u9876\u70b9\uff08\u7b2c1X\u4e2a\uff09\u65f6\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u662f\u76f8\u540c\u7684\uff08\u7b2c1\u4e2a\uff09\u3002\u5f53\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u7684\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528\u7b2c\u4e8c\u4e2a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002 \u56e0\u6b64\uff0c\u5728\u6e32\u67d3\u7b2c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e00\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V11\u3001T11\u548cN11\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u5e76\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5f53\u6e32\u67d3\u540c\u4e00\u4e2a\u5b9e\u4f8b\u7684\u7b2c\u4e8c\u4e2a\u9876\u70b9\u65f6\uff0c\u5c06\u4f7f\u7528V12\u3001T12\u548cN12\u4f5c\u4e3a\u5750\u6807\u3001\u7eb9\u7406\u548c\u6cd5\u7ebf\u6570\u636e\uff0c\u4ecd\u4f7f\u7528MV1\u4f5c\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u3002\u5728\u6e32\u67d3\u7b2c\u4e8c\u4e2a\u5b9e\u4f8b\u4e4b\u524d\uff0c\u4e0d\u4f1a\u4f7f\u7528MV2\u548cLV2\u3002 \u4e3a\u4e86\u5b9a\u4e49\u6bcf\u4e2a\u5b9e\u4f8b\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\u8c03\u7528\u51fd\u6570 glVertexAttribDivisor \u3002\u8be5\u51fd\u6570\u63a5\u6536\u4e24\u4e2a\u53c2\u6570\uff1a index\uff1a\u9876\u70b9\u5c5e\u6027\u7684\u7d22\u5f15\uff08\u5728 glVertexAttribPointer \u51fd\u6570\u4e2d\u8bbe\u7f6e\u7684\uff09\u3002 divisor: \u5982\u679c\u8fd9\u4e2a\u503c\u4e3a0\uff0c\u90a3\u4e48\u5728\u6e32\u67d3\u65f6\uff0c\u6bcf\u4e2a\u9876\u70b9\u7684\u6570\u636e\u90fd\u4f1a\u6539\u53d8\u3002\u5982\u679c\u5c06\u5176\u8bbe\u7f6e\u4e3a1\uff0c\u5219\u6bcf\u6e32\u67d3\u4e00\u4e2a\u5b9e\u4f8b\uff0c\u6570\u636e\u66f4\u6539\u4e00\u6b21\u3002\u5982\u679c\u5b83\u88ab\u8bbe\u7f6e\u4e3a2\uff0c\u5219\u6bcf\u6e32\u67d3\u4e24\u4e2a\u5b9e\u4f8b\u5c31\u4f1a\u66f4\u6539\u4e00\u6b21\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8bbe\u7f6e\u5b9e\u4f8b\u7684\u6570\u636e\uff0c\u6211\u4eec\u9700\u8981\u5728\u6bcf\u4e2a\u5c5e\u6027\u5b9a\u4e49\u4e4b\u540e\u8fdb\u884c\u5982\u4e0b\u8c03\u7528\uff1a glVertexAttribDivisor(index, 1); \u8ba9\u6211\u4eec\u5f00\u59cb\u4fee\u6539\u4ee3\u7801\u5e93\uff0c\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u7b2c\u4e00\u6b65\u662f\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a InstancedMesh \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u7ee7\u627f\u81ea Mesh \u7c7b\u3002\u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u7c7b\u4f3c\u4e8e Mesh \u7684\u6784\u9020\u51fd\u6570\uff0c\u4f46\u6709\u4e00\u4e2a\u989d\u5916\u7684\u53c2\u6570\uff0c\u5373\u5b9e\u4f8b\u6570\u3002 \u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u9664\u4e86\u4f9d\u8d56\u8d85\u7c7b\u7684\u6784\u9020\u51fd\u6570\u5916\uff0c\u6211\u4eec\u8fd8\u5c06\u521b\u5efa\u4e24\u4e2a\u65b0\u7684VBO\uff0c\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u521b\u5efa\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u7684\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a modelViewVBO = glGenBuffers(); vboIdList.add(modelViewVBO); this.modelViewBuffer = MemoryUtil.memAllocFloat(numInstances * MATRIX_SIZE_FLOATS); glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); int start = 5; for (int i = 0; i < 4; i++) { glVertexAttribPointer(start, 4, GL_FLOAT, false, MATRIX_SIZE_BYTES, i * VECTOR4F_SIZE_BYTES); glVertexAttribDivisor(start, 1); start++; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u65b0\u7684VBO\u548c\u4e00\u4e2a\u65b0\u7684 FloatBuffer \u4ee5\u5728\u5176\u5185\u50a8\u5b58\u6570\u636e\u3002\u7f13\u51b2\u533a\u7684\u5927\u5c0f\u662f\u7528\u6d6e\u70b9\u6570\u6570\u91cf\u8ba1\u7b97\u7684\uff0c\u6240\u4ee5\u5b83\u7b49\u4e8e\u5b9e\u4f8b\u6570\u4e58\u4ee54x4\u77e9\u9635\u7684\u6d6e\u70b9\u6570\u5927\u5c0f\uff08\u7b49\u4e8e16\uff09\u3002 \u4e00\u65e6VBO\u88ab\u7ed1\u5b9a\uff0c\u6211\u4eec\u5c31\u5f00\u59cb\u4e3a\u5b83\u5b9a\u4e49\u5c5e\u6027\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u8fd9\u662f\u5728 for \u5faa\u73af\u4e2d\u5b8c\u6210\u7684\uff0c\u5faa\u73af\u8fdb\u884c\u4e86\u56db\u6b21\u3002\u6bcf\u8f6e\u5faa\u73af\u5b9a\u4e49\u4e00\u4e2a\u77e9\u9635\u5411\u91cf\u3002\u4e3a\u4ec0\u4e48\u4e0d\u7b80\u5355\u5730\u4e3a\u6574\u4e2a\u77e9\u9635\u5b9a\u4e49\u4e00\u4e2a\u5c5e\u6027\u5462\uff1f\u539f\u56e0\u662f\u9876\u70b9\u5c5e\u6027\u4e0d\u80fd\u50a8\u5b58\u8d85\u8fc7\u56db\u4e2a\u6d6e\u70b9\u6570\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u628a\u77e9\u9635\u5b9a\u4e49\u5206\u4e3a\u56db\u90e8\u5206\u3002\u8ba9\u6211\u4eec\u91cd\u65b0\u8ba4\u8bc6\u4e00\u4e0b glVertexAttribPointer \u7684\u53c2\u6570\uff1a Index: \u8981\u5b9a\u4e49\u7684\u5143\u7d20\u7684\u7d22\u5f15\u3002 Size: \u8be5\u5c5e\u6027\u7684\u5206\u91cf\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5b83\u662f\u56db\u4e2a\u6d6e\u70b9\u6570\uff0c\u8fd9\u662f\u53ef\u63a5\u53d7\u7684\u6700\u5927\u503c\u3002 Type: \u6570\u636e\u7c7b\u578b\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u6d6e\u70b9\u578b\uff09\u3002 Normalize: \u662f\u5426\u5e94\u8be5\u5f52\u4e00\u5316\u6307\u5b9a\u6570\u636e\u3002 Stride\uff08\u6b65\u957f\uff09: \u7406\u89e3\u8fd9\u91cc\u7684\u6982\u5ff5\u5f88\u91cd\u8981\uff0c\u5b83\u8bbe\u7f6e\u4e86\u8fde\u7eed\u5c5e\u6027\u4e4b\u95f4\u7684\u5b57\u8282\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5176\u8bbe\u7f6e\u4e3a\u6574\u4e2a\u77e9\u9635\u7684\u5b57\u8282\u5927\u5c0f\u3002\u8fd9\u5c31\u50cf\u4e00\u4e2a\u7528\u4e8e\u5305\u88c5\u6570\u636e\u7684\u6807\u8bb0\uff0c\u4ece\u800c\u53ef\u4ee5\u5728\u9876\u70b9\u6216\u5b9e\u4f8b\u4e4b\u95f4\u8fdb\u884c\u66f4\u6539\u3002 Pointer: \u6b64\u5c5e\u6027\u5b9a\u4e49\u5e94\u7528\u7684\u504f\u79fb\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5c06\u77e9\u9635\u5b9a\u4e49\u62c6\u5206\u4e3a\u56db\u6b21\u8c03\u7528\u3002\u4f9d\u77e9\u9635\u7684\u6bcf\u4e2a\u5411\u91cf\u589e\u52a0\u504f\u79fb\u91cf\u3002 \u5b9a\u4e49\u4e86\u9876\u70b9\u5c5e\u6027\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u76f8\u540c\u7684\u7d22\u5f15\u8c03\u7528 glVertexAttribDivisor \u3002 \u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684\u5b9a\u4e49\u4e0e\u4e0a\u8ff0\u8fc7\u7a0b\u7c7b\u4f3c\uff0c\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u5b83\u3002\u7ee7\u7eed\u8fdb\u884c InstancedMesh \u7c7b\u7684\u5b9a\u4e49\uff0c\u91cd\u5199\u65b9\u6cd5\u4ee5\u5728\u6e32\u67d3\u4e4b\u524d\u542f\u7528\u9876\u70b9\u5c5e\u6027\uff08\u4ee5\u53ca\u5728\u6e32\u67d3\u4e4b\u540e\u8981\u7981\u7528\u5b83\u4eec\uff09\u662f\u5f88\u91cd\u8981\u7684\u3002 @Override protected void initRender() { super.initRender(); int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glEnableVertexAttribArray(start + i); } } @Override protected void endRender() { int start = 5; int numElements = 4 * 2; for (int i = 0; i < numElements; i++) { glDisableVertexAttribArray(start + i); } super.endRender(); } InstancedMesh \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u540d\u4e3a renderListInstanced \u7684\u516c\u5171\u65b9\u6cd5\uff0c\u5b83\u6e32\u67d3\u4e00\u7cfb\u5217\u7684\u6e38\u620f\u9879\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c06\u6e38\u620f\u9879\u5217\u8868\u5206\u5272\u4e3a\u5927\u5c0f\u4e0e\u521b\u5efa InstancedMesh \u6240\u8bbe\u5b9e\u4f8b\u6570\u91cf\u76f8\u7b49\u7684\u5757\u3002\u771f\u6b63\u7684\u6e32\u67d3\u65b9\u6cd5\u662f renderChunkInstanced \uff0c\u5b9a\u4e49\u5982\u4e0b\uff1a private void renderChunkInstanced(List<GameItem> gameItems, boolean depthMap, Transformation transformation, Matrix4f viewMatrix, Matrix4f lightViewMatrix) { this.modelViewBuffer.clear(); this.modelLightViewBuffer.clear(); int i = 0; for (GameItem gameItem : gameItems) { Matrix4f modelMatrix = transformation.buildModelMatrix(gameItem); if (!depthMap) { Matrix4f modelViewMatrix = transformation.buildModelViewMatrix(modelMatrix, viewMatrix); modelViewMatrix.get(MATRIX_SIZE_FLOATS * i, modelViewBuffer); } Matrix4f modelLightViewMatrix = transformation.buildModelLightViewMatrix(modelMatrix, lightViewMatrix); modelLightViewMatrix.get(MATRIX_SIZE_FLOATS * i, this.modelLightViewBuffer); i++; } glBindBuffer(GL_ARRAY_BUFFER, modelViewVBO); glBufferData(GL_ARRAY_BUFFER, modelViewBuffer, GL_DYNAMIC_DRAW); glBindBuffer(GL_ARRAY_BUFFER, modelLightViewVBO); glBufferData(GL_ARRAY_BUFFER, modelLightViewBuffer, GL_DYNAMIC_DRAW); glDrawElementsInstanced(GL_TRIANGLES, getVertexCount(), GL_UNSIGNED_INT, 0, gameItems.size()); glBindBuffer(GL_ARRAY_BUFFER, 0); } \u8be5\u65b9\u6cd5\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u904d\u5386\u6e38\u620f\u9879\uff0c\u8ba1\u7b97\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u3002\u8fd9\u4e9b\u77e9\u9635\u88ab\u8f6c\u50a8\u5230\u5b83\u4eec\u5404\u81ea\u7684\u7f13\u51b2\u533a\u4e2d\u3002\u8fd9\u4e9b\u7f13\u51b2\u533a\u7684\u5185\u5bb9\u88ab\u53d1\u9001\u5230GPU\uff0c\u6700\u540e\u901a\u8fc7\u5bf9\u65b9\u6cd5 glDrawElementsInstanced \u7684\u8c03\u7528\u6765\u6e32\u67d3\u5b83\u4eec\u3002 \u56de\u5230\u7740\u8272\u5668\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u9876\u70b9\u7740\u8272\u5668\u4ee5\u652f\u6301\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u9996\u5148\u6211\u4eec\u4e3a\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u6dfb\u52a0\u65b0\u7684\u8f93\u5165\u53c2\u6570\uff0c\u8fd9\u4e9b\u53c2\u6570\u5c06\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u65f6\u4f20\u9012\u3002 layout (location=5) in mat4 modelViewInstancedMatrix; layout (location=9) in mat4 modelLightViewInstancedMatrix; \u5982\u4f60\u6240\u89c1\uff0c\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e5\u5f00\u59cb\u3002\u7531\u4e8e\u77e9\u9635\u662f\u7531\u4e00\u7ec4\u5171\u56db\u4e2a\u5c5e\u6027\uff08\u6bcf\u4e2a\u5c5e\u6027\u50a8\u5b58\u4e00\u4e2a\u5411\u91cf\uff09\u5b9a\u4e49\u7684\uff0c\u6240\u4ee5\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u4ece\u4f4d\u7f6e9\u5f00\u59cb\u3002\u56e0\u4e3a\u6211\u4eec\u60f3\u5728\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u5b9e\u4f8b\u5316\u6e32\u67d3\u4e2d\u4f7f\u7528\u540c\u4e00\u7740\u8272\u5668\uff0c\u6240\u4ee5\u6211\u4eec\u5c06\u7ef4\u62a4\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u7684Uniform\u3002\u6211\u4eec\u53ea\u9700\u66f4\u6539\u5b83\u4eec\u7684\u540d\u5b57\u3002 uniform int isInstanced; uniform mat4 modelViewNonInstancedMatrix; \u2026 uniform mat4 modelLightViewNonInstancedMatrix; \u6211\u4eec\u521b\u5efa\u4e86\u53e6\u4e00\u4e2aUniform\u6765\u6307\u5b9a\u662f\u5426\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u3002\u5728\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u60c5\u51b5\u4e0b\u4ee3\u7801\u975e\u5e38\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8f93\u5165\u53c2\u6570\u4e2d\u7684\u77e9\u9635\u3002 void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelViewMatrix; mat4 lightViewMatrix; if ( isInstanced > 0 ) { modelViewMatrix = modelViewInstancedMatrix; lightViewMatrix = modelLightViewInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } \u6211\u4eec\u6682\u65f6\u4e0d\u652f\u6301\u52a8\u753b\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u7b80\u5316\u793a\u4f8b\uff0c\u4f46\u662f\u8be5\u6280\u672f\u53ef\u4ee5\u5b8c\u7f8e\u5730\u7528\u4e8e\u6b64\u5904\u3002 \u6700\u540e\uff0c\u7740\u8272\u5668\u50cf\u5f80\u5e38\u4e00\u6837\u8bbe\u7f6e\u6070\u5f53\u7684\u503c\u3002 vec4 mvPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * mvPos; outTexCoord = texCoord; mvVertexNormal = normalize(modelViewMatrix * initNormal).xyz; mvVertexPos = mvPos.xyz; mlightviewVertexPos = orthoProjectionMatrix * lightViewMatrix * initPos; outModelViewMatrix = modelViewMatrix; } \u5f53\u7136\uff0c Renderer \u7c7b\u5df2\u7ecf\u88ab\u4fee\u6539\uff0c\u4ee5\u652f\u6301Uniform\u7684\u4fee\u6539\uff0c\u5e76\u5c06\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u7684\u6e32\u67d3\u4ece\u5b9e\u4f8b\u5316\u7f51\u683c\u4e2d\u5206\u79bb\u51fa\u6765\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u4e2d\u7684\u4fee\u6539\u3002 \u6b64\u5916\uff0cJOML\u7684\u4f5c\u8005 Kai Burjack \u8fd8\u5411\u6e90\u4ee3\u7801\u6dfb\u52a0\u4e86\u4e00\u4e9b\u4f18\u5316\u3002\u8fd9\u4e9b\u4f18\u5316\u5df2\u7ecf\u7528\u4e8e Transformation \u7c7b\uff0c\u5e76\u603b\u7ed3\u4e3a\u5982\u4e0b\u51e0\u6761\uff1a \u5220\u9664\u5197\u4f59\u8c03\u7528\uff0c\u4ee5\u8bbe\u7f6e\u5177\u6709\u5355\u4f4d\u503c\u7684\u77e9\u9635\u3002 \u4f7f\u7528\u56db\u5143\u6570\u8fdb\u884c\u66f4\u6709\u6548\u7684\u65cb\u8f6c\u3002 \u4f7f\u7528\u7279\u5b9a\u7684\u65cb\u8f6c\u548c\u5e73\u79fb\u77e9\u9635\u7684\u65b9\u6cd5\uff0c\u8fd9\u4e9b\u65b9\u6cd5\u662f\u9488\u5bf9\u8fd9\u4e9b\u64cd\u4f5c\u4f18\u5316\u7684\u3002","title":"\u5f88\u591a\u5b9e\u4f8b"},{"location":"21-instanced-rendering/#_2","text":"\u5728\u5b9e\u4f8b\u5316\u6e32\u67d3\u7684\u652f\u6301\u4e0b\uff0c\u6211\u4eec\u8fd8\u53ef\u4ee5\u63d0\u9ad8\u7c92\u5b50\u6e32\u67d3\u7684\u6027\u80fd\u3002\u7c92\u5b50\u5c31\u662f\u6700\u597d\u7684\u7528\u4f8b\u3002 \u4e3a\u4e86\u5c06\u5b9e\u4f8b\u5316\u6e32\u67d3\u5e94\u7528\u5230\u7c92\u5b50\u4e0a\u6211\u4eec\u5fc5\u987b\u63d0\u4f9b\u5bf9\u7eb9\u7406\u96c6\u7684\u652f\u6301\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u6dfb\u52a0\u4e00\u4e2a\u5e26\u6709\u7eb9\u7406\u504f\u79fb\u91cf\u7684VBO\u6765\u5b9e\u73b0\u3002\u7eb9\u7406\u504f\u79fb\u91cf\u53ef\u4ee5\u7531\u4e24\u4e2a\u6d6e\u70b9\u6570\u7ec4\u6210\u7684\u5355\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u50cf\u77e9\u9635\u90a3\u6837\u62c6\u5206\u5b9a\u4e49\u3002 // \u7eb9\u7406\u504f\u79fb\u91cf glVertexAttribPointer(start, 2, GL_FLOAT, false, INSTANCE_SIZE_BYTES, strideStart); glVertexAttribDivisor(start, 1); \u4f46\u662f\uff0c\u6211\u4eec\u5c06\u5728\u5355\u4e2aVBO\u4e2d\u8bbe\u7f6e\u6240\u6709\u5b9e\u4f8b\u5c5e\u6027\uff0c\u800c\u4e0d\u662f\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684VBO\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8fd9\u4e2a\u6982\u5ff5\u3002\u6211\u4eec\u5c06\u6240\u6709\u5c5e\u6027\u6253\u5305\u5728\u4e00\u4e2aVBO\u4e2d\uff0c\u6bcf\u4e2a\u5b9e\u4f8b\u7684\u503c\u90fd\u4f1a\u53d1\u751f\u53d8\u5316\u3002 \u4e3a\u4e86\u4f7f\u7528\u5355\u4e2aVBO\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539\u5b9e\u4f8b\u4e2d\u6240\u6709\u5c5e\u6027\u7684\u5c5e\u6027\u5927\u5c0f\u3002\u4ece\u4e0a\u8ff0\u4ee3\u7801\u4e2d\u53ef\u4ee5\u770b\u5230\uff0c\u7eb9\u7406\u504f\u79fb\u91cf\u7684\u5b9a\u4e49\u4f7f\u7528\u4e86\u4e00\u4e2a\u540d\u4e3a INSTANCE_SIZE_BYTES \u7684\u5e38\u91cf\u3002\u8fd9\u4e2a\u5e38\u91cf\u7b49\u4e8e\u4e24\u4e2a\u77e9\u9635\uff08\u4e00\u4e2a\u7528\u4e8e\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff0c\u53e6\u4e00\u4e2a\u7528\u4e8e\u5149\u7167\u89c2\u5bdf\u77e9\u9635\u5b9a\u4e49\uff09\u7684\u5b57\u8282\u5927\u5c0f\u518d\u52a0\u4e0a\u4e24\u4e2a\u6d6e\u70b9\u6570\uff08\u7eb9\u7406\u504f\u79fb\u91cf\uff09\u7684\u5b57\u8282\u5927\u5c0f\uff0c\u603b\u5171\u662f136\u3002\u6b65\u957f\u4e5f\u9700\u8981\u9002\u5f53\u5730\u8c03\u6574\u3002 \u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u4fee\u6539\u3002 Renderer \u7c7b\u4e5f\u9700\u8981\u4fee\u6539\uff0c\u4ee5\u5b9e\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u7c92\u5b50\u548c\u652f\u6301\u7eb9\u7406\u96c6\u5728\u573a\u666f\u4e2d\u6e32\u67d3\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u652f\u6301\u8fd9\u4e24\u79cd\u7c7b\u578b\uff08\u975e\u5b9e\u4f8b\u5316\u548c\u5b9e\u4f8b\u5316\uff09\u7684\u6e32\u67d3\u662f\u6ca1\u6709\u610f\u4e49\u7684\uff0c\u6240\u4ee5\u4fee\u6539\u66f4\u7b80\u5355\u3002 \u7c92\u5b50\u7684\u9876\u70b9\u7740\u8272\u5668\u5982\u4e0b\u6240\u793a\uff1a #version 330 layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=5) in mat4 modelViewMatrix; layout (location=13) in vec2 texOffset; out vec2 outTexCoord; uniform mat4 projectionMatrix; uniform int numCols; uniform int numRows; void main() { gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0); // \u652f\u6301\u7eb9\u7406\u96c6\uff0c\u66f4\u65b0\u7eb9\u7406\u5750\u6807 float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); outTexCoord = vec2(x, y);} \u4e0a\u8ff0\u4fee\u6539\u7684\u6548\u679c\uff0c\u770b\u8d77\u6765\u548c\u975e\u5b9e\u4f8b\u5316\u7c92\u5b50\u6e32\u67d3\u65f6\u5b8c\u5168\u4e00\u6837\uff0c\u4f46\u6027\u80fd\u66f4\u9ad8\u3002FPS\u8ba1\u6570\u5668\u5df2\u4f5c\u4e3a\u9009\u9879\u6dfb\u52a0\u5230\u7a97\u53e3\u6807\u9898\u4e2d\u3002\u4f60\u53ef\u4ee5\u4f7f\u7528\u5b9e\u4f8b\u5316\u6e32\u67d3\u548c\u975e\u5b9e\u4f8b\u5316\u6e32\u67d3\u6765\u770b\u770b\u81ea\u8eab\u7684\u6027\u80fd\u63d0\u5347\u3002","title":"\u56de\u987e\u7c92\u5b50"},{"location":"21-instanced-rendering/#_3","text":"\u7ed3\u5408\u6211\u4eec\u73b0\u5728\u6240\u62e5\u6709\u7684\u6240\u6709\u57fa\u7840\u6784\u9020\uff0c\u6211\u5df2\u7ecf\u57fa\u4e8e\u4f7f\u7528\u9ad8\u5ea6\u56fe\u4fee\u6539\u4e86\u6e32\u67d3\u65b9\u5757\u6570\u636e\u7684\u4ee3\u7801\uff0c\u8fd8\u4f7f\u7528\u4e86\u7eb9\u7406\u96c6\u4ee5\u4f7f\u7528\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u5b83\u8fd8\u878d\u5408\u4e86\u7c92\u5b50\u6e32\u67d3\u3002\u770b\u8d77\u6765\u662f\u8fd9\u6837\u7684\uff1a \u8bf7\u8bb0\u4f4f\uff0c\u8fd9\u8fd8\u6709\u5f88\u5927\u7684\u4f18\u5316\u7a7a\u95f4\uff0c\u4f46\u8fd9\u672c\u4e66\u7684\u76ee\u7684\u662f\u6307\u5bfc\u4f60\u5b66\u4e60LWJGL\u548cOpenGL\u7684\u6982\u5ff5\u548c\u6280\u672f\u3002\u6211\u4eec\u7684\u76ee\u6807\u4e0d\u662f\u521b\u5efa\u4e00\u4e2a\u5b8c\u6574\u7684\u6e38\u620f\u5f15\u64ce\uff08\u7edd\u5bf9\u4e0d\u662f\u4e00\u4e2a\u4f53\u7d20\u5f15\u64ce\uff0c\u5b83\u9700\u8981\u4e0d\u540c\u7684\u65b9\u6cd5\u548c\u66f4\u591a\u7684\u4f18\u5316\uff09\u3002","title":"\u6269\u5c55"},{"location":"22-audio/","text":"\u97f3\u9891\uff08Audio\uff09 \u5728\u6b64\u4e4b\u524d\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u56fe\u50cf\uff0c\u4f46\u6bcf\u4e2a\u6e38\u620f\u7684\u53e6\u4e00\u4e2a\u5173\u952e\u9762\u662f\u97f3\u9891\u3002\u672c\u7ae0\u5c06\u5728 OpenAL \uff08Open Audio Library\uff0c\u5f00\u653e\u97f3\u9891\u5e93\uff09\u7684\u5e2e\u52a9\u4e0b\u5b9e\u73b0\u8fd9\u4e2a\u529f\u80fd\u3002OpenAL\u5c31\u50cf\u662fOpenGL\u5728\u97f3\u9891\u7684\u76f8\u4f3c\u7269\uff0c\u5b83\u5141\u8bb8\u6211\u4eec\u901a\u8fc7\u62bd\u8c61\u5c42\u64ad\u653e\u58f0\u97f3\u3002\u8be5\u5c42\u5c06\u6211\u4eec\u4e0e\u97f3\u9891\u5b50\u7cfb\u7edf\u7684\u590d\u6742\u5e95\u5c42\u9694\u79bb\u5f00\u6765\u3002\u6b64\u5916\uff0c\u5b83\u8fd8\u5141\u8bb8\u6211\u4eec\u53ef\u4ee5\u4e09\u7ef4\u573a\u666f\u4e2d\u7279\u5b9a\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u58f0\u97f3\uff0c\u201c\u6e32\u67d3\u201d\u58f0\u97f3\uff0c\u968f\u7740\u8ddd\u79bb\u8870\u51cf\u5e76\u6839\u636e\u5b83\u4eec\u7684\u901f\u5ea6\u8fdb\u884c\u4fee\u6539\uff08\u6a21\u62df \u591a\u666e\u52d2\u6548\u5e94 \uff09\u3002 LWJGL\u652f\u6301OpenGL\uff0c\u4e0d\u9700\u8981\u4efb\u4f55\u989d\u5916\u7684\u4e0b\u8f7d\uff0c\u5b83\u5c31\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528\u4e86\u3002\u4f46\u662f\u5728\u5f00\u59cb\u5199\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4ecb\u7ecd\u5904\u7406OpenGL\u65f6\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u5143\u7d20\uff0c\u5b83\u4eec\u662f\uff1a \u7f13\u51b2\u533a\uff08Buffer\uff09\u3002 \u58f0\u6e90\uff08Source\uff09\u3002 \u4fa6\u542c\u8005\uff08Listener\uff09\u3002 \u7f13\u51b2\u533a\u50a8\u5b58\u97f3\u9891\u6570\u636e\uff0c\u5373\u97f3\u4e50\u6216\u97f3\u6548\u3002\u5b83\u4eec\u7c7b\u4f3c\u4e8eOpenGL\u4e2d\u7684\u7eb9\u7406\u3002OpenAL\u5e0c\u671b\u97f3\u9891\u6570\u636e\u91c7\u7528PCM\uff08Pulse Coded Modulation\uff0c\u8109\u51b2\u7f16\u7801\u8c03\u5236\uff09\u683c\u5f0f\uff08\u5355\u58f0\u9053\u6216\u591a\u58f0\u9053\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u80fd\u53ea\u8f6c\u50a8MP3\u6216OGG\u6587\u4ef6\u800c\u4e0d\u9996\u5148\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3aPCM\u3002 \u4e0b\u4e00\u4e2a\u5143\u7d20\u662f\u58f0\u6e90\uff0c\u5b83\u8868\u793a\u53d1\u51fa\u58f0\u97f3\u7684\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\uff08\u4e00\u4e2a\u70b9\uff09\u3002\u58f0\u6e90\u4e0e\u7f13\u51b2\u533a\u5173\u8054\uff08\u4e00\u6b21\u53ea\u80fd\u6709\u4e00\u4e2a\uff09\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4f4d\u7f6e\uff0c\u58f0\u6e90\u7684\u4f4d\u7f6e\uff08 x \uff0c y \u548c z \u5750\u6807\uff09\u3002\u987a\u4fbf\u4e00\u63d0\uff0cOpenAL\u548cOpenGL\u4e00\u6837\u4f7f\u7528\u53f3\u624b\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5047\u8bbe\uff08\u4e3a\u4e86\u7b80\u5316\uff09\u4f60\u7684\u4e16\u754c\u5750\u6807\u7b49\u4e8e\u58f0\u97f3\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5750\u6807\u3002 \u901f\u5ea6\uff0c\u5b83\u6307\u5b9a\u58f0\u6e90\u79fb\u52a8\u7684\u901f\u5ea6\u3002\u8fd9\u662f\u7528\u6765\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u7684\u3002 \u589e\u76ca\uff0c\u7528\u6765\u6539\u53d8\u58f0\u97f3\u7684\u5927\u5c0f\uff08\u5c31\u50cf\u662f\u4e00\u4e2a\u653e\u5927\u56e0\u6570\uff09\u3002 \u6e90\u4ee3\u7801\u4e2d\u6709\u989d\u5916\u7684\u5c5e\u6027\uff0c\u7a0d\u540e\u5728\u8bb2\u89e3\u6e90\u4ee3\u7801\u65f6\u5c06\u63cf\u8ff0\u8fd9\u4e9b\u5c5e\u6027\u3002 \u6700\u540e\u4f46\u5e76\u4e0d\u91cd\u8981\u7684\u662f\uff0c\u4fa6\u542c\u8005\u662f\u662f\u4ea7\u751f\u7684\u58f0\u97f3\u5e94\u8be5\u88ab\u542c\u5230\u7684\u5730\u65b9\u3002\u4fa6\u542c\u5668\u5c31\u50cf\u662f\u88ab\u8bbe\u7f6e\u5728\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u4e2d\u7528\u6765\u63a5\u6536\u58f0\u97f3\u7684\u9ea6\u514b\u98ce\u3002\u73b0\u5728\u53ea\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\u3002\u56e0\u6b64\uff0c\u4eba\u4eec\u5e38\u8bf4\u7684\u97f3\u9891\u6e32\u67d3\u662f\u4ee5\u542c\u4f17\u7684\u89d2\u5ea6\u5b8c\u6210\u7684\u3002\u4fa6\u542c\u5668\u5171\u4eab\u4e00\u4e9b\u5c5e\u6027\uff0c\u4f46\u5b83\u8fd8\u6709\u4e00\u4e9b\u9644\u52a0\u5c5e\u6027\uff0c\u6bd4\u5982\u65b9\u5411\u3002\u65b9\u5411\u8868\u793a\u4fa6\u542c\u5668\u6240\u9762\u671d\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u6709\u4e00\u7ec4\u53d1\u51fa\u58f0\u97f3\u7684\u58f0\u6e90\u548c\u63a5\u6536\u58f0\u97f3\u7684\u4fa6\u542c\u5668\u7ec4\u6210\u3002\u6700\u7ec8\u542c\u5230\u7684\u58f0\u97f3\u53d6\u51b3\u4e8e\u542c\u8005\u5230\u4e0d\u540c\u58f0\u6e90\u7684\u8ddd\u79bb\u3001\u76f8\u5bf9\u901f\u5ea6\u548c\u9009\u62e9\u7684\u4f20\u64ad\u6a21\u578b\uff08Propagation Model\uff09\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u5305\u542b\u4e0d\u540c\u5143\u7d20\u7c7b\u578b\u7684\u4e09\u7ef4\u573a\u666f\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.sound \u7684\u65b0\u5305\uff0c\u5b83\u5c06\u8d1f\u8d23\u7ba1\u7406\u6240\u6709\u8d1f\u8d23\u5904\u7406\u97f3\u9891\u7684\u7c7b\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u4e00\u4e2a\u540d\u4e3a SoundBuffer \u7684\u7c7b\u5f00\u59cb\uff0c\u5b83\u5c06\u8868\u793a\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u7684\u4e00\u4e2a\u4ee3\u7801\u7247\u6bb5\u6240\u793a\uff1a package org.lwjglb.engine.sound; // import ... public class SoundBuffer { private final int bufferId; public SoundBuffer(String file) throws Exception { this.bufferId = alGenBuffers(); try (STBVorbisInfo info = STBVorbisInfo.malloc()) { ShortBuffer pcm = readVorbis(file, 32 * 1024, info); // \u590d\u5236\u5230\u7f13\u51b2\u533a alBufferData(buffer, info.channels() == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, pcm, info.sample_rate()); } } public int getBufferId() { return this.bufferId; } public void cleanup() { alDeleteBuffers(this.bufferId); } // ... } \u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u9700\u8981\u4e00\u4e2a\u58f0\u97f3\u6587\u4ef6\uff08\u5b83\u53ef\u80fd\u4e0e\u5176\u4ed6\u8d44\u6e90\u4e00\u6837\u4f4d\u4e8e\u7c7b\u8def\u5f84\u4e2d\uff09\uff0c\u5e76\u4ece\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenBuffers \u521b\u5efa\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u6700\u540e\uff0c\u6211\u4eec\u7684\u58f0\u97f3\u7f13\u51b2\u533a\u5c06\u7528\u4e00\u4e2a\u6574\u6570\u6765\u8868\u793a\uff0c\u5c31\u50cf\u4e00\u4e2a\u6307\u5411\u5b83\u6240\u6301\u6709\u7684\u6570\u636e\u7684\u6307\u9488\u3002\u4e00\u65e6\u521b\u5efa\u4e86\u7f13\u51b2\u533a\uff0c\u6211\u4eec\u5c31\u5c06\u97f3\u9891\u6570\u636e\u8f6c\u50a8\u5230\u5176\u4e2d\u3002\u6784\u9020\u51fd\u6570\u9700\u8981OGG\u683c\u5f0f\u7684\u6587\u4ef6\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3aPCM\u683c\u5f0f\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u8fd9\u5982\u4f55\u5728\u6e90\u4ee3\u7801\u4e2d\u5b8c\u6210\u7684\uff0c\u65e0\u8bba\u5982\u4f55\uff0c\u6e90\u4ee3\u7801\u662f\u4eceLWJGL\u7684OpenAL\u6d4b\u8bd5\u4e2d\u63d0\u53d6\u7684\u3002 \u6b64\u524d\u7248\u672c\u7684LWJGL\u6709\u4e00\u4e2a\u540d\u4e3a WaveData \u7684\u5e2e\u52a9\u7c7b\uff0c\u7528\u4e8e\u52a0\u8f7dWAV\u683c\u5f0f\u7684\u97f3\u9891\u6587\u4ef6\u3002\u8fd9\u4e2a\u7c7b\u4e0d\u518d\u51fa\u73b0\u5728LWJGL3\u4e2d\u3002\u4e0d\u8fc7\uff0c\u4f60\u53ef\u4ee5\u4ece\u8be5\u7c7b\u83b7\u5f97\u6e90\u4ee3\u7801\u5e76\u5728\u6e38\u620f\u4e2d\u4f7f\u7528\u5b83\uff08\u53ef\u80fd\u4e0d\u9700\u8981\u4efb\u4f55\u4fee\u6539\uff09\u3002 SoundBuffer \u7c7b\u8fd8\u63d0\u4f9b\u4e86 cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u8d44\u6e90\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u4e3aOpenAL\u5efa\u6a21\uff0c\u5b83\u5c06\u7531\u4e00\u4e2a\u540d\u4e3a SoundSource \u7684\u7c7b\u5b9e\u73b0\u3002\u7c7b\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundSource { private final int sourceId; public SoundSource(boolean loop, boolean relative) { this.sourceId = alGenSources(); if (loop) { alSourcei(sourceId, AL_LOOPING, AL_TRUE); } if (relative) { alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE); } } public void setBuffer(int bufferId) { stop(); alSourcei(sourceId, AL_BUFFER, bufferId); } public void setPosition(Vector3f position) { alSource3f(sourceId, AL_POSITION, position.x, position.y, position.z); } public void setSpeed(Vector3f speed) { alSource3f(sourceId, AL_VELOCITY, speed.x, speed.y, speed.z); } public void setGain(float gain) { alSourcef(sourceId, AL_GAIN, gain); } public void setProperty(int param, float value) { alSourcef(sourceId, param, value); } public void play() { alSourcePlay(sourceId); } public boolean isPlaying() { return alGetSourcei(sourceId, AL_SOURCE_STATE) == AL_PLAYING; } public void pause() { alSourcePause(sourceId); } public void stop() { alSourceStop(sourceId); } public void cleanup() { stop(); alDeleteSources(sourceId); } } \u58f0\u6e90\u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e9b\u65b9\u6cd5\u6765\u8bbe\u7f6e\u5b83\u7684\u4f4d\u7f6e\u3001\u589e\u76ca\u548c\u63a7\u5236\u65b9\u6cd5\u6765\u505c\u6b62\u548c\u6682\u505c\u64ad\u653e\u3002\u8bf7\u8bb0\u4f4f\uff0c\u58f0\u97f3\u63a7\u5236\u64cd\u4f5c\u662f\u5bf9\u4e00\u4e2a\u58f0\u6e90\uff08\u800c\u4e0d\u662f\u5bf9\u7f13\u51b2\u533a\uff09\u6267\u884c\u7684\u3002\u8bf7\u8bb0\u4f4f\uff0c\u591a\u4e2a\u6e90\u53ef\u4ee5\u5171\u4eab\u540c\u4e00\u4e2a\u7f13\u51b2\u533a\u3002\u4e0e SoundBuffer \u7c7b\u4e2d\u4e00\u6837\uff0c SoundBuffer \u7531\u4e00\u4e2a\u6807\u8bc6\u7b26\u6807\u8bb0\uff0c\u8be5\u6807\u8bc6\u7b26\u5728\u6bcf\u4e2a\u64cd\u4f5c\u4e2d\u4f7f\u7528\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u4fdd\u7559\u7684\u8d44\u6e90\u3002\u4f46\u662f\u8ba9\u6211\u4eec\u770b\u770b\u6784\u9020\u51fd\u6570\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenSources \u521b\u5efa\u58f0\u6e90\uff0c\u7136\u540e\u4f7f\u7528\u6784\u9020\u51fd\u6570\u53c2\u6570\u8bbe\u7f6e\u4e00\u4e9b\u6709\u8da3\u7684\u5c5e\u6027\u3002 \u7b2c\u4e00\u4e2a\u53c2\u6570 loop \uff0c\u8868\u793a\u8981\u64ad\u653e\u7684\u58f0\u97f3\u662f\u5426\u5e94\u8be5\u5904\u4e8e\u5faa\u73af\u6a21\u5f0f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5f53\u901a\u8fc7\u58f0\u6e90\u8c03\u7528\u64ad\u653e\u64cd\u4f5c\u65f6\uff0c\u5f53\u58f0\u97f3\u64ad\u653e\u5230\u6700\u540e\u65f6\u5c06\u505c\u6b62\u3002\u8fd9\u5bf9\u4e8e\u4e00\u4e9b\u58f0\u97f3\u6765\u8bf4\u662f\u53ef\u4ee5\u7684\uff0c\u4f46\u662f\u5bf9\u4e8e\u5176\u4ed6\u4e00\u4e9b\u58f0\u97f3\uff0c\u6bd4\u5982\u80cc\u666f\u97f3\u4e50\uff0c\u5c31\u9700\u8981\u53cd\u590d\u64ad\u653e\u3002\u5f53\u58f0\u97f3\u505c\u6b62\u65f6\u4e0d\u9700\u8981\u624b\u52a8\u63a7\u5236\u5e76\u91cd\u65b0\u64ad\u653e\u58f0\u97f3\uff0c\u6211\u4eec\u5c31\u53ea\u7528\u5c06\u5faa\u73af\u5c5e\u6027\u8bbe\u7f6e\u4e3a true \uff1a alSourcei(sourceId, AL_LOOPING, AL_TRUE); \u3002 \u53e6\u4e00\u4e2a\u53c2\u6570 relative \uff0c\u63a7\u5236\u58f0\u6e90\u7684\u4f4d\u7f6e\u662f\u5426\u76f8\u5bf9\u4e8e\u4fa6\u542c\u5668\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5f53\u4e3a\u58f0\u6e90\u8bbe\u7f6e\u4f4d\u7f6e\u65f6\uff0c\u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5b9a\u4e49\u5230\u4fa6\u542c\u5668\u7684\u8ddd\u79bb\uff08\u4f7f\u7528\u60f3\u60f3\uff09\uff0c\u800c\u4e0d\u662fOpenAL\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5750\u6807\uff0c\u4e5f\u4e0d\u662f\u4e16\u754c\u5750\u6807\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE);\u201d \u542f\u7528\u7684\u3002\u4f46\u662f\uff0c\u6211\u4eec\u80fd\u7528\u5b83\u505a\u4ec0\u4e48\u5462\uff1f\u8fd9\u4e2a\u5c5e\u6027\u5f88\u6709\u8da3\uff0c\u4f8b\u5982\uff0c\u7528\u4e8e\u4e0d\u5e94\u8be5\u53d7\u5230\u4fa6\u542c\u5668\u8ddd\u79bb\u5f71\u54cd\uff08\u51cf\u5f31\uff09\u7684\u80cc\u666f\u58f0\u97f3\u3002\u4f8b\u5982\uff0c\u5728\u80cc\u666f\u97f3\u4e50\u6216\u4e0e\u64ad\u653e\u5668\u63a7\u4ef6\u76f8\u5173\u7684\u97f3\u6548\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e9b\u58f0\u6e90\u8bbe\u7f6e\u4e3a\u76f8\u5bf9\u7684\uff0c\u5e76\u5c06\u5b83\u4eec\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u4e3a (0, 0, 0) \uff0c\u5b83\u4eec\u5c06\u4e0d\u4f1a\u88ab\u51cf\u5f31\u3002 \u73b0\u5728\u8f6e\u5230\u4fa6\u542c\u5668\u4e86\uff0c\u5b83\u662f\u7531\u4e00\u4e2a\u540d\u4e3a SoundListener \u5b9a\u4e49\u7684\u3002\u4ee5\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundListener { public SoundListener() { this(new Vector3f(0, 0, 0)); } public SoundListener(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); alListener3f(AL_VELOCITY, 0, 0, 0); } public void setSpeed(Vector3f speed) { alListener3f(AL_VELOCITY, speed.x, speed.y, speed.z); } public void setPosition(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); } public void setOrientation(Vector3f at, Vector3f up) { float[] data = new float[6]; data[0] = at.x; data[1] = at.y; data[2] = at.z; data[3] = up.x; data[4] = up.y; data[5] = up.z; alListenerfv(AL_ORIENTATION, data); } } \u4e0e\u524d\u9762\u7684\u7c7b\u4e0d\u540c\uff0c\u4f60\u5c06\u6ce8\u610f\u5230\u4e0d\u9700\u8981\u521b\u5efa\u4fa6\u542c\u5668\u3002\u603b\u4f1a\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u521b\u5efa\u4e00\u4e2a\uff0c\u5b83\u5df2\u7ecf\u4e3a\u6211\u4eec\u51c6\u5907\u597d\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u662f\u7b80\u5355\u5730\u8bbe\u7f6e\u5b83\u7684\u521d\u59cb\u4f4d\u7f6e\u3002\u57fa\u4e8e\u540c\u6837\u7684\u539f\u56e0\uff0c\u6ca1\u6709\u5fc5\u8981\u4f7f\u7528 cleanup \u65b9\u6cd5\u3002\u7c7b\u4e5f\u6709\u8bbe\u7f6e\u4fa6\u542c\u5668\u4f4d\u7f6e\u548c\u901f\u5ea6\u7684\u65b9\u6cd5\uff0c\u5c31\u50cf\u5728 SoundSource \u7c7b\u4e2d\u4e00\u6837\uff0c\u4f46\u662f\u6211\u4eec\u6709\u4e00\u4e2a\u989d\u5916\u7684\u65b9\u6cd5\u6765\u4fee\u6539\u4fa6\u542c\u5668\u7684\u65b9\u5411\u3002\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u65b9\u5411\u662f\u4ec0\u4e48\u3002\u4fa6\u542c\u5668\u65b9\u5411\u7531\u4e24\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c at \u5411\u91cf\u548c up \u5411\u91cf\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a at \u5411\u91cf\u57fa\u672c\u4e0a\u6307\u5411\u4fa6\u542c\u5668\u6240\u671d\u5411\u7684\u4f4d\u7f6e\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u7684\u503c\u4e3a (0, 0, -1) \u3002 up \u5411\u91cf\u786e\u5b9a\u4fa6\u542c\u5668\u5411\u4e0a\u7684\u65b9\u5411\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u6307\u5411 (0, 1, 0) \u3002\u8fd9\u4e24\u4e2a\u5411\u91cf\u7684\u4e09\u4e2a\u5206\u91cf\u90fd\u662f\u5728 alListenerfv \u65b9\u6cd5\u8c03\u7528\u4e2d\u8bbe\u7f6e\u7684\u3002\u6b64\u65b9\u6cd5\u7528\u4e8e\u5c06\u4e00\u7ec4\u6d6e\u70b9\u6570\uff08\u6d6e\u70b9\u6570\u53d8\u91cf\uff09\u4f20\u9012\u5230\u5c5e\u6027\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u65b9\u5411\uff09\u3002 \u5728\u7ee7\u7eed\u8bb2\u89e3\u4e4b\u524d\uff0c\u6709\u5fc5\u8981\u5f3a\u8c03\u4e00\u4e9b\u4e0e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\u76f8\u5173\u7684\u6982\u5ff5\u3002\u58f0\u6e90\u4e0e\u4fa6\u542c\u5668\u4e4b\u95f4\u7684\u76f8\u5bf9\u901f\u5ea6\u4f1a\u5bfc\u81f4OpenAL\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u3002\u5982\u679c\u4f60\u4e0d\u77e5\u9053\u591a\u666e\u52d2\u6548\u5e94\u662f\u4ec0\u4e48\uff0c\u591a\u666e\u52d2\u6548\u5e94\u5c06\u5bfc\u81f4\u4e00\u4e2a\u79bb\u4f60\u8d8a\u6765\u8d8a\u8fd1\u7684\u7269\u4f53\u53d1\u51fa\u7684\u9891\u7387\u4f3c\u4e4e\u6bd4\u5b83\u79bb\u5f00\u65f6\u53d1\u51fa\u7684\u9891\u7387\u8981\u9ad8\u7684\u6548\u5e94\u3002\u95ee\u9898\u662f\uff0c\u4ec5\u4ec5\u901a\u8fc7\u8bbe\u7f6e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\uff0cOpenAL\u4e0d\u4f1a\u4e3a\u4f60\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002\u5b83\u5c06\u4f7f\u7528\u76f8\u5bf9\u901f\u5ea6\u6765\u8ba1\u7b97\u591a\u666e\u52d2\u6548\u5e94\uff0c\u4f46\u4f4d\u7f6e\u4e0d\u4f1a\u6539\u53d8\u3002\u56e0\u6b64\uff0c\u5982\u679c\u4f60\u60f3\u8981\u6a21\u62df\u4e00\u4e2a\u79fb\u52a8\u7684\u58f0\u6e90\u6216\u8005\u4fa6\u542c\u5668\uff0c\u4f60\u5fc5\u987b\u6ce8\u610f\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b9a\u4e49\u4e86\u5173\u952e\u5143\u7d20\uff0c\u4e3a\u4e86\u8ba9\u5b83\u4eec\u5de5\u4f5c\uff0c\u9700\u8981\u521d\u59cb\u5316OpenAL\u5e93\uff0c\u56e0\u6b64\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SoundManager \u7684\u65b0\u7c7b\u6765\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u3002\u4e0b\u9762\u662f\u5b9a\u4e49\u8be5\u7c7b\u7684\u4ee3\u7801\u7247\u6bb5\uff1a package org.lwjglb.engine.sound; // import ... public class SoundManager { private long device; private long context; private SoundListener listener; private final List<SoundBuffer> soundBufferList; private final Map<String, SoundSource> soundSourceMap; private final Matrix4f cameraMatrix; public SoundManager() { soundBufferList = new ArrayList<>(); soundSourceMap = new HashMap<>(); cameraMatrix = new Matrix4f(); } public void init() throws Exception { this.device = alcOpenDevice((ByteBuffer) null); if (device == NULL) { throw new IllegalStateException(\"Failed to open the default OpenAL device.\"); } ALCCapabilities deviceCaps = ALC.createCapabilities(device); this.context = alcCreateContext(device, (IntBuffer) null); if (context == NULL) { throw new IllegalStateException(\"Failed to create OpenAL context.\"); } alcMakeContextCurrent(context); AL.createCapabilities(deviceCaps); } \u8be5\u7c7b\u4fdd\u5b58\u5bf9 SoundBuffer \u548c SoundSource \u7684\u5b9e\u4f8b\u7684\u5f15\u7528\uff0c\u4ee5\u4fbf\u8ddf\u8e2a\u548c\u5728\u6b64\u4e4b\u540e\u6b63\u786e\u5730\u6e05\u7406\u5b83\u4eec\u3002 SoundBuffer \u50a8\u5b58\u5728\u4e00\u4e2a\u5217\u8868\u4e2d\uff0c\u4f46 SoundSource \u50a8\u5b58\u5728\u4e00\u4e2a Map \u4e2d\uff0c\u56e0\u6b64\u53ef\u4ee5\u901a\u8fc7\u540d\u79f0\u641c\u7d22\u5b83\u4eec\u3002 init \u65b9\u6cd5\u521d\u59cb\u5316OpenAL\u5b50\u7cfb\u7edf\uff1a \u5f00\u542f\u9ed8\u8ba4\u8bbe\u5907\u3002 \u4e3a\u8be5\u8bbe\u5907\u521b\u5efa\u529f\u80fd\u3002 \u521b\u5efa\u4e00\u4e2a\u58f0\u97f3\u73af\u5883\uff0c\u5c31\u50cf\u662fOpenGL\u90a3\u6837\uff0c\u5e76\u5c06\u5176\u8bbe\u7f6e\u4e3a\u5f53\u524d\u73af\u5883\u3002 SoundManager \u7c7b\u8fd8\u5177\u6709\u66f4\u65b0\u7ed9\u5b9a\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u4fa6\u542c\u5668\u671d\u5411\u7684\u65b9\u6cd5\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u4fa6\u542c\u5668\u5c06\u88ab\u8bbe\u7f6e\u5728\u6444\u50cf\u673a\u6240\u5728\u7684\u4f4d\u7f6e\u3002\u90a3\u4e48\uff0c\u7ed9\u5b9a\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4fe1\u606f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 at \u548c up \u5411\u91cf\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u76f8\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6211\u4eec\u9700\u8981\u5c06 at (0, 0, -1) \u4e0e up (0, 1, 0) \u5411\u91cf\u8f6c\u6362\u4e3a\u8003\u8651\u6444\u50cf\u673a\u65cb\u8f6c\u7684\u5411\u91cf\u3002\u8ba9 cameraMatrix \u4e3a\u4e0e\u6444\u50cf\u673a\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u5b9e\u73b0\u7684\u4ee3\u7801\u5982\u4e0b\uff1a Matrix4f invCam = new Matrix4f(cameraMatrix).invert(); Vector3f at = new Vector3f(0, 0, -1); invCam.transformDirection(at); Vector3f up = new Vector3f(0, 1, 0); invCam.transformDirection(up); \u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u9006\u8f6c\u6444\u50cf\u673a\u89c2\u5bdf\u77e9\u9635\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u8fd9\u6837\u60f3\uff0c\u89c2\u5bdf\u77e9\u9635\u4ece\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u6211\u4eec\u60f3\u8981\u7684\u6b63\u597d\u76f8\u53cd\uff0c\u6211\u4eec\u60f3\u8981\u4ece\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\uff08\u89c2\u5bdf\u77e9\u9635\uff09\u8f6c\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5750\u6807\uff0c\u8fd9\u662f\u4fa6\u542c\u5668\u5e94\u8be5\u88ab\u653e\u7f6e\u7684\u4f4d\u7f6e\u3002\u5bf9\u4e8e\u77e9\u9635\uff0c\u53cd\u6bd4\u901a\u5e38\u5c31\u610f\u5473\u7740\u9006\u8f6c\u3002\u4e00\u65e6\u6211\u4eec\u6709\u4e86\u8fd9\u4e2a\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8f6c\u6362 at \u548c up \u5411\u91cf\uff0c\u4f7f\u7528\u8fd9\u4e2a\u77e9\u9635\u8ba1\u7b97\u65b0\u7684\u65b9\u5411\u3002 \u4f46\u662f\uff0c\u5982\u679c\u4f60\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u770b\u5230\u5b9e\u73b0\u7565\u6709\u4e0d\u540c\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\uff1a Vector3f at = new Vector3f(); cameraMatrix.positiveZ(at).negate(); Vector3f up = new Vector3f(); cameraMatrix.positiveY(up); listener.setOrientation(at, up); \u4e0a\u8ff0\u4ee3\u7801\u7b49\u4ef7\u4e8e\u7b2c\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ea\u662f\u4e00\u79cd\u66f4\u9ad8\u6548\u7684\u65b9\u6cd5\u3002\u5b83\u4f7f\u7528\u4e86\u4e00\u79cd\u66f4\u5feb\u7684\u65b9\u6cd5\uff0c\u53ef\u4ee5\u5728 JOML \u5e93\u4e2d\u627e\u5230\uff0c\u8fd9\u79cd\u65b9\u6cd5\u4e0d\u9700\u8981\u8ba1\u7b97\u5b8c\u6574\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u53ef\u4ee5\u5f97\u5230\u76f8\u540c\u7684\u7ed3\u679c\u3002\u8fd9\u65b9\u6cd5\u662f\u7531LWJGL\u8bba\u575b\u4e2d\u7684 JOML\u4f5c\u8005 \u63d0\u4f9b\u7684\uff0c\u56e0\u6b64\u4f60\u53ef\u4ee5\u5728[\u90a3\u91cc]((http://forum.lwjgl.org/index.php?topic=6080.0)\u67e5\u770b\u66f4\u591a\u7ec6\u8282\u3002\u5982\u679c\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u5c06\u770b\u5230 SoundManager \u7c7b\u8ba1\u7b97\u5b83\u81ea\u5df1\u7684\u89c2\u5bdf\u77e9\u9635\u526f\u672c\u3002\u8fd9\u5df2\u7ecf\u5728 Renderer \u7c7b\u4e2d\u5b8c\u6210\u4e86\u3002\u4e3a\u4e86\u4fdd\u6301\u4ee3\u7801\u7b80\u5355\uff0c\u5e76\u907f\u514d\u91cd\u6784\uff0c\u6211\u503e\u5411\u4e8e\u4f7f\u7528\u8fd9\u79cd\u65b9\u5f0f\u3002 \u8fd9\u5c31\u5b8c\u4e86\u3002\u6211\u4eec\u62e5\u6709\u64ad\u653e\u58f0\u97f3\u6240\u9700\u7684\u6240\u6709\u57fa\u7840\u7ed3\u6784\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4e86\u89e3\u5982\u4f55\u4f7f\u7528\u6240\u6709\u4ee3\u7801\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u97f3\u4e50\u662f\u5982\u4f55\u64ad\u653e\u7684\uff0c\u4ee5\u53ca\u4e0d\u540c\u6548\u679c\u7684\u58f0\u97f3\uff08\u8fd9\u4e9b\u6587\u4ef6\u662f\u4ece Freesound \u4e2d\u83b7\u5f97\u7684\uff0c\u8d21\u732e\u8005\u90fd\u50a8\u5b58\u5728\u540d\u4e3aCREDITS.txt\u7684\u4e00\u4e2a\u6587\u4ef6\u4e2d\uff09\u3002\u5982\u679c\u4f60\u83b7\u5f97\u4e00\u4e9b\u5176\u4ed6\u6587\u4ef6\uff0c\u4f60\u53ef\u4ee5\u4f1a\u6ce8\u610f\u5230\u58f0\u97f3\u8870\u51cf\u4e0e\u8ddd\u79bb\u6216\u4fa6\u542c\u5668\u7684\u65b9\u5411\u65e0\u5173\u3002\u8bf7\u68c0\u67e5\u8fd9\u4e9b\u58f0\u97f3\u662f\u5426\u662f\u5355\u58f0\u9053\uff0c\u662f\u5426\u4e0d\u662f\u7acb\u4f53\u58f0\u3002OpenGL\u4ec5\u80fd\u4f7f\u7528\u5355\u58f0\u9053\u58f0\u97f3\u8fdb\u884c\u8ba1\u7b97\u3002 \u540e\u8bb0\uff0cOpenAL\u8fd8\u5141\u8bb8\u4f60\u901a\u8fc7\u4f7f\u7528 alDistanceModel \u5e76\u4f20\u9012\u4f60\u60f3\u4f7f\u7528\u7684\u6a21\u578b\uff08 AL11.AL_EXPONENT_DISTANCE \uff0c AL_EXPONENT_DISTANCE_CLAMP \uff0c\u7b49\u7b49\uff09\u3002\u4f60\u53ef\u4ee5\u7528\u5b83\u4eec\u6765\u64ad\u653e\u5e76\u68c0\u67e5\u6548\u679c\u3002","title":"\u97f3\u6548"},{"location":"22-audio/#audio","text":"\u5728\u6b64\u4e4b\u524d\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u56fe\u50cf\uff0c\u4f46\u6bcf\u4e2a\u6e38\u620f\u7684\u53e6\u4e00\u4e2a\u5173\u952e\u9762\u662f\u97f3\u9891\u3002\u672c\u7ae0\u5c06\u5728 OpenAL \uff08Open Audio Library\uff0c\u5f00\u653e\u97f3\u9891\u5e93\uff09\u7684\u5e2e\u52a9\u4e0b\u5b9e\u73b0\u8fd9\u4e2a\u529f\u80fd\u3002OpenAL\u5c31\u50cf\u662fOpenGL\u5728\u97f3\u9891\u7684\u76f8\u4f3c\u7269\uff0c\u5b83\u5141\u8bb8\u6211\u4eec\u901a\u8fc7\u62bd\u8c61\u5c42\u64ad\u653e\u58f0\u97f3\u3002\u8be5\u5c42\u5c06\u6211\u4eec\u4e0e\u97f3\u9891\u5b50\u7cfb\u7edf\u7684\u590d\u6742\u5e95\u5c42\u9694\u79bb\u5f00\u6765\u3002\u6b64\u5916\uff0c\u5b83\u8fd8\u5141\u8bb8\u6211\u4eec\u53ef\u4ee5\u4e09\u7ef4\u573a\u666f\u4e2d\u7279\u5b9a\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u58f0\u97f3\uff0c\u201c\u6e32\u67d3\u201d\u58f0\u97f3\uff0c\u968f\u7740\u8ddd\u79bb\u8870\u51cf\u5e76\u6839\u636e\u5b83\u4eec\u7684\u901f\u5ea6\u8fdb\u884c\u4fee\u6539\uff08\u6a21\u62df \u591a\u666e\u52d2\u6548\u5e94 \uff09\u3002 LWJGL\u652f\u6301OpenGL\uff0c\u4e0d\u9700\u8981\u4efb\u4f55\u989d\u5916\u7684\u4e0b\u8f7d\uff0c\u5b83\u5c31\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528\u4e86\u3002\u4f46\u662f\u5728\u5f00\u59cb\u5199\u4ee3\u7801\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4ecb\u7ecd\u5904\u7406OpenGL\u65f6\u6240\u6d89\u53ca\u7684\u4e3b\u8981\u5143\u7d20\uff0c\u5b83\u4eec\u662f\uff1a \u7f13\u51b2\u533a\uff08Buffer\uff09\u3002 \u58f0\u6e90\uff08Source\uff09\u3002 \u4fa6\u542c\u8005\uff08Listener\uff09\u3002 \u7f13\u51b2\u533a\u50a8\u5b58\u97f3\u9891\u6570\u636e\uff0c\u5373\u97f3\u4e50\u6216\u97f3\u6548\u3002\u5b83\u4eec\u7c7b\u4f3c\u4e8eOpenGL\u4e2d\u7684\u7eb9\u7406\u3002OpenAL\u5e0c\u671b\u97f3\u9891\u6570\u636e\u91c7\u7528PCM\uff08Pulse Coded Modulation\uff0c\u8109\u51b2\u7f16\u7801\u8c03\u5236\uff09\u683c\u5f0f\uff08\u5355\u58f0\u9053\u6216\u591a\u58f0\u9053\uff09\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u80fd\u53ea\u8f6c\u50a8MP3\u6216OGG\u6587\u4ef6\u800c\u4e0d\u9996\u5148\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3aPCM\u3002 \u4e0b\u4e00\u4e2a\u5143\u7d20\u662f\u58f0\u6e90\uff0c\u5b83\u8868\u793a\u53d1\u51fa\u58f0\u97f3\u7684\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u4f4d\u7f6e\uff08\u4e00\u4e2a\u70b9\uff09\u3002\u58f0\u6e90\u4e0e\u7f13\u51b2\u533a\u5173\u8054\uff08\u4e00\u6b21\u53ea\u80fd\u6709\u4e00\u4e2a\uff09\uff0c\u53ef\u4ee5\u901a\u8fc7\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4f4d\u7f6e\uff0c\u58f0\u6e90\u7684\u4f4d\u7f6e\uff08 x \uff0c y \u548c z \u5750\u6807\uff09\u3002\u987a\u4fbf\u4e00\u63d0\uff0cOpenAL\u548cOpenGL\u4e00\u6837\u4f7f\u7528\u53f3\u624b\u7b1b\u5361\u5c14\u5750\u6807\u7cfb\uff0c\u6240\u4ee5\u4f60\u53ef\u4ee5\u5047\u8bbe\uff08\u4e3a\u4e86\u7b80\u5316\uff09\u4f60\u7684\u4e16\u754c\u5750\u6807\u7b49\u4e8e\u58f0\u97f3\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\u7684\u5750\u6807\u3002 \u901f\u5ea6\uff0c\u5b83\u6307\u5b9a\u58f0\u6e90\u79fb\u52a8\u7684\u901f\u5ea6\u3002\u8fd9\u662f\u7528\u6765\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u7684\u3002 \u589e\u76ca\uff0c\u7528\u6765\u6539\u53d8\u58f0\u97f3\u7684\u5927\u5c0f\uff08\u5c31\u50cf\u662f\u4e00\u4e2a\u653e\u5927\u56e0\u6570\uff09\u3002 \u6e90\u4ee3\u7801\u4e2d\u6709\u989d\u5916\u7684\u5c5e\u6027\uff0c\u7a0d\u540e\u5728\u8bb2\u89e3\u6e90\u4ee3\u7801\u65f6\u5c06\u63cf\u8ff0\u8fd9\u4e9b\u5c5e\u6027\u3002 \u6700\u540e\u4f46\u5e76\u4e0d\u91cd\u8981\u7684\u662f\uff0c\u4fa6\u542c\u8005\u662f\u662f\u4ea7\u751f\u7684\u58f0\u97f3\u5e94\u8be5\u88ab\u542c\u5230\u7684\u5730\u65b9\u3002\u4fa6\u542c\u5668\u5c31\u50cf\u662f\u88ab\u8bbe\u7f6e\u5728\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u4e2d\u7528\u6765\u63a5\u6536\u58f0\u97f3\u7684\u9ea6\u514b\u98ce\u3002\u73b0\u5728\u53ea\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\u3002\u56e0\u6b64\uff0c\u4eba\u4eec\u5e38\u8bf4\u7684\u97f3\u9891\u6e32\u67d3\u662f\u4ee5\u542c\u4f17\u7684\u89d2\u5ea6\u5b8c\u6210\u7684\u3002\u4fa6\u542c\u5668\u5171\u4eab\u4e00\u4e9b\u5c5e\u6027\uff0c\u4f46\u5b83\u8fd8\u6709\u4e00\u4e9b\u9644\u52a0\u5c5e\u6027\uff0c\u6bd4\u5982\u65b9\u5411\u3002\u65b9\u5411\u8868\u793a\u4fa6\u542c\u5668\u6240\u9762\u671d\u7684\u4f4d\u7f6e\u3002 \u56e0\u6b64\uff0c\u4e09\u7ef4\u97f3\u9891\u573a\u666f\u6709\u4e00\u7ec4\u53d1\u51fa\u58f0\u97f3\u7684\u58f0\u6e90\u548c\u63a5\u6536\u58f0\u97f3\u7684\u4fa6\u542c\u5668\u7ec4\u6210\u3002\u6700\u7ec8\u542c\u5230\u7684\u58f0\u97f3\u53d6\u51b3\u4e8e\u542c\u8005\u5230\u4e0d\u540c\u58f0\u6e90\u7684\u8ddd\u79bb\u3001\u76f8\u5bf9\u901f\u5ea6\u548c\u9009\u62e9\u7684\u4f20\u64ad\u6a21\u578b\uff08Propagation Model\uff09\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u4e00\u4e2a\u5305\u542b\u4e0d\u540c\u5143\u7d20\u7c7b\u578b\u7684\u4e09\u7ef4\u573a\u666f\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u5199\u4ee3\u7801\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.sound \u7684\u65b0\u5305\uff0c\u5b83\u5c06\u8d1f\u8d23\u7ba1\u7406\u6240\u6709\u8d1f\u8d23\u5904\u7406\u97f3\u9891\u7684\u7c7b\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u4e00\u4e2a\u540d\u4e3a SoundBuffer \u7684\u7c7b\u5f00\u59cb\uff0c\u5b83\u5c06\u8868\u793a\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u8be5\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\u7684\u4e00\u4e2a\u4ee3\u7801\u7247\u6bb5\u6240\u793a\uff1a package org.lwjglb.engine.sound; // import ... public class SoundBuffer { private final int bufferId; public SoundBuffer(String file) throws Exception { this.bufferId = alGenBuffers(); try (STBVorbisInfo info = STBVorbisInfo.malloc()) { ShortBuffer pcm = readVorbis(file, 32 * 1024, info); // \u590d\u5236\u5230\u7f13\u51b2\u533a alBufferData(buffer, info.channels() == 1 ? AL_FORMAT_MONO16 : AL_FORMAT_STEREO16, pcm, info.sample_rate()); } } public int getBufferId() { return this.bufferId; } public void cleanup() { alDeleteBuffers(this.bufferId); } // ... } \u8be5\u7c7b\u7684\u6784\u9020\u51fd\u6570\u9700\u8981\u4e00\u4e2a\u58f0\u97f3\u6587\u4ef6\uff08\u5b83\u53ef\u80fd\u4e0e\u5176\u4ed6\u8d44\u6e90\u4e00\u6837\u4f4d\u4e8e\u7c7b\u8def\u5f84\u4e2d\uff09\uff0c\u5e76\u4ece\u4e2d\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u7f13\u51b2\u533a\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenBuffers \u521b\u5efa\u4e00\u4e2aOpenAL\u7f13\u51b2\u533a\u3002\u6700\u540e\uff0c\u6211\u4eec\u7684\u58f0\u97f3\u7f13\u51b2\u533a\u5c06\u7528\u4e00\u4e2a\u6574\u6570\u6765\u8868\u793a\uff0c\u5c31\u50cf\u4e00\u4e2a\u6307\u5411\u5b83\u6240\u6301\u6709\u7684\u6570\u636e\u7684\u6307\u9488\u3002\u4e00\u65e6\u521b\u5efa\u4e86\u7f13\u51b2\u533a\uff0c\u6211\u4eec\u5c31\u5c06\u97f3\u9891\u6570\u636e\u8f6c\u50a8\u5230\u5176\u4e2d\u3002\u6784\u9020\u51fd\u6570\u9700\u8981OGG\u683c\u5f0f\u7684\u6587\u4ef6\uff0c\u56e0\u6b64\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3aPCM\u683c\u5f0f\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u8fd9\u5982\u4f55\u5728\u6e90\u4ee3\u7801\u4e2d\u5b8c\u6210\u7684\uff0c\u65e0\u8bba\u5982\u4f55\uff0c\u6e90\u4ee3\u7801\u662f\u4eceLWJGL\u7684OpenAL\u6d4b\u8bd5\u4e2d\u63d0\u53d6\u7684\u3002 \u6b64\u524d\u7248\u672c\u7684LWJGL\u6709\u4e00\u4e2a\u540d\u4e3a WaveData \u7684\u5e2e\u52a9\u7c7b\uff0c\u7528\u4e8e\u52a0\u8f7dWAV\u683c\u5f0f\u7684\u97f3\u9891\u6587\u4ef6\u3002\u8fd9\u4e2a\u7c7b\u4e0d\u518d\u51fa\u73b0\u5728LWJGL3\u4e2d\u3002\u4e0d\u8fc7\uff0c\u4f60\u53ef\u4ee5\u4ece\u8be5\u7c7b\u83b7\u5f97\u6e90\u4ee3\u7801\u5e76\u5728\u6e38\u620f\u4e2d\u4f7f\u7528\u5b83\uff08\u53ef\u80fd\u4e0d\u9700\u8981\u4efb\u4f55\u4fee\u6539\uff09\u3002 SoundBuffer \u7c7b\u8fd8\u63d0\u4f9b\u4e86 cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u8d44\u6e90\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u4e3aOpenAL\u5efa\u6a21\uff0c\u5b83\u5c06\u7531\u4e00\u4e2a\u540d\u4e3a SoundSource \u7684\u7c7b\u5b9e\u73b0\u3002\u7c7b\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundSource { private final int sourceId; public SoundSource(boolean loop, boolean relative) { this.sourceId = alGenSources(); if (loop) { alSourcei(sourceId, AL_LOOPING, AL_TRUE); } if (relative) { alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE); } } public void setBuffer(int bufferId) { stop(); alSourcei(sourceId, AL_BUFFER, bufferId); } public void setPosition(Vector3f position) { alSource3f(sourceId, AL_POSITION, position.x, position.y, position.z); } public void setSpeed(Vector3f speed) { alSource3f(sourceId, AL_VELOCITY, speed.x, speed.y, speed.z); } public void setGain(float gain) { alSourcef(sourceId, AL_GAIN, gain); } public void setProperty(int param, float value) { alSourcef(sourceId, param, value); } public void play() { alSourcePlay(sourceId); } public boolean isPlaying() { return alGetSourcei(sourceId, AL_SOURCE_STATE) == AL_PLAYING; } public void pause() { alSourcePause(sourceId); } public void stop() { alSourceStop(sourceId); } public void cleanup() { stop(); alDeleteSources(sourceId); } } \u58f0\u6e90\u7c7b\u63d0\u4f9b\u4e86\u4e00\u4e9b\u65b9\u6cd5\u6765\u8bbe\u7f6e\u5b83\u7684\u4f4d\u7f6e\u3001\u589e\u76ca\u548c\u63a7\u5236\u65b9\u6cd5\u6765\u505c\u6b62\u548c\u6682\u505c\u64ad\u653e\u3002\u8bf7\u8bb0\u4f4f\uff0c\u58f0\u97f3\u63a7\u5236\u64cd\u4f5c\u662f\u5bf9\u4e00\u4e2a\u58f0\u6e90\uff08\u800c\u4e0d\u662f\u5bf9\u7f13\u51b2\u533a\uff09\u6267\u884c\u7684\u3002\u8bf7\u8bb0\u4f4f\uff0c\u591a\u4e2a\u6e90\u53ef\u4ee5\u5171\u4eab\u540c\u4e00\u4e2a\u7f13\u51b2\u533a\u3002\u4e0e SoundBuffer \u7c7b\u4e2d\u4e00\u6837\uff0c SoundBuffer \u7531\u4e00\u4e2a\u6807\u8bc6\u7b26\u6807\u8bb0\uff0c\u8be5\u6807\u8bc6\u7b26\u5728\u6bcf\u4e2a\u64cd\u4f5c\u4e2d\u4f7f\u7528\u3002\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a cleanup \u65b9\u6cd5\u6765\u91ca\u653e\u4fdd\u7559\u7684\u8d44\u6e90\u3002\u4f46\u662f\u8ba9\u6211\u4eec\u770b\u770b\u6784\u9020\u51fd\u6570\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 alGenSources \u521b\u5efa\u58f0\u6e90\uff0c\u7136\u540e\u4f7f\u7528\u6784\u9020\u51fd\u6570\u53c2\u6570\u8bbe\u7f6e\u4e00\u4e9b\u6709\u8da3\u7684\u5c5e\u6027\u3002 \u7b2c\u4e00\u4e2a\u53c2\u6570 loop \uff0c\u8868\u793a\u8981\u64ad\u653e\u7684\u58f0\u97f3\u662f\u5426\u5e94\u8be5\u5904\u4e8e\u5faa\u73af\u6a21\u5f0f\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c\u5f53\u901a\u8fc7\u58f0\u6e90\u8c03\u7528\u64ad\u653e\u64cd\u4f5c\u65f6\uff0c\u5f53\u58f0\u97f3\u64ad\u653e\u5230\u6700\u540e\u65f6\u5c06\u505c\u6b62\u3002\u8fd9\u5bf9\u4e8e\u4e00\u4e9b\u58f0\u97f3\u6765\u8bf4\u662f\u53ef\u4ee5\u7684\uff0c\u4f46\u662f\u5bf9\u4e8e\u5176\u4ed6\u4e00\u4e9b\u58f0\u97f3\uff0c\u6bd4\u5982\u80cc\u666f\u97f3\u4e50\uff0c\u5c31\u9700\u8981\u53cd\u590d\u64ad\u653e\u3002\u5f53\u58f0\u97f3\u505c\u6b62\u65f6\u4e0d\u9700\u8981\u624b\u52a8\u63a7\u5236\u5e76\u91cd\u65b0\u64ad\u653e\u58f0\u97f3\uff0c\u6211\u4eec\u5c31\u53ea\u7528\u5c06\u5faa\u73af\u5c5e\u6027\u8bbe\u7f6e\u4e3a true \uff1a alSourcei(sourceId, AL_LOOPING, AL_TRUE); \u3002 \u53e6\u4e00\u4e2a\u53c2\u6570 relative \uff0c\u63a7\u5236\u58f0\u6e90\u7684\u4f4d\u7f6e\u662f\u5426\u76f8\u5bf9\u4e8e\u4fa6\u542c\u5668\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5f53\u4e3a\u58f0\u6e90\u8bbe\u7f6e\u4f4d\u7f6e\u65f6\uff0c\u6211\u4eec\u57fa\u672c\u4e0a\u662f\u5728\u5b9a\u4e49\u5230\u4fa6\u542c\u5668\u7684\u8ddd\u79bb\uff08\u4f7f\u7528\u60f3\u60f3\uff09\uff0c\u800c\u4e0d\u662fOpenAL\u4e09\u7ef4\u573a\u666f\u4e2d\u7684\u5750\u6807\uff0c\u4e5f\u4e0d\u662f\u4e16\u754c\u5750\u6807\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 alSourcei(sourceId, AL_SOURCE_RELATIVE, AL_TRUE);\u201d \u542f\u7528\u7684\u3002\u4f46\u662f\uff0c\u6211\u4eec\u80fd\u7528\u5b83\u505a\u4ec0\u4e48\u5462\uff1f\u8fd9\u4e2a\u5c5e\u6027\u5f88\u6709\u8da3\uff0c\u4f8b\u5982\uff0c\u7528\u4e8e\u4e0d\u5e94\u8be5\u53d7\u5230\u4fa6\u542c\u5668\u8ddd\u79bb\u5f71\u54cd\uff08\u51cf\u5f31\uff09\u7684\u80cc\u666f\u58f0\u97f3\u3002\u4f8b\u5982\uff0c\u5728\u80cc\u666f\u97f3\u4e50\u6216\u4e0e\u64ad\u653e\u5668\u63a7\u4ef6\u76f8\u5173\u7684\u97f3\u6548\u3002\u5982\u679c\u6211\u4eec\u5c06\u8fd9\u4e9b\u58f0\u6e90\u8bbe\u7f6e\u4e3a\u76f8\u5bf9\u7684\uff0c\u5e76\u5c06\u5b83\u4eec\u7684\u4f4d\u7f6e\u8bbe\u7f6e\u4e3a (0, 0, 0) \uff0c\u5b83\u4eec\u5c06\u4e0d\u4f1a\u88ab\u51cf\u5f31\u3002 \u73b0\u5728\u8f6e\u5230\u4fa6\u542c\u5668\u4e86\uff0c\u5b83\u662f\u7531\u4e00\u4e2a\u540d\u4e3a SoundListener \u5b9a\u4e49\u7684\u3002\u4ee5\u4e0b\u662f\u8be5\u7c7b\u7684\u5b9a\u4e49\uff1a package org.lwjglb.engine.sound; import org.joml.Vector3f; import static org.lwjgl.openal.AL10.*; public class SoundListener { public SoundListener() { this(new Vector3f(0, 0, 0)); } public SoundListener(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); alListener3f(AL_VELOCITY, 0, 0, 0); } public void setSpeed(Vector3f speed) { alListener3f(AL_VELOCITY, speed.x, speed.y, speed.z); } public void setPosition(Vector3f position) { alListener3f(AL_POSITION, position.x, position.y, position.z); } public void setOrientation(Vector3f at, Vector3f up) { float[] data = new float[6]; data[0] = at.x; data[1] = at.y; data[2] = at.z; data[3] = up.x; data[4] = up.y; data[5] = up.z; alListenerfv(AL_ORIENTATION, data); } } \u4e0e\u524d\u9762\u7684\u7c7b\u4e0d\u540c\uff0c\u4f60\u5c06\u6ce8\u610f\u5230\u4e0d\u9700\u8981\u521b\u5efa\u4fa6\u542c\u5668\u3002\u603b\u4f1a\u6709\u4e00\u4e2a\u4fa6\u542c\u5668\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u521b\u5efa\u4e00\u4e2a\uff0c\u5b83\u5df2\u7ecf\u4e3a\u6211\u4eec\u51c6\u5907\u597d\u4e86\u3002\u56e0\u6b64\uff0c\u5728\u6784\u9020\u51fd\u6570\u4e2d\uff0c\u6211\u4eec\u53ea\u662f\u7b80\u5355\u5730\u8bbe\u7f6e\u5b83\u7684\u521d\u59cb\u4f4d\u7f6e\u3002\u57fa\u4e8e\u540c\u6837\u7684\u539f\u56e0\uff0c\u6ca1\u6709\u5fc5\u8981\u4f7f\u7528 cleanup \u65b9\u6cd5\u3002\u7c7b\u4e5f\u6709\u8bbe\u7f6e\u4fa6\u542c\u5668\u4f4d\u7f6e\u548c\u901f\u5ea6\u7684\u65b9\u6cd5\uff0c\u5c31\u50cf\u5728 SoundSource \u7c7b\u4e2d\u4e00\u6837\uff0c\u4f46\u662f\u6211\u4eec\u6709\u4e00\u4e2a\u989d\u5916\u7684\u65b9\u6cd5\u6765\u4fee\u6539\u4fa6\u542c\u5668\u7684\u65b9\u5411\u3002\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u65b9\u5411\u662f\u4ec0\u4e48\u3002\u4fa6\u542c\u5668\u65b9\u5411\u7531\u4e24\u4e2a\u5411\u91cf\u5b9a\u4e49\uff0c at \u5411\u91cf\u548c up \u5411\u91cf\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a at \u5411\u91cf\u57fa\u672c\u4e0a\u6307\u5411\u4fa6\u542c\u5668\u6240\u671d\u5411\u7684\u4f4d\u7f6e\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u7684\u503c\u4e3a (0, 0, -1) \u3002 up \u5411\u91cf\u786e\u5b9a\u4fa6\u542c\u5668\u5411\u4e0a\u7684\u65b9\u5411\uff0c\u9ed8\u8ba4\u60c5\u51b5\u4e0b\u5b83\u6307\u5411 (0, 1, 0) \u3002\u8fd9\u4e24\u4e2a\u5411\u91cf\u7684\u4e09\u4e2a\u5206\u91cf\u90fd\u662f\u5728 alListenerfv \u65b9\u6cd5\u8c03\u7528\u4e2d\u8bbe\u7f6e\u7684\u3002\u6b64\u65b9\u6cd5\u7528\u4e8e\u5c06\u4e00\u7ec4\u6d6e\u70b9\u6570\uff08\u6d6e\u70b9\u6570\u53d8\u91cf\uff09\u4f20\u9012\u5230\u5c5e\u6027\uff08\u5728\u672c\u4f8b\u4e2d\u4e3a\u65b9\u5411\uff09\u3002 \u5728\u7ee7\u7eed\u8bb2\u89e3\u4e4b\u524d\uff0c\u6709\u5fc5\u8981\u5f3a\u8c03\u4e00\u4e9b\u4e0e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\u76f8\u5173\u7684\u6982\u5ff5\u3002\u58f0\u6e90\u4e0e\u4fa6\u542c\u5668\u4e4b\u95f4\u7684\u76f8\u5bf9\u901f\u5ea6\u4f1a\u5bfc\u81f4OpenAL\u6a21\u62df\u591a\u666e\u52d2\u6548\u5e94\u3002\u5982\u679c\u4f60\u4e0d\u77e5\u9053\u591a\u666e\u52d2\u6548\u5e94\u662f\u4ec0\u4e48\uff0c\u591a\u666e\u52d2\u6548\u5e94\u5c06\u5bfc\u81f4\u4e00\u4e2a\u79bb\u4f60\u8d8a\u6765\u8d8a\u8fd1\u7684\u7269\u4f53\u53d1\u51fa\u7684\u9891\u7387\u4f3c\u4e4e\u6bd4\u5b83\u79bb\u5f00\u65f6\u53d1\u51fa\u7684\u9891\u7387\u8981\u9ad8\u7684\u6548\u5e94\u3002\u95ee\u9898\u662f\uff0c\u4ec5\u4ec5\u901a\u8fc7\u8bbe\u7f6e\u58f0\u97f3\u548c\u4fa6\u542c\u5668\u901f\u5ea6\uff0cOpenAL\u4e0d\u4f1a\u4e3a\u4f60\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002\u5b83\u5c06\u4f7f\u7528\u76f8\u5bf9\u901f\u5ea6\u6765\u8ba1\u7b97\u591a\u666e\u52d2\u6548\u5e94\uff0c\u4f46\u4f4d\u7f6e\u4e0d\u4f1a\u6539\u53d8\u3002\u56e0\u6b64\uff0c\u5982\u679c\u4f60\u60f3\u8981\u6a21\u62df\u4e00\u4e2a\u79fb\u52a8\u7684\u58f0\u6e90\u6216\u8005\u4fa6\u542c\u5668\uff0c\u4f60\u5fc5\u987b\u6ce8\u610f\u5728\u6e38\u620f\u5faa\u73af\u4e2d\u66f4\u65b0\u5b83\u4eec\u7684\u4f4d\u7f6e\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u5b9a\u4e49\u4e86\u5173\u952e\u5143\u7d20\uff0c\u4e3a\u4e86\u8ba9\u5b83\u4eec\u5de5\u4f5c\uff0c\u9700\u8981\u521d\u59cb\u5316OpenAL\u5e93\uff0c\u56e0\u6b64\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SoundManager \u7684\u65b0\u7c7b\u6765\u5904\u7406\u8fd9\u4e2a\u95ee\u9898\u3002\u4e0b\u9762\u662f\u5b9a\u4e49\u8be5\u7c7b\u7684\u4ee3\u7801\u7247\u6bb5\uff1a package org.lwjglb.engine.sound; // import ... public class SoundManager { private long device; private long context; private SoundListener listener; private final List<SoundBuffer> soundBufferList; private final Map<String, SoundSource> soundSourceMap; private final Matrix4f cameraMatrix; public SoundManager() { soundBufferList = new ArrayList<>(); soundSourceMap = new HashMap<>(); cameraMatrix = new Matrix4f(); } public void init() throws Exception { this.device = alcOpenDevice((ByteBuffer) null); if (device == NULL) { throw new IllegalStateException(\"Failed to open the default OpenAL device.\"); } ALCCapabilities deviceCaps = ALC.createCapabilities(device); this.context = alcCreateContext(device, (IntBuffer) null); if (context == NULL) { throw new IllegalStateException(\"Failed to create OpenAL context.\"); } alcMakeContextCurrent(context); AL.createCapabilities(deviceCaps); } \u8be5\u7c7b\u4fdd\u5b58\u5bf9 SoundBuffer \u548c SoundSource \u7684\u5b9e\u4f8b\u7684\u5f15\u7528\uff0c\u4ee5\u4fbf\u8ddf\u8e2a\u548c\u5728\u6b64\u4e4b\u540e\u6b63\u786e\u5730\u6e05\u7406\u5b83\u4eec\u3002 SoundBuffer \u50a8\u5b58\u5728\u4e00\u4e2a\u5217\u8868\u4e2d\uff0c\u4f46 SoundSource \u50a8\u5b58\u5728\u4e00\u4e2a Map \u4e2d\uff0c\u56e0\u6b64\u53ef\u4ee5\u901a\u8fc7\u540d\u79f0\u641c\u7d22\u5b83\u4eec\u3002 init \u65b9\u6cd5\u521d\u59cb\u5316OpenAL\u5b50\u7cfb\u7edf\uff1a \u5f00\u542f\u9ed8\u8ba4\u8bbe\u5907\u3002 \u4e3a\u8be5\u8bbe\u5907\u521b\u5efa\u529f\u80fd\u3002 \u521b\u5efa\u4e00\u4e2a\u58f0\u97f3\u73af\u5883\uff0c\u5c31\u50cf\u662fOpenGL\u90a3\u6837\uff0c\u5e76\u5c06\u5176\u8bbe\u7f6e\u4e3a\u5f53\u524d\u73af\u5883\u3002 SoundManager \u7c7b\u8fd8\u5177\u6709\u66f4\u65b0\u7ed9\u5b9a\u6444\u50cf\u673a\u4f4d\u7f6e\u7684\u4fa6\u542c\u5668\u671d\u5411\u7684\u65b9\u6cd5\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u4fa6\u542c\u5668\u5c06\u88ab\u8bbe\u7f6e\u5728\u6444\u50cf\u673a\u6240\u5728\u7684\u4f4d\u7f6e\u3002\u90a3\u4e48\uff0c\u7ed9\u5b9a\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4fe1\u606f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 at \u548c up \u5411\u91cf\u5462\uff1f\u7b54\u6848\u662f\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u76f8\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u6211\u4eec\u9700\u8981\u5c06 at (0, 0, -1) \u4e0e up (0, 1, 0) \u5411\u91cf\u8f6c\u6362\u4e3a\u8003\u8651\u6444\u50cf\u673a\u65cb\u8f6c\u7684\u5411\u91cf\u3002\u8ba9 cameraMatrix \u4e3a\u4e0e\u6444\u50cf\u673a\u5173\u8054\u7684\u89c2\u5bdf\u77e9\u9635\u3002\u5b9e\u73b0\u7684\u4ee3\u7801\u5982\u4e0b\uff1a Matrix4f invCam = new Matrix4f(cameraMatrix).invert(); Vector3f at = new Vector3f(0, 0, -1); invCam.transformDirection(at); Vector3f up = new Vector3f(0, 1, 0); invCam.transformDirection(up); \u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u9006\u8f6c\u6444\u50cf\u673a\u89c2\u5bdf\u77e9\u9635\u3002\u4e3a\u4ec0\u4e48\u8981\u8fd9\u4e48\u505a\uff1f\u8fd9\u6837\u60f3\uff0c\u89c2\u5bdf\u77e9\u9635\u4ece\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u6211\u4eec\u60f3\u8981\u7684\u6b63\u597d\u76f8\u53cd\uff0c\u6211\u4eec\u60f3\u8981\u4ece\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\uff08\u89c2\u5bdf\u77e9\u9635\uff09\u8f6c\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5750\u6807\uff0c\u8fd9\u662f\u4fa6\u542c\u5668\u5e94\u8be5\u88ab\u653e\u7f6e\u7684\u4f4d\u7f6e\u3002\u5bf9\u4e8e\u77e9\u9635\uff0c\u53cd\u6bd4\u901a\u5e38\u5c31\u610f\u5473\u7740\u9006\u8f6c\u3002\u4e00\u65e6\u6211\u4eec\u6709\u4e86\u8fd9\u4e2a\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8f6c\u6362 at \u548c up \u5411\u91cf\uff0c\u4f7f\u7528\u8fd9\u4e2a\u77e9\u9635\u8ba1\u7b97\u65b0\u7684\u65b9\u5411\u3002 \u4f46\u662f\uff0c\u5982\u679c\u4f60\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u4f1a\u770b\u5230\u5b9e\u73b0\u7565\u6709\u4e0d\u540c\uff0c\u6211\u4eec\u6240\u505a\u7684\u662f\uff1a Vector3f at = new Vector3f(); cameraMatrix.positiveZ(at).negate(); Vector3f up = new Vector3f(); cameraMatrix.positiveY(up); listener.setOrientation(at, up); \u4e0a\u8ff0\u4ee3\u7801\u7b49\u4ef7\u4e8e\u7b2c\u4e00\u79cd\u65b9\u6cd5\uff0c\u5b83\u53ea\u662f\u4e00\u79cd\u66f4\u9ad8\u6548\u7684\u65b9\u6cd5\u3002\u5b83\u4f7f\u7528\u4e86\u4e00\u79cd\u66f4\u5feb\u7684\u65b9\u6cd5\uff0c\u53ef\u4ee5\u5728 JOML \u5e93\u4e2d\u627e\u5230\uff0c\u8fd9\u79cd\u65b9\u6cd5\u4e0d\u9700\u8981\u8ba1\u7b97\u5b8c\u6574\u7684\u9006\u77e9\u9635\uff0c\u4f46\u662f\u53ef\u4ee5\u5f97\u5230\u76f8\u540c\u7684\u7ed3\u679c\u3002\u8fd9\u65b9\u6cd5\u662f\u7531LWJGL\u8bba\u575b\u4e2d\u7684 JOML\u4f5c\u8005 \u63d0\u4f9b\u7684\uff0c\u56e0\u6b64\u4f60\u53ef\u4ee5\u5728[\u90a3\u91cc]((http://forum.lwjgl.org/index.php?topic=6080.0)\u67e5\u770b\u66f4\u591a\u7ec6\u8282\u3002\u5982\u679c\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4f60\u5c06\u770b\u5230 SoundManager \u7c7b\u8ba1\u7b97\u5b83\u81ea\u5df1\u7684\u89c2\u5bdf\u77e9\u9635\u526f\u672c\u3002\u8fd9\u5df2\u7ecf\u5728 Renderer \u7c7b\u4e2d\u5b8c\u6210\u4e86\u3002\u4e3a\u4e86\u4fdd\u6301\u4ee3\u7801\u7b80\u5355\uff0c\u5e76\u907f\u514d\u91cd\u6784\uff0c\u6211\u503e\u5411\u4e8e\u4f7f\u7528\u8fd9\u79cd\u65b9\u5f0f\u3002 \u8fd9\u5c31\u5b8c\u4e86\u3002\u6211\u4eec\u62e5\u6709\u64ad\u653e\u58f0\u97f3\u6240\u9700\u7684\u6240\u6709\u57fa\u7840\u7ed3\u6784\u3002\u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u4e86\u89e3\u5982\u4f55\u4f7f\u7528\u6240\u6709\u4ee3\u7801\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u97f3\u4e50\u662f\u5982\u4f55\u64ad\u653e\u7684\uff0c\u4ee5\u53ca\u4e0d\u540c\u6548\u679c\u7684\u58f0\u97f3\uff08\u8fd9\u4e9b\u6587\u4ef6\u662f\u4ece Freesound \u4e2d\u83b7\u5f97\u7684\uff0c\u8d21\u732e\u8005\u90fd\u50a8\u5b58\u5728\u540d\u4e3aCREDITS.txt\u7684\u4e00\u4e2a\u6587\u4ef6\u4e2d\uff09\u3002\u5982\u679c\u4f60\u83b7\u5f97\u4e00\u4e9b\u5176\u4ed6\u6587\u4ef6\uff0c\u4f60\u53ef\u4ee5\u4f1a\u6ce8\u610f\u5230\u58f0\u97f3\u8870\u51cf\u4e0e\u8ddd\u79bb\u6216\u4fa6\u542c\u5668\u7684\u65b9\u5411\u65e0\u5173\u3002\u8bf7\u68c0\u67e5\u8fd9\u4e9b\u58f0\u97f3\u662f\u5426\u662f\u5355\u58f0\u9053\uff0c\u662f\u5426\u4e0d\u662f\u7acb\u4f53\u58f0\u3002OpenGL\u4ec5\u80fd\u4f7f\u7528\u5355\u58f0\u9053\u58f0\u97f3\u8fdb\u884c\u8ba1\u7b97\u3002 \u540e\u8bb0\uff0cOpenAL\u8fd8\u5141\u8bb8\u4f60\u901a\u8fc7\u4f7f\u7528 alDistanceModel \u5e76\u4f20\u9012\u4f60\u60f3\u4f7f\u7528\u7684\u6a21\u578b\uff08 AL11.AL_EXPONENT_DISTANCE \uff0c AL_EXPONENT_DISTANCE_CLAMP \uff0c\u7b49\u7b49\uff09\u3002\u4f60\u53ef\u4ee5\u7528\u5b83\u4eec\u6765\u64ad\u653e\u5e76\u68c0\u67e5\u6548\u679c\u3002","title":"\u97f3\u9891\uff08Audio\uff09"},{"location":"23-3d-object-picking/","text":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6\uff083D Object Picking\uff09 \u6444\u50cf\u673a\u9009\u53d6 \u6bcf\u4e00\u4e2a\u6e38\u620f\u7684\u5173\u952e\u4e4b\u4e00\u662f\u80fd\u4e0e\u73af\u5883\u4ea4\u4e92\uff0c\u8be5\u529f\u80fd\u8981\u6c42\u80fd\u591f\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u9009\u53d6\u7269\u4f53\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u63a2\u8ba8\u5982\u4f55\u5b9e\u73b0\u8fd9\u4e00\u529f\u80fd\u3002 \u4f46\u662f\uff0c\u5728\u5f00\u59cb\u8bb2\u8ff0\u9009\u53d6\u7269\u4f53\u7684\u6b65\u9aa4\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e00\u79cd\u8868\u793a\u6240\u9009\u7269\u4f53\u7684\u65b9\u6cd5\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6dfb\u52a0\u4e00\u4e2a\u5c5e\u6027\u5230 GameItem \u7c7b\uff0c\u8fd9\u5141\u8bb8\u6211\u4eec\u6807\u8bb0\u9009\u5b9a\u7684\u5bf9\u8c61\uff1a private boolean selected; \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8be5\u503c\u3002\u8ba9\u6211\u4eec\u4ece\u7247\u5143\u7740\u8272\u5668\uff08 scene_fragment.fs \uff09\u5f00\u59cb\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u4ece\u9876\u70b9\u7740\u8272\u5668\u63a5\u6536\u4e00\u4e2a\u6807\u8bb0\uff0c\u8be5\u6807\u8bb0\u5c06\u786e\u5b9a\u8981\u6e32\u67d3\u7684\u7247\u5143\u662f\u5426\u662f\u9009\u5b9a\u7684\u7269\u4f53\u3002 in float outSelected; \u7136\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u7ed3\u5c3e\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u6700\u7ec8\u7684\u7247\u5143\u989c\u8272\uff0c\u5982\u679c\u9009\u4e2d\uff0c\u5219\u5c06\u84dd\u8272\u5206\u91cf\u8bbe\u7f6e\u4e3a 1 . if ( outSelected > 0 ) { fragColor = vec4(fragColor.x, fragColor.y, 1, 1); } \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8be5\u503c\u3002\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\u524d\u9762\u7684\u7ae0\u8282\uff0c\u6211\u4eec\u6709\u4e24\u79cd\u60c5\u51b5\uff1a \u6e32\u67d3\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u6e32\u67d3\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u5728\u7b2c\u4e00\u79cd\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a GameItem \u7684\u6570\u636e\u901a\u8fc7Uniform\u4f20\u9012\uff0c\u56e0\u6b64\u6211\u4eec\u53ea\u9700\u8981\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684Uniform\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b9e\u4f8b\u5316\u5c5e\u6027\u3002\u53ef\u4ee5\u770b\u5230\u4e0b\u8ff0\u4ee3\u7801\u4e2d\u96c6\u6210\u4e86\u4e24\u79cd\u60c5\u51b5\u5230\u9876\u70b9\u7740\u8272\u5668\u3002 layout (location=14) in float selectedInstanced; ... uniform float selectedNonInstanced; ... if ( isInstanced > 0 ) { outSelected = selectedInstanced; ... } else { outSelected = selectedNonInstanced; ... \u65e2\u7136\u5df2\u7ecf\u505a\u597d\u4e86\u57fa\u672c\u51c6\u5907\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u5982\u4f55\u9009\u62e9\u5bf9\u8c61\u3002\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u89c2\u5bdf\u77e9\u9635\u73b0\u5728\u50a8\u5b58\u5728 Camera \u7c7b\u4e2d\u3002\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u6e90\u4ee3\u7801\u4e2d\u7684\u51e0\u4e2a\u7c7b\u91cd\u65b0\u8ba1\u7b97\u4e86\u89c2\u5bdf\u77e9\u9635\uff0c\u6b64\u524d\u5b83\u50a8\u5b58\u5728 Transformation \u548c SoundManager \u7c7b\u4e2d\u3002\u4e3a\u4e86\u8ba1\u7b97\u4ea4\u70b9\uff0c\u6211\u4eec\u5c31\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\u3002\u4e0e\u5176\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\uff0c\u6211\u4eec\u4e0d\u5982\u628a\u5b83\u96c6\u4e2d\u5230 Camera \u7c7b\u4e2d\u3002\u8fd9\u4e00\u66f4\u6539\u8fd8\u9700\u8981\u89c2\u5bdf\u77e9\u9635\u5728\u6e38\u620f\u4e3b\u5faa\u73af\u4e2d\u66f4\u65b0\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7269\u4f53\u9009\u53d6\u7684\u8ba8\u8bba\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4e00\u4e2a\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u9009\u53d6\u5c06\u7531\u6444\u50cf\u673a\u81ea\u52a8\u5730\u5b8c\u6210\uff0c\u5c06\u9009\u62e9\u6444\u50cf\u673a\u6240\u9762\u5bf9\u7684\u6700\u8fd1\u7684\u7269\u4f53\u3002\u8ba9\u6211\u4eec\u8ba8\u8bba\u4e00\u4e0b\u5982\u4f55\u505a\u5230\u5b83\u3002 \u4e0b\u56fe\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u60c5\u51b5\uff1a \u6211\u4eec\u628a\u6444\u50cf\u673a\u653e\u5728\u4e16\u754c\u7a7a\u95f4\u7684\u67d0\u4e2a\u5750\u6807\u4e2d\uff0c\u9762\u671d\u4e00\u4e2a\u7279\u5b9a\u65b9\u5411\u3002\u4efb\u4f55\u4e00\u4e2a\u7269\u4f53\uff0c\u5982\u679c\u5b83\u4e0e\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u524d\u5411\u7684\u5149\u7ebf\u6295\u5c04\uff08Ray Cast\uff09\u76f8\u4ea4\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5019\u9009\u7269\u4f53\u3002\u5728\u6240\u6709\u5019\u9009\u7269\u4f53\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9009\u62e9\u6700\u8fd1\u7684\u4e00\u4e2a\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6e38\u620f\u9879\u662f\u7acb\u65b9\u4f53\uff0c\u56e0\u6b64\u9700\u8981\u8ba1\u7b97\u6444\u50cf\u673a\u7684\u524d\u5411\u5411\u91cf\u4e0e\u7acb\u65b9\u4f53\u7684\u4ea4\u70b9\u3002\u8fd9\u4f3c\u4e4e\u662f\u4e00\u4e2a\u975e\u5e38\u7279\u6b8a\u7684\u60c5\u51b5\uff0c\u4f46\u5b9e\u9645\u4e0a\u662f\u975e\u5e38\u5e38\u89c1\u7684\u3002\u5728\u8bb8\u591a\u6e38\u620f\u4e2d\uff0c\u6e38\u620f\u9879\u90fd\u4e0e\u6240\u8c13\u7684\u8fb9\u754c\u6846\uff08Bounding Box\uff09\u76f8\u5173\u8fde\u3002\u8fb9\u754c\u6846\u662f\u4e00\u4e2a\u77e9\u5f62\u6846\uff0c\u5b83\u56ca\u62ec\u4e86\u8be5\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u3002\u4f8b\u5982\uff0c\u8fb9\u754c\u6846\u4e5f\u7528\u4e8e\u78b0\u649e\u68c0\u6d4b\u3002\u5b9e\u9645\u4e0a\uff0c\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\uff0c\u4f60\u770b\u5230\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u8fd9\u6709\u52a9\u4e8e\u5728\u4efb\u610f\u7ed9\u5b9a\u65f6\u95f4\u8bbe\u7f6e\u8fb9\u754c\u3002 \u63a5\u4e0b\u6765\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a CameraBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u6709\u4e00\u4e2a\u540d\u4e3a selectGameItem \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u6536\u6e38\u620f\u9879\u5217\u8868\u548c\u6444\u50cf\u673a\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void selectGameItem(GameItem[] gameItems, Camera camera) { GameItem selectedGameItem = null; float closestDistance = Float.POSITIVE_INFINITY; dir = camera.getViewMatrix().positiveZ(dir).negate(); for (GameItem gameItem : gameItems) { gameItem.setSelected(false); min.set(gameItem.getPosition()); max.set(gameItem.getPosition()); min.add(-gameItem.getScale(), -gameItem.getScale(), -gameItem.getScale()); max.add(gameItem.getScale(), gameItem.getScale(), gameItem.getScale()); if (Intersectionf.intersectRayAab(camera.getPosition(), dir, min, max, nearFar) && nearFar.x < closestDistance) { closestDistance = nearFar.x; selectedGameItem = gameItem; } } if (selectedGameItem != null) { selectedGameItem.setSelected(true); } } \u8be5\u65b9\u6cd5\u5c06\u8fed\u4ee3\u6e38\u620f\u9879\uff0c\u5c1d\u8bd5\u4ece\u4e2d\u83b7\u53d6\u4e0e\u6444\u50cf\u673a\u5149\u7ebf\u6295\u5c04\u76f8\u4ea4\u7684\u9879\u3002\u5b83\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a closestDistance \u7684\u53d8\u91cf\uff0c\u8be5\u53d8\u91cf\u5c06\u50a8\u5b58\u6700\u8fd1\u7684\u8ddd\u79bb\u3002\u5bf9\u4e8e\u76f8\u4ea4\u7684\u6e38\u620f\u9879\uff0c\u5c06\u8ba1\u7b97\u6444\u50cf\u673a\u5230\u4ea4\u70b9\u7684\u8ddd\u79bb\uff0c\u5982\u679c\u8be5\u8ddd\u79bb\u5c0f\u4e8e\u50a8\u5b58\u5728 closestDistance \u4e2d\u7684\u503c\uff0c\u5219\u8be5\u9879\u5c06\u6210\u4e3a\u65b0\u7684\u5019\u9009\u9879\u3002 \u5728\u8fdb\u5165\u5faa\u73af\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u6444\u50cf\u673a\u6240\u9762\u5411\u7684\u65b9\u5411\u5411\u91cf\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u53ea\u9700\u4f7f\u7528\u89c6\u56fe\u77e9\u9635\u53bb\u83b7\u5f97\u8003\u8651\u76f8\u673a\u65cb\u8f6c\u7684Z\u65b9\u5411\u3002\u8bb0\u4f4f\uff0c\u6b63Z\u6307\u5411\u5c4f\u5e55\u5916\uff0c\u6240\u4ee5\u9700\u8981\u76f8\u53cd\u7684\u65b9\u5411\u5411\u91cf\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u8981\u53cd\u65b9\u5411\uff08 negate \uff09\u3002 \u5728\u6e38\u620f\u5faa\u73af\u4e2d\uff0c\u6bcf\u4e2a GameItem \u90fd\u8981\u8fdb\u884c\u76f8\u4ea4\u8ba1\u7b97\u3002\u4f46\u662f\uff0c\u6211\u4eec\u8be5\u600e\u4e48\u505a\u5462\uff1f\u8fd9\u5c31\u662f JOML \u5e93\u6765\u5e2e\u5fd9\u7684\u5730\u65b9\u4e86\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f JOML \u7684 Intersectionf \u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u51e0\u79cd\u8ba1\u7b97\u4e8c\u7ef4\u548c\u4e09\u7ef4\u4ea4\u70b9\u7684\u65b9\u6cd5\u3002\u5177\u4f53\u6765\u8bf4\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f intersectRayAab \u65b9\u6cd5\u3002 \u8be5\u65b9\u6cd5\u5b9e\u73b0\u4e86\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\uff08Axis Aligned Bounding Box\uff0c\u7b80\u79f0AABB\uff09\u4ea4\u70b9\u68c0\u6d4b\u7b97\u6cd5\u3002\u4f60\u53ef\u4ee5\u67e5\u770bJOML\u6587\u6863\u4e2d\u6307\u51fa\u7684 \u8be6\u7ec6\u4fe1\u606f \u3002 \u8be5\u65b9\u6cd5\u6d4b\u8bd5\u7531\u539f\u70b9\u548c\u65b9\u5411\u5b9a\u4e49\u7684\u5c04\u7ebf\u662f\u5426\u4e0e\u7531\u6700\u5c0f\u548c\u6700\u5927\u5750\u6807\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u76f8\u4ea4\u3002\u8fd9\u4e2a\u7b97\u6cd5\u662f\u6709\u6548\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7acb\u65b9\u4f53\u662f\u8f74\u5bf9\u9f50\u7684\uff0c\u5982\u679c\u65cb\u8f6c\u5b83\u4eec\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c31\u4e0d\u8d77\u4f5c\u7528\u3002\u56e0\u6b64\uff0c\u8be5\u65b9\u6cd5\u63a5\u6536\u4ee5\u4e0b\u53c2\u6570\uff1a \u4e00\u4e2a\u539f\u70b9\uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002 \u4e00\u4e2a\u65b9\u5411\uff1a\u5728\u8fd9\u91cc\u662f\u6444\u50cf\u673a\u7684\u671d\u5411\uff0c\u524d\u5411\u5411\u91cf\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5c0f\u5750\u6807\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7acb\u65b9\u4f53\u4ee5 GameItem \u5750\u6807\u4e3a\u4e2d\u5fc3\uff0c\u6700\u5c0f\u5750\u6807\u662f\u8be5\u5750\u6807\u51cf\u53bb\u6bd4\u4f8b\u3002\uff08\u5728\u5176\u539f\u59cb\u5927\u5c0f\u4e2d\uff0c\u7acb\u65b9\u4f53\u7684\u957f\u5ea6\u4e3a2\uff0c\u6bd4\u4f8b\u4e3a1\uff09\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5927\u5750\u6807\u3002\u4e0d\u8a00\u800c\u55bb\u3002 \u4e00\u4e2a\u7ed3\u679c\u5411\u91cf\u3002\u5b83\u5c06\u50a8\u5b58\u5230\u8fdc\u8fd1\u4ea4\u70b9\u7684\u8ddd\u79bb\uff08\u5bf9\u4e8e\u4e00\u4e2a\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\u548c\u4e00\u6761\u5c04\u7ebf\uff0c\u6700\u591a\u6709\u4e24\u4e2a\u4ea4\u70b9\uff09\u3002 \u5982\u679c\u6709\u4ea4\u70b9\uff0c\u8be5\u65b9\u6cd5\u5c06\u8fd4\u56de true \u3002\u5982\u679c\u4e3a true \uff0c\u6211\u4eec\u5c06\u68c0\u67e5\u6700\u8fd1\u8ddd\u79bb\u5e76\u5728\u5fc5\u8981\u65f6\u66f4\u65b0\u5b83\uff0c\u5e76\u50a8\u5b58\u6240\u9009\u5019\u9009 GameItem \u7684\u5f15\u7528\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8be5\u65b9\u6cd5\u4e2d\u6d89\u53ca\u7684\u6240\u6709\u8981\u7d20\u3002 \u4e00\u65e6\u5faa\u73af\u5b8c\u6210\uff0c\u5019\u9009 GamItem \u5c06\u88ab\u6807\u8bb0\u4e3a\u5df2\u9009\u5b9a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u4e86\u3002 selectGameItem \u5c06\u5728 DummyGame \u7c7b\u7684\u66f4\u65b0\u65b9\u6cd5\u4e2d\u8c03\u7528\uff0c\u540c\u65f6\u8c03\u7528\u7684\u8fd8\u6709\u89c2\u5bdf\u77e9\u9635\u66f4\u65b0\u3002 // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 camera.updateViewMatrix(); // \u66f4\u65b0\u58f0\u97f3\u76d1\u542c\u5668\u4f4d\u7f6e soundMgr.updateListenerPosition(camera); this.selectDetector.selectGameItem(gameItems, camera); \u6b64\u5916\uff0c\u4e00\u4e2a\u5341\u5b57\u7784\u51c6\u7ebf\uff08Cross-hair\uff09\u5df2\u6dfb\u52a0\u5230\u6e32\u67d3\u4e2d\uff0c\u4ee5\u68c0\u67e5\u4e00\u5207\u5de5\u4f5c\u6b63\u5e38\u3002\u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u663e\u7136\uff0c\u8fd9\u91cc\u7ed9\u51fa\u7684\u65b9\u6cd5\u8fdc\u8fdc\u4e0d\u662f\u6700\u4f73\u7684\uff0c\u4f46\u5b83\u5c06\u4e3a\u4f60\u63d0\u4f9b\u57fa\u7840\u77e5\u8bc6\uff0c\u662f\u4f60\u80fd\u591f\u81ea\u5df1\u5f00\u53d1\u66f4\u590d\u6742\u7684\u65b9\u6cd5\u3002\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u5f88\u5bb9\u6613\u88ab\u4e22\u5f03\uff0c\u6bd4\u5982\u6444\u50cf\u673a\u540e\u9762\u7684\u7269\u4f53\uff0c\u56e0\u4e3a\u5b83\u4eec\u4e0d\u4f1a\u76f8\u4ea4\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u4f60\u6362\u53ef\u4ee5\u6839\u636e\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u6765\u786e\u5b9a\u7269\u4f53\uff0c\u4ee5\u52a0\u5feb\u8ba1\u7b97\u901f\u5ea6\u3002\u6b64\u5916\uff0c\u53ea\u6709\u5728\u6444\u50cf\u673a\u79fb\u52a8\u6216\u65cb\u8f6c\u540e\uff0c\u624d\u9700\u8981\u8fdb\u884c\u8ba1\u7b97\u3002 \u9f20\u6807\u9009\u53d6 \u7528\u6444\u50cf\u673a\u9009\u53d6\u7269\u4f53\u5b8c\u6210\u4e86\uff0c\u4f46\u5f53\u6211\u4eec\u60f3\u7528\u9f20\u6807\u81ea\u7531\u9009\u62e9\u7269\u4f53\u600e\u4e48\u529e\uff1f\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5e0c\u671b\u6bcf\u5f53\u7528\u6237\u5355\u51fb\u5c4f\u5e55\u65f6\uff0c\u81ea\u52a8\u9009\u62e9\u6700\u8fd1\u7684\u5bf9\u8c61\u3002 \u5b9e\u73b0\u5b83\u7684\u65b9\u6cd5\u7c7b\u4f3c\u4e8e\u4e0a\u8ff0\u65b9\u6cd5\u3002\u5728\u4e4b\u524d\u7684\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u5e76\u6839\u636e\u6444\u50cf\u673a\u5f53\u524d\u7684\u65b9\u5411\u4f7f\u7528\u201c\u524d\u5411\u201d\u65b9\u5411\u4ece\u6444\u50cf\u673a\u751f\u6210\u5c04\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u4ecd\u9700\u8981\u6295\u5c04\u5e7f\u897f\uff0c\u4f46\u65b9\u5411\u6307\u5411\u4e00\u4e2a\u8fdc\u79bb\u6444\u50cf\u673a\u7684\u70b9\uff0c\u4e5f\u5c31\u662f\u70b9\u51fb\u7684\u70b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u70b9\u51fb\u7684\u5750\u6807\u6765\u8ba1\u7b97\u65b9\u5411\u5411\u91cf\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u5c06\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5462\uff1f\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u5982\u4f55\u4ece\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u4e3a\u4e86\u8fbe\u5230\u8fd9\u4e2a\u76ee\u7684\uff0c\u6240\u5e94\u7528\u7684\u4e0d\u540c\u5750\u6807\u53d8\u6362\u662f\uff1a \u6211\u4eec\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u5c06\u6a21\u578b\u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u3002 \u6211\u4eec\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff08\u63d0\u4f9b\u6444\u50cf\u673a\u529f\u80fd\uff09\u5c06\u4e16\u754c\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u3002 \u6211\u4eec\u901a\u8fc7\u5e94\u7528\u900f\u89c6\u6295\u5f71\u77e9\u9635\u5c06\u89c2\u5bdf\u5750\u6807\u53d8\u6362\u5230\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\uff08Homogeneous Clip Space\uff09\u3002 \u6700\u7ec8\u7684\u5c4f\u5e55\u5750\u6807\u7531OpenGL\u4e3a\u6211\u4eec\u81ea\u52a8\u8ba1\u7b97\u3002\u5728\u6b64\u4e4b\u524d\uff0c\u5b83\u4f20\u9012\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\uff08\u901a\u8fc7\u5c06 x,y,z \u5750\u6807\u9664\u4ee5 w \u5206\u91cf\uff09\uff0c\u7136\u540e\u4f20\u9012\u5230 x,y \u5c4f\u5e55\u5750\u6807\u3002 \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4ece\u5c4f\u5e55\u5750\u6807 (x,y) \u5230\u4e16\u754c\u5750\u6807\uff0c\u9006\u8def\u5f84\u904d\u5386\u3002 \u7b2c\u4e00\u6b65\u662f\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\u3002\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u7684\u8303\u56f4\u662f [0, \u5c4f\u5e55\u5bbd\u5ea6] [0, \u5c4f\u5e55\u9ad8\u5ea6] \u3002\u5c4f\u5e55\u5de6\u4e0a\u89d2\u7684\u5750\u6807\u4e3a (0, 0) \u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3a [-1, 1] \u8303\u56f4\u5185\u7684\u5750\u6807\u3002 \u5f88\u7b80\u5355\u7684\u6570\u5b66\uff1a x = 2 \\cdot screen_x / screenwidth - 1 y = 1 - 2 * screen_y / screenheight \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 z \u5206\u91cf\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u7ed9\u5b83\u5206\u914d -1 \u503c\uff0c\u8fd9\u6837\u5e7f\u897f\u5c31\u53ef\u4ee5\u6307\u5411\u6700\u8fdc\u7684\u53ef\u89c1\u8ddd\u79bb\uff08\u8bf7\u8bb0\u4f4f\uff0c\u5728OpenGL\u4e2d\uff0c -1 \u6307\u5411\u9891\u5e55\uff09\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e86\u5f52\u4e00\u5316\u7ec8\u7aef\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\u3002 \u4e3a\u4e86\u7ee7\u7eed\u53d8\u6362\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u9f50\u6b21\u526a\u5207\u7a7a\u95f4\u3002\u6211\u4eec\u9700\u8981\u6709\u4e00\u4e2a w \u5206\u91cf\uff0c\u5b83\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u3002\u867d\u7136\u8fd9\u4e2a\u6982\u5ff5\u5728\u524d\u51e0\u7ae0\u5df2\u7ecf\u4ecb\u7ecd\u8fc7\u4e86\uff0c\u4f46\u8ba9\u6211\u4eec\u518d\u56de\u987e\u5b83\u3002\u4e3a\u4e86\u8868\u793a\u4e00\u4e2a\u4e09\u7ef4\u70b9\uff0c\u6211\u4eec\u9700\u8981 x \uff0c y \u548c z \u5206\u91cf\uff0c\u4f46\u662f\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u4e00\u4e2a\u989d\u5916\u7684 w \u5206\u91cf\u3002\u6211\u4eec\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\u6765\u4f7f\u7528\u77e9\u9635\u6267\u884c\u4e0d\u540c\u7684\u53d8\u6362\u3002\u6709\u4e9b\u53d8\u5316\u4e0d\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\uff0c\u4f46\u6709\u4e9b\u53d8\u6362\u9700\u8981\u3002\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u53ea\u6709 x \uff0c y \u548c z \u5206\u91cf\uff0c\u90a3\u4e48\u53d8\u6362\u77e9\u9635\u5c31\u4e0d\u80fd\u5de5\u4f5c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86 w \u5206\u91cf\uff0c\u5e76\u4e3a\u5b83\u4eec\u8d4b\u503c\u4e3a 1 \uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u5904\u74064x4\u77e9\u9635\u4e86\u3002 \u6b64\u5916\uff0c\u5927\u591a\u6570\u53d8\u6362\uff0c\u6216\u8005\u66f4\u7cbe\u786e\u5730\u8bf4\uff0c\u5927\u591a\u6570\u53d8\u6362\u77e9\u9635\u90fd\u4e0d\u4f1a\u66f4\u6539 w \u5206\u91cf\u3002\u6295\u5f71\u77e9\u9635\u662f\u4e00\u4e2a\u4f8b\u5916\uff0c\u8be5\u77e9\u9635\u5c06 w \u5206\u91cf\u66f4\u6539\u4e3a\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\u3002 \u901a\u8fc7\u5c06 x \uff0c y \u548c z \u5206\u91cf\u5904\u4ee5 w \uff0c\u5c31\u53ef\u4ee5\u5b9e\u73b0\u4ece\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u5750\u6807\u7684\u8f6c\u6362\u3002\u7531\u4e8e\u8fd9\u4e2a\u5206\u91cf\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\uff0c\u610f\u5473\u7740\u8fdc\u5904\u7684\u7269\u4f53\u88ab\u753b\u5f97\u66f4\u5c0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u9700\u8981\u53cd\u5176\u9053\u800c\u884c\u4e4b\uff0c\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e00\u6b65\uff0c\u53ea\u9700\u8981\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 1 \uff0c\u5e76\u4fdd\u7559\u5176\u5b83\u7ec4\u4ef6\u7684\u539f\u59cb\u503c\u3002 \u6211\u4eec\u73b0\u5728\u9700\u8981\u56de\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u6295\u5f71\u77e9\u9635\u7684\u9006\u77e9\u9635\u5e76\u5c06\u5b83\u4e0e4\u4e2a\u5206\u91cf\u5411\u91cf\u76f8\u4e58\u3002\u5b8c\u6210\u4e4b\u540e\uff0c\u6211\u4eec\u5c31\u9700\u8981\u628a\u5b83\u4eec\u8f6c\u6362\u6210\u4e16\u754c\u7a7a\u95f4\u3002\u540c\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u8ba1\u7b97\u5b83\u7684\u9006\u77e9\u9635\u7136\u540e\u4e58\u4ee5\u5411\u91cf\u3002 \u8bb0\u4f4f\uff0c\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\uff0c\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002\u6211\u4eec\u8fd8\u53ef\u4ee5\u5c06 z \u7ec4\u4ef6\u518d\u6b21\u8bbe\u7f6e\u4e3a -1 \uff0c\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u5b83\u6307\u5411\u9891\u5e55\u3002\u4e00\u65e6\u8fd9\u6837\u505a\u5e76\u5e94\u7528\u9006\u77e9\u9635\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u4e86\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u5411\u91cf\u3002\u6211\u4eec\u8ba1\u7b97\u4e86\u5c04\u7ebf\uff0c\u53ef\u4ee5\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u9009\u53d6\u76f8\u540c\u7684\u7b97\u6cd5\u3002 \u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a MouseBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86\u4e0a\u8ff0\u6b65\u9aa4\u3002\u6b64\u5916\uff0c\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u79fb\u52a8\u5230 Window \u7c7b\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728\u51e0\u4e2a\u5730\u65b9\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u8fd8\u91cd\u6784\u4e86\u4e00\u70b9 CameraBoxSelectionDetector \uff0c\u6240\u4ee5 MouseBoxSelectionDetector \u53ef\u4ee5\u7ee7\u627f\u548c\u4f7f\u7528\u78b0\u649e\u68c0\u6d4b\u65b9\u6cd5\u3002\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5b9e\u73b0\u975e\u5e38\u7b80\u5355\u3002 \u7ed3\u679c\u5982\u4e0b\u6240\u793a\uff1a \u4f60\u53ea\u9700\u7528\u9f20\u6807\u5355\u51fb\u8be5\u65b9\u5757\u5373\u53ef\u8fdb\u884c\u9009\u53d6\u3002 \u4e4b\u540e\u4f60\u53ef\u4ee5\u53c2\u8003\u4e00\u7bc7 \u4f18\u79c0\u6587\u7ae0 \u4e2d\u80cc\u5b8c\u6240\u89e3\u91ca\u7684\u6b65\u9aa4\u7684\u7ec6\u8282\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6d89\u53ca\u4e0d\u540c\u65b9\u6848\u7684\u975e\u5e38\u8be6\u7ec6\u7684\u8bf4\u660e\u3002","title":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6"},{"location":"23-3d-object-picking/#3d-object-picking","text":"","title":"\u4e09\u7ef4\u7269\u4f53\u9009\u53d6\uff083D Object Picking\uff09"},{"location":"23-3d-object-picking/#_1","text":"\u6bcf\u4e00\u4e2a\u6e38\u620f\u7684\u5173\u952e\u4e4b\u4e00\u662f\u80fd\u4e0e\u73af\u5883\u4ea4\u4e92\uff0c\u8be5\u529f\u80fd\u8981\u6c42\u80fd\u591f\u5728\u4e09\u7ef4\u573a\u666f\u4e2d\u9009\u53d6\u7269\u4f53\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u63a2\u8ba8\u5982\u4f55\u5b9e\u73b0\u8fd9\u4e00\u529f\u80fd\u3002 \u4f46\u662f\uff0c\u5728\u5f00\u59cb\u8bb2\u8ff0\u9009\u53d6\u7269\u4f53\u7684\u6b65\u9aa4\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u4e00\u79cd\u8868\u793a\u6240\u9009\u7269\u4f53\u7684\u65b9\u6cd5\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5fc5\u987b\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u6dfb\u52a0\u4e00\u4e2a\u5c5e\u6027\u5230 GameItem \u7c7b\uff0c\u8fd9\u5141\u8bb8\u6211\u4eec\u6807\u8bb0\u9009\u5b9a\u7684\u5bf9\u8c61\uff1a private boolean selected; \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8be5\u503c\u3002\u8ba9\u6211\u4eec\u4ece\u7247\u5143\u7740\u8272\u5668\uff08 scene_fragment.fs \uff09\u5f00\u59cb\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u5047\u8bbe\u4ece\u9876\u70b9\u7740\u8272\u5668\u63a5\u6536\u4e00\u4e2a\u6807\u8bb0\uff0c\u8be5\u6807\u8bb0\u5c06\u786e\u5b9a\u8981\u6e32\u67d3\u7684\u7247\u5143\u662f\u5426\u662f\u9009\u5b9a\u7684\u7269\u4f53\u3002 in float outSelected; \u7136\u540e\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u7684\u7ed3\u5c3e\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u6700\u7ec8\u7684\u7247\u5143\u989c\u8272\uff0c\u5982\u679c\u9009\u4e2d\uff0c\u5219\u5c06\u84dd\u8272\u5206\u91cf\u8bbe\u7f6e\u4e3a 1 . if ( outSelected > 0 ) { fragColor = vec4(fragColor.x, fragColor.y, 1, 1); } \u7136\u540e\uff0c\u6211\u4eec\u9700\u8981\u80fd\u591f\u4e3a\u6bcf\u4e2a GameItem \u8bbe\u7f6e\u8be5\u503c\u3002\u5982\u679c\u4f60\u56de\u60f3\u4e00\u4e0b\u524d\u9762\u7684\u7ae0\u8282\uff0c\u6211\u4eec\u6709\u4e24\u79cd\u60c5\u51b5\uff1a \u6e32\u67d3\u975e\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u6e32\u67d3\u5b9e\u4f8b\u5316\u7f51\u683c\u3002 \u5728\u7b2c\u4e00\u79cd\u60c5\u51b5\u4e0b\uff0c\u6bcf\u4e2a GameItem \u7684\u6570\u636e\u901a\u8fc7Uniform\u4f20\u9012\uff0c\u56e0\u6b64\u6211\u4eec\u53ea\u9700\u8981\u5728\u9876\u70b9\u7740\u8272\u5668\u4e2d\u4e3a\u5b83\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684Uniform\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9700\u8981\u521b\u5efa\u4e00\u4e2a\u65b0\u7684\u5b9e\u4f8b\u5316\u5c5e\u6027\u3002\u53ef\u4ee5\u770b\u5230\u4e0b\u8ff0\u4ee3\u7801\u4e2d\u96c6\u6210\u4e86\u4e24\u79cd\u60c5\u51b5\u5230\u9876\u70b9\u7740\u8272\u5668\u3002 layout (location=14) in float selectedInstanced; ... uniform float selectedNonInstanced; ... if ( isInstanced > 0 ) { outSelected = selectedInstanced; ... } else { outSelected = selectedNonInstanced; ... \u65e2\u7136\u5df2\u7ecf\u505a\u597d\u4e86\u57fa\u672c\u51c6\u5907\uff0c\u6211\u4eec\u53ea\u9700\u8981\u5b9a\u4e49\u5982\u4f55\u9009\u62e9\u5bf9\u8c61\u3002\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u5982\u679c\u4f60\u67e5\u9605\u6e90\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u6ce8\u610f\u5230\u89c2\u5bdf\u77e9\u9635\u73b0\u5728\u50a8\u5b58\u5728 Camera \u7c7b\u4e2d\u3002\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u5728\u6e90\u4ee3\u7801\u4e2d\u7684\u51e0\u4e2a\u7c7b\u91cd\u65b0\u8ba1\u7b97\u4e86\u89c2\u5bdf\u77e9\u9635\uff0c\u6b64\u524d\u5b83\u50a8\u5b58\u5728 Transformation \u548c SoundManager \u7c7b\u4e2d\u3002\u4e3a\u4e86\u8ba1\u7b97\u4ea4\u70b9\uff0c\u6211\u4eec\u5c31\u9700\u8981\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\u3002\u4e0e\u5176\u521b\u5efa\u53e6\u4e00\u4e2a\u526f\u672c\uff0c\u6211\u4eec\u4e0d\u5982\u628a\u5b83\u96c6\u4e2d\u5230 Camera \u7c7b\u4e2d\u3002\u8fd9\u4e00\u66f4\u6539\u8fd8\u9700\u8981\u89c2\u5bdf\u77e9\u9635\u5728\u6e38\u620f\u4e3b\u5faa\u73af\u4e2d\u66f4\u65b0\u3002 \u8ba9\u6211\u4eec\u7ee7\u7eed\u7269\u4f53\u9009\u53d6\u7684\u8ba8\u8bba\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u57fa\u4e8e\u4e00\u4e2a\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u9009\u53d6\u5c06\u7531\u6444\u50cf\u673a\u81ea\u52a8\u5730\u5b8c\u6210\uff0c\u5c06\u9009\u62e9\u6444\u50cf\u673a\u6240\u9762\u5bf9\u7684\u6700\u8fd1\u7684\u7269\u4f53\u3002\u8ba9\u6211\u4eec\u8ba8\u8bba\u4e00\u4e0b\u5982\u4f55\u505a\u5230\u5b83\u3002 \u4e0b\u56fe\u662f\u6211\u4eec\u9700\u8981\u89e3\u51b3\u7684\u60c5\u51b5\uff1a \u6211\u4eec\u628a\u6444\u50cf\u673a\u653e\u5728\u4e16\u754c\u7a7a\u95f4\u7684\u67d0\u4e2a\u5750\u6807\u4e2d\uff0c\u9762\u671d\u4e00\u4e2a\u7279\u5b9a\u65b9\u5411\u3002\u4efb\u4f55\u4e00\u4e2a\u7269\u4f53\uff0c\u5982\u679c\u5b83\u4e0e\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u524d\u5411\u7684\u5149\u7ebf\u6295\u5c04\uff08Ray Cast\uff09\u76f8\u4ea4\uff0c\u90a3\u4e48\u5b83\u5c31\u662f\u5019\u9009\u7269\u4f53\u3002\u5728\u6240\u6709\u5019\u9009\u7269\u4f53\u4e2d\uff0c\u6211\u4eec\u53ea\u9700\u8981\u9009\u62e9\u6700\u8fd1\u7684\u4e00\u4e2a\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6e38\u620f\u9879\u662f\u7acb\u65b9\u4f53\uff0c\u56e0\u6b64\u9700\u8981\u8ba1\u7b97\u6444\u50cf\u673a\u7684\u524d\u5411\u5411\u91cf\u4e0e\u7acb\u65b9\u4f53\u7684\u4ea4\u70b9\u3002\u8fd9\u4f3c\u4e4e\u662f\u4e00\u4e2a\u975e\u5e38\u7279\u6b8a\u7684\u60c5\u51b5\uff0c\u4f46\u5b9e\u9645\u4e0a\u662f\u975e\u5e38\u5e38\u89c1\u7684\u3002\u5728\u8bb8\u591a\u6e38\u620f\u4e2d\uff0c\u6e38\u620f\u9879\u90fd\u4e0e\u6240\u8c13\u7684\u8fb9\u754c\u6846\uff08Bounding Box\uff09\u76f8\u5173\u8fde\u3002\u8fb9\u754c\u6846\u662f\u4e00\u4e2a\u77e9\u5f62\u6846\uff0c\u5b83\u56ca\u62ec\u4e86\u8be5\u7269\u4f53\u7684\u6240\u6709\u9876\u70b9\u3002\u4f8b\u5982\uff0c\u8fb9\u754c\u6846\u4e5f\u7528\u4e8e\u78b0\u649e\u68c0\u6d4b\u3002\u5b9e\u9645\u4e0a\uff0c\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\uff0c\u4f60\u770b\u5230\u7684\u6bcf\u4e2a\u52a8\u753b\u5e27\u90fd\u5b9a\u4e49\u4e86\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u8fd9\u6709\u52a9\u4e8e\u5728\u4efb\u610f\u7ed9\u5b9a\u65f6\u95f4\u8bbe\u7f6e\u8fb9\u754c\u3002 \u63a5\u4e0b\u6765\u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a CameraBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u6709\u4e00\u4e2a\u540d\u4e3a selectGameItem \u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5c06\u63a5\u6536\u6e38\u620f\u9879\u5217\u8868\u548c\u6444\u50cf\u673a\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void selectGameItem(GameItem[] gameItems, Camera camera) { GameItem selectedGameItem = null; float closestDistance = Float.POSITIVE_INFINITY; dir = camera.getViewMatrix().positiveZ(dir).negate(); for (GameItem gameItem : gameItems) { gameItem.setSelected(false); min.set(gameItem.getPosition()); max.set(gameItem.getPosition()); min.add(-gameItem.getScale(), -gameItem.getScale(), -gameItem.getScale()); max.add(gameItem.getScale(), gameItem.getScale(), gameItem.getScale()); if (Intersectionf.intersectRayAab(camera.getPosition(), dir, min, max, nearFar) && nearFar.x < closestDistance) { closestDistance = nearFar.x; selectedGameItem = gameItem; } } if (selectedGameItem != null) { selectedGameItem.setSelected(true); } } \u8be5\u65b9\u6cd5\u5c06\u8fed\u4ee3\u6e38\u620f\u9879\uff0c\u5c1d\u8bd5\u4ece\u4e2d\u83b7\u53d6\u4e0e\u6444\u50cf\u673a\u5149\u7ebf\u6295\u5c04\u76f8\u4ea4\u7684\u9879\u3002\u5b83\u9996\u5148\u5b9a\u4e49\u4e00\u4e2a\u540d\u4e3a closestDistance \u7684\u53d8\u91cf\uff0c\u8be5\u53d8\u91cf\u5c06\u50a8\u5b58\u6700\u8fd1\u7684\u8ddd\u79bb\u3002\u5bf9\u4e8e\u76f8\u4ea4\u7684\u6e38\u620f\u9879\uff0c\u5c06\u8ba1\u7b97\u6444\u50cf\u673a\u5230\u4ea4\u70b9\u7684\u8ddd\u79bb\uff0c\u5982\u679c\u8be5\u8ddd\u79bb\u5c0f\u4e8e\u50a8\u5b58\u5728 closestDistance \u4e2d\u7684\u503c\uff0c\u5219\u8be5\u9879\u5c06\u6210\u4e3a\u65b0\u7684\u5019\u9009\u9879\u3002 \u5728\u8fdb\u5165\u5faa\u73af\u4e4b\u524d\uff0c\u6211\u4eec\u9700\u8981\u6444\u50cf\u673a\u6240\u9762\u5411\u7684\u65b9\u5411\u5411\u91cf\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u53ea\u9700\u4f7f\u7528\u89c6\u56fe\u77e9\u9635\u53bb\u83b7\u5f97\u8003\u8651\u76f8\u673a\u65cb\u8f6c\u7684Z\u65b9\u5411\u3002\u8bb0\u4f4f\uff0c\u6b63Z\u6307\u5411\u5c4f\u5e55\u5916\uff0c\u6240\u4ee5\u9700\u8981\u76f8\u53cd\u7684\u65b9\u5411\u5411\u91cf\uff0c\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u8981\u53cd\u65b9\u5411\uff08 negate \uff09\u3002 \u5728\u6e38\u620f\u5faa\u73af\u4e2d\uff0c\u6bcf\u4e2a GameItem \u90fd\u8981\u8fdb\u884c\u76f8\u4ea4\u8ba1\u7b97\u3002\u4f46\u662f\uff0c\u6211\u4eec\u8be5\u600e\u4e48\u505a\u5462\uff1f\u8fd9\u5c31\u662f JOML \u5e93\u6765\u5e2e\u5fd9\u7684\u5730\u65b9\u4e86\u3002\u6211\u4eec\u4f7f\u7528\u7684\u662f JOML \u7684 Intersectionf \u7c7b\uff0c\u5b83\u63d0\u4f9b\u4e86\u51e0\u79cd\u8ba1\u7b97\u4e8c\u7ef4\u548c\u4e09\u7ef4\u4ea4\u70b9\u7684\u65b9\u6cd5\u3002\u5177\u4f53\u6765\u8bf4\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662f intersectRayAab \u65b9\u6cd5\u3002 \u8be5\u65b9\u6cd5\u5b9e\u73b0\u4e86\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\uff08Axis Aligned Bounding Box\uff0c\u7b80\u79f0AABB\uff09\u4ea4\u70b9\u68c0\u6d4b\u7b97\u6cd5\u3002\u4f60\u53ef\u4ee5\u67e5\u770bJOML\u6587\u6863\u4e2d\u6307\u51fa\u7684 \u8be6\u7ec6\u4fe1\u606f \u3002 \u8be5\u65b9\u6cd5\u6d4b\u8bd5\u7531\u539f\u70b9\u548c\u65b9\u5411\u5b9a\u4e49\u7684\u5c04\u7ebf\u662f\u5426\u4e0e\u7531\u6700\u5c0f\u548c\u6700\u5927\u5750\u6807\u5b9a\u4e49\u7684\u8fb9\u754c\u6846\u76f8\u4ea4\u3002\u8fd9\u4e2a\u7b97\u6cd5\u662f\u6709\u6548\u7684\uff0c\u56e0\u4e3a\u6211\u4eec\u7684\u7acb\u65b9\u4f53\u662f\u8f74\u5bf9\u9f50\u7684\uff0c\u5982\u679c\u65cb\u8f6c\u5b83\u4eec\uff0c\u8fd9\u4e2a\u65b9\u6cd5\u5c31\u4e0d\u8d77\u4f5c\u7528\u3002\u56e0\u6b64\uff0c\u8be5\u65b9\u6cd5\u63a5\u6536\u4ee5\u4e0b\u53c2\u6570\uff1a \u4e00\u4e2a\u539f\u70b9\uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u662f\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u3002 \u4e00\u4e2a\u65b9\u5411\uff1a\u5728\u8fd9\u91cc\u662f\u6444\u50cf\u673a\u7684\u671d\u5411\uff0c\u524d\u5411\u5411\u91cf\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5c0f\u5750\u6807\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u7acb\u65b9\u4f53\u4ee5 GameItem \u5750\u6807\u4e3a\u4e2d\u5fc3\uff0c\u6700\u5c0f\u5750\u6807\u662f\u8be5\u5750\u6807\u51cf\u53bb\u6bd4\u4f8b\u3002\uff08\u5728\u5176\u539f\u59cb\u5927\u5c0f\u4e2d\uff0c\u7acb\u65b9\u4f53\u7684\u957f\u5ea6\u4e3a2\uff0c\u6bd4\u4f8b\u4e3a1\uff09\u3002 \u8fb9\u754c\u6846\u7684\u6700\u5927\u5750\u6807\u3002\u4e0d\u8a00\u800c\u55bb\u3002 \u4e00\u4e2a\u7ed3\u679c\u5411\u91cf\u3002\u5b83\u5c06\u50a8\u5b58\u5230\u8fdc\u8fd1\u4ea4\u70b9\u7684\u8ddd\u79bb\uff08\u5bf9\u4e8e\u4e00\u4e2a\u8f74\u5bf9\u9f50\u8fb9\u754c\u6846\u548c\u4e00\u6761\u5c04\u7ebf\uff0c\u6700\u591a\u6709\u4e24\u4e2a\u4ea4\u70b9\uff09\u3002 \u5982\u679c\u6709\u4ea4\u70b9\uff0c\u8be5\u65b9\u6cd5\u5c06\u8fd4\u56de true \u3002\u5982\u679c\u4e3a true \uff0c\u6211\u4eec\u5c06\u68c0\u67e5\u6700\u8fd1\u8ddd\u79bb\u5e76\u5728\u5fc5\u8981\u65f6\u66f4\u65b0\u5b83\uff0c\u5e76\u50a8\u5b58\u6240\u9009\u5019\u9009 GameItem \u7684\u5f15\u7528\u3002\u4e0b\u56fe\u5c55\u793a\u4e86\u8be5\u65b9\u6cd5\u4e2d\u6d89\u53ca\u7684\u6240\u6709\u8981\u7d20\u3002 \u4e00\u65e6\u5faa\u73af\u5b8c\u6210\uff0c\u5019\u9009 GamItem \u5c06\u88ab\u6807\u8bb0\u4e3a\u5df2\u9009\u5b9a\u3002 \u8fd9\u5c31\u662f\u5168\u90e8\u4e86\u3002 selectGameItem \u5c06\u5728 DummyGame \u7c7b\u7684\u66f4\u65b0\u65b9\u6cd5\u4e2d\u8c03\u7528\uff0c\u540c\u65f6\u8c03\u7528\u7684\u8fd8\u6709\u89c2\u5bdf\u77e9\u9635\u66f4\u65b0\u3002 // \u66f4\u65b0\u89c2\u5bdf\u77e9\u9635 camera.updateViewMatrix(); // \u66f4\u65b0\u58f0\u97f3\u76d1\u542c\u5668\u4f4d\u7f6e soundMgr.updateListenerPosition(camera); this.selectDetector.selectGameItem(gameItems, camera); \u6b64\u5916\uff0c\u4e00\u4e2a\u5341\u5b57\u7784\u51c6\u7ebf\uff08Cross-hair\uff09\u5df2\u6dfb\u52a0\u5230\u6e32\u67d3\u4e2d\uff0c\u4ee5\u68c0\u67e5\u4e00\u5207\u5de5\u4f5c\u6b63\u5e38\u3002\u7ed3\u679c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u663e\u7136\uff0c\u8fd9\u91cc\u7ed9\u51fa\u7684\u65b9\u6cd5\u8fdc\u8fdc\u4e0d\u662f\u6700\u4f73\u7684\uff0c\u4f46\u5b83\u5c06\u4e3a\u4f60\u63d0\u4f9b\u57fa\u7840\u77e5\u8bc6\uff0c\u662f\u4f60\u80fd\u591f\u81ea\u5df1\u5f00\u53d1\u66f4\u590d\u6742\u7684\u65b9\u6cd5\u3002\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u5f88\u5bb9\u6613\u88ab\u4e22\u5f03\uff0c\u6bd4\u5982\u6444\u50cf\u673a\u540e\u9762\u7684\u7269\u4f53\uff0c\u56e0\u4e3a\u5b83\u4eec\u4e0d\u4f1a\u76f8\u4ea4\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u4f60\u6362\u53ef\u4ee5\u6839\u636e\u6444\u50cf\u673a\u7684\u8ddd\u79bb\u6765\u786e\u5b9a\u7269\u4f53\uff0c\u4ee5\u52a0\u5feb\u8ba1\u7b97\u901f\u5ea6\u3002\u6b64\u5916\uff0c\u53ea\u6709\u5728\u6444\u50cf\u673a\u79fb\u52a8\u6216\u65cb\u8f6c\u540e\uff0c\u624d\u9700\u8981\u8fdb\u884c\u8ba1\u7b97\u3002","title":"\u6444\u50cf\u673a\u9009\u53d6"},{"location":"23-3d-object-picking/#_2","text":"\u7528\u6444\u50cf\u673a\u9009\u53d6\u7269\u4f53\u5b8c\u6210\u4e86\uff0c\u4f46\u5f53\u6211\u4eec\u60f3\u7528\u9f20\u6807\u81ea\u7531\u9009\u62e9\u7269\u4f53\u600e\u4e48\u529e\uff1f\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u5e0c\u671b\u6bcf\u5f53\u7528\u6237\u5355\u51fb\u5c4f\u5e55\u65f6\uff0c\u81ea\u52a8\u9009\u62e9\u6700\u8fd1\u7684\u5bf9\u8c61\u3002 \u5b9e\u73b0\u5b83\u7684\u65b9\u6cd5\u7c7b\u4f3c\u4e8e\u4e0a\u8ff0\u65b9\u6cd5\u3002\u5728\u4e4b\u524d\u7684\u65b9\u6cd5\u4e2d\uff0c\u6211\u4eec\u5f97\u5230\u4e86\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\uff0c\u5e76\u6839\u636e\u6444\u50cf\u673a\u5f53\u524d\u7684\u65b9\u5411\u4f7f\u7528\u201c\u524d\u5411\u201d\u65b9\u5411\u4ece\u6444\u50cf\u673a\u751f\u6210\u5c04\u7ebf\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u4ecd\u9700\u8981\u6295\u5c04\u5e7f\u897f\uff0c\u4f46\u65b9\u5411\u6307\u5411\u4e00\u4e2a\u8fdc\u79bb\u6444\u50cf\u673a\u7684\u70b9\uff0c\u4e5f\u5c31\u662f\u70b9\u51fb\u7684\u70b9\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f7f\u7528\u70b9\u51fb\u7684\u5750\u6807\u6765\u8ba1\u7b97\u65b9\u5411\u5411\u91cf\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u5c06\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u7a7a\u95f4\u5462\uff1f\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u5982\u4f55\u4ece\u6a21\u578b\u7a7a\u95f4\u5750\u6807\u53d8\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u4e3a\u4e86\u8fbe\u5230\u8fd9\u4e2a\u76ee\u7684\uff0c\u6240\u5e94\u7528\u7684\u4e0d\u540c\u5750\u6807\u53d8\u6362\u662f\uff1a \u6211\u4eec\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u5c06\u6a21\u578b\u5750\u6807\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u3002 \u6211\u4eec\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff08\u63d0\u4f9b\u6444\u50cf\u673a\u529f\u80fd\uff09\u5c06\u4e16\u754c\u5750\u6807\u8f6c\u6362\u5230\u89c2\u5bdf\u7a7a\u95f4\u5750\u6807\u3002 \u6211\u4eec\u901a\u8fc7\u5e94\u7528\u900f\u89c6\u6295\u5f71\u77e9\u9635\u5c06\u89c2\u5bdf\u5750\u6807\u53d8\u6362\u5230\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\uff08Homogeneous Clip Space\uff09\u3002 \u6700\u7ec8\u7684\u5c4f\u5e55\u5750\u6807\u7531OpenGL\u4e3a\u6211\u4eec\u81ea\u52a8\u8ba1\u7b97\u3002\u5728\u6b64\u4e4b\u524d\uff0c\u5b83\u4f20\u9012\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\uff08\u901a\u8fc7\u5c06 x,y,z \u5750\u6807\u9664\u4ee5 w \u5206\u91cf\uff09\uff0c\u7136\u540e\u4f20\u9012\u5230 x,y \u5c4f\u5e55\u5750\u6807\u3002 \u6240\u4ee5\u6211\u4eec\u53ea\u9700\u8981\u4ece\u5c4f\u5e55\u5750\u6807 (x,y) \u5230\u4e16\u754c\u5750\u6807\uff0c\u9006\u8def\u5f84\u904d\u5386\u3002 \u7b2c\u4e00\u6b65\u662f\u5c06\u5c4f\u5e55\u5750\u6807\u8f6c\u6362\u4e3a\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u7a7a\u95f4\u3002\u89c6\u53e3\u7a7a\u95f4\u4e2d\u7684 (x,y) \u5750\u6807\u7684\u8303\u56f4\u662f [0, \u5c4f\u5e55\u5bbd\u5ea6] [0, \u5c4f\u5e55\u9ad8\u5ea6] \u3002\u5c4f\u5e55\u5de6\u4e0a\u89d2\u7684\u5750\u6807\u4e3a (0, 0) \u3002\u6211\u4eec\u9700\u8981\u5c06\u5176\u8f6c\u6362\u4e3a [-1, 1] \u8303\u56f4\u5185\u7684\u5750\u6807\u3002 \u5f88\u7b80\u5355\u7684\u6570\u5b66\uff1a x = 2 \\cdot screen_x / screenwidth - 1 y = 1 - 2 * screen_y / screenheight \u4f46\u662f\uff0c\u6211\u4eec\u5982\u4f55\u8ba1\u7b97 z \u5206\u91cf\u5462\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u7ed9\u5b83\u5206\u914d -1 \u503c\uff0c\u8fd9\u6837\u5e7f\u897f\u5c31\u53ef\u4ee5\u6307\u5411\u6700\u8fdc\u7684\u53ef\u89c1\u8ddd\u79bb\uff08\u8bf7\u8bb0\u4f4f\uff0c\u5728OpenGL\u4e2d\uff0c -1 \u6307\u5411\u9891\u5e55\uff09\u3002\u73b0\u5728\u6211\u4eec\u6709\u4e86\u5f52\u4e00\u5316\u7ec8\u7aef\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\u3002 \u4e3a\u4e86\u7ee7\u7eed\u53d8\u6362\uff0c\u6211\u4eec\u9700\u8981\u5c06\u5b83\u4eec\u8f6c\u6362\u4e3a\u9f50\u6b21\u526a\u5207\u7a7a\u95f4\u3002\u6211\u4eec\u9700\u8981\u6709\u4e00\u4e2a w \u5206\u91cf\uff0c\u5b83\u4f7f\u7528\u9f50\u6b21\u5750\u6807\u3002\u867d\u7136\u8fd9\u4e2a\u6982\u5ff5\u5728\u524d\u51e0\u7ae0\u5df2\u7ecf\u4ecb\u7ecd\u8fc7\u4e86\uff0c\u4f46\u8ba9\u6211\u4eec\u518d\u56de\u987e\u5b83\u3002\u4e3a\u4e86\u8868\u793a\u4e00\u4e2a\u4e09\u7ef4\u70b9\uff0c\u6211\u4eec\u9700\u8981 x \uff0c y \u548c z \u5206\u91cf\uff0c\u4f46\u662f\u6211\u4eec\u4e00\u76f4\u5728\u5904\u7406\u4e00\u4e2a\u989d\u5916\u7684 w \u5206\u91cf\u3002\u6211\u4eec\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\u6765\u4f7f\u7528\u77e9\u9635\u6267\u884c\u4e0d\u540c\u7684\u53d8\u6362\u3002\u6709\u4e9b\u53d8\u5316\u4e0d\u9700\u8981\u8fd9\u4e2a\u989d\u5916\u7684\u5206\u91cf\uff0c\u4f46\u6709\u4e9b\u53d8\u6362\u9700\u8981\u3002\u4f8b\u5982\uff0c\u5982\u679c\u6211\u4eec\u53ea\u6709 x \uff0c y \u548c z \u5206\u91cf\uff0c\u90a3\u4e48\u53d8\u6362\u77e9\u9635\u5c31\u4e0d\u80fd\u5de5\u4f5c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u6dfb\u52a0\u4e86 w \u5206\u91cf\uff0c\u5e76\u4e3a\u5b83\u4eec\u8d4b\u503c\u4e3a 1 \uff0c\u8fd9\u6837\u6211\u4eec\u5c31\u53ef\u4ee5\u5904\u74064x4\u77e9\u9635\u4e86\u3002 \u6b64\u5916\uff0c\u5927\u591a\u6570\u53d8\u6362\uff0c\u6216\u8005\u66f4\u7cbe\u786e\u5730\u8bf4\uff0c\u5927\u591a\u6570\u53d8\u6362\u77e9\u9635\u90fd\u4e0d\u4f1a\u66f4\u6539 w \u5206\u91cf\u3002\u6295\u5f71\u77e9\u9635\u662f\u4e00\u4e2a\u4f8b\u5916\uff0c\u8be5\u77e9\u9635\u5c06 w \u5206\u91cf\u66f4\u6539\u4e3a\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\u3002 \u901a\u8fc7\u5c06 x \uff0c y \u548c z \u5206\u91cf\u5904\u4ee5 w \uff0c\u5c31\u53ef\u4ee5\u5b9e\u73b0\u4ece\u9f50\u6b21\u88c1\u526a\u7a7a\u95f4\u5230\u5f52\u4e00\u5316\u7684\u7ec8\u7aef\u5750\u6807\u7684\u8f6c\u6362\u3002\u7531\u4e8e\u8fd9\u4e2a\u5206\u91cf\u4e0e z \u5206\u91cf\u6210\u6bd4\u4f8b\uff0c\u610f\u5473\u7740\u8fdc\u5904\u7684\u7269\u4f53\u88ab\u753b\u5f97\u66f4\u5c0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u9700\u8981\u53cd\u5176\u9053\u800c\u884c\u4e4b\uff0c\u6211\u4eec\u53ef\u4ee5\u5ffd\u7565\u8fd9\u4e00\u6b65\uff0c\u53ea\u9700\u8981\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 1 \uff0c\u5e76\u4fdd\u7559\u5176\u5b83\u7ec4\u4ef6\u7684\u539f\u59cb\u503c\u3002 \u6211\u4eec\u73b0\u5728\u9700\u8981\u56de\u5230\u89c2\u5bdf\u7a7a\u95f4\u3002\u8fd9\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8ba1\u7b97\u6295\u5f71\u77e9\u9635\u7684\u9006\u77e9\u9635\u5e76\u5c06\u5b83\u4e0e4\u4e2a\u5206\u91cf\u5411\u91cf\u76f8\u4e58\u3002\u5b8c\u6210\u4e4b\u540e\uff0c\u6211\u4eec\u5c31\u9700\u8981\u628a\u5b83\u4eec\u8f6c\u6362\u6210\u4e16\u754c\u7a7a\u95f4\u3002\u540c\u6837\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u8ba1\u7b97\u5b83\u7684\u9006\u77e9\u9635\u7136\u540e\u4e58\u4ee5\u5411\u91cf\u3002 \u8bb0\u4f4f\uff0c\u6211\u4eec\u53ea\u5bf9\u65b9\u5411\u611f\u5174\u8da3\uff0c\u56e0\u6b64\uff0c\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06 w \u5206\u91cf\u8bbe\u7f6e\u4e3a 0 \u3002\u6211\u4eec\u8fd8\u53ef\u4ee5\u5c06 z \u7ec4\u4ef6\u518d\u6b21\u8bbe\u7f6e\u4e3a -1 \uff0c\u56e0\u4e3a\u6211\u4eec\u5e0c\u671b\u5b83\u6307\u5411\u9891\u5e55\u3002\u4e00\u65e6\u8fd9\u6837\u505a\u5e76\u5e94\u7528\u9006\u77e9\u9635\uff0c\u6211\u4eec\u5c31\u5f97\u5230\u4e86\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u5411\u91cf\u3002\u6211\u4eec\u8ba1\u7b97\u4e86\u5c04\u7ebf\uff0c\u53ef\u4ee5\u4f7f\u7528\u4e0e\u6444\u50cf\u673a\u9009\u53d6\u76f8\u540c\u7684\u7b97\u6cd5\u3002 \u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a MouseBoxSelectionDetector \u7684\u65b0\u7c7b\uff0c\u5b83\u5b9e\u73b0\u4e86\u4e0a\u8ff0\u6b65\u9aa4\u3002\u6b64\u5916\uff0c\u6211\u4eec\u5c06\u6295\u5f71\u77e9\u9635\u79fb\u52a8\u5230 Window \u7c7b\uff0c\u6240\u4ee5\u6211\u4eec\u53ef\u4ee5\u5728\u51e0\u4e2a\u5730\u65b9\u4f7f\u7528\u5b83\u4eec\u3002\u6211\u4eec\u8fd8\u91cd\u6784\u4e86\u4e00\u70b9 CameraBoxSelectionDetector \uff0c\u6240\u4ee5 MouseBoxSelectionDetector \u53ef\u4ee5\u7ee7\u627f\u548c\u4f7f\u7528\u78b0\u649e\u68c0\u6d4b\u65b9\u6cd5\u3002\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u5b9e\u73b0\u975e\u5e38\u7b80\u5355\u3002 \u7ed3\u679c\u5982\u4e0b\u6240\u793a\uff1a \u4f60\u53ea\u9700\u7528\u9f20\u6807\u5355\u51fb\u8be5\u65b9\u5757\u5373\u53ef\u8fdb\u884c\u9009\u53d6\u3002 \u4e4b\u540e\u4f60\u53ef\u4ee5\u53c2\u8003\u4e00\u7bc7 \u4f18\u79c0\u6587\u7ae0 \u4e2d\u80cc\u5b8c\u6240\u89e3\u91ca\u7684\u6b65\u9aa4\u7684\u7ec6\u8282\uff0c\u5176\u4e2d\u5305\u542b\u4e86\u6d89\u53ca\u4e0d\u540c\u65b9\u6848\u7684\u975e\u5e38\u8be6\u7ec6\u7684\u8bf4\u660e\u3002","title":"\u9f20\u6807\u9009\u53d6"},{"location":"24-hud-revisited/","text":"\u56de\u987eHUD - NanoVG\uff08HUD Revisited - NanoVG\uff09 \u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u8bb2\u89e3\u4e86\u5982\u4f55\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u5728\u573a\u666f\u9876\u90e8\u521b\u5efa\u4e00\u4e2aHUD\u4ee5\u6e32\u67d3\u56fe\u5f62\u548c\u7eb9\u7406\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 NanoVG \u5e93\u6765\u6e32\u67d3\u6297\u952f\u9f7f\u77e2\u91cf\u56fe\u5f62\uff0c\u4ece\u800c\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u521b\u5efa\u66f4\u590d\u6742\u7684HUD\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528\u8bb8\u591a\u5176\u4ed6\u5e93\u6765\u5b8c\u6210\u6b64\u4e8b\uff0c\u4f8b\u5982 Nifty GUI \uff0c Nuklear \u7b49\u3002\u5728\u672c\u7ae0\u662f\uff0c\u6211\u4eec\u5c06\u91cd\u70b9\u4ecb\u7ecdNanoVG\uff0c\u56e0\u4e3a\u5b83\u4f7f\u7528\u8d77\u6765\u975e\u5e38\u7b80\u5355\uff0c\u4f46\u662f\u5982\u679c\u4f60\u5e0c\u671b\u5f00\u53d1\u53ef\u4e0e\u6309\u94ae\u3001\u83dc\u5355\u548c\u7a97\u53e3\u4ea4\u4e92\u7684\u590d\u6742GUI\uff0c\u90a3\u4f60\u53ef\u80fd\u9700\u8981\u7684\u662f Nifty GUI \u3002 \u4f7f\u7528 NanoVG \u9996\u5148\u662f\u8981\u5728 pom.xml \u6587\u4ef6\u4e2d\u6dfb\u52a0\u4f9d\u8d56\u9879\uff08\u4e00\u4e2a\u662f\u7528\u4e8e\u7f16\u8bd1\u65f6\u6240\u9700\u7684\u4f9d\u8d56\u9879\uff0c\u53e6\u4e00\u4e2a\u662f\u7528\u4e8e\u8fd0\u884c\u65f6\u6240\u9700\u7684\u672c\u5730\u4ee3\u7801\uff09\uff1a ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> </dependency> ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u5f00\u59cb\u4f7f\u7528 NanoVG \u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u5728OpenGL\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u4ee5\u4fbf\u793a\u4f8b\u80fd\u591f\u6b63\u5e38\u5de5\u4f5c\u3002\u6211\u4eec\u9700\u8981\u542f\u7528\u5bf9\u6a21\u677f\u6d4b\u8bd5\uff08Stencil Test\uff09\u7684\u652f\u6301\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u8bb2\u89e3\u4e86\u989c\u8272\u548c\u6df1\u5ea6\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u63d0\u5230\u6a21\u677f\u7f13\u51b2\u533a\u3002\u8be5\u7f13\u51b2\u533a\u4e3a\u7528\u4e8e\u63a7\u5236\u5e94\u7ed8\u5236\u54ea\u4e9b\u50cf\u7d20\u7684\u6bcf\u4e2a\u50cf\u7d20\u50a8\u5b58\u4e00\u4e2a\u503c\uff08\u6574\u6570\uff09\uff0c\u7528\u4e8e\u6839\u636e\u50a8\u5b58\u7684\u503c\u4ee5\u5c4f\u853d\u6216\u653e\u5f03\u7ed8\u56fe\u533a\u57df\u3002\u4f8b\u5982\uff0c\u5b83\u53ef\u4ee5\u7528\u6765\u4ee5\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u5f0f\u5207\u5272\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u6b64\u884c\u6dfb\u52a0\u5230 Window \u7c7b\u4e2d\u6765\u542f\u7528\u6a21\u677f\u6d4b\u8bd5\uff08\u5728\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4e4b\u540e\uff09\uff1a glEnable(GL_STENCIL_TEST); \u56e0\u4e3a\u6211\u4eec\u4f7f\u7528\u7684\u662f\u53e6\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u6240\u4ee5\u5728\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u6ce8\u610f\u5220\u9664\u5b83\u7684\u503c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u7684 clear \u65b9\u6cd5\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT); } \u6211\u4eec\u8fd8\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u7a97\u53e3\u9009\u9879\u6765\u6fc0\u6d3b\u6297\u952f\u9f7f\uff08Anti-aliasing\uff09\u3002\u56e0\u6b64\uff0c\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u542f\u7528\u5b83\uff1a if (opts.antialiasing) { glfwWindowHint(GLFW_SAMPLES, 4); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 NanoVG \u5e93\u4e86\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5220\u6389\u6211\u4eec\u521b\u5efa\u7684HUD\u4ee3\u7801\uff0c\u5373\u7740\u8272\u5668\uff0c IHud \u63a5\u53e3\uff0c Renderer \u7c7b\u4e2d\u7684HUD\u6e32\u67d3\u65b9\u6cd5\u7b49\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u65b0\u7684 Hud \u7c7b\u5c06\u8d1f\u8d23\u5176\u6e32\u67d3\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u9700\u8981\u5c06\u5176\u59d4\u6258\u7ed9 Renderer \u7c7b\u3002\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u8fd9\u4e2a\u7c7b\uff0c\u5b83\u5c06\u6709\u4e00\u4e2a init \u65b9\u6cd5\u6765\u8bbe\u7f6e\u5e93\u548c\u6784\u5efaHUD\u6240\u9700\u8981\u7684\u8d44\u6e90\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void init(Window window) throws Exception { this.vg = window.getOptions().antialiasing ? nvgCreate(NVG_ANTIALIAS | NVG_STENCIL_STROKES) : nvgCreate(NVG_STENCIL_STROKES); if (this.vg == NULL) { throw new Exception(\"Could not init nanovg\"); } fontBuffer = Utils.ioResourceToByteBuffer(\"/fonts/OpenSans-Bold.ttf\", 150 * 1024); int font = nvgCreateFontMem(vg, FONT_NAME, fontBuffer, 0); if (font == -1) { throw new Exception(\"Could not add font\"); } colour = NVGColor.create(); posx = MemoryUtil.memAllocDouble(1); posy = MemoryUtil.memAllocDouble(1); counter = 0; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2aNanoVG\u4e0a\u4e0b\u6587\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL3.0\u540e\u7aef\uff0c\u56e0\u6b64\u6211\u4eec\u5f15\u7528\u7684\u662f org.lwjgl.nanovg.NanoVGGL3 \u547d\u540d\u7a7a\u95f4\u3002\u5982\u679c\u6297\u952f\u9f7f\u88ab\u542f\u7528\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e NVG_ANTIALIAS \u6807\u5fd7\u3002 \u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u4f7f\u7528\u6b64\u524d\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\u7684TrueType\u5b57\u4f53\u6765\u521b\u5efa\u5b57\u4f53\u3002\u6211\u4eec\u4e3a\u5b83\u6307\u5b9a\u4e00\u4e2a\u540d\u8bcd\uff0c\u4ee5\u4fbf\u7a0d\u540e\u5728\u6e32\u67d3\u6587\u672c\u65f6\u4f7f\u7528\u5b83\u3002\u5173\u4e8e\u8fd9\u70b9\uff0c\u4e00\u4ef6\u5f88\u91cd\u8981\u7684\u4e8b\u60c5\u662f\u7528\u4e8e\u52a0\u8f7d\u5b57\u4f53\u7684 ByteBuffer \u5fc5\u987b\u5728\u4f7f\u7528\u5b57\u4f53\u65f6\u50a8\u5b58\u5728\u5185\u5b58\u4e2d\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u4e0d\u80fd\u88ab\u56de\u6536\uff0c\u5426\u5219\u4f60\u5c06\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u6838\u5fc3\u5d29\u6e83\u3002\u8fd9\u5c31\u662f\u5c06\u5b83\u50a8\u5b58\u4e3a\u7c7b\u5c5e\u6027\u7684\u539f\u56e0\u3002 \u7136\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e00\u4e2a\u989c\u8272\u5b9e\u4f8b\u548c\u4e00\u4e9b\u6709\u7528\u7684\u53d8\u91cf\uff0c\u8fd9\u4e9b\u53d8\u91cf\u5c06\u5728\u6e32\u67d3\u65f6\u4f7f\u7528\u3002\u5728\u521d\u59cb\u5316\u6e32\u67d3\u4e4b\u524d\uff0c\u5728\u6e38\u620f\u521d\u59cb\u5316\u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a @Override public void init(Window window) throws Exception { hud.init(window); renderer.init(window); ... Hud \u7c7b\u8fd8\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5e94\u5728\u6e32\u67d3\u573a\u666f\u540e\u8c03\u7528\uff0c\u4ee5\u4fbf\u5728\u5176\u4e0a\u7ed8\u5236Hud\u3002 @Override public void render(Window window) { renderer.render(window, camera, scene); hud.render(window); } Hud\u7c7b\u7684 render \u65b9\u6cd5\u7684\u5f00\u5934\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window) { nvgBeginFrame(vg, window.getWidth(), window.getHeight(), 1); \u9996\u5148\u5fc5\u987b\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 nvgBeginFrame \u65b9\u6cd5\u3002\u6240\u6709NanoVG\u6e32\u67d3\u64cd\u4f5c\u90fd\u5fc5\u987b\u4fdd\u62a4\u5728 nvgBeginFrame \u548c nvgEndFrame \u8c03\u7528\u4e4b\u95f4\u3002 nvgBeginFrame \u63a5\u53d7\u4ee5\u4e0b\u53c2\u6570\uff1a NanoVG\u73af\u5883 \u8981\u6e32\u67d3\u7684\u7a97\u53e3\u7684\u5927\u5c0f\uff08\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff09\u3002 \u50cf\u7d20\u6bd4\u3002\u5982\u679c\u9700\u8981\u652f\u6301Hi-DPI\uff0c\u53ef\u4ee5\u4fee\u6539\u6b64\u503c\u3002\u5bf9\u4e8e\u672c\u4f8b\uff0c\u6211\u4eec\u53ea\u5c06\u5176\u8bbe\u7f6e\u4e3a1\u3002 \u7136\u540e\u6211\u4eec\u521b\u5efa\u4e86\u51e0\u4e2a\u5360\u636e\u6574\u4e2a\u5c4f\u5e55\u7684\u8272\u5e26\u3002\u7b2c\u4e00\u6761\u662f\u8fd9\u6837\u7ed8\u5236\u7684\uff1a // \u4e0a\u8272\u5e26 nvgBeginPath(vg); nvgRect(vg, 0, window.getHeight() - 100, window.getWidth(), 50); nvgFillColor(vg, rgba(0x23, 0xa1, 0xf1, 200, colour)); nvgFill(vg); \u6e32\u67d3\u56fe\u5f62\u65f6\uff0c\u5e94\u8c03\u7528\u7684\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f nvgBeginPath \uff0c\u5b83\u6307\u793aNanoVG\u5f00\u59cb\u7ed8\u5236\u65b0\u56fe\u5f62\u3002\u7136\u540e\u5b9a\u4e49\u8981\u7ed8\u5236\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u77e9\u5f62\uff0c\u586b\u5145\u989c\u8272\u5e76\u901a\u8fc7\u8c03\u7528 nvgFill \u7ed8\u5236\u5b83\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u7684\u5176\u4ed6\u90e8\u5206\uff0c\u4ee5\u4e86\u89e3\u5176\u4f59\u56fe\u5f62\u662f\u5982\u4f55\u7ed8\u5236\u7684\u3002\u5f53\u6e32\u67d3\u6587\u672c\u662f\uff0c\u4e0d\u9700\u8981\u5728\u6e32\u67d3\u524d\u8c03\u7528 nvgBeginPath \u3002 \u5b8c\u6210\u6240\u6709\u56fe\u5f62\u7684\u7ed8\u5236\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8c03\u7528 nvgEndFrame \u6765\u7ed3\u675f\u6e32\u67d3\uff0c\u4f46\u5728\u79bb\u5f00\u65b9\u6cd5\u4e4b\u524d\u8fd8\u6709\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u60c5\u8981\u505a\u3002\u6211\u4eec\u5fc5\u987b\u6062\u590dOpenGL\u72b6\u6001\uff0cNanoVG\u4fee\u6539OpenGL\u4ee5\u6267\u884c\u5176\u64cd\u4f5c\uff0c\u5982\u679c\u72b6\u6001\u672a\u6b63\u786e\u8fd8\u539f\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u573a\u666f\u6ca1\u6709\u6b63\u786e\u6e32\u67d3\uff0c\u751a\u81f3\u88ab\u64e6\u9664\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6062\u590d\u6e32\u67d3\u6240\u9700\u7684\u76f8\u5173OpenGL\u72b6\u6001\u3002\u8fd9\u662f\u59d4\u6d3e\u5230 Window \u7c7b\u4e2d\u7684\uff1a // \u8fd8\u539f\u72b6\u6001 window.restoreState(); \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void restoreState() { glEnable(GL_DEPTH_TEST); glEnable(GL_STENCIL_TEST); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); if (opts.cullFace) { glEnable(GL_CULL_FACE); glCullFace(GL_BACK); } } \u8fd9\u5c31\u5b8c\u4e8b\u4e86\uff08\u9664\u4e86\u4e00\u4e9b\u5176\u5b83\u7684\u6e05\u7406\u65b9\u6cd5\uff09\uff0c\u4ee3\u7801\u5b8c\u6210\u4e86\u3002\u5f53\u4f60\u8fd0\u884c\u793a\u4f8b\u65f6\uff0c\u4f60\u5c06\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a","title":"\u56de\u987eHUD - NanoVG"},{"location":"24-hud-revisited/#hud-nanovghud-revisited-nanovg","text":"\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u8bb2\u89e3\u4e86\u5982\u4f55\u4f7f\u7528\u6b63\u4ea4\u6295\u5f71\u5728\u573a\u666f\u9876\u90e8\u521b\u5efa\u4e00\u4e2aHUD\u4ee5\u6e32\u67d3\u56fe\u5f62\u548c\u7eb9\u7406\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 NanoVG \u5e93\u6765\u6e32\u67d3\u6297\u952f\u9f7f\u77e2\u91cf\u56fe\u5f62\uff0c\u4ece\u800c\u4ee5\u7b80\u5355\u7684\u65b9\u5f0f\u521b\u5efa\u66f4\u590d\u6742\u7684HUD\u3002 \u4f60\u53ef\u4ee5\u4f7f\u7528\u8bb8\u591a\u5176\u4ed6\u5e93\u6765\u5b8c\u6210\u6b64\u4e8b\uff0c\u4f8b\u5982 Nifty GUI \uff0c Nuklear \u7b49\u3002\u5728\u672c\u7ae0\u662f\uff0c\u6211\u4eec\u5c06\u91cd\u70b9\u4ecb\u7ecdNanoVG\uff0c\u56e0\u4e3a\u5b83\u4f7f\u7528\u8d77\u6765\u975e\u5e38\u7b80\u5355\uff0c\u4f46\u662f\u5982\u679c\u4f60\u5e0c\u671b\u5f00\u53d1\u53ef\u4e0e\u6309\u94ae\u3001\u83dc\u5355\u548c\u7a97\u53e3\u4ea4\u4e92\u7684\u590d\u6742GUI\uff0c\u90a3\u4f60\u53ef\u80fd\u9700\u8981\u7684\u662f Nifty GUI \u3002 \u4f7f\u7528 NanoVG \u9996\u5148\u662f\u8981\u5728 pom.xml \u6587\u4ef6\u4e2d\u6dfb\u52a0\u4f9d\u8d56\u9879\uff08\u4e00\u4e2a\u662f\u7528\u4e8e\u7f16\u8bd1\u65f6\u6240\u9700\u7684\u4f9d\u8d56\u9879\uff0c\u53e6\u4e00\u4e2a\u662f\u7528\u4e8e\u8fd0\u884c\u65f6\u6240\u9700\u7684\u672c\u5730\u4ee3\u7801\uff09\uff1a ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> </dependency> ... <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-nanovg</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u5728\u5f00\u59cb\u4f7f\u7528 NanoVG \u4e4b\u524d\uff0c\u6211\u4eec\u5fc5\u987b\u5728OpenGL\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u4ee5\u4fbf\u793a\u4f8b\u80fd\u591f\u6b63\u5e38\u5de5\u4f5c\u3002\u6211\u4eec\u9700\u8981\u542f\u7528\u5bf9\u6a21\u677f\u6d4b\u8bd5\uff08Stencil Test\uff09\u7684\u652f\u6301\u3002\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u5df2\u7ecf\u8bb2\u89e3\u4e86\u989c\u8272\u548c\u6df1\u5ea6\u7f13\u51b2\u533a\uff0c\u4f46\u6211\u4eec\u6ca1\u6709\u63d0\u5230\u6a21\u677f\u7f13\u51b2\u533a\u3002\u8be5\u7f13\u51b2\u533a\u4e3a\u7528\u4e8e\u63a7\u5236\u5e94\u7ed8\u5236\u54ea\u4e9b\u50cf\u7d20\u7684\u6bcf\u4e2a\u50cf\u7d20\u50a8\u5b58\u4e00\u4e2a\u503c\uff08\u6574\u6570\uff09\uff0c\u7528\u4e8e\u6839\u636e\u50a8\u5b58\u7684\u503c\u4ee5\u5c4f\u853d\u6216\u653e\u5f03\u7ed8\u56fe\u533a\u57df\u3002\u4f8b\u5982\uff0c\u5b83\u53ef\u4ee5\u7528\u6765\u4ee5\u4e00\u79cd\u7b80\u5355\u7684\u65b9\u5f0f\u5207\u5272\u573a\u666f\u7684\u67d0\u4e9b\u90e8\u5206\u3002\u6211\u4eec\u901a\u8fc7\u5c06\u6b64\u884c\u6dfb\u52a0\u5230 Window \u7c7b\u4e2d\u6765\u542f\u7528\u6a21\u677f\u6d4b\u8bd5\uff08\u5728\u542f\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4e4b\u540e\uff09\uff1a glEnable(GL_STENCIL_TEST); \u56e0\u4e3a\u6211\u4eec\u4f7f\u7528\u7684\u662f\u53e6\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u6240\u4ee5\u5728\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u4e4b\u524d\uff0c\u6211\u4eec\u8fd8\u5fc5\u987b\u6ce8\u610f\u5220\u9664\u5b83\u7684\u503c\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u4fee\u6539 Renderer \u7c7b\u7684 clear \u65b9\u6cd5\uff1a public void clear() { glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT); } \u6211\u4eec\u8fd8\u5c06\u6dfb\u52a0\u4e00\u4e2a\u65b0\u7684\u7a97\u53e3\u9009\u9879\u6765\u6fc0\u6d3b\u6297\u952f\u9f7f\uff08Anti-aliasing\uff09\u3002\u56e0\u6b64\uff0c\u5728 Window \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u901a\u8fc7\u5982\u4e0b\u65b9\u5f0f\u542f\u7528\u5b83\uff1a if (opts.antialiasing) { glfwWindowHint(GLFW_SAMPLES, 4); } \u73b0\u5728\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 NanoVG \u5e93\u4e86\u3002\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u5c31\u662f\u5220\u6389\u6211\u4eec\u521b\u5efa\u7684HUD\u4ee3\u7801\uff0c\u5373\u7740\u8272\u5668\uff0c IHud \u63a5\u53e3\uff0c Renderer \u7c7b\u4e2d\u7684HUD\u6e32\u67d3\u65b9\u6cd5\u7b49\u3002\u4f60\u53ef\u4ee5\u5728\u6e90\u4ee3\u7801\u4e2d\u67e5\u770b\u3002 \u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u65b0\u7684 Hud \u7c7b\u5c06\u8d1f\u8d23\u5176\u6e32\u67d3\uff0c\u56e0\u6b64\u6211\u4eec\u4e0d\u9700\u8981\u5c06\u5176\u59d4\u6258\u7ed9 Renderer \u7c7b\u3002\u8ba9\u6211\u4eec\u5148\u5b9a\u4e49\u8fd9\u4e2a\u7c7b\uff0c\u5b83\u5c06\u6709\u4e00\u4e2a init \u65b9\u6cd5\u6765\u8bbe\u7f6e\u5e93\u548c\u6784\u5efaHUD\u6240\u9700\u8981\u7684\u8d44\u6e90\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void init(Window window) throws Exception { this.vg = window.getOptions().antialiasing ? nvgCreate(NVG_ANTIALIAS | NVG_STENCIL_STROKES) : nvgCreate(NVG_STENCIL_STROKES); if (this.vg == NULL) { throw new Exception(\"Could not init nanovg\"); } fontBuffer = Utils.ioResourceToByteBuffer(\"/fonts/OpenSans-Bold.ttf\", 150 * 1024); int font = nvgCreateFontMem(vg, FONT_NAME, fontBuffer, 0); if (font == -1) { throw new Exception(\"Could not add font\"); } colour = NVGColor.create(); posx = MemoryUtil.memAllocDouble(1); posy = MemoryUtil.memAllocDouble(1); counter = 0; } \u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u662f\u521b\u5efa\u4e00\u4e2aNanoVG\u4e0a\u4e0b\u6587\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u7684\u662fOpenGL3.0\u540e\u7aef\uff0c\u56e0\u6b64\u6211\u4eec\u5f15\u7528\u7684\u662f org.lwjgl.nanovg.NanoVGGL3 \u547d\u540d\u7a7a\u95f4\u3002\u5982\u679c\u6297\u952f\u9f7f\u88ab\u542f\u7528\uff0c\u6211\u4eec\u5c06\u8bbe\u7f6e NVG_ANTIALIAS \u6807\u5fd7\u3002 \u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u4f7f\u7528\u6b64\u524d\u52a0\u8f7d\u5230 ByteBuffer \u4e2d\u7684TrueType\u5b57\u4f53\u6765\u521b\u5efa\u5b57\u4f53\u3002\u6211\u4eec\u4e3a\u5b83\u6307\u5b9a\u4e00\u4e2a\u540d\u8bcd\uff0c\u4ee5\u4fbf\u7a0d\u540e\u5728\u6e32\u67d3\u6587\u672c\u65f6\u4f7f\u7528\u5b83\u3002\u5173\u4e8e\u8fd9\u70b9\uff0c\u4e00\u4ef6\u5f88\u91cd\u8981\u7684\u4e8b\u60c5\u662f\u7528\u4e8e\u52a0\u8f7d\u5b57\u4f53\u7684 ByteBuffer \u5fc5\u987b\u5728\u4f7f\u7528\u5b57\u4f53\u65f6\u50a8\u5b58\u5728\u5185\u5b58\u4e2d\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b83\u4e0d\u80fd\u88ab\u56de\u6536\uff0c\u5426\u5219\u4f60\u5c06\u5f97\u5230\u4e00\u4e2a\u4e0d\u9519\u7684\u6838\u5fc3\u5d29\u6e83\u3002\u8fd9\u5c31\u662f\u5c06\u5b83\u50a8\u5b58\u4e3a\u7c7b\u5c5e\u6027\u7684\u539f\u56e0\u3002 \u7136\u540e\uff0c\u6211\u4eec\u521b\u5efa\u4e00\u4e2a\u989c\u8272\u5b9e\u4f8b\u548c\u4e00\u4e9b\u6709\u7528\u7684\u53d8\u91cf\uff0c\u8fd9\u4e9b\u53d8\u91cf\u5c06\u5728\u6e32\u67d3\u65f6\u4f7f\u7528\u3002\u5728\u521d\u59cb\u5316\u6e32\u67d3\u4e4b\u524d\uff0c\u5728\u6e38\u620f\u521d\u59cb\u5316\u65b9\u6cd5\u4e2d\u8c03\u7528\u8be5\u65b9\u6cd5\uff1a @Override public void init(Window window) throws Exception { hud.init(window); renderer.init(window); ... Hud \u7c7b\u8fd8\u5b9a\u4e49\u4e86\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u5e94\u5728\u6e32\u67d3\u573a\u666f\u540e\u8c03\u7528\uff0c\u4ee5\u4fbf\u5728\u5176\u4e0a\u7ed8\u5236Hud\u3002 @Override public void render(Window window) { renderer.render(window, camera, scene); hud.render(window); } Hud\u7c7b\u7684 render \u65b9\u6cd5\u7684\u5f00\u5934\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window) { nvgBeginFrame(vg, window.getWidth(), window.getHeight(), 1); \u9996\u5148\u5fc5\u987b\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 nvgBeginFrame \u65b9\u6cd5\u3002\u6240\u6709NanoVG\u6e32\u67d3\u64cd\u4f5c\u90fd\u5fc5\u987b\u4fdd\u62a4\u5728 nvgBeginFrame \u548c nvgEndFrame \u8c03\u7528\u4e4b\u95f4\u3002 nvgBeginFrame \u63a5\u53d7\u4ee5\u4e0b\u53c2\u6570\uff1a NanoVG\u73af\u5883 \u8981\u6e32\u67d3\u7684\u7a97\u53e3\u7684\u5927\u5c0f\uff08\u5bbd\u5ea6\u548c\u9ad8\u5ea6\uff09\u3002 \u50cf\u7d20\u6bd4\u3002\u5982\u679c\u9700\u8981\u652f\u6301Hi-DPI\uff0c\u53ef\u4ee5\u4fee\u6539\u6b64\u503c\u3002\u5bf9\u4e8e\u672c\u4f8b\uff0c\u6211\u4eec\u53ea\u5c06\u5176\u8bbe\u7f6e\u4e3a1\u3002 \u7136\u540e\u6211\u4eec\u521b\u5efa\u4e86\u51e0\u4e2a\u5360\u636e\u6574\u4e2a\u5c4f\u5e55\u7684\u8272\u5e26\u3002\u7b2c\u4e00\u6761\u662f\u8fd9\u6837\u7ed8\u5236\u7684\uff1a // \u4e0a\u8272\u5e26 nvgBeginPath(vg); nvgRect(vg, 0, window.getHeight() - 100, window.getWidth(), 50); nvgFillColor(vg, rgba(0x23, 0xa1, 0xf1, 200, colour)); nvgFill(vg); \u6e32\u67d3\u56fe\u5f62\u65f6\uff0c\u5e94\u8c03\u7528\u7684\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u662f nvgBeginPath \uff0c\u5b83\u6307\u793aNanoVG\u5f00\u59cb\u7ed8\u5236\u65b0\u56fe\u5f62\u3002\u7136\u540e\u5b9a\u4e49\u8981\u7ed8\u5236\u7684\u5185\u5bb9\uff0c\u4e00\u4e2a\u77e9\u5f62\uff0c\u586b\u5145\u989c\u8272\u5e76\u901a\u8fc7\u8c03\u7528 nvgFill \u7ed8\u5236\u5b83\u3002 \u4f60\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u7684\u5176\u4ed6\u90e8\u5206\uff0c\u4ee5\u4e86\u89e3\u5176\u4f59\u56fe\u5f62\u662f\u5982\u4f55\u7ed8\u5236\u7684\u3002\u5f53\u6e32\u67d3\u6587\u672c\u662f\uff0c\u4e0d\u9700\u8981\u5728\u6e32\u67d3\u524d\u8c03\u7528 nvgBeginPath \u3002 \u5b8c\u6210\u6240\u6709\u56fe\u5f62\u7684\u7ed8\u5236\u540e\uff0c\u6211\u4eec\u53ea\u9700\u8981\u8c03\u7528 nvgEndFrame \u6765\u7ed3\u675f\u6e32\u67d3\uff0c\u4f46\u5728\u79bb\u5f00\u65b9\u6cd5\u4e4b\u524d\u8fd8\u6709\u4e00\u4ef6\u91cd\u8981\u7684\u4e8b\u60c5\u8981\u505a\u3002\u6211\u4eec\u5fc5\u987b\u6062\u590dOpenGL\u72b6\u6001\uff0cNanoVG\u4fee\u6539OpenGL\u4ee5\u6267\u884c\u5176\u64cd\u4f5c\uff0c\u5982\u679c\u72b6\u6001\u672a\u6b63\u786e\u8fd8\u539f\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u573a\u666f\u6ca1\u6709\u6b63\u786e\u6e32\u67d3\uff0c\u751a\u81f3\u88ab\u64e6\u9664\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u6062\u590d\u6e32\u67d3\u6240\u9700\u7684\u76f8\u5173OpenGL\u72b6\u6001\u3002\u8fd9\u662f\u59d4\u6d3e\u5230 Window \u7c7b\u4e2d\u7684\uff1a // \u8fd8\u539f\u72b6\u6001 window.restoreState(); \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void restoreState() { glEnable(GL_DEPTH_TEST); glEnable(GL_STENCIL_TEST); glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA); if (opts.cullFace) { glEnable(GL_CULL_FACE); glCullFace(GL_BACK); } } \u8fd9\u5c31\u5b8c\u4e8b\u4e86\uff08\u9664\u4e86\u4e00\u4e9b\u5176\u5b83\u7684\u6e05\u7406\u65b9\u6cd5\uff09\uff0c\u4ee3\u7801\u5b8c\u6210\u4e86\u3002\u5f53\u4f60\u8fd0\u884c\u793a\u4f8b\u65f6\uff0c\u4f60\u5c06\u5f97\u5230\u5982\u4e0b\u7ed3\u679c\uff1a","title":"\u56de\u987eHUD - NanoVG\uff08HUD Revisited - NanoVG\uff09"},{"location":"25-optimizations-frustum-culling/","text":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\uff08Optimizations - Frustum Culling\uff09 \u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e00 \u73b0\u5728\u6211\u4eec\u4f7f\u7528\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u56fe\u5f62\u6548\u679c\uff0c\u4f8b\u5982\u5149\u7167\u3001\u7c92\u5b50\u7b49\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5b66\u4e60\u4e86\u5982\u4f55\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u51cf\u5c11\u7ed8\u5236\u8bb8\u591a\u76f8\u4f3c\u5bf9\u8c61\u7684\u5f00\u9500\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u6709\u8db3\u591f\u7684\u7a7a\u95f4\u8fdb\u884c\u4e00\u4e9b\u7b80\u5355\u7684\u4f18\u5316\uff0c\u8fd9\u5c06\u589e\u52a0\u53ef\u4ee5\u8fbe\u5230\u7684\u5e27\u7387\uff08FPS\uff09\u3002 \u4f60\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u6211\u4eec\u4f1a\u5728\u6bcf\u4e00\u5e27\u4e2d\u7ed8\u5236\u6574\u4e2a\u6e38\u620f\u9879\u5217\u8868\uff0c\u5373\u4f7f\u5176\u4e2d\u4e00\u4e9b\u9879\u4e0d\u53ef\u89c1\uff08\u56e0\u4e3a\u5b83\u4eec\u5728\u6444\u50cf\u673a\u540e\u9762\u6216\u8ddd\u79bb\u6444\u50cf\u673a\u592a\u8fdc\uff09\u3002\u4f60\u751a\u81f3\u53ef\u80fd\u8ba4\u4e3a\u8fd9\u662f\u7531OpenGL\u81ea\u52a8\u5904\u7406\u7684\uff0c\u8fd9\u5728\u67d0\u79cd\u7a0b\u5ea6\u4e0a\u662f\u6b63\u786e\u7684\u3002OpenGL\u5c06\u653e\u5f03\u4f4d\u4e8e\u53ef\u89c1\u533a\u57df\u4e4b\u5916\u7684\u9876\u70b9\u7684\u6e32\u67d3\uff0c\u8fd9\u79f0\u4f5c\u88c1\u526a\uff08Clipping\uff09\u3002\u88c1\u526a\u7684\u95ee\u9898\u662f\uff0c\u5728\u6267\u884c\u9876\u70b9\u7740\u8272\u4e4b\u540e\uff0c\u6309\u9876\u70b9\u8fdb\u884c\u5904\u7406\u7684\u3002\u56e0\u6b64\uff0c\u5373\u4f7f\u6b64\u64cd\u4f5c\u8282\u7701\u4e86\u8d44\u6e90\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u901a\u8fc7\u4e0d\u5c1d\u8bd5\u6e32\u67d3\u4e0d\u53ef\u89c1\u7684\u5bf9\u8c61\u6765\u63d0\u9ad8\u6548\u7387\u3002\u6211\u4eec\u4e0d\u4f1a\u901a\u8fc7\u5c06\u6570\u636e\u53d1\u9001\u5230GPU\u4ee5\u53ca\u5bf9\u8fd9\u4e9b\u5bf9\u8c61\u7684\u6bcf\u4e2a\u9876\u70b9\u8fdb\u884c\u53d8\u6362\u6765\u6d6a\u8d39\u8d44\u6e90\u3002\u6211\u4eec\u9700\u8981\u79fb\u9664\u4e0d\u5305\u542b\u5728\u89c6\u9525\u4f53\uff08View Frustum\uff09\u4e2d\u7684\u5bf9\u8c61\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u622a\u9525\u5254\u9664\u3002 \u4f46\u662f\uff0c\u9996\u5148\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u4ec0\u4e48\u662f\u89c6\u9525\u4f53\u3002\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u7ed3\u5408\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4ee5\u53ca\u4f7f\u7528\u7684\u6295\u5f71\uff0c\u5305\u542b\u6240\u6709\u53ef\u89c1\u7269\u4f53\u7684\u4f53\u79ef\u3002\u901a\u5e38\uff0c\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u56db\u68f1\u53f0\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u89c6\u9525\u4f53\u7531\u516d\u4e2a\u5e73\u9762\u5b9a\u4e49\uff0c\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u4efb\u4f55\u5185\u5bb9\u90fd\u4e0d\u4f1a\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u622a\u9525\u5254\u9664\u662f\u79fb\u9664\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u5bf9\u8c61\u7684\u8fc7\u7a0b\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8fdb\u884c\u622a\u9525\u5254\u9664\uff0c\u6211\u4eec\u9700\u8981\uff1a \u4f7f\u7528\u89c2\u5bdf\u548c\u6295\u5f71\u77e9\u9635\u4e2d\u5305\u542b\u7684\u6570\u636e\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u3002 \u5bf9\u6bcf\u4e2a\u6e38\u620f\u9879\u68c0\u67e5\u5b83\u662f\u5426\u5305\u542b\u5728\u89c6\u9525\u4f53\u4e2d\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5728\u5927\u5c0f\u622a\u9525\u5e73\u9762\u4e4b\u95f4\u3002\u5e76\u4ece\u6e32\u67d3\u6d41\u7a0b\u4e2d\u5220\u9664\u90a3\u4e9b\u4e0d\u5305\u542b\u5728\u5176\u4e2d\u7684\u3002 \u90a3\u4e48\u8ba9\u6211\u4eec\u4ece\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u5f00\u59cb\u3002\u5e73\u9762\u7531\u5305\u542b\u5728\u5176\u4e2d\u7684\u70b9\u548c\u4e0e\u8be5\u5e73\u9762\u6b63\u4ea4\u7684\u5411\u91cf\u5b9a\u4e49\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5e73\u9762\u65b9\u7a0b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a Ax+By+Cz+D=0 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u89c6\u9525\u4f53\u7684\u516d\u4e2a\u4fa7\u9762\u7684\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u3002\u4e3a\u4e86\u8fbe\u6210\u8fd9\u4e2a\u76ee\u6807\uff0c\u4f60\u57fa\u672c\u4e0a\u6709\u4e24\u4e2a\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u8fdb\u884c\u7e41\u7410\u7684\u8ba1\u7b97\uff0c\u5f97\u5230\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u7684\u6765\u81ea\u4e0a\u8ff0\u65b9\u7a0b\u7684\u56db\u4e2a\u5e38\u6570\uff08A\u3001B\u3001C\u548cD\uff09\u3002\u53e6\u4e00\u4e2a\u9009\u9879\u662f\u8ba9 JOML \u5e93\u4e3a\u4f60\u8ba1\u7b97\u8fd9\u4e2a\u503c\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9009\u62e9\u540e\u4e00\u4e2a\u9009\u9879\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FrustumCullingFilter \u7684\u65b0\u7c7b\uff0c\u8ddf\u5b83\u7684\u540d\u5b57\u76f8\u540c\uff0c\u5b83\u5c06\u6839\u636e\u89c6\u9525\u4f53\u6267\u884c\u7b5b\u9009\u64cd\u4f5c\u3002 public class FrustumCullingFilter { private static final int NUM_PLANES = 6; private final Matrix4f prjViewMatrix; private final Vector4f[] frustumPlanes; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumPlanes = new Vector4f[NUM_PLANES]; for (int i = 0; i < NUM_PLANES; i++) { frustumPlanes[i] = new Vector4f(); } } FrustumCullingFilter \u7c7b\u4e5f\u5c06\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u8ba1\u7b97\u5e73\u9762\u65b9\u7a0b\uff0c\u540d\u4e3a updateFrustum \uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u4e4b\u524d\u8c03\u7528\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u89c2\u5bdf\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u83b7\u53d6\u89c6\u9525\u4f53\u5e73\u9762 for (int i = 0; i < NUM_PLANES; i++) { prjViewMatrix.frustumPlane(i, frustumPlanes[i]); } } \u9996\u5148\uff0c\u6211\u4eec\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u7684\u526f\u672c\uff0c\u5e76\u5c06\u5176\u4e0e\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\uff0c\u5f97\u5230\u6295\u5f71\u89c2\u5bdf\u77e9\u9635\u3002\u7136\u540e\uff0c\u4f7f\u7528\u8fd9\u4e2a\u53d8\u6362\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u622a\u9525\u5e73\u9762\u8c03\u7528 frustumPlane \u65b9\u6cd5\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8fd9\u4e9b\u5e73\u9762\u65b9\u7a0b\u662f\u7528\u4e16\u754c\u5750\u6807\u8868\u793a\u7684\uff0c\u6240\u4ee5\u6240\u6709\u7684\u8ba1\u7b97\u90fd\u8981\u5728\u8fd9\u4e2a\u7a7a\u95f4\u4e2d\u8fdb\u884c\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u8ba1\u7b97\u4e86\u6240\u6709\u5e73\u9762\uff0c\u6211\u4eec\u53ea\u9700\u8981\u68c0\u67e5 GameItem \u5b9e\u4f8b\u662f\u5426\u5728\u622a\u9525\u4f53\u4e2d\u3002\u8be5\u600e\u4e48\u505a\uff1f\u8ba9\u6211\u4eec\u9996\u5148\u786e\u8ba4\u4e00\u4e0b\u5982\u4f55\u68c0\u67e5\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\uff0c\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u70b9\u5230\u6bcf\u4e2a\u5e73\u9762\u7684\u6709\u7b26\u53f7\u7684\u8ddd\u79bb\u6765\u5b9e\u73b0\u8fd9\u4e00\u70b9\u3002\u5982\u679c\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u662f\u6b63\u7684\uff0c\u8fd9\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u524d\u9762\uff08\u6839\u636e\u5176\u6cd5\u7ebf\uff09\u3002\u5982\u679c\u662f\u8d1f\u7684\uff0c\u5219\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u56e0\u6b64\uff0c\u5982\u679c\u5230\u622a\u9525\u7684\u6240\u6709\u5e73\u9762\u7684\u8ddd\u79bb\u4e3a\u6b63\uff0c\u5219\u4e00\u4e2a\u70b9\u4f4d\u4e8e\u89c6\u9525\u4f53\u7684\u5185\u90e8\u3002\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u5b9a\u4e49\u5982\u4e0b\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0}+D \uff0c\u5176\u4e2d x_{0} \u3001 y_{0} \u548c z_{0} \u662f\u70b9\u7684\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u5982\u679c Ax_{0}+By_{0}+Cz_{0}+D <= 0 \u5219\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u6ca1\u6709\u70b9\uff0c\u53ea\u6709\u590d\u6742\u7684\u7f51\u683c\uff0c\u6211\u4eec\u4e0d\u80fd\u4ec5\u4ec5\u7528\u70b9\u6765\u68c0\u67e5\u4e00\u4e2a\u7269\u54c1\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u4f60\u53ef\u4ee5\u8003\u8651\u68c0\u67e5 GameItem \u7684\u6bcf\u4e2a\u9876\u70b9\uff0c\u770b\u770b\u5b83\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u5982\u679c\u4efb\u4f55\u4e00\u4e2a\u70b9\u5728\u91cc\u9762\uff0c\u6e38\u620f\u9879\u5e94\u8be5\u88ab\u7ed8\u5236\u51fa\u6765\u3002\u4f46\u8fd9\u5c31\u662fOpenGL\u5728\u88c1\u526a\u65f6\u6240\u505a\u7684\uff0c\u4e5f\u662f\u6211\u4eec\u8981\u907f\u514d\u7684\u3002\u8bb0\u4f4f\uff0c\u7f51\u683c\u8d8a\u590d\u6742\uff0c\u622a\u9525\u5254\u9664\u7684\u597d\u5904\u8d8a\u660e\u663e\u3002 \u6211\u4eec\u9700\u8981\u628a\u6bcf\u4e00\u4e2a GameItem \u653e\u5230\u4e00\u4e2a\u7b80\u5355\u7684\u4f53\u4e2d\uff0c\u8fd9\u4e2a\u4f53\u5f88\u5bb9\u6613\u68c0\u67e5\u3002\u8fd9\u91cc\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u9879\uff1a \u8fb9\u754c\u76d2\uff08Bounding Box\uff09\u3002 \u8fb9\u754c\u7403\uff08Bounding Sphere\uff09\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7403\u4f53\uff0c\u56e0\u4e3a\u8fd9\u662f\u6700\u7b80\u5355\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u628a\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879\u653e\u5728\u4e00\u4e2a\u7403\u4f53\u4e2d\uff0c\u5e76\u68c0\u67e5\u7403\u4f53\u662f\u5426\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e2d\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7403\u4f53\u7684\u4e2d\u5fc3\u548c\u534a\u5f84\u3002\u68c0\u67e5\u5b83\u51e0\u4e4e\u7b49\u540c\u4e8e\u68c0\u67e5\u70b9\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u8003\u8651\u677f\u7532\u3002\u5982\u679c\u6ee1\u8db3\u4ee5\u4e0b\u6761\u4ef6\uff0c\u5219\u7403\u4f53\u5c06\u4f4d\u4e8e\u622a\u9525\u4e4b\u5916\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0} <= -\u534a\u5f84 \u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728 FrustumCullingFilter \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u68c0\u67e5\u7403\u4f53\u662f\u5426\u5728\u622a\u9525\u4e2d\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { boolean result = true; for (int i = 0; i < NUM_PLANES; i++) { Vector4f plane = frustumPlanes[i]; if (plane.x * x0 + plane.y * y0 + plane.z * z0 + plane.w <= -boundingRadius) { result = false; return result; } } return result; } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u8fc7\u6ee4\u89c6\u9525\u4f53\u5916\u7684\u6e38\u620f\u9879\u7684\u65b9\u6cd5\uff1a public void filter(List<GameItem> gameItems, float meshBoundingRadius) { float boundingRadius; Vector3f pos; for (GameItem gameItem : gameItems) { boundingRadius = gameItem.getScale() * meshBoundingRadius; pos = gameItem.getPosition(); gameItem.setInsideFrustum(insideFrustum(pos.x, pos.y, pos.z, boundingRadius)); } } \u6211\u4eec\u5728 GameItem \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 insideFrustum \u6765\u8ddf\u8e2a\u53ef\u89c1\u6027\u3002\u5982\u4f60\u6240\u89c1\uff0c\u8fb9\u754c\u7403\u7684\u677f\u7532\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u3002\u8fd9\u662f\u7531\u4e8e\u8fb9\u754c\u7403\u4e0e Mesh \u7ba1\u7406\uff0c\u5b83\u4e0d\u662f GameItem \u7684\u5c5e\u6027\u3002\u4f46\u662f\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u5728\u4e16\u754c\u5750\u6807\u4e2d\u64cd\u4f5c\uff0c\u5e76\u4e14\u8fb9\u754c\u7403\u7684\u534a\u5f84\u5c06\u5728\u6a21\u578b\u7a7a\u95f4\u9707\u3002\u6211\u4eec\u5c06\u5e94\u7528\u4e3a GameItem \u8bbe\u7f6e\u7684\u6bd4\u4f8b\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u7a7a\u95f4\uff0c\u6211\u4eec\u8fd8\u5047\u8bbe GameItem \u7684\u4f4d\u7f6e\u662f\u7403\u4f53\u7684\u4e2d\u5fc3\uff08\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6700\u540e\u4e00\u4e2a\u65b9\u6cd5\u53ea\u662f\u4e00\u4e2a\u5b9e\u7528\u65b9\u6cd5\uff0c\u5b83\u63a5\u53d7\u7f51\u683c\u8868\u5e76\u8fc7\u6ee4\u5176\u4e2d\u5305\u542b\u7684\u6240\u6709 GameItem \u5b9e\u4f8b\uff1a public void filter(Map<? extends Mesh, List<GameItem>> mapMesh) { for (Map.Entry<? extends Mesh, List<GameItem>> entry : mapMesh.entrySet()) { List<GameItem> gameItems = entry.getValue(); filter(gameItems, entry.getKey().getBoundingRadius()); } } \u5c31\u8fd9\u6837\u3002\u6211\u4eec\u53ef\u4ee5\u5728\u6e32\u67d3\u6d41\u7a0b\u4e2d\u4f7f\u7528\u8be5\u7c7b\uff0c\u53ea\u9700\u8981\u66f4\u65b0\u622a\u9525\u5e73\u9762\uff0c\u8ba1\u7b97\u51fa\u54ea\u4e9b\u6e38\u620f\u9879\u662f\u53ef\u89c1\u7684\uff0c\u5e76\u5728\u7ed8\u5236\u5b9e\u4f8b\u7f51\u683c\u548c\u975e\u5b9e\u4f8b\u7f51\u683c\u65f6\u8fc7\u6ee4\u6389\u5b83\u4eec\uff1a frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); \u4f60\u53ef\u4ee5\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u529f\u80fd\uff0c\u5e76\u53ef\u4ee5\u68c0\u67e5\u4f60\u53ef\u4ee5\u8fbe\u5230\u7684FPS\u7684\u589e\u52a0\u548c\u51cf\u5c11\u3002\u5728\u8fc7\u6ee4\u65f6\u4e0d\u8003\u8651\u7c92\u5b50\uff0c\u4f46\u662f\u6dfb\u52a0\u5b83\u662f\u5f88\u7b80\u5355\u7684\u3002\u5bf9\u4e8e\u7c92\u5b50\uff0c\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\u6700\u597d\u68c0\u67e5\u53d1\u5c04\u5668\u7684\u4f4d\u7f6e\uff0c\u800c\u4e0d\u662f\u68c0\u67e5\u6bcf\u4e2a\u7c92\u5b50\u3002 \u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e8c \u89e3\u91ca\u4e86\u622a\u9525\u5254\u9664\u7684\u57fa\u7840\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 JOML \u5e93\u4e2d\u63d0\u4f9b\u7684\u66f4\u7cbe\u7ec6\u7684\u65b9\u6cd5\u3002\u5b83\u7279\u522b\u5730\u63d0\u4f9b\u4e86\u4e00\u4e2a\u540d\u4e3a FrustumIntersection \u7684\u7c7b\uff0c\u8be5\u7c7b\u4ee5\u6309\u6b64 \u6587\u7ae0 \u6240\u8ff0\u7684\u4e00\u79cd\u66f4\u6709\u6548\u7684\u65b9\u5f0f\u83b7\u53d6\u89c6\u9525\u4f53\u7684\u5e73\u9762\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u6d4b\u8bd5\u8fb9\u754c\u76d2\u3001\u70b9\u548c\u7403\u4f53\u7684\u65b9\u6cd5\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u4fee\u6539 FrustumCullingFilter \u7c7b\u3002\u5c5e\u6027\u548c\u6784\u9020\u51fd\u6570\u7b80\u5316\u5982\u4e0b\uff1a public class FrustumCullingFilter { private final Matrix4f prjViewMatrix; private FrustumIntersection frustumInt; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumInt = new FrustumIntersection(); } updateFrustum \u65b9\u6cd5\u53ea\u662f\u5c06\u5e73\u9762\u83b7\u53d6\u59d4\u6258\u7ed9 FrustumIntersection \u5b9e\u4f8b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u66f4\u65b0\u622a\u9525\u76f8\u4ea4\u7c7b frustumInt.set(prjViewMatrix); } insideFrustum \u65b9\u6cd5\u66f4\u7b80\u5355\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { return frustumInt.testSphere(x0, y0, z0, boundingRadius); } \u4f7f\u7528\u8be5\u65b9\u6cd5\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u8fbe\u5230\u66f4\u9ad8\u7684FPS\u3002\u6b64\u5916\uff0c\u8fd8\u5411 Window \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u5168\u5c40\u6807\u8bb0\uff0c\u4ee5\u542f\u7528\u6216\u7981\u7528\u622a\u9525\u5254\u9664\u3002 GameItem \u7c7b\u4e5f\u6709\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u7684\u6807\u8bb0\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u67d0\u4e9b\u9879\uff0c\u622a\u9525\u5254\u9664\u8fc7\u6ee4\u53ef\u80fd\u6ca1\u6709\u610f\u4e49\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664"},{"location":"25-optimizations-frustum-culling/#-optimizations-frustum-culling","text":"","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\uff08Optimizations - Frustum Culling\uff09"},{"location":"25-optimizations-frustum-culling/#-","text":"\u73b0\u5728\u6211\u4eec\u4f7f\u7528\u4e86\u8bb8\u591a\u4e0d\u540c\u7684\u56fe\u5f62\u6548\u679c\uff0c\u4f8b\u5982\u5149\u7167\u3001\u7c92\u5b50\u7b49\u3002\u6b64\u5916\uff0c\u6211\u4eec\u8fd8\u5b66\u4e60\u4e86\u5982\u4f55\u5b9e\u4f8b\u5316\u6e32\u67d3\uff0c\u4ee5\u51cf\u5c11\u7ed8\u5236\u8bb8\u591a\u76f8\u4f3c\u5bf9\u8c61\u7684\u5f00\u9500\u3002\u7136\u800c\uff0c\u6211\u4eec\u4ecd\u6709\u8db3\u591f\u7684\u7a7a\u95f4\u8fdb\u884c\u4e00\u4e9b\u7b80\u5355\u7684\u4f18\u5316\uff0c\u8fd9\u5c06\u589e\u52a0\u53ef\u4ee5\u8fbe\u5230\u7684\u5e27\u7387\uff08FPS\uff09\u3002 \u4f60\u53ef\u80fd\u60f3\u77e5\u9053\u4e3a\u4ec0\u4e48\u6211\u4eec\u4f1a\u5728\u6bcf\u4e00\u5e27\u4e2d\u7ed8\u5236\u6574\u4e2a\u6e38\u620f\u9879\u5217\u8868\uff0c\u5373\u4f7f\u5176\u4e2d\u4e00\u4e9b\u9879\u4e0d\u53ef\u89c1\uff08\u56e0\u4e3a\u5b83\u4eec\u5728\u6444\u50cf\u673a\u540e\u9762\u6216\u8ddd\u79bb\u6444\u50cf\u673a\u592a\u8fdc\uff09\u3002\u4f60\u751a\u81f3\u53ef\u80fd\u8ba4\u4e3a\u8fd9\u662f\u7531OpenGL\u81ea\u52a8\u5904\u7406\u7684\uff0c\u8fd9\u5728\u67d0\u79cd\u7a0b\u5ea6\u4e0a\u662f\u6b63\u786e\u7684\u3002OpenGL\u5c06\u653e\u5f03\u4f4d\u4e8e\u53ef\u89c1\u533a\u57df\u4e4b\u5916\u7684\u9876\u70b9\u7684\u6e32\u67d3\uff0c\u8fd9\u79f0\u4f5c\u88c1\u526a\uff08Clipping\uff09\u3002\u88c1\u526a\u7684\u95ee\u9898\u662f\uff0c\u5728\u6267\u884c\u9876\u70b9\u7740\u8272\u4e4b\u540e\uff0c\u6309\u9876\u70b9\u8fdb\u884c\u5904\u7406\u7684\u3002\u56e0\u6b64\uff0c\u5373\u4f7f\u6b64\u64cd\u4f5c\u8282\u7701\u4e86\u8d44\u6e90\uff0c\u6211\u4eec\u4e5f\u53ef\u4ee5\u901a\u8fc7\u4e0d\u5c1d\u8bd5\u6e32\u67d3\u4e0d\u53ef\u89c1\u7684\u5bf9\u8c61\u6765\u63d0\u9ad8\u6548\u7387\u3002\u6211\u4eec\u4e0d\u4f1a\u901a\u8fc7\u5c06\u6570\u636e\u53d1\u9001\u5230GPU\u4ee5\u53ca\u5bf9\u8fd9\u4e9b\u5bf9\u8c61\u7684\u6bcf\u4e2a\u9876\u70b9\u8fdb\u884c\u53d8\u6362\u6765\u6d6a\u8d39\u8d44\u6e90\u3002\u6211\u4eec\u9700\u8981\u79fb\u9664\u4e0d\u5305\u542b\u5728\u89c6\u9525\u4f53\uff08View Frustum\uff09\u4e2d\u7684\u5bf9\u8c61\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u9700\u8981\u8fdb\u884c\u622a\u9525\u5254\u9664\u3002 \u4f46\u662f\uff0c\u9996\u5148\u8ba9\u6211\u4eec\u56de\u987e\u4e00\u4e0b\u4ec0\u4e48\u662f\u89c6\u9525\u4f53\u3002\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u7ed3\u5408\u6444\u50cf\u673a\u7684\u4f4d\u7f6e\u548c\u65cb\u8f6c\u4ee5\u53ca\u4f7f\u7528\u7684\u6295\u5f71\uff0c\u5305\u542b\u6240\u6709\u53ef\u89c1\u7269\u4f53\u7684\u4f53\u79ef\u3002\u901a\u5e38\uff0c\u89c6\u9525\u4f53\u662f\u4e00\u4e2a\u56db\u68f1\u53f0\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5982\u4f60\u6240\u89c1\uff0c\u89c6\u9525\u4f53\u7531\u516d\u4e2a\u5e73\u9762\u5b9a\u4e49\uff0c\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u4efb\u4f55\u5185\u5bb9\u90fd\u4e0d\u4f1a\u6e32\u67d3\u3002\u56e0\u6b64\uff0c\u622a\u9525\u5254\u9664\u662f\u79fb\u9664\u89c6\u9525\u4f53\u4e4b\u5916\u7684\u5bf9\u8c61\u7684\u8fc7\u7a0b\u3002 \u56e0\u6b64\uff0c\u4e3a\u4e86\u8fdb\u884c\u622a\u9525\u5254\u9664\uff0c\u6211\u4eec\u9700\u8981\uff1a \u4f7f\u7528\u89c2\u5bdf\u548c\u6295\u5f71\u77e9\u9635\u4e2d\u5305\u542b\u7684\u6570\u636e\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u3002 \u5bf9\u6bcf\u4e2a\u6e38\u620f\u9879\u68c0\u67e5\u5b83\u662f\u5426\u5305\u542b\u5728\u89c6\u9525\u4f53\u4e2d\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u5728\u5927\u5c0f\u622a\u9525\u5e73\u9762\u4e4b\u95f4\u3002\u5e76\u4ece\u6e32\u67d3\u6d41\u7a0b\u4e2d\u5220\u9664\u90a3\u4e9b\u4e0d\u5305\u542b\u5728\u5176\u4e2d\u7684\u3002 \u90a3\u4e48\u8ba9\u6211\u4eec\u4ece\u8ba1\u7b97\u622a\u9525\u5e73\u9762\u5f00\u59cb\u3002\u5e73\u9762\u7531\u5305\u542b\u5728\u5176\u4e2d\u7684\u70b9\u548c\u4e0e\u8be5\u5e73\u9762\u6b63\u4ea4\u7684\u5411\u91cf\u5b9a\u4e49\uff0c\u5982\u4e0b\u56fe\u6240\u793a\uff1a \u5e73\u9762\u65b9\u7a0b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a Ax+By+Cz+D=0 \u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u8ba1\u7b97\u89c6\u9525\u4f53\u7684\u516d\u4e2a\u4fa7\u9762\u7684\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u3002\u4e3a\u4e86\u8fbe\u6210\u8fd9\u4e2a\u76ee\u6807\uff0c\u4f60\u57fa\u672c\u4e0a\u6709\u4e24\u4e2a\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u8fdb\u884c\u7e41\u7410\u7684\u8ba1\u7b97\uff0c\u5f97\u5230\u516d\u4e2a\u5e73\u9762\u65b9\u7a0b\u7684\u6765\u81ea\u4e0a\u8ff0\u65b9\u7a0b\u7684\u56db\u4e2a\u5e38\u6570\uff08A\u3001B\u3001C\u548cD\uff09\u3002\u53e6\u4e00\u4e2a\u9009\u9879\u662f\u8ba9 JOML \u5e93\u4e3a\u4f60\u8ba1\u7b97\u8fd9\u4e2a\u503c\u3002\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u9009\u62e9\u540e\u4e00\u4e2a\u9009\u9879\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a FrustumCullingFilter \u7684\u65b0\u7c7b\uff0c\u8ddf\u5b83\u7684\u540d\u5b57\u76f8\u540c\uff0c\u5b83\u5c06\u6839\u636e\u89c6\u9525\u4f53\u6267\u884c\u7b5b\u9009\u64cd\u4f5c\u3002 public class FrustumCullingFilter { private static final int NUM_PLANES = 6; private final Matrix4f prjViewMatrix; private final Vector4f[] frustumPlanes; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumPlanes = new Vector4f[NUM_PLANES]; for (int i = 0; i < NUM_PLANES; i++) { frustumPlanes[i] = new Vector4f(); } } FrustumCullingFilter \u7c7b\u4e5f\u5c06\u6709\u4e00\u4e2a\u65b9\u6cd5\u6765\u8ba1\u7b97\u5e73\u9762\u65b9\u7a0b\uff0c\u540d\u4e3a updateFrustum \uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u4e4b\u524d\u8c03\u7528\u3002\u65b9\u6cd5\u5b9a\u4e49\u5982\u4e0b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u89c2\u5bdf\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u83b7\u53d6\u89c6\u9525\u4f53\u5e73\u9762 for (int i = 0; i < NUM_PLANES; i++) { prjViewMatrix.frustumPlane(i, frustumPlanes[i]); } } \u9996\u5148\uff0c\u6211\u4eec\u50a8\u5b58\u6295\u5f71\u77e9\u9635\u7684\u526f\u672c\uff0c\u5e76\u5c06\u5176\u4e0e\u89c2\u5bdf\u77e9\u9635\u76f8\u4e58\uff0c\u5f97\u5230\u6295\u5f71\u89c2\u5bdf\u77e9\u9635\u3002\u7136\u540e\uff0c\u4f7f\u7528\u8fd9\u4e2a\u53d8\u6362\u77e9\u9635\uff0c\u6211\u4eec\u53ea\u9700\u8981\u4e3a\u6bcf\u4e2a\u622a\u9525\u5e73\u9762\u8c03\u7528 frustumPlane \u65b9\u6cd5\u3002\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u8fd9\u4e9b\u5e73\u9762\u65b9\u7a0b\u662f\u7528\u4e16\u754c\u5750\u6807\u8868\u793a\u7684\uff0c\u6240\u4ee5\u6240\u6709\u7684\u8ba1\u7b97\u90fd\u8981\u5728\u8fd9\u4e2a\u7a7a\u95f4\u4e2d\u8fdb\u884c\u3002 \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u8ba1\u7b97\u4e86\u6240\u6709\u5e73\u9762\uff0c\u6211\u4eec\u53ea\u9700\u8981\u68c0\u67e5 GameItem \u5b9e\u4f8b\u662f\u5426\u5728\u622a\u9525\u4f53\u4e2d\u3002\u8be5\u600e\u4e48\u505a\uff1f\u8ba9\u6211\u4eec\u9996\u5148\u786e\u8ba4\u4e00\u4e0b\u5982\u4f55\u68c0\u67e5\u4e00\u4e2a\u70b9\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\uff0c\u53ef\u4ee5\u901a\u8fc7\u8ba1\u7b97\u70b9\u5230\u6bcf\u4e2a\u5e73\u9762\u7684\u6709\u7b26\u53f7\u7684\u8ddd\u79bb\u6765\u5b9e\u73b0\u8fd9\u4e00\u70b9\u3002\u5982\u679c\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u662f\u6b63\u7684\uff0c\u8fd9\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u524d\u9762\uff08\u6839\u636e\u5176\u6cd5\u7ebf\uff09\u3002\u5982\u679c\u662f\u8d1f\u7684\uff0c\u5219\u610f\u5473\u7740\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u56e0\u6b64\uff0c\u5982\u679c\u5230\u622a\u9525\u7684\u6240\u6709\u5e73\u9762\u7684\u8ddd\u79bb\u4e3a\u6b63\uff0c\u5219\u4e00\u4e2a\u70b9\u4f4d\u4e8e\u89c6\u9525\u4f53\u7684\u5185\u90e8\u3002\u70b9\u5230\u5e73\u9762\u7684\u8ddd\u79bb\u5b9a\u4e49\u5982\u4e0b\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0}+D \uff0c\u5176\u4e2d x_{0} \u3001 y_{0} \u548c z_{0} \u662f\u70b9\u7684\u5750\u6807\u3002 \u56e0\u6b64\uff0c\u5982\u679c Ax_{0}+By_{0}+Cz_{0}+D <= 0 \u5219\u70b9\u5728\u5e73\u9762\u7684\u540e\u9762\u3002 \u4f46\u662f\uff0c\u6211\u4eec\u6ca1\u6709\u70b9\uff0c\u53ea\u6709\u590d\u6742\u7684\u7f51\u683c\uff0c\u6211\u4eec\u4e0d\u80fd\u4ec5\u4ec5\u7528\u70b9\u6765\u68c0\u67e5\u4e00\u4e2a\u7269\u54c1\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u4f60\u53ef\u4ee5\u8003\u8651\u68c0\u67e5 GameItem \u7684\u6bcf\u4e2a\u9876\u70b9\uff0c\u770b\u770b\u5b83\u662f\u5426\u5728\u622a\u9525\u4f53\u5185\u3002\u5982\u679c\u4efb\u4f55\u4e00\u4e2a\u70b9\u5728\u91cc\u9762\uff0c\u6e38\u620f\u9879\u5e94\u8be5\u88ab\u7ed8\u5236\u51fa\u6765\u3002\u4f46\u8fd9\u5c31\u662fOpenGL\u5728\u88c1\u526a\u65f6\u6240\u505a\u7684\uff0c\u4e5f\u662f\u6211\u4eec\u8981\u907f\u514d\u7684\u3002\u8bb0\u4f4f\uff0c\u7f51\u683c\u8d8a\u590d\u6742\uff0c\u622a\u9525\u5254\u9664\u7684\u597d\u5904\u8d8a\u660e\u663e\u3002 \u6211\u4eec\u9700\u8981\u628a\u6bcf\u4e00\u4e2a GameItem \u653e\u5230\u4e00\u4e2a\u7b80\u5355\u7684\u4f53\u4e2d\uff0c\u8fd9\u4e2a\u4f53\u5f88\u5bb9\u6613\u68c0\u67e5\u3002\u8fd9\u91cc\u6211\u4eec\u6709\u4e24\u4e2a\u9009\u9879\uff1a \u8fb9\u754c\u76d2\uff08Bounding Box\uff09\u3002 \u8fb9\u754c\u7403\uff08Bounding Sphere\uff09\u3002 \u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u7403\u4f53\uff0c\u56e0\u4e3a\u8fd9\u662f\u6700\u7b80\u5355\u7684\u65b9\u6cd5\u3002\u6211\u4eec\u5c06\u628a\u6bcf\u4e00\u4e2a\u6e38\u620f\u9879\u653e\u5728\u4e00\u4e2a\u7403\u4f53\u4e2d\uff0c\u5e76\u68c0\u67e5\u7403\u4f53\u662f\u5426\u4f4d\u4e8e\u89c6\u9525\u4f53\u4e2d\u3002\u4e3a\u4e86\u505a\u5230\u5b83\uff0c\u6211\u4eec\u53ea\u9700\u8981\u7403\u4f53\u7684\u4e2d\u5fc3\u548c\u534a\u5f84\u3002\u68c0\u67e5\u5b83\u51e0\u4e4e\u7b49\u540c\u4e8e\u68c0\u67e5\u70b9\uff0c\u4f46\u662f\u6211\u4eec\u9700\u8981\u8003\u8651\u677f\u7532\u3002\u5982\u679c\u6ee1\u8db3\u4ee5\u4e0b\u6761\u4ef6\uff0c\u5219\u7403\u4f53\u5c06\u4f4d\u4e8e\u622a\u9525\u4e4b\u5916\uff1a \u8ddd\u79bb=Ax_{0}+By_{0}+Cz_{0} <= -\u534a\u5f84 \u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u5c06\u5728 FrustumCullingFilter \u7c7b\u4e2d\u6dfb\u52a0\u4e00\u4e2a\u65b0\u65b9\u6cd5\u6765\u68c0\u67e5\u7403\u4f53\u662f\u5426\u5728\u622a\u9525\u4e2d\u3002\u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { boolean result = true; for (int i = 0; i < NUM_PLANES; i++) { Vector4f plane = frustumPlanes[i]; if (plane.x * x0 + plane.y * y0 + plane.z * z0 + plane.w <= -boundingRadius) { result = false; return result; } } return result; } \u7136\u540e\uff0c\u6211\u4eec\u5c06\u6dfb\u52a0\u8fc7\u6ee4\u89c6\u9525\u4f53\u5916\u7684\u6e38\u620f\u9879\u7684\u65b9\u6cd5\uff1a public void filter(List<GameItem> gameItems, float meshBoundingRadius) { float boundingRadius; Vector3f pos; for (GameItem gameItem : gameItems) { boundingRadius = gameItem.getScale() * meshBoundingRadius; pos = gameItem.getPosition(); gameItem.setInsideFrustum(insideFrustum(pos.x, pos.y, pos.z, boundingRadius)); } } \u6211\u4eec\u5728 GameItem \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u5c5e\u6027 insideFrustum \u6765\u8ddf\u8e2a\u53ef\u89c1\u6027\u3002\u5982\u4f60\u6240\u89c1\uff0c\u8fb9\u754c\u7403\u7684\u677f\u7532\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\u3002\u8fd9\u662f\u7531\u4e8e\u8fb9\u754c\u7403\u4e0e Mesh \u7ba1\u7406\uff0c\u5b83\u4e0d\u662f GameItem \u7684\u5c5e\u6027\u3002\u4f46\u662f\uff0c\u8bf7\u8bb0\u4f4f\uff0c\u6211\u4eec\u5fc5\u987b\u5728\u4e16\u754c\u5750\u6807\u4e2d\u64cd\u4f5c\uff0c\u5e76\u4e14\u8fb9\u754c\u7403\u7684\u534a\u5f84\u5c06\u5728\u6a21\u578b\u7a7a\u95f4\u9707\u3002\u6211\u4eec\u5c06\u5e94\u7528\u4e3a GameItem \u8bbe\u7f6e\u7684\u6bd4\u4f8b\u5c06\u5176\u8f6c\u6362\u4e3a\u4e16\u754c\u7a7a\u95f4\uff0c\u6211\u4eec\u8fd8\u5047\u8bbe GameItem \u7684\u4f4d\u7f6e\u662f\u7403\u4f53\u7684\u4e2d\u5fc3\uff08\u5728\u4e16\u754c\u7a7a\u95f4\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6700\u540e\u4e00\u4e2a\u65b9\u6cd5\u53ea\u662f\u4e00\u4e2a\u5b9e\u7528\u65b9\u6cd5\uff0c\u5b83\u63a5\u53d7\u7f51\u683c\u8868\u5e76\u8fc7\u6ee4\u5176\u4e2d\u5305\u542b\u7684\u6240\u6709 GameItem \u5b9e\u4f8b\uff1a public void filter(Map<? extends Mesh, List<GameItem>> mapMesh) { for (Map.Entry<? extends Mesh, List<GameItem>> entry : mapMesh.entrySet()) { List<GameItem> gameItems = entry.getValue(); filter(gameItems, entry.getKey().getBoundingRadius()); } } \u5c31\u8fd9\u6837\u3002\u6211\u4eec\u53ef\u4ee5\u5728\u6e32\u67d3\u6d41\u7a0b\u4e2d\u4f7f\u7528\u8be5\u7c7b\uff0c\u53ea\u9700\u8981\u66f4\u65b0\u622a\u9525\u5e73\u9762\uff0c\u8ba1\u7b97\u51fa\u54ea\u4e9b\u6e38\u620f\u9879\u662f\u53ef\u89c1\u7684\uff0c\u5e76\u5728\u7ed8\u5236\u5b9e\u4f8b\u7f51\u683c\u548c\u975e\u5b9e\u4f8b\u7f51\u683c\u65f6\u8fc7\u6ee4\u6389\u5b83\u4eec\uff1a frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); \u4f60\u53ef\u4ee5\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u529f\u80fd\uff0c\u5e76\u53ef\u4ee5\u68c0\u67e5\u4f60\u53ef\u4ee5\u8fbe\u5230\u7684FPS\u7684\u589e\u52a0\u548c\u51cf\u5c11\u3002\u5728\u8fc7\u6ee4\u65f6\u4e0d\u8003\u8651\u7c92\u5b50\uff0c\u4f46\u662f\u6dfb\u52a0\u5b83\u662f\u5f88\u7b80\u5355\u7684\u3002\u5bf9\u4e8e\u7c92\u5b50\uff0c\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\u6700\u597d\u68c0\u67e5\u53d1\u5c04\u5668\u7684\u4f4d\u7f6e\uff0c\u800c\u4e0d\u662f\u68c0\u67e5\u6bcf\u4e2a\u7c92\u5b50\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e00"},{"location":"25-optimizations-frustum-culling/#-_1","text":"\u89e3\u91ca\u4e86\u622a\u9525\u5254\u9664\u7684\u57fa\u7840\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528 JOML \u5e93\u4e2d\u63d0\u4f9b\u7684\u66f4\u7cbe\u7ec6\u7684\u65b9\u6cd5\u3002\u5b83\u7279\u522b\u5730\u63d0\u4f9b\u4e86\u4e00\u4e2a\u540d\u4e3a FrustumIntersection \u7684\u7c7b\uff0c\u8be5\u7c7b\u4ee5\u6309\u6b64 \u6587\u7ae0 \u6240\u8ff0\u7684\u4e00\u79cd\u66f4\u6709\u6548\u7684\u65b9\u5f0f\u83b7\u53d6\u89c6\u9525\u4f53\u7684\u5e73\u9762\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u8be5\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u6d4b\u8bd5\u8fb9\u754c\u76d2\u3001\u70b9\u548c\u7403\u4f53\u7684\u65b9\u6cd5\u3002 \u90a3\u4e48\uff0c\u8ba9\u6211\u4eec\u4fee\u6539 FrustumCullingFilter \u7c7b\u3002\u5c5e\u6027\u548c\u6784\u9020\u51fd\u6570\u7b80\u5316\u5982\u4e0b\uff1a public class FrustumCullingFilter { private final Matrix4f prjViewMatrix; private FrustumIntersection frustumInt; public FrustumCullingFilter() { prjViewMatrix = new Matrix4f(); frustumInt = new FrustumIntersection(); } updateFrustum \u65b9\u6cd5\u53ea\u662f\u5c06\u5e73\u9762\u83b7\u53d6\u59d4\u6258\u7ed9 FrustumIntersection \u5b9e\u4f8b\uff1a public void updateFrustum(Matrix4f projMatrix, Matrix4f viewMatrix) { // \u8ba1\u7b97\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 prjViewMatrix.set(projMatrix); prjViewMatrix.mul(viewMatrix); // \u66f4\u65b0\u622a\u9525\u76f8\u4ea4\u7c7b frustumInt.set(prjViewMatrix); } insideFrustum \u65b9\u6cd5\u66f4\u7b80\u5355\uff1a public boolean insideFrustum(float x0, float y0, float z0, float boundingRadius) { return frustumInt.testSphere(x0, y0, z0, boundingRadius); } \u4f7f\u7528\u8be5\u65b9\u6cd5\uff0c\u4f60\u751a\u81f3\u53ef\u4ee5\u8fbe\u5230\u66f4\u9ad8\u7684FPS\u3002\u6b64\u5916\uff0c\u8fd8\u5411 Window \u7c7b\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u5168\u5c40\u6807\u8bb0\uff0c\u4ee5\u542f\u7528\u6216\u7981\u7528\u622a\u9525\u5254\u9664\u3002 GameItem \u7c7b\u4e5f\u6709\u542f\u7528\u6216\u7981\u7528\u8fc7\u6ee4\u7684\u6807\u8bb0\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u67d0\u4e9b\u9879\uff0c\u622a\u9525\u5254\u9664\u8fc7\u6ee4\u53ef\u80fd\u6ca1\u6709\u610f\u4e49\u3002","title":"\u4f18\u5316 - \u622a\u9525\u5254\u9664\u4e8c"},{"location":"26-cascaded-shadow-maps/","text":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09 \u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4ecb\u7ecd\u4e86\u9634\u5f71\u6620\u5c04\u6280\u672f\uff0c\u4ee5\u4fbf\u5728\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u65f6\u4f7f\u7528\u5e73\u884c\u5149\u663e\u793a\u9634\u5f71\u3002\u6b64\u524d\u4ecb\u7ecd\u7684\u65b9\u6848\u4e2d\u8981\u6c42\u4f60\u624b\u52a8\u8c03\u6574\u4e00\u4e9b\u53c2\u6570\u4ee5\u6539\u8fdb\u6548\u679c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u8be5\u6280\u672f\uff0c\u4ee5\u81ea\u52a8\u5316\u6240\u6709\u6d41\u7a0b\uff0c\u5e76\u6539\u8fdb\u5728\u5f00\u653e\u7a7a\u95f4\u4e2d\u7684\u6548\u679c\u3002\u4e3a\u4e86\u8fbe\u5230\u76ee\u7684\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CMS\uff0cCascaded Shadow Map\uff09\u7684\u6280\u672f\u3002 \u8ba9\u6211\u4eec\u9996\u5148\u770b\u4e00\u4e0b\u5982\u4f55\u81ea\u52a8\u6784\u9020\u7528\u4e8e\u6e32\u67d3\u9634\u5f71\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u5982\u679c\u4f60\u56de\u60f3\u9634\u5f71\u4e00\u7ae0\uff0c\u6211\u4eec\u9700\u8981\u4ece\u5149\u7ebf\u7684\u89d2\u5ea6\u6765\u7ed8\u5236\u573a\u666f\u3002\u8fd9\u610f\u5473\u7740\u521b\u5efa\u4e00\u4e2a\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5b83\u5c31\u50cf\u4e00\u4e2a\u4f5c\u7528\u4e8e\u5149\u6e90\u7684\u6444\u50cf\u673a\u548c\u4e00\u4e2a\u6295\u5f71\u77e9\u9635\u3002\u7531\u4e8e\u5149\u662f\u5b9a\u5411\u7684\uff0c\u800c\u4e14\u5e94\u8be5\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\uff0c\u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4e86\u6b63\u4ea4\u6295\u5f71\u3002 \u6211\u4eec\u5e0c\u671b\u6240\u6709\u53ef\u89c1\u7684\u7269\u4f53\u90fd\u9002\u7528\u4e8e\u5149\u7167\u89c6\u56fe\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5c06\u89c6\u622a\u9525\u653e\u5165\u5149\u622a\u9525\u4e2d\u3002\u4e0b\u56fe\u662f\u6211\u4eec\u6700\u7ec8\u60f3\u8981\u5b9e\u73b0\u7684\u6548\u679c\uff1a \u8be5\u5982\u4f55\u6784\u9020\u5b83\uff1f\u9996\u5148\u662f\u8ba1\u7b97\u89c2\u5bdf\u6295\u5f71\u77e9\u9635\u7684\u622a\u9525\u9876\u70b9\u3002\u6211\u4eec\u5f97\u5230\u4e16\u754c\u7a7a\u95f4\u7684\u5750\u6807\uff0c\u7136\u540e\u8ba1\u7b97\u8fd9\u4e2a\u622a\u9525\u7684\u4e2d\u5fc3\uff0c\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06\u6240\u6709\u7684\u9876\u70b9\u7684\u5750\u6807\u76f8\u52a0\u5e76\u5c06\u7ed3\u679c\u9664\u4ee5\u9876\u70b9\u7684\u6570\u91cf\u6765\u8ba1\u7b97\u3002 \u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8bbe\u7f6e\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u5176\u4f4d\u7f6e\u53ca\u5176\u65b9\u5411\u5c06\u7528\u4e8e\u6784\u5efa\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u4f4d\u7f6e\uff0c\u6211\u4eec\u4ece\u6b64\u524d\u5f97\u5230\u7684\u89c6\u9525\u4f53\u7684\u4e2d\u5fc3\u5f00\u59cb\uff0c\u9006\u7740\u5149\u7684\u65b9\u5411\uff0c\u53d6\u76f8\u5f53\u4e8e\u89c6\u9525\u4f53\u7684\u8fd1Z\u5e73\u9762\u548c\u8fdcZ\u5e73\u9762\u7684\u8ddd\u79bb\u7684\u4e00\u70b9\u3002 \u6784\u5efa\u5b8c\u6210\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u5b83\u4eec\uff0c\u6211\u4eec\u5c06\u622a\u9525\u7684\u9876\u70b9\u8f6c\u6362\u5230\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\uff0c\u53ea\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u521a\u521a\u6784\u5efa\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u6295\u5f71\u77e9\u9635\u7684\u5c3a\u5bf8\u662f\u6700\u5927\u548c\u6700\u5c0f\u7684X\u548cY\u503c\uff0c\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u4e0e\u6807\u51c6\u6295\u5f71\u77e9\u9635\u76f8\u540c\u7684\u503c\uff0c\u8fdcZ\u5e73\u9762\u5219\u662f\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\u4e2d\u622a\u9525\u9876\u70b9\u7684\u6700\u5927\u548c\u6700\u5c0fZ\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 \u4f46\u662f\uff0c\u5982\u679c\u5728\u9634\u5f71\u793a\u4f8b\u4ee3\u7801\u7684\u57fa\u7840\u4e0a\u5b9e\u73b0\u4e0a\u8ff0\u7b97\u6cd5\uff0c\u5219\u53ef\u80fd\u4f1a\u5bf9\u9634\u5f71\u8d28\u91cf\u611f\u5230\u5931\u671b\u3002 \u539f\u56e0\u662f\u9634\u5f71\u5206\u8fa8\u7387\u53d7\u7eb9\u7406\u5927\u5c0f\u7684\u9650\u5236\u3002\u6211\u4eec\u73b0\u5728\u6b63\u8986\u76d6\u4e00\u4e2a\u6f5c\u5728\u7684\u5de8\u5927\u533a\u57df\uff0c\u5e76\u4e14\u6211\u4eec\u7528\u6765\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u6ca1\u6709\u8db3\u591f\u7684\u5206\u8fa8\u7387\u6765\u53d6\u5f97\u826f\u597d\u7684\u6548\u679c\u3002\u4f60\u53ef\u80fd\u8ba4\u4e3a\u89e3\u51b3\u65b9\u6cd5\u53ea\u662f\u63d0\u9ad8\u7eb9\u7406\u5206\u8fa8\u7387\uff0c\u4f46\u8fd9\u5e76\u4e0d\u8db3\u4ee5\u5b8c\u5168\u89e3\u51b3\u95ee\u9898\uff0c\u4f60\u9700\u8981\u5de8\u5927\u7684\u7eb9\u7406\u3002 \u6709\u4e00\u4e2a\u66f4\u806a\u660e\u7684\u89e3\u51b3\u65b9\u6848\u3002\u5176\u5173\u952e\u662f\uff0c\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u9700\u8981\u6bd4\u8fdc\u5904\u7269\u4f53\u7684\u9634\u5f71\u6709\u66f4\u9ad8\u7684\u8d28\u91cf\u3002\u4e00\u79cd\u65b9\u6cd5\u662f\u53ea\u6e32\u67d3\u9760\u8fd1\u6444\u50cf\u673a\u7684\u5bf9\u8c61\u7684\u9634\u5f71\uff0c\u4f46\u8fd9\u4f1a\u5bfc\u81f4\u9634\u5f71\u5728\u573a\u666f\u4e2d\u79fb\u52a8\u65f6\u51fa\u73b0\u6216\u6d88\u5931\u3002 \u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CSM\uff09\u4f7f\u7528\u7684\u65b9\u6cd5\u662f\u5c06\u89c6\u9525\u4f53\u5206\u5272\u4e3a\u591a\u4e2a\u90e8\u5206\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u8f83\u5c0f\u7684\u533a\u57df\uff0c\u800c\u8ddd\u79bb\u8f83\u8fdc\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u66f4\u5e7f\u7684\u533a\u57df\u3002\u4e0b\u56fe\u663e\u793a\u4e86\u628a\u4e00\u4e2a\u89c6\u9525\u4f53\u5206\u4e3a\u4e09\u4e2a\u90e8\u5206\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff0c\u5c06\u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\uff0c\u8c03\u6574\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u4ee5\u5408\u9002\u5730\u8986\u76d6\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u3002\u56e0\u6b64\uff0c\u50a8\u5b58\u6df1\u5ea6\u6620\u5c04\u7684\u7eb9\u7406\u8986\u76d6\u89c6\u9525\u4f53\u7684\u533a\u57df\u7f29\u5c0f\u4e86\u3002\u800c\u4e14\uff0c\u7531\u4e8e\u79bb\u6444\u50cf\u673a\u6700\u8fd1\u7684\u90e8\u5206\u4f1a\u5360\u7528\u8f83\u5c11\u7684\u7a7a\u95f4\uff0c\u56e0\u6b64\u6df1\u5ea6\u5206\u8fa8\u7387\u4f1a\u63d0\u9ad8\u3002 \u4ece\u4e0a\u8ff0\u89e3\u91ca\u53ef\u4ee5\u770b\u51fa\uff0c\u6211\u4eec\u9700\u8981\u5c3d\u53ef\u80fd\u591a\u7684\u5c06\u6df1\u5ea6\u56fe\u8fdb\u884c\u5206\u5272\uff0c\u6211\u4eec\u8fd8\u5c06\u66f4\u6539\u6bcf\u4e2a\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u8981\u4f7f\u7528CSM\u9700\u8981\u505a\u7684\u4e8b\u60c5\u662f\uff1a \u5c06\u89c6\u9525\u4f53\u5206\u4e3an\u4e2a\u90e8\u5206\u3002 \u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\u65f6\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff1a \u8ba1\u7b97\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u5c06\u573a\u666f\u6e32\u67d3\u4e3a\u5355\u72ec\u7684\u6df1\u5ea6\u56fe\u3002 \u6e32\u67d3\u573a\u666f\u65f6\uff1a \u4f7f\u7528\u6b64\u524d\u8ba1\u7b97\u7684\u6df1\u5ea6\u56fe\u3002 \u786e\u5b9a\u8981\u7ed8\u5236\u7684\u7247\u6bb5\u6240\u5c5e\u7684\u90e8\u5206\u3002 \u8ba1\u7b97\u9634\u5f71\u56e0\u5b50\uff0c\u5982\u9634\u5f71\u6620\u5c04\u4e2d\u6240\u8ff0\u3002 \u5982\u4f60\u6240\u89c1\uff0cCSM\u7684\u4e3b\u8981\u7f3a\u70b9\u662f\u6211\u4eec\u9700\u8981\u4ece\u706f\u5149\u7684\u89d2\u5ea6\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6e32\u67d3\u573a\u666f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u901a\u5e38\u53ea\u7528\u4e8e\u5f00\u653e\u7a7a\u95f4\u7684\u539f\u56e0\u3002\u4e0d\u7ba1\u600e\u4e48\u8bf4\uff0c\u6211\u4eec\u5c06\u53ef\u4ee5\u770b\u5230\u5982\u4f55\u8f7b\u677e\u5730\u51cf\u5c11\u5f00\u9500\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u4ee3\u7801\u3002\u4f46\u662f\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u6709\u4e00\u4e2a\u5c0f\u5c0f\u7684\u63d0\u9192\uff0c\u6211\u4e0d\u4f1a\u5728\u8fd9\u91cc\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u8fd9\u4f1a\u975e\u5e38\u67af\u71e5\u3002\u76f8\u53cd\uff0c\u6211\u5c06\u4ecb\u7ecd\u4e3b\u8981\u7c7b\u3001\u5b83\u4eec\u7684\u804c\u8d23\u548c\u53ef\u80fd\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u7247\u6bb5\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u3002\u6240\u6709\u4e0e\u7740\u8272\u76f8\u5173\u7684\u7c7b\u90fd\u5df2\u79fb\u52a8\u5230\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.graph.shadow \u7684\u65b0\u5305\u4e2d\u3002 \u6e32\u67d3\u9634\u5f71\u7684\u4ee3\u7801\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u4ece\u5149\u5f71\u900f\u89c6\u7684\u573a\u666f\u5df2\u7ecf\u79fb\u52a8\u5230\u4e86 ShadowRenderer \u7c7b\u4e2d\u3002\uff08\u8be5\u4ee3\u7801\u4ee5\u524d\u5728 Renderer \u7c7b\u4e2d\uff09\u3002 \u7c7b\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5e38\u91cf\uff1a public static final int NUM_CASCADES = 3; public static final float[] CASCADE_SPLITS = new float[]{Window.Z_FAR / 20.0f, Window.Z_FAR / 10.0f, Window.Z_FAR}; \u9996\u5148\u662f\u5c42\u7ea7\u6216\u62c6\u5206\u7684\u6570\u91cf\u3002\u7b2c\u4e8c\u4e2a\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u62c6\u5206\u7684\u90e8\u5206\u7684\u8fdcZ\u5e73\u9762\u7684\u4f4d\u7f6e\u3002\u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u7684\u95f4\u8ddd\u5e76\u4e0d\u76f8\u7b49\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u5728Z\u5e73\u9762\u4e0a\u7684\u8ddd\u79bb\u6700\u77ed\u3002 \u7c7b\u8fd8\u50a8\u5b58\u4e86\u7528\u4e8e\u6e32\u67d3\u6df1\u5ea6\u56fe\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u7684\u5f15\u7528\uff0c\u4e00\u4e2a\u5217\u8868\uff0c\u5176\u4e2d\u5305\u542b\u4e0e\u6bcf\u4e2a\u90e8\u5206\u76f8\u5173\u8054\u7684\u4fe1\u606f\uff0c\u5176\u7531 ShadowCascade \u7c7b\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5bf9\u50a8\u5b58\u6df1\u5ea6\u56fe\u6570\u636e\uff08\u7eb9\u7406\uff09\u7684\u5bf9\u8c61\u7684\u5f15\u7528\uff0c\u7531 ShadowBuffer \u7c7b\u5b9a\u4e49\u3002 ShadowRenderer \u7c7b\u5177\u6709\u7528\u4e8e\u8bbe\u7f6e\u7740\u8272\u5668\u548c\u6240\u9700\u5c5e\u6027\u7684\u65b9\u6cd5\u4ee5\u53ca\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\u3002 render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window, Scene scene, Camera camera, Transformation transformation, Renderer renderer) { update(window, camera.getViewMatrix(), scene); // \u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5927\u5c0f glBindFramebuffer(GL_FRAMEBUFFER, shadowBuffer.getDepthMapFBO()); glViewport(0, 0, ShadowBuffer.SHADOW_MAP_WIDTH, ShadowBuffer.SHADOW_MAP_HEIGHT); glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); // \u4e3a\u6bcf\u5c42\u56fe\u6e32\u67d3\u573a\u666f for (int i = 0; i < NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); depthShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix()); depthShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix()); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); glClear(GL_DEPTH_BUFFER_BIT); renderNonInstancedMeshes(scene, transformation); renderInstancedMeshes(scene, transformation); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6267\u884c\u7684\u51e0\u4e2a\u6e32\u67d3\u8fc7\u7a0b\uff0c\u7c7b\u4f3c\u4e8e\u6b64\u524d\u9634\u5f71\u56fe\u7684\u6e32\u67d3\u65b9\u6cd5\u3002\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u4f1a\u4f7f\u7528\u76f8\u5173\u7684 ShadowCascade \u5b9e\u4f8b\u4e2d\u4fdd\u51fd\u7684\u4fe1\u606f\u66f4\u6539\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002 \u6b64\u5916\uff0c\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u9700\u8981\u66f4\u6539\u6b63\u5728\u4f7f\u7528\u7684\u7eb9\u7406\u3002\u6bcf\u6b21\u90fd\u4f1a\u5c06\u6df1\u5ea6\u4fe1\u606f\u6e32\u67d3\u4e3a\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u6b64\u4fe1\u606f\u50a8\u5b58\u5728 ShadowBuffer \u7c7b\u4e2d\uff0c\u5e76\u8bbe\u7f6e\u4e3a\u4f9bFBO\u4f7f\u7528\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); \u6b63\u5982\u521a\u521a\u63d0\u5230\u7684\uff0c ShadowBuffer \u7c7b\u50a8\u5b58\u4e0e\u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u76f8\u5173\u7684\u4fe1\u606f\u3002\u4ee3\u7801\u4e0e\u9634\u5f71\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u4ee3\u7801\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u6211\u4eec\u4f7f\u7528\u7684\u662f\u7eb9\u7406\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684\u7c7b ArrTexture \uff0c\u5b83\u521b\u5efa\u4e86\u4e00\u4e2a\u5177\u6709\u76f8\u540c\u5c5e\u6027\u7684\u7eb9\u7406\u6570\u7ec4\u3002\u6b64\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a bind \u65b9\u6cd5\uff0c\u7528\u4e8e\u7ed1\u5b9a\u6240\u6709\u7eb9\u7406\u6570\u7ec4\uff0c\u4ee5\u4fbf\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u8be5\u65b9\u6cd5\u63a5\u6536\u4e00\u4e2a\u53c2\u6570\uff0c\u4ece\u67d0\u4e2a\u7eb9\u7406\u5355\u5143\u5f00\u59cb\u7ed1\u5b9a\u3002 public void bindTextures(int start) { for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { glActiveTexture(start + i); glBindTexture(GL_TEXTURE_2D, depthMap.getIds()[i]); } } ShadowCascade \u7c7b\u50a8\u5b58\u4e0e\u4e00\u4e2a\u90e8\u5206\u5173\u8054\u7684\u5149\u7167\u89c6\u56fe\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u7531\u4e00\u4e2a\u8fd1Z\u5e73\u9762\u8ddd\u79bb\u548c\u4e00\u4e2a\u8fdcZ\u5e73\u9762\u8ddd\u79bb\u5b9a\u4e49\uff0c\u5e76\u6839\u636e\u8be5\u4fe1\u606f\u8ba1\u7b97\u77e9\u9635\u3002 \u8be5\u7c7b\u63d0\u4f9b\u5e76\u66f4\u65b0\u4e86\u4ee5\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u65b9\u5411\u4e3a\u8f93\u5165\u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u9996\u5148\u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u89c6\u9525\u9876\u70b9\uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u6839\u636e\u5149\u7684\u65b9\u5411\uff0c\u4ece\u622a\u9525\u7684\u4e2d\u5fc3\u5230\u76f8\u5f53\u4e8e\u8fdcZ\u5e73\u9762\u5230\u8fd1Z\u5e73\u9762\u4e4b\u95f4\u7684\u8ddd\u79bb\u7684\u8ddd\u79bb\uff0c\u8ba1\u7b97\u51fa\u8be5\u4f4d\u7f6e\u3002 public void update(Window window, Matrix4f viewMatrix, DirectionalLight light) { // \u4e3a\u6b64\u5c42\u751f\u6210\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 float aspectRatio = (float) window.getWidth() / (float) window.getHeight(); projViewMatrix.setPerspective(Window.FOV, aspectRatio, zNear, zFar); projViewMatrix.mul(viewMatrix); // \u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u9876\u70b9 float maxZ = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; corner.set(0, 0, 0); projViewMatrix.frustumCorner(i, corner); centroid.add(corner); centroid.div(8.0f); minZ = Math.min(minZ, corner.z); maxZ = Math.max(maxZ, corner.z); } // \u4ece\u8d28\u5fc3\u9006\u7740\u5149\u7684\u65b9\u5411\u4e0amax.z-min.z\u7684\u8ddd\u79bb Vector3f lightDirection = light.getDirection(); Vector3f lightPosInc = new Vector3f().set(lightDirection); float distance = maxZ - minZ; lightPosInc.mul(distance); Vector3f lightPosition = new Vector3f(); lightPosition.set(centroid); lightPosition.add(lightPosInc); updateLightViewMatrix(lightDirection, lightPosition); updateLightProjectionMatrix(); } \u6839\u636e\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u6211\u4eec\u53ef\u4ee5\u6784\u9020\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightViewMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void updateLightViewMatrix(Vector3f lightDirection, Vector3f lightPosition) { float lightAngleX = (float) Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float) Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Transformation.updateGenericViewMatrix(lightPosition, new Vector3f(lightAngleX, lightAngleY, lightAngleZ), lightViewMatrix); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u6784\u9020\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightProjectionMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8be5\u65b9\u6cd5\u5c06\u89c6\u9525\u4f53\u5750\u6807\u8f6c\u6362\u5230\u5149\u7167\u7a7a\u95f4\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230x\u3001y\u5750\u6807\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\u6765\u6784\u9020\u5305\u56f4\u89c6\u9525\u4f53\u7684\u8fb9\u754c\u6846\u3002\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a0\uff0c\u8fdcZ\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u5750\u6807\u7684\u6700\u5927\u503c\u548c\u6700\u5c0f\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 private void updateLightProjectionMatrix() { // \u73b0\u5728\u8ba1\u7b97\u5149\u7167\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u5927\u5c0f\u3002 float minX = Float.MAX_VALUE; float maxX = -Float.MAX_VALUE; float minY = Float.MAX_VALUE; float maxY = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; float maxZ = -Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; tmpVec.set(corner, 1); tmpVec.mul(lightViewMatrix); minX = Math.min(tmpVec.x, minX); maxX = Math.max(tmpVec.x, maxX); minY = Math.min(tmpVec.y, minY); maxY = Math.max(tmpVec.y, maxY); minZ = Math.min(tmpVec.z, minZ); maxZ = Math.max(tmpVec.z, maxZ); } float distz = maxZ - minZ; orthoProjMatrix.setOrtho(minX, maxX, minY, maxY, 0, distz); } \u8bb0\u4f4f\uff0c\u6b63\u4ea4\u6295\u5f71\u5c31\u50cf\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5e94\u8be5\u5305\u542b\u6240\u6709\u5c06\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u3002\u8be5\u8fb9\u754c\u6846\u4ee5\u5149\u7167\u89c6\u56fe\u5750\u6807\u7a7a\u95f4\u8868\u793a\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u8ba1\u7b97\u5305\u56f4\u89c6\u9525\u4f53\u7684\u6700\u5c0f\u8fb9\u754c\u6846\uff0c\u8f74\u4e0e\u5149\u6e90\u4f4d\u7f6e\u5bf9\u9f50\u3002 Renderer \u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u4f7f\u7528\u89c6\u56fe\u5305\u4e2d\u7684\u7c7b\u4ee5\u53ca\u4fee\u6539\u4f20\u9012\u7ed9\u6e32\u67d3\u5668\u7684\u4fe1\u606f\u3002\u5728\u6e32\u67d3\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u6a21\u578b\u3001\u6a21\u578b\u89c2\u5bdf\u548c\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u6216\u5149\u7167\u89c6\u56fe\u77e9\u9635\u6765\u51cf\u5c11\u64cd\u4f5c\u7684\u6570\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9009\u62e9\u7b80\u5316\u8981\u4f20\u9012\u7684\u5143\u7d20\u7684\u6570\u91cf\uff0c\u73b0\u5728\u53ea\u5c06\u6a21\u578b\u3001\u89c2\u5bdf\u548c\u5149\u7167\u77e9\u9635\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u6b64\u5916\uff0c\u5bf9\u4e8e\u7c92\u5b50\uff0c\u6211\u4eec\u9700\u8981\u4fdd\u7559\u6bd4\u4f8b\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u518d\u4f20\u9012\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u6240\u4ee5\u73b0\u5728\u4fe1\u606f\u5c06\u4e22\u5931\u3002\u6211\u4eec\u91cd\u7528\u7528\u4e8e\u6807\u8bb0\u6240\u9009\u9879\u7684\u5c5e\u6027\u6765\u8bbe\u7f6e\u6bd4\u4f8b\u4fe1\u606f\u3002\u5728\u7c92\u5b50\u7740\u8272\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u503c\u518d\u6b21\u8bbe\u7f6e\u7f29\u653e\u3002 \u5728\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u8ba1\u7b97\u6a21\u578b\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5e76\u5c06\u5176\u4f5c\u4e3a\u8f93\u51fa\u4f20\u9012\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 mvVertexPos = mvPos.xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * vec4(position, 1.0); } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u503c\u6839\u636e\u7247\u5143\u6240\u5904\u7684\u90e8\u5206\u6765\u67e5\u8be2\u9002\u5f53\u7684\u6df1\u5ea6\u56fe\u3002\u8fd9\u9700\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u7279\u5b9a\u9879\u76ee\uff0c\u5b83\u4eec\u7684\u7247\u5143\u53ef\u80fd\u4f4d\u4e8e\u4e0d\u540c\u7684\u90e8\u5206\u4e2d\u3002 \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5fc5\u987b\u51b3\u5b9a\u8981\u5206\u6210\u54ea\u4e2a\u90e8\u5206\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u4f7f\u7528\u7247\u5143\u7684Z\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u6bcf\u4e2a\u90e8\u5206\u7684\u6700\u5927Z\u503c\u8fdb\u884c\u6bd4\u8f83\uff0c\u4e5f\u5c31\u662f\u8fdcZ\u5e73\u9762\u503c\u3002\u8fd9\u4e9b\u6570\u636e\u4f5c\u4e3a\u4e00\u4e2a\u65b0\u7684Uniform\u4f20\u9012\uff1a uniform float cascadeFarPlanes[NUM_CASCADES]; \u5982\u4e0b\u6240\u793a\uff0c\u6211\u4eec\u8ba1\u7b97\u5206\u5272\u7684\u90e8\u5206\uff0c\u53d8\u91cf idx \u5c06\u50a8\u5b58\u8981\u4f7f\u7528\u7684\u90e8\u5206\uff1a int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } \u6b64\u5916\uff0c\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u7eb9\u7406\u6570\u7ec4\uff0c\u4e00\u4e2a sampler2D \u6570\u7ec4\uff0c\u7528\u4e8e\u6df1\u5ea6\u56fe\uff0c\u5373\u4e0e\u6211\u4eec\u5206\u5272\u90e8\u5206\u76f8\u5173\u8054\u7684\u7eb9\u7406\u3002\u6e90\u4ee3\u7801\u7528\u4e00\u4e2aUniform\u5217\u8868\uff08\u800c\u4e0d\u662f\u4f7f\u7528\u6570\u7ec4\uff09\u50a8\u5b58\u7528\u4e8e\u5f15\u7528\u4e0e\u6bcf\u4e2a\u90e8\u5206\u5173\u8054\u7684\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u5355\u5143\u3002 uniform sampler2D normalMap; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; \u5c06\u5176\u66f4\u6539\u4e3a\u4e00\u7ec4Uniform\u4f1a\u5bfc\u81f4\u96be\u4ee5\u8ffd\u8e2a\u6b64\u793a\u4f8b\u7684\u5176\u4ed6\u7eb9\u7406\u51fa\u73b0\u7684\u95ee\u9898\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u5c1d\u8bd5\u5728\u4ee3\u7801\u4e2d\u4fee\u6539\u5b83\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4f59\u4fee\u6539\u548c\u7740\u8272\u5668\u53ea\u662f\u57fa\u4e8e\u4e0a\u8ff0\u66f4\u6539\u6240\u9700\u7684\u8c03\u6574\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u6700\u540e\uff0c\u5f53\u5f15\u5165\u8fd9\u4e9b\u66f4\u6539\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u6027\u80fd\u4e0b\u964d\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u7ed8\u5236\u7684\u6df1\u5ea6\u56fe\u662f\u6b64\u524d\u7684\u4e09\u500d\u3002\u5982\u679c\u6444\u50cf\u673a\u672a\u88ab\u79fb\u52a8\u6216\u573a\u666f\u9879\u672a\u53d1\u751f\u66f4\u6539\uff0c\u5219\u4e0d\u9700\u8981\u53cd\u590d\u6e32\u67d3\u6df1\u5ea6\u56fe\u3002\u6df1\u5ea6\u56fe\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u6e05\u9664\u5b83\u4eec\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5728 render \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u53d8\u91cf\uff0c\u7528\u4e8e\u6307\u793a\u662f\u5426\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4ee5\u907f\u514d\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4f7f\u5176\u4fdd\u6301\u4e0d\u53d8\uff0c\u8fd9\u4f1a\u663e\u8457\u63d0\u9ad8FPS\u3002\u6700\u7ec8\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a","title":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04"},{"location":"26-cascaded-shadow-maps/#cascaded-shadow-maps","text":"\u5728\u9634\u5f71\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u4ecb\u7ecd\u4e86\u9634\u5f71\u6620\u5c04\u6280\u672f\uff0c\u4ee5\u4fbf\u5728\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u65f6\u4f7f\u7528\u5e73\u884c\u5149\u663e\u793a\u9634\u5f71\u3002\u6b64\u524d\u4ecb\u7ecd\u7684\u65b9\u6848\u4e2d\u8981\u6c42\u4f60\u624b\u52a8\u8c03\u6574\u4e00\u4e9b\u53c2\u6570\u4ee5\u6539\u8fdb\u6548\u679c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4fee\u6539\u8be5\u6280\u672f\uff0c\u4ee5\u81ea\u52a8\u5316\u6240\u6709\u6d41\u7a0b\uff0c\u5e76\u6539\u8fdb\u5728\u5f00\u653e\u7a7a\u95f4\u4e2d\u7684\u6548\u679c\u3002\u4e3a\u4e86\u8fbe\u5230\u76ee\u7684\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CMS\uff0cCascaded Shadow Map\uff09\u7684\u6280\u672f\u3002 \u8ba9\u6211\u4eec\u9996\u5148\u770b\u4e00\u4e0b\u5982\u4f55\u81ea\u52a8\u6784\u9020\u7528\u4e8e\u6e32\u67d3\u9634\u5f71\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u5982\u679c\u4f60\u56de\u60f3\u9634\u5f71\u4e00\u7ae0\uff0c\u6211\u4eec\u9700\u8981\u4ece\u5149\u7ebf\u7684\u89d2\u5ea6\u6765\u7ed8\u5236\u573a\u666f\u3002\u8fd9\u610f\u5473\u7740\u521b\u5efa\u4e00\u4e2a\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5b83\u5c31\u50cf\u4e00\u4e2a\u4f5c\u7528\u4e8e\u5149\u6e90\u7684\u6444\u50cf\u673a\u548c\u4e00\u4e2a\u6295\u5f71\u77e9\u9635\u3002\u7531\u4e8e\u5149\u662f\u5b9a\u5411\u7684\uff0c\u800c\u4e14\u5e94\u8be5\u4f4d\u4e8e\u65e0\u7a77\u8fdc\u5904\uff0c\u6240\u4ee5\u6211\u4eec\u9009\u62e9\u4e86\u6b63\u4ea4\u6295\u5f71\u3002 \u6211\u4eec\u5e0c\u671b\u6240\u6709\u53ef\u89c1\u7684\u7269\u4f53\u90fd\u9002\u7528\u4e8e\u5149\u7167\u89c6\u56fe\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5c06\u89c6\u622a\u9525\u653e\u5165\u5149\u622a\u9525\u4e2d\u3002\u4e0b\u56fe\u662f\u6211\u4eec\u6700\u7ec8\u60f3\u8981\u5b9e\u73b0\u7684\u6548\u679c\uff1a \u8be5\u5982\u4f55\u6784\u9020\u5b83\uff1f\u9996\u5148\u662f\u8ba1\u7b97\u89c2\u5bdf\u6295\u5f71\u77e9\u9635\u7684\u622a\u9525\u9876\u70b9\u3002\u6211\u4eec\u5f97\u5230\u4e16\u754c\u7a7a\u95f4\u7684\u5750\u6807\uff0c\u7136\u540e\u8ba1\u7b97\u8fd9\u4e2a\u622a\u9525\u7684\u4e2d\u5fc3\uff0c\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06\u6240\u6709\u7684\u9876\u70b9\u7684\u5750\u6807\u76f8\u52a0\u5e76\u5c06\u7ed3\u679c\u9664\u4ee5\u9876\u70b9\u7684\u6570\u91cf\u6765\u8ba1\u7b97\u3002 \u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u8bbe\u7f6e\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u5176\u4f4d\u7f6e\u53ca\u5176\u65b9\u5411\u5c06\u7528\u4e8e\u6784\u5efa\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u4f4d\u7f6e\uff0c\u6211\u4eec\u4ece\u6b64\u524d\u5f97\u5230\u7684\u89c6\u9525\u4f53\u7684\u4e2d\u5fc3\u5f00\u59cb\uff0c\u9006\u7740\u5149\u7684\u65b9\u5411\uff0c\u53d6\u76f8\u5f53\u4e8e\u89c6\u9525\u4f53\u7684\u8fd1Z\u5e73\u9762\u548c\u8fdcZ\u5e73\u9762\u7684\u8ddd\u79bb\u7684\u4e00\u70b9\u3002 \u6784\u5efa\u5b8c\u6210\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u6211\u4eec\u9700\u8981\u8bbe\u7f6e\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u4e3a\u4e86\u8ba1\u7b97\u5b83\u4eec\uff0c\u6211\u4eec\u5c06\u622a\u9525\u7684\u9876\u70b9\u8f6c\u6362\u5230\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\uff0c\u53ea\u9700\u8981\u5c06\u5b83\u4eec\u4e58\u4ee5\u521a\u521a\u6784\u5efa\u7684\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u6295\u5f71\u77e9\u9635\u7684\u5c3a\u5bf8\u662f\u6700\u5927\u548c\u6700\u5c0f\u7684X\u548cY\u503c\uff0c\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u4e0e\u6807\u51c6\u6295\u5f71\u77e9\u9635\u76f8\u540c\u7684\u503c\uff0c\u8fdcZ\u5e73\u9762\u5219\u662f\u5149\u7167\u89c6\u56fe\u7a7a\u95f4\u4e2d\u622a\u9525\u9876\u70b9\u7684\u6700\u5927\u548c\u6700\u5c0fZ\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 \u4f46\u662f\uff0c\u5982\u679c\u5728\u9634\u5f71\u793a\u4f8b\u4ee3\u7801\u7684\u57fa\u7840\u4e0a\u5b9e\u73b0\u4e0a\u8ff0\u7b97\u6cd5\uff0c\u5219\u53ef\u80fd\u4f1a\u5bf9\u9634\u5f71\u8d28\u91cf\u611f\u5230\u5931\u671b\u3002 \u539f\u56e0\u662f\u9634\u5f71\u5206\u8fa8\u7387\u53d7\u7eb9\u7406\u5927\u5c0f\u7684\u9650\u5236\u3002\u6211\u4eec\u73b0\u5728\u6b63\u8986\u76d6\u4e00\u4e2a\u6f5c\u5728\u7684\u5de8\u5927\u533a\u57df\uff0c\u5e76\u4e14\u6211\u4eec\u7528\u6765\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u6ca1\u6709\u8db3\u591f\u7684\u5206\u8fa8\u7387\u6765\u53d6\u5f97\u826f\u597d\u7684\u6548\u679c\u3002\u4f60\u53ef\u80fd\u8ba4\u4e3a\u89e3\u51b3\u65b9\u6cd5\u53ea\u662f\u63d0\u9ad8\u7eb9\u7406\u5206\u8fa8\u7387\uff0c\u4f46\u8fd9\u5e76\u4e0d\u8db3\u4ee5\u5b8c\u5168\u89e3\u51b3\u95ee\u9898\uff0c\u4f60\u9700\u8981\u5de8\u5927\u7684\u7eb9\u7406\u3002 \u6709\u4e00\u4e2a\u66f4\u806a\u660e\u7684\u89e3\u51b3\u65b9\u6848\u3002\u5176\u5173\u952e\u662f\uff0c\u9760\u8fd1\u6444\u50cf\u673a\u7684\u7269\u4f53\u9700\u8981\u6bd4\u8fdc\u5904\u7269\u4f53\u7684\u9634\u5f71\u6709\u66f4\u9ad8\u7684\u8d28\u91cf\u3002\u4e00\u79cd\u65b9\u6cd5\u662f\u53ea\u6e32\u67d3\u9760\u8fd1\u6444\u50cf\u673a\u7684\u5bf9\u8c61\u7684\u9634\u5f71\uff0c\u4f46\u8fd9\u4f1a\u5bfc\u81f4\u9634\u5f71\u5728\u573a\u666f\u4e2d\u79fb\u52a8\u65f6\u51fa\u73b0\u6216\u6d88\u5931\u3002 \u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08CSM\uff09\u4f7f\u7528\u7684\u65b9\u6cd5\u662f\u5c06\u89c6\u9525\u4f53\u5206\u5272\u4e3a\u591a\u4e2a\u90e8\u5206\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u8f83\u5c0f\u7684\u533a\u57df\uff0c\u800c\u8ddd\u79bb\u8f83\u8fdc\u7684\u90e8\u5206\u4f1a\u8986\u76d6\u66f4\u5e7f\u7684\u533a\u57df\u3002\u4e0b\u56fe\u663e\u793a\u4e86\u628a\u4e00\u4e2a\u89c6\u9525\u4f53\u5206\u4e3a\u4e09\u4e2a\u90e8\u5206\u3002 \u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff0c\u5c06\u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\uff0c\u8c03\u6574\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u4ee5\u5408\u9002\u5730\u8986\u76d6\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u3002\u56e0\u6b64\uff0c\u50a8\u5b58\u6df1\u5ea6\u6620\u5c04\u7684\u7eb9\u7406\u8986\u76d6\u89c6\u9525\u4f53\u7684\u533a\u57df\u7f29\u5c0f\u4e86\u3002\u800c\u4e14\uff0c\u7531\u4e8e\u79bb\u6444\u50cf\u673a\u6700\u8fd1\u7684\u90e8\u5206\u4f1a\u5360\u7528\u8f83\u5c11\u7684\u7a7a\u95f4\uff0c\u56e0\u6b64\u6df1\u5ea6\u5206\u8fa8\u7387\u4f1a\u63d0\u9ad8\u3002 \u4ece\u4e0a\u8ff0\u89e3\u91ca\u53ef\u4ee5\u770b\u51fa\uff0c\u6211\u4eec\u9700\u8981\u5c3d\u53ef\u80fd\u591a\u7684\u5c06\u6df1\u5ea6\u56fe\u8fdb\u884c\u5206\u5272\uff0c\u6211\u4eec\u8fd8\u5c06\u66f4\u6539\u6bcf\u4e2a\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002\u56e0\u6b64\uff0c\u8981\u4f7f\u7528CSM\u9700\u8981\u505a\u7684\u4e8b\u60c5\u662f\uff1a \u5c06\u89c6\u9525\u4f53\u5206\u4e3an\u4e2a\u90e8\u5206\u3002 \u6e32\u67d3\u6df1\u5ea6\u7eb9\u7406\u65f6\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u90e8\u5206\uff1a \u8ba1\u7b97\u5149\u7167\u89c6\u56fe\u548c\u6295\u5f71\u77e9\u9635\u3002 \u4ece\u5149\u6e90\u7684\u89d2\u5ea6\u5c06\u573a\u666f\u6e32\u67d3\u4e3a\u5355\u72ec\u7684\u6df1\u5ea6\u56fe\u3002 \u6e32\u67d3\u573a\u666f\u65f6\uff1a \u4f7f\u7528\u6b64\u524d\u8ba1\u7b97\u7684\u6df1\u5ea6\u56fe\u3002 \u786e\u5b9a\u8981\u7ed8\u5236\u7684\u7247\u6bb5\u6240\u5c5e\u7684\u90e8\u5206\u3002 \u8ba1\u7b97\u9634\u5f71\u56e0\u5b50\uff0c\u5982\u9634\u5f71\u6620\u5c04\u4e2d\u6240\u8ff0\u3002 \u5982\u4f60\u6240\u89c1\uff0cCSM\u7684\u4e3b\u8981\u7f3a\u70b9\u662f\u6211\u4eec\u9700\u8981\u4ece\u706f\u5149\u7684\u89d2\u5ea6\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6e32\u67d3\u573a\u666f\u3002\u8fd9\u5c31\u662f\u4e3a\u4ec0\u4e48\u901a\u5e38\u53ea\u7528\u4e8e\u5f00\u653e\u7a7a\u95f4\u7684\u539f\u56e0\u3002\u4e0d\u7ba1\u600e\u4e48\u8bf4\uff0c\u6211\u4eec\u5c06\u53ef\u4ee5\u770b\u5230\u5982\u4f55\u8f7b\u677e\u5730\u51cf\u5c11\u5f00\u9500\u3002 \u6240\u4ee5\uff0c\u8ba9\u6211\u4eec\u770b\u770b\u4ee3\u7801\u3002\u4f46\u662f\u5728\u7ee7\u7eed\u4e4b\u524d\uff0c\u6709\u4e00\u4e2a\u5c0f\u5c0f\u7684\u63d0\u9192\uff0c\u6211\u4e0d\u4f1a\u5728\u8fd9\u91cc\u5199\u4e0a\u5b8c\u6574\u7684\u6e90\u4ee3\u7801\uff0c\u56e0\u4e3a\u8fd9\u4f1a\u975e\u5e38\u67af\u71e5\u3002\u76f8\u53cd\uff0c\u6211\u5c06\u4ecb\u7ecd\u4e3b\u8981\u7c7b\u3001\u5b83\u4eec\u7684\u804c\u8d23\u548c\u53ef\u80fd\u9700\u8981\u8fdb\u4e00\u6b65\u89e3\u91ca\u7684\u7247\u6bb5\uff0c\u4ee5\u4fbf\u66f4\u597d\u5730\u7406\u89e3\u3002\u6240\u6709\u4e0e\u7740\u8272\u76f8\u5173\u7684\u7c7b\u90fd\u5df2\u79fb\u52a8\u5230\u4e00\u4e2a\u540d\u4e3a org.lwjglb.engine.graph.shadow \u7684\u65b0\u5305\u4e2d\u3002 \u6e32\u67d3\u9634\u5f71\u7684\u4ee3\u7801\uff0c\u6362\u53e5\u8bdd\u8bf4\uff0c\u4ece\u5149\u5f71\u900f\u89c6\u7684\u573a\u666f\u5df2\u7ecf\u79fb\u52a8\u5230\u4e86 ShadowRenderer \u7c7b\u4e2d\u3002\uff08\u8be5\u4ee3\u7801\u4ee5\u524d\u5728 Renderer \u7c7b\u4e2d\uff09\u3002 \u7c7b\u5b9a\u4e49\u4e86\u4ee5\u4e0b\u5e38\u91cf\uff1a public static final int NUM_CASCADES = 3; public static final float[] CASCADE_SPLITS = new float[]{Window.Z_FAR / 20.0f, Window.Z_FAR / 10.0f, Window.Z_FAR}; \u9996\u5148\u662f\u5c42\u7ea7\u6216\u62c6\u5206\u7684\u6570\u91cf\u3002\u7b2c\u4e8c\u4e2a\u5b9a\u4e49\u4e86\u6bcf\u4e2a\u62c6\u5206\u7684\u90e8\u5206\u7684\u8fdcZ\u5e73\u9762\u7684\u4f4d\u7f6e\u3002\u5982\u4f60\u6240\u89c1\uff0c\u5b83\u4eec\u7684\u95f4\u8ddd\u5e76\u4e0d\u76f8\u7b49\u3002\u79bb\u6444\u50cf\u673a\u8f83\u8fd1\u7684\u90e8\u5206\u5728Z\u5e73\u9762\u4e0a\u7684\u8ddd\u79bb\u6700\u77ed\u3002 \u7c7b\u8fd8\u50a8\u5b58\u4e86\u7528\u4e8e\u6e32\u67d3\u6df1\u5ea6\u56fe\u7684\u7740\u8272\u5668\u7a0b\u5e8f\u7684\u5f15\u7528\uff0c\u4e00\u4e2a\u5217\u8868\uff0c\u5176\u4e2d\u5305\u542b\u4e0e\u6bcf\u4e2a\u90e8\u5206\u76f8\u5173\u8054\u7684\u4fe1\u606f\uff0c\u5176\u7531 ShadowCascade \u7c7b\u5b9a\u4e49\uff0c\u4ee5\u53ca\u5bf9\u50a8\u5b58\u6df1\u5ea6\u56fe\u6570\u636e\uff08\u7eb9\u7406\uff09\u7684\u5bf9\u8c61\u7684\u5f15\u7528\uff0c\u7531 ShadowBuffer \u7c7b\u5b9a\u4e49\u3002 ShadowRenderer \u7c7b\u5177\u6709\u7528\u4e8e\u8bbe\u7f6e\u7740\u8272\u5668\u548c\u6240\u9700\u5c5e\u6027\u7684\u65b9\u6cd5\u4ee5\u53ca\u4e00\u4e2a\u6e32\u67d3\u65b9\u6cd5\u3002 render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a public void render(Window window, Scene scene, Camera camera, Transformation transformation, Renderer renderer) { update(window, camera.getViewMatrix(), scene); // \u8bbe\u7f6e\u89c6\u53e3\u4ee5\u5339\u914d\u7eb9\u7406\u5927\u5c0f glBindFramebuffer(GL_FRAMEBUFFER, shadowBuffer.getDepthMapFBO()); glViewport(0, 0, ShadowBuffer.SHADOW_MAP_WIDTH, ShadowBuffer.SHADOW_MAP_HEIGHT); glClear(GL_DEPTH_BUFFER_BIT); depthShaderProgram.bind(); // \u4e3a\u6bcf\u5c42\u56fe\u6e32\u67d3\u573a\u666f for (int i = 0; i < NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); depthShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix()); depthShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix()); glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); glClear(GL_DEPTH_BUFFER_BIT); renderNonInstancedMeshes(scene, transformation); renderInstancedMeshes(scene, transformation); } // \u89e3\u7ed1 depthShaderProgram.unbind(); glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u6267\u884c\u7684\u51e0\u4e2a\u6e32\u67d3\u8fc7\u7a0b\uff0c\u7c7b\u4f3c\u4e8e\u6b64\u524d\u9634\u5f71\u56fe\u7684\u6e32\u67d3\u65b9\u6cd5\u3002\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u4f1a\u4f7f\u7528\u76f8\u5173\u7684 ShadowCascade \u5b9e\u4f8b\u4e2d\u4fdd\u51fd\u7684\u4fe1\u606f\u66f4\u6539\u5149\u7167\u89c6\u56fe\u77e9\u9635\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002 \u6b64\u5916\uff0c\u5728\u6bcf\u6b21\u6267\u884c\u4e2d\uff0c\u6211\u4eec\u90fd\u9700\u8981\u66f4\u6539\u6b63\u5728\u4f7f\u7528\u7684\u7eb9\u7406\u3002\u6bcf\u6b21\u90fd\u4f1a\u5c06\u6df1\u5ea6\u4fe1\u606f\u6e32\u67d3\u4e3a\u4e0d\u540c\u7684\u7eb9\u7406\u3002\u6b64\u4fe1\u606f\u50a8\u5b58\u5728 ShadowBuffer \u7c7b\u4e2d\uff0c\u5e76\u8bbe\u7f6e\u4e3a\u4f9bFBO\u4f7f\u7528\uff0c\u4ee3\u7801\u5982\u4e0b\uff1a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_TEXTURE_2D, shadowBuffer.getDepthMapTexture().getIds()[i], 0); \u6b63\u5982\u521a\u521a\u63d0\u5230\u7684\uff0c ShadowBuffer \u7c7b\u50a8\u5b58\u4e0e\u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u4fe1\u606f\u7684\u7eb9\u7406\u76f8\u5173\u7684\u4fe1\u606f\u3002\u4ee3\u7801\u4e0e\u9634\u5f71\u7ae0\u8282\u4e2d\u4f7f\u7528\u7684\u4ee3\u7801\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u6211\u4eec\u4f7f\u7528\u7684\u662f\u7eb9\u7406\u6570\u7ec4\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684\u7c7b ArrTexture \uff0c\u5b83\u521b\u5efa\u4e86\u4e00\u4e2a\u5177\u6709\u76f8\u540c\u5c5e\u6027\u7684\u7eb9\u7406\u6570\u7ec4\u3002\u6b64\u7c7b\u8fd8\u63d0\u4f9b\u4e86\u4e00\u4e2a bind \u65b9\u6cd5\uff0c\u7528\u4e8e\u7ed1\u5b9a\u6240\u6709\u7eb9\u7406\u6570\u7ec4\uff0c\u4ee5\u4fbf\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u8be5\u65b9\u6cd5\u63a5\u6536\u4e00\u4e2a\u53c2\u6570\uff0c\u4ece\u67d0\u4e2a\u7eb9\u7406\u5355\u5143\u5f00\u59cb\u7ed1\u5b9a\u3002 public void bindTextures(int start) { for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { glActiveTexture(start + i); glBindTexture(GL_TEXTURE_2D, depthMap.getIds()[i]); } } ShadowCascade \u7c7b\u50a8\u5b58\u4e0e\u4e00\u4e2a\u90e8\u5206\u5173\u8054\u7684\u5149\u7167\u89c6\u56fe\u548c\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u6bcf\u4e2a\u5206\u5272\u7684\u90e8\u5206\u7531\u4e00\u4e2a\u8fd1Z\u5e73\u9762\u8ddd\u79bb\u548c\u4e00\u4e2a\u8fdcZ\u5e73\u9762\u8ddd\u79bb\u5b9a\u4e49\uff0c\u5e76\u6839\u636e\u8be5\u4fe1\u606f\u8ba1\u7b97\u77e9\u9635\u3002 \u8be5\u7c7b\u63d0\u4f9b\u5e76\u66f4\u65b0\u4e86\u4ee5\u89c2\u5bdf\u77e9\u9635\u548c\u5149\u7167\u65b9\u5411\u4e3a\u8f93\u5165\u7684\u65b9\u6cd5\uff0c\u8be5\u65b9\u6cd5\u9996\u5148\u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u89c6\u9525\u9876\u70b9\uff0c\u7136\u540e\u8ba1\u7b97\u51fa\u5149\u6e90\u7684\u4f4d\u7f6e\u3002\u6839\u636e\u5149\u7684\u65b9\u5411\uff0c\u4ece\u622a\u9525\u7684\u4e2d\u5fc3\u5230\u76f8\u5f53\u4e8e\u8fdcZ\u5e73\u9762\u5230\u8fd1Z\u5e73\u9762\u4e4b\u95f4\u7684\u8ddd\u79bb\u7684\u8ddd\u79bb\uff0c\u8ba1\u7b97\u51fa\u8be5\u4f4d\u7f6e\u3002 public void update(Window window, Matrix4f viewMatrix, DirectionalLight light) { // \u4e3a\u6b64\u5c42\u751f\u6210\u6295\u5f71\u8bc6\u56fe\u77e9\u9635 float aspectRatio = (float) window.getWidth() / (float) window.getHeight(); projViewMatrix.setPerspective(Window.FOV, aspectRatio, zNear, zFar); projViewMatrix.mul(viewMatrix); // \u8ba1\u7b97\u4e16\u754c\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u9876\u70b9 float maxZ = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; corner.set(0, 0, 0); projViewMatrix.frustumCorner(i, corner); centroid.add(corner); centroid.div(8.0f); minZ = Math.min(minZ, corner.z); maxZ = Math.max(maxZ, corner.z); } // \u4ece\u8d28\u5fc3\u9006\u7740\u5149\u7684\u65b9\u5411\u4e0amax.z-min.z\u7684\u8ddd\u79bb Vector3f lightDirection = light.getDirection(); Vector3f lightPosInc = new Vector3f().set(lightDirection); float distance = maxZ - minZ; lightPosInc.mul(distance); Vector3f lightPosition = new Vector3f(); lightPosition.set(centroid); lightPosition.add(lightPosInc); updateLightViewMatrix(lightDirection, lightPosition); updateLightProjectionMatrix(); } \u6839\u636e\u5149\u6e90\u7684\u4f4d\u7f6e\u548c\u65b9\u5411\uff0c\u6211\u4eec\u53ef\u4ee5\u6784\u9020\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightViewMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void updateLightViewMatrix(Vector3f lightDirection, Vector3f lightPosition) { float lightAngleX = (float) Math.toDegrees(Math.acos(lightDirection.z)); float lightAngleY = (float) Math.toDegrees(Math.asin(lightDirection.x)); float lightAngleZ = 0; Transformation.updateGenericViewMatrix(lightPosition, new Vector3f(lightAngleX, lightAngleY, lightAngleZ), lightViewMatrix); } \u6700\u540e\uff0c\u6211\u4eec\u9700\u8981\u6784\u9020\u6b63\u4ea4\u6295\u5f71\u77e9\u9635\u3002\u8fd9\u662f\u5728 updateLightProjectionMatrix \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8be5\u65b9\u6cd5\u5c06\u89c6\u9525\u4f53\u5750\u6807\u8f6c\u6362\u5230\u5149\u7167\u7a7a\u95f4\u3002\u7136\u540e\u6211\u4eec\u5f97\u5230x\u3001y\u5750\u6807\u7684\u6700\u5c0f\u503c\u548c\u6700\u5927\u503c\u6765\u6784\u9020\u5305\u56f4\u89c6\u9525\u4f53\u7684\u8fb9\u754c\u6846\u3002\u8fd1Z\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a0\uff0c\u8fdcZ\u5e73\u9762\u53ef\u4ee5\u8bbe\u7f6e\u4e3a\u5750\u6807\u7684\u6700\u5927\u503c\u548c\u6700\u5c0f\u503c\u4e4b\u95f4\u7684\u8ddd\u79bb\u3002 private void updateLightProjectionMatrix() { // \u73b0\u5728\u8ba1\u7b97\u5149\u7167\u7a7a\u95f4\u4e2d\u7684\u622a\u9525\u5927\u5c0f\u3002 float minX = Float.MAX_VALUE; float maxX = -Float.MAX_VALUE; float minY = Float.MAX_VALUE; float maxY = -Float.MAX_VALUE; float minZ = Float.MAX_VALUE; float maxZ = -Float.MAX_VALUE; for (int i = 0; i < FRUSTUM_CORNERS; i++) { Vector3f corner = frustumCorners[i]; tmpVec.set(corner, 1); tmpVec.mul(lightViewMatrix); minX = Math.min(tmpVec.x, minX); maxX = Math.max(tmpVec.x, maxX); minY = Math.min(tmpVec.y, minY); maxY = Math.max(tmpVec.y, maxY); minZ = Math.min(tmpVec.z, minZ); maxZ = Math.max(tmpVec.z, maxZ); } float distz = maxZ - minZ; orthoProjMatrix.setOrtho(minX, maxX, minY, maxY, 0, distz); } \u8bb0\u4f4f\uff0c\u6b63\u4ea4\u6295\u5f71\u5c31\u50cf\u4e00\u4e2a\u8fb9\u754c\u6846\uff0c\u5e94\u8be5\u5305\u542b\u6240\u6709\u5c06\u8981\u6e32\u67d3\u7684\u5bf9\u8c61\u3002\u8be5\u8fb9\u754c\u6846\u4ee5\u5149\u7167\u89c6\u56fe\u5750\u6807\u7a7a\u95f4\u8868\u793a\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u8981\u505a\u7684\u662f\u8ba1\u7b97\u5305\u56f4\u89c6\u9525\u4f53\u7684\u6700\u5c0f\u8fb9\u754c\u6846\uff0c\u8f74\u4e0e\u5149\u6e90\u4f4d\u7f6e\u5bf9\u9f50\u3002 Renderer \u7c7b\u5df2\u88ab\u4fee\u6539\u4e3a\u4f7f\u7528\u89c6\u56fe\u5305\u4e2d\u7684\u7c7b\u4ee5\u53ca\u4fee\u6539\u4f20\u9012\u7ed9\u6e32\u67d3\u5668\u7684\u4fe1\u606f\u3002\u5728\u6e32\u67d3\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u6a21\u578b\u3001\u6a21\u578b\u89c2\u5bdf\u548c\u5149\u7167\u89c6\u56fe\u77e9\u9635\u3002\u5728\u6b64\u524d\u7684\u7ae0\u8282\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u6a21\u578b\u89c2\u5bdf\u6216\u5149\u7167\u89c6\u56fe\u77e9\u9635\u6765\u51cf\u5c11\u64cd\u4f5c\u7684\u6570\u91cf\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u9009\u62e9\u7b80\u5316\u8981\u4f20\u9012\u7684\u5143\u7d20\u7684\u6570\u91cf\uff0c\u73b0\u5728\u53ea\u5c06\u6a21\u578b\u3001\u89c2\u5bdf\u548c\u5149\u7167\u77e9\u9635\u4f20\u9012\u7ed9\u7740\u8272\u5668\u3002\u6b64\u5916\uff0c\u5bf9\u4e8e\u7c92\u5b50\uff0c\u6211\u4eec\u9700\u8981\u4fdd\u7559\u6bd4\u4f8b\uff0c\u56e0\u4e3a\u6211\u4eec\u4e0d\u518d\u4f20\u9012\u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff0c\u6240\u4ee5\u73b0\u5728\u4fe1\u606f\u5c06\u4e22\u5931\u3002\u6211\u4eec\u91cd\u7528\u7528\u4e8e\u6807\u8bb0\u6240\u9009\u9879\u7684\u5c5e\u6027\u6765\u8bbe\u7f6e\u6bd4\u4f8b\u4fe1\u606f\u3002\u5728\u7c92\u5b50\u7740\u8272\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528\u8be5\u503c\u518d\u6b21\u8bbe\u7f6e\u7f29\u653e\u3002 \u5728\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4e3a\u6bcf\u4e2a\u90e8\u5206\u8ba1\u7b97\u6a21\u578b\u5149\u7167\u89c6\u56fe\u77e9\u9635\uff0c\u5e76\u5c06\u5176\u4f5c\u4e3a\u8f93\u51fa\u4f20\u9012\u7ed9\u7247\u5143\u7740\u8272\u5668\u3002 mvVertexPos = mvPos.xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * vec4(position, 1.0); } \u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u4f7f\u7528\u8fd9\u4e9b\u503c\u6839\u636e\u7247\u5143\u6240\u5904\u7684\u90e8\u5206\u6765\u67e5\u8be2\u9002\u5f53\u7684\u6df1\u5ea6\u56fe\u3002\u8fd9\u9700\u8981\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5b8c\u6210\uff0c\u56e0\u4e3a\u5bf9\u4e8e\u7279\u5b9a\u9879\u76ee\uff0c\u5b83\u4eec\u7684\u7247\u5143\u53ef\u80fd\u4f4d\u4e8e\u4e0d\u540c\u7684\u90e8\u5206\u4e2d\u3002 \u6b64\u5916\uff0c\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u5fc5\u987b\u51b3\u5b9a\u8981\u5206\u6210\u54ea\u4e2a\u90e8\u5206\u3002\u4e3a\u4e86\u5b9e\u73b0\u5b83\uff0c\u6211\u4eec\u4f7f\u7528\u7247\u5143\u7684Z\u503c\uff0c\u5e76\u5c06\u5176\u4e0e\u6bcf\u4e2a\u90e8\u5206\u7684\u6700\u5927Z\u503c\u8fdb\u884c\u6bd4\u8f83\uff0c\u4e5f\u5c31\u662f\u8fdcZ\u5e73\u9762\u503c\u3002\u8fd9\u4e9b\u6570\u636e\u4f5c\u4e3a\u4e00\u4e2a\u65b0\u7684Uniform\u4f20\u9012\uff1a uniform float cascadeFarPlanes[NUM_CASCADES]; \u5982\u4e0b\u6240\u793a\uff0c\u6211\u4eec\u8ba1\u7b97\u5206\u5272\u7684\u90e8\u5206\uff0c\u53d8\u91cf idx \u5c06\u50a8\u5b58\u8981\u4f7f\u7528\u7684\u90e8\u5206\uff1a int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } \u6b64\u5916\uff0c\u5728\u573a\u666f\u7740\u8272\u5668\u4e2d\uff0c\u6211\u4eec\u9700\u8981\u4f20\u9012\u4e00\u4e2a\u7eb9\u7406\u6570\u7ec4\uff0c\u4e00\u4e2a sampler2D \u6570\u7ec4\uff0c\u7528\u4e8e\u6df1\u5ea6\u56fe\uff0c\u5373\u4e0e\u6211\u4eec\u5206\u5272\u90e8\u5206\u76f8\u5173\u8054\u7684\u7eb9\u7406\u3002\u6e90\u4ee3\u7801\u7528\u4e00\u4e2aUniform\u5217\u8868\uff08\u800c\u4e0d\u662f\u4f7f\u7528\u6570\u7ec4\uff09\u50a8\u5b58\u7528\u4e8e\u5f15\u7528\u4e0e\u6bcf\u4e2a\u90e8\u5206\u5173\u8054\u7684\u6df1\u5ea6\u56fe\u7684\u7eb9\u7406\u5355\u5143\u3002 uniform sampler2D normalMap; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; \u5c06\u5176\u66f4\u6539\u4e3a\u4e00\u7ec4Uniform\u4f1a\u5bfc\u81f4\u96be\u4ee5\u8ffd\u8e2a\u6b64\u793a\u4f8b\u7684\u5176\u4ed6\u7eb9\u7406\u51fa\u73b0\u7684\u95ee\u9898\u3002\u5728\u4efb\u4f55\u60c5\u51b5\u4e0b\uff0c\u4f60\u90fd\u53ef\u4ee5\u5c1d\u8bd5\u5728\u4ee3\u7801\u4e2d\u4fee\u6539\u5b83\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4f59\u4fee\u6539\u548c\u7740\u8272\u5668\u53ea\u662f\u57fa\u4e8e\u4e0a\u8ff0\u66f4\u6539\u6240\u9700\u7684\u8c03\u6574\uff0c\u4f60\u53ef\u4ee5\u76f4\u63a5\u5728\u6e90\u4ee3\u7801\u4e0a\u67e5\u770b\u5b83\u3002 \u6700\u540e\uff0c\u5f53\u5f15\u5165\u8fd9\u4e9b\u66f4\u6539\u65f6\uff0c\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u6027\u80fd\u4e0b\u964d\uff0c\u8fd9\u662f\u56e0\u4e3a\u6211\u4eec\u7ed8\u5236\u7684\u6df1\u5ea6\u56fe\u662f\u6b64\u524d\u7684\u4e09\u500d\u3002\u5982\u679c\u6444\u50cf\u673a\u672a\u88ab\u79fb\u52a8\u6216\u573a\u666f\u9879\u672a\u53d1\u751f\u66f4\u6539\uff0c\u5219\u4e0d\u9700\u8981\u53cd\u590d\u6e32\u67d3\u6df1\u5ea6\u56fe\u3002\u6df1\u5ea6\u56fe\u50a8\u5b58\u5728\u7eb9\u7406\u4e2d\uff0c\u56e0\u6b64\u4e0d\u9700\u8981\u6bcf\u6b21\u6e32\u67d3\u8c03\u7528\u6e05\u9664\u5b83\u4eec\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u5728 render \u65b9\u6cd5\u4e2d\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u53d8\u91cf\uff0c\u7528\u4e8e\u6307\u793a\u662f\u5426\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4ee5\u907f\u514d\u66f4\u65b0\u6df1\u5ea6\u56fe\uff0c\u4f7f\u5176\u4fdd\u6301\u4e0d\u53d8\uff0c\u8fd9\u4f1a\u663e\u8457\u63d0\u9ad8FPS\u3002\u6700\u7ec8\uff0c\u4f60\u4f1a\u5f97\u5230\u8fd9\u6837\u7684\u6548\u679c\uff1a","title":"\u7ea7\u8054\u9634\u5f71\u6620\u5c04\uff08Cascaded Shadow Maps\uff09"},{"location":"27-assimp/","text":"Assimp\u5e93\uff08Assimp\uff09 \u9759\u6001\u7f51\u683c \u52a0\u8f7d\u4e0d\u540c\u683c\u5f0f\u7684\u590d\u6742\u4e09\u7ef4\u6a21\u578b\u7684\u529f\u80fd\u5bf9\u4e8e\u7f16\u5199\u6e38\u620f\u81f3\u5173\u91cd\u8981\uff0c\u4e3a\u5176\u4e2d\u4e00\u4e9b\u7f16\u5199\u89e3\u6790\u5668\u9700\u8981\u5927\u91cf\u7684\u5de5\u4f5c\uff0c\u5373\u4fbf\u53ea\u652f\u6301\u4e00\u79cd\u683c\u5f0f\u4e5f\u53ef\u80fd\u5f88\u8017\u65f6\u3002\u4f8b\u5982\uff0c\u5728\u7b2c\u4e5d\u7ae0\u4e2d\u63cf\u8ff0\u7684wavefront\u52a0\u8f7d\u5668\u53ea\u89e3\u6790\u4e86\u89c4\u8303\u4e2d\u7684\u4e00\u5c0f\u90e8\u5206\uff08\u6839\u672c\u4e0d\u5904\u7406\u6750\u8d28\uff09\u3002 \u5e78\u8fd0\u7684\u662f\uff0c\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528 Assimp \u5e93\u6765\u89e3\u6790\u8bb8\u591a\u5e38\u89c1\u76843D\u683c\u5f0f\u3002\u5b83\u662f\u4e00\u4e2aC++\u5e93\uff0c\u53ef\u4ee5\u4ee5\u5404\u79cd\u683c\u5f0f\u52a0\u8f7d\u9759\u6001\u548c\u52a8\u753b\u6a21\u578b\u3002LWJGL\u63d0\u4f9b\u4e86\u7ed1\u5b9a\u4ee5\u4fbf\u4eceJava\u4ee3\u7801\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u5b83\u3002 \u9996\u5148\u662f\u5c06Assimp\u7684Maven\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230 pom.xml \u6587\u4ef6\u4e2d\u3002\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u7f16\u8bd1\u65f6\u548c\u8fd0\u884c\u65f6\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> </dependency> <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u4e00\u65e6\u8bbe\u7f6e\u4e86\u4f9d\u8d56\u9879\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a StaticMeshesLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u7528\u4e8e\u52a0\u8f7d\u4e0d\u5e26\u52a8\u753b\u7684\u7f51\u683c\uff0c\u8be5\u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u9759\u6001\u516c\u5171\u65b9\u6cd5\uff1a public static Mesh[] load(String resourcePath, String texturesDir) throws Exception { return load(resourcePath, texturesDir, aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals); } public static Mesh[] load(String resourcePath, String texturesDir, int flags) throws Exception { // .... \u4e24\u79cd\u65b9\u6cd5\u90fd\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * resourcePath \uff1a\u6a21\u578b\u6587\u4ef6\u6240\u5728\u7684\u6587\u4ef6\u8def\u5f84\u3002\u8fd9\u662f\u4e00\u4e2a\u7edd\u5bf9\u8def\u5f84\uff0c\u56e0\u4e3aAssimp\u53ef\u80fd\u9700\u8981\u52a0\u8f7d\u5176\u4ed6\u6587\u4ef6\uff08\u4f8b\u5982wavefront\u3001OBJ\u7b49\u6587\u4ef6\u7684\u6750\u8d28\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u53ef\u80fd\u4f7f\u7528\u4e0e\u8d44\u6e90\u8def\u5f84\u76f8\u540c\u7684\u57fa\u8def\u5f84\u3002\u5982\u679c\u5c06\u8d44\u6e90\u5d4c\u5165JAR\u6587\u4ef6\u4e2d\uff0c\u90a3\u4e48assimp\u5c06\u65e0\u6cd5\u5bfc\u5165\u5b83\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u662f\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 * texturesDir \uff1a\u4fdd\u5b58\u6b64\u6a21\u578b\u7684\u6587\u4ef6\u5939\u8def\u5f84\u3002\u8fd9\u662fCLASSPATH\u7684\u76f8\u5bf9\u8def\u5f84\u3002\u4f8b\u5982\uff0cwavefront\u6750\u8d28\u6587\u4ef6\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u4ee3\u7801\u5e0c\u671b\u6b64\u6587\u4ef6\u4f4d\u4e8e texturesDir \u76ee\u5f55\u4e0b\u3002\u5982\u679c\u53d1\u73b0\u7eb9\u7406\u52a0\u8f7d\u9519\u8bef\uff0c\u53ef\u80fd\u9700\u8981\u5728\u6a21\u578b\u6587\u4ef6\u4e2d\u624b\u52a8\u8c03\u6574\u8fd9\u4e9b\u8def\u5f84\u3002 \u7b2c\u4e8c\u4e2a\u65b9\u6cd5\u6709\u4e00\u4e2a\u540d\u4e3a flags \u7684\u989d\u5916\u53c2\u6570\u3002\u6b64\u53c2\u6570\u5141\u8bb8\u8c03\u6574\u52a0\u8f7d\u8fc7\u7a0b\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u7b2c\u4e8c\u4e2a\u65b9\u6cd5\uff0c\u5e76\u4f20\u9012\u4e00\u4e9b\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u6709\u7528\u7684\u503c\uff1a * aiProcess_JoinIdenticalVertices \uff1a\u6b64\u6807\u8bb0\u5c06\u51cf\u5c11\u4f7f\u7528\u7684\u9876\u70b9\u6570\uff0c\u8bc6\u522b\u53ef\u5728\u9762\u4e4b\u95f4\u91cd\u7528\u7684\u9876\u70b9\u3002 * aiProcess_Triangulate \uff1a\u6a21\u578b\u53ef\u4ee5\u4f7f\u7528\u56db\u8fb9\u5f62\u6216\u5176\u4ed6\u51e0\u4f55\u56fe\u5f62\u6765\u5b9a\u4e49\u5b83\u4eec\u7684\u5143\u7d20\u3002\u7531\u4e8e\u6211\u4eec\u53ea\u5904\u7406\u4e09\u89d2\u5f62\uff0c\u56e0\u6b64\u5fc5\u987b\u4f7f\u7528\u6b64\u6807\u8bb0\u5c06\u6240\u6709\u7684\u9762\u62c6\u5206\u4e3a\u4e09\u89d2\u5f62\uff08\u5982\u679c\u6709\u5fc5\u8981\u7684\u8bdd\uff09\u3002 * aiProcess_FixInfacingNormals \uff1a\u6b64\u6807\u8bb0\u5c06\u5c1d\u8bd5\u53cd\u8f6c\u53ef\u80fd\u6307\u5411\u5185\u90e8\u7684\u6cd5\u7ebf\u3002 \u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u6807\u8bb0\u53ef\u4ee5\u4f7f\u7528\uff0c\u4f60\u53ef\u4ee5\u5728LWJGL\u7684Javadoc\u6587\u6863\u4e2d\u67e5\u9605\u5b83\u4eec\u3002 \u56de\u770b\u5230\u7b2c\u4e8c\u4e2a\u8f7d\u5165\u65b9\u6cd5\uff0c\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 aiImportFile \u65b9\u6cd5\u6765\u52a0\u8f7d\u5e26\u6709\u6240\u9009\u6807\u8bb0\u7684\u6a21\u578b\u3002 AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } \u8f7d\u5165\u65b9\u6cd5\u7684\u5176\u4f59\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials); meshes[i] = mesh; } return meshes; \u6211\u4eec\u5904\u7406\u6a21\u578b\u4e2d\u5305\u542b\u7684\u6750\u8d28\uff0c\u6750\u8d28\u5b9a\u4e49\u7ec4\u6210\u6a21\u578b\u7684\u7f51\u683c\u4f7f\u7528\u7684\u989c\u8272\u548c\u7eb9\u7406\u3002\u7136\u540e\u6211\u4eec\u5904\u7406\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u6a21\u578b\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7f51\u683c\uff0c\u6bcf\u4e2a\u7f51\u683c\u90fd\u53ef\u4ee5\u4f7f\u7528\u4e3a\u6a21\u578b\u5b9a\u4e49\u7684\u4e00\u79cd\u6750\u8d28\u3002 \u5982\u679c\u4f60\u770b\u5230\u4e0a\u9762\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u5f88\u591a\u5bf9Assimp\u5e93\u7684\u8c03\u7528\u8fd4\u56de\u7684 PointerBuffer \u5b9e\u4f8b\u3002\u4f60\u53ef\u4ee5\u7528C\u6307\u9488\u90a3\u6837\u7684\u65b9\u5f0f\u770b\u5f85\u5b83\u4eec\uff0c\u5b83\u4eec\u53ea\u662f\u6307\u5411\u50a8\u5b58\u6570\u636e\u7684\u5185\u5b58\u533a\u57df\u3002\u4f60\u9700\u8981\u63d0\u524d\u77e5\u9053\u5b83\u4eec\u50a8\u5b58\u7684\u6570\u636e\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5904\u7406\u5b83\u4eec\u3002\u5bf9\u4e8e\u6750\u8d28\uff0c\u6211\u4eec\u8fed\u4ee3\u8be5\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMaterial \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u8fed\u4ee3\u50a8\u5b58\u7f51\u683c\u6570\u636e\u7684\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMesh \u7c7b\u7684\u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u770b\u770b processMaterial \u65b9\u6cd5\uff1a private static void processMaterial(AIMaterial aiMaterial, List<Material> materials, String texturesDir) throws Exception { AIColor4D colour = AIColor4D.create(); AIString path = AIString.calloc(); Assimp.aiGetMaterialTexture(aiMaterial, aiTextureType_DIFFUSE, 0, path, (IntBuffer) null, null, null, null, null, null); String textPath = path.dataString(); Texture texture = null; if (textPath != null && textPath.length() > 0) { TextureCache textCache = TextureCache.getInstance(); texture = textCache.getTexture(texturesDir + \"/\" + textPath); } Vector4f ambient = Material.DEFAULT_COLOUR; int result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_AMBIENT, aiTextureType_NONE, 0, colour); if (result == 0) { ambient = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f diffuse = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_DIFFUSE, aiTextureType_NONE, 0, colour); if (result == 0) { diffuse = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f specular = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_SPECULAR, aiTextureType_NONE, 0, colour); if (result == 0) { specular = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Material material = new Material(ambient, diffuse, specular, 1.0f); material.setTexture(texture); materials.add(material); } \u6211\u4eec\u68c0\u67e5\u6750\u8d28\u662f\u5426\u5b9a\u4e49\u4e86\u7eb9\u7406\u3002\u5982\u679c\u6709\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a TextureCache \u7684\u65b0\u7c7b\uff0c\u7528\u4e8e\u7f13\u5b58\u7eb9\u7406\u3002\u8fd9\u662f\u56e0\u4e3a\u51e0\u4e2a\u7f51\u683c\u53ef\u80fd\u5171\u4eab\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u4e0d\u60f3\u6d6a\u8d39\u7a7a\u95f4\u4e00\u6b21\u53c8\u4e00\u6b21\u52a0\u8f7d\u76f8\u540c\u7684\u6570\u636e\u3002\u7136\u540e\u6211\u4eec\u5c1d\u8bd5\u83b7\u5f97\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u5e78\u8fd0\u7684\u662f\uff0c\u6211\u4eec\u5bf9\u6750\u8d28\u7684\u5b9a\u4e49\u5df2\u7ecf\u5305\u542b\u4e86\u8fd9\u4e9b\u4fe1\u606f\u3002 TextureCache \u7684\u5b9a\u4e49\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u6620\u5c04\uff0c\u901a\u8fc7\u7eb9\u7406\u6587\u4ef6\u7684\u8def\u5f84\u5bf9\u4e0d\u540c\u7684\u7eb9\u7406\u8fdb\u884c\u7d22\u5f15\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u7531\u4e8e\u73b0\u5728\u7eb9\u7406\u53ef\u80fd\u4f7f\u7528\u4e0d\u540c\u7684\u56fe\u50cf\u683c\u5f0f\uff08PNG\u3001JPEG\u7b49\uff09\uff0c\u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86\u7eb9\u7406\u7684\u52a0\u8f7d\u65b9\u5f0f\uff0c\u73b0\u5728\u4f7f\u7528STB\u5e93\u6765\u52a0\u8f7d\u66f4\u591a\u7684\u683c\u5f0f\uff0c\u800c\u4e0d\u662f\u4f7f\u7528PNG\u5e93\u3002 \u8ba9\u6211\u4eec\u770b\u5230 StaticMeshesLoader \u7c7b\u3002 processMesh \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static Mesh processMesh(AIMesh aiMesh, List<Material> materials) { List<Float> vertices = new ArrayList<>(); List<Float> textures = new ArrayList<>(); List<Float> normals = new ArrayList<>(); List<Integer> indices = new ArrayList(); processVertices(aiMesh, vertices); processNormals(aiMesh, normals); processTextCoords(aiMesh, textures); processIndices(aiMesh, indices); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices) ); Material material; int materialIdx = aiMesh.mMaterialIndex(); if (materialIdx >= 0 && materialIdx < materials.size()) { material = materials.get(materialIdx); } else { material = new Material(); } mesh.setMaterial(material); return mesh; } Mesh \u7531\u4e00\u7ec4\u9876\u70b9\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u65b9\u5411\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u5b9a\u4e49\u3002\u6bcf\u4e2a\u5143\u7d20\u90fd\u5728 processVertices \u3001 processNormals \u3001 processTextCoords \u548c processIndices \u65b9\u6cd5\u4e2d\u5904\u7406\uff0c\u7f51\u683c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u5176\u7d22\u5f15\u6307\u5411\u6750\u8d28\u3002\u5982\u679c\u7d22\u5f15\u4e0e\u4e4b\u524d\u5904\u7406\u7684\u6750\u8d28\u76f8\u5bf9\u5e94\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b83\u4eec\u4e0e Mesh \u76f8\u5173\u8054\u3002 processXXX \u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u662f\u5728\u8fd4\u56de\u6240\u9700\u6570\u636e\u7684 AIMesh \u5b9e\u4f8b\u4e0a\u8c03\u7528\u76f8\u5e94\u7684\u65b9\u6cd5\u3002\u4f8b\u5982\uff0c processVertices \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static void processVertices(AIMesh aiMesh, List<Float> vertices) { AIVector3D.Buffer aiVertices = aiMesh.mVertices(); while (aiVertices.remaining() > 0) { AIVector3D aiVertex = aiVertices.get(); vertices.add(aiVertex.x()); vertices.add(aiVertex.y()); vertices.add(aiVertex.z()); } } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u8c03\u7528 mVertices \u65b9\u6cd5\u6765\u83b7\u53d6\u9876\u70b9\u7684\u7f13\u51b2\u533a\uff0c\u7b80\u5355\u5730\u5904\u7406\u5b83\u4eec\u6765\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u9876\u70b9\u4f4d\u7f6e\u7684\u6d6e\u70b9\u6570\u5217\u8868\u3002\u56e0\u4e3a\uff0c\u8be5\u65b9\u6cd5\u53ea\u8fd4\u56de\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4f60\u53ef\u4ee5\u5c06\u8be5\u6570\u636e\u76f4\u63a5\u4f20\u7ed9\u521b\u5efa\u9876\u70b9\u7684OpenGL\u65b9\u6cd5\u3002\u4f46\u6211\u4eec\u4e0d\u8fd9\u6837\u505a\uff0c\u539f\u56e0\u6709\u4e24\u4e2a\u3002\u7b2c\u4e00\u4e2a\u539f\u56e0\u662f\u5c3d\u91cf\u51cf\u5c11\u5bf9\u4ee3\u7801\u5e93\u7684\u4fee\u6539\uff0c\u7b2c\u4e8c\u4e2a\u539f\u56e0\u662f\uff0c\u901a\u8fc7\u52a0\u8f7d\u6570\u636e\u5230\u4e2d\u95f4\u5c42\u4e2d\uff0c\u4f60\u53ef\u4ee5\u6267\u884c\u4e00\u4e9b\u4e13\u95e8\u7684\u5904\u7406\u4efb\u52a1\uff0c\u751a\u81f3\u8c03\u8bd5\u52a0\u8f7d\u8fc7\u7a0b\u3002 \u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u6709\u6548\u7684\u793a\u4f8b\uff0c\u5373\u76f4\u63a5\u5c06\u7f13\u51b2\u533a\u4f20\u7ed9OpenGL\uff0c\u53ef\u4ee5\u67e5\u770b\u8fd9\u4e2a \u4f8b\u5b50 \u3002 StaticMeshesLoader \u7c7b\u8ba9 OBJLoader \u7c7b\u8fc7\u65f6\u4e86\uff0c\u56e0\u6b64\u5b83\u5df2\u7ecf\u4ece\u6e90\u4ee3\u7801\u4e2d\u5220\u9664\u3002\u4e00\u4e2a\u66f4\u590d\u6742\u7684OBJ\u6587\u4ef6\u5df2\u7ecf\u4f5c\u4e3a\u793a\u4f8b\u63d0\u4f9b\uff0c\u5982\u679c\u8fd0\u884c\u5b83\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u52a8\u753b \u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4f7f\u7528Assimp\u52a0\u8f7d\u4e86\u9759\u6001\u7f51\u683c\uff0c\u53ef\u4ee5\u7ee7\u7eed\u8bb2\u89e3\u52a8\u753b\u3002\u5982\u679c\u4f60\u56de\u60f3\u52a8\u753b\u4e00\u7ae0\uff0c\u4e0e\u7f51\u683c\u5173\u8054\u7684VAO\u5305\u542b\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u5e94\u5e94\u7528\u4e8e\u5173\u8282\u4f4d\u7f6e\u4ee5\u8c03\u6574\u6700\u7ec8\u9876\u70b9\u4f4d\u7f6e\u7684\u6743\u91cd\u5217\u8868\u3002 \u6bcf\u4e2a\u9876\u70b9\u4f4d\u7f6e\u90fd\u5173\u8054\u4e86\u4e00\u4e2a\u6539\u53d8\u6700\u7ec8\u4f4d\u7f6e\u7684\u56db\u4e2a\u6743\u91cd\u7684\u5217\u8868\uff0c\u5f15\u7528\u4e86\u5c06\u7ec4\u5408\u4ee5\u786e\u5b9a\u9876\u70b9\u6700\u7ec8\u4f4d\u7f6e\u7684\u9aa8\u9abc\u7d22\u5f15\u3002\u5728\u6bcf\u4e00\u5e27\uff0c\u4e00\u4e2a\u53d8\u6362\u77e9\u9635\u5217\u8868\u5c06\u88ab\u4f5c\u4e3aUniform\u52a0\u8f7d\u5230\u6bcf\u4e2a\u5173\u8282\u3002\u6839\u636e\u8fd9\u4e9b\u6570\u636e\uff0c\u7b97\u51fa\u6700\u7ec8\u4f4d\u7f6e\u3002 \u5728\u52a8\u753b\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u5f00\u53d1\u4e86\u4e00\u4e2aMD5\u89e3\u6790\u5668\u6765\u52a0\u8f7d\u52a8\u753b\u7f51\u683c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Assimp\u5e93\u3002\u8fd9\u5c06\u5141\u8bb8\u6211\u4eec\u52a0\u8f7dMD5\u4e4b\u5916\u7684\u66f4\u591a\u683c\u5f0f\uff0c\u4f8b\u5982 COLLADA \uff0c FBX \u7b49\u3002 \u5728\u5f00\u59cb\u7f16\u7801\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7406\u6e05\u4e00\u4e9b\u672f\u8bed\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u52a0\u533a\u5206\u5730\u63d0\u5230\u9aa8\u9abc\u548c\u5173\u8282\u3002\u9aa8\u9abc\u6216\u8005\u5173\u8282\u90fd\u53ea\u662f\u5f71\u54cd\u9876\u70b9\u7684\u5143\u7d20\uff0c\u5e76\u4e14\u5177\u6709\u5f62\u6210\u5c42\u6b21\u7684\u7236\u7ea7\u3002MD5\u683c\u5f0f\u4f7f\u7528\u672f\u8bed\u5173\u8282\uff0c\u800cAssimp\u4f7f\u7528\u672f\u8bed\u9aa8\u9abc\u3002 \u8ba9\u6211\u4eec\u5148\u770b\u4e00\u4e0b\u7531Assimp\u5904\u7406\u7684\u50a8\u5b58\u7740\u52a8\u753b\u4fe1\u606f\u7684\u7ed3\u6784\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u9aa8\u9abc\u548c\u6743\u91cd\u6570\u636e\u5f00\u59cb\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002\u7f51\u683c\u8fd8\u50a8\u5b58\u7740\u9aa8\u9abc\u5217\u8868\uff0c\u6bcf\u4e2a\u9aa8\u9abc\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u4e00\u4e2a\u504f\u79fb\u77e9\u9635\uff1a\u7a0d\u540e\u5c06\u7528\u5b83\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc\u5e94\u8be5\u4f7f\u7528\u7684\u6700\u7ec8\u53d8\u6362\u3002 \u9aa8\u9abc\u8fd8\u6307\u5411\u4e00\u4e2a\u6743\u91cd\u5217\u8868\uff0c\u6bcf\u4e2a\u6743\u91cd\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u6743\u91cd\u56e0\u5b50\uff0c\u5373\u7528\u4e8e\u8c03\u8282\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u9aa8\u9abc\u53d8\u6362\u5f71\u54cd\u7684\u6570\u5b57\u3002 \u4e00\u4e2a\u9876\u70b9\u6807\u8bc6\u7b26\uff0c\u5373\u4e0e\u5f53\u524d\u9aa8\u9abc\u76f8\u5173\u8054\u7684\u9876\u70b9\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u6240\u6709\u8fd9\u4e9b\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u4ece\u4e0a\u8ff0\u7684\u7ed3\u6784\u6784\u9020\u9876\u70b9\u4f4d\u7f6e\u3001\u9aa8\u9abc/\u5173\u8282/\u7d22\u5f15\u548c\u76f8\u5173\u6743\u91cd\u7684\u5217\u8868\u3002\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6a21\u578b\u4e2d\u5b9a\u4e00\u4e2a\u6240\u6709\u52a8\u753b\u5e27\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc/\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Assimp\u573a\u666f\u5bf9\u8c61\u662f\u5b9a\u4e49\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u6bcf\u4e2a\u8282\u70b9\u90fd\u7531\u4e00\u4e2a\u540d\u8bcd\u548c\u4e00\u4e2a\u5b50\u8282\u70b9\u5217\u8868\u5b9a\u4e49\u3002\u52a8\u753b\u4f7f\u7528\u8fd9\u4e9b\u8282\u70b9\u6765\u5b9a\u4e49\u5e94\u8be5\u5e94\u7528\u7684\u53d8\u6362\uff0c\u8fd9\u4e2a\u5c42\u6b21\u7ed3\u6784\u5b9e\u9645\u4e0a\u5b9a\u4e49\u4e86\u9aa8\u9abc\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u6bcf\u4e2a\u9aa8\u9abc\u90fd\u662f\u4e00\u4e2a\u8282\u70b9\uff0c\u5e76\u4e14\u6709\u4e00\u4e2a\u7236\u8282\u70b9\uff08\u6839\u8282\u70b9\u9664\u5916\uff09\uff0c\u53ef\u80fd\u8fd8\u6709\u4e00\u7ec4\u5b50\u8282\u70b9\u3002\u6709\u4e00\u4e9b\u7279\u6b8a\u7684\u8282\u70b9\u4e0d\u662f\u9aa8\u9abc\uff0c\u5b83\u4eec\u7528\u4e8e\u5bf9\u53d8\u6362\u8fdb\u884c\u5206\u7ec4\uff0c\u5728\u8ba1\u7b97\u53d8\u6362\u65f6\u8fdb\u884c\u5904\u7406\u3002\u53e6\u4e00\u4e2a\u95ee\u9898\u662f\uff0c\u8fd9\u4e9b\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u662f\u57fa\u4e8e\u6574\u4e2a\u6a21\u578b\u5b9a\u4e49\u7684\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u6ca1\u6709\u5355\u72ec\u7684\u5c42\u6b21\u7ed3\u6784\u3002 \u573a\u666f\u8fd8\u5b9a\u4e49\u4e86\u4e00\u7ec4\u52a8\u753b\u3002\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u53ef\u4ee5\u5bf9\u6a21\u578b\u505a\u884c\u8d70\u3001\u8dd1\u52a8\u7b49\u52a8\u753b\u3002\u6bcf\u4e2a\u52a8\u753b\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\u3002\u52a8\u753b\u5177\u6709\u4ee5\u4e0b\u5c5e\u6027\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u6301\u7eed\u65f6\u95f4\u3002\u5373\u52a8\u753b\u7684\u6301\u7eed\u65f6\u95f4\uff0c\u7531\u4e8e\u52a8\u753b\u662f\u5e94\u7528\u4e8e\u6bcf\u4e2a\u4e0d\u540c\u5e27\u7684\u6bcf\u4e2a\u8282\u70b9\u7684\u53d8\u6362\u5217\u8868\uff0c\u56e0\u6b64\u540d\u79f0\u53ef\u80fd\u770b\u8d77\u6765\u5f88\u6df7\u4e71\u3002 \u4e00\u4e2a\u52a8\u753b\u901a\u9053\uff08Animation Channel\uff09\u7684\u5217\u8868\u3002\u52a8\u753b\u901a\u9053\u50a8\u5b58\u5e94\u5e94\u7528\u4e8e\u6bcf\u4e2a\u8282\u70b9\u7684\u7279\u5b9a\u65f6\u95f4\u70b9\u7684\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u6570\u636e\uff0c\u6a21\u578b\u4e2d\u50a8\u5b58\u52a8\u753b\u901a\u9053\u6570\u636e\u7684\u7c7b\u662f AINodeAnim \u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e0a\u8ff0\u6240\u6709\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\uff1a \u5bf9\u4e8e\u7279\u5b9a\u7684\u65f6\u523b\uff0c\u6216\u8005\u8bf4\u5bf9\u4e8e\u5e27\uff0c\u8981\u5e94\u7528\u5230\u9aa8\u9abc\u7684\u53d8\u6362\u662f\u5728\u52a8\u753b\u901a\u9053\u4e2d\u4e3a\u8be5\u65f6\u523b\u5b9a\u4e49\u7684\u53d8\u6362\uff0c\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u5230\u6839\u8282\u70b9\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u573a\u666f\u4e2d\u5b58\u50a8\u7684\u4fe1\u606f\u8fdb\u884c\u91cd\u65b0\u6392\u5e8f\uff0c\u6d41\u7a0b\u5982\u4e0b\uff1a \u6784\u9020\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u3002 \u5bf9\u6bcf\u4e2a\u52a8\u753b\uff0c\u8fed\u4ee3\u6bcf\u4e2a\u52a8\u753b\u901a\u9053\uff08\u5bf9\u6bcf\u4e2a\u52a8\u753b\u8282\u70b9\uff09\uff1a\u4e3a\u6240\u6709\u5e27\u6784\u9020\u53d8\u6362\u77e9\u9635\u3002\u53d8\u6362\u77e9\u9635\u662f\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\u7684\u7ec4\u5408\u3002 \u91cd\u65b0\u6392\u5217\u6bcf\u4e00\u5e27\u7684\u4fe1\u606f\uff1a\u6784\u9020\u8981\u5e94\u7528\u4e8e\u7f51\u683c\u4e2d\u6bcf\u4e2a\u9aa8\u9abc\u7684\u6700\u7ec8\u53d8\u6362\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u9aa8\u9abc\u7684\u53d8\u6362\u77e9\u9635\uff08\u76f8\u5173\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\uff09\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\u76f4\u5230\u6839\u8282\u70b9\u6765\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u9996\u5148\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a AnimMeshesLoader \u7684\u7c7b\uff0c\u5b83\u7531 StaticMeshesLoader \u6269\u5c55\uff0c\u4f46\u5b83\u4e0d\u8fd4\u56de\u7f51\u683c\u6570\u7ec4\uff0c\u800c\u662f\u8fd4\u56de\u4e00\u4e2a AnimGameItem \u5b9e\u4f8b\u3002\u5b83\u5b9a\u4e49\u4e86\u4e24\u4e2a\u516c\u5171\u65b9\u6cd5\uff1a public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir) throws Exception { return loadAnimGameItem(resourcePath, texturesDir, aiProcess_GenSmoothNormals | aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals | aiProcess_LimitBoneWeights); } public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir, int flags) throws Exception { AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } List<Bone> boneList = new ArrayList<>(); int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials, boneList); meshes[i] = mesh; } AINode aiRootNode = aiScene.mRootNode(); Matrix4f rootTransfromation = AnimMeshesLoader.toMatrix(aiRootNode.mTransformation()); Node rootNode = processNodesHierarchy(aiRootNode, null); Map<String, Animation> animations = processAnimations(aiScene, boneList, rootNode, rootTransfromation); AnimGameItem item = new AnimGameItem(meshes, animations); return item; } \u8fd9\u4e9b\u65b9\u6cd5\u4e0e StaticMeshesLoader \u4e2d\u5b9a\u4e49\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u5982\u4e0b\u533a\u522b\uff1a \u4f20\u9012\u9ed8\u8ba4\u52a0\u8f7d\u6807\u8bb0\u7684\u65b9\u6cd5\u4f7f\u7528\u4e86\u65b0\u53c2\u6570\uff1a aiProcess_LimitBoneWeights \u3002\u8fd9\u5c06\u4f1a\u5c06\u5f71\u54cd\u9876\u70b9\u7684\u6700\u5927\u6743\u91cd\u6570\u9650\u5236\u4e3a4\uff08\u8fd9\u4e5f\u662f\u6211\u4eec\u5f53\u524d\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\u652f\u6301\u7684\u6700\u5927\u503c\uff09\u3002 \u5b9e\u9645\u52a0\u8f7d\u6a21\u578b\u7684\u65b9\u6cd5\u53ea\u52a0\u8f7d\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u4f46\u5b83\u9996\u5148\u8ba1\u7b97\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u7136\u540e\u5728\u7ed3\u5c3e\u8c03\u7528 processAnimations \u4ee5\u751f\u6210 AnimGameItem \u5b9e\u4f8b\u3002 processMesh \u65b9\u6cd5\u4e0e StaticMeshesLoader \u7c7b\u4e2d\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u5b83\u521b\u5efa\u7684\u7f51\u683c\u5c06\u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\uff1a processBones(aiMesh, boneList, boneIds, weights); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices), Utils.listIntToArray(boneIds), Utils.listToArray(weights)); \u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u6309 processBones \u65b9\u6cd5\u8ba1\u7b97\uff1a private static void processBones(AIMesh aiMesh, List<Bone> boneList, List<Integer> boneIds, List<Float> weights) { Map<Integer, List<VertexWeight>> weightSet = new HashMap<>(); int numBones = aiMesh.mNumBones(); PointerBuffer aiBones = aiMesh.mBones(); for (int i = 0; i < numBones; i++) { AIBone aiBone = AIBone.create(aiBones.get(i)); int id = boneList.size(); Bone bone = new Bone(id, aiBone.mName().dataString(), toMatrix(aiBone.mOffsetMatrix())); boneList.add(bone); int numWeights = aiBone.mNumWeights(); AIVertexWeight.Buffer aiWeights = aiBone.mWeights(); for (int j = 0; j < numWeights; j++) { AIVertexWeight aiWeight = aiWeights.get(j); VertexWeight vw = new VertexWeight(bone.getBoneId(), aiWeight.mVertexId(), aiWeight.mWeight()); List<VertexWeight> vertexWeightList = weightSet.get(vw.getVertexId()); if (vertexWeightList == null) { vertexWeightList = new ArrayList<>(); weightSet.put(vw.getVertexId(), vertexWeightList); } vertexWeightList.add(vw); } } int numVertices = aiMesh.mNumVertices(); for (int i = 0; i < numVertices; i++) { List<VertexWeight> vertexWeightList = weightSet.get(i); int size = vertexWeightList != null ? vertexWeightList.size() : 0; for (int j = 0; j < Mesh.MAX_WEIGHTS; j++) { if (j < size) { VertexWeight vw = vertexWeightList.get(j); weights.add(vw.getWeight()); boneIds.add(vw.getBoneId()); } else { weights.add(0.0f); boneIds.add(0); } } } } \u6b64\u65b9\u6cd5\u904d\u5386\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u5b9a\u4e49\uff0c\u83b7\u53d6\u5176\u6743\u91cd\u5e76\u751f\u6210\u4e09\u4e2a\u5217\u8868\uff1a boneList \uff1a\u50a8\u5b58\u8282\u70b9\u53ca\u5176\u504f\u79fb\u77e9\u9635\u7684\u5217\u8868\u3002\u7a0d\u540e\u5c06\u4f7f\u7528\u5b83\u6765\u8ba1\u7b97\u8282\u70b9\u53d8\u6362\u3002\u5df2\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Bone \u7684\u65b0\u7c7b\u6765\u50a8\u5b58\u8be5\u4fe1\u606f\u3002\u6b64\u5217\u8868\u5c06\u50a8\u5b58\u6240\u6709\u7f51\u683c\u7684\u9aa8\u9abc\u3002 boneIds \uff1a\u53ea\u50a8\u5b58\u5305\u542b Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u9aa8\u9abc\u6807\u8bc6\u3002\u9aa8\u9abc\u5728\u6e32\u67d3\u65f6\u6839\u636e\u5176\u4f4d\u7f6e\u8fdb\u884c\u6807\u8bc6\uff0c\u6b64\u5217\u8868\u4ec5\u5305\u542b\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u3002 weights \uff1a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u5173\u8054\u9aa8\u9abc\u7684 Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u6743\u91cd\u3002 weights \u548c boneIds \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u7528\u4e8e\u6784\u9020 Mesh \u6570\u636e\u3002 boneList \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5c06\u5728\u7a0d\u540e\u8ba1\u7b97\u52a8\u753b\u6570\u636e\u65f6\u4f7f\u7528\u3002 \u8ba9\u6211\u4eec\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\u3002\u4e00\u65e6\u6211\u4eec\u521b\u5efa\u4e86\u7f51\u683c\uff0c\u8fd8\u5f97\u5230\u4e86\u5e94\u7528\u4e8e\u6839\u8282\u70b9\u7684\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u4e5f\u5c06\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u7684\u53d8\u6362\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u662f\u5728 processNodesHierarchy \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8fd9\u4e2a\u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4ece\u6839\u8282\u70b9\u5f00\u59cb\u904d\u5386\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u6784\u9020\u4e00\u4e2a\u8282\u70b9\u6811\u3002 private static Node processNodesHierarchy(AINode aiNode, Node parentNode) { String nodeName = aiNode.mName().dataString(); Node node = new Node(nodeName, parentNode); int numChildren = aiNode.mNumChildren(); PointerBuffer aiChildren = aiNode.mChildren(); for (int i = 0; i < numChildren; i++) { AINode aiChildNode = AINode.create(aiChildren.get(i)); Node childNode = processNodesHierarchy(aiChildNode, node); node.addChild(childNode); } return node; } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Node \u7c7b\uff0c\u8be5\u7c7b\u5c06\u50a8\u5b58 AINode \u5b9e\u4f8b\u7684\u76f8\u5173\u4fe1\u606f\uff0c\u5e76\u63d0\u4f9b\u4e86\u67e5\u627e\u65b9\u6cd5\u6765\u5b9a\u4f4d\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u4ee5\u4fbf\u6309\u540d\u79f0\u67e5\u627e\u8282\u70b9\u3002\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8be5\u6570\u636e\u8ba1\u7b97 processAnimations \u65b9\u6cd5\u4e2d\u7684\u52a8\u753b\u3002\u8be5\u65b9\u6cd5\u8fd4\u56de Animation \u5b9e\u4f8b\u7684 Map \u3002\u8bf7\u8bb0\u4f4f\uff0c\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u56e0\u6b64\u5b83\u4eec\u6309\u540d\u79f0\u50a8\u5b58\u7d22\u5f15\u3002\u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6784\u5efa\u4e00\u4e2a AnimAgameItem \u5b9e\u4f8b\u3002 processAnimations \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a private static Map<String, Animation> processAnimations(AIScene aiScene, List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { Map<String, Animation> animations = new HashMap<>(); // \u5904\u7406\u6240\u6709\u52a8\u753b int numAnimations = aiScene.mNumAnimations(); PointerBuffer aiAnimations = aiScene.mAnimations(); for (int i = 0; i < numAnimations; i++) { AIAnimation aiAnimation = AIAnimation.create(aiAnimations.get(i)); // \u4e3a\u6bcf\u4e2a\u8282\u70b9\u8ba1\u7b97\u53d8\u6362\u77e9\u9635 int numChanels = aiAnimation.mNumChannels(); PointerBuffer aiChannels = aiAnimation.mChannels(); for (int j = 0; j < numChanels; j++) { AINodeAnim aiNodeAnim = AINodeAnim.create(aiChannels.get(j)); String nodeName = aiNodeAnim.mNodeName().dataString(); Node node = rootNode.findByName(nodeName); buildTransFormationMatrices(aiNodeAnim, node); } List<AnimatedFrame> frames = buildAnimationFrames(boneList, rootNode, rootTransformation); Animation animation = new Animation(aiAnimation.mName().dataString(), frames, aiAnimation.mDuration()); animations.put(animation.getName(), animation); } return animations; } \u5c06\u4e3a\u6bcf\u4e2a\u52a8\u753b\u5904\u7406\u5176\u52a8\u753b\u901a\u9053\uff0c\u6bcf\u4e2a\u901a\u9053\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\uff0c\u8fd9\u4e9b\u53d8\u5316\u5e94\u8be5\u968f\u7740\u65f6\u95f4\u7684\u63a8\u79fb\u5e94\u7528\u4e8e\u4e00\u4e2a\u8282\u70b9\u3002\u4e3a\u6bcf\u4e2a\u8282\u70b9\u5b9a\u4e49\u7684\u53d8\u6362\u5728 buildTransFormationMatrices \u65b9\u6cd5\u4e2d\u5b9a\u4e49\uff0c\u8fd9\u4e9b\u77e9\u9635\u88ab\u6bcf\u4e2a\u8282\u70b9\u50a8\u5b58\u3002\u4e00\u65e6\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u4e2d\u50a8\u5b58\u5b8c\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6784\u5efa\u52a8\u753b\u5e27\u3002 \u8ba9\u6211\u4eec\u5148\u56de\u987e\u4e00\u4e0b buildTransFormationMatrices \u65b9\u6cd5\uff1a private static void buildTransFormationMatrices(AINodeAnim aiNodeAnim, Node node) { int numFrames = aiNodeAnim.mNumPositionKeys(); AIVectorKey.Buffer positionKeys = aiNodeAnim.mPositionKeys(); AIVectorKey.Buffer scalingKeys = aiNodeAnim.mScalingKeys(); AIQuatKey.Buffer rotationKeys = aiNodeAnim.mRotationKeys(); for (int i = 0; i < numFrames; i++) { AIVectorKey aiVecKey = positionKeys.get(i); AIVector3D vec = aiVecKey.mValue(); Matrix4f transfMat = new Matrix4f().translate(vec.x(), vec.y(), vec.z()); AIQuatKey quatKey = rotationKeys.get(i); AIQuaternion aiQuat = quatKey.mValue(); Quaternionf quat = new Quaternionf(aiQuat.x(), aiQuat.y(), aiQuat.z(), aiQuat.w()); transfMat.rotate(quat); if (i < aiNodeAnim.mNumScalingKeys()) { aiVecKey = scalingKeys.get(i); vec = aiVecKey.mValue(); transfMat.scale(vec.x(), vec.y(), vec.z()); } node.addTransformation(transfMat); } } \u5982\u4f60\u6240\u89c1\uff0c AINodeAnim \u5b9e\u4f8b\u5b9a\u4e49\u4e86\u4e00\u7ec4\u5305\u542b\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4fe1\u606f\u7684\u952e\uff0c\u8fd9\u4e9b\u952e\u662f\u6307\u7279\u5b9a\u7684\u65f6\u523b\u3002\u6211\u4eec\u5047\u8bbe\u6570\u636e\u662f\u6309\u65f6\u95f4\u987a\u5e8f\u6392\u5217\u7684\uff0c\u5e76\u6784\u5efa\u4e00\u4e2a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5e27\u7684\u53d8\u6362\u7684\u77e9\u9635\u5217\u8868\u3002\u6700\u540e\u7684\u8ba1\u7b97\u662f\u5728 buildAnimationFrames \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private static List<AnimatedFrame> buildAnimationFrames(List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { int numFrames = rootNode.getAnimationFrames(); List<AnimatedFrame> frameList = new ArrayList<>(); for (int i = 0; i < numFrames; i++) { AnimatedFrame frame = new AnimatedFrame(); frameList.add(frame); int numBones = boneList.size(); for (int j = 0; j < numBones; j++) { Bone bone = boneList.get(j); Node node = rootNode.findByName(bone.getBoneName()); Matrix4f boneMatrix = Node.getParentTransforms(node, i); boneMatrix.mul(bone.getOffsetMatrix()); boneMatrix = new Matrix4f(rootTransformation).mul(boneMatrix); frame.setMatrix(j, boneMatrix); } } return frameList; } \u6b64\u65b9\u6cd5\u8fd4\u56de AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\uff0c\u6bcf\u4e2a AnimatedFrame \u5b9e\u4f8b\u5c06\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u7279\u5b9a\u5e27\u7684\u6bcf\u4e2a\u9aa8\u9abc\u7684\u53d8\u6362\u5217\u8868\u3002\u8fd9\u4e2a\u65b9\u6cd5\u53ea\u662f\u8fed\u4ee3\u50a8\u5b58\u6240\u6709\u9aa8\u9abc\u7684\u5217\u8868\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u9aa8\u9abc\uff1a \u83b7\u53d6\u76f8\u5173\u8054\u7684\u8282\u70b9\u3002 \u901a\u8fc7\u5c06\u76f8\u5173\u8054\u7684 Node \u7684\u53d8\u6362\u4e0e\u5176\u7236\u8282\u70b9\u7684\u6240\u6709\u53d8\u6362\u76f8\u4e58\uff0c\u751f\u6210\u53d8\u6362\u77e9\u9635\uff0c\u76f4\u81f3\u6839\u8282\u70b9\u3002\u8fd9\u662f\u5728 Node.getParentTransforms \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002 \u5b83\u5c06\u8be5\u77e9\u9635\u4e0e\u9aa8\u9abc\u7684\u504f\u501a\u77e9\u9635\u76f8\u4e58\u3002 \u6700\u540e\u7684\u53d8\u6362\u662f\u901a\u8fc7\u5c06\u6839\u8282\u70b9\u7684\u53d8\u6362\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u4e2d\u8ba1\u7b97\u7684\u77e9\u9635\u76f8\u4e58\u6765\u8ba1\u7b97\u7684\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4ed6\u4fee\u6539\u662f\u4e3a\u4e86\u9002\u5e94\u67d0\u4e9b\u7ed3\u6784\u800c\u8fdb\u884c\u7684\u5fae\u5c0f\u4fee\u6539\u3002\u6700\u540e\uff0c\u4f60\u80fd\u591f\u52a0\u8f7d\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u52a8\u753b\uff08\u4f60\u9700\u8981\u6309\u7a7a\u683c\u6539\u53d8\u5e27\uff09\uff1a \u8fd9\u4e2a\u793a\u4f8b\u7684\u590d\u6742\u4e4b\u5904\u5728\u4e8eAssimp\u7ed3\u6784\u7684\u8c03\u6574\uff0c\u4f7f\u5176\u9002\u5e94\u672c\u4e66\u4e2d\u4f7f\u7528\u7684\u5f15\u64ce\uff0c\u5e76\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6570\u636e\u3002\u6b64\u5916\uff0c\u8fd9\u4e9b\u6982\u5ff5\u4e0e\u52a8\u753b\u4e00\u7ae0\u4e2d\u7684\u6982\u5ff5\u7c7b\u4f3c\u3002\u4f60\u53ef\u4ee5\u5c1d\u8bd5\u4fee\u6539\u6e90\u4ee3\u7801\u4ee5\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u52a8\u753b\u3002","title":"Assimp\u5e93"},{"location":"27-assimp/#assimpassimp","text":"","title":"Assimp\u5e93\uff08Assimp\uff09"},{"location":"27-assimp/#_1","text":"\u52a0\u8f7d\u4e0d\u540c\u683c\u5f0f\u7684\u590d\u6742\u4e09\u7ef4\u6a21\u578b\u7684\u529f\u80fd\u5bf9\u4e8e\u7f16\u5199\u6e38\u620f\u81f3\u5173\u91cd\u8981\uff0c\u4e3a\u5176\u4e2d\u4e00\u4e9b\u7f16\u5199\u89e3\u6790\u5668\u9700\u8981\u5927\u91cf\u7684\u5de5\u4f5c\uff0c\u5373\u4fbf\u53ea\u652f\u6301\u4e00\u79cd\u683c\u5f0f\u4e5f\u53ef\u80fd\u5f88\u8017\u65f6\u3002\u4f8b\u5982\uff0c\u5728\u7b2c\u4e5d\u7ae0\u4e2d\u63cf\u8ff0\u7684wavefront\u52a0\u8f7d\u5668\u53ea\u89e3\u6790\u4e86\u89c4\u8303\u4e2d\u7684\u4e00\u5c0f\u90e8\u5206\uff08\u6839\u672c\u4e0d\u5904\u7406\u6750\u8d28\uff09\u3002 \u5e78\u8fd0\u7684\u662f\uff0c\u5df2\u7ecf\u53ef\u4ee5\u4f7f\u7528 Assimp \u5e93\u6765\u89e3\u6790\u8bb8\u591a\u5e38\u89c1\u76843D\u683c\u5f0f\u3002\u5b83\u662f\u4e00\u4e2aC++\u5e93\uff0c\u53ef\u4ee5\u4ee5\u5404\u79cd\u683c\u5f0f\u52a0\u8f7d\u9759\u6001\u548c\u52a8\u753b\u6a21\u578b\u3002LWJGL\u63d0\u4f9b\u4e86\u7ed1\u5b9a\u4ee5\u4fbf\u4eceJava\u4ee3\u7801\u4e2d\u4f7f\u7528\u5b83\u4eec\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528\u5b83\u3002 \u9996\u5148\u662f\u5c06Assimp\u7684Maven\u4f9d\u8d56\u9879\u6dfb\u52a0\u5230 pom.xml \u6587\u4ef6\u4e2d\u3002\u6211\u4eec\u9700\u8981\u6dfb\u52a0\u7f16\u8bd1\u65f6\u548c\u8fd0\u884c\u65f6\u4f9d\u8d56\u9879\u3002 <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> </dependency> <dependency> <groupId>org.lwjgl</groupId> <artifactId>lwjgl-assimp</artifactId> <version>${lwjgl.version}</version> <classifier>${native.target}</classifier> <scope>runtime</scope> </dependency> \u4e00\u65e6\u8bbe\u7f6e\u4e86\u4f9d\u8d56\u9879\uff0c\u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a StaticMeshesLoader \u7684\u65b0\u7c7b\uff0c\u8be5\u7c7b\u5c06\u7528\u4e8e\u52a0\u8f7d\u4e0d\u5e26\u52a8\u753b\u7684\u7f51\u683c\uff0c\u8be5\u7c7b\u5b9a\u4e49\u4e86\u4e24\u4e2a\u9759\u6001\u516c\u5171\u65b9\u6cd5\uff1a public static Mesh[] load(String resourcePath, String texturesDir) throws Exception { return load(resourcePath, texturesDir, aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals); } public static Mesh[] load(String resourcePath, String texturesDir, int flags) throws Exception { // .... \u4e24\u79cd\u65b9\u6cd5\u90fd\u6709\u4ee5\u4e0b\u53c2\u6570\uff1a * resourcePath \uff1a\u6a21\u578b\u6587\u4ef6\u6240\u5728\u7684\u6587\u4ef6\u8def\u5f84\u3002\u8fd9\u662f\u4e00\u4e2a\u7edd\u5bf9\u8def\u5f84\uff0c\u56e0\u4e3aAssimp\u53ef\u80fd\u9700\u8981\u52a0\u8f7d\u5176\u4ed6\u6587\u4ef6\uff08\u4f8b\u5982wavefront\u3001OBJ\u7b49\u6587\u4ef6\u7684\u6750\u8d28\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u53ef\u80fd\u4f7f\u7528\u4e0e\u8d44\u6e90\u8def\u5f84\u76f8\u540c\u7684\u57fa\u8def\u5f84\u3002\u5982\u679c\u5c06\u8d44\u6e90\u5d4c\u5165JAR\u6587\u4ef6\u4e2d\uff0c\u90a3\u4e48assimp\u5c06\u65e0\u6cd5\u5bfc\u5165\u5b83\uff0c\u56e0\u6b64\u5b83\u5fc5\u987b\u662f\u6587\u4ef6\u7cfb\u7edf\u8def\u5f84\u3002 * texturesDir \uff1a\u4fdd\u5b58\u6b64\u6a21\u578b\u7684\u6587\u4ef6\u5939\u8def\u5f84\u3002\u8fd9\u662fCLASSPATH\u7684\u76f8\u5bf9\u8def\u5f84\u3002\u4f8b\u5982\uff0cwavefront\u6750\u8d28\u6587\u4ef6\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7eb9\u7406\u6587\u4ef6\u3002\u4ee3\u7801\u5e0c\u671b\u6b64\u6587\u4ef6\u4f4d\u4e8e texturesDir \u76ee\u5f55\u4e0b\u3002\u5982\u679c\u53d1\u73b0\u7eb9\u7406\u52a0\u8f7d\u9519\u8bef\uff0c\u53ef\u80fd\u9700\u8981\u5728\u6a21\u578b\u6587\u4ef6\u4e2d\u624b\u52a8\u8c03\u6574\u8fd9\u4e9b\u8def\u5f84\u3002 \u7b2c\u4e8c\u4e2a\u65b9\u6cd5\u6709\u4e00\u4e2a\u540d\u4e3a flags \u7684\u989d\u5916\u53c2\u6570\u3002\u6b64\u53c2\u6570\u5141\u8bb8\u8c03\u6574\u52a0\u8f7d\u8fc7\u7a0b\u3002\u7b2c\u4e00\u4e2a\u65b9\u6cd5\u8c03\u7528\u7b2c\u4e8c\u4e2a\u65b9\u6cd5\uff0c\u5e76\u4f20\u9012\u4e00\u4e9b\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\u90fd\u6709\u7528\u7684\u503c\uff1a * aiProcess_JoinIdenticalVertices \uff1a\u6b64\u6807\u8bb0\u5c06\u51cf\u5c11\u4f7f\u7528\u7684\u9876\u70b9\u6570\uff0c\u8bc6\u522b\u53ef\u5728\u9762\u4e4b\u95f4\u91cd\u7528\u7684\u9876\u70b9\u3002 * aiProcess_Triangulate \uff1a\u6a21\u578b\u53ef\u4ee5\u4f7f\u7528\u56db\u8fb9\u5f62\u6216\u5176\u4ed6\u51e0\u4f55\u56fe\u5f62\u6765\u5b9a\u4e49\u5b83\u4eec\u7684\u5143\u7d20\u3002\u7531\u4e8e\u6211\u4eec\u53ea\u5904\u7406\u4e09\u89d2\u5f62\uff0c\u56e0\u6b64\u5fc5\u987b\u4f7f\u7528\u6b64\u6807\u8bb0\u5c06\u6240\u6709\u7684\u9762\u62c6\u5206\u4e3a\u4e09\u89d2\u5f62\uff08\u5982\u679c\u6709\u5fc5\u8981\u7684\u8bdd\uff09\u3002 * aiProcess_FixInfacingNormals \uff1a\u6b64\u6807\u8bb0\u5c06\u5c1d\u8bd5\u53cd\u8f6c\u53ef\u80fd\u6307\u5411\u5185\u90e8\u7684\u6cd5\u7ebf\u3002 \u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u6807\u8bb0\u53ef\u4ee5\u4f7f\u7528\uff0c\u4f60\u53ef\u4ee5\u5728LWJGL\u7684Javadoc\u6587\u6863\u4e2d\u67e5\u9605\u5b83\u4eec\u3002 \u56de\u770b\u5230\u7b2c\u4e8c\u4e2a\u8f7d\u5165\u65b9\u6cd5\uff0c\u6211\u4eec\u8981\u505a\u7684\u7b2c\u4e00\u4ef6\u4e8b\u662f\u8c03\u7528 aiImportFile \u65b9\u6cd5\u6765\u52a0\u8f7d\u5e26\u6709\u6240\u9009\u6807\u8bb0\u7684\u6a21\u578b\u3002 AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } \u8f7d\u5165\u65b9\u6cd5\u7684\u5176\u4f59\u4ee3\u7801\u5982\u4e0b\u6240\u793a\uff1a int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials); meshes[i] = mesh; } return meshes; \u6211\u4eec\u5904\u7406\u6a21\u578b\u4e2d\u5305\u542b\u7684\u6750\u8d28\uff0c\u6750\u8d28\u5b9a\u4e49\u7ec4\u6210\u6a21\u578b\u7684\u7f51\u683c\u4f7f\u7528\u7684\u989c\u8272\u548c\u7eb9\u7406\u3002\u7136\u540e\u6211\u4eec\u5904\u7406\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u6a21\u578b\u53ef\u4ee5\u5b9a\u4e49\u591a\u4e2a\u7f51\u683c\uff0c\u6bcf\u4e2a\u7f51\u683c\u90fd\u53ef\u4ee5\u4f7f\u7528\u4e3a\u6a21\u578b\u5b9a\u4e49\u7684\u4e00\u79cd\u6750\u8d28\u3002 \u5982\u679c\u4f60\u770b\u5230\u4e0a\u9762\u7684\u4ee3\u7801\uff0c\u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u5f88\u591a\u5bf9Assimp\u5e93\u7684\u8c03\u7528\u8fd4\u56de\u7684 PointerBuffer \u5b9e\u4f8b\u3002\u4f60\u53ef\u4ee5\u7528C\u6307\u9488\u90a3\u6837\u7684\u65b9\u5f0f\u770b\u5f85\u5b83\u4eec\uff0c\u5b83\u4eec\u53ea\u662f\u6307\u5411\u50a8\u5b58\u6570\u636e\u7684\u5185\u5b58\u533a\u57df\u3002\u4f60\u9700\u8981\u63d0\u524d\u77e5\u9053\u5b83\u4eec\u50a8\u5b58\u7684\u6570\u636e\u7c7b\u578b\uff0c\u4ee5\u4fbf\u5904\u7406\u5b83\u4eec\u3002\u5bf9\u4e8e\u6750\u8d28\uff0c\u6211\u4eec\u8fed\u4ee3\u8be5\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMaterial \u7c7b\u7684\u5b9e\u4f8b\u3002\u5728\u7b2c\u4e8c\u79cd\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u8fed\u4ee3\u50a8\u5b58\u7f51\u683c\u6570\u636e\u7684\u7f13\u51b2\u533a\uff0c\u521b\u5efa AIMesh \u7c7b\u7684\u5b9e\u4f8b\u3002 \u8ba9\u6211\u4eec\u770b\u770b processMaterial \u65b9\u6cd5\uff1a private static void processMaterial(AIMaterial aiMaterial, List<Material> materials, String texturesDir) throws Exception { AIColor4D colour = AIColor4D.create(); AIString path = AIString.calloc(); Assimp.aiGetMaterialTexture(aiMaterial, aiTextureType_DIFFUSE, 0, path, (IntBuffer) null, null, null, null, null, null); String textPath = path.dataString(); Texture texture = null; if (textPath != null && textPath.length() > 0) { TextureCache textCache = TextureCache.getInstance(); texture = textCache.getTexture(texturesDir + \"/\" + textPath); } Vector4f ambient = Material.DEFAULT_COLOUR; int result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_AMBIENT, aiTextureType_NONE, 0, colour); if (result == 0) { ambient = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f diffuse = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_DIFFUSE, aiTextureType_NONE, 0, colour); if (result == 0) { diffuse = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Vector4f specular = Material.DEFAULT_COLOUR; result = aiGetMaterialColor(aiMaterial, AI_MATKEY_COLOR_SPECULAR, aiTextureType_NONE, 0, colour); if (result == 0) { specular = new Vector4f(colour.r(), colour.g(), colour.b(), colour.a()); } Material material = new Material(ambient, diffuse, specular, 1.0f); material.setTexture(texture); materials.add(material); } \u6211\u4eec\u68c0\u67e5\u6750\u8d28\u662f\u5426\u5b9a\u4e49\u4e86\u7eb9\u7406\u3002\u5982\u679c\u6709\uff0c\u6211\u4eec\u52a0\u8f7d\u7eb9\u7406\u3002\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a TextureCache \u7684\u65b0\u7c7b\uff0c\u7528\u4e8e\u7f13\u5b58\u7eb9\u7406\u3002\u8fd9\u662f\u56e0\u4e3a\u51e0\u4e2a\u7f51\u683c\u53ef\u80fd\u5171\u4eab\u76f8\u540c\u7684\u7eb9\u7406\uff0c\u6211\u4eec\u4e0d\u60f3\u6d6a\u8d39\u7a7a\u95f4\u4e00\u6b21\u53c8\u4e00\u6b21\u52a0\u8f7d\u76f8\u540c\u7684\u6570\u636e\u3002\u7136\u540e\u6211\u4eec\u5c1d\u8bd5\u83b7\u5f97\u73af\u5883\u3001\u6f2b\u53cd\u5c04\u548c\u955c\u9762\u53cd\u5c04\u7684\u6750\u8d28\u989c\u8272\u5206\u91cf\u3002\u5e78\u8fd0\u7684\u662f\uff0c\u6211\u4eec\u5bf9\u6750\u8d28\u7684\u5b9a\u4e49\u5df2\u7ecf\u5305\u542b\u4e86\u8fd9\u4e9b\u4fe1\u606f\u3002 TextureCache \u7684\u5b9a\u4e49\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4e00\u4e2a\u6620\u5c04\uff0c\u901a\u8fc7\u7eb9\u7406\u6587\u4ef6\u7684\u8def\u5f84\u5bf9\u4e0d\u540c\u7684\u7eb9\u7406\u8fdb\u884c\u7d22\u5f15\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\u3002\u7531\u4e8e\u73b0\u5728\u7eb9\u7406\u53ef\u80fd\u4f7f\u7528\u4e0d\u540c\u7684\u56fe\u50cf\u683c\u5f0f\uff08PNG\u3001JPEG\u7b49\uff09\uff0c\u6211\u4eec\u5df2\u7ecf\u4fee\u6539\u4e86\u7eb9\u7406\u7684\u52a0\u8f7d\u65b9\u5f0f\uff0c\u73b0\u5728\u4f7f\u7528STB\u5e93\u6765\u52a0\u8f7d\u66f4\u591a\u7684\u683c\u5f0f\uff0c\u800c\u4e0d\u662f\u4f7f\u7528PNG\u5e93\u3002 \u8ba9\u6211\u4eec\u770b\u5230 StaticMeshesLoader \u7c7b\u3002 processMesh \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static Mesh processMesh(AIMesh aiMesh, List<Material> materials) { List<Float> vertices = new ArrayList<>(); List<Float> textures = new ArrayList<>(); List<Float> normals = new ArrayList<>(); List<Integer> indices = new ArrayList(); processVertices(aiMesh, vertices); processNormals(aiMesh, normals); processTextCoords(aiMesh, textures); processIndices(aiMesh, indices); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices) ); Material material; int materialIdx = aiMesh.mMaterialIndex(); if (materialIdx >= 0 && materialIdx < materials.size()) { material = materials.get(materialIdx); } else { material = new Material(); } mesh.setMaterial(material); return mesh; } Mesh \u7531\u4e00\u7ec4\u9876\u70b9\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u65b9\u5411\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u5b9a\u4e49\u3002\u6bcf\u4e2a\u5143\u7d20\u90fd\u5728 processVertices \u3001 processNormals \u3001 processTextCoords \u548c processIndices \u65b9\u6cd5\u4e2d\u5904\u7406\uff0c\u7f51\u683c\u4e5f\u53ef\u4ee5\u4f7f\u7528\u5176\u7d22\u5f15\u6307\u5411\u6750\u8d28\u3002\u5982\u679c\u7d22\u5f15\u4e0e\u4e4b\u524d\u5904\u7406\u7684\u6750\u8d28\u76f8\u5bf9\u5e94\uff0c\u6211\u4eec\u53ea\u9700\u5c06\u5b83\u4eec\u4e0e Mesh \u76f8\u5173\u8054\u3002 processXXX \u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u4eec\u53ea\u662f\u5728\u8fd4\u56de\u6240\u9700\u6570\u636e\u7684 AIMesh \u5b9e\u4f8b\u4e0a\u8c03\u7528\u76f8\u5e94\u7684\u65b9\u6cd5\u3002\u4f8b\u5982\uff0c processVertices \u7684\u5b9a\u4e49\u5982\u4e0b\uff1a private static void processVertices(AIMesh aiMesh, List<Float> vertices) { AIVector3D.Buffer aiVertices = aiMesh.mVertices(); while (aiVertices.remaining() > 0) { AIVector3D aiVertex = aiVertices.get(); vertices.add(aiVertex.x()); vertices.add(aiVertex.y()); vertices.add(aiVertex.z()); } } \u4f60\u53ef\u4ee5\u770b\u5230\uff0c\u6211\u4eec\u53ea\u662f\u901a\u8fc7\u8c03\u7528 mVertices \u65b9\u6cd5\u6765\u83b7\u53d6\u9876\u70b9\u7684\u7f13\u51b2\u533a\uff0c\u7b80\u5355\u5730\u5904\u7406\u5b83\u4eec\u6765\u521b\u5efa\u4e00\u4e2a\u50a8\u5b58\u9876\u70b9\u4f4d\u7f6e\u7684\u6d6e\u70b9\u6570\u5217\u8868\u3002\u56e0\u4e3a\uff0c\u8be5\u65b9\u6cd5\u53ea\u8fd4\u56de\u4e00\u4e2a\u7f13\u51b2\u533a\uff0c\u4f60\u53ef\u4ee5\u5c06\u8be5\u6570\u636e\u76f4\u63a5\u4f20\u7ed9\u521b\u5efa\u9876\u70b9\u7684OpenGL\u65b9\u6cd5\u3002\u4f46\u6211\u4eec\u4e0d\u8fd9\u6837\u505a\uff0c\u539f\u56e0\u6709\u4e24\u4e2a\u3002\u7b2c\u4e00\u4e2a\u539f\u56e0\u662f\u5c3d\u91cf\u51cf\u5c11\u5bf9\u4ee3\u7801\u5e93\u7684\u4fee\u6539\uff0c\u7b2c\u4e8c\u4e2a\u539f\u56e0\u662f\uff0c\u901a\u8fc7\u52a0\u8f7d\u6570\u636e\u5230\u4e2d\u95f4\u5c42\u4e2d\uff0c\u4f60\u53ef\u4ee5\u6267\u884c\u4e00\u4e9b\u4e13\u95e8\u7684\u5904\u7406\u4efb\u52a1\uff0c\u751a\u81f3\u8c03\u8bd5\u52a0\u8f7d\u8fc7\u7a0b\u3002 \u5982\u679c\u4f60\u60f3\u8981\u4e00\u4e2a\u66f4\u6709\u6548\u7684\u793a\u4f8b\uff0c\u5373\u76f4\u63a5\u5c06\u7f13\u51b2\u533a\u4f20\u7ed9OpenGL\uff0c\u53ef\u4ee5\u67e5\u770b\u8fd9\u4e2a \u4f8b\u5b50 \u3002 StaticMeshesLoader \u7c7b\u8ba9 OBJLoader \u7c7b\u8fc7\u65f6\u4e86\uff0c\u56e0\u6b64\u5b83\u5df2\u7ecf\u4ece\u6e90\u4ee3\u7801\u4e2d\u5220\u9664\u3002\u4e00\u4e2a\u66f4\u590d\u6742\u7684OBJ\u6587\u4ef6\u5df2\u7ecf\u4f5c\u4e3a\u793a\u4f8b\u63d0\u4f9b\uff0c\u5982\u679c\u8fd0\u884c\u5b83\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a","title":"\u9759\u6001\u7f51\u683c"},{"location":"27-assimp/#_2","text":"\u73b0\u5728\u6211\u4eec\u5df2\u7ecf\u4f7f\u7528Assimp\u52a0\u8f7d\u4e86\u9759\u6001\u7f51\u683c\uff0c\u53ef\u4ee5\u7ee7\u7eed\u8bb2\u89e3\u52a8\u753b\u3002\u5982\u679c\u4f60\u56de\u60f3\u52a8\u753b\u4e00\u7ae0\uff0c\u4e0e\u7f51\u683c\u5173\u8054\u7684VAO\u5305\u542b\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u3001\u7d22\u5f15\u548c\u5e94\u5e94\u7528\u4e8e\u5173\u8282\u4f4d\u7f6e\u4ee5\u8c03\u6574\u6700\u7ec8\u9876\u70b9\u4f4d\u7f6e\u7684\u6743\u91cd\u5217\u8868\u3002 \u6bcf\u4e2a\u9876\u70b9\u4f4d\u7f6e\u90fd\u5173\u8054\u4e86\u4e00\u4e2a\u6539\u53d8\u6700\u7ec8\u4f4d\u7f6e\u7684\u56db\u4e2a\u6743\u91cd\u7684\u5217\u8868\uff0c\u5f15\u7528\u4e86\u5c06\u7ec4\u5408\u4ee5\u786e\u5b9a\u9876\u70b9\u6700\u7ec8\u4f4d\u7f6e\u7684\u9aa8\u9abc\u7d22\u5f15\u3002\u5728\u6bcf\u4e00\u5e27\uff0c\u4e00\u4e2a\u53d8\u6362\u77e9\u9635\u5217\u8868\u5c06\u88ab\u4f5c\u4e3aUniform\u52a0\u8f7d\u5230\u6bcf\u4e2a\u5173\u8282\u3002\u6839\u636e\u8fd9\u4e9b\u6570\u636e\uff0c\u7b97\u51fa\u6700\u7ec8\u4f4d\u7f6e\u3002 \u5728\u52a8\u753b\u4e00\u7ae0\u4e2d\uff0c\u6211\u4eec\u5f00\u53d1\u4e86\u4e00\u4e2aMD5\u89e3\u6790\u5668\u6765\u52a0\u8f7d\u52a8\u753b\u7f51\u683c\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4f7f\u7528Assimp\u5e93\u3002\u8fd9\u5c06\u5141\u8bb8\u6211\u4eec\u52a0\u8f7dMD5\u4e4b\u5916\u7684\u66f4\u591a\u683c\u5f0f\uff0c\u4f8b\u5982 COLLADA \uff0c FBX \u7b49\u3002 \u5728\u5f00\u59cb\u7f16\u7801\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7406\u6e05\u4e00\u4e9b\u672f\u8bed\u3002\u5728\u672c\u7ae0\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u52a0\u533a\u5206\u5730\u63d0\u5230\u9aa8\u9abc\u548c\u5173\u8282\u3002\u9aa8\u9abc\u6216\u8005\u5173\u8282\u90fd\u53ea\u662f\u5f71\u54cd\u9876\u70b9\u7684\u5143\u7d20\uff0c\u5e76\u4e14\u5177\u6709\u5f62\u6210\u5c42\u6b21\u7684\u7236\u7ea7\u3002MD5\u683c\u5f0f\u4f7f\u7528\u672f\u8bed\u5173\u8282\uff0c\u800cAssimp\u4f7f\u7528\u672f\u8bed\u9aa8\u9abc\u3002 \u8ba9\u6211\u4eec\u5148\u770b\u4e00\u4e0b\u7531Assimp\u5904\u7406\u7684\u50a8\u5b58\u7740\u52a8\u753b\u4fe1\u606f\u7684\u7ed3\u6784\u3002\u6211\u4eec\u5c06\u9996\u5148\u4ece\u9aa8\u9abc\u548c\u6743\u91cd\u6570\u636e\u5f00\u59cb\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u53ef\u4ee5\u8bbf\u95ee\u9876\u70b9\u4f4d\u7f6e\u3001\u7eb9\u7406\u5750\u6807\u548c\u7d22\u5f15\u3002\u7f51\u683c\u8fd8\u50a8\u5b58\u7740\u9aa8\u9abc\u5217\u8868\uff0c\u6bcf\u4e2a\u9aa8\u9abc\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u4e00\u4e2a\u504f\u79fb\u77e9\u9635\uff1a\u7a0d\u540e\u5c06\u7528\u5b83\u6765\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc\u5e94\u8be5\u4f7f\u7528\u7684\u6700\u7ec8\u53d8\u6362\u3002 \u9aa8\u9abc\u8fd8\u6307\u5411\u4e00\u4e2a\u6743\u91cd\u5217\u8868\uff0c\u6bcf\u4e2a\u6743\u91cd\u7531\u4ee5\u4e0b\u5c5e\u6027\u5b9a\u4e49\uff1a \u4e00\u4e2a\u6743\u91cd\u56e0\u5b50\uff0c\u5373\u7528\u4e8e\u8c03\u8282\u4e0e\u6bcf\u4e2a\u9876\u70b9\u76f8\u5173\u7684\u9aa8\u9abc\u53d8\u6362\u5f71\u54cd\u7684\u6570\u5b57\u3002 \u4e00\u4e2a\u9876\u70b9\u6807\u8bc6\u7b26\uff0c\u5373\u4e0e\u5f53\u524d\u9aa8\u9abc\u76f8\u5173\u8054\u7684\u9876\u70b9\u3002 \u4e0b\u56fe\u5c55\u73b0\u4e86\u6240\u6709\u8fd9\u4e9b\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\u3002 \u56e0\u6b64\uff0c\u6211\u4eec\u9996\u5148\u8981\u505a\u7684\u4e8b\u662f\u4ece\u4e0a\u8ff0\u7684\u7ed3\u6784\u6784\u9020\u9876\u70b9\u4f4d\u7f6e\u3001\u9aa8\u9abc/\u5173\u8282/\u7d22\u5f15\u548c\u76f8\u5173\u6743\u91cd\u7684\u5217\u8868\u3002\u5b8c\u6210\u540e\uff0c\u6211\u4eec\u9700\u8981\u4e3a\u6a21\u578b\u4e2d\u5b9a\u4e00\u4e2a\u6240\u6709\u52a8\u753b\u5e27\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u9aa8\u9abc/\u5173\u8282\u7684\u53d8\u6362\u77e9\u9635\u3002 Assimp\u573a\u666f\u5bf9\u8c61\u662f\u5b9a\u4e49\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u6bcf\u4e2a\u8282\u70b9\u90fd\u7531\u4e00\u4e2a\u540d\u8bcd\u548c\u4e00\u4e2a\u5b50\u8282\u70b9\u5217\u8868\u5b9a\u4e49\u3002\u52a8\u753b\u4f7f\u7528\u8fd9\u4e9b\u8282\u70b9\u6765\u5b9a\u4e49\u5e94\u8be5\u5e94\u7528\u7684\u53d8\u6362\uff0c\u8fd9\u4e2a\u5c42\u6b21\u7ed3\u6784\u5b9e\u9645\u4e0a\u5b9a\u4e49\u4e86\u9aa8\u9abc\u7684\u5c42\u6b21\u7ed3\u6784\u3002\u6bcf\u4e2a\u9aa8\u9abc\u90fd\u662f\u4e00\u4e2a\u8282\u70b9\uff0c\u5e76\u4e14\u6709\u4e00\u4e2a\u7236\u8282\u70b9\uff08\u6839\u8282\u70b9\u9664\u5916\uff09\uff0c\u53ef\u80fd\u8fd8\u6709\u4e00\u7ec4\u5b50\u8282\u70b9\u3002\u6709\u4e00\u4e9b\u7279\u6b8a\u7684\u8282\u70b9\u4e0d\u662f\u9aa8\u9abc\uff0c\u5b83\u4eec\u7528\u4e8e\u5bf9\u53d8\u6362\u8fdb\u884c\u5206\u7ec4\uff0c\u5728\u8ba1\u7b97\u53d8\u6362\u65f6\u8fdb\u884c\u5904\u7406\u3002\u53e6\u4e00\u4e2a\u95ee\u9898\u662f\uff0c\u8fd9\u4e9b\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\u662f\u57fa\u4e8e\u6574\u4e2a\u6a21\u578b\u5b9a\u4e49\u7684\uff0c\u5bf9\u4e8e\u6bcf\u4e2a\u7f51\u683c\uff0c\u6211\u4eec\u6ca1\u6709\u5355\u72ec\u7684\u5c42\u6b21\u7ed3\u6784\u3002 \u573a\u666f\u8fd8\u5b9a\u4e49\u4e86\u4e00\u7ec4\u52a8\u753b\u3002\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u53ef\u4ee5\u5bf9\u6a21\u578b\u505a\u884c\u8d70\u3001\u8dd1\u52a8\u7b49\u52a8\u753b\u3002\u6bcf\u4e2a\u52a8\u753b\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\u3002\u52a8\u753b\u5177\u6709\u4ee5\u4e0b\u5c5e\u6027\uff1a \u4e00\u4e2a\u540d\u5b57\u3002 \u6301\u7eed\u65f6\u95f4\u3002\u5373\u52a8\u753b\u7684\u6301\u7eed\u65f6\u95f4\uff0c\u7531\u4e8e\u52a8\u753b\u662f\u5e94\u7528\u4e8e\u6bcf\u4e2a\u4e0d\u540c\u5e27\u7684\u6bcf\u4e2a\u8282\u70b9\u7684\u53d8\u6362\u5217\u8868\uff0c\u56e0\u6b64\u540d\u79f0\u53ef\u80fd\u770b\u8d77\u6765\u5f88\u6df7\u4e71\u3002 \u4e00\u4e2a\u52a8\u753b\u901a\u9053\uff08Animation Channel\uff09\u7684\u5217\u8868\u3002\u52a8\u753b\u901a\u9053\u50a8\u5b58\u5e94\u5e94\u7528\u4e8e\u6bcf\u4e2a\u8282\u70b9\u7684\u7279\u5b9a\u65f6\u95f4\u70b9\u7684\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u6570\u636e\uff0c\u6a21\u578b\u4e2d\u50a8\u5b58\u52a8\u753b\u901a\u9053\u6570\u636e\u7684\u7c7b\u662f AINodeAnim \u3002 \u4e0b\u56fe\u5c55\u793a\u4e86\u4e0a\u8ff0\u6240\u6709\u5143\u7d20\u4e4b\u95f4\u7684\u5173\u7cfb\uff1a \u5bf9\u4e8e\u7279\u5b9a\u7684\u65f6\u523b\uff0c\u6216\u8005\u8bf4\u5bf9\u4e8e\u5e27\uff0c\u8981\u5e94\u7528\u5230\u9aa8\u9abc\u7684\u53d8\u6362\u662f\u5728\u52a8\u753b\u901a\u9053\u4e2d\u4e3a\u8be5\u65f6\u523b\u5b9a\u4e49\u7684\u53d8\u6362\uff0c\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u5230\u6839\u8282\u70b9\u7684\u53d8\u6362\u3002\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5bf9\u573a\u666f\u4e2d\u5b58\u50a8\u7684\u4fe1\u606f\u8fdb\u884c\u91cd\u65b0\u6392\u5e8f\uff0c\u6d41\u7a0b\u5982\u4e0b\uff1a \u6784\u9020\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u3002 \u5bf9\u6bcf\u4e2a\u52a8\u753b\uff0c\u8fed\u4ee3\u6bcf\u4e2a\u52a8\u753b\u901a\u9053\uff08\u5bf9\u6bcf\u4e2a\u52a8\u753b\u8282\u70b9\uff09\uff1a\u4e3a\u6240\u6709\u5e27\u6784\u9020\u53d8\u6362\u77e9\u9635\u3002\u53d8\u6362\u77e9\u9635\u662f\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u77e9\u9635\u7684\u7ec4\u5408\u3002 \u91cd\u65b0\u6392\u5217\u6bcf\u4e00\u5e27\u7684\u4fe1\u606f\uff1a\u6784\u9020\u8981\u5e94\u7528\u4e8e\u7f51\u683c\u4e2d\u6bcf\u4e2a\u9aa8\u9abc\u7684\u6700\u7ec8\u53d8\u6362\u3002\u8fd9\u662f\u901a\u8fc7\u5c06\u9aa8\u9abc\u7684\u53d8\u6362\u77e9\u9635\uff08\u76f8\u5173\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\uff09\u4e58\u4ee5\u6240\u6709\u7236\u8282\u70b9\u7684\u53d8\u6362\u77e9\u9635\u76f4\u5230\u6839\u8282\u70b9\u6765\u5b9e\u73b0\u7684\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\u3002\u9996\u5148\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a AnimMeshesLoader \u7684\u7c7b\uff0c\u5b83\u7531 StaticMeshesLoader \u6269\u5c55\uff0c\u4f46\u5b83\u4e0d\u8fd4\u56de\u7f51\u683c\u6570\u7ec4\uff0c\u800c\u662f\u8fd4\u56de\u4e00\u4e2a AnimGameItem \u5b9e\u4f8b\u3002\u5b83\u5b9a\u4e49\u4e86\u4e24\u4e2a\u516c\u5171\u65b9\u6cd5\uff1a public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir) throws Exception { return loadAnimGameItem(resourcePath, texturesDir, aiProcess_GenSmoothNormals | aiProcess_JoinIdenticalVertices | aiProcess_Triangulate | aiProcess_FixInfacingNormals | aiProcess_LimitBoneWeights); } public static AnimGameItem loadAnimGameItem(String resourcePath, String texturesDir, int flags) throws Exception { AIScene aiScene = aiImportFile(resourcePath, flags); if (aiScene == null) { throw new Exception(\"Error loading model\"); } int numMaterials = aiScene.mNumMaterials(); PointerBuffer aiMaterials = aiScene.mMaterials(); List<Material> materials = new ArrayList<>(); for (int i = 0; i < numMaterials; i++) { AIMaterial aiMaterial = AIMaterial.create(aiMaterials.get(i)); processMaterial(aiMaterial, materials, texturesDir); } List<Bone> boneList = new ArrayList<>(); int numMeshes = aiScene.mNumMeshes(); PointerBuffer aiMeshes = aiScene.mMeshes(); Mesh[] meshes = new Mesh[numMeshes]; for (int i = 0; i < numMeshes; i++) { AIMesh aiMesh = AIMesh.create(aiMeshes.get(i)); Mesh mesh = processMesh(aiMesh, materials, boneList); meshes[i] = mesh; } AINode aiRootNode = aiScene.mRootNode(); Matrix4f rootTransfromation = AnimMeshesLoader.toMatrix(aiRootNode.mTransformation()); Node rootNode = processNodesHierarchy(aiRootNode, null); Map<String, Animation> animations = processAnimations(aiScene, boneList, rootNode, rootTransfromation); AnimGameItem item = new AnimGameItem(meshes, animations); return item; } \u8fd9\u4e9b\u65b9\u6cd5\u4e0e StaticMeshesLoader \u4e2d\u5b9a\u4e49\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u4f46\u6709\u5982\u4e0b\u533a\u522b\uff1a \u4f20\u9012\u9ed8\u8ba4\u52a0\u8f7d\u6807\u8bb0\u7684\u65b9\u6cd5\u4f7f\u7528\u4e86\u65b0\u53c2\u6570\uff1a aiProcess_LimitBoneWeights \u3002\u8fd9\u5c06\u4f1a\u5c06\u5f71\u54cd\u9876\u70b9\u7684\u6700\u5927\u6743\u91cd\u6570\u9650\u5236\u4e3a4\uff08\u8fd9\u4e5f\u662f\u6211\u4eec\u5f53\u524d\u5728\u52a8\u753b\u7ae0\u8282\u4e2d\u652f\u6301\u7684\u6700\u5927\u503c\uff09\u3002 \u5b9e\u9645\u52a0\u8f7d\u6a21\u578b\u7684\u65b9\u6cd5\u53ea\u52a0\u8f7d\u4e0d\u540c\u7684\u7f51\u683c\uff0c\u4f46\u5b83\u9996\u5148\u8ba1\u7b97\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u7136\u540e\u5728\u7ed3\u5c3e\u8c03\u7528 processAnimations \u4ee5\u751f\u6210 AnimGameItem \u5b9e\u4f8b\u3002 processMesh \u65b9\u6cd5\u4e0e StaticMeshesLoader \u7c7b\u4e2d\u7684\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\uff0c\u53ea\u662f\u5b83\u521b\u5efa\u7684\u7f51\u683c\u5c06\u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u4f5c\u4e3a\u53c2\u6570\u4f20\u9012\uff1a processBones(aiMesh, boneList, boneIds, weights); Mesh mesh = new Mesh(Utils.listToArray(vertices), Utils.listToArray(textures), Utils.listToArray(normals), Utils.listIntToArray(indices), Utils.listIntToArray(boneIds), Utils.listToArray(weights)); \u5173\u8282\u7d22\u5f15\u548c\u6743\u91cd\u6309 processBones \u65b9\u6cd5\u8ba1\u7b97\uff1a private static void processBones(AIMesh aiMesh, List<Bone> boneList, List<Integer> boneIds, List<Float> weights) { Map<Integer, List<VertexWeight>> weightSet = new HashMap<>(); int numBones = aiMesh.mNumBones(); PointerBuffer aiBones = aiMesh.mBones(); for (int i = 0; i < numBones; i++) { AIBone aiBone = AIBone.create(aiBones.get(i)); int id = boneList.size(); Bone bone = new Bone(id, aiBone.mName().dataString(), toMatrix(aiBone.mOffsetMatrix())); boneList.add(bone); int numWeights = aiBone.mNumWeights(); AIVertexWeight.Buffer aiWeights = aiBone.mWeights(); for (int j = 0; j < numWeights; j++) { AIVertexWeight aiWeight = aiWeights.get(j); VertexWeight vw = new VertexWeight(bone.getBoneId(), aiWeight.mVertexId(), aiWeight.mWeight()); List<VertexWeight> vertexWeightList = weightSet.get(vw.getVertexId()); if (vertexWeightList == null) { vertexWeightList = new ArrayList<>(); weightSet.put(vw.getVertexId(), vertexWeightList); } vertexWeightList.add(vw); } } int numVertices = aiMesh.mNumVertices(); for (int i = 0; i < numVertices; i++) { List<VertexWeight> vertexWeightList = weightSet.get(i); int size = vertexWeightList != null ? vertexWeightList.size() : 0; for (int j = 0; j < Mesh.MAX_WEIGHTS; j++) { if (j < size) { VertexWeight vw = vertexWeightList.get(j); weights.add(vw.getWeight()); boneIds.add(vw.getBoneId()); } else { weights.add(0.0f); boneIds.add(0); } } } } \u6b64\u65b9\u6cd5\u904d\u5386\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u5b9a\u4e49\uff0c\u83b7\u53d6\u5176\u6743\u91cd\u5e76\u751f\u6210\u4e09\u4e2a\u5217\u8868\uff1a boneList \uff1a\u50a8\u5b58\u8282\u70b9\u53ca\u5176\u504f\u79fb\u77e9\u9635\u7684\u5217\u8868\u3002\u7a0d\u540e\u5c06\u4f7f\u7528\u5b83\u6765\u8ba1\u7b97\u8282\u70b9\u53d8\u6362\u3002\u5df2\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a Bone \u7684\u65b0\u7c7b\u6765\u50a8\u5b58\u8be5\u4fe1\u606f\u3002\u6b64\u5217\u8868\u5c06\u50a8\u5b58\u6240\u6709\u7f51\u683c\u7684\u9aa8\u9abc\u3002 boneIds \uff1a\u53ea\u50a8\u5b58\u5305\u542b Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u9aa8\u9abc\u6807\u8bc6\u3002\u9aa8\u9abc\u5728\u6e32\u67d3\u65f6\u6839\u636e\u5176\u4f4d\u7f6e\u8fdb\u884c\u6807\u8bc6\uff0c\u6b64\u5217\u8868\u4ec5\u5305\u542b\u7279\u5b9a\u7f51\u683c\u7684\u9aa8\u9abc\u3002 weights \uff1a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u5173\u8054\u9aa8\u9abc\u7684 Mesh \u7684\u6bcf\u4e2a\u9876\u70b9\u7684\u6743\u91cd\u3002 weights \u548c boneIds \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u7528\u4e8e\u6784\u9020 Mesh \u6570\u636e\u3002 boneList \u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5c06\u5728\u7a0d\u540e\u8ba1\u7b97\u52a8\u753b\u6570\u636e\u65f6\u4f7f\u7528\u3002 \u8ba9\u6211\u4eec\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\u3002\u4e00\u65e6\u6211\u4eec\u521b\u5efa\u4e86\u7f51\u683c\uff0c\u8fd8\u5f97\u5230\u4e86\u5e94\u7528\u4e8e\u6839\u8282\u70b9\u7684\u53d8\u6362\uff0c\u8be5\u53d8\u6362\u4e5f\u5c06\u7528\u4e8e\u8ba1\u7b97\u6700\u7ec8\u7684\u53d8\u6362\u3002\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u5904\u7406\u8282\u70b9\u7684\u5c42\u6b21\u7ed3\u6784\uff0c\u8fd9\u662f\u5728 processNodesHierarchy \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002\u8fd9\u4e2a\u65b9\u6cd5\u975e\u5e38\u7b80\u5355\uff0c\u5b83\u53ea\u662f\u4ece\u6839\u8282\u70b9\u5f00\u59cb\u904d\u5386\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u6784\u9020\u4e00\u4e2a\u8282\u70b9\u6811\u3002 private static Node processNodesHierarchy(AINode aiNode, Node parentNode) { String nodeName = aiNode.mName().dataString(); Node node = new Node(nodeName, parentNode); int numChildren = aiNode.mNumChildren(); PointerBuffer aiChildren = aiNode.mChildren(); for (int i = 0; i < numChildren; i++) { AINode aiChildNode = AINode.create(aiChildren.get(i)); Node childNode = processNodesHierarchy(aiChildNode, node); node.addChild(childNode); } return node; } \u6211\u4eec\u5df2\u7ecf\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Node \u7c7b\uff0c\u8be5\u7c7b\u5c06\u50a8\u5b58 AINode \u5b9e\u4f8b\u7684\u76f8\u5173\u4fe1\u606f\uff0c\u5e76\u63d0\u4f9b\u4e86\u67e5\u627e\u65b9\u6cd5\u6765\u5b9a\u4f4d\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\uff0c\u4ee5\u4fbf\u6309\u540d\u79f0\u67e5\u627e\u8282\u70b9\u3002\u56de\u5230 loadAnimGameItem \u65b9\u6cd5\uff0c\u6211\u4eec\u53ea\u4f7f\u7528\u8be5\u6570\u636e\u8ba1\u7b97 processAnimations \u65b9\u6cd5\u4e2d\u7684\u52a8\u753b\u3002\u8be5\u65b9\u6cd5\u8fd4\u56de Animation \u5b9e\u4f8b\u7684 Map \u3002\u8bf7\u8bb0\u4f4f\uff0c\u4e00\u4e2a\u6a21\u578b\u53ef\u4ee5\u6709\u591a\u4e2a\u52a8\u753b\uff0c\u56e0\u6b64\u5b83\u4eec\u6309\u540d\u79f0\u50a8\u5b58\u7d22\u5f15\u3002\u6709\u4e86\u8fd9\u4e9b\u6570\u636e\uff0c\u6211\u4eec\u7ec8\u4e8e\u53ef\u4ee5\u6784\u5efa\u4e00\u4e2a AnimAgameItem \u5b9e\u4f8b\u3002 processAnimations \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a private static Map<String, Animation> processAnimations(AIScene aiScene, List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { Map<String, Animation> animations = new HashMap<>(); // \u5904\u7406\u6240\u6709\u52a8\u753b int numAnimations = aiScene.mNumAnimations(); PointerBuffer aiAnimations = aiScene.mAnimations(); for (int i = 0; i < numAnimations; i++) { AIAnimation aiAnimation = AIAnimation.create(aiAnimations.get(i)); // \u4e3a\u6bcf\u4e2a\u8282\u70b9\u8ba1\u7b97\u53d8\u6362\u77e9\u9635 int numChanels = aiAnimation.mNumChannels(); PointerBuffer aiChannels = aiAnimation.mChannels(); for (int j = 0; j < numChanels; j++) { AINodeAnim aiNodeAnim = AINodeAnim.create(aiChannels.get(j)); String nodeName = aiNodeAnim.mNodeName().dataString(); Node node = rootNode.findByName(nodeName); buildTransFormationMatrices(aiNodeAnim, node); } List<AnimatedFrame> frames = buildAnimationFrames(boneList, rootNode, rootTransformation); Animation animation = new Animation(aiAnimation.mName().dataString(), frames, aiAnimation.mDuration()); animations.put(animation.getName(), animation); } return animations; } \u5c06\u4e3a\u6bcf\u4e2a\u52a8\u753b\u5904\u7406\u5176\u52a8\u753b\u901a\u9053\uff0c\u6bcf\u4e2a\u901a\u9053\u5b9a\u4e49\u4e86\u4e0d\u540c\u7684\u53d8\u6362\uff0c\u8fd9\u4e9b\u53d8\u5316\u5e94\u8be5\u968f\u7740\u65f6\u95f4\u7684\u63a8\u79fb\u5e94\u7528\u4e8e\u4e00\u4e2a\u8282\u70b9\u3002\u4e3a\u6bcf\u4e2a\u8282\u70b9\u5b9a\u4e49\u7684\u53d8\u6362\u5728 buildTransFormationMatrices \u65b9\u6cd5\u4e2d\u5b9a\u4e49\uff0c\u8fd9\u4e9b\u77e9\u9635\u88ab\u6bcf\u4e2a\u8282\u70b9\u50a8\u5b58\u3002\u4e00\u65e6\u8282\u70b9\u5c42\u6b21\u7ed3\u6784\u4e2d\u50a8\u5b58\u5b8c\u8fd9\u4e9b\u4fe1\u606f\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u6784\u5efa\u52a8\u753b\u5e27\u3002 \u8ba9\u6211\u4eec\u5148\u56de\u987e\u4e00\u4e0b buildTransFormationMatrices \u65b9\u6cd5\uff1a private static void buildTransFormationMatrices(AINodeAnim aiNodeAnim, Node node) { int numFrames = aiNodeAnim.mNumPositionKeys(); AIVectorKey.Buffer positionKeys = aiNodeAnim.mPositionKeys(); AIVectorKey.Buffer scalingKeys = aiNodeAnim.mScalingKeys(); AIQuatKey.Buffer rotationKeys = aiNodeAnim.mRotationKeys(); for (int i = 0; i < numFrames; i++) { AIVectorKey aiVecKey = positionKeys.get(i); AIVector3D vec = aiVecKey.mValue(); Matrix4f transfMat = new Matrix4f().translate(vec.x(), vec.y(), vec.z()); AIQuatKey quatKey = rotationKeys.get(i); AIQuaternion aiQuat = quatKey.mValue(); Quaternionf quat = new Quaternionf(aiQuat.x(), aiQuat.y(), aiQuat.z(), aiQuat.w()); transfMat.rotate(quat); if (i < aiNodeAnim.mNumScalingKeys()) { aiVecKey = scalingKeys.get(i); vec = aiVecKey.mValue(); transfMat.scale(vec.x(), vec.y(), vec.z()); } node.addTransformation(transfMat); } } \u5982\u4f60\u6240\u89c1\uff0c AINodeAnim \u5b9e\u4f8b\u5b9a\u4e49\u4e86\u4e00\u7ec4\u5305\u542b\u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4fe1\u606f\u7684\u952e\uff0c\u8fd9\u4e9b\u952e\u662f\u6307\u7279\u5b9a\u7684\u65f6\u523b\u3002\u6211\u4eec\u5047\u8bbe\u6570\u636e\u662f\u6309\u65f6\u95f4\u987a\u5e8f\u6392\u5217\u7684\uff0c\u5e76\u6784\u5efa\u4e00\u4e2a\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u6bcf\u4e2a\u5e27\u7684\u53d8\u6362\u7684\u77e9\u9635\u5217\u8868\u3002\u6700\u540e\u7684\u8ba1\u7b97\u662f\u5728 buildAnimationFrames \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private static List<AnimatedFrame> buildAnimationFrames(List<Bone> boneList, Node rootNode, Matrix4f rootTransformation) { int numFrames = rootNode.getAnimationFrames(); List<AnimatedFrame> frameList = new ArrayList<>(); for (int i = 0; i < numFrames; i++) { AnimatedFrame frame = new AnimatedFrame(); frameList.add(frame); int numBones = boneList.size(); for (int j = 0; j < numBones; j++) { Bone bone = boneList.get(j); Node node = rootNode.findByName(bone.getBoneName()); Matrix4f boneMatrix = Node.getParentTransforms(node, i); boneMatrix.mul(bone.getOffsetMatrix()); boneMatrix = new Matrix4f(rootTransformation).mul(boneMatrix); frame.setMatrix(j, boneMatrix); } } return frameList; } \u6b64\u65b9\u6cd5\u8fd4\u56de AnimatedFrame \u5b9e\u4f8b\u7684\u5217\u8868\uff0c\u6bcf\u4e2a AnimatedFrame \u5b9e\u4f8b\u5c06\u50a8\u5b58\u8981\u5e94\u7528\u4e8e\u7279\u5b9a\u5e27\u7684\u6bcf\u4e2a\u9aa8\u9abc\u7684\u53d8\u6362\u5217\u8868\u3002\u8fd9\u4e2a\u65b9\u6cd5\u53ea\u662f\u8fed\u4ee3\u50a8\u5b58\u6240\u6709\u9aa8\u9abc\u7684\u5217\u8868\u3002\u5bf9\u4e8e\u6bcf\u4e2a\u9aa8\u9abc\uff1a \u83b7\u53d6\u76f8\u5173\u8054\u7684\u8282\u70b9\u3002 \u901a\u8fc7\u5c06\u76f8\u5173\u8054\u7684 Node \u7684\u53d8\u6362\u4e0e\u5176\u7236\u8282\u70b9\u7684\u6240\u6709\u53d8\u6362\u76f8\u4e58\uff0c\u751f\u6210\u53d8\u6362\u77e9\u9635\uff0c\u76f4\u81f3\u6839\u8282\u70b9\u3002\u8fd9\u662f\u5728 Node.getParentTransforms \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\u3002 \u5b83\u5c06\u8be5\u77e9\u9635\u4e0e\u9aa8\u9abc\u7684\u504f\u501a\u77e9\u9635\u76f8\u4e58\u3002 \u6700\u540e\u7684\u53d8\u6362\u662f\u901a\u8fc7\u5c06\u6839\u8282\u70b9\u7684\u53d8\u6362\u4e0e\u4e0a\u8ff0\u6b65\u9aa4\u4e2d\u8ba1\u7b97\u7684\u77e9\u9635\u76f8\u4e58\u6765\u8ba1\u7b97\u7684\u3002 \u6e90\u4ee3\u7801\u4e2d\u7684\u5176\u4ed6\u4fee\u6539\u662f\u4e3a\u4e86\u9002\u5e94\u67d0\u4e9b\u7ed3\u6784\u800c\u8fdb\u884c\u7684\u5fae\u5c0f\u4fee\u6539\u3002\u6700\u540e\uff0c\u4f60\u80fd\u591f\u52a0\u8f7d\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u52a8\u753b\uff08\u4f60\u9700\u8981\u6309\u7a7a\u683c\u6539\u53d8\u5e27\uff09\uff1a \u8fd9\u4e2a\u793a\u4f8b\u7684\u590d\u6742\u4e4b\u5904\u5728\u4e8eAssimp\u7ed3\u6784\u7684\u8c03\u6574\uff0c\u4f7f\u5176\u9002\u5e94\u672c\u4e66\u4e2d\u4f7f\u7528\u7684\u5f15\u64ce\uff0c\u5e76\u9884\u5148\u8ba1\u7b97\u6bcf\u4e2a\u5e27\u7684\u6570\u636e\u3002\u6b64\u5916\uff0c\u8fd9\u4e9b\u6982\u5ff5\u4e0e\u52a8\u753b\u4e00\u7ae0\u4e2d\u7684\u6982\u5ff5\u7c7b\u4f3c\u3002\u4f60\u53ef\u4ee5\u5c1d\u8bd5\u4fee\u6539\u6e90\u4ee3\u7801\u4ee5\u5728\u5e27\u4e4b\u95f4\u63d2\u5165\uff0c\u4ee5\u83b7\u5f97\u66f4\u5e73\u6ed1\u7684\u52a8\u753b\u3002","title":"\u52a8\u753b"},{"location":"28-deferred-shading/","text":"\u5ef6\u8fdf\u7740\u8272\u6cd5\uff08Deferred Shading\uff09 \u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u65b9\u5f0f\u79f0\u4e3a\u6b63\u5411\u6e32\u67d3\u6cd5\uff08Forward Rendering\uff09\u3002\u6211\u4eec\u9996\u5148\u6e32\u67d33D\u5bf9\u8c61\uff0c\u5e76\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u7eb9\u7406\u548c\u5149\u7167\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u6709\u4e00\u4e2a\u5177\u6709\u591a\u79cd\u5149\u7167\u548c\u590d\u6742\u6548\u679c\u7684\u590d\u6742\u7247\u5143\u7740\u8272\u5668\u5904\u7406\u9636\u6bb5\uff0c\u8fd9\u79cd\u65b9\u6cd5\u5c31\u4e0d\u662f\u5f88\u9ad8\u6548\u3002\u6b64\u5916\uff0c\u6211\u4eec\u6700\u7ec8\u53ef\u80fd\u4f1a\u5c06\u8fd9\u4e9b\u6548\u679c\u5e94\u7528\u5230\u7a0d\u540e\u53ef\u80fd\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\u800c\u88ab\u4e22\u5f03\u7684\u7247\u5143\u4e0a\uff08\u5c3d\u7ba1\u8fd9\u5e76\u4e0d\u5b8c\u5168\u6b63\u786e\uff0c\u5982\u679c\u6211\u4eec\u542f\u7528 \u65e9\u671f\u7247\u5143\u6d4b\u8bd5 \u7684\u8bdd\uff09\u3002 \u4e3a\u4e86\u7f13\u89e3\u4e0a\u8ff0\u95ee\u9898\uff0c\u6211\u4eec\u53ef\u4ee5\u6539\u53d8\u65b9\u5f0f\uff0c\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u5ef6\u8fdf\u7740\u8272\u6cd5\u7684\u6280\u672f\u6765\u6e32\u67d3\u573a\u666f\u3002\u901a\u8fc7\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u5148\u5c06\u540e\u671f\uff08\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff09\u6240\u9700\u7684\u51e0\u4f55\u4fe1\u606f\u6e32\u67d3\u5230\u7f13\u51b2\u533a\u3002\u5f53\u4f7f\u7528\u50a8\u5b58\u5728\u8fd9\u4e9b\u7f13\u51b2\u533a\u4e2d\u7684\u4fe1\u606f\u65f6\uff0c\u7247\u5143\u7740\u8272\u5668\u6240\u9700\u7684\u590d\u6742\u8fd0\u7b97\u88ab\u63a8\u8fdf\uff08Postpone\uff09\u3001\u5ef6\u8fdf\uff08Defer\uff09\u5230\u4e4b\u540e\u7684\u9636\u6bb5\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u8fdb\u884c\u4e24\u4e2a\u6e32\u67d3\u9636\u6bb5\uff08Pass\uff09\u3002\u7b2c\u4e00\u4e2a\u662f\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff0c\u6211\u4eec\u5c06\u573a\u666f\u6e32\u67d3\u5230\u50a8\u5b58\u4ee5\u4e0b\u6570\u636e\u7684\u7f13\u51b2\u533a\u4e2d\uff1a \u4f4d\u7f6e\uff08\u5728\u672c\u4f8b\u4e2d\uff0c\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff0c\u5c3d\u7ba1\u4f60\u53ef\u4ee5\u770b\u5230\u4f7f\u7528\u4e16\u754c\u5750\u6807\u7684\u5176\u4ed6\u793a\u4f8b\uff09\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6f2b\u53cd\u5c04\u989c\u8272\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6cd5\u7ebf\uff08\u4e5f\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6709\u5411\u5149\u7684\u9634\u5f71\u56fe\uff08\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u4e00\u6b65\u5728\u5176\u4ed6\u5b9e\u73b0\u4e2d\u662f\u5355\u72ec\u5b8c\u6210\u7684\uff09\u3002 \u6240\u6709\u8fd9\u4e9b\u6570\u636e\u90fd\u5b58\u50a8\u5728\u4e00\u4e2a\u79f0\u4e3aG\u7f13\u51b2\u533a\uff08G-Buffer\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002 \u7b2c\u4e8c\u4e2a\u9636\u6bb5\u79f0\u4e3a\u5149\u7167\u5904\u7406\u9636\u6bb5\uff0c\u8be5\u9636\u6bb5\u9700\u8981\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\uff0c\u5e76\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u4fe1\u606f\u4e3a\u6bcf\u4e2a\u7247\u5143\u751f\u6210\u989c\u8272\u4fe1\u606f\u3002\u5f53\u6211\u4eec\u8fdb\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\uff0c\u6df1\u5ea6\u6d4b\u8bd5\u5c06\u5220\u9664\u6240\u6709\u770b\u4e0d\u5230\u7684\u573a\u666f\u6570\u636e\u3002\u56e0\u6b64\uff0c\u8981\u6267\u884c\u7684\u64cd\u4f5c\u6570\u91cf\u4ec5\u9650\u4e8e\u5c06\u5728\u5c4f\u5e55\u4e0a\u663e\u793a\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u95ee\u8fdb\u884c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u80fd\u5426\u63d0\u9ad8\u6027\u80fd\uff0c\u7b54\u6848\u662f\u89c6\u60c5\u51b5\u800c\u5b9a\u3002\u5ef6\u8fdf\u7740\u8272\u6cd5\u901a\u5e38\u5728\u6709\u8bb8\u591a\u4e0d\u540c\u7684\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u5c06\u901a\u8fc7\u51cf\u5c11\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u6267\u884c\u7684\u64cd\u4f5c\u6765\u8865\u507f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u4e3aG\u7f13\u51b2\u533a\u521b\u5efa\u4e00\u4e2a\u65b0\u7c7b\uff0c\u540d\u4e3a GBuffer \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine.graph; import org.lwjgl.system.MemoryStack; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import java.nio.IntBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL20.*; import static org.lwjgl.opengl.GL30.*; public class GBuffer { private static final int TOTAL_TEXTURES = 6; private int gBufferId; private int[] textureIds; private int width; private int height; \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5e38\u91cf\uff0c\u8be5\u5e38\u91cf\u4e3a\u8981\u4f7f\u7528\u7684\u6700\u5927\u7f13\u51b2\u533a\u6570\u5efa\u6a21\u3002\u4e0eG\u7f13\u51b2\u533a\u672c\u8eab\u5173\u8054\u7684ID\uff0c\u4ee5\u53ca\u5355\u4e2a\u7f13\u51b2\u533a\u7684\u6570\u7ec4\uff0c\u5c4f\u5e55\u7684\u5927\u5c0f\u4e5f\u4f1a\u88ab\u50a8\u5b58\u3002 \u8ba9\u6211\u4eec\u770b\u4e00\u4e0b\u6784\u9020\u51fd\u6570\uff1a public GBuffer(Window window) throws Exception { // \u521b\u5efaG\u7f13\u51b2\u533a gBufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBufferId); textureIds = new int[TOTAL_TEXTURES]; glGenTextures(textureIds); this.width = window.getWidth(); this.height = window.getHeight(); // \u4e3a\u4f4d\u7f6e\u3001\u6f2b\u53cd\u5c04\u989c\u8272\u3001\u955c\u9762\u53cd\u5c04\u989c\u8272\u3001\u6cd5\u7ebf\u3001\u9634\u5f71\u56e0\u5b50\u548c\u6df1\u5ea6\u521b\u5efa\u7eb9\u7406 // \u6240\u6709\u5750\u6807\u90fd\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d for(int i=0; i<TOTAL_TEXTURES; i++) { glBindTexture(GL_TEXTURE_2D, textureIds[i]); int attachmentType; switch(i) { case TOTAL_TEXTURES - 1: // \u6df1\u5ea6\u5206\u91cf glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT32F, width, height, 0, GL_DEPTH_COMPONENT, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_DEPTH_ATTACHMENT; break; default: glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, width, height, 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_COLOR_ATTACHMENT0 + i; break; } // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u5c06\u7eb9\u7406\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, attachmentType, GL_TEXTURE_2D, textureIds[i], 0); } try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer intBuff = stack.mallocInt(TOTAL_TEXTURES); int values[] = {GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1, GL_COLOR_ATTACHMENT2, GL_COLOR_ATTACHMENT3, GL_COLOR_ATTACHMENT4, GL_COLOR_ATTACHMENT5}; for(int i = 0; i < values.length; i++) { intBuff.put(values[i]); } intBuff.flip(); glDrawBuffers(intBuff); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u9996\u5148\u6211\u4eec\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8bb0\u4f4f\uff0c\u5e27\u7f13\u51b2\u533a\u53ea\u662f\u4e00\u4e2aOpenGL\u5bf9\u8c61\uff0c\u53ef\u7528\u4e8e\u6e32\u67d3\u64cd\u4f5c\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5230\u5c4f\u5e55\u3002\u7136\u540e\u6211\u4eec\u751f\u6210\u4e00\u7ec4\u7eb9\u7406\uff086\u4e2a\u7eb9\u7406\uff09\uff0c\u8fd9\u4e9b\u7eb9\u7406\u5c06\u4e0e\u5e27\u7f13\u51b2\u533a\u5173\u8054\u3002 \u4e4b\u540e\uff0c\u6211\u4eec\u4f7f\u7528for\u5faa\u73af\u6765\u521d\u59cb\u5316\u7eb9\u7406\uff0c\u6709\u5982\u4e0b\u7c7b\u578b\uff1a \u201c\u5e38\u89c4\u7eb9\u7406\u201d\uff0c\u5c06\u50a8\u5b58\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u548c\u6f2b\u53cd\u5c04\u5206\u91cf\u7b49\u3002 \u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u7eb9\u7406\uff0c\u8fd9\u5c06\u662f\u6700\u540e\u7684\u7eb9\u7406\u3002 \u7eb9\u7406\u521d\u59cb\u5316\u540e\uff0c\u6211\u4eec\u4e3a\u5b83\u4eec\u542f\u7528\u91c7\u6837\u5e76\u5c06\u5b83\u4eec\u7ed1\u5b9a\u5230\u5e27\u7f13\u51b2\u533a\u3002\u6bcf\u4e2a\u7eb9\u7406\u4f7f\u7528\u4ee5 GL_COLOR_ATTACHMENT0 \u4e3a\u5f00\u5934\u7684ID\u8fdb\u884c\u7ed1\u5b9a\u3002\u6bcf\u4e2a\u7eb9\u7406\u90fd\u4ee5\u8be5ID\u9012\u589e\u4e00\u4f4d\uff0c\u56e0\u6b64\u5750\u6807\u4f7f\u7528 GL_COLOR_ATTACHMENT0 \u7ed1\u5b9a\uff0c\u6f2b\u53cd\u5c04\u5206\u91cf\u4f7f\u7528 GL_COLOR_ATTACHMENT1 \uff08\u5373 GL_COLOR_ATTACHMENT0 + 1 \uff09\u9644\u52a0\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u5728\u521b\u5efa\u5b8c\u6240\u6709\u7eb9\u7406\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ba9\u7247\u5143\u7740\u8272\u5668\u4f7f\u7528\u5b83\u4eec\u8fdb\u884c\u6e32\u67d3\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glDrawBuffers \u5b8c\u6210\u7684\u3002\u6211\u4eec\u53ea\u4f20\u9012\u5e26\u6709\u6240\u7528\u989c\u8272\u7ed1\u5b9a\u7684ID\u7684\u6570\u7ec4\uff08 GL_COLOR_ ATTACHMENT0 \u5230 GL_COLOR_ATTACHMENT5 \uff09\u3002 \u7c7b\u7684\u5176\u4ed6\u90e8\u5206\u53ea\u662fgetter\u65b9\u6cd5\u548c cleanup \u65b9\u6cd5\u3002 public int getWidth() { return width; } public int getHeight() { return height; } public int getGBufferId() { return gBufferId; } public int[] getTextureIds() { return textureIds; } public int getPositionTexture() { return textureIds[0]; } public int getDepthTexture() { return textureIds[TOTAL_TEXTURES-1]; } public void cleanUp() { glDeleteFramebuffers(gBufferId); if (textureIds != null) { for (int i=0; i<TOTAL_TEXTURES; i++) { glDeleteTextures(textureIds[i]); } } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SceneBuffer \u7684\u65b0\u7c7b\uff0c\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\uff0c\u5c06\u5728\u6267\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u4e0d\u76f4\u63a5\u6e32\u67d3\u5230\u5c4f\u5e55\uff0c\u800c\u662f\u6e32\u67d3\u5230\u8fd9\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8fd9\u6837\u505a\uff0c\u6211\u4eec\u53ef\u4ee5\u5e94\u7528\u5176\u4ed6\u6548\u679c\uff08\u5982\u96fe\u3001\u5929\u7a7a\u76d2\u7b49\uff09\u3002\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class SceneBuffer { private int bufferId; private int textureId; public SceneBuffer(Window window) throws Exception { // \u521b\u5efa\u7f13\u51b2\u533a bufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, bufferId); // \u521b\u5efa\u7eb9\u7406 int[] textureIds = new int[1]; glGenTextures(textureIds); textureId = textureIds[0]; glBindTexture(GL_TEXTURE_2D, textureId); glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, window.getWidth(), window.getHeight(), 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u9644\u52a0\u7eb9\u7406\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, textureId, 0); // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public int getBufferId() { return bufferId; } public int getTextureId() { return textureId; } public void cleanup() { glDeleteFramebuffers(bufferId); glDeleteTextures(textureId); } } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u7c7b\u4f3c\u4e8e GBuffer \u7c7b\uff0c\u4f46\u8fd9\u91cc\u53ea\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u6765\u50a8\u5b58\u751f\u6210\u7684\u989c\u8272\u3002\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u8fd9\u4e9b\u65b0\u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528\u5b83\u4eec\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u518d\u4f7f\u7528\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u6b63\u5411\u6e32\u67d3\u7740\u8272\u5668\uff08\u540d\u4e3a scene_vertex.vs \u548c scene_fragment.fs \uff09\u3002 \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u521b\u5efa\u4e86\u4e00\u4e2a GBuffer \u5b9e\u73b0\uff0c\u6211\u4eec\u5206\u522b\u4e3a\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupGeometryShader \u65b9\u6cd5\uff09\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupDirLightShader \u548c setupPointLightShader \u65b9\u6cd5\uff09\u521d\u59cb\u5316\u4e86\u53e6\u4e00\u7ec4\u7740\u8272\u5668\u3002\u4f60\u6362\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a sceneBuffer \u7684 SceneBuffer \u7c7b\u7684\u5b9e\u4f8b\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u5149\u7167\u65f6\u4f7f\u7528\u3002\u540d\u4e3a bufferPassModelMatrix \u7684\u5b9e\u7528\u77e9\u9635\u4e5f\u88ab\u5b9e\u4f8b\u5316\uff08\u5728\u6267\u884c\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u65f6\u5c06\u4f7f\u7528\u5b83\uff09\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5728 init \u65b9\u6cd5\u7684\u672b\u5c3e\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Mesh \uff0c\u5b83\u5c06\u7528\u4e8e\u5149\u7167\u5904\u7406\u9636\u6bb5\u3002\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u8be6\u60c5\u5c06\u5728\u4e4b\u540e\u4ecb\u7ecd\u3002 public void init(Window window) throws Exception { shadowRenderer.init(window); gBuffer = new GBuffer(window); sceneBuffer = new SceneBuffer(window); setupSkyBoxShader(); setupParticlesShader(); setupGeometryShader(); setupDirLightShader(); setupPointLightShader(); setupFogShader(); bufferPassModelMatrix = new Matrix4f(); bufferPassMesh = StaticMeshesLoader.load(\"src/main/resources/models/buffer_pass_mess.obj\", \"src/main/resources/models\")[0]; } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\u4f7f\u7528\u7684\u7740\u8272\u5668\u5b9a\u4e49\u4e0e\u901a\u5e38\u4e00\u81f4\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\uff0c\u8ba9\u6211\u4eec\u5173\u6ce8\u5b83\u4eec\u7684\u5185\u5bb9\u3002\u6211\u4eec\u5c06\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\uff0c\u63a5\u4e0b\u6765\u662f\u9876\u70b9\u7740\u8272\u5668\u4ee3\u7801\uff08 gbuffer_vertex.vs \uff09\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; const int NUM_CASCADES = 3; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; layout (location=5) in mat4 modelInstancedMatrix; layout (location=9) in vec2 texOffset; layout (location=10) in float selectedInstanced; uniform int isInstanced; uniform mat4 viewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelNonInstancedMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 lightViewMatrix[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int numCols; uniform int numRows; uniform float selectedNonInstanced; out vec2 vs_textcoord; out vec3 vs_normal; out vec4 vs_mvVertexPos; out vec4 vs_mlightviewVertexPos[NUM_CASCADES]; out mat4 vs_modelMatrix; out float vs_selected; void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelMatrix; if ( isInstanced > 0 ) { vs_selected = selectedInstanced; modelMatrix = modelInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } else { vs_selected = selectedNonInstanced; modelMatrix = modelNonInstancedMatrix; int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } } mat4 modelViewMatrix = viewMatrix * modelMatrix; vs_mvVertexPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * vs_mvVertexPos; // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); vs_textcoord = vec2(x, y); vs_normal = normalize(modelViewMatrix * initNormal).xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { vs_mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * initPos; } vs_modelMatrix = modelMatrix; } \u6b64\u7740\u8272\u5668\u4e0e\u4e0a\u4e00\u7ae0\u4e2d\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\uff0c\u8f93\u51fa\u53d8\u91cf\u7684\u540d\u79f0\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u4f46\u672c\u8d28\u4e0a\u662f\u76f8\u540c\u7684\u7740\u8272\u5668\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u5e94\u8be5\u662f\u51e0\u8fd1\u4e00\u81f4\u7684\uff0c\u6211\u4eec\u6e32\u67d3\u9876\u70b9\u7684\u65b9\u5f0f\u4e0d\u5e94\u8be5\u6539\u53d8\uff0c\u4e3b\u8981\u7684\u66f4\u6539\u662f\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u5b83\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff08 gbuffer_fragment.fs \uff09\uff1a #version 330 const int NUM_CASCADES = 3; in vec2 vs_textcoord; in vec3 vs_normal; in vec4 vs_mvVertexPos; in vec4 vs_mlightviewVertexPos[NUM_CASCADES]; in mat4 vs_modelMatrix; in float vs_selected; layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; uniform mat4 viewMatrix; struct Material { vec4 diffuse; vec4 specular; int hasTexture; int hasNormalMap; float reflectance; }; uniform sampler2D texture_sampler; uniform sampler2D normalMap; uniform Material material; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; uniform float cascadeFarPlanes[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int renderShadow; vec4 diffuseC; vec4 speculrC; void getColour(Material material, vec2 textCoord) { if (material.hasTexture == 1) { diffuseC = texture(texture_sampler, textCoord); speculrC = diffuseC; } else { diffuseC = material.diffuse; speculrC = material.specular; } } vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(viewMatrix * modelMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } float calcShadow(vec4 position, int idx) { if ( renderShadow == 0 ) { return 1.0; } vec3 projCoords = position.xyz; // Transform from screen coordinates to texture coordinates projCoords = projCoords * 0.5 + 0.5; float bias = 0.005; float shadowFactor = 0.0; vec2 inc; if (idx == 0) { inc = 1.0 / textureSize(shadowMap_0, 0); } else if (idx == 1) { inc = 1.0 / textureSize(shadowMap_1, 0); } else { inc = 1.0 / textureSize(shadowMap_2, 0); } for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth; if (idx == 0) { textDepth = texture(shadowMap_0, projCoords.xy + vec2(row, col) * inc).r; } else if (idx == 1) { textDepth = texture(shadowMap_1, projCoords.xy + vec2(row, col) * inc).r; } else { textDepth = texture(shadowMap_2, projCoords.xy + vec2(row, col) * inc).r; } shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; if(projCoords.z > 1.0) { shadowFactor = 1.0; } return 1 - shadowFactor; } void main() { getColour(material, vs_textcoord); fs_worldpos = vs_mvVertexPos.xyz; fs_diffuse = diffuseC.xyz; fs_specular = speculrC.xyz; fs_normal = normalize(calcNormal(material, vs_normal, vs_textcoord, vs_modelMatrix)); int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(vs_mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } fs_shadow = vec2(calcShadow(vs_mlightviewVertexPos[idx], idx), material.reflectance); if ( vs_selected > 0 ) { fs_diffuse = vec3(fs_diffuse.x, fs_diffuse.y, 1); } } \u6700\u5173\u952e\u7684\u884c\u662f\uff1a layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; \u8fd9\u5c31\u662f\u6211\u4eec\u8981\u5f15\u7528\u8be5\u7247\u5143\u7740\u8272\u5668\u5c06\u5199\u5165\u7684\u7eb9\u7406\u7684\u5730\u65b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u662f\u8f6c\u50a8\u4f4d\u7f6e\uff08\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3001\u6f2b\u53cd\u5c04\u989c\u8272\uff08\u53ef\u4ee5\u662f\u6750\u8d28\u76f8\u5173\u7684\u7eb9\u7406\u7684\u989c\u8272\u5206\u91cf\uff09\u3001\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3001\u6cd5\u7ebf\u548c\u9634\u5f71\u56fe\u7684\u6df1\u5ea6\u503c\u3002 \u65c1\u6ce8\uff1a\u6211\u4eec\u5df2\u7ecf\u7b80\u5316\u4e86 Material \u7c7b\u7684\u5b9a\u4e49\uff0c\u5220\u9664\u4e86\u73af\u5883\u989c\u8272\u5206\u91cf\u3002 \u56de\u5230 Renderer \u7c7b\uff0c render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void render(Window window, Camera camera, Scene scene, boolean sceneChanged) { clear(); if (window.getOptions().frustumCulling) { frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); } // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe if (scene.isRenderShadows() && sceneChanged) { shadowRenderer.render(window, scene, camera, transformation, this); } glViewport(0, 0, window.getWidth(), window.getHeight()); // \u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21 window.updateProjectionMatrix(); renderGeometry(window, camera, scene); initLightRendering(); renderPointLights(window, camera, scene); renderDirectionalLight(window, camera, scene); endLightRendering(); renderFog(window, camera, scene); renderSkyBox(window, camera, scene); renderParticles(window, camera, scene); } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u662f\u5728 renderGeometry \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4e0d\u518d\u6709 renderScene \uff09\u3002\u5149\u7167\u5904\u7406\u9636\u6bb5\u5206\u51e0\u4e2a\u6b65\u9aa4\u5b8c\u6210\uff0c\u9996\u5148\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u7f13\u51b2\u533a\u548c\u5176\u4ed6\u53c2\u6570\uff08\u5728 initLightRendering \u4e2d\uff09\uff0c\u7136\u540e\u6e32\u67d3\u70b9\u5149\u6e90\uff08\u5728 renderPointLights \u4e2d\uff09\u548c\u5e73\u884c\u5149\uff08\u5728 renderDirectionalLight \u4e2d\uff09\uff0c\u6700\u540e\u6062\u590d\u72b6\u6001\uff08\u5728 endLightRendering \u4e2d\uff09\u3002 \u8ba9\u6211\u4eec\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\u3002 renderGeometry \u65b9\u6cd5\u51e0\u4e4e\u7b49\u540c\u4e8e\u5728\u524d\u51e0\u7ae0\u4e2d\u4f7f\u7528\u7684 renderScene \u65b9\u6cd5\uff1a private void renderGeometry(Window window, Camera camera, Scene scene) { // \u6e32\u67d3G\u7f13\u51b2\u533a\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBuffer.getGBufferId()); clear(); glDisable(GL_BLEND); gBufferShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); gBufferShaderProgram.setUniform(\"viewMatrix\", viewMatrix); gBufferShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); gBufferShaderProgram.setUniform(\"texture_sampler\", 0); gBufferShaderProgram.setUniform(\"normalMap\", 1); List<ShadowCascade> shadowCascades = shadowRenderer.getShadowCascades(); for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); gBufferShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix(), i); gBufferShaderProgram.setUniform(\"cascadeFarPlanes\", ShadowRenderer.CASCADE_SPLITS[i], i); gBufferShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix(), i); } shadowRenderer.bindTextures(GL_TEXTURE2); int start = 2; for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { gBufferShaderProgram.setUniform(\"shadowMap_\" + i, start + i); } gBufferShaderProgram.setUniform(\"renderShadow\", scene.isRenderShadows() ? 1 : 0); renderNonInstancedMeshes(scene); renderInstancedMeshes(scene, viewMatrix); gBufferShaderProgram.unbind(); glEnable(GL_BLEND); } \u4ec5\u6709\u7684\u533a\u522b\u662f\uff1a \u6211\u4eec\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a\u800c\u4e0d\u662f\u5c4f\u5e55\u3002 \u7981\u7528\u6df7\u5408\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u60f3\u4f7f\u7528\u6700\u63a5\u8fd1\u6444\u50cf\u673a\u7684\u503c\uff08\u6700\u5c0f\u6df1\u5ea6\u503c\uff09\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6df7\u5408\u3002 \u5982\u679c\u4f7f\u7528OpenGL\u8c03\u8bd5\u5668\uff08\u5982RenderDoc\uff09\u8c03\u8bd5\u793a\u4f8b\uff0c\u5219\u53ef\u4ee5\u770b\u5230\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u671f\u95f4\u751f\u6210\u7684\u7eb9\u7406\u3002\u4f4d\u7f6e\u7eb9\u7406\u5c06\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6f2b\u53cd\u5c04\u5206\u91cf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6cd5\u7ebf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u73b0\u5728\u8f6e\u5230\u5149\u7167\u5904\u7406\u9636\u6bb5\u4e86\u3002\u6211\u4eec\u9996\u5148\u9700\u8981\u5728\u6e32\u67d3\u4e4b\u524d\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u8fd9\u662f\u5728 initLightRendering \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void initLightRendering() { // \u7ed1\u5b9a\u573a\u666f\u7f13\u51b2\u533a glBindFramebuffer(GL_FRAMEBUFFER, sceneBuffer.getBufferId()); // \u6e05\u7406G\u7f13\u51b2\u533a clear(); // \u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4ee5\u5141\u8bb8\u7ed8\u5236\u5177\u6709\u76f8\u540c\u6df1\u5ea6\u7684\u591a\u4e2a\u56fe\u5c42 glDisable(GL_DEPTH_TEST); glEnable(GL_BLEND); glBlendEquation(GL_FUNC_ADD); glBlendFunc(GL_ONE, GL_ONE); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u4ee5\u4fbf\u8bfb\u53d6 glBindFramebuffer(GL_READ_FRAMEBUFFER, gBuffer.getGBufferId()); } \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\uff0c\u6240\u4ee5\u9996\u5148\u9700\u8981\u7ed1\u5b9a\u5230\u7eb9\u7406\u4e0a\uff0c\u8be5\u7eb9\u7406\u5c06\u4fdd\u5b58\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u7ed3\u679c\u3002\u7136\u540e\u6e05\u9664\u7f13\u51b2\u533a\u5e76\u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u3002\u56e0\u4e3a\u5df2\u7ecf\u5728\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u8fdb\u884c\u4e86\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u8fd9\u5c31\u4e0d\u518d\u9700\u8981\u4e86\u3002\u53e6\u4e00\u91cd\u8981\u6b65\u9aa4\u662f\u542f\u7528\u6df7\u5408\u3002\u6700\u540e\u4e00\u4e2a\u64cd\u4f5c\u662f\u542f\u7528G\u7f13\u51b2\u533a\u8fdb\u884c\u8bfb\u53d6\uff0c\u5b83\u5c06\u5728\u5149\u7167\u5904\u7406\u9636\u6bb5\u671f\u95f4\u4f7f\u7528\u3002 \u5728\u5206\u6790\u4e0d\u540c\u5149\u7167\u7684\u6e32\u67d3\u65b9\u6cd5\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7a0d\u5fae\u8003\u8651\u4e00\u4e0b\u5982\u4f55\u6e32\u67d3\u5149\u7167\u3002\u6211\u4eec\u9700\u8981\u4f7f\u7528G\u7f13\u51b2\u533a\u7684\u5185\u5bb9\uff0c\u4f46\u4e3a\u4e86\u4f7f\u7528\u5b83\u4eec\uff0c\u9700\u8981\u5148\u6e32\u67d3\u4e00\u4e9b\u4e1c\u897f\u3002\u4f46\u662f\uff0c\u6211\u4eec\u5df2\u7ecf\u7ed8\u5236\u4e86\u573a\u666f\uff0c\u73b0\u5728\u8981\u6e32\u67d3\u4ec0\u4e48\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e32\u67d3\u4e00\u4e2a\u5145\u6ee1\u4e86\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u5bf9\u4e8e\u8be5\u77e9\u5f62\u7684\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5e76\u751f\u6210\u6b63\u786e\u7684\u8f93\u51fa\u989c\u8272\u3002\u4f60\u8fd8\u8bb0\u5f97\u6211\u4eec\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u52a0\u8f7d\u7684 Mesh \u5417\uff1f\u5b83\u88ab\u547d\u540d\u4e3a bufferPassMesh \uff0c\u5b83\u53ea\u50a8\u5b58\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002 \u90a3\u4e48\uff0c\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u9876\u70b9\u7740\u8272\u5668\u770b\u8d77\u6765\u662f\u600e\u6837\u7684\uff1f #version 330 layout (location=0) in vec3 position; uniform mat4 projectionMatrix; uniform mat4 modelMatrix; void main() { gl_Position = projectionMatrix * modelMatrix * vec4(position, 1.0); } \u4e0a\u8ff0\u4ee3\u7801\u662f\u6e32\u67d3\u70b9\u5149\u6e90\u548c\u5e73\u884c\u5149\u65f6\u4f7f\u7528\u7684\u9876\u70b9\u7740\u8272\u5668\uff08 light_vertex.vs \uff09\u3002\u5b83\u53ea\u662f\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u6765\u8f6c\u50a8\u9876\u70b9\u3002\u4e0d\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u8fd9\u91cc\u4e0d\u9700\u8981\u6444\u50cf\u673a\u3002 \u70b9\u5149\u6e90\u7684\u7247\u5143\u7740\u8272\u5668\uff08 point_light_fragment.fs \uff09\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // Light position is assumed to be in view coordinates vec3 position; float intensity; Attenuation att; }; uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; uniform vec2 screenSize; uniform float specularPower; uniform PointLight pointLight; vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } vec4 calcLightColour(vec4 diffuseC, vec4 speculrC, float reflectance, vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 1); vec4 specColour = vec4(0, 0, 0, 1); // Diffuse Light float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // Specular Light vec3 camera_direction = normalize(-position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } vec4 calcPointLight(vec4 diffuseC, vec4 speculrC, float reflectance, PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(diffuseC, speculrC, reflectance, light.colour, light.intensity, position, to_light_dir, normal); // Apply Attenuation float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } void main() { vec2 textCoord = getTextCoord(); float depth = texture(depthText, textCoord).r; vec3 worldPos = texture(positionsText, textCoord).xyz; vec4 diffuseC = texture(diffuseText, textCoord); vec4 speculrC = texture(specularText, textCoord); vec3 normal = texture(normalsText, textCoord).xyz; float shadowFactor = texture(shadowText, textCoord).r; float reflectance = texture(shadowText, textCoord).g; fragColor = calcPointLight(diffuseC, speculrC, reflectance, pointLight, worldPos.xyz, normal.xyz) * shadowFactor; } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u5305\u542b\u4f60\u5e94\u8be5\u719f\u6089\u7684\u51fd\u6570\uff0c\u5b83\u4eec\u5728\u524d\u51e0\u7ae0\u7684\u573a\u666f\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8fc7\u3002\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u91cd\u8981\u4e8b\u9879\u5982\u4e0b\uff1a uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; \u8fd9\u4e9bUniform\u5efa\u6a21\u6784\u6210\u4e86G\u7f13\u51b2\u533a\u7684\u4e0d\u540c\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u8bbf\u95ee\u6570\u636e\u3002\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u95ee\uff0c\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u7247\u5143\u65f6\uff0c\u5982\u4f55\u77e5\u9053\u8981\u4ece\u8fd9\u4e9b\u7eb9\u7406\u4e2d\u83b7\u53d6\u54ea\u4e2a\u50cf\u7d20\uff1f\u7b54\u6848\u662f\u4f7f\u7528 gl_FragCoord \u8f93\u5165\u53d8\u91cf\uff0c\u6b64\u53d8\u91cf\u50a8\u5b58\u5f53\u524d\u7247\u5143\u4e0e\u7a97\u53e3\u7684\u76f8\u5bf9\u5750\u6807\u3002\u56e0\u4e3a\u8981\u4ece\u5750\u6807\u7cfb\u8f6c\u6362\u4e3a\u7eb9\u7406\uff0c\u6211\u4eec\u4f7f\u7528\u4ee5\u4e0b\u51fd\u6570\uff1a vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } \u5e73\u884c\u5149\u7684\u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u76f8\u4f3c\uff0c\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u3002\u73b0\u5728\u5df2\u7ecf\u6709\u4e86\u7740\u8272\u5668\uff0c\u6211\u4eec\u56de\u5230 Renderer \u7c7b\u3002\u5bf9\u4e8e\u70b9\u5149\u6e90\uff0c\u6211\u4eec\u5c06\u505a\u5c3d\u53ef\u80fd\u591a\u7684\u5149\u7167\u5904\u7406\uff0c\u6211\u4eec\u53ea\u662f\u7ed1\u5b9a\u7528\u4e8e\u6b64\u7c7b\u578b\u5149\u6e90\u7684\u7740\u8272\u5668\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u7ed8\u5236\u77e9\u5f62\u3002 private void renderPointLights(Window window, Camera camera, Scene scene) { pointLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); pointLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); pointLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 pointLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } pointLightShaderProgram.setUniform(\"positionsText\", 0); pointLightShaderProgram.setUniform(\"diffuseText\", 1); pointLightShaderProgram.setUniform(\"specularText\", 2); pointLightShaderProgram.setUniform(\"normalsText\", 3); pointLightShaderProgram.setUniform(\"shadowText\", 4); pointLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); SceneLight sceneLight = scene.getSceneLight(); PointLight[] pointLights = sceneLight.getPointLightList(); int numPointLights = pointLights != null ? pointLights.length : 0; for(int i=0; i<numPointLights; i++) { // \u83b7\u53d6\u70b9\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLights[i]); Vector3f lightPos = currPointLight.getPosition(); tmpVec.set(lightPos, 1); tmpVec.mul(viewMatrix); lightPos.x = tmpVec.x; lightPos.y = tmpVec.y; lightPos.z = tmpVec.z; pointLightShaderProgram.setUniform(\"pointLight\", currPointLight); bufferPassMesh.render(); } pointLightShaderProgram.unbind(); } \u5bf9\u4e8e\u5e73\u884c\u5149\u6765\u8bf4\uff0c\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u8fdb\u884c\u4e00\u6b21\u5904\u7406\uff1a private void renderDirectionalLight(Window window, Camera camera, Scene scene) { dirLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); dirLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); dirLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 dirLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } dirLightShaderProgram.setUniform(\"positionsText\", 0); dirLightShaderProgram.setUniform(\"diffuseText\", 1); dirLightShaderProgram.setUniform(\"specularText\", 2); dirLightShaderProgram.setUniform(\"normalsText\", 3); dirLightShaderProgram.setUniform(\"shadowText\", 4); dirLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); // \u73af\u5883\u5149\u7167 SceneLight sceneLight = scene.getSceneLight(); dirLightShaderProgram.setUniform(\"ambientLight\", sceneLight.getAmbientLight()); // \u5e73\u884c\u5149 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(sceneLight.getDirectionalLight()); tmpVec.set(currDirLight.getDirection(), 0); tmpVec.mul(viewMatrix); currDirLight.setDirection(new Vector3f(tmpVec.x, tmpVec.y, tmpVec.z)); dirLightShaderProgram.setUniform(\"directionalLight\", currDirLight); bufferPassMesh.render(); dirLightShaderProgram.unbind(); } endLightRendering \u53ea\u7b80\u5355\u5730\u6062\u590d\u72b6\u6001\u3002 private void endLightRendering() { // \u7ed1\u5b9a\u5c4f\u5e55\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_FRAMEBUFFER, 0); glEnable(GL_DEPTH_TEST); glDisable(GL_BLEND); } \u5982\u679c\u8fd0\u884c\u793a\u4f8b\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u672c\u7ae0\u6bd4\u9884\u671f\u65f6\u95f4\u957f\uff0c\u4f46\u6709\u51e0\u4e2a\u8981\u70b9\u9700\u8981\u6f84\u6e05\uff1a \u4e3a\u4e86\u7b80\u5316\u672c\u7ae0\uff0c\u5df2\u7ecf\u5220\u9664\u4e86\u805a\u5149\u6e90\u7684\u76f8\u5173\u5185\u5bb9\u3002 \u5ef6\u8fdf\u7740\u8272\u6cd5\u4e2d\u4f7f\u7528\u70b9\u5149\u6e90\u7684\u4e00\u79cd\u5e38\u89c1\u6280\u672f\u662f\u8ba1\u7b97\u53d7\u8be5\u5149\u6e90\u5f71\u54cd\u7684\u573a\u666f\u533a\u57df\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\u8f83\u5c0f\u7684\u56db\u8fb9\u5f62\uff0c\u5706\u5f62\u7b49\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5145\u6ee1\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u8bf7\u7262\u8bb0\uff0c\u6700\u597d\u662f\u597d\u7684\u654c\u4eba\uff0c\u8fdb\u884c\u590d\u6742\u7684\u5fae\u79ef\u5206\u4ee5\u786e\u5b9a\u6240\u9700\u7684\u6700\u5c0f\u5f62\u72b6\u53ef\u80fd\u6bd4\u4f7f\u7528\u5176\u4ed6\u7c97\u7cd9\u65b9\u6cd5\u6162\u3002 \u5982\u679c\u6ca1\u6709\u8bb8\u591a\u5149\u6e90\uff0c\u6b64\u65b9\u6cd5\u6bd4\u6b63\u5411\u7740\u8272\u6cd5\u6162\u3002 \u6700\u540e\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c\u5982\u679c\u4f60\u60f3\u4e86\u89e3\u8fd9\u4e9b\u6280\u672f\u5728\u73b0\u5b9e\u4e2d\u7684\u5e94\u7528\uff0c\u53ef\u4ee5\u67e5\u770b \u8fd9\u4e2a\u6781\u597d\u7684\u8bf4\u660e \uff0c\u4e86\u89e3GTA V\u7684\u5e27\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002","title":"\u5ef6\u8fdf\u7740\u8272\u6cd5"},{"location":"28-deferred-shading/#deferred-shading","text":"\u5230\u76ee\u524d\u4e3a\u6b62\uff0c\u6211\u4eec\u6e32\u67d3\u4e09\u7ef4\u573a\u666f\u7684\u65b9\u5f0f\u79f0\u4e3a\u6b63\u5411\u6e32\u67d3\u6cd5\uff08Forward Rendering\uff09\u3002\u6211\u4eec\u9996\u5148\u6e32\u67d33D\u5bf9\u8c61\uff0c\u5e76\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u5e94\u7528\u7eb9\u7406\u548c\u5149\u7167\u6548\u679c\u3002\u5982\u679c\u6211\u4eec\u6709\u4e00\u4e2a\u5177\u6709\u591a\u79cd\u5149\u7167\u548c\u590d\u6742\u6548\u679c\u7684\u590d\u6742\u7247\u5143\u7740\u8272\u5668\u5904\u7406\u9636\u6bb5\uff0c\u8fd9\u79cd\u65b9\u6cd5\u5c31\u4e0d\u662f\u5f88\u9ad8\u6548\u3002\u6b64\u5916\uff0c\u6211\u4eec\u6700\u7ec8\u53ef\u80fd\u4f1a\u5c06\u8fd9\u4e9b\u6548\u679c\u5e94\u7528\u5230\u7a0d\u540e\u53ef\u80fd\u7531\u4e8e\u6df1\u5ea6\u6d4b\u8bd5\u800c\u88ab\u4e22\u5f03\u7684\u7247\u5143\u4e0a\uff08\u5c3d\u7ba1\u8fd9\u5e76\u4e0d\u5b8c\u5168\u6b63\u786e\uff0c\u5982\u679c\u6211\u4eec\u542f\u7528 \u65e9\u671f\u7247\u5143\u6d4b\u8bd5 \u7684\u8bdd\uff09\u3002 \u4e3a\u4e86\u7f13\u89e3\u4e0a\u8ff0\u95ee\u9898\uff0c\u6211\u4eec\u53ef\u4ee5\u6539\u53d8\u65b9\u5f0f\uff0c\u4f7f\u7528\u4e00\u79cd\u79f0\u4e3a\u5ef6\u8fdf\u7740\u8272\u6cd5\u7684\u6280\u672f\u6765\u6e32\u67d3\u573a\u666f\u3002\u901a\u8fc7\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u5148\u5c06\u540e\u671f\uff08\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff09\u6240\u9700\u7684\u51e0\u4f55\u4fe1\u606f\u6e32\u67d3\u5230\u7f13\u51b2\u533a\u3002\u5f53\u4f7f\u7528\u50a8\u5b58\u5728\u8fd9\u4e9b\u7f13\u51b2\u533a\u4e2d\u7684\u4fe1\u606f\u65f6\uff0c\u7247\u5143\u7740\u8272\u5668\u6240\u9700\u7684\u590d\u6742\u8fd0\u7b97\u88ab\u63a8\u8fdf\uff08Postpone\uff09\u3001\u5ef6\u8fdf\uff08Defer\uff09\u5230\u4e4b\u540e\u7684\u9636\u6bb5\u3002 \u56e0\u6b64\uff0c\u4f7f\u7528\u5ef6\u8fdf\u7740\u8272\u6cd5\uff0c\u6211\u4eec\u8fdb\u884c\u4e24\u4e2a\u6e32\u67d3\u9636\u6bb5\uff08Pass\uff09\u3002\u7b2c\u4e00\u4e2a\u662f\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff0c\u6211\u4eec\u5c06\u573a\u666f\u6e32\u67d3\u5230\u50a8\u5b58\u4ee5\u4e0b\u6570\u636e\u7684\u7f13\u51b2\u533a\u4e2d\uff1a \u4f4d\u7f6e\uff08\u5728\u672c\u4f8b\u4e2d\uff0c\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff0c\u5c3d\u7ba1\u4f60\u53ef\u4ee5\u770b\u5230\u4f7f\u7528\u4e16\u754c\u5750\u6807\u7684\u5176\u4ed6\u793a\u4f8b\uff09\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6f2b\u53cd\u5c04\u989c\u8272\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3002 \u6bcf\u4e2a\u4f4d\u7f6e\u7684\u6cd5\u7ebf\uff08\u4e5f\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3002 \u6709\u5411\u5149\u7684\u9634\u5f71\u56fe\uff08\u4f60\u53ef\u80fd\u4f1a\u53d1\u73b0\u8fd9\u4e00\u6b65\u5728\u5176\u4ed6\u5b9e\u73b0\u4e2d\u662f\u5355\u72ec\u5b8c\u6210\u7684\uff09\u3002 \u6240\u6709\u8fd9\u4e9b\u6570\u636e\u90fd\u5b58\u50a8\u5728\u4e00\u4e2a\u79f0\u4e3aG\u7f13\u51b2\u533a\uff08G-Buffer\uff09\u7684\u7f13\u51b2\u533a\u4e2d\u3002 \u7b2c\u4e8c\u4e2a\u9636\u6bb5\u79f0\u4e3a\u5149\u7167\u5904\u7406\u9636\u6bb5\uff0c\u8be5\u9636\u6bb5\u9700\u8981\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\uff0c\u5e76\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u4fe1\u606f\u4e3a\u6bcf\u4e2a\u7247\u5143\u751f\u6210\u989c\u8272\u4fe1\u606f\u3002\u5f53\u6211\u4eec\u8fdb\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\uff0c\u6df1\u5ea6\u6d4b\u8bd5\u5c06\u5220\u9664\u6240\u6709\u770b\u4e0d\u5230\u7684\u573a\u666f\u6570\u636e\u3002\u56e0\u6b64\uff0c\u8981\u6267\u884c\u7684\u64cd\u4f5c\u6570\u91cf\u4ec5\u9650\u4e8e\u5c06\u5728\u5c4f\u5e55\u4e0a\u663e\u793a\u7684\u3002 \u4f60\u53ef\u80fd\u4f1a\u95ee\u8fdb\u884c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u80fd\u5426\u63d0\u9ad8\u6027\u80fd\uff0c\u7b54\u6848\u662f\u89c6\u60c5\u51b5\u800c\u5b9a\u3002\u5ef6\u8fdf\u7740\u8272\u6cd5\u901a\u5e38\u5728\u6709\u8bb8\u591a\u4e0d\u540c\u7684\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\uff0c\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u989d\u5916\u7684\u6e32\u67d3\u9636\u6bb5\u5c06\u901a\u8fc7\u51cf\u5c11\u5c06\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\u6267\u884c\u7684\u64cd\u4f5c\u6765\u8865\u507f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u7f16\u7801\u5427\uff0c\u9996\u5148\u8981\u505a\u7684\u662f\u4e3aG\u7f13\u51b2\u533a\u521b\u5efa\u4e00\u4e2a\u65b0\u7c7b\uff0c\u540d\u4e3a GBuffer \uff0c\u5176\u5b9a\u4e49\u5982\u4e0b\u6240\u793a\uff1a package org.lwjglb.engine.graph; import org.lwjgl.system.MemoryStack; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import java.nio.IntBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL20.*; import static org.lwjgl.opengl.GL30.*; public class GBuffer { private static final int TOTAL_TEXTURES = 6; private int gBufferId; private int[] textureIds; private int width; private int height; \u7c7b\u5b9a\u4e49\u4e86\u4e00\u4e2a\u5e38\u91cf\uff0c\u8be5\u5e38\u91cf\u4e3a\u8981\u4f7f\u7528\u7684\u6700\u5927\u7f13\u51b2\u533a\u6570\u5efa\u6a21\u3002\u4e0eG\u7f13\u51b2\u533a\u672c\u8eab\u5173\u8054\u7684ID\uff0c\u4ee5\u53ca\u5355\u4e2a\u7f13\u51b2\u533a\u7684\u6570\u7ec4\uff0c\u5c4f\u5e55\u7684\u5927\u5c0f\u4e5f\u4f1a\u88ab\u50a8\u5b58\u3002 \u8ba9\u6211\u4eec\u770b\u4e00\u4e0b\u6784\u9020\u51fd\u6570\uff1a public GBuffer(Window window) throws Exception { // \u521b\u5efaG\u7f13\u51b2\u533a gBufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBufferId); textureIds = new int[TOTAL_TEXTURES]; glGenTextures(textureIds); this.width = window.getWidth(); this.height = window.getHeight(); // \u4e3a\u4f4d\u7f6e\u3001\u6f2b\u53cd\u5c04\u989c\u8272\u3001\u955c\u9762\u53cd\u5c04\u989c\u8272\u3001\u6cd5\u7ebf\u3001\u9634\u5f71\u56e0\u5b50\u548c\u6df1\u5ea6\u521b\u5efa\u7eb9\u7406 // \u6240\u6709\u5750\u6807\u90fd\u5728\u4e16\u754c\u5750\u6807\u7cfb\u4e2d for(int i=0; i<TOTAL_TEXTURES; i++) { glBindTexture(GL_TEXTURE_2D, textureIds[i]); int attachmentType; switch(i) { case TOTAL_TEXTURES - 1: // \u6df1\u5ea6\u5206\u91cf glTexImage2D(GL_TEXTURE_2D, 0, GL_DEPTH_COMPONENT32F, width, height, 0, GL_DEPTH_COMPONENT, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_DEPTH_ATTACHMENT; break; default: glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, width, height, 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); attachmentType = GL_COLOR_ATTACHMENT0 + i; break; } // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u5c06\u7eb9\u7406\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, attachmentType, GL_TEXTURE_2D, textureIds[i], 0); } try (MemoryStack stack = MemoryStack.stackPush()) { IntBuffer intBuff = stack.mallocInt(TOTAL_TEXTURES); int values[] = {GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1, GL_COLOR_ATTACHMENT2, GL_COLOR_ATTACHMENT3, GL_COLOR_ATTACHMENT4, GL_COLOR_ATTACHMENT5}; for(int i = 0; i < values.length; i++) { intBuff.put(values[i]); } intBuff.flip(); glDrawBuffers(intBuff); } // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } \u9996\u5148\u6211\u4eec\u8981\u505a\u7684\u4e8b\u662f\u521b\u5efa\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8bb0\u4f4f\uff0c\u5e27\u7f13\u51b2\u533a\u53ea\u662f\u4e00\u4e2aOpenGL\u5bf9\u8c61\uff0c\u53ef\u7528\u4e8e\u6e32\u67d3\u64cd\u4f5c\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5230\u5c4f\u5e55\u3002\u7136\u540e\u6211\u4eec\u751f\u6210\u4e00\u7ec4\u7eb9\u7406\uff086\u4e2a\u7eb9\u7406\uff09\uff0c\u8fd9\u4e9b\u7eb9\u7406\u5c06\u4e0e\u5e27\u7f13\u51b2\u533a\u5173\u8054\u3002 \u4e4b\u540e\uff0c\u6211\u4eec\u4f7f\u7528for\u5faa\u73af\u6765\u521d\u59cb\u5316\u7eb9\u7406\uff0c\u6709\u5982\u4e0b\u7c7b\u578b\uff1a \u201c\u5e38\u89c4\u7eb9\u7406\u201d\uff0c\u5c06\u50a8\u5b58\u4f4d\u7f6e\u3001\u6cd5\u7ebf\u548c\u6f2b\u53cd\u5c04\u5206\u91cf\u7b49\u3002 \u7528\u4e8e\u50a8\u5b58\u6df1\u5ea6\u7f13\u51b2\u533a\u7684\u7eb9\u7406\uff0c\u8fd9\u5c06\u662f\u6700\u540e\u7684\u7eb9\u7406\u3002 \u7eb9\u7406\u521d\u59cb\u5316\u540e\uff0c\u6211\u4eec\u4e3a\u5b83\u4eec\u542f\u7528\u91c7\u6837\u5e76\u5c06\u5b83\u4eec\u7ed1\u5b9a\u5230\u5e27\u7f13\u51b2\u533a\u3002\u6bcf\u4e2a\u7eb9\u7406\u4f7f\u7528\u4ee5 GL_COLOR_ATTACHMENT0 \u4e3a\u5f00\u5934\u7684ID\u8fdb\u884c\u7ed1\u5b9a\u3002\u6bcf\u4e2a\u7eb9\u7406\u90fd\u4ee5\u8be5ID\u9012\u589e\u4e00\u4f4d\uff0c\u56e0\u6b64\u5750\u6807\u4f7f\u7528 GL_COLOR_ATTACHMENT0 \u7ed1\u5b9a\uff0c\u6f2b\u53cd\u5c04\u5206\u91cf\u4f7f\u7528 GL_COLOR_ATTACHMENT1 \uff08\u5373 GL_COLOR_ATTACHMENT0 + 1 \uff09\u9644\u52a0\uff0c\u4ee5\u6b64\u7c7b\u63a8\u3002 \u5728\u521b\u5efa\u5b8c\u6240\u6709\u7eb9\u7406\u4e4b\u540e\uff0c\u6211\u4eec\u9700\u8981\u8ba9\u7247\u5143\u7740\u8272\u5668\u4f7f\u7528\u5b83\u4eec\u8fdb\u884c\u6e32\u67d3\u3002\u8fd9\u662f\u901a\u8fc7\u8c03\u7528 glDrawBuffers \u5b8c\u6210\u7684\u3002\u6211\u4eec\u53ea\u4f20\u9012\u5e26\u6709\u6240\u7528\u989c\u8272\u7ed1\u5b9a\u7684ID\u7684\u6570\u7ec4\uff08 GL_COLOR_ ATTACHMENT0 \u5230 GL_COLOR_ATTACHMENT5 \uff09\u3002 \u7c7b\u7684\u5176\u4ed6\u90e8\u5206\u53ea\u662fgetter\u65b9\u6cd5\u548c cleanup \u65b9\u6cd5\u3002 public int getWidth() { return width; } public int getHeight() { return height; } public int getGBufferId() { return gBufferId; } public int[] getTextureIds() { return textureIds; } public int getPositionTexture() { return textureIds[0]; } public int getDepthTexture() { return textureIds[TOTAL_TEXTURES-1]; } public void cleanUp() { glDeleteFramebuffers(gBufferId); if (textureIds != null) { for (int i=0; i<TOTAL_TEXTURES; i++) { glDeleteTextures(textureIds[i]); } } } \u6211\u4eec\u5c06\u521b\u5efa\u4e00\u4e2a\u540d\u4e3a SceneBuffer \u7684\u65b0\u7c7b\uff0c\u5b83\u53ea\u662f\u53e6\u4e00\u4e2a\u5e27\u7f13\u51b2\u533a\uff0c\u5c06\u5728\u6267\u884c\u5149\u7167\u5904\u7406\u9636\u6bb5\u65f6\u4f7f\u7528\u5b83\u3002\u6211\u4eec\u4e0d\u76f4\u63a5\u6e32\u67d3\u5230\u5c4f\u5e55\uff0c\u800c\u662f\u6e32\u67d3\u5230\u8fd9\u4e2a\u5e27\u7f13\u51b2\u533a\u3002\u8fd9\u6837\u505a\uff0c\u6211\u4eec\u53ef\u4ee5\u5e94\u7528\u5176\u4ed6\u6548\u679c\uff08\u5982\u96fe\u3001\u5929\u7a7a\u76d2\u7b49\uff09\u3002\u7c7b\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a package org.lwjglb.engine.graph; import org.lwjglb.engine.Window; import java.nio.ByteBuffer; import static org.lwjgl.opengl.GL11.*; import static org.lwjgl.opengl.GL30.*; public class SceneBuffer { private int bufferId; private int textureId; public SceneBuffer(Window window) throws Exception { // \u521b\u5efa\u7f13\u51b2\u533a bufferId = glGenFramebuffers(); glBindFramebuffer(GL_DRAW_FRAMEBUFFER, bufferId); // \u521b\u5efa\u7eb9\u7406 int[] textureIds = new int[1]; glGenTextures(textureIds); textureId = textureIds[0]; glBindTexture(GL_TEXTURE_2D, textureId); glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB32F, window.getWidth(), window.getHeight(), 0, GL_RGB, GL_FLOAT, (ByteBuffer) null); // \u7528\u4e8e\u91c7\u6837 glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); // \u9644\u52a0\u7eb9\u7406\u5230G\u7f13\u51b2\u533a glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, textureId, 0); // \u89e3\u7ed1 glBindFramebuffer(GL_FRAMEBUFFER, 0); } public int getBufferId() { return bufferId; } public int getTextureId() { return textureId; } public void cleanup() { glDeleteFramebuffers(bufferId); glDeleteTextures(textureId); } } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u7c7b\u4f3c\u4e8e GBuffer \u7c7b\uff0c\u4f46\u8fd9\u91cc\u53ea\u4f7f\u7528\u4e00\u4e2a\u7eb9\u7406\u6765\u50a8\u5b58\u751f\u6210\u7684\u989c\u8272\u3002\u65e2\u7136\u5df2\u7ecf\u521b\u5efa\u4e86\u8fd9\u4e9b\u65b0\u7c7b\uff0c\u6211\u4eec\u5c31\u53ef\u4ee5\u5f00\u59cb\u4f7f\u7528\u5b83\u4eec\u4e86\u3002\u5728 Renderer \u7c7b\u4e2d\uff0c\u6211\u4eec\u5c06\u4e0d\u518d\u4f7f\u7528\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u6b63\u5411\u6e32\u67d3\u7740\u8272\u5668\uff08\u540d\u4e3a scene_vertex.vs \u548c scene_fragment.fs \uff09\u3002 \u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\uff0c\u4f60\u4f1a\u770b\u5230\u521b\u5efa\u4e86\u4e00\u4e2a GBuffer \u5b9e\u73b0\uff0c\u6211\u4eec\u5206\u522b\u4e3a\u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupGeometryShader \u65b9\u6cd5\uff09\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\uff08\u901a\u8fc7\u8c03\u7528 setupDirLightShader \u548c setupPointLightShader \u65b9\u6cd5\uff09\u521d\u59cb\u5316\u4e86\u53e6\u4e00\u7ec4\u7740\u8272\u5668\u3002\u4f60\u6362\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u521b\u5efa\u4e86\u4e00\u4e2a\u540d\u4e3a sceneBuffer \u7684 SceneBuffer \u7c7b\u7684\u5b9e\u4f8b\uff0c\u5982\u4e0a\u6240\u8ff0\uff0c\u5b83\u5c06\u5728\u6e32\u67d3\u5149\u7167\u65f6\u4f7f\u7528\u3002\u540d\u4e3a bufferPassModelMatrix \u7684\u5b9e\u7528\u77e9\u9635\u4e5f\u88ab\u5b9e\u4f8b\u5316\uff08\u5728\u6267\u884c\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u65f6\u5c06\u4f7f\u7528\u5b83\uff09\u3002\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u5728 init \u65b9\u6cd5\u7684\u672b\u5c3e\u521b\u5efa\u4e86\u4e00\u4e2a\u65b0\u7684 Mesh \uff0c\u5b83\u5c06\u7528\u4e8e\u5149\u7167\u5904\u7406\u9636\u6bb5\u3002\u5173\u4e8e\u8fd9\u65b9\u9762\u7684\u8be6\u60c5\u5c06\u5728\u4e4b\u540e\u4ecb\u7ecd\u3002 public void init(Window window) throws Exception { shadowRenderer.init(window); gBuffer = new GBuffer(window); sceneBuffer = new SceneBuffer(window); setupSkyBoxShader(); setupParticlesShader(); setupGeometryShader(); setupDirLightShader(); setupPointLightShader(); setupFogShader(); bufferPassModelMatrix = new Matrix4f(); bufferPassMesh = StaticMeshesLoader.load(\"src/main/resources/models/buffer_pass_mess.obj\", \"src/main/resources/models\")[0]; } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u548c\u5149\u7167\u5904\u7406\u9636\u6bb5\u4f7f\u7528\u7684\u7740\u8272\u5668\u5b9a\u4e49\u4e0e\u901a\u5e38\u4e00\u81f4\uff08\u4f60\u53ef\u4ee5\u76f4\u63a5\u67e5\u770b\u6e90\u4ee3\u7801\uff09\uff0c\u8ba9\u6211\u4eec\u5173\u6ce8\u5b83\u4eec\u7684\u5185\u5bb9\u3002\u6211\u4eec\u5c06\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\uff0c\u63a5\u4e0b\u6765\u662f\u9876\u70b9\u7740\u8272\u5668\u4ee3\u7801\uff08 gbuffer_vertex.vs \uff09\uff1a #version 330 const int MAX_WEIGHTS = 4; const int MAX_JOINTS = 150; const int NUM_CASCADES = 3; layout (location=0) in vec3 position; layout (location=1) in vec2 texCoord; layout (location=2) in vec3 vertexNormal; layout (location=3) in vec4 jointWeights; layout (location=4) in ivec4 jointIndices; layout (location=5) in mat4 modelInstancedMatrix; layout (location=9) in vec2 texOffset; layout (location=10) in float selectedInstanced; uniform int isInstanced; uniform mat4 viewMatrix; uniform mat4 projectionMatrix; uniform mat4 modelNonInstancedMatrix; uniform mat4 jointsMatrix[MAX_JOINTS]; uniform mat4 lightViewMatrix[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int numCols; uniform int numRows; uniform float selectedNonInstanced; out vec2 vs_textcoord; out vec3 vs_normal; out vec4 vs_mvVertexPos; out vec4 vs_mlightviewVertexPos[NUM_CASCADES]; out mat4 vs_modelMatrix; out float vs_selected; void main() { vec4 initPos = vec4(0, 0, 0, 0); vec4 initNormal = vec4(0, 0, 0, 0); mat4 modelMatrix; if ( isInstanced > 0 ) { vs_selected = selectedInstanced; modelMatrix = modelInstancedMatrix; initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } else { vs_selected = selectedNonInstanced; modelMatrix = modelNonInstancedMatrix; int count = 0; for(int i = 0; i < MAX_WEIGHTS; i++) { float weight = jointWeights[i]; if(weight > 0) { count++; int jointIndex = jointIndices[i]; vec4 tmpPos = jointsMatrix[jointIndex] * vec4(position, 1.0); initPos += weight * tmpPos; vec4 tmpNormal = jointsMatrix[jointIndex] * vec4(vertexNormal, 0.0); initNormal += weight * tmpNormal; } } if (count == 0) { initPos = vec4(position, 1.0); initNormal = vec4(vertexNormal, 0.0); } } mat4 modelViewMatrix = viewMatrix * modelMatrix; vs_mvVertexPos = modelViewMatrix * initPos; gl_Position = projectionMatrix * vs_mvVertexPos; // Support for texture atlas, update texture coordinates float x = (texCoord.x / numCols + texOffset.x); float y = (texCoord.y / numRows + texOffset.y); vs_textcoord = vec2(x, y); vs_normal = normalize(modelViewMatrix * initNormal).xyz; for (int i = 0 ; i < NUM_CASCADES ; i++) { vs_mlightviewVertexPos[i] = orthoProjectionMatrix[i] * lightViewMatrix[i] * modelMatrix * initPos; } vs_modelMatrix = modelMatrix; } \u6b64\u7740\u8272\u5668\u4e0e\u4e0a\u4e00\u7ae0\u4e2d\u7528\u4e8e\u6e32\u67d3\u573a\u666f\u7684\u9876\u70b9\u7740\u8272\u5668\u975e\u5e38\u76f8\u4f3c\uff0c\u8f93\u51fa\u53d8\u91cf\u7684\u540d\u79f0\u6709\u4e00\u4e9b\u53d8\u5316\uff0c\u4f46\u672c\u8d28\u4e0a\u662f\u76f8\u540c\u7684\u7740\u8272\u5668\u3002\u4e8b\u5b9e\u4e0a\uff0c\u5b83\u5e94\u8be5\u662f\u51e0\u8fd1\u4e00\u81f4\u7684\uff0c\u6211\u4eec\u6e32\u67d3\u9876\u70b9\u7684\u65b9\u5f0f\u4e0d\u5e94\u8be5\u6539\u53d8\uff0c\u4e3b\u8981\u7684\u66f4\u6539\u662f\u5728\u7247\u5143\u7740\u8272\u5668\u4e2d\uff0c\u5b83\u662f\u8fd9\u6837\u5b9a\u4e49\u7684\uff08 gbuffer_fragment.fs \uff09\uff1a #version 330 const int NUM_CASCADES = 3; in vec2 vs_textcoord; in vec3 vs_normal; in vec4 vs_mvVertexPos; in vec4 vs_mlightviewVertexPos[NUM_CASCADES]; in mat4 vs_modelMatrix; in float vs_selected; layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; uniform mat4 viewMatrix; struct Material { vec4 diffuse; vec4 specular; int hasTexture; int hasNormalMap; float reflectance; }; uniform sampler2D texture_sampler; uniform sampler2D normalMap; uniform Material material; uniform sampler2D shadowMap_0; uniform sampler2D shadowMap_1; uniform sampler2D shadowMap_2; uniform float cascadeFarPlanes[NUM_CASCADES]; uniform mat4 orthoProjectionMatrix[NUM_CASCADES]; uniform int renderShadow; vec4 diffuseC; vec4 speculrC; void getColour(Material material, vec2 textCoord) { if (material.hasTexture == 1) { diffuseC = texture(texture_sampler, textCoord); speculrC = diffuseC; } else { diffuseC = material.diffuse; speculrC = material.specular; } } vec3 calcNormal(Material material, vec3 normal, vec2 text_coord, mat4 modelMatrix) { vec3 newNormal = normal; if ( material.hasNormalMap == 1 ) { newNormal = texture(normalMap, text_coord).rgb; newNormal = normalize(newNormal * 2 - 1); newNormal = normalize(viewMatrix * modelMatrix * vec4(newNormal, 0.0)).xyz; } return newNormal; } float calcShadow(vec4 position, int idx) { if ( renderShadow == 0 ) { return 1.0; } vec3 projCoords = position.xyz; // Transform from screen coordinates to texture coordinates projCoords = projCoords * 0.5 + 0.5; float bias = 0.005; float shadowFactor = 0.0; vec2 inc; if (idx == 0) { inc = 1.0 / textureSize(shadowMap_0, 0); } else if (idx == 1) { inc = 1.0 / textureSize(shadowMap_1, 0); } else { inc = 1.0 / textureSize(shadowMap_2, 0); } for(int row = -1; row <= 1; ++row) { for(int col = -1; col <= 1; ++col) { float textDepth; if (idx == 0) { textDepth = texture(shadowMap_0, projCoords.xy + vec2(row, col) * inc).r; } else if (idx == 1) { textDepth = texture(shadowMap_1, projCoords.xy + vec2(row, col) * inc).r; } else { textDepth = texture(shadowMap_2, projCoords.xy + vec2(row, col) * inc).r; } shadowFactor += projCoords.z - bias > textDepth ? 1.0 : 0.0; } } shadowFactor /= 9.0; if(projCoords.z > 1.0) { shadowFactor = 1.0; } return 1 - shadowFactor; } void main() { getColour(material, vs_textcoord); fs_worldpos = vs_mvVertexPos.xyz; fs_diffuse = diffuseC.xyz; fs_specular = speculrC.xyz; fs_normal = normalize(calcNormal(material, vs_normal, vs_textcoord, vs_modelMatrix)); int idx; for (int i=0; i<NUM_CASCADES; i++) { if ( abs(vs_mvVertexPos.z) < cascadeFarPlanes[i] ) { idx = i; break; } } fs_shadow = vec2(calcShadow(vs_mlightviewVertexPos[idx], idx), material.reflectance); if ( vs_selected > 0 ) { fs_diffuse = vec3(fs_diffuse.x, fs_diffuse.y, 1); } } \u6700\u5173\u952e\u7684\u884c\u662f\uff1a layout (location = 0) out vec3 fs_worldpos; layout (location = 1) out vec3 fs_diffuse; layout (location = 2) out vec3 fs_specular; layout (location = 3) out vec3 fs_normal; layout (location = 4) out vec2 fs_shadow; \u8fd9\u5c31\u662f\u6211\u4eec\u8981\u5f15\u7528\u8be5\u7247\u5143\u7740\u8272\u5668\u5c06\u5199\u5165\u7684\u7eb9\u7406\u7684\u5730\u65b9\u3002\u5982\u4f60\u6240\u89c1\uff0c\u6211\u4eec\u53ea\u662f\u8f6c\u50a8\u4f4d\u7f6e\uff08\u5728\u5149\u7167\u89c6\u56fe\u5750\u6807\u7cfb\u4e2d\uff09\u3001\u6f2b\u53cd\u5c04\u989c\u8272\uff08\u53ef\u4ee5\u662f\u6750\u8d28\u76f8\u5173\u7684\u7eb9\u7406\u7684\u989c\u8272\u5206\u91cf\uff09\u3001\u955c\u9762\u53cd\u5c04\u5206\u91cf\u3001\u6cd5\u7ebf\u548c\u9634\u5f71\u56fe\u7684\u6df1\u5ea6\u503c\u3002 \u65c1\u6ce8\uff1a\u6211\u4eec\u5df2\u7ecf\u7b80\u5316\u4e86 Material \u7c7b\u7684\u5b9a\u4e49\uff0c\u5220\u9664\u4e86\u73af\u5883\u989c\u8272\u5206\u91cf\u3002 \u56de\u5230 Renderer \u7c7b\uff0c render \u65b9\u6cd5\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a public void render(Window window, Camera camera, Scene scene, boolean sceneChanged) { clear(); if (window.getOptions().frustumCulling) { frustumFilter.updateFrustum(window.getProjectionMatrix(), camera.getViewMatrix()); frustumFilter.filter(scene.getGameMeshes()); frustumFilter.filter(scene.getGameInstancedMeshes()); } // \u5728\u8bbe\u7f6e\u89c6\u53e3\u4e4b\u524d\u6e32\u67d3\u6df1\u5ea6\u56fe if (scene.isRenderShadows() && sceneChanged) { shadowRenderer.render(window, scene, camera, transformation, this); } glViewport(0, 0, window.getWidth(), window.getHeight()); // \u6bcf\u4e2a\u6e32\u67d3\u5468\u671f\u66f4\u65b0\u6295\u5f71\u77e9\u9635\u4e00\u6b21 window.updateProjectionMatrix(); renderGeometry(window, camera, scene); initLightRendering(); renderPointLights(window, camera, scene); renderDirectionalLight(window, camera, scene); endLightRendering(); renderFog(window, camera, scene); renderSkyBox(window, camera, scene); renderParticles(window, camera, scene); } \u51e0\u4f55\u5904\u7406\u9636\u6bb5\u662f\u5728 renderGeometry \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff08\u4f60\u53ef\u4ee5\u770b\u5230\u6211\u4eec\u4e0d\u518d\u6709 renderScene \uff09\u3002\u5149\u7167\u5904\u7406\u9636\u6bb5\u5206\u51e0\u4e2a\u6b65\u9aa4\u5b8c\u6210\uff0c\u9996\u5148\u8bbe\u7f6e\u8981\u4f7f\u7528\u7684\u7f13\u51b2\u533a\u548c\u5176\u4ed6\u53c2\u6570\uff08\u5728 initLightRendering \u4e2d\uff09\uff0c\u7136\u540e\u6e32\u67d3\u70b9\u5149\u6e90\uff08\u5728 renderPointLights \u4e2d\uff09\u548c\u5e73\u884c\u5149\uff08\u5728 renderDirectionalLight \u4e2d\uff09\uff0c\u6700\u540e\u6062\u590d\u72b6\u6001\uff08\u5728 endLightRendering \u4e2d\uff09\u3002 \u8ba9\u6211\u4eec\u4ece\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u5f00\u59cb\u3002 renderGeometry \u65b9\u6cd5\u51e0\u4e4e\u7b49\u540c\u4e8e\u5728\u524d\u51e0\u7ae0\u4e2d\u4f7f\u7528\u7684 renderScene \u65b9\u6cd5\uff1a private void renderGeometry(Window window, Camera camera, Scene scene) { // \u6e32\u67d3G\u7f13\u51b2\u533a\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_DRAW_FRAMEBUFFER, gBuffer.getGBufferId()); clear(); glDisable(GL_BLEND); gBufferShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); gBufferShaderProgram.setUniform(\"viewMatrix\", viewMatrix); gBufferShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); gBufferShaderProgram.setUniform(\"texture_sampler\", 0); gBufferShaderProgram.setUniform(\"normalMap\", 1); List<ShadowCascade> shadowCascades = shadowRenderer.getShadowCascades(); for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { ShadowCascade shadowCascade = shadowCascades.get(i); gBufferShaderProgram.setUniform(\"orthoProjectionMatrix\", shadowCascade.getOrthoProjMatrix(), i); gBufferShaderProgram.setUniform(\"cascadeFarPlanes\", ShadowRenderer.CASCADE_SPLITS[i], i); gBufferShaderProgram.setUniform(\"lightViewMatrix\", shadowCascade.getLightViewMatrix(), i); } shadowRenderer.bindTextures(GL_TEXTURE2); int start = 2; for (int i = 0; i < ShadowRenderer.NUM_CASCADES; i++) { gBufferShaderProgram.setUniform(\"shadowMap_\" + i, start + i); } gBufferShaderProgram.setUniform(\"renderShadow\", scene.isRenderShadows() ? 1 : 0); renderNonInstancedMeshes(scene); renderInstancedMeshes(scene, viewMatrix); gBufferShaderProgram.unbind(); glEnable(GL_BLEND); } \u4ec5\u6709\u7684\u533a\u522b\u662f\uff1a \u6211\u4eec\u7ed1\u5b9a\u5230G\u7f13\u51b2\u533a\u800c\u4e0d\u662f\u5c4f\u5e55\u3002 \u7981\u7528\u6df7\u5408\uff0c\u56e0\u4e3a\u6211\u4eec\u53ea\u60f3\u4f7f\u7528\u6700\u63a5\u8fd1\u6444\u50cf\u673a\u7684\u503c\uff08\u6700\u5c0f\u6df1\u5ea6\u503c\uff09\uff0c\u6240\u4ee5\u4e0d\u9700\u8981\u6df7\u5408\u3002 \u5982\u679c\u4f7f\u7528OpenGL\u8c03\u8bd5\u5668\uff08\u5982RenderDoc\uff09\u8c03\u8bd5\u793a\u4f8b\uff0c\u5219\u53ef\u4ee5\u770b\u5230\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u671f\u95f4\u751f\u6210\u7684\u7eb9\u7406\u3002\u4f4d\u7f6e\u7eb9\u7406\u5c06\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6f2b\u53cd\u5c04\u5206\u91cf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u50a8\u5b58\u6cd5\u7ebf\u503c\u7684\u7eb9\u7406\u5982\u4e0b\u6240\u793a\uff1a \u73b0\u5728\u8f6e\u5230\u5149\u7167\u5904\u7406\u9636\u6bb5\u4e86\u3002\u6211\u4eec\u9996\u5148\u9700\u8981\u5728\u6e32\u67d3\u4e4b\u524d\u8bbe\u7f6e\u4e00\u4e9b\u4e1c\u897f\uff0c\u8fd9\u662f\u5728 initLightRendering \u65b9\u6cd5\u4e2d\u5b8c\u6210\u7684\uff1a private void initLightRendering() { // \u7ed1\u5b9a\u573a\u666f\u7f13\u51b2\u533a glBindFramebuffer(GL_FRAMEBUFFER, sceneBuffer.getBufferId()); // \u6e05\u7406G\u7f13\u51b2\u533a clear(); // \u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u4ee5\u5141\u8bb8\u7ed8\u5236\u5177\u6709\u76f8\u540c\u6df1\u5ea6\u7684\u591a\u4e2a\u56fe\u5c42 glDisable(GL_DEPTH_TEST); glEnable(GL_BLEND); glBlendEquation(GL_FUNC_ADD); glBlendFunc(GL_ONE, GL_ONE); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u4ee5\u4fbf\u8bfb\u53d6 glBindFramebuffer(GL_READ_FRAMEBUFFER, gBuffer.getGBufferId()); } \u56e0\u4e3a\u6211\u4eec\u4e0d\u4f1a\u6e32\u67d3\u5230\u5c4f\u5e55\u4e0a\uff0c\u6240\u4ee5\u9996\u5148\u9700\u8981\u7ed1\u5b9a\u5230\u7eb9\u7406\u4e0a\uff0c\u8be5\u7eb9\u7406\u5c06\u4fdd\u5b58\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u7ed3\u679c\u3002\u7136\u540e\u6e05\u9664\u7f13\u51b2\u533a\u5e76\u7981\u7528\u6df1\u5ea6\u6d4b\u8bd5\u3002\u56e0\u4e3a\u5df2\u7ecf\u5728\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u8fdb\u884c\u4e86\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u8fd9\u5c31\u4e0d\u518d\u9700\u8981\u4e86\u3002\u53e6\u4e00\u91cd\u8981\u6b65\u9aa4\u662f\u542f\u7528\u6df7\u5408\u3002\u6700\u540e\u4e00\u4e2a\u64cd\u4f5c\u662f\u542f\u7528G\u7f13\u51b2\u533a\u8fdb\u884c\u8bfb\u53d6\uff0c\u5b83\u5c06\u5728\u5149\u7167\u5904\u7406\u9636\u6bb5\u671f\u95f4\u4f7f\u7528\u3002 \u5728\u5206\u6790\u4e0d\u540c\u5149\u7167\u7684\u6e32\u67d3\u65b9\u6cd5\u4e4b\u524d\uff0c\u8ba9\u6211\u4eec\u7a0d\u5fae\u8003\u8651\u4e00\u4e0b\u5982\u4f55\u6e32\u67d3\u5149\u7167\u3002\u6211\u4eec\u9700\u8981\u4f7f\u7528G\u7f13\u51b2\u533a\u7684\u5185\u5bb9\uff0c\u4f46\u4e3a\u4e86\u4f7f\u7528\u5b83\u4eec\uff0c\u9700\u8981\u5148\u6e32\u67d3\u4e00\u4e9b\u4e1c\u897f\u3002\u4f46\u662f\uff0c\u6211\u4eec\u5df2\u7ecf\u7ed8\u5236\u4e86\u573a\u666f\uff0c\u73b0\u5728\u8981\u6e32\u67d3\u4ec0\u4e48\uff1f\u7b54\u6848\u5f88\u7b80\u5355\uff0c\u6211\u4eec\u53ea\u9700\u8981\u6e32\u67d3\u4e00\u4e2a\u5145\u6ee1\u4e86\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u5bf9\u4e8e\u8be5\u77e9\u5f62\u7684\u6bcf\u4e2a\u7247\u5143\uff0c\u6211\u4eec\u5c06\u4f7f\u7528G\u7f13\u51b2\u533a\u4e2d\u50a8\u5b58\u7684\u6570\u636e\u5e76\u751f\u6210\u6b63\u786e\u7684\u8f93\u51fa\u989c\u8272\u3002\u4f60\u8fd8\u8bb0\u5f97\u6211\u4eec\u5728 Renderer \u7c7b\u7684 init \u65b9\u6cd5\u4e2d\u52a0\u8f7d\u7684 Mesh \u5417\uff1f\u5b83\u88ab\u547d\u540d\u4e3a bufferPassMesh \uff0c\u5b83\u53ea\u50a8\u5b58\u4e00\u4e2a\u5145\u6ee1\u6574\u4e2a\u5c4f\u5e55\u7684\u77e9\u5f62\u3002 \u90a3\u4e48\uff0c\u5149\u7167\u5904\u7406\u9636\u6bb5\u7684\u9876\u70b9\u7740\u8272\u5668\u770b\u8d77\u6765\u662f\u600e\u6837\u7684\uff1f #version 330 layout (location=0) in vec3 position; uniform mat4 projectionMatrix; uniform mat4 modelMatrix; void main() { gl_Position = projectionMatrix * modelMatrix * vec4(position, 1.0); } \u4e0a\u8ff0\u4ee3\u7801\u662f\u6e32\u67d3\u70b9\u5149\u6e90\u548c\u5e73\u884c\u5149\u65f6\u4f7f\u7528\u7684\u9876\u70b9\u7740\u8272\u5668\uff08 light_vertex.vs \uff09\u3002\u5b83\u53ea\u662f\u4f7f\u7528\u6a21\u578b\u77e9\u9635\u548c\u6295\u5f71\u77e9\u9635\u6765\u8f6c\u50a8\u9876\u70b9\u3002\u4e0d\u9700\u8981\u4f7f\u7528\u89c2\u5bdf\u77e9\u9635\uff0c\u56e0\u4e3a\u8fd9\u91cc\u4e0d\u9700\u8981\u6444\u50cf\u673a\u3002 \u70b9\u5149\u6e90\u7684\u7247\u5143\u7740\u8272\u5668\uff08 point_light_fragment.fs \uff09\u7684\u5b9a\u4e49\u5982\u4e0b\uff1a #version 330 out vec4 fragColor; struct Attenuation { float constant; float linear; float exponent; }; struct PointLight { vec3 colour; // Light position is assumed to be in view coordinates vec3 position; float intensity; Attenuation att; }; uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; uniform vec2 screenSize; uniform float specularPower; uniform PointLight pointLight; vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } vec4 calcLightColour(vec4 diffuseC, vec4 speculrC, float reflectance, vec3 light_colour, float light_intensity, vec3 position, vec3 to_light_dir, vec3 normal) { vec4 diffuseColour = vec4(0, 0, 0, 1); vec4 specColour = vec4(0, 0, 0, 1); // Diffuse Light float diffuseFactor = max(dot(normal, to_light_dir), 0.0); diffuseColour = diffuseC * vec4(light_colour, 1.0) * light_intensity * diffuseFactor; // Specular Light vec3 camera_direction = normalize(-position); vec3 from_light_dir = -to_light_dir; vec3 reflected_light = normalize(reflect(from_light_dir , normal)); float specularFactor = max( dot(camera_direction, reflected_light), 0.0); specularFactor = pow(specularFactor, specularPower); specColour = speculrC * light_intensity * specularFactor * reflectance * vec4(light_colour, 1.0); return (diffuseColour + specColour); } vec4 calcPointLight(vec4 diffuseC, vec4 speculrC, float reflectance, PointLight light, vec3 position, vec3 normal) { vec3 light_direction = light.position - position; vec3 to_light_dir = normalize(light_direction); vec4 light_colour = calcLightColour(diffuseC, speculrC, reflectance, light.colour, light.intensity, position, to_light_dir, normal); // Apply Attenuation float distance = length(light_direction); float attenuationInv = light.att.constant + light.att.linear * distance + light.att.exponent * distance * distance; return light_colour / attenuationInv; } void main() { vec2 textCoord = getTextCoord(); float depth = texture(depthText, textCoord).r; vec3 worldPos = texture(positionsText, textCoord).xyz; vec4 diffuseC = texture(diffuseText, textCoord); vec4 speculrC = texture(specularText, textCoord); vec3 normal = texture(normalsText, textCoord).xyz; float shadowFactor = texture(shadowText, textCoord).r; float reflectance = texture(shadowText, textCoord).g; fragColor = calcPointLight(diffuseC, speculrC, reflectance, pointLight, worldPos.xyz, normal.xyz) * shadowFactor; } \u5982\u4f60\u6240\u89c1\uff0c\u5b83\u5305\u542b\u4f60\u5e94\u8be5\u719f\u6089\u7684\u51fd\u6570\uff0c\u5b83\u4eec\u5728\u524d\u51e0\u7ae0\u7684\u573a\u666f\u7247\u5143\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u8fc7\u3002\u8fd9\u91cc\u9700\u8981\u6ce8\u610f\u7684\u91cd\u8981\u4e8b\u9879\u5982\u4e0b\uff1a uniform sampler2D positionsText; uniform sampler2D diffuseText; uniform sampler2D specularText; uniform sampler2D normalsText; uniform sampler2D shadowText; uniform sampler2D depthText; \u8fd9\u4e9bUniform\u5efa\u6a21\u6784\u6210\u4e86G\u7f13\u51b2\u533a\u7684\u4e0d\u540c\u7eb9\u7406\u3002\u6211\u4eec\u5c06\u4f7f\u7528\u5b83\u4eec\u6765\u8bbf\u95ee\u6570\u636e\u3002\u4f60\u73b0\u5728\u53ef\u80fd\u4f1a\u95ee\uff0c\u5f53\u6211\u4eec\u6e32\u67d3\u4e00\u4e2a\u7247\u5143\u65f6\uff0c\u5982\u4f55\u77e5\u9053\u8981\u4ece\u8fd9\u4e9b\u7eb9\u7406\u4e2d\u83b7\u53d6\u54ea\u4e2a\u50cf\u7d20\uff1f\u7b54\u6848\u662f\u4f7f\u7528 gl_FragCoord \u8f93\u5165\u53d8\u91cf\uff0c\u6b64\u53d8\u91cf\u50a8\u5b58\u5f53\u524d\u7247\u5143\u4e0e\u7a97\u53e3\u7684\u76f8\u5bf9\u5750\u6807\u3002\u56e0\u4e3a\u8981\u4ece\u5750\u6807\u7cfb\u8f6c\u6362\u4e3a\u7eb9\u7406\uff0c\u6211\u4eec\u4f7f\u7528\u4ee5\u4e0b\u51fd\u6570\uff1a vec2 getTextCoord() { return gl_FragCoord.xy / screenSize; } \u5e73\u884c\u5149\u7684\u7247\u5143\u7740\u8272\u5668\u4e5f\u5f88\u76f8\u4f3c\uff0c\u53ef\u4ee5\u67e5\u770b\u6e90\u4ee3\u7801\u3002\u73b0\u5728\u5df2\u7ecf\u6709\u4e86\u7740\u8272\u5668\uff0c\u6211\u4eec\u56de\u5230 Renderer \u7c7b\u3002\u5bf9\u4e8e\u70b9\u5149\u6e90\uff0c\u6211\u4eec\u5c06\u505a\u5c3d\u53ef\u80fd\u591a\u7684\u5149\u7167\u5904\u7406\uff0c\u6211\u4eec\u53ea\u662f\u7ed1\u5b9a\u7528\u4e8e\u6b64\u7c7b\u578b\u5149\u6e90\u7684\u7740\u8272\u5668\uff0c\u5e76\u4e3a\u6bcf\u4e2a\u7740\u8272\u5668\u7ed8\u5236\u77e9\u5f62\u3002 private void renderPointLights(Window window, Camera camera, Scene scene) { pointLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); pointLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); pointLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 pointLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } pointLightShaderProgram.setUniform(\"positionsText\", 0); pointLightShaderProgram.setUniform(\"diffuseText\", 1); pointLightShaderProgram.setUniform(\"specularText\", 2); pointLightShaderProgram.setUniform(\"normalsText\", 3); pointLightShaderProgram.setUniform(\"shadowText\", 4); pointLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); SceneLight sceneLight = scene.getSceneLight(); PointLight[] pointLights = sceneLight.getPointLightList(); int numPointLights = pointLights != null ? pointLights.length : 0; for(int i=0; i<numPointLights; i++) { // \u83b7\u53d6\u70b9\u5149\u6e90\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb PointLight currPointLight = new PointLight(pointLights[i]); Vector3f lightPos = currPointLight.getPosition(); tmpVec.set(lightPos, 1); tmpVec.mul(viewMatrix); lightPos.x = tmpVec.x; lightPos.y = tmpVec.y; lightPos.z = tmpVec.z; pointLightShaderProgram.setUniform(\"pointLight\", currPointLight); bufferPassMesh.render(); } pointLightShaderProgram.unbind(); } \u5bf9\u4e8e\u5e73\u884c\u5149\u6765\u8bf4\uff0c\u65b9\u6cd5\u975e\u5e38\u76f8\u4f3c\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6211\u4eec\u53ea\u8fdb\u884c\u4e00\u6b21\u5904\u7406\uff1a private void renderDirectionalLight(Window window, Camera camera, Scene scene) { dirLightShaderProgram.bind(); Matrix4f viewMatrix = camera.getViewMatrix(); Matrix4f projectionMatrix = window.getProjectionMatrix(); dirLightShaderProgram.setUniform(\"modelMatrix\", bufferPassModelMatrix); dirLightShaderProgram.setUniform(\"projectionMatrix\", projectionMatrix); // \u955c\u9762\u53cd\u5c04\u7cfb\u6570 dirLightShaderProgram.setUniform(\"specularPower\", specularPower); // \u7ed1\u5b9aG\u7f13\u51b2\u533a\u7eb9\u7406 int[] textureIds = this.gBuffer.getTextureIds(); int numTextures = textureIds != null ? textureIds.length : 0; for (int i=0; i<numTextures; i++) { glActiveTexture(GL_TEXTURE0 + i); glBindTexture(GL_TEXTURE_2D, textureIds[i]); } dirLightShaderProgram.setUniform(\"positionsText\", 0); dirLightShaderProgram.setUniform(\"diffuseText\", 1); dirLightShaderProgram.setUniform(\"specularText\", 2); dirLightShaderProgram.setUniform(\"normalsText\", 3); dirLightShaderProgram.setUniform(\"shadowText\", 4); dirLightShaderProgram.setUniform(\"screenSize\", (float) gBuffer.getWidth(), (float)gBuffer.getHeight()); // \u73af\u5883\u5149\u7167 SceneLight sceneLight = scene.getSceneLight(); dirLightShaderProgram.setUniform(\"ambientLight\", sceneLight.getAmbientLight()); // \u5e73\u884c\u5149 // \u83b7\u53d6\u5e73\u884c\u5149\u5bf9\u8c61\u7684\u526f\u672c\u5e76\u5c06\u5176\u4f4d\u7f6e\u8f6c\u6362\u5230\u89c2\u5bdf\u5750\u6807\u7cfb DirectionalLight currDirLight = new DirectionalLight(sceneLight.getDirectionalLight()); tmpVec.set(currDirLight.getDirection(), 0); tmpVec.mul(viewMatrix); currDirLight.setDirection(new Vector3f(tmpVec.x, tmpVec.y, tmpVec.z)); dirLightShaderProgram.setUniform(\"directionalLight\", currDirLight); bufferPassMesh.render(); dirLightShaderProgram.unbind(); } endLightRendering \u53ea\u7b80\u5355\u5730\u6062\u590d\u72b6\u6001\u3002 private void endLightRendering() { // \u7ed1\u5b9a\u5c4f\u5e55\u4ee5\u4fbf\u5199\u5165 glBindFramebuffer(GL_FRAMEBUFFER, 0); glEnable(GL_DEPTH_TEST); glDisable(GL_BLEND); } \u5982\u679c\u8fd0\u884c\u793a\u4f8b\uff0c\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u672c\u7ae0\u6bd4\u9884\u671f\u65f6\u95f4\u957f\uff0c\u4f46\u6709\u51e0\u4e2a\u8981\u70b9\u9700\u8981\u6f84\u6e05\uff1a \u4e3a\u4e86\u7b80\u5316\u672c\u7ae0\uff0c\u5df2\u7ecf\u5220\u9664\u4e86\u805a\u5149\u6e90\u7684\u76f8\u5173\u5185\u5bb9\u3002 \u5ef6\u8fdf\u7740\u8272\u6cd5\u4e2d\u4f7f\u7528\u70b9\u5149\u6e90\u7684\u4e00\u79cd\u5e38\u89c1\u6280\u672f\u662f\u8ba1\u7b97\u53d7\u8be5\u5149\u6e90\u5f71\u54cd\u7684\u573a\u666f\u533a\u57df\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\u8f83\u5c0f\u7684\u56db\u8fb9\u5f62\uff0c\u5706\u5f62\u7b49\uff0c\u800c\u4e0d\u662f\u6e32\u67d3\u5145\u6ee1\u5c4f\u5e55\u7684\u77e9\u5f62\u3002\u8bf7\u7262\u8bb0\uff0c\u6700\u597d\u662f\u597d\u7684\u654c\u4eba\uff0c\u8fdb\u884c\u590d\u6742\u7684\u5fae\u79ef\u5206\u4ee5\u786e\u5b9a\u6240\u9700\u7684\u6700\u5c0f\u5f62\u72b6\u53ef\u80fd\u6bd4\u4f7f\u7528\u5176\u4ed6\u7c97\u7cd9\u65b9\u6cd5\u6162\u3002 \u5982\u679c\u6ca1\u6709\u8bb8\u591a\u5149\u6e90\uff0c\u6b64\u65b9\u6cd5\u6bd4\u6b63\u5411\u7740\u8272\u6cd5\u6162\u3002 \u6700\u540e\u8981\u6ce8\u610f\u7684\u4e00\u70b9\u662f\uff0c\u5982\u679c\u4f60\u60f3\u4e86\u89e3\u8fd9\u4e9b\u6280\u672f\u5728\u73b0\u5b9e\u4e2d\u7684\u5e94\u7528\uff0c\u53ef\u4ee5\u67e5\u770b \u8fd9\u4e2a\u6781\u597d\u7684\u8bf4\u660e \uff0c\u4e86\u89e3GTA V\u7684\u5e27\u662f\u5982\u4f55\u6e32\u67d3\u7684\u3002","title":"\u5ef6\u8fdf\u7740\u8272\u6cd5\uff08Deferred Shading\uff09"},{"location":"a01-opengl-debugging/","text":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5\uff08OpenGL Debugging\uff09 \u8c03\u8bd5OpenGL\u7a0b\u5e8f\u53ef\u80fd\u662f\u4e00\u9879\u8270\u5de8\u7684\u4efb\u52a1\u3002\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u4e00\u4e2a\u9ed1\u5c4f\uff0c\u4f60\u65e0\u6cd5\u77e5\u9053\u5230\u5e95\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e3a\u4e86\u7f13\u89e3\u8fd9\u4e2a\u7a98\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e9b\u73b0\u6709\u7684\u5de5\u5177\u6765\u63d0\u4f9b\u5173\u4e8e\u6e32\u67d3\u6d41\u7a0b\u7684\u66f4\u591a\u4fe1\u606f\u3002 \u5728\u672c\u9644\u5f55\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 RenderDoc \u5de5\u5177\u8c03\u8bd5LWJGL\u7a0b\u5e8f\u3002RenderDoc\u662f\u4e00\u4e2a\u56fe\u5f62\u8c03\u8bd5\u5de5\u7a0b\uff0c\u53ef\u4ee5\u4e0eDirect3D\u3001Vulkan\u548cOpenGL\u4e00\u8d77\u4f7f\u7528\u3002\u5bf9\u4e8eOpenGL\uff0c\u5b83\u4ec5\u652f\u6301\u4ece3.2\u52304.5\u7684\u6838\u5fc3\u6a21\u5f0f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5427\uff0c\u4f60\u9700\u8981\u4e0b\u8f7d\u5e76\u5b89\u88c5\u5bf9\u5e94\u64cd\u4f5c\u7cfb\u7edf\u7684RenderDoc\u3002\u5b89\u88c5\u540e\uff0c\u5f53\u4f60\u542f\u52a8\u5b83\u65f6\uff0c\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u4e1c\u897f\uff1a \u7b2c\u4e00\u6b65\u662f\u914d\u7f6eRenderDoc\u6765\u8fd0\u884c\u548c\u76d1\u89c6\u6211\u4eec\u7684\u793a\u4f8b\u3002\u5728\u201cCapture Executable\u201d\u9009\u9879\u5361\u4e2d\uff0c\u9700\u8981\u8bbe\u7f6e\u4ee5\u4e0b\u53c2\u6570\uff1a Executable path \uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u5e94\u8be5\u6307\u5411JVM\u542f\u52a8\u7a0b\u5e8f\uff08\u4f8b\u5982\uff0c\u201cC:\\Program Files\\Java\\jdk-9\\bin\\java.exe\u201d\uff09\u3002 Working Directory \uff1a\u8fd9\u5c06\u4e3a\u4f60\u7684\u7a0b\u5e8f\u8bbe\u7f6e\u5de5\u4f5c\u76ee\u5f55\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5e94\u8be5\u5c06\u5176\u8bbe\u7f6e\u4e3aMaven\u8f6c\u50a8\u7ed3\u679c\u7684 target \u76ee\u5f55\u3002\u8fd9\u6837\u8bbe\u7f6e\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u4f9d\u8d56\u9879\u3002 Command line arguments \uff1a\u8fd9\u5c06\u5305\u542bJVM\u8fd0\u884c\u793a\u4f8b\u6240\u9700\u7684\u53c2\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u53ea\u9700\u8981\u4f20\u9012\u8981\u6267\u884c\u7684Jar\uff08\u4f8b\u5982\uff0c\u201c-java game-c28-1.0.jar\u201d\uff09\u3002 \u4f60\u8981\u8bb0\u4f4f3D\u6a21\u578b\u73b0\u5df2\u7531 Assimp \u5e93\u52a0\u8f7d\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u5b9e\u9645\u7684\u6587\u4ef6\u8def\u5f84\uff08\u800c\u4e0d\u662f CLASSPATH \u7684\u76f8\u5bf9\u8def\u5f84\uff09\uff0c\u56e0\u6b64\u4f60\u9700\u8981\u5728\u4f60\u8bbe\u7f6e\u7684\u5de5\u4f5c\u76ee\u5f55\u68c0\u67e5\u8def\u5f84\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6700\u7b80\u5355\u5feb\u901f\u7684\u6d4b\u8bd5\u65b9\u6cd5\u662f\u5c06src\u6587\u4ef6\u5939\u590d\u5236\u5230 target \u76ee\u5f55\u4e2d\u3002 \u6b64\u9009\u9879\u5361\u4e2d\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u9009\u9879\u7528\u4e8e\u914d\u7f6e\u6355\u83b7\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u5728 RenderDoc\u6587\u6863 \u4e2d\u67e5\u9605\u5b83\u4eec\u7684\u7528\u9014\u3002\u4e00\u5207\u5c31\u7eea\u540e\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u70b9\u51fb\u201cLaunch\u201d\u6309\u94ae\u6765\u5f00\u59cb\u8fd0\u884c\u7a0b\u5e8f\u3002\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u56e0\u4e3aRenderDoc\u53ea\u80fd\u4f7f\u7528OpenGL\u6838\u5fc3\u6a21\u5f0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u517c\u5bb9\u6027\u6a21\u5f0f\uff0c\u4f46\u5b83\u4f1a\u5ffd\u7565\u8b66\u544a\u7ee7\u7eed\u5de5\u4f5c\u3002\u7a0b\u5e8f\u8fd0\u884c\u540e\uff0c\u4f60\u5c31\u53ef\u4ee5\u89e6\u53d1\u5b83\u7684\u5feb\u7167\u3002\u4f60\u5c06\u770b\u5230\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u9009\u9879\u5361\uff0c\u540d\u4e3a\u201cjava [PID XXXX]\u201d\uff08\u5176\u4e2dXXXX\u6570\u5b57\u8868\u793aJava\u8fdb\u7a0b\u7684PID\u3001\u8fdb\u7a0b\u6807\u8bc6\u53f7\uff09 \u4ece\u8be5\u9009\u9879\u5361\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u6309\u4e0b\u201cTrigger capture\u201d\u6309\u94ae\u6765\u6355\u83b7\u7a0b\u5e8f\u7684\u72b6\u6001\u3002\u751f\u6210\u4e86\u4e00\u4e2a\u6355\u83b7\u7ed3\u679c\u540e\uff0c\u4f60\u5c06\u5728\u540c\u4e00\u4e2a\u9009\u9879\u5361\u4e2d\u770b\u5230\u4e00\u4e2a\u5c0f\u5feb\u7167\u3002 \u5982\u679c\u53cc\u51fb\u8be5\u6355\u83b7\u7ed3\u679c\uff0c\u5219\u5c06\u52a0\u8f7d\u6536\u96c6\u7684\u6240\u6709\u6570\u636e\uff0c\u5e76\u53ef\u4ee5\u5f00\u59cb\u67e5\u770b\u5b83\u3002\u201cEvent Browser\u201d\u9762\u677f\u5c06\u663e\u793a\u6240\u6709\u5728\u4e00\u4e2a\u6e32\u67d3\u5468\u671f\u5185\u6267\u884c\u7684\u4e0eOpenGL\u76f8\u5173\u7684\u8c03\u7528\u3002 \u5bf9\u4e8e\u7b2c\u4e00\u4e2a\u6e32\u67d3\u6d41\u7a0b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u5730\u9762\u662f\u5982\u4f55\u5728\u6a21\u578b\u623f\u5c4b\u7684\u7f51\u683c\u4e4b\u540e\u7ed8\u5236\u7684\u3002\u5982\u679c\u5355\u51fb\u4e00\u4e2aglDrawELements\u4e8b\u4ef6\uff0c\u5e76\u9009\u62e9\u201cMesh\u201d\u9009\u9879\u5361\uff0c\u5219\u53ef\u4ee5\u67e5\u770b\u7ed8\u5236\u7684\u7f51\u683c\uff0c\u4e8b\u4ef6\u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u8f93\u5165\u4e0e\u8f93\u51fa\u3002 \u4f60\u6362\u53ef\u4ee5\u67e5\u770b\u7528\u4e8e\u8be5\u7ed8\u5236\u64cd\u4f5c\u7684\u8f93\u5165\u7eb9\u7406\uff08\u901a\u8fc7\u5355\u51fb\u201cTexture Viewer\u201d\u9009\u9879\u5361\uff09\u3002 \u5728\u4e2d\u592e\u9762\u677f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u8f93\u51fa\uff0c\u5728\u53f3\u4fa7\u9762\u677f\u4e0a\u53ef\u4ee5\u770b\u5230\u7528\u4e8e\u8f93\u5165\u7684\u7eb9\u7406\u5217\u8868\u3002\u8fd8\u53ef\u4ee5\u9010\u4e2a\u67e5\u770b\u8f93\u51fa\u7eb9\u7406\u3002\u8fd9\u5f88\u597d\u5730\u8bf4\u660e\u4e86\u5ef6\u8fdf\u7740\u8272\u662f\u5982\u4f55\u5de5\u4f5c\u7684\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u8be5\u5de5\u5177\u63d0\u4f9b\u4e86\u6709\u5173\u6e32\u67d3\u65f6\u53d1\u751f\u7684\u60c5\u51b5\u7684\u5b9d\u8d35\u6570\u636e\uff0c\u5b83\u53ef\u4ee5\u5728\u8c03\u8bd5\u6e32\u67d3\u95ee\u9898\u65f6\u8282\u7701\u5b9d\u8d35\u7684\u65f6\u95f4\u3002\u5b83\u751a\u81f3\u53ef\u4ee5\u663e\u793a\u6709\u5173\u6e32\u67d3\u7ba1\u7ebf\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u7684\u4fe1\u606f\u3002","title":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5"},{"location":"a01-opengl-debugging/#a-openglopengl-debugging","text":"\u8c03\u8bd5OpenGL\u7a0b\u5e8f\u53ef\u80fd\u662f\u4e00\u9879\u8270\u5de8\u7684\u4efb\u52a1\u3002\u5728\u5927\u591a\u6570\u60c5\u51b5\u4e0b\uff0c\u4f60\u4f1a\u770b\u5230\u4e00\u4e2a\u9ed1\u5c4f\uff0c\u4f60\u65e0\u6cd5\u77e5\u9053\u5230\u5e95\u53d1\u751f\u4e86\u4ec0\u4e48\u3002\u4e3a\u4e86\u7f13\u89e3\u8fd9\u4e2a\u7a98\u51b5\uff0c\u6211\u4eec\u53ef\u4ee5\u4f7f\u7528\u4e00\u4e9b\u73b0\u6709\u7684\u5de5\u5177\u6765\u63d0\u4f9b\u5173\u4e8e\u6e32\u67d3\u6d41\u7a0b\u7684\u66f4\u591a\u4fe1\u606f\u3002 \u5728\u672c\u9644\u5f55\u4e2d\uff0c\u6211\u4eec\u5c06\u5b66\u4e60\u5982\u4f55\u4f7f\u7528 RenderDoc \u5de5\u5177\u8c03\u8bd5LWJGL\u7a0b\u5e8f\u3002RenderDoc\u662f\u4e00\u4e2a\u56fe\u5f62\u8c03\u8bd5\u5de5\u7a0b\uff0c\u53ef\u4ee5\u4e0eDirect3D\u3001Vulkan\u548cOpenGL\u4e00\u8d77\u4f7f\u7528\u3002\u5bf9\u4e8eOpenGL\uff0c\u5b83\u4ec5\u652f\u6301\u4ece3.2\u52304.5\u7684\u6838\u5fc3\u6a21\u5f0f\u3002 \u8ba9\u6211\u4eec\u5f00\u59cb\u5427\uff0c\u4f60\u9700\u8981\u4e0b\u8f7d\u5e76\u5b89\u88c5\u5bf9\u5e94\u64cd\u4f5c\u7cfb\u7edf\u7684RenderDoc\u3002\u5b89\u88c5\u540e\uff0c\u5f53\u4f60\u542f\u52a8\u5b83\u65f6\uff0c\u4f1a\u770b\u5230\u7c7b\u4f3c\u4e8e\u4e0b\u56fe\u7684\u4e1c\u897f\uff1a \u7b2c\u4e00\u6b65\u662f\u914d\u7f6eRenderDoc\u6765\u8fd0\u884c\u548c\u76d1\u89c6\u6211\u4eec\u7684\u793a\u4f8b\u3002\u5728\u201cCapture Executable\u201d\u9009\u9879\u5361\u4e2d\uff0c\u9700\u8981\u8bbe\u7f6e\u4ee5\u4e0b\u53c2\u6570\uff1a Executable path \uff1a\u5728\u672c\u4f8b\u4e2d\uff0c\u8fd9\u5e94\u8be5\u6307\u5411JVM\u542f\u52a8\u7a0b\u5e8f\uff08\u4f8b\u5982\uff0c\u201cC:\\Program Files\\Java\\jdk-9\\bin\\java.exe\u201d\uff09\u3002 Working Directory \uff1a\u8fd9\u5c06\u4e3a\u4f60\u7684\u7a0b\u5e8f\u8bbe\u7f6e\u5de5\u4f5c\u76ee\u5f55\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u5e94\u8be5\u5c06\u5176\u8bbe\u7f6e\u4e3aMaven\u8f6c\u50a8\u7ed3\u679c\u7684 target \u76ee\u5f55\u3002\u8fd9\u6837\u8bbe\u7f6e\u540e\uff0c\u53ef\u4ee5\u627e\u5230\u4f9d\u8d56\u9879\u3002 Command line arguments \uff1a\u8fd9\u5c06\u5305\u542bJVM\u8fd0\u884c\u793a\u4f8b\u6240\u9700\u7684\u53c2\u6570\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u53ea\u9700\u8981\u4f20\u9012\u8981\u6267\u884c\u7684Jar\uff08\u4f8b\u5982\uff0c\u201c-java game-c28-1.0.jar\u201d\uff09\u3002 \u4f60\u8981\u8bb0\u4f4f3D\u6a21\u578b\u73b0\u5df2\u7531 Assimp \u5e93\u52a0\u8f7d\uff0c\u6211\u4eec\u9700\u8981\u7684\u662f\u5b9e\u9645\u7684\u6587\u4ef6\u8def\u5f84\uff08\u800c\u4e0d\u662f CLASSPATH \u7684\u76f8\u5bf9\u8def\u5f84\uff09\uff0c\u56e0\u6b64\u4f60\u9700\u8981\u5728\u4f60\u8bbe\u7f6e\u7684\u5de5\u4f5c\u76ee\u5f55\u68c0\u67e5\u8def\u5f84\u3002\u5728\u6b64\u60c5\u51b5\u4e0b\uff0c\u6700\u7b80\u5355\u5feb\u901f\u7684\u6d4b\u8bd5\u65b9\u6cd5\u662f\u5c06src\u6587\u4ef6\u5939\u590d\u5236\u5230 target \u76ee\u5f55\u4e2d\u3002 \u6b64\u9009\u9879\u5361\u4e2d\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u9009\u9879\u7528\u4e8e\u914d\u7f6e\u6355\u83b7\u9009\u9879\u3002\u4f60\u53ef\u4ee5\u5728 RenderDoc\u6587\u6863 \u4e2d\u67e5\u9605\u5b83\u4eec\u7684\u7528\u9014\u3002\u4e00\u5207\u5c31\u7eea\u540e\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u70b9\u51fb\u201cLaunch\u201d\u6309\u94ae\u6765\u5f00\u59cb\u8fd0\u884c\u7a0b\u5e8f\u3002\u4f60\u5c06\u770b\u5230\u5982\u4e0b\u5185\u5bb9\uff1a \u4f60\u53ef\u80fd\u4f1a\u770b\u5230\u4e00\u4e2a\u8b66\u544a\uff0c\u56e0\u4e3aRenderDoc\u53ea\u80fd\u4f7f\u7528OpenGL\u6838\u5fc3\u6a21\u5f0f\u3002\u5728\u672c\u4f8b\u4e2d\uff0c\u6211\u4eec\u5df2\u7ecf\u542f\u7528\u4e86\u517c\u5bb9\u6027\u6a21\u5f0f\uff0c\u4f46\u5b83\u4f1a\u5ffd\u7565\u8b66\u544a\u7ee7\u7eed\u5de5\u4f5c\u3002\u7a0b\u5e8f\u8fd0\u884c\u540e\uff0c\u4f60\u5c31\u53ef\u4ee5\u89e6\u53d1\u5b83\u7684\u5feb\u7167\u3002\u4f60\u5c06\u770b\u5230\u6dfb\u52a0\u4e86\u4e00\u4e2a\u65b0\u7684\u9009\u9879\u5361\uff0c\u540d\u4e3a\u201cjava [PID XXXX]\u201d\uff08\u5176\u4e2dXXXX\u6570\u5b57\u8868\u793aJava\u8fdb\u7a0b\u7684PID\u3001\u8fdb\u7a0b\u6807\u8bc6\u53f7\uff09 \u4ece\u8be5\u9009\u9879\u5361\u4e2d\uff0c\u4f60\u53ef\u4ee5\u901a\u8fc7\u6309\u4e0b\u201cTrigger capture\u201d\u6309\u94ae\u6765\u6355\u83b7\u7a0b\u5e8f\u7684\u72b6\u6001\u3002\u751f\u6210\u4e86\u4e00\u4e2a\u6355\u83b7\u7ed3\u679c\u540e\uff0c\u4f60\u5c06\u5728\u540c\u4e00\u4e2a\u9009\u9879\u5361\u4e2d\u770b\u5230\u4e00\u4e2a\u5c0f\u5feb\u7167\u3002 \u5982\u679c\u53cc\u51fb\u8be5\u6355\u83b7\u7ed3\u679c\uff0c\u5219\u5c06\u52a0\u8f7d\u6536\u96c6\u7684\u6240\u6709\u6570\u636e\uff0c\u5e76\u53ef\u4ee5\u5f00\u59cb\u67e5\u770b\u5b83\u3002\u201cEvent Browser\u201d\u9762\u677f\u5c06\u663e\u793a\u6240\u6709\u5728\u4e00\u4e2a\u6e32\u67d3\u5468\u671f\u5185\u6267\u884c\u7684\u4e0eOpenGL\u76f8\u5173\u7684\u8c03\u7528\u3002 \u5bf9\u4e8e\u7b2c\u4e00\u4e2a\u6e32\u67d3\u6d41\u7a0b\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u5730\u9762\u662f\u5982\u4f55\u5728\u6a21\u578b\u623f\u5c4b\u7684\u7f51\u683c\u4e4b\u540e\u7ed8\u5236\u7684\u3002\u5982\u679c\u5355\u51fb\u4e00\u4e2aglDrawELements\u4e8b\u4ef6\uff0c\u5e76\u9009\u62e9\u201cMesh\u201d\u9009\u9879\u5361\uff0c\u5219\u53ef\u4ee5\u67e5\u770b\u7ed8\u5236\u7684\u7f51\u683c\uff0c\u4e8b\u4ef6\u7684\u9876\u70b9\u7740\u8272\u5668\u7684\u8f93\u5165\u4e0e\u8f93\u51fa\u3002 \u4f60\u6362\u53ef\u4ee5\u67e5\u770b\u7528\u4e8e\u8be5\u7ed8\u5236\u64cd\u4f5c\u7684\u8f93\u5165\u7eb9\u7406\uff08\u901a\u8fc7\u5355\u51fb\u201cTexture Viewer\u201d\u9009\u9879\u5361\uff09\u3002 \u5728\u4e2d\u592e\u9762\u677f\u4e2d\uff0c\u4f60\u53ef\u4ee5\u770b\u5230\u8f93\u51fa\uff0c\u5728\u53f3\u4fa7\u9762\u677f\u4e0a\u53ef\u4ee5\u770b\u5230\u7528\u4e8e\u8f93\u5165\u7684\u7eb9\u7406\u5217\u8868\u3002\u8fd8\u53ef\u4ee5\u9010\u4e2a\u67e5\u770b\u8f93\u51fa\u7eb9\u7406\u3002\u8fd9\u5f88\u597d\u5730\u8bf4\u660e\u4e86\u5ef6\u8fdf\u7740\u8272\u662f\u5982\u4f55\u5de5\u4f5c\u7684\u3002 \u5982\u4f60\u6240\u89c1\uff0c\u8be5\u5de5\u5177\u63d0\u4f9b\u4e86\u6709\u5173\u6e32\u67d3\u65f6\u53d1\u751f\u7684\u60c5\u51b5\u7684\u5b9d\u8d35\u6570\u636e\uff0c\u5b83\u53ef\u4ee5\u5728\u8c03\u8bd5\u6e32\u67d3\u95ee\u9898\u65f6\u8282\u7701\u5b9d\u8d35\u7684\u65f6\u95f4\u3002\u5b83\u751a\u81f3\u53ef\u4ee5\u663e\u793a\u6709\u5173\u6e32\u67d3\u7ba1\u7ebf\u4e2d\u4f7f\u7528\u7684\u7740\u8272\u5668\u7684\u4fe1\u606f\u3002","title":"\u9644\u5f55 A - OpenGL\u8c03\u8bd5\uff08OpenGL Debugging\uff09"},{"location":"glossary/","text":"\u672f\u8bed\u8868 \u672c\u4e66\u672f\u8bed\u8868\u6309\u672f\u8bed\u9996\u6b21\u4ecb\u7ecd\u7ae0\u8282\u6392\u5e8f\u3002 Java\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93\uff08Lightweight Java Game Library\uff0cLWJGL\uff09\uff1a OpenGL\u3001OpenCL\u3001OpenAL\u548cVulkan\u5bf9Java\u5e73\u53f0\u7684\u539f\u751f\u7ed1\u5b9a\uff0c\u5e38\u7528\u4e8e\u5f00\u53d1\u6e38\u620f\u3002 GLFW\uff1a \u4e3aOpenGL\u3001OpenGL ES\u548cVulkan\u63d0\u4f9b\u7684\u8de8\u5e73\u53f0\u7a97\u53e3\u4e0e\u8f93\u5165\u5e93\u3002 \u5e27\u7387\uff08Frames Per Second\uff0cFPS\uff09\uff1a \u4ee5\u5e27\u79f0\u4e3a\u5355\u4f4d\u7684\u4f4d\u56fe\u56fe\u50cf\u8fde\u7eed\u51fa\u73b0\u5728\u663e\u793a\u5668\u4e0a\u7684\u9891\u7387\uff08\u901f\u7387\uff09\uff0c\u5355\u4f4d\u4e3aHz\u6216FPS\uff0c\u901a\u4fd7\u6765\u8bb2\u5c31\u662f\u6bcf\u79d2\u51fa\u73b0\u5728\u5c4f\u5e55\u4e0a\u7684\u753b\u9762\u6570\u3002 \u5b9a\u957f\u6e38\u620f\u5faa\u73af\uff08Fixed Step Game Loop\uff09\uff1a \u4ee5\u56fa\u5b9a\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u7684\u6e38\u620f\u5faa\u73af\u3002 \u5782\u76f4\u540c\u6b65\uff08Vertical Synchronization\uff09\uff1a \u907f\u514d\u56e0\u4e3a\u6e38\u620f\u8fd0\u884c\u901f\u5ea6\u8fc7\u5feb\u5bfc\u81f4\u7684\u753b\u9762\u6495\u88c2\u73b0\u8c61\u3002 \u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\uff1a \u53c8\u79f0 \u6e32\u67d3\u7ba1\u7ebf\uff08Rendering Pipeline\uff09 \uff0c\u662f\u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u3002 \u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\uff1a \u56fa\u5b9a\u7ba1\u7ebf\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\uff1a \u53ef\u7f16\u7a0b\u7ba1\u7ebf\u4f7f\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002 \u7740\u8272\u5668\uff08Shader\uff09\uff1a \u7528\u4e8e\u63a7\u5236\u56fe\u5f62\u7ba1\u7ebf\u4e0d\u540c\u9636\u6bb5\u7684\u7279\u5b9a\u7a0b\u5e8f\u3002 \u9876\u70b9\uff08Vertex\uff09\uff1a \u7528\u4e8e\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002 \u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\uff1a \u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002 \u4e09\u89d2\u5f62\uff08Triangle\uff09\uff1a \u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\u4e4b\u4e00\uff0c\u6700\u7b80\u5355\u7684\u4e8c\u7ef4\u51e0\u4f55\u5f62\u72b6\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u751f\u6210\u7684\u4e09\u89d2\u5f62\u526a\u8f91\u5e76\u5c06\u5176\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u7247\u5143\uff08Fragment\uff09\uff1a \u7ec4\u6210\u5e27\u7684\u6700\u5c0f\u5355\u4f4d\uff0c\u901a\u5e38\u76f8\u5f53\u4e8e\u4e00\u4e2a\u50cf\u7d20\u7684\u5927\u5c0f\uff0c\u53ef\u8ba4\u4e3a\u5176\u5373\u662f\u50cf\u7d20\uff08Pixel\uff09\u3002 \u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u56fe\u5f62\u7ba1\u7ebf\u7684\u8f93\u51fa\uff0c\u7531\u591a\u4e2a\u50cf\u7d20\u7ec4\u6210\u7684\u6570\u636e\u7ed3\u6784\u3002 OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\uff1a \u7528\u4e8e\u7f16\u5199OpenGL\u7740\u8272\u5668\u7684\u7c7bC\u8bed\u8a00\u3002 \u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\uff1a \u9f50\u6b21\u5750\u6807\u5c31\u662f\u5c06\u4e00\u4e2a\u539f\u672c\u662fn\u7ef4\u7684\u5411\u91cf\u7528\u4e00\u4e2an+1\u7ef4\u5411\u91cf\u6765\u8868\u793a\u3002 \u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\uff1a \u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u6216\u5176\u4ed6\u6570\u636e\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\u7684\u5bf9\u8c61\uff0c\u4fbf\u4e8e\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u50a8\u5b58\u7684\u6570\u636e\u3002 \u56db\u8fb9\u5f62\uff08Quad\uff09\uff1a \u53ef\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u7531\u56db\u4e2a\u9876\u70b9\u7ec4\u6210\u3002 \u7f51\u683c\uff08Mesh\uff09\uff1a \u6e38\u620f\u5f00\u53d1\u4e2d\u5e38\u89c1\u6982\u5ff5\u4e4b\u4e00\uff0c\u901a\u5e38\u7528\u4e8e\u5305\u88c5\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\uff0c\u50a8\u5b58\u6a21\u578b\u7684\u4f4d\u7f6e\u3001\u9876\u70b9\u7d22\u5f15\u3001\u989c\u8272\u7b49\u6570\u636e\u3002 \u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\uff1a \u7528\u4e8e\u6307\u5b9a\u9876\u70b9\u7ed8\u5236\u987a\u5e8f\u7684\u7f13\u51b2\u533a\u3002 \u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\uff1a \u5c06\u9876\u70b9\u4ece\u4e09\u7ef4\u4e16\u754c\u7a7a\u95f4\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u7684\u77e9\u9635\u3002 \u622a\u9525\u4f53\uff08Frustum\uff09\uff1a \u4e09\u7ef4\u51e0\u4f55\u4f53\u7684\u4e00\u79cd\uff0c\u53c8\u79f0\u4e3a\u68f1\u53f0\u3002\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u4e3a\u56db\u68f1\u53f0\u3002 \u77e9\u9635\uff08Matrix\uff09\uff1a \u77e9\u9635\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\uff0c\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u7528\u4e8e\u53d8\u6362\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u3002 \u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\uff1a \u9ad8\u5ea6\u4e0e\u5bbd\u5ea6\u4e4b\u6bd4\u3002 JOML\uff08Java OpenGL Math Library\uff09\uff1a Java OpenGL \u6570\u5b66\u5e93\uff0c\u63d0\u4f9b\u4e86\u5bf9OpenGL\u7684\u4e00\u7cfb\u5217\u5e38\u7528\u6570\u5b66\u5b9e\u4f53\u7684\u5c01\u88c5\u3002 Uniform\uff1a Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\u3002 \u4f4d\u79fb\uff08Translation\uff09\uff1a \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09\uff1a \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09\uff1a \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u53d8\u6362\uff08Transformation\uff09\uff1a \u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4e09\u8005\u7684\u7edf\u79f0\u3002 \u4e16\u754c\u77e9\u9635\uff08World Matrix\uff09\uff1a \u5c06\u7269\u4f53\u6216\u6a21\u578b\u4ece\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u7a7a\u95f4\u7684\u77e9\u9635\uff0c\u7531\u4f4d\u79fb\u77e9\u9635\u3001\u65cb\u8f6c\u77e9\u9635\u548c\u7f29\u653e\u77e9\u9635\u76f8\u4e58\u6240\u5f97\u3002 \u4f4d\u79fb\u77e9\u9635\uff08Translation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u4f4d\u79fb\u53d8\u6362\u7684\u77e9\u9635\u3002 \u65cb\u8f6c\u77e9\u9635\uff08Rotation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u65cb\u8f6c\u53d8\u6362\u7684\u77e9\u9635\u3002 \u7f29\u653e\u77e9\u9635\uff08Scale Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u7f29\u653e\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\uff1a \u5bf9\u7247\u5143\u8fdb\u884c\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u4e22\u5f03\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u7247\u5143\u3002 \u7eb9\u7406\uff08Texture\uff09\uff1a \u7528\u4e8e\u7ed8\u5236\u6a21\u578b\u7684\u50cf\u7d20\u7684\u56fe\u50cf\u3002 \u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\uff1a \u5bf9\u4e8e\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u50cf\u7d20\uff0c\u5c06\u4f7f\u7528\u7ec6\u8282\u8f83\u4f4e\u7684\u7eb9\u7406\u8fdb\u884c\u7ed8\u5236\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u53ef\u89e3\u51b3\u7531\u4e8e\u8ddd\u79bb\u95ee\u9898\u800c\u5bfc\u81f4\u7684\u8fdc\u5904\u50cf\u7d20\u95ea\u70c1\u95ee\u9898\u3002 \u7eb9\u7406\u5750\u6807\uff08Texture Coordinate\uff09\uff1a \u901a\u5e38\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\uff0c\u7528\u4e8e\u6307\u5b9a\u7247\u5143\u5728\u7eb9\u7406\u4e0a\u7684\u4f4d\u7f6e\u3002 \u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u7eb9\u7406\u7684\u7a7a\u95f4\u3002 \u53d6\u6837\u5668\uff08Sampler\uff09\uff1a Uniform\u7c7b\u578b\u4e4b\u4e00\uff0c\u7528\u4e8e\u6307\u5b9a\u88ab\u53d6\u6837\u7684\u7eb9\u7406\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a OpenGL\u529f\u80fd\u4e4b\u4e00\uff0c\u7528\u4e8e\u6e32\u67d3\u900f\u660e\u6216\u534a\u900f\u660e\u7269\u4f53\uff0c\u5c06\u5176\u7247\u5143\u4e0e\u5176\u540e\u7247\u5143\u7684\u989c\u8272\u8fdb\u884c\u6df7\u5408\u3002 \u6444\u50cf\u673a\uff08Camera\uff09\uff1a \u7528\u4e8e\u81ea\u7531\u89c2\u5bdf\u4e09\u7ef4\u4e16\u754c\u7684\u529f\u80fd\u3002OpenGL\u4e2d\u4e0d\u5b58\u5728\u6b64\u529f\u80fd\u548c\u6982\u5ff5\uff0c\u79fb\u52a8\u6444\u50cf\u673a\u5b9e\u9645\u4e0a\u662f\u5c06\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u5411\u76f8\u53cd\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u7ffb\u6eda\uff08Roll\uff09\uff1a \u6b27\u62c9\u89d2\uff08Euler Angles\uff09\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7eb5\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u4fef\u4ef0\uff08Pitch\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u6a2a\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u504f\u822a\uff08Yaw\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7ad6\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\uff1a \u7528\u4e8e\u5c06\u9876\u70b9\u5411\u6444\u50cf\u673a\u6240\u5728\u4f4d\u7f6e\u7684\u76f8\u53cd\u65b9\u5411\u548c\u65cb\u8f6c\u72b6\u6001\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\uff1a \u662f\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\uff0c\u53ef\u5c06\u6a21\u578b\u7a7a\u95f4\u7684\u5750\u6807\u53d8\u6362\u5230\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\uff0c\u7528\u4e8e\u7b80\u5316\u8ba1\u7b97\u3002 OBJ\uff08.obj\uff09\uff1a Wavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002 \u6cd5\u7ebf\uff08Normal\uff09\uff1a \u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u5411\u91cf\u3002 \u5f52\u4e00\u5316\uff08Normalize\uff09\uff1a \u4f7f\u5411\u91cf\u7684\u957f\u5ea6\uff08\u6216\u6a21\u957f\uff09\u4e3a1\u3002 \u9876\u70b9\u6cd5\u7ebf\uff08Vertex Normal\uff09\uff1a \u4e00\u4e2a\u9876\u70b9\u7684\u6cd5\u7ebf\u662f\u5176\u53c2\u4e0e\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u7684\u9762\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff0c\u5176\u957f\u5ea6\u4ecd\u4e3a1\u3002 \u70b9\u5149\u6e90\uff08Point Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09\uff1a \u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09\uff1a \u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09\uff1a \u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 HUD\uff08Heads-Up Display\uff09\uff1a \u5e73\u89c6\u663e\u793a\u5668\uff0c\u5e38\u7528\u4e8e\u98de\u673a\u4e0a\u5c06\u91cd\u8981\u4fe1\u606f\u6295\u5f71\u4e8e\u6321\u98ce\u73bb\u7483\u6216\u5934\u76d4\u4e0a\uff0c\u4ee5\u4fbf\u98de\u884c\u5458\u540c\u65f6\u67e5\u770b\u524d\u65b9\u60c5\u51b5\u548c\u98de\u884c\u4fe1\u606f\u3002\u73b0\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u5c06\u6e38\u620f\u4e2d\u7684\u91cd\u8981\u4fe1\u606f\u663e\u793a\u4e8e\u4e09\u7ef4\u573a\u666f\u524d\u3002 \u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff0cOrthogonal Projection\uff09\uff1a \u4e5f\u79f0\u4e3a\u6b63\u6295\u5f71\uff0c\u6b63\u5c04\u6295\u5f71\u3002\u6307\u4e0d\u53d7\u8fd1\u5927\u8fdc\u5c0f\u5f71\u54cd\u7684\u5c06\u4e09\u7ef4\u7269\u4f53\u6295\u5f71\u5230\u4e8c\u7ef4\u5e73\u9762\u4e0a\u7684\u6295\u5f71\u65b9\u5f0f\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a \u5b9e\u73b03D\u6e32\u67d3\u4e2d\u7269\u4f53\u900f\u660e\u7684\u4e00\u4e2a\u529f\u80fd\uff0c\u542f\u7528\u900f\u660e\u5c06\u5141\u8bb8\u4f7f\u7528Alpha\u5206\u91cf\u6df7\u5408\u989c\u8272\u3002 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\uff1a \u5305\u88f93D\u573a\u666f\u5e76\u4ee5\u6444\u50cf\u673a\u4f4d\u7f6e\u4e3a\u539f\u70b9\u7684\u5de8\u5927\u7acb\u65b9\u4f53\uff0c\u5c06\u7eb9\u7406\u6e32\u67d3\u5728\u8be5\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4ee5\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff1a \u5c06\u7eb9\u7406\u5206\u4e3a\u516d\u4e2a\u90e8\u5206\uff0c\u5c06\u5404\u90e8\u5206\u6620\u5c04\u5230\u7acb\u65b9\u4f53\u4e0a\u3002 \u9762\u5254\u9664\uff08Face Culling\uff09\uff1a \u5254\u9664\u65e0\u7528\u6216\u770b\u4e0d\u5230\u7684\u9762\uff0c\u4ee5\u63d0\u5347\u6027\u80fd\u7684OpenGL\u529f\u80fd\u3002","title":"\u672f\u8bed\u8868"},{"location":"glossary/#_1","text":"\u672c\u4e66\u672f\u8bed\u8868\u6309\u672f\u8bed\u9996\u6b21\u4ecb\u7ecd\u7ae0\u8282\u6392\u5e8f\u3002 Java\u8f7b\u91cf\u7ea7\u6e38\u620f\u5e93\uff08Lightweight Java Game Library\uff0cLWJGL\uff09\uff1a OpenGL\u3001OpenCL\u3001OpenAL\u548cVulkan\u5bf9Java\u5e73\u53f0\u7684\u539f\u751f\u7ed1\u5b9a\uff0c\u5e38\u7528\u4e8e\u5f00\u53d1\u6e38\u620f\u3002 GLFW\uff1a \u4e3aOpenGL\u3001OpenGL ES\u548cVulkan\u63d0\u4f9b\u7684\u8de8\u5e73\u53f0\u7a97\u53e3\u4e0e\u8f93\u5165\u5e93\u3002 \u5e27\u7387\uff08Frames Per Second\uff0cFPS\uff09\uff1a \u4ee5\u5e27\u79f0\u4e3a\u5355\u4f4d\u7684\u4f4d\u56fe\u56fe\u50cf\u8fde\u7eed\u51fa\u73b0\u5728\u663e\u793a\u5668\u4e0a\u7684\u9891\u7387\uff08\u901f\u7387\uff09\uff0c\u5355\u4f4d\u4e3aHz\u6216FPS\uff0c\u901a\u4fd7\u6765\u8bb2\u5c31\u662f\u6bcf\u79d2\u51fa\u73b0\u5728\u5c4f\u5e55\u4e0a\u7684\u753b\u9762\u6570\u3002 \u5b9a\u957f\u6e38\u620f\u5faa\u73af\uff08Fixed Step Game Loop\uff09\uff1a \u4ee5\u56fa\u5b9a\u65f6\u95f4\u5468\u671f\u66f4\u65b0\u7684\u6e38\u620f\u5faa\u73af\u3002 \u5782\u76f4\u540c\u6b65\uff08Vertical Synchronization\uff09\uff1a \u907f\u514d\u56e0\u4e3a\u6e38\u620f\u8fd0\u884c\u901f\u5ea6\u8fc7\u5feb\u5bfc\u81f4\u7684\u753b\u9762\u6495\u88c2\u73b0\u8c61\u3002 \u56fe\u5f62\u7ba1\u7ebf\uff08Graphics Pipeline\uff09\uff1a \u53c8\u79f0 \u6e32\u67d3\u7ba1\u7ebf\uff08Rendering Pipeline\uff09 \uff0c\u662f\u5c06\u4e09\u7ef4\u8868\u793a\u6620\u5c04\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7684\u4e00\u7cfb\u5217\u6b65\u9aa4\u3002 \u56fa\u5b9a\u7ba1\u7ebf\uff08Fixed-function Pipeline\uff09\uff1a \u56fa\u5b9a\u7ba1\u7ebf\u5728\u7ed8\u5236\u8fc7\u7a0b\u4e2d\u5b9a\u4e49\u4e86\u4e00\u7ec4\u56fa\u5b9a\u7684\u64cd\u4f5c\u6b65\u9aa4\uff0c\u7a0b\u5e8f\u5458\u88ab\u6bcf\u4e00\u6b65\u9aa4\u53ef\u7528\u7684\u51fd\u6570\u96c6\u7ea6\u675f\uff0c\u53ef\u4ee5\u4f7f\u7528\u7684\u6548\u679c\u548c\u53ef\u8fdb\u884c\u7684\u64cd\u4f5c\u53d7\u5230API\u7684\u9650\u5236\uff0c\u4f46\u662f\u8fd9\u4e9b\u529f\u80fd\u7684\u5b9e\u73b0\u662f\u56fa\u5b9a\u7684\uff0c\u5e76\u4e14\u4e0d\u80fd\u4fee\u6539\u3002 \u53ef\u7f16\u7a0b\u7ba1\u7ebf\uff08Programmable Pipeline\uff09\uff1a \u53ef\u7f16\u7a0b\u7ba1\u7ebf\u4f7f\u7ec4\u6210\u56fe\u5f62\u7ba1\u7ebf\u7684\u4e0d\u540c\u6b65\u9aa4\u53ef\u4ee5\u901a\u8fc7\u4f7f\u7528\u4e00\u7ec4\u53eb\u505a\u7740\u8272\u5668\u7684\u7279\u5b9a\u7a0b\u5e8f\u6765\u63a7\u5236\u6216\u7f16\u7a0b\u3002 \u7740\u8272\u5668\uff08Shader\uff09\uff1a \u7528\u4e8e\u63a7\u5236\u56fe\u5f62\u7ba1\u7ebf\u4e0d\u540c\u9636\u6bb5\u7684\u7279\u5b9a\u7a0b\u5e8f\u3002 \u9876\u70b9\uff08Vertex\uff09\uff1a \u7528\u4e8e\u63cf\u8ff0\u4e8c\u7ef4\u6216\u8005\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u7684\u6570\u636e\u7ed3\u6784\u3002 \u9876\u70b9\u7f13\u51b2\u533a\uff08Vertex Buffer\uff09\uff1a \u4f7f\u7528\u9876\u70b9\u6570\u7ec4\u6765\u5305\u88c5\u6240\u6709\u9700\u8981\u6e32\u67d3\u7684\u9876\u70b9\u7684\u6570\u636e\u7ed3\u6784\uff0c\u5e76\u4f7f\u8fd9\u4e9b\u6570\u636e\u80fd\u591f\u5728\u56fe\u5f62\u7ba1\u7ebf\u7684\u7740\u8272\u5668\u4e2d\u4f7f\u7528\u3002 \u9876\u70b9\u7740\u8272\u5668\uff08Vertex Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u8ba1\u7b97\u6bcf\u4e2a\u9876\u70b9\u5230\u5c4f\u5e55\u7a7a\u95f4\u4e2d\u7684\u6295\u5f71\u4f4d\u7f6e\u3002 \u51e0\u4f55\u5904\u7406\u9636\u6bb5\uff08Geometry Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u7531\u9876\u70b9\u7740\u8272\u5668\u53d8\u6362\u7684\u9876\u70b9\u8fde\u63a5\u6210\u4e09\u89d2\u5f62\u3002 \u4e09\u89d2\u5f62\uff08Triangle\uff09\uff1a \u663e\u5361\u7684\u57fa\u672c\u5de5\u4f5c\u5355\u5143\u4e4b\u4e00\uff0c\u6700\u7b80\u5355\u7684\u4e8c\u7ef4\u51e0\u4f55\u5f62\u72b6\u3002 \u5149\u6805\u5316\uff08Rasterization\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u6b64\u9636\u6bb5\u5c06\u51e0\u4f55\u5904\u7406\u9636\u6bb5\u751f\u6210\u7684\u4e09\u89d2\u5f62\u526a\u8f91\u5e76\u5c06\u5176\u8f6c\u6362\u4e3a\u50cf\u7d20\u5927\u5c0f\u7684\u7247\u5143\u3002 \u7247\u5143\u5904\u7406\u9636\u6bb5\uff08Fragment Processing\uff09\uff1a \u56fe\u5f62\u7ba1\u7ebf\u9636\u6bb5\u4e4b\u4e00\uff0c\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u7247\u5143\uff08Fragment\uff09\uff1a \u7ec4\u6210\u5e27\u7684\u6700\u5c0f\u5355\u4f4d\uff0c\u901a\u5e38\u76f8\u5f53\u4e8e\u4e00\u4e2a\u50cf\u7d20\u7684\u5927\u5c0f\uff0c\u53ef\u8ba4\u4e3a\u5176\u5373\u662f\u50cf\u7d20\uff08Pixel\uff09\u3002 \u7247\u5143\u7740\u8272\u5668\uff08Fragment Shader\uff09\uff1a \u7740\u8272\u5668\u4e4b\u4e00\uff0c\u7528\u4e8e\u751f\u6210\u5199\u5165\u5230\u5e27\u7f13\u51b2\u533a\u7684\u50cf\u7d20\u7684\u6700\u7ec8\u989c\u8272\u3002 \u5e27\u7f13\u51b2\u533a\uff08Framebuffer\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u56fe\u5f62\u7ba1\u7ebf\u7684\u8f93\u51fa\uff0c\u7531\u591a\u4e2a\u50cf\u7d20\u7ec4\u6210\u7684\u6570\u636e\u7ed3\u6784\u3002 OpenGL\u7740\u8272\u5668\u8bed\u8a00\uff08GLSL\uff09\uff1a \u7528\u4e8e\u7f16\u5199OpenGL\u7740\u8272\u5668\u7684\u7c7bC\u8bed\u8a00\u3002 \u9f50\u6b21\u5750\u6807\uff08Homogeneous Coordinates\uff09\uff1a \u9f50\u6b21\u5750\u6807\u5c31\u662f\u5c06\u4e00\u4e2a\u539f\u672c\u662fn\u7ef4\u7684\u5411\u91cf\u7528\u4e00\u4e2an+1\u7ef4\u5411\u91cf\u6765\u8868\u793a\u3002 \u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\uff08Vertex Buffer Object\uff0cVBO\uff09\uff1a \u663e\u5b58\u4e2d\u5b58\u50a8\u9876\u70b9\u6216\u5176\u4ed6\u6570\u636e\u7684\u5185\u5b58\u7f13\u51b2\u533a\u3002 \u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08Vertex Array Object\uff0cVAO\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u4e00\u4e2a\u6216\u591a\u4e2a\u9876\u70b9\u7f13\u51b2\u5bf9\u8c61\u7684\u5bf9\u8c61\uff0c\u4fbf\u4e8e\u4f7f\u7528\u663e\u5361\u4e2d\u7684\u50a8\u5b58\u7684\u6570\u636e\u3002 \u56db\u8fb9\u5f62\uff08Quad\uff09\uff1a \u53ef\u7531\u4e24\u4e2a\u4e09\u89d2\u5f62\u7ec4\u6210\u7684\u51e0\u4f55\u5f62\u72b6\uff0c\u7531\u56db\u4e2a\u9876\u70b9\u7ec4\u6210\u3002 \u7f51\u683c\uff08Mesh\uff09\uff1a \u6e38\u620f\u5f00\u53d1\u4e2d\u5e38\u89c1\u6982\u5ff5\u4e4b\u4e00\uff0c\u901a\u5e38\u7528\u4e8e\u5305\u88c5\u9876\u70b9\u6570\u7ec4\u5bf9\u8c61\uff08VAO\uff09\uff0c\u50a8\u5b58\u6a21\u578b\u7684\u4f4d\u7f6e\u3001\u9876\u70b9\u7d22\u5f15\u3001\u989c\u8272\u7b49\u6570\u636e\u3002 \u7d22\u5f15\u7f13\u51b2\u533a\uff08Index Buffer\uff09\uff1a \u7528\u4e8e\u6307\u5b9a\u9876\u70b9\u7ed8\u5236\u987a\u5e8f\u7684\u7f13\u51b2\u533a\u3002 \u6295\u5f71\u77e9\u9635\uff08Projection Matrix\uff09\uff1a \u5c06\u9876\u70b9\u4ece\u4e09\u7ef4\u4e16\u754c\u7a7a\u95f4\u6295\u5f71\u5230\u4e8c\u7ef4\u5c4f\u5e55\u7a7a\u95f4\u7684\u77e9\u9635\u3002 \u622a\u9525\u4f53\uff08Frustum\uff09\uff1a \u4e09\u7ef4\u51e0\u4f55\u4f53\u7684\u4e00\u79cd\uff0c\u53c8\u79f0\u4e3a\u68f1\u53f0\u3002\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u4e3a\u56db\u68f1\u53f0\u3002 \u77e9\u9635\uff08Matrix\uff09\uff1a \u77e9\u9635\u662f\u4ee5\u884c\u548c\u5217\u6392\u5217\u7684\u4e8c\u7ef4\u6570\u7ec4\uff0c\u5728\u6e38\u620f\u5f15\u64ce\u4e2d\u901a\u5e38\u7528\u4e8e\u53d8\u6362\u4e09\u7ef4\u7a7a\u95f4\u4e2d\u7684\u70b9\u3002 \u5bbd\u9ad8\u6bd4\uff08Aspect Ratio\uff09\uff1a \u9ad8\u5ea6\u4e0e\u5bbd\u5ea6\u4e4b\u6bd4\u3002 JOML\uff08Java OpenGL Math Library\uff09\uff1a Java OpenGL \u6570\u5b66\u5e93\uff0c\u63d0\u4f9b\u4e86\u5bf9OpenGL\u7684\u4e00\u7cfb\u5217\u5e38\u7528\u6570\u5b66\u5b9e\u4f53\u7684\u5c01\u88c5\u3002 Uniform\uff1a Uniform\u662f\u7740\u8272\u5668\u53ef\u4ee5\u4f7f\u7528\u7684\u5168\u5c40\u7684GLSL\u53d8\u91cf\u3002 \u4f4d\u79fb\uff08Translation\uff09\uff1a \u5728\u4e09\u4e2a\u8f74\u4e2d\u7684\u4efb\u610f\u4e00\u4e2a\u8f74\u4e0a\u79fb\u52a8\u4e00\u4e2a\u7269\u4f53\u3002 \u65cb\u8f6c\uff08Rotation\uff09\uff1a \u6309\u4efb\u610f\u4e00\u4e2a\u8f74\u65cb\u8f6c\u7269\u4f53\u4efb\u610f\u89d2\u5ea6\u3002 \u7f29\u653e\uff08Scale\uff09\uff1a \u8c03\u6574\u7269\u4f53\u7684\u5927\u5c0f\u3002 \u53d8\u6362\uff08Transformation\uff09\uff1a \u4f4d\u79fb\u3001\u65cb\u8f6c\u548c\u7f29\u653e\u4e09\u8005\u7684\u7edf\u79f0\u3002 \u4e16\u754c\u77e9\u9635\uff08World Matrix\uff09\uff1a \u5c06\u7269\u4f53\u6216\u6a21\u578b\u4ece\u6a21\u578b\u5750\u6807\u7a7a\u95f4\u53d8\u6362\u5230\u4e16\u754c\u5750\u6807\u7a7a\u95f4\u7684\u77e9\u9635\uff0c\u7531\u4f4d\u79fb\u77e9\u9635\u3001\u65cb\u8f6c\u77e9\u9635\u548c\u7f29\u653e\u77e9\u9635\u76f8\u4e58\u6240\u5f97\u3002 \u4f4d\u79fb\u77e9\u9635\uff08Translation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u4f4d\u79fb\u53d8\u6362\u7684\u77e9\u9635\u3002 \u65cb\u8f6c\u77e9\u9635\uff08Rotation Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u65cb\u8f6c\u53d8\u6362\u7684\u77e9\u9635\u3002 \u7f29\u653e\u77e9\u9635\uff08Scale Matrix\uff09\uff1a \u53ef\u5bf9\u4e09\u7ef4\u5750\u6807\u8fdb\u884c\u7f29\u653e\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6df1\u5ea6\u6d4b\u8bd5\uff08Depth Test\uff09\uff1a \u5bf9\u7247\u5143\u8fdb\u884c\u6df1\u5ea6\u6d4b\u8bd5\uff0c\u4e22\u5f03\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u7247\u5143\u3002 \u7eb9\u7406\uff08Texture\uff09\uff1a \u7528\u4e8e\u7ed8\u5236\u6a21\u578b\u7684\u50cf\u7d20\u7684\u56fe\u50cf\u3002 \u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\uff08Mipmap\uff09\uff1a \u5bf9\u4e8e\u8ddd\u79bb\u5c4f\u5e55\u8f83\u8fdc\u7684\u50cf\u7d20\uff0c\u5c06\u4f7f\u7528\u7ec6\u8282\u8f83\u4f4e\u7684\u7eb9\u7406\u8fdb\u884c\u7ed8\u5236\u3002\u591a\u7ea7\u6e10\u8fdc\u7eb9\u7406\u53ef\u89e3\u51b3\u7531\u4e8e\u8ddd\u79bb\u95ee\u9898\u800c\u5bfc\u81f4\u7684\u8fdc\u5904\u50cf\u7d20\u95ea\u70c1\u95ee\u9898\u3002 \u7eb9\u7406\u5750\u6807\uff08Texture Coordinate\uff09\uff1a \u901a\u5e38\u53ea\u6709\u4e24\u4e2a\u5206\u91cf\uff0c\u7528\u4e8e\u6307\u5b9a\u7247\u5143\u5728\u7eb9\u7406\u4e0a\u7684\u4f4d\u7f6e\u3002 \u7eb9\u7406\u5355\u5143\uff08Texture Unit\uff09\uff1a \u7528\u4e8e\u50a8\u5b58\u7eb9\u7406\u7684\u7a7a\u95f4\u3002 \u53d6\u6837\u5668\uff08Sampler\uff09\uff1a Uniform\u7c7b\u578b\u4e4b\u4e00\uff0c\u7528\u4e8e\u6307\u5b9a\u88ab\u53d6\u6837\u7684\u7eb9\u7406\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a OpenGL\u529f\u80fd\u4e4b\u4e00\uff0c\u7528\u4e8e\u6e32\u67d3\u900f\u660e\u6216\u534a\u900f\u660e\u7269\u4f53\uff0c\u5c06\u5176\u7247\u5143\u4e0e\u5176\u540e\u7247\u5143\u7684\u989c\u8272\u8fdb\u884c\u6df7\u5408\u3002 \u6444\u50cf\u673a\uff08Camera\uff09\uff1a \u7528\u4e8e\u81ea\u7531\u89c2\u5bdf\u4e09\u7ef4\u4e16\u754c\u7684\u529f\u80fd\u3002OpenGL\u4e2d\u4e0d\u5b58\u5728\u6b64\u529f\u80fd\u548c\u6982\u5ff5\uff0c\u79fb\u52a8\u6444\u50cf\u673a\u5b9e\u9645\u4e0a\u662f\u5c06\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u5411\u76f8\u53cd\u7684\u65b9\u5411\u79fb\u52a8\u3002 \u7ffb\u6eda\uff08Roll\uff09\uff1a \u6b27\u62c9\u89d2\uff08Euler Angles\uff09\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7eb5\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u4fef\u4ef0\uff08Pitch\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u6a2a\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u504f\u822a\uff08Yaw\uff09\uff1a \u6b27\u62c9\u89d2\u4e4b\u4e00\uff0c\u7528\u4e8e\u63cf\u8ff0\u7269\u4f53\u6cbf\u5176\u7ad6\u8f74\u65cb\u8f6c\u7684\u89d2\u5ea6\u3002 \u89c2\u5bdf\u77e9\u9635\uff08View Matrix\uff09\uff1a \u7528\u4e8e\u5c06\u9876\u70b9\u5411\u6444\u50cf\u673a\u6240\u5728\u4f4d\u7f6e\u7684\u76f8\u53cd\u65b9\u5411\u548c\u65cb\u8f6c\u72b6\u6001\u53d8\u6362\u7684\u77e9\u9635\u3002 \u6a21\u578b\u89c2\u5bdf\u77e9\u9635\uff08Model View Matrix\uff09\uff1a \u662f\u89c2\u5bdf\u77e9\u9635\u4e0e\u4e16\u754c\u77e9\u9635\u7ec4\u5408\uff0c\u53ef\u5c06\u6a21\u578b\u7a7a\u95f4\u7684\u5750\u6807\u53d8\u6362\u5230\u6444\u50cf\u673a\u7a7a\u95f4\u4e2d\u7684\u5750\u6807\uff0c\u7528\u4e8e\u7b80\u5316\u8ba1\u7b97\u3002 OBJ\uff08.obj\uff09\uff1a Wavefront Technologies\u5f00\u53d1\u7684\u4e00\u79cd\u51e0\u4f55\u5b9a\u4e49\u5f00\u653e\u6587\u4ef6\u683c\u5f0f\uff0c\u73b0\u5df2\u88ab\u5e7f\u6cdb\u91c7\u7528\u3002 \u6cd5\u7ebf\uff08Normal\uff09\uff1a \u4e00\u4e2a\u5e73\u9762\u7684\u6cd5\u7ebf\u662f\u4e00\u4e2a\u5782\u76f4\u4e8e\u8be5\u5e73\u9762\u7684\u5411\u91cf\u3002 \u5f52\u4e00\u5316\uff08Normalize\uff09\uff1a \u4f7f\u5411\u91cf\u7684\u957f\u5ea6\uff08\u6216\u6a21\u957f\uff09\u4e3a1\u3002 \u9876\u70b9\u6cd5\u7ebf\uff08Vertex Normal\uff09\uff1a \u4e00\u4e2a\u9876\u70b9\u7684\u6cd5\u7ebf\u662f\u5176\u53c2\u4e0e\u7ec4\u6210\u7684\u4e09\u89d2\u5f62\u7684\u9762\u7684\u6cd5\u7ebf\u7684\u7ec4\u5408\uff0c\u5176\u957f\u5ea6\u4ecd\u4e3a1\u3002 \u70b9\u5149\u6e90\uff08Point Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u7684\u662f\u4e00\u4e2a\u7531\u70b9\u5411\u7a7a\u95f4\u5404\u4e2a\u65b9\u5411\u5747\u5300\u53d1\u5c04\u7684\u5149\u6e90\u3002 \u805a\u5149\u6e90\uff08Spot Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4ece\u7a7a\u95f4\u4e2d\u7684\u70b9\u53d1\u5c04\u7684\u5149\u6e90\uff0c\u4f46\u4e0d\u662f\u5411\u6240\u6709\u65b9\u5411\u4e0a\u53d1\u5c04\uff0c\u800c\u662f\u9650\u5b9a\u5728\u4e86\u4e00\u4e2a\u9525\u5f62\u65b9\u5411\u4e0a\u3002 \u5e73\u884c\u5149\uff08Directional Light\uff09\uff1a \u8fd9\u79cd\u5149\u6a21\u62df\u4e86\u592a\u9633\u5149\uff0c3D\u573a\u666f\u4e2d\u7684\u6240\u6709\u7269\u4f53\u90fd\u4f1a\u53d7\u5230\u6765\u81ea\u7279\u5b9a\u65b9\u5411\u7684\u5e73\u884c\u5149\u7ebf\u7684\u7167\u5c04\u3002\u65e0\u8bba\u7269\u4f53\u662f\u8fd1\u6291\u6216\u662f\u8fdc\uff0c\u5149\u7ebf\u603b\u662f\u4ee5\u76f8\u540c\u89d2\u5ea6\u7167\u5c04\u5728\u7269\u4f53\u4e0a\u3002 \u73af\u5883\u5149\uff08Ambient Light\uff09\uff1a \u8fd9\u79cd\u5149\u6765\u81ea\u7a7a\u95f4\u7684\u4efb\u4f55\u65b9\u5411\uff0c\u5e76\u4ee5\u76f8\u540c\u7684\u5f3a\u5ea6\u7167\u4eae\u6240\u6709\u7269\u4f53\u3002 \u6f2b\u53cd\u5c04\uff08Diffuse Reflectance\uff09\uff1a \u8003\u8651\u5230\u9762\u5411\u5149\u6e90\u7684\u8868\u9762\u66f4\u4eae\u3002 \u955c\u9762\u53cd\u5c04\uff08Specular Reflectance\uff09\uff1a \u6a21\u62df\u5149\u7ebf\u5728\u629b\u5149\u6216\u91d1\u5c5e\u8868\u9762\u4e0a\u7684\u53cd\u5c04\u3002 HUD\uff08Heads-Up Display\uff09\uff1a \u5e73\u89c6\u663e\u793a\u5668\uff0c\u5e38\u7528\u4e8e\u98de\u673a\u4e0a\u5c06\u91cd\u8981\u4fe1\u606f\u6295\u5f71\u4e8e\u6321\u98ce\u73bb\u7483\u6216\u5934\u76d4\u4e0a\uff0c\u4ee5\u4fbf\u98de\u884c\u5458\u540c\u65f6\u67e5\u770b\u524d\u65b9\u60c5\u51b5\u548c\u98de\u884c\u4fe1\u606f\u3002\u73b0\u7528\u4e8e\u6e38\u620f\u4e2d\uff0c\u5c06\u6e38\u620f\u4e2d\u7684\u91cd\u8981\u4fe1\u606f\u663e\u793a\u4e8e\u4e09\u7ef4\u573a\u666f\u524d\u3002 \u6b63\u4ea4\u6295\u5f71\uff08Orthographic Projection\uff0cOrthogonal Projection\uff09\uff1a \u4e5f\u79f0\u4e3a\u6b63\u6295\u5f71\uff0c\u6b63\u5c04\u6295\u5f71\u3002\u6307\u4e0d\u53d7\u8fd1\u5927\u8fdc\u5c0f\u5f71\u54cd\u7684\u5c06\u4e09\u7ef4\u7269\u4f53\u6295\u5f71\u5230\u4e8c\u7ef4\u5e73\u9762\u4e0a\u7684\u6295\u5f71\u65b9\u5f0f\u3002 \u6df7\u5408\uff08Blend\uff09\uff1a \u5b9e\u73b03D\u6e32\u67d3\u4e2d\u7269\u4f53\u900f\u660e\u7684\u4e00\u4e2a\u529f\u80fd\uff0c\u542f\u7528\u900f\u660e\u5c06\u5141\u8bb8\u4f7f\u7528Alpha\u5206\u91cf\u6df7\u5408\u989c\u8272\u3002 \u5929\u7a7a\u76d2\uff08Sky Box\uff09\uff1a \u5305\u88f93D\u573a\u666f\u5e76\u4ee5\u6444\u50cf\u673a\u4f4d\u7f6e\u4e3a\u539f\u70b9\u7684\u5de8\u5927\u7acb\u65b9\u4f53\uff0c\u5c06\u7eb9\u7406\u6e32\u67d3\u5728\u8be5\u7acb\u65b9\u4f53\u5185\u90e8\uff0c\u4ee5\u4ea7\u751f\u4e00\u79cd\u770b\u5230\u6ca1\u6709\u8fb9\u7f18\u7684\u573a\u666f\u7684\u9519\u89c9\u3002 \u7acb\u65b9\u4f53\u6620\u5c04\uff08Cube Mapping\uff09\uff1a \u5c06\u7eb9\u7406\u5206\u4e3a\u516d\u4e2a\u90e8\u5206\uff0c\u5c06\u5404\u90e8\u5206\u6620\u5c04\u5230\u7acb\u65b9\u4f53\u4e0a\u3002 \u9762\u5254\u9664\uff08Face Culling\uff09\uff1a \u5254\u9664\u65e0\u7528\u6216\u770b\u4e0d\u5230\u7684\u9762\uff0c\u4ee5\u63d0\u5347\u6027\u80fd\u7684OpenGL\u529f\u80fd\u3002","title":"\u672f\u8bed\u8868"}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 9c5abb7..0f8724e 100755
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -1,158 +1,3 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
-    <url>
-         <loc>None</loc>
-         <lastmod>2021-09-27</lastmod>
-         <changefreq>daily</changefreq>
-    </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 9fe04fec283c5894d2dcc538b2a5fbc9491a65dd..d66837b436eb12adb898c360b1523ce2f318e1f9 100755
GIT binary patch
literal 127
zcmV-_0D%7=iwFn+nU-b(|8r?{Wo=<_E_iKh04<9_3V<LG0Pnp*_MTg}inLoVs0V~e
z38~>)_WXo8&M?ytk3HC}0~zlG)Vu<wo${-3n}B&5%LWEn^jA1YN0wtp0`?fs4l$*~
h$wY0JleiBXlG-y6{t_$RLZ0!v<qJi$pFwQ^003u#Hq`(C

literal 217
zcmb2|=HQ5m4NPSEUz}NznwwalSCN~;@b>y%zGejh_78WLE4*piwZ*I>`nca)W`QMM
zixL{IeS6z2pIOtwSI&KW{^`GI5r5^Xz671i&eobUnMXNwN$!?R?V8>5E-SCAJT!0J
zcdZ2$IW?`j1&#?Xy=)@5zFF$Xi_TKrubaBX{kKm@TXMw4apN=A?Cm12*FF)?7Fk@p
zy<WhMXWK*9uqT;e%Z@7c<=o8kDLb^~)w?Ur=1$+`-O5jDU6SXtc+kMihfMr$)OY`r
P@LB(MzTVpj{0s~Lm8oWD