SCENEFILTER

Detailed Description

Scene filter flags for the loading, saving and merging of documents.

See also
LoadDocument() SaveDocument() MergeDocument()

Enumerations

enum class  SCENEFILTER {
  NONE ,
  OBJECTS ,
  MATERIALS ,
  DIALOGSALLOWED ,
  PROGRESSALLOWED ,
  MERGESCENE ,
  NONEWMARKERS ,
  SAVECACHES ,
  NOUNDO ,
  SAVE_BINARYCACHE ,
  IDENTIFY_ONLY ,
  ONLY_RENDERDATA ,
  IGNOREMISSINGPLUGINSINNONACTIVERENDERDATA ,
  IGNOREXREFS ,
  DONTCORRECTOUTPUTFORMAT ,
  SKIPOLDERTHANV13 ,
  PREVIEWONLY ,
  DOCUMENTPREFSONLY ,
  DOCUMENTINFOGUIALLOWED ,
  SUPPRESSOPTIONSDIALOG
}
 

Functions

enum SCENEFILTER MAXON_ENUM_FLAGS (SCENEFILTER)
 

Enumeration Type Documentation

◆ SCENEFILTER

enum SCENEFILTER
strong
Enumerator
NONE 

None.

OBJECTS 

Load/save objects.

MATERIALS 

Load/save materials.

DIALOGSALLOWED 

Flag to inform a plugin that a dialog can be displayed. If this flag is not set then no dialogs must be opened.

PROGRESSALLOWED 

Flag to inform a plugin that a progress bar can be displayed. The progress bar can be set by calling StatusSetBar().

MERGESCENE 

Flag to inform a plugin that this is a merge operation, i.e. the document that is inserted to is an existing scene.

NONEWMARKERS 

Objects loaded from disk will keep their markers (GeMarker).

SAVECACHES 

For Cineware export only. Caches of objects will also be written (only supported by Cinema 4D format). This is the same as the global option "Save Polygon Objects for Melange Exchange".

NOUNDO 

Use together with SCENEFILTER::MERGESCENE to avoid that undos are created for the merge operation.

SAVE_BINARYCACHE 

Save the binary compiled shaders with the scene (only for Cinema 4D format).

IDENTIFY_ONLY 

Do not load the whole document, identify it only.

ONLY_RENDERDATA 

Only load render settings. If this flag is set, SCENEFILTER::OBJECTS, SCENEFILTER::MATERIALS, SCENEFILTER::PREVIEWONLY and SCENEFILTER::DOCUMENTPREFSONLY are ignored.

IGNOREMISSINGPLUGINSINNONACTIVERENDERDATA 

Ignore all missing plugins which are part of a non-active render data.

IGNOREXREFS 

Avoid that included X-Refs will be loaded.

Since
R16.038
DONTCORRECTOUTPUTFORMAT 

Do not change unknown output formats in render settings.

SKIPOLDERTHANV13 

Private. (used in Cineware SDK only).

PREVIEWONLY 

Only load the document preview image. If this flag is set, SCENEFILTER::OBJECTS, SCENEFILTER::MATERIALS and SCENEFILTER::DOCUMENTPREFSONLY are ignored. Does not work with SCENEFILTER::ONLY_RENDERDATA.

DOCUMENTPREFSONLY 

Only load document preferences. If this flag is set, SCENEFILTER::OBJECTS and SCENEFILTER::MATERIALS are ignored. Does not work with SCENEFILTER::PREVIEWONLY nor SCENEFILTER::ONLY_RENDERDATA.

DOCUMENTINFOGUIALLOWED 

Custom dialogs can be displayed while reacting to DocumentInfo Messages.

SUPPRESSOPTIONSDIALOG 

Suppress the options dialog (if DIALOGSALLOWED was specified), so that errors would show up.

Function Documentation

◆ MAXON_ENUM_FLAGS()

enum SCENEFILTER MAXON_ENUM_FLAGS ( SCENEFILTER  )