aframe-svg-extruder

A-Frame component to extrude your SVG's files and use in WebVR scenes like magic 🌟

3d · aframe · aframe-component · aframe-vr · aframevr
入门
GitHub在线演示
Stars:72
License:MIT License
更新:2025/8/30

README

aframe-svg-extruder

A-Frame component to extrude your SVG's files and use in WebVR scenes like magic 🌟

Demo

https://luiguild.github.io/aframe-svg-extruder/

Usage

Development

git clone https://github.com/luiguild/aframe-svg-extruder.git
npm install
npm start

Install

Using NPM
npm i aframe-svg-extruder
Using yarn
yarn add aframe-svg-extruder
Use via CDN
<script src="https://unpkg.com/[email protected]/dist/index.min.js"></script>
Add on your a-scene
<a-scene>
  <a-asset-item id="mozilla" src="https://raw.githubusercontent.com/luiguild/aframe-svg-extruder/master/example/svg/mozilla-letters.svg"></a-asset-item>

  <!-- If you prefer use entities -->
  <a-entity
    svg="src: #mozilla; proportionalScale: 2; extrude: 1; zFactor: 0.001;"
    position="0 2 -5">
  </a-entity>

  <!-- If you prefer use a web component -->
  <a-svg
    src="#mozilla"
    proportional-scale="2"
    extrude="0.5"
    z-factor="0"
    position="0 1.3 -5"
  >
  </a-svg>
</a-scene>

API

This is the list of the available parameters.

ParameterTypeDefaultRequiredDescription
srcStringnulltruePass the path of your SVG file
proportionalScaleNumber1falseProportionally how many times you want that your file grow
extrudeNumber0.1falseThe depth of the extrusion
zFactorNumber0.005falseThis will help you control the z-fighting on complex SVG layouts
overrideColorStringnullfalseSet an hex (eg: #000000) color if you want override the original colors of file

* kekab-case params for webcomponent | camelCase for entity

Help and contact

PRs are appreciated, issues are welcomed. For any question, ping @luiguild at aframevr in Slack, Twitter or Telegram.