원근 변형

Perspective

평면 이미지를 3D 공간에서 기울여 가까운 쪽과 먼 쪽의 크기가 달라지는 원근감을 만듭니다.

다른 이름: PerspectivePerspective warp

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

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

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

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

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

<Shader style="width: 100%; height: 320px" disableTelemetry>
  <ImageTexture
    objectFit="cover"
    url="/samples/poster.jpg" />
  <Perspective
    pan={{
      type: "auto-animate",
      mode: "ping-pong",
      outputMin: -30,
      outputMax: 30,
      speed: 0.4
    }}
    tilt={15} />
</Shader>
Solid
// WebGPU 를 지원하는 브라우저에서만 그립니다.
// /samples/… 는 이 사이트의 샘플 파일입니다. 내 프로젝트의 이미지·영상 경로로 바꾸세요.
import { Shader, ImageTexture, Perspective } from 'shaders/solid'

export default function ShaderEffect() {
  return (
    <Shader style={{ width: '100%', height: '320px' }} disableTelemetry>
      <ImageTexture
        objectFit="cover"
        url="/samples/poster.jpg" />
      <Perspective
        pan={{
          type: "auto-animate",
          mode: "ping-pong",
          outputMin: -30,
          outputMax: 30,
          speed: 0.4
        }}
        tilt={15} />
    </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/poster.jpg',
      },
    },
    {
      type: 'Perspective',
      props: {
        pan: {
          type: 'auto-animate',
          mode: 'ping-pong',
          outputMin: -30,
          outputMax: 30,
          speed: 0.4
        },
        tilt: 15,
      },
    }
  ]
}, { disableTelemetry: true })

속성(props) · Perspective

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

이름값기본값범위·선택지설명(원문)
centerCenter
x0.5y0.5
{"x":0.5,"y":0.5}x, y: 0 – 1Center point of rotation
panPan데모에서 자동으로 오가는 값 — 움직이면 그 값에 고정됩니다0-90 – 90 (step 0.1)Horizontal rotation (left/right)
tiltTilt0-90 – 90 (step 0.1)Vertical rotation (up/down)
fovFOV6030 – 120 (step 1)Field of view - controls perspective intensity
zoomZoom10.5 – 3 (step 0.1)Zoom in to fill the frame after rotation
offsetOffset
x0.5y0.5
{"x":0.5,"y":0.5}x, y: 0 – 1Shift the result in X/Y
edgesEdgestransparentstretch · transparent · mirror · wrapHow to handle edges

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

사진을 책상 위에서 들어 비스듬히 바라보는 것처럼, 평면 입력이 기울고 멀어지는 쪽이 작아져 원근감이 생깁니다.

`pan`은 좌우 기울기, `tilt`은 위아래 기울기를 정합니다. `fov`를 올리면 원근감이 강해지고 `zoom`은 회전 뒤 화면을 채우도록 확대합니다. `center`는 회전의 기준점을 옮깁니다.

입력 이미지 위에 놓아야 보입니다. `CornerPin`을 더하면 각 모서리 위치를 따로 맞출 수 있습니다. 기울기가 커질수록 텍스트도 함께 찌그러지고 가장자리에 빈 영역이 생길 수 있으니 `edges`를 확인하세요.

언제 쓰나

카드·포스터의 기울어진 목업, 원근감 있는 히어로 이미지, 짧은 패널 전환에 적합합니다. 작은 본문을 읽히게 하거나 평면 정렬을 유지해야 할 때는 피하세요.

페이지로 열기 ↗