비디오 텍스처

Video Texture

비디오를 캔버스의 텍스처로 재생하고, 화면에 맞추거나 반복할 수 있습니다.

다른 이름: VideoTexturevideo texturevideo layermovie texture

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

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

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

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

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

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

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

속성(props) · VideoTexture

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

이름값기본값범위·선택지설명(원문)
urlVideo코드에서 지정https://shaders.com/sample.mp4—Upload a video or provide a URL
objectFitObject Fitfillcover · contain · fill · scale-downHow the video should be sized within the viewport
loopLooptrue—Loop the video playback

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

움직이는 포스터 한 장을 캔버스에 올리는 것처럼, 비디오가 시간에 따라 바뀌는 바탕 레이어가 됩니다.

`url`은 재생할 비디오를 정하고, `objectFit`은 화면에 맞추는 방식을 정합니다. 기본값 `fill`은 화면을 채우며, `cover`는 비율을 유지하며 가장자리를 자르고 `contain`은 전체 화면을 보입니다. `loop`는 기본값 `true`로 재생이 끝난 뒤 반복합니다.

비디오도 독립적으로 그려지므로 그 위에 효과를 배치하면 영상 전체에 적용됩니다. 긴 영상은 데이터와 배터리를 더 쓰며, 자막이나 재생 제어가 필요한 콘텐츠는 접근 가능한 HTML 플레이어를 함께 제공하세요.

언제 쓰나

짧은 반복 배경 영상, 움직임이 있는 장면에 효과를 적용하는 데모, 분위기를 만드는 시각 요소에 좋습니다. 긴 본편 영상이나 자막·재생 제어가 핵심인 콘텐츠를 이 레이어 하나로 제공하는 것은 피하세요.

페이지로 열기 ↗