mme_mediacopier_info_t

Media copy and ripping information

Synopsis:

#include <mme/types.h>

typedef struct {
   uint64_t     dstmsid;
   const char   *dstfolder;
   const char   *dstfilename;
   uint64_t     encodeformatid;
} mme_mediacopier_info_t;

Description:

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.

dstfolder and dstfilename

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.

Destination folder dstfolder and file name dstfilename template strings

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

encodeformatid

The standard default values for encodeformatid are:

Set encodeformatid to 0 to use the default encode format.

Classification:

QNX Multimedia

See also:

mme_mediacopier_add()