
## Adding Files

To add files, simply browse the desired folder and click the button `Import...` in the Assets Browser toolbar.
A dialog will open to select the files to add. Once selected and validated, all the selected assets will be copied to
the currently browsed folder.

Each time a file has been added, its thumbnail will be computed if its type is recognized and supported.

![AddingFiles](/img/extensions/Editor/AddingFiles/adding-files.gif)

## Supported meshes formats
* .babylon
* .fbx
* .gltf
* .glb
* .obj
* .stl

## Supported texture formats
* .png
* .jpg
* .bmp
* .basis
* .dds (cube texture)
* .env (cube texture)

## Supported sound formats
* .mp3
* .ogg
* .wav





## Adding Meshes To The Scene

To add a new mesh (or hierarchy of meshes, depends on the nature of the source file) to the scene, simply
drag and drop the source file on the preview panel. The mesh(es) will be added where the source file has been
dropped.

When adding meshes to the scene, all skeletons, geometries and materials will be loaded and instantiated in the scene.

Because materials are packed into source files, for each material that doesn't already exist in the assets will be
created as `.material` file(s).

![AddingMeshes](/img/extensions/Editor/AddingMeshes/adding-meshes.gif)

## Updating Existing Meshes

Meshes can be updated even if they were created using an old version of their source files.
Once a source mesh file (.babylon, .fbx, etc.) has been updated in the assets, `right-click the mesh file` and
select `"Update References"`

Meshes can be updated by:
* Choosing which component to update (geometry, material, skeleton)
* Forcing to update all components (geometry(ies), material(s) and skeleton(s))

![UpdatingReferences](/img/extensions/Editor/AddingMeshes/updating-references.gif)

## Examining Meshes

At any time, `double-clicking a mesh file` in the assets browser creates a new window (or tabbed window on MacOS)
to examine a mesh(es) source file.

Once loaded, the Babylon.JS Inspector appears to inspector the mesh(es) available in the source file.
You can refer to [the inspector documentation](https://doc.babylonjs.com/toolsAndResources/tools/inspector]) to understand how to use the Babylon.JS Inspector.

![ExaminingAsset](/img/extensions/Editor/AddingMeshes/examining-asset.gif)

## Cleaning assets
In order to let the user managing its own assets, the Editor will never remove useless assets until it is asked by the user. That means, when updating meshes, that old materials and texture will still be availalbe in the assets panel. Don't forget to clear unused assets (for example unused materials then unused textures) to keep the project clear if you are sure that old materials, for example, are not needed anymore.



## Introduction

Starting from Babylon.JS Editor v4.1.0, assets management has been improved by introducing a new panel: **"Assets Browser"**.
All assets are now shared across projects and are now browsable like we can do in other famous 3D editors.

The assets browser can browse two main assets types:
* Sources folder `/src` which contains all the project's TypeScript, Json, etc. files
* Assets folder `/assets` which contains all the scenes assets (textures, meshes, materials, sounds, etc.).

To identify assets quickly, distinct colors are applied on titles:
* `Yellow` represents meshes assets
* `Green` represents materials assets
* `Blue` represents particle systems assets

## Using Assets Browser

The Assets Browser panel is composed of 2 resizable panes:
* left pane: the directory tree, like we have in any file explorer
* right pane: the content of the selected directory (files & sub-directories)

Each time a directory is selected in the tree (left pane), the right pane is updated to show its content.

![SelectDirectoryTree](/img/extensions/Editor/AssetsIntroduction/select-directory-tree.gif)

The right pane also contains a stack of opened folders. This stack is used to know the currently browsed path
and can be clicked to quickly access a specified directory available in the stack.

![UseStack](/img/extensions/Editor/AssetsIntroduction/use-stack.gif)

## Using favorites

On top of the directory tree, 2 favorites shortcuts are available:
* `All Materials`: shows the list of all available materials assets that have been instantiated (used) in the current scene.
* `All Textures`: as for materials, shows the list of all available textures assets that have been instantiated (used) in the current scene.

![UsingFavorites](/img/extensions/Editor/AssetsIntroduction/using-favorites.gif)

## Creating A New Folder

New folders can be created at any time. Just right-click empty space in the panel, select `New Directory...` and
type the name of the folder to created. Once accepted, a new folder will be created in the currently browsed folder.

![CreatingFolder](/img/extensions/Editor/AssetsIntroduction/creating-folder.gif)

## Selecting Files

As any other file browser, multiple files can be selected using either:
- `CTRL or Command + Click` to select multiple individual files
- `Shift + Click` to select a range of files

**Note: rectangle selection is not yet available and is still WIP.**

![SelectingFiles](/img/extensions/Editor/AssetsIntroduction/selecting-files.gif)

## Moving Files

Once file(s) have been selected, they can be drag'n'dropped in any folder. Once moved, all links to the moved files
are updated automatically by the editor (materials, textures, sounds, etc.).

Until the project is saved, the editor creates a temporary file named `links.json` located at `${workspacePath}/projects/links.json`.
This json file stores the last moving actions for each moved file in order to, if the project has been closed before saving, retrieve the real path for linked assets (like materials textures).

![MovingFiles](/img/extensions/Editor/AssetsIntroduction/moving-files.gif)

Drag'n'drop is also supported in the tree

![MovingFiles](/img/extensions/Editor/AssetsIntroduction/moving-files-tree.gif)


Adding files

Adding Files

Supported meshes formats

Supported texture formats

Supported sound formats