Open Brush Docs
  • Home
  • How to get Open Brush
  • Differences between Open Brush and Tilt Brush
  • User Guide
    • Get started with Open Brush
    • Painting with Open Brush
    • The Open Brush UI
      • Admin Panel
        • Settings Panel
        • Labs Panel
      • Tools Panel
        • Selection Options
        • Repaint Options
      • Brushes Panel
      • Extras Panel
        • Environment Panel
        • Lights Panel
        • Backdrop Panel
        • Guides Panel
        • Media Library
        • Camera Paths Panel
        • Snap Settings Panel
        • Transform Panel
        • Layers Panel
      • Experimental Panel
      • UI Differences Between Basic Mode and Advanced Mode
    • Grid and Angle Snapping
    • Repaint Tool and Jitter
    • Selection/Erase Filter
    • Lazy Input
    • Bimanual Input and Revolver
    • World Axis Unlock
    • Saving and sharing your Open Brush sketches
    • Troubleshooting issues with Open Brush
    • Check out Labs features
    • Importing Images, Videos and 3D Models
    • Experimental Mode
    • Make moving creations using audio reactive brushes
    • Using Reference Images on Oculus Quest
    • Remixing and Creative Commons
    • Accessing Autosave Files
    • The Open Brush config file
    • Exporting Open Brush sketches to other apps
      • Exporting to Unreal Engine 5
      • Exporting to Snapchat Lens Studio
      • Configuring Export
    • Plugins
      • Example Plugins
        • Example Pointer Plugins
        • Example Symmetry Plugins
        • Example Tool Plugins
        • Example Background Plugins
      • Writing Plugins
        • Getting Started
        • Tweaking existing plugins
        • Writing a Pointer Plugin
        • Writing a Symmetry Plugin
        • Writing a Tool Plugin
        • Writing a Background Plugin
        • Defining and Drawing Brush Strokes
      • Plugin API Scripting Reference
    • Open Brush Unity SDK
    • Open Brush API
      • Retrieving a preview image
      • API Commands List
    • Cameras and Exporting Video
    • Brushes
      • Brush List
      • Memory limits and brush costs
      • Experimental Brushes
      • Hiding Brushes with Brush Tags
    • Using Open Brush without a VR headset
    • Command Line Arguments
    • Tilt Brush Version 23 Release Notes
  • Get Involved!
    • How to help with Testing
  • Pre-release and Experimental Builds
    • Installing the Beta Release
    • "Experimental Mode" Builds
    • Feature: 3D Shapes Tool
    • Feature: Animation Timeline
    • Feature: Icosa Gallery Support
    • Feature: Brush Editing
    • Feature: Plugin Scripting
    • Feature: Sculpting
    • Combined Testing Build
    • Old or Completed Feature Builds
      • Feature: Polyhedra
      • Feature: Snip Tool
      • Feature: Layers
      • Insominx's (michael-g) Experimental Build
      • XR Framework Beta
      • Feature: Transform Panel and Snap Enhancements
      • Feature: Improved GLTF Importer
      • Feature: Multi-Mirror
      • Feature: New Monoscopic Mode
      • Feature: Improved Import/Export
      • Feature: Multiplayer
  • Case Studies
  • Other Resources
  • Developer Notes
    • UI Elements
    • Unity shader examples
    • Setting up CI for Open Brush using Github Actions
    • Open Brush File Format
    • Previous Github Wiki
      • Brushes
      • BuildingOpenBrush
      • BurstCompiler
      • Comparison
      • MonoscopicMode
      • PseudoCode
      • UserInterface
    • Differences between Standard and Experimental Mode
    • Open Brush AsCanvas Notes
    • Unity Versions
  • Release History
    • v2.10 Multiplayer
    • v2.9 (Maintenance)
    • v2.8 Import/Export
    • v2.7 (Maintenance)
    • v2.6 (Maintenance)
    • v2.5 (Maintenance)
    • v2.4 "Prismatic"
    • v2.2: Settings and Sketches
    • v2.1 Hotfix
    • 🚀v2.0: XR Update
    • v1.0: Happy Birthday to Us!
    • Current Beta Release Notes
  • Docs TODO
  • Contacting Us
Powered by GitBook
On this page
  • Supported File Formats
  • Interacting with Imported Objects
  • Enabling the new GLTF importer
Edit on GitHub
Export as PDF
  1. User Guide

Importing Images, Videos and 3D Models

PreviousCheck out Labs featuresNextExperimental Mode

Last updated 9 months ago

eIf you want to see an image or 3D model while you paint in Open Brush, you can add it to your scene. You can move, change, or delete reference images.

  1. Make sure you are in Advanced Mode.

  2. Below your palette, go to the Menu panel and select "More Options...".

  3. On your paint palette, swipe to the Tools panel and select More.

  4. Select Labs to open the

Click this icon to open the Media Library:

Add a reference image

  1. On a computer, copy a PNG or JPG file to Documents/Open Brush/Media Library/Images.

  2. In Open Brush, make sure you are in Advanced Mode.

  3. Go to the Menu panel (below your palette) and select "More Options..." > Labs > Local Media Library > Local Images.

  4. Switch between selecting images and models using the icons in the top left.

Add a 3D model

  1. On a computer, copy the model files to Documents/Open Brush/Media Library/Models.

  2. In Open Brush, make sure you are in Advanced Mode. On the Quest you also need to switch Experimental Mode on in the settings.

  3. Go to the Menu panel (below your palette) and select "More Options..." > Labs > Local Media Library > Local Models.

  4. Switch between selecting images and models using the icons in the top left.

  5. See "Supported Formats" below to see which file types you can use.

Supported File Formats

Type
Format
Notes

Images

PNG

JPEG

SVG

SVGs are rasterized on import.

HDR

Video

MP4

See notes below.

MKV

See notes below.

MOV

See notes below.

WEBM

See notes below. Must use VP8 codec. Supports transparency on Windows only.

3d Models

GLTF/GLB

OBJ

PC/Mac only.

FBX

PC/Mac only.

USD

PC/Mac only. Support is rather outdated and experimental

PLY

Point clouds only. Binary little-endian format.

Interacting with Imported Objects

Move an image or model: Position your controller on the image, press and hold a grip button on the side of your controller. Then, drag the image to the new location and release the grip button.

Resize an image or model: With your controllers near the image, press and hold both grip buttons. Then, move the controllers farther apart or closer together.

Pin an image or model: While holding your selection with the grip, pull the trigger to pin. Alternatively, you can use the Pin tool to pin images, models, or guides.

Remove an image or model: With your controller near the reference image, press and hold a grip button. Then, flick the controller away from your body and release the grip button.

Enabling the new GLTF importer

We have an alternative version of GLB export which can have some advantages over the importer we released in v2.4.

"Import": {
    "UseUnityGltf": true
  }

Video support varies across OS and hardware versions. See: for more detailed information.

To switch to the new importer (UnityGLTF which replaces GLTFast added in the v2.4 release) you need to edit your and add this entry after "Flags":

https://learn.microsoft.com/en-us/windows/win32/medfound/supported-media-formats-in-media-foundation#video-codecs
https://learn.microsoft.com/en-us/windows/win32/medfound/supported-media-formats-in-media-foundation#video-codecs
Open Brush config file
Labs Panel