Copyright © 2008-2019 MultiMedia Soft

TagsEditor.WMA_PictureFrameAddFromBitmap method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds to the WMA 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.WMA_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 WMA_PictureFrameAddFromBitmap (

hBitmap as IntPtr,

strDescription as String,

nPictureType as enumId3v2PictureType,

nFormat as enumGraphicFormats,

nFormatParameter as Int32

) as enumErrorCodes


 

[C#]

public string WMA_PictureFrameAddFromBitmap (

IntPtr hBitmap,

string strDescription,

enumId3v2PictureType nPictureType,

enumGraphicFormats nFormat,

Int32 nFormatParameter

);


 

[C++]

public: string WMA_PictureFrameAddFromBitmap (

IntPtr hBitmap,

string strDescription,

enumId3v2PictureType nPictureType,

enumGraphicFormats nFormat,

Int32 nFormatParameter

);


 

Parameter

Description

 

 

hBitmap

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

strDescription

String representing the picture description

nPictureType

Value representing the type of picture.

Supported values are the following:

Mnemonic Value

Value

Meaning

ID3V2_PICTURE_OTHER

0

Other

ID3V2_PICTURE_ICON_32x32

1

32x32 icon

ID3V2_PICTURE_ICON_OTHER

2

Other icon

ID3V2_PICTURE_COVER_FRONT

3

Front cover

ID3V2_PICTURE_COVER_BACK

4

Back cover

ID3V2_PICTURE_LEAFLET_PAGE

5

Leaflet page

ID3V2_PICTURE_MEDIA

6

Media (e.g. label side of CD)

ID3V2_PICTURE_LEAD_ARTIST_PERFORMER_SOLOIST

7

Lead artist/lead performer/soloist

ID3V2_PICTURE_ARTIST_PERFORMER

8

Artist/performer

ID3V2_PICTURE_CONDUCTOR

9

Conductor

ID3V2_PICTURE_BAND_ORCHESTRA

10

Band/Orchestra

ID3V2_PICTURE_COMPOSER

11

Composer

ID3V2_PICTURE_LYRICIST_TEXT_WRITER

12

Lyricist/text writer

ID3V2_PICTURE_RECORDING_LOCATION

13

Recording Location

ID3V2_PICTURE_DURING_RECORDING

14

During recording

ID3V2_PICTURE_DURING_PERFORMANCE

15

During performance

ID3V2_PICTURE_MOVIE_VIDEO_SCREEN_CAPTURE

16

Movie/video screen capture

ID3V2_PICTURE_BRIGHT_FISH

17

A bright coloured fish

ID3V2_PICTURE_ILLUSTRATION

18

Illustration

ID3V2_PICTURE_BAND_ARTIST_LOGO

19

Band/artist logotype

ID3V2_PICTURE_PUBLISHER_STUDIO_LOGO

20

Publisher/Studio logotype

nFormat

Graphic format used to save the bitmap inside the WMA 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.