3D 형태 매핑

Form 3 D

입력 이미지가 조명이 있는 3D 형태의 표면을 따라 감기며 입체 오브젝트처럼 보입니다.

다른 이름: Form3D3D shape wrap

WebGPU 를 지원하는 브라우저에서 움직입니다

이 기기에서는 데모를 그리지 못해 정지 화면을 보여 줍니다

React
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
import { Shader, Form3D, ImageTexture } from 'shaders/react'

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: 320 }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/photo.jpg" />
      <Form3D
        zoom={90} />
    </Shader>
  )
}
Vue
<!-- WebGPU 를 지원하는 브라우저에서만 그립니다. -->
<!-- /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요. -->
<script setup lang="ts">
import { Shader, Form3D, ImageTexture } from 'shaders/vue'
</script>

<template>
  <Shader style="width: 100%; height: 320px" :disable-telemetry="true">
    <ImageTexture
      object-fit="cover"
      url="/samples/photo.jpg"/>
    <Form3D
      :zoom="90"/>
  </Shader>
</template>
Svelte
<!-- WebGPU 를 지원하는 브라우저에서만 그립니다. -->
<!-- /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요. -->
<script>
  import { Shader, Form3D, ImageTexture } from 'shaders/svelte'
</script>

<Shader style="width: 100%; height: 320px" disableTelemetry>
  <ImageTexture
    objectFit="cover"
    url="/samples/photo.jpg" />
  <Form3D
    zoom={90} />
</Shader>
Solid
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
import { Shader, Form3D, ImageTexture } from 'shaders/solid'

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: '320px' }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/photo.jpg" />
      <Form3D
        zoom={90} />
    </Shader>
  )
}
JavaScript
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
// <canvas id="canvas" style="width:100%;height:320px"></canvas> 가 페이지에 있어야 한다
import { createShader } from 'shaders/js'

const shader = await createShader(document.getElementById("canvas"), {
  components: [
    {
      type: 'ImageTexture',
      props: {
        objectFit: 'cover',
        url: '/samples/photo.jpg',
      },
    },
    {
      type: 'Form3D',
      props: {
        zoom: 90,
      },
    }
  ]
}, { disableTelemetry: true })

속성(props) · Form3D

값을 바꾸면 위 데모와 코드 탭에 바로 반영됩니다. 설명은 라이브러리 레지스트리의 영어 원문(MIT)입니다.

이름값기본값범위·선택지설명(원문)
shape3dShape코드에서 지정{"type":"ribbon","angle":0,"twist":50,"width":40,"thickne…—3D shape and its parameters
shape3dTypeshape3dType코드에서 지정ribbon—Active shape type — triggers recompile when shape is switched
centerCenter
x0.5y0.5
{"x":0.5,"y":0.5}x, y: 0 – 1Center position of the shape on screen
zoomZoom5010 – 200 (step 1)Camera zoom level
glossinessGlossiness500 – 200 (step 1)Specular highlight intensity and sharpness
lightingLighting500 – 200 (step 1)Overall intensity of lighting effects
uvModeUV Edgesstretchstretch · mirror · wrapHow to handle UV coordinates at shape boundaries
speedSpeed1-10 – 10 (step 0.1)Animation speed — scales all spin rates

모든 컴포넌트 공통: blendMode · opacity · visible · maskSource/maskType · boundingBox · id

평면 포스터를 리본이나 도넛 같은 입체 표면에 감아 놓은 것처럼, 입력 이미지가 형태의 굴곡을 따라 보입니다.

`shape3d`에서 형태와 세부 값을 정하고 `center`로 화면 안의 위치를 옮깁니다. `zoom`은 카메라 확대 정도를, `glossiness`는 반사의 선명도와 강도를, `lighting`은 전체 조명의 세기를 조절합니다.

입력 이미지가 있어야 표면에 무늬가 보입니다. `uvMode`는 경계에서 이미지 좌표를 늘일지·반사할지·이어 붙일지 정합니다. 작은 글자는 곡면에서 찌그러질 수 있으니 짧은 로고나 패턴을 우선 사용하고, `Surface3D`와 달리 3D 형태의 윤곽을 강조할 때 고르세요.

언제 쓰나

회전하는 로고, 표면에 감긴 패턴, 입체 오브젝트형 히어로 이미지에 좋습니다. 긴 문장이나 평면 비율을 유지해야 하는 콘텐츠에는 피하세요.

페이지로 열기 ↗