Skip to content

webgl_materials_texture_manualmipmap

对应 three.js 示例地址

仅需关注 init 函数的内容,其他部分都是示例小程序所使用的描述配置。

js
import * as THREE from "three";

/** @type {import("@minisheeep/mp-three-examples").OfficialExampleInfo} */
const exampleInfo = {
  name: "webgl_materials_texture_manualmipmap",
  useLoaders: [],
  info: [
    [
      {
        tag: "a",
        link: "https://threejs.org",
        content: "three.js"
      },
      {
        tag: "text",
        content: "- texture manual mipmapping example"
      }
    ],
    [
      {
        tag: "text",
        content: "painting by"
      },
      {
        tag: "a",
        link: "http://en.wikipedia.org/wiki/Basket_of_Fruit_%28Caravaggio%29",
        content: "Caravaggio"
      }
    ]
  ],
  infoPanel: {
    left: [
      ["Floor", "g_(128x128)"],
      ["mag:", "Linear"],
      ["min:", "LinearMipmapLinear"],
      ["Painting", "g_(748x600)"],
      ["mag:", "Linear"],
      ["min:", "Linear"]
    ],
    right: [
      ["Floor", "g_"],
      ["mag:", "Nearest"],
      ["min:", "NearestMipmapNearestFilter"],
      ["Painting", "g_"],
      ["mag:", "Nearest"],
      ["min:", "Nearest"]
    ]
  },
  init: ({ window, canvas: rendererCanvas, GUI, Stats, needToDispose, useFrame }) => {
    const SCREEN_WIDTH = window.innerWidth;
    const SCREEN_HEIGHT = window.innerHeight;
    let camera, scene1, scene2, renderer;
    let mouseX = 0, mouseY = 0;
    const windowHalfX = window.innerWidth / 2;
    const windowHalfY = window.innerHeight / 2;
    init();
    function init() {
      camera = new THREE.PerspectiveCamera(35, SCREEN_WIDTH / SCREEN_HEIGHT, 1, 5e3);
      camera.position.z = 1500;
      scene1 = new THREE.Scene();
      scene1.background = new THREE.Color(0);
      scene1.fog = new THREE.Fog(0, 1500, 4e3);
      scene2 = new THREE.Scene();
      scene2.background = new THREE.Color(0);
      scene2.fog = new THREE.Fog(0, 1500, 4e3);
      function mipmap(size, color) {
        const imageCanvas = document.createElement("canvas");
        const context = imageCanvas.getContext("2d");
        imageCanvas.width = imageCanvas.height = size;
        context.fillStyle = "#444";
        context.fillRect(0, 0, size, size);
        context.fillStyle = color;
        context.fillRect(0, 0, size / 2, size / 2);
        context.fillRect(size / 2, size / 2, size / 2, size / 2);
        return imageCanvas;
      }
      const canvas = mipmap(128, "#f00");
      const textureCanvas1 = new THREE.CanvasTexture(canvas);
      textureCanvas1.mipmaps[0] = canvas;
      textureCanvas1.mipmaps[1] = mipmap(64, "#0f0");
      textureCanvas1.mipmaps[2] = mipmap(32, "#00f");
      textureCanvas1.mipmaps[3] = mipmap(16, "#400");
      textureCanvas1.mipmaps[4] = mipmap(8, "#040");
      textureCanvas1.mipmaps[5] = mipmap(4, "#004");
      textureCanvas1.mipmaps[6] = mipmap(2, "#044");
      textureCanvas1.mipmaps[7] = mipmap(1, "#404");
      textureCanvas1.colorSpace = THREE.SRGBColorSpace;
      textureCanvas1.repeat.set(1e3, 1e3);
      textureCanvas1.wrapS = THREE.RepeatWrapping;
      textureCanvas1.wrapT = THREE.RepeatWrapping;
      const textureCanvas2 = textureCanvas1.clone();
      textureCanvas2.magFilter = THREE.NearestFilter;
      textureCanvas2.minFilter = THREE.NearestMipmapNearestFilter;
      const materialCanvas1 = new THREE.MeshBasicMaterial({ map: textureCanvas1 });
      const materialCanvas2 = new THREE.MeshBasicMaterial({ color: 16764074, map: textureCanvas2 });
      const geometry = new THREE.PlaneGeometry(100, 100);
      const meshCanvas1 = new THREE.Mesh(geometry, materialCanvas1);
      meshCanvas1.rotation.x = -Math.PI / 2;
      meshCanvas1.scale.set(1e3, 1e3, 1e3);
      const meshCanvas2 = new THREE.Mesh(geometry, materialCanvas2);
      meshCanvas2.rotation.x = -Math.PI / 2;
      meshCanvas2.scale.set(1e3, 1e3, 1e3);
      const callbackPainting = function() {
        const image = texturePainting1.image;
        texturePainting2.image = image;
        texturePainting2.needsUpdate = true;
        scene1.add(meshCanvas1);
        scene2.add(meshCanvas2);
        const geometry2 = new THREE.PlaneGeometry(100, 100);
        const mesh1 = new THREE.Mesh(geometry2, materialPainting1);
        const mesh2 = new THREE.Mesh(geometry2, materialPainting2);
        addPainting(scene1, mesh1);
        addPainting(scene2, mesh2);
        function addPainting(zscene, zmesh) {
          zmesh.scale.x = image.width / 100;
          zmesh.scale.y = image.height / 100;
          zscene.add(zmesh);
          const meshFrame = new THREE.Mesh(
            geometry2,
            new THREE.MeshBasicMaterial({ color: 0 })
          );
          meshFrame.position.z = -10;
          meshFrame.scale.x = 1.1 * image.width / 100;
          meshFrame.scale.y = 1.1 * image.height / 100;
          zscene.add(meshFrame);
          const meshShadow = new THREE.Mesh(
            geometry2,
            new THREE.MeshBasicMaterial({ color: 0, opacity: 0.75, transparent: true })
          );
          meshShadow.position.y = -1.1 * image.height / 2;
          meshShadow.position.z = -1.1 * image.height / 2;
          meshShadow.rotation.x = -Math.PI / 2;
          meshShadow.scale.x = 1.1 * image.width / 100;
          meshShadow.scale.y = 1.1 * image.height / 100;
          zscene.add(meshShadow);
          const floorHeight = -1.117 * image.height / 2;
          meshCanvas1.position.y = meshCanvas2.position.y = floorHeight;
        }
      };
      const texturePainting1 = new THREE.TextureLoader().load(
        "textures/758px-Canestra_di_frutta_(Caravaggio).jpg",
        callbackPainting
      );
      const texturePainting2 = new THREE.Texture();
      const materialPainting1 = new THREE.MeshBasicMaterial({
        color: 16777215,
        map: texturePainting1
      });
      const materialPainting2 = new THREE.MeshBasicMaterial({
        color: 16764074,
        map: texturePainting2
      });
      texturePainting1.colorSpace = THREE.SRGBColorSpace;
      texturePainting2.colorSpace = THREE.SRGBColorSpace;
      texturePainting2.minFilter = texturePainting2.magFilter = THREE.NearestFilter;
      texturePainting1.minFilter = texturePainting1.magFilter = THREE.LinearFilter;
      texturePainting1.mapping = THREE.UVMapping;
      renderer = new THREE.WebGLRenderer({ antialias: true, canvas: rendererCanvas });
      renderer.setPixelRatio(window.devicePixelRatio);
      renderer.setSize(SCREEN_WIDTH, SCREEN_HEIGHT);
      renderer.setAnimationLoop(animate);
      renderer.autoClear = false;
      rendererCanvas.addEventListener("pointermove", onDocumentMouseMove);
      needToDispose(renderer, scene1, scene2);
    }
    function onDocumentMouseMove(event) {
      mouseX = event.clientX - windowHalfX;
      mouseY = event.clientY - windowHalfY;
    }
    function animate() {
      camera.position.x += (mouseX - camera.position.x) * 0.05;
      camera.position.y += (-(mouseY - 200) - camera.position.y) * 0.05;
      camera.lookAt(scene1.position);
      renderer.clear();
      renderer.setScissorTest(true);
      renderer.setScissor(0, 0, SCREEN_WIDTH / 2 - 2, SCREEN_HEIGHT);
      renderer.render(scene1, camera);
      renderer.setScissor(SCREEN_WIDTH / 2, 0, SCREEN_WIDTH / 2 - 2, SCREEN_HEIGHT);
      renderer.render(scene2, camera);
      renderer.setScissorTest(false);
    }
  }
};
export {
  exampleInfo as default
};
ts
import { Loader, TypedArray } from 'three';
/**
 * 官网示例的多端使用封装把版本
 * */
