#include <c4d_filterdata.h>
A data class for creating bitmap loader plugins.
Use RegisterBitmapLoaderPlugin() to register a bitmap loader plugin.
|
virtual Bool | Identify (const Filename &name, UChar *probe, Int32 size)=0 |
|
virtual IMAGERESULT | Load (const Filename &name, BaseBitmap *bm, Int32 frame)=0 |
|
virtual Int32 | GetSaver (void) |
|
virtual Bool | GetInformation (const Filename &name, Int32 *frames, Float *fps) |
|
virtual IMAGERESULT | LoadAnimated (BitmapLoaderAnimatedData *bd, BITMAPLOADERACTION action, BaseBitmap *bm, Int32 frame) |
|
virtual IMAGERESULT | ExtractSound (BitmapLoaderAnimatedData *bd, BaseSound *snd) |
|
virtual IMAGERESULT | HasSound (BitmapLoaderAnimatedData *bd) |
|
| BaseData () |
|
virtual | ~BaseData (void) |
|
void | Destructor (void) |
|
◆ Identify()
Called to identify a file type as one that can be loaded using the bitmap loader.
If possible, the file should not be identified through its suffix, but through the probe data.
- Parameters
-
[in] | name | The filename of the file. |
[in] | probe | The start of a small chunk of data from the start of the file to identify the file type. Cinema 4D owns the pointed array. |
[in] | size | The size of the probe chunk, usually 1024 bytes. |
- Returns
- true if the bitmap loader recognizes the file type, otherwise false.
◆ Load()
Called to load an image file into a bitmap.
- Parameters
-
[in] | name | The name of the file to load. |
[in] | bm | The bitmap to load the image file into. Cinema 4D owns the pointed bitmap. |
[in] | frame | The frame number for formats containing multiple images in a file such as QuickTime or AVI. |
- Returns
- The result of loading the file: IMAGERESULT
◆ GetSaver()
virtual Int32 GetSaver |
( |
void |
| ) |
|
|
virtual |
Called to get the plugin ID of the corresponding BitmapSaverData, if there is one.
- Returns
- The plugin ID of the corresponding bitmap saver, or nullptr if there is none.
◆ GetInformation()
Called to get information on the loading of movies.
- Parameters
-
[in] | name | The name of the file to check. |
[out] | frames | Set this to the number of frames. |
[out] | fps | Set this to the number of frames-per-second. |
- Returns
- true if the information could be retrieved, otherwise false.
◆ LoadAnimated()
◆ ExtractSound()
Called to extract the sound of animated bitmaps.
- Parameters
-
[in] | bd | The bitmap loader animated data. Cinema 4D owns the pointed data. |
[in] | snd | The extracted sound. Cinema 4D owns the pointed sound. |
- Returns
- The result of extracting the sound: IMAGERESULT
◆ HasSound()
Called by the Picture Viewer to determine whether a movie has sound or not.
- Parameters
-
[in] | bd | The bitmap loader animated data. Cinema 4D owns the pointed data. |
- Returns
- The result: IMAGERESULT