Merge pull request #402 from limzykenneth/main

Add missing translation

Author: limzykenneth

src/content/reference/zh-Hans/p5/texture.mdx

@@ -0,0 +1,178 @@
+---
+title: texture
+module: 3D
+submodule: 材质
+file: src/webgl/material.js
+description: >
+  <p>设置将用于形状的纹理。</p>
+
+  <p>纹理就像是包裹在形状周围的皮肤。<code>texture()</code> 函数可用于内置的形状，例如 <a href="/reference/p5/square">square()</a> 和 <a href="/reference/p5/sphere">sphere()</a>，以及使用 <a href="/reference/p5/buildGeometry">buildGeometry()</a> 等函数创建的自定义形状。要对使用 <a href="/reference/p5/beginShape">beginShape()</a> 创建的几何体进行纹理化，必须为每个 <a href="/reference/p5/vertex">vertex()</a> 调用传递 uv 坐标。</p>
+
+  <p>参数 <code>tex</code> 是要应用的纹理。<code>texture()</code> 可以使用包括图像、视频和离屏渲染器等来源，例如 <a href="/reference/p5/p5.Graphics">p5.Graphics</a> 和 <a href="/reference/p5/p5.Framebuffer">p5.Framebuffer</a> 对象。</p>
+
+  <p>要对使用 <a href="/reference/p5/beginShape">beginShape()</a> 创建的几何体进行纹理化，你需要在 <a href="/reference/p5/vertex">vertex()</a> 中指定 uv 坐标。</p>
+
+  <p>注意：<code>texture()</code> 只能在 WebGL 模式下使用。</p>
+line: 861
+isConstructor: false
+itemtype: method
+example:
+  - |-
+
+    <div>
+    <code>
+    let img;
+
+    // 加载一张图片并创建一个 p5.Image 对象。
+    function preload() {
+      img = loadImage('/assets/laDefense.jpg');
+    }
+
+    function setup() {
+      createCanvas(100, 100, WEBGL);
+
+      describe('A spinning cube with an image of a ceiling on each face.');
+    }
+
+    function draw() {
+      background(0);
+
+      // 绕 x 轴、y 轴和 z 轴旋转。
+      rotateZ(frameCount * 0.01);
+      rotateX(frameCount * 0.01);
+      rotateY(frameCount * 0.01);
+
+      // 将图片应用为纹理。
+      texture(img);
+
+      // 绘制立方体。
+      box(50);
+    }
+    </code>
+    </div>
+
+    <div>
+    <code>
+    let pg;
+
+    function setup() {
+      createCanvas(100, 100, WEBGL);
+
+      // 创建一个 p5.Graphics 对象。
+      pg = createGraphics(100, 100);
+
+      // 在 p5.Graphics 对象上绘制一个圆形。
+      pg.background(200);
+      pg.circle(50, 50, 30);
+
+      describe('A spinning cube with circle at the center of each face.');
+    }
+
+    function draw() {
+      background(0);
+
+      //  绕 x 轴、y 轴和 z 轴旋转。
+      rotateZ(frameCount * 0.01);
+      rotateX(frameCount * 0.01);
+      rotateY(frameCount * 0.01);
+
+      // 将 p5.Graphics 对象应用为纹理。
+      texture(pg);
+
+      // 绘制立方体。
+      box(50);
+    }
+    </code>
+    </div>
+
+    <div>
+    <code>
+    let vid;
+
+    // 加载一个视频并创建一个 p5.MediaElement 对象。
+    function preload() {
+      vid = createVideo('/assets/fingers.mov');
+    }
+
+    function setup() {
+      createCanvas(100, 100, WEBGL);
+
+      // 隐藏视频。
+      vid.hide();
+
+      // 设置视频循环播放。
+      vid.loop();
+
+      describe('A rectangle with video as texture');
+    }
+
+    function draw() {
+      background(0);
+
+      // 绕 y 轴旋转。
+      rotateY(frameCount * 0.01);
+
+      // 将视频应用为纹理。
+      texture(vid);
+
+      // 绘制矩形。
+      rect(-40, -40, 80, 80);
+    }
+    </code>
+    </div>
+
+    <div>
+    <code>
+    let vid;
+
+    // 加载一个视频并创建一个 p5.MediaElement 对象。
+    function preload() {
+      vid = createVideo('/assets/fingers.mov');
+    }
+
+    function setup() {
+      createCanvas(100, 100, WEBGL);
+
+      // 隐藏视频。
+      vid.hide();
+
+      // 设置视频循环播放。
+      vid.loop();
+
+      describe('A rectangle with video as texture');
+    }
+
+    function draw() {
+      background(0);
+
+      // 绕 y 轴旋转。
+      rotateY(frameCount * 0.01);
+
+      // 设置纹理模式。
+      textureMode(NORMAL);
+
+      // 将视频应用为纹理。
+      texture(vid);
+
+      // 使用 uv 坐标绘制自定义形状。
+      beginShape();
+      vertex(-40, -40, 0, 0);
+      vertex(40, -40, 1, 0);
+      vertex(40, 40, 1, 1);
+      vertex(-40, 40, 0, 1);
+      endShape();
+    }
+    </code>
+    </div>
+class: p5
+params:
+  - name: tex
+    description: |
+      <p>将媒体用作纹理。</p>
+    type: >-
+      p5.Image|p5.MediaElement|p5.Graphics|p5.Texture|p5.Framebuffer|p5.FramebufferTexture
+chainable: true
+---
+
+
+# texture