export interface OfficialExampleInfo extends MiniProgramMeta {
  /*** 示例名称(保持和官网一致)*/
  name: string;
  /** main */
  init: (context: LoadContext) => void;
}

export interface LoadContext {
  //为了减少官方代码的改动,实际上等同于 canvas
  window: EventTarget & { innerWidth: number; innerHeight: number; devicePixelRatio: number };
  /** HTMLCanvasElement */
  canvas: any;
  /** https://www.npmjs.com/package/lil-gui */
  GUI: any;
  /**
   * https://www.npmjs.com/package/stats.js
   * 也可以使用其他受支持的版本
   * */
  Stats: any;
  /** 收集需要 dispose 的对象(官方示例没有处理这部分)*/
  needToDispose: (...objs: any[]) => void | ((fromFn: () => any[]) => void);

  /**基于 raq 的通用封装 */
  useFrame(animateFunc: (/** ms */ delta: number) => void): { cancel: () => void };

  /** 显示加载模态框 */
  requestLoading(text?: string): Promise<void>;

  /** 隐藏加载模态框*/
  cancelLoading(): void;

  /** 保存文件的通用封装*/
  saveFile(
    fileName: string,
    data: ArrayBuffer | TypedArray | DataView | string
  ): Promise<string | null>;

  /** 示例使用 DracoDecoder 时的资源路径 */
  DecoderPath: {
    GLTF: string;
    STANDARD: string;
  };

