Copyright © 2008-2018 MultiMedia Soft

TagsEditor.MP4_PictureFrameAddFromBitmap method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds to the MP4 tag a new picture frame taken from a memory bitmap.

The modification only happens in memory and not directly into the original sound file: in order to store modifications inside the file you need to call the TagsEditor.MP4_SaveChanges method.

 

For further details about methods related to tags editing refer to the TagsEditorMan class.

For details about the editing of tags see the How to edit tag info in sound files tutorial.

 

 

Syntax

 

[Visual Basic]

Public Function MP4_PictureFrameAddFromBitmap (

hBitmap as IntPtr,

nFormat as enumGraphicFormats,

nFormatParameter as Int32

) as enumErrorCodes


 

[C#]

public string MP4_PictureFrameAddFromBitmap (

IntPtr hBitmap,

enumGraphicFormats nFormat,

Int32 nFormatParameter

);


 

[C++]

public: string MP4_PictureFrameAddFromBitmap (

IntPtr hBitmap,

enumGraphicFormats nFormat,

Int32 nFormatParameter

);


 

Parameter

Description

 

 

hBitmap

Handle of the memory bitmap (HBITMAP) to use in order to create the picture frame.

nFormat

Graphic format used to save the bitmap inside the MP4 tag.

Supported values are the following:

Mnemonic value

Value

Meaning

GRAPHIC_FORMAT_BMP

0

BMP format

GRAPHIC_FORMAT_JPEG

1

JPEG format

GRAPHIC_FORMAT_PNG

2

PNG format

GRAPHIC_FORMAT_GIF

3

GIF format

GRAPHIC_FORMAT_TIFF

4

TIFF format

nFormatParameter

Eventual parameter required by the chosen graphic format.

 

When the nFormat parameter is set to GRAPHIC_FORMAT_JPEG, this parameter defines the JPEG compression factor whose range can be in the range from 0 (Maximum compression, Lower Quality) to 100 (Minimum compression, Higher Quality).

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.