Difference between revisions of "Assets"

Latest revision as of 20:12, 28 April 2020

The 'Asset Palette' is a key element of using PanelForge. It provides the mechanism to import and manage external data files to be copied or referenced in your Panels/Project.

Assets in PanelForge is simply the term used for data files on disk that are not the PanelForge Panel or Project files. This use of external asset files allows the increased flexibility, as the asset files can be reused, updated, distributed and organised separately from the main PanelForge Project/Panel Files.

Types of assets that are currently supported by PanelForge that are managed this 'Asset Palette' are the following:

Geometry Models : To be imported into the Stage view to construct a 3D scene.
Bitmap Images : Can be imported into the Canvas view or used as textures on 3D stage objects.
Audio Files : Import into the Panel Timeline view.
Directories : For organising of asset items. Can also be imported into the Stage view where the hierarchy will be replicated as group objects.
Panels : Can be imported into the Panel Thumbnails/Timeline.

Three types of items are shown in this Palettes main asset Tree view:

Assets : Data file of various types that can be imported or referenced in PanelForge.
Asset Libraries : PanelForge can access assets from multiple libraries at one time. These can be the 'Local', 'Primitive' or multiple 'External' libraries. More details below.
Asset Groups : A Directory/Folder on the Disk's file system to organise assets and other groups.

The different Asset Library types provide the flexibility to tailor your work, from a simple short PanelForge Project to a large collaborative multi episode/season collection of Projects.

Primitive : This special library type provides a collection of built in primitive and example assets that can be used in your project. These assets are supplied as part of the PanelForge 'Program Files' or 'Application Bundle'.
Local : Another special library that reflects the contents of the 'Assets' directory contained in the current PanelForge Project. Keeping assets in this library allows for easily be disturbed with the Project and Panel files.
External : This library type is the most powerful and common used with PanelForge. These are directories that can be located any place on disk. The directory can be moved and relinked. For more information see the Asset Reference Manager where external libraries can be created and managed.

Tips

When renaming or moving assets that are referenced in a project the location will not be automatically updated in the Panel/Project. Use the Asset Reference Manager can be used to relink the file locations if required.

When using an asset library from an outside source, do not change the folder names or where assets are within this, as it may break links when your project is sent back to the source client/studio.

Palette Toolbar

Toolbar containing buttons and other items to change the asset tree view or selected assets in the asset tree view.

Refresh

Refreshes items in the Asset Tree View. This will recalculate asset previews and information. New files will be added, renamed or removed based on changes in the computers file system.

If directories have been changed then the Asset Tree View will need to be ‘rebuilt’, this can be accessed in the ‘More Tools’ popup tool button in this tool bar.

Library Manager…

Opens the ‘Asset Library Manager’ dialog window. This window provides an interface to add/remove or modify assets libraries available in the current project.

Any changes made in the ‘Asset Library Manager’ will be updated in this palette’s Asset Tree View.

Add Group

Adds a directory/folder in the library or group selected in the Asset Tree View to group files. Groups can contain other groups to create complex hierarchies.

Rename Asset

Rename the selected asset in the Asset Tree View.

Delete Asset

Delete the selected asset in the Asset Tree View.

Progress Bar

The progress bar indicator is shown in the toolbar during regeneration of asset preview and information data. The Asset Palette can be used during this time, but the preview/info in Asset Information Bar may be unavailable.

More Tools

Popup menu button. Provides additional less frequently used functionality of the Asset Palette.

Group Asset Libraries : The the contents of the asset libraries are shown as in separate groups (default). When deselected the contents of the asset libraries will be shown mixed into a single tree.
Rebuild List : All the asset tree view contents will be fully rebuilt. This includes changes to the file system directory structure that do not update during the 'Refresh' toolbar button item.

Show in Windows Explorer/Finder

Show the currently selected asset item, directory or library in the Operating Systems's 'Windows Explorer'/'Finder' view.

Add In Place

If an existing item is selected in the 'Stage' view this tool button is displayed, the currently selected asset(s) will be added in the same location (transform) as the selected item in the view.

Add

Add the selected asset(s), or when supported directory hierarchy of assets into the current Panel/Project.

Asset Tree View

The main view showing the contents of the currently available asset libraries. The items are displayed in a tree view that reflects the directory structure in the file system on disk.

See above for more information on the type of assets and other items that are shown in this area.

Selecting Asset Files

