3D 파동 표면

Surface 3 D

입력 이미지가 물결치는 3D 표면 위에 펼쳐지고 원근과 조명으로 깊이감이 생깁니다.

다른 이름: Surface3D3D wave surface

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

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

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

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

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

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

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: '320px' }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/photo.jpg" />
      <Surface3D />
    </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: 'Surface3D',
    }
  ]
}, { disableTelemetry: true })

속성(props) · Surface3D

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

이름값기본값범위·선택지설명(원문)
amplitudeAmplitude0.30 – 1 (step 0.01)Wave height
waveTypeWave Typefractalfractal · sine · ridgeWave pattern type
frequencyFrequency1.50.1 – 5 (step 0.1)Wave frequency
octavesOctaves21 – 5 (step 1)Detail octaves
seedSeed00 – 100 (step 1)Random seed offset
speedSpeed0.50 – 3 (step 0.1)Animation speed
tiltTilt350 – 85 (step 1)Camera tilt in degrees
rollRoll0-45 – 45 (step 1)Camera roll in degrees
heightHeight0-1 – 2 (step 0.01)Camera height
zoomZoom10.3 – 3 (step 0.01)Camera zoom
nearCutoffNear Cutoff00 – 1 (step 0.01)Near fade distance
farCutoffFar Cutoff10 – 1 (step 0.01)Far fade distance
edgePinningEdge Pinning00 – 1 (step 0.01)Smoothly flatten the surface at its edges (orthogonal to edge mode)
edgesEdgesmirrorstretch · transparent · mirror · wrapHow to handle content beyond the surface bounds
lightingLighting300 – 100 (step 1)Intensity of lighting and shading
glossinessGlossiness00 – 100 (step 1)Surface glossiness
highlightsHighlights150 – 100 (step 1)Specular highlight intensity
lightXLight X0.4-1 – 1 (step 0.01)Light direction X
lightYLight Y-0.6-1 – 1 (step 0.01)Light direction Y
lightZLight Z0.7-1 – 1 (step 0.01)Light direction Z
lightColorLight Color#ffffff—Light color
cursorIntensityCursor Ripples10 – 2 (step 0.01)Strength of cursor ripples
cursorSpeedRipple Speed0.50 – 1 (step 0.01)Speed of cursor ripple propagation

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

천이나 깃발을 바람에 펼친 것처럼, 평면 이미지가 굴곡진 표면 위에 놓이고 파도가 지나가며 입체적으로 움직입니다.

`amplitude`를 올리면 표면의 파고가 커지고 `waveType`으로 파동 모양을 고릅니다. `frequency`는 물결의 촘촘함, `tilt`는 카메라가 표면을 내려다보는 정도, `lighting`은 표면 음영의 세기를 조절합니다.

입력 이미지나 패턴 레이어 위에 적용하세요. `Form3D`가 리본·구체 같은 형태를 강조한다면 이 효과는 파동 표면의 흐름을 강조합니다. `edges`와 `nearCutoff`·`farCutoff`에서 경계를 다듬고, 글자가 표면을 따라 흔들리므로 긴 문구는 피하세요.

언제 쓰나

천·깃발처럼 흔들리는 그래픽, 물결 배너, 입체 배경에 적합합니다. 작은 본문이나 표처럼 평평하고 정확한 배치가 필요한 콘텐츠에는 피하세요.

페이지로 열기 ↗