  /** 为资源路径拼上 CDN 前缀 */
  withCDNPrefix(path: string): string;

  /**
   * 在小程序中应使用 import { VideoTexture } from '@minisheep/three-platform-adapter/override/jsm/textures/VideoTexture.js';
   * 正常情况(web) 可直接使用 THREE.VideoTexture
   * */
  getVideoTexture(videoOptions: VideoOptions): Promise<[{ isVideoTexture: true }, video: any]>;

  /**
   * 在小程序中应使用 import { CameraTexture } from '@minisheep/three-platform-adapter/override/jsm/textures/CameraTexture.js';
   * 正常情况(web) 可参考示例 webgl_materials_video_webcam
   * */
  getCameraTexture(): { isVideoTexture: true };

  /** 用于动态修改 info 中的占位符*/
  bindInfoText(template: `$${string}$`, initValue?: string): { value: string };

  /** 分屏控件对应的事件回调 */
  onSlideStart(handle: () => void): void;
  /** 分屏控件对应的事件回调 */
  onSlideEnd(handle: () => void): void;
  /** 分屏控件对应的事件回调 */
  onSlideChange(handle: (offset: number, boxSize: number) => void): void;
}

export type VideoOptions = {
  src: string;
  /** 相当于 HTMLVideoElement 的 naturalWidth (小程序中获取不到)*/
  width: number;
  /** 相当于 HTMLVideoElement 的 naturalHeight (小程序中获取不到)*/
  height: number;
  loop?: boolean;
  autoplay?: boolean;
  muted?: boolean;
};

/** 示例小程序中使用的一些配置 */
export interface MiniProgramMeta {
  /** 用于统计加载相关信息 */
  useLoaders: Loader[];
  /** 通用 info */
  info: TagItem[][];
  /** 特殊 info */
  infoPanel?: {
    left?: [string, string][];
    right?: [string, string][];
  };
  /** 分屏控件配置 */
  needSlider?: {
    /** 方向 */
    direction?: 'horizontal' | 'vertical';
    /** 初始偏移 0-100 */
    initPosition?: number;
  };
  /** 操作摇杆控件 */
  needArrowControls?: boolean;
  /** 默认需要的画布类型 */
  canvasType?: '2d' | 'webgl' | 'webgl2';
  /** 为保持效果一致所需要的画布样式 */
  canvasStyle?: {
    bgColor?: string;
    width?: number | string;
    height?: number | string;
  };
  /** 部分示例需要在加载前进行一些提示 */
  initAfterConfirm?: {
    /**
     * 提示类型
     * @default 'default'
     * */
    type?: 'warning' | 'default';
    text: string[];
  };
}

export interface BaseTag<T extends string> {
  tag: T;
  content: string;
}

export interface ATag extends BaseTag<'a'> {
  link: string;
}

export type TextTag = BaseTag<'text'>;

export type TagItem = TextTag | ATag;