Items can be selected with a single mouse click. Multiple items can be selected using the 'Shift' and 'Ctrl' modifier keys.

Drag & Drop Assets

Drag and Drop is a key concept when using the Asset Tree View. It can be used to organise items in the view but also quickly import and export items form asset libraries. The Following are the currently compatible source and destinations of the drag/drop.

Import

Interface items that can be dragged into the Asset library tree to create an Asset:

Canvas Layer -> Image File : 'Canvas Layer' Palette'.
Panel -> Panel File : 'Panel Thumbnail' and 'Panel Timeline' Palette'.

Export

Assets in the asset library tree that can be dragged to interface areas:

Image File -> Canvas Viewport : Creates a new layer with the contents image file (this data is saved in the Panel's file).
Geometry File -> Stage Viewport : Adds a new model object with the contents geometry file (the data is referenced from the original asset file).
Panel File -> Panel Thumbnail/Timeline Palette : Imports and copies the Panel to the current Project, with copied Panel being added to the current Projects Panel Directory.
Audio File -> Panel Timeline Palette : Imports the audio file to timeline for playback (the data is referenced from the original asset file).

Asset Information Bar

The lower part of the Palette. The information and image preview shown here is for the currently selected item.

The information and preview will be generated in the background when a Project is opened, Asset library added or the view refreshed. The Asset Palette is still usable when this information is being generated, but may not be complete.

Preview Image

The image preview for the Asset will be automatically generated if possible otherwise the 'Generate Preview' button can be used to trigger an instant generation of an image preview. Asset types that support image previews are the following:

Bitmap Images : A thumbnail version of the image is displayed.
Geometry Models : When a preview image file accompanies the geometry file. The preview image requires to be in PNG format with the same filename as the target geometry Asset i.e 'geometryFile.png'
Panels : A thumbnail version of the panel without overlays is displayed. Overlays are not displayed in the preview.

Asset Information

Label : The name of the Asset. Sourced from Asset metadata, otherwise based on the file name.
File Name : File name of the Asset on disk.
Library : Asset Library that the Asset is contained in, i.e 'Local', 'External', 'Primitive' etc..
Type : The recognised type of asset as usable with PanelForge.
Modified : The data and time the asset was last modified.
Created : The data and time when the asset was created.
Dimensions : Different based on type of Asset, e.g. Image Assets will display the bitmap resolution.
Size : The file size on disk.
Path : Full position of file on disk's file system.

@@ Line 1: / Line 1: @@
-Assets are vital to creating a 3D board as well as speeding up workflow for 2D boards. These are imported in via an asset library. If you wish to learn about Asset Library Creation please go to  [[Asset Library Manager]], where you can also learn more about managing and linking in Asset Libraries to your project.
+The 'Asset Palette' is a key element of using PanelForge. It provides the mechanism to import and manage external data files to be copied or referenced in your Panels/Project.
+:[[File: PaletteAssets.png|thumb| 1073px |none|]]
-There are 8 types of file that can be imported into a Panelforge Project via the Assets Palette. These are:
+Assets in PanelForge is simply the term used for data files on disk that are not the PanelForge Panel or Project files. This use of external asset files allows the increased flexibility, as the asset files can be reused, updated, distributed and organised separately from the main PanelForge Project/Panel Files.
-# '''.obj files''' - Commonly exported from Maya or other 3D object creation programs.
-# '''.pfe files''' - A file type particular to Panelforge, which can be exported from Maya through ___
-# '''.png files''' - Image files with a transparent background.
-# '''.jpg files''' - Image files with a non transparent background.
-# '''.pfn files''' - Panel files that you have pulled from other projects*
-# '''.aiff files''' -  Audio files in a format developed by apple.
-# '''.mp3 files''' - Audio file, compressed audio format.
-# '''.wav files''' - Audio file in a format devloped by Windows and IBM.
+Types of assets that are currently supported by PanelForge that are managed this 'Asset Palette' are the following:
-<small>''*Please be aware if the panel has 3D assets they will need to have the corresponding Asset library attached the project to be fully functional.''</small>
+* '''Geometry Models''' : To be imported into the Stage view to construct a 3D scene.
+* '''Bitmap Images''' : Can be imported into the Canvas view or used as textures on 3D stage objects.
+* '''Audio Files''' : Import into the Panel Timeline view.
+* '''Directories''' : For organising of asset items. Can also be imported into the Stage view where the hierarchy will be replicated as group objects.
+* '''Panels''' : Can be imported into the Panel Thumbnails/Timeline.
+:[[File: AssetsIcons.png|thumb| 835px |none|]]
-----
+Three types of items are shown in this Palettes main asset Tree view:
-==Using 3D Assets==
+* '''Assets''' : Data file of various types that can be imported or referenced in PanelForge.
+* '''Asset Libraries''' : PanelForge can access assets from multiple libraries at one time. These can be the 'Local', 'Primitive' or multiple 'External' libraries. More details below.
+* '''Asset Groups''' : A Directory/Folder on the Disk's file system to organise assets and other groups.
+:[[File: AssetsTypesIcons.png|thumb| 489px |none|]]
-D assets can only be used within the stage workspace, should attempt to add them while in the canvas they add button is disabled.
+The different Asset Library types provide the flexibility to tailor your work, from a simple short PanelForge Project to a large collaborative multi episode/season collection of Projects.
-Once the stage workspace is accessed and the asset window is open. It's easy to add an asset from the default library or your own. Simply select a 3D item in the folder and choose to add. Or simply select and drag an object from the asset library to the stage viewport. This will import the asset to the stage viewport and the 3D Origin point.*
+* '''Primitive''' : This special library type provides a collection of built in primitive and example assets that can be used in your project. These assets are supplied as part of the PanelForge 'Program Files' or 'Application Bundle'.
+* '''Local''' : Another special library that reflects the contents of the 'Assets' directory contained in the current PanelForge Project. Keeping assets in this library allows for easily be disturbed with the Project and Panel files.
+* '''External''' : This library type is the most powerful and common used with PanelForge. These are directories that can be located any place on disk. The directory can be moved and relinked. For more information see the [[Asset Reference Manager]] where external libraries can be created and managed.
-[[File:PIC]]
+==Tips==
+* When renaming or moving assets that are referenced in a project the location will not be automatically updated in the Panel/Project. Use the [[Asset Reference Manager]] can be used to relink the file locations if required.
-If an object has previously been placed in a space where you want to import a new asset it can be easily done by selecting the object already within the stage viewport and then within assets selecting the object that needs to be imported in. A second selection option should appear in the top right of the palette under "Add in place" Choosing this will add the object to the same location as the initial item.
+* When using an asset library from an outside source, do not change the folder names or where assets are within this, as it may break links when your project is sent back to the source client/studio.
-For inserting multiple objects, using ctrl and selecting your chosen items will allow you to add them both through "Add" and "Add in place. This is also possible to do with the folders in your library, which will then insert the folder and its contents to the stage viewport. At this time it's not possible to drag multiple highlighted objects from the asset palette to the stage viewport.
+==Palette Toolbar==
-<small>''*Please note, if the object is exported from the initial 3D creation program not central to the origin point then the object will be imported as it has been exported as such. This means when its added to the stage viewport it may appear central to the origin point. ''</small>
+Toolbar containing buttons and other items to change the asset tree view or selected assets in the asset tree view.
+:[[File: AssetToolBar.png|thumb| 616px |none|]]
-----
+===Refresh===
-==Using 2D Assets==
+Refreshes items in the Asset Tree View. This will recalculate asset previews and information. New files will be added, renamed or removed based on changes in the computers file system.
-D assets are for use within the canvas view. Like 3D assets, it's possible to add from within the asset palette (via "+add" ) or dragging the item onto the stage. These assets will keep their naming convention, even when added multiple times to one panel.
+If directories have been changed then the Asset Tree View will need to be ‘rebuilt’, this can be accessed in the ‘More Tools’ popup tool button in this tool bar.
-----
+===Library Manager…===
-== Using Audio ===
+Opens the ‘Asset Library Manager’ dialog window. This window provides an interface to add/remove or modify assets libraries available in the current project.
-Audio is only available within Panelforge 2.0.10 onwards for use with the editing timeline. Audio can be stored as an asset then added to the audio timeline via drag and drop. Clips can be used multiple times, as well as multiple clips on the same audio timeline.
+Any changes made in the ‘Asset Library Manager’ will be updated in this palette’s Asset Tree View.
+===Add Group===
+Adds a directory/folder in the library or group selected in the Asset Tree View to group files. Groups can contain other groups to create complex hierarchies.
+===Rename Asset===
+Rename the selected asset in the Asset Tree View.
+===Delete Asset===
+Delete the selected asset in the Asset Tree View.
+===Progress Bar===
+The progress bar indicator is shown in the toolbar during regeneration of asset preview and information data. The Asset Palette can be used during this time, but the preview/info in Asset Information Bar may be unavailable.
+===More Tools===
+Popup menu button. Provides additional less frequently used functionality of the Asset Palette.
+* '''Group Asset Libraries''' : The the contents of the asset libraries are shown as in separate groups (default). When deselected the contents of the asset libraries will be shown mixed into a single tree.
+* '''Rebuild List''' : All the asset tree view contents will be fully rebuilt. This includes changes to the file system directory structure that do not update during the 'Refresh' toolbar button item.
+===Show in Windows Explorer/Finder===
+Show the currently selected asset item, directory or library in the Operating Systems's 'Windows Explorer'/'Finder' view.
+===Add In Place===
+If an existing item is selected in the 'Stage' view this tool button is displayed, the currently selected asset(s) will be added in the same location (transform) as the selected item in the view.
+===Add===
+Add the selected asset(s), or when supported directory hierarchy of assets into the current Panel/Project.
+==Asset Tree View==
+The main view showing the contents of the currently available asset libraries. The items are displayed in a tree view that reflects the directory structure in the file system on disk.
+See above for more information on the type of assets and other items that are shown in this area.
+:[[File: AssetTree.png|thumb| 600px |none|]]
+===Selecting Asset Files===
+Items can be selected with a single mouse click. Multiple items can be selected using the 'Shift' and 'Ctrl' modifier keys.
+===Drag & Drop Assets===
+Drag and Drop is a key concept when using the Asset Tree View. It can be used to organise items in the view but also quickly import and export items form asset libraries. The Following are the currently compatible source and destinations of the drag/drop.
+====Import====
+Interface items that can be dragged into the Asset library tree to create an Asset:
+* '''Canvas Layer''' -> '''Image File''' : 'Canvas Layer' Palette'.
+* '''Panel''' -> '''Panel File''' : 'Panel Thumbnail' and 'Panel Timeline' Palette'.
+====Export====
+Assets in the asset library tree that can be dragged to interface areas:
+* '''Image File''' -> '''Canvas Viewport''' : Creates a new layer with the contents image file (this data is saved in the Panel's file).
+* '''Geometry File''' -> '''Stage Viewport''' : Adds a new model object with the contents geometry file (the data is referenced from the original asset file).
+* '''Panel File''' -> '''Panel Thumbnail/Timeline Palette''' : Imports and copies the Panel to the current Project, with copied Panel being added to the current Projects Panel Directory.
+* '''Audio File''' -> '''Panel Timeline Palette''' : Imports the audio file to timeline for playback (the data is referenced from the original asset file).
+==Asset Information Bar==
+The lower part of the Palette. The information and image preview shown here is for the currently selected item.
+The information and preview will be generated in the background when a Project is opened, Asset library added or the view refreshed. The Asset Palette is still usable when this information is being generated, but may not be complete.
+:[[File: AssetInformationBar.png|thumb| 600px |none|]]
+===Preview Image===
+The image preview for the Asset will be automatically generated if possible otherwise the 'Generate Preview' button can be used to trigger an instant generation of an image preview.
+Asset types that support image previews are the following:
+* '''Bitmap Images''' : A thumbnail version of the image is displayed.
+* '''Geometry Models''' : When a preview image file accompanies the geometry file. The preview image requires to be in PNG format with the same filename as the target geometry Asset i.e 'geometryFile.png'
+* '''Panels''' : A thumbnail version of the panel without overlays is displayed. Overlays are not displayed in the preview.
+===Asset Information===
+* '''Label''' : The name of the Asset. Sourced from Asset metadata, otherwise based on the file name.
+* '''File Name''' : File name of the Asset on disk.
+* '''Library''' : Asset Library that the Asset is contained in, i.e 'Local', 'External', 'Primitive' etc..
+* '''Type''' : The recognised type of asset as usable with PanelForge.
+* '''Modified''' : The data and time the asset was last modified.
+* '''Created''' : The data and time when the asset was created.
+* '''Dimensions''' : Different based on type of Asset, e.g. Image Assets will display the bitmap resolution.
+* '''Size''' : The file size on disk.
+* '''Path''' : Full position of file on disk's file system.