Asset API

Table of Contents

Provide content as reusable assets served with the Cinema 4D Asset Browser.

Note
For information about the classic API Content Browser, see Content Browser [Deprecated]. For information on scene assets as reflected in the 'Save with Assets' command, see AssetData.

Overview

The Asset API is a collection of interfaces for the Asset Browser which does replace the classic API Content Browser and can import content produced for the Content Browser. The API does provide only limited access to the graphical user interface of the Asset Browser and primarily exposes the underlying data structures that are represented by the Asset Browser.

Assets come natively in the form of scenes, objects, materials, media files, presets and other types like plugins and keywords to describe other assets. The Asset API also provides means to implement custom asset interfaces to wrap around data defined by a third party developer. This data wrapped into an asset can then be loaded into a scene with the Asset Browser. Assets displayed in the Asset Browser are stored in databases whose content can either reside locally in the asset database or remotely outside of the database. Asset databases also store metadata describing their stored assets. This metadata is then accessible for the user in its mots tangible form in the Info Area of the Asset Browser, displaying for example a short note which describes a single asset.

Fig I: The Asset Browser is the graphical user interface for asset databases and therefore indirectly for the Asset API. The API does offer only limited direct control over the Asset Browser window and its functionalities and instead provides access to the underlying data structures that are represented by the Asset Browser. Shown here is the Asset Browser displaying the builtin asset databases which are shipped with Cinema 4D.

Related Topics

Articles

Asset API Databases

Access and manage asset databases that contain assets which are exposed by the Asset Browser.
Asset API Assets Create assets and presets for scene elements to be stored in an asset database.
Asset API Metadata

Read and write asset metadata to describe and organize assets and collect technical information on them.

Frameworks asset.framework Provides the functionalities of the Asset API.
cinema_hybrid.framework

Provides functionalities to bridge the classic API to the maxon API used by other frameworks.

SDK Plugins Asset API Basics Showcases basic interactions with the Asset API to modify asset databases and their content.
Custom Preset Type Implementation
Not yet documented

Development Tools Copy Asset ID to Cache Builtin feature of the Cinema 4D Asset Browser to copy the identifiers of assets. The feature is described in the Asset Browser manual in more detail.
g_console Command Line Argument for Cinema 4D which can take the values true or false and defaults to false. Enables or disables the Cinema 4D console (Windows only and only if no debugger is present).
g_consoleDebugger Command Line Argument for Cinema 4D which can take the values true or false and defaults to false. Enables or disables the Cinema 4D console (Windows only and even if a debugger is present).
g_developerNodeEditorFunctions Command Line Argument for Cinema 4D which can take the values true or false and defaults to false. Shows the versions of node asset in the Asset Browser and allows to create a specific versions of an asset by dragging it into the editor. Also makes the "Edit Description" and "Edit Port" commands available at all times.
g_generateAssetRepositoryGml Command Line Argument for Cinema 4D which can take the values true or false and defaults to false. Generates an asset repository dependency gml graph. The location will be printed to the debug console.