![]() |
![]() |
![]() |
![]() |
Media copy and ripping information
#include <mme/types.h> typedef struct { uint64_t dstmsid; const char *dstfolder; const char *dstfilename; uint64_t encodeformatid; } mme_mediacopier_info_t;
The structure mme_mediacopier_info_t carries information about a media copy or ripping operation. It includes at least the members described in the table below.
Member | Type | Description |
---|---|---|
dstmsid | uint64_t | The destination msid. Set to 0 to use the default msid. |
dstfolder | char | A pointer to the destination folder for the tracks to be ripped. See dstfolder below. |
dstfilename | char | A pointer to the string used to create the destination file name for the tracks to be ripped. |
encodeformatid | uint64_t | The encode format ID (encodeformatid) from the encodeformats table that you want to use for encoding. See encodeformatid below. |
The value for dstfolder must be in the format /foldername/ (beginning and ending with a “/” character). For example, if in your mediastores table the destination msid has a mountpath of /media/drive, and the dstfolder name is “/ripped/”, then the track is ripped to /media/drive/ripped/.
Set dstfolder to NULL to use the default destination folder, and dstfilename NULL to use the destination file name defined in the MME configuration file mme.conf. You can specify nested sub-directories, as required.
The MME defines templates strings you can use to name the ripping destination folders and files. These template strings are described in the table below.
String | Value | Description |
---|---|---|
$TITLE | MME_MEDIACOPIER_TEMPLATE_TITLE | song title |
$ARTIST | MME_MEDIACOPIER_TEMPLATE_ARTIST | artist name |
$ALBUM | MME_MEDIACOPIER_TEMPLATE_ALBUM | album name |
$GENRE | MME_MEDIACOPIER_TEMPLATE_GENRE | song genre |
$COMPOSER | MME_MEDIACOPIER_TEMPLATE_COMPOSER | song composer |
$TRACK | MME_MEDIACOPIER_TEMPLATE_TRACK | track number |
$0TRACK | MME_MEDIACOPIER_TEMPLATE_0TRACK | track number with leading zeros: 01, 02, etc. |
$DISC | MME_MEDIACOPIER_TEMPLATE_DISC | disc number |
$0DISC | MME_MEDIACOPIER_TEMPLATE_0DISC | disc number with leading zeros: 01, 02, etc. |
$YEAR | MME_MEDIACOPIER_TEMPLATE_YEAR | release year |
$SRCFID | MME_MEDIACOPIER_TEMPLATE_SRCFID | source file ID |
$SRCMSID | MME_MEDIACOPIER_TEMPLATE_SRCMSID | source mediastore ID |
$TIMESTAMP | MME_MEDIACOPIER_TEMPLATE_TIMESTAMP | time when file is copied |
$DATESTAMP | MME_MEDIACOPIER_TEMPLATE_DATESTAMP | date when file is copied |
$MSIDENTIFIER | MME_MEDIACOPIER_TEMPLATE_MSIDENTIFIER | source mediastore ID |
$NO_PRESERVE_PATH | COPY_NO_PATH_PRESERVE | force the path to be discarded |
$PRESERVE_PATH | COPY_PATH_PRESERVE | force the path to be preserved |
$PRESERVE_PATH_AFTER | COPY_PATH_PRESERVE_AFTER | modify the source path when it is appended to the destination folder |
The standard default values for encodeformatid are:
Set encodeformatid to 0 to use the default encode format.
QNX Multimedia
![]() |
![]() |
![]() |
![]() |