669 lines
16 KiB
C++
669 lines
16 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// LameXP - Audio Encoder Front-End
|
|
// Copyright (C) 2004-2013 LoRd_MuldeR <MuldeR2@GMX.de>
|
|
//
|
|
// This program is free software; you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation; either version 2 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License along
|
|
// with this program; if not, write to the Free Software Foundation, Inc.,
|
|
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
//
|
|
// http://www.gnu.org/licenses/gpl-2.0.txt
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#include "Thread_FileAnalyzer_Task.h"
|
|
|
|
#include "Global.h"
|
|
#include "LockedFile.h"
|
|
#include "Model_AudioFile.h"
|
|
|
|
#include <QDir>
|
|
#include <QFileInfo>
|
|
#include <QProcess>
|
|
#include <QDate>
|
|
#include <QTime>
|
|
#include <QDebug>
|
|
#include <QImage>
|
|
#include <QReadLocker>
|
|
#include <QWriteLocker>
|
|
#include <QThread>
|
|
|
|
#include <math.h>
|
|
#include <time.h>
|
|
#include <assert.h>
|
|
|
|
#define IS_KEY(KEY) (key.compare(KEY, Qt::CaseInsensitive) == 0)
|
|
#define IS_SEC(SEC) (key.startsWith((SEC "_"), Qt::CaseInsensitive))
|
|
#define FIRST_TOK(STR) (STR.split(" ", QString::SkipEmptyParts).first())
|
|
|
|
////////////////////////////////////////////////////////////
|
|
// Constructor
|
|
////////////////////////////////////////////////////////////
|
|
|
|
AnalyzeTask::AnalyzeTask(const int taskId, const QString &inputFile, const QString &templateFile, volatile bool *abortFlag)
|
|
:
|
|
m_taskId(taskId),
|
|
m_inputFile(inputFile),
|
|
m_templateFile(templateFile),
|
|
m_mediaInfoBin(lamexp_lookup_tool("mediainfo.exe")),
|
|
m_avs2wavBin(lamexp_lookup_tool("avs2wav.exe")),
|
|
m_abortFlag(abortFlag)
|
|
{
|
|
if(m_mediaInfoBin.isEmpty() || m_avs2wavBin.isEmpty())
|
|
{
|
|
qFatal("Invalid path to MediaInfo binary. Tool not initialized properly.");
|
|
}
|
|
}
|
|
|
|
AnalyzeTask::~AnalyzeTask(void)
|
|
{
|
|
emit taskCompleted(m_taskId);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////
|
|
// Thread Main
|
|
////////////////////////////////////////////////////////////
|
|
|
|
void AnalyzeTask::run()
|
|
{
|
|
try
|
|
{
|
|
run_ex();
|
|
}
|
|
catch(...)
|
|
{
|
|
qWarning("WARNING: Caught an in exception AnalyzeTask thread!");
|
|
}
|
|
}
|
|
|
|
void AnalyzeTask::run_ex(void)
|
|
{
|
|
int fileType = fileTypeNormal;
|
|
QString currentFile = QDir::fromNativeSeparators(m_inputFile);
|
|
qDebug("Analyzing: %s", currentFile.toUtf8().constData());
|
|
|
|
AudioFileModel file = analyzeFile(currentFile, &fileType);
|
|
|
|
if(*m_abortFlag)
|
|
{
|
|
qWarning("Operation cancelled by user!");
|
|
return;
|
|
}
|
|
|
|
switch(fileType)
|
|
{
|
|
case fileTypeDenied:
|
|
qWarning("Cannot access file for reading, skipping!");
|
|
break;
|
|
case fileTypeCDDA:
|
|
qWarning("Dummy CDDA file detected, skipping!");
|
|
break;
|
|
default:
|
|
if(file.metaInfo().title().isEmpty() || file.techInfo().containerType().isEmpty() || file.techInfo().audioType().isEmpty())
|
|
{
|
|
fileType = fileTypeUnknown;
|
|
if(!QFileInfo(currentFile).suffix().compare("cue", Qt::CaseInsensitive))
|
|
{
|
|
qWarning("Cue Sheet file detected, skipping!");
|
|
fileType = fileTypeCueSheet;
|
|
}
|
|
else if(!QFileInfo(currentFile).suffix().compare("avs", Qt::CaseInsensitive))
|
|
{
|
|
qDebug("Found a potential Avisynth script, investigating...");
|
|
if(analyzeAvisynthFile(currentFile, file))
|
|
{
|
|
fileType = fileTypeNormal;
|
|
}
|
|
else
|
|
{
|
|
qDebug("Rejected Avisynth file: %s", file.filePath().toUtf8().constData());
|
|
}
|
|
}
|
|
else
|
|
{
|
|
qDebug("Rejected file of unknown type: %s", file.filePath().toUtf8().constData());
|
|
}
|
|
}
|
|
break;
|
|
}
|
|
|
|
//Emit the file now!
|
|
emit fileAnalyzed(m_taskId, fileType, file);
|
|
}
|
|
|
|
////////////////////////////////////////////////////////////
|
|
// Privtae Functions
|
|
////////////////////////////////////////////////////////////
|
|
|
|
const AudioFileModel AnalyzeTask::analyzeFile(const QString &filePath, int *type)
|
|
{
|
|
*type = fileTypeNormal;
|
|
AudioFileModel audioFile(filePath);
|
|
|
|
QFile readTest(filePath);
|
|
if(!readTest.open(QIODevice::ReadOnly))
|
|
{
|
|
*type = fileTypeDenied;
|
|
return audioFile;
|
|
}
|
|
if(checkFile_CDDA(readTest))
|
|
{
|
|
*type = fileTypeCDDA;
|
|
return audioFile;
|
|
}
|
|
readTest.close();
|
|
|
|
bool skipNext = false;
|
|
unsigned int id_val[2] = {UINT_MAX, UINT_MAX};
|
|
cover_t coverType = coverNone;
|
|
QByteArray coverData;
|
|
|
|
QStringList params;
|
|
params << QString("--Inform=file://%1").arg(QDir::toNativeSeparators(m_templateFile));
|
|
params << QDir::toNativeSeparators(filePath);
|
|
|
|
QProcess process;
|
|
process.setProcessChannelMode(QProcess::MergedChannels);
|
|
process.setReadChannel(QProcess::StandardOutput);
|
|
process.start(m_mediaInfoBin, params);
|
|
|
|
if(!process.waitForStarted())
|
|
{
|
|
qWarning("MediaInfo process failed to create!");
|
|
qWarning("Error message: \"%s\"\n", process.errorString().toLatin1().constData());
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
return audioFile;
|
|
}
|
|
|
|
while(process.state() != QProcess::NotRunning)
|
|
{
|
|
if(*m_abortFlag)
|
|
{
|
|
process.kill();
|
|
qWarning("Process was aborted on user request!");
|
|
break;
|
|
}
|
|
|
|
if(!process.waitForReadyRead())
|
|
{
|
|
if(process.state() == QProcess::Running)
|
|
{
|
|
qWarning("MediaInfo time out. Killing process and skipping file!");
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
return audioFile;
|
|
}
|
|
}
|
|
|
|
QByteArray data;
|
|
|
|
while(process.canReadLine())
|
|
{
|
|
QString line = QString::fromUtf8(process.readLine().constData()).simplified();
|
|
if(!line.isEmpty())
|
|
{
|
|
//qDebug("Line:%s", line.toUtf8().constData());
|
|
|
|
int index = line.indexOf('=');
|
|
if(index > 0)
|
|
{
|
|
QString key = line.left(index).trimmed();
|
|
QString val = line.mid(index+1).trimmed();
|
|
if(!key.isEmpty())
|
|
{
|
|
updateInfo(audioFile, &skipNext, id_val, &coverType, &coverData, key, val);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if(audioFile.metaInfo().title().isEmpty())
|
|
{
|
|
QString baseName = QFileInfo(filePath).fileName();
|
|
int index = baseName.lastIndexOf(".");
|
|
|
|
if(index >= 0)
|
|
{
|
|
baseName = baseName.left(index);
|
|
}
|
|
|
|
baseName = baseName.replace("_", " ").simplified();
|
|
index = baseName.lastIndexOf(" - ");
|
|
|
|
if(index >= 0)
|
|
{
|
|
baseName = baseName.mid(index + 3).trimmed();
|
|
}
|
|
|
|
audioFile.metaInfo().setTitle(baseName);
|
|
}
|
|
|
|
process.waitForFinished();
|
|
if(process.state() != QProcess::NotRunning)
|
|
{
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
}
|
|
|
|
if((coverType != coverNone) && (!coverData.isEmpty()))
|
|
{
|
|
retrieveCover(audioFile, coverType, coverData);
|
|
}
|
|
|
|
if((audioFile.techInfo().audioType().compare("PCM", Qt::CaseInsensitive) == 0) && (audioFile.techInfo().audioProfile().compare("Float", Qt::CaseInsensitive) == 0))
|
|
{
|
|
if(audioFile.techInfo().audioBitdepth() == 32) audioFile.techInfo().setAudioBitdepth(AudioFileModel::BITDEPTH_IEEE_FLOAT32);
|
|
}
|
|
|
|
return audioFile;
|
|
}
|
|
|
|
void AnalyzeTask::updateInfo(AudioFileModel &audioFile, bool *skipNext, unsigned int *id_val, cover_t *coverType, QByteArray *coverData, const QString &key, const QString &value)
|
|
{
|
|
//qWarning("'%s' -> '%s'", key.toUtf8().constData(), value.toUtf8().constData());
|
|
|
|
/*New Stream*/
|
|
if(IS_KEY("Gen_ID") || IS_KEY("Aud_ID"))
|
|
{
|
|
if(value.isEmpty())
|
|
{
|
|
*skipNext = false;
|
|
}
|
|
else
|
|
{
|
|
//We ignore all ID's, except for the lowest one!
|
|
bool ok = false;
|
|
unsigned int id = value.toUInt(&ok);
|
|
if(ok)
|
|
{
|
|
if(IS_KEY("Gen_ID")) { id_val[0] = qMin(id_val[0], id); *skipNext = (id > id_val[0]); }
|
|
if(IS_KEY("Aud_ID")) { id_val[1] = qMin(id_val[1], id); *skipNext = (id > id_val[1]); }
|
|
}
|
|
else
|
|
{
|
|
*skipNext = true;
|
|
}
|
|
}
|
|
if(*skipNext)
|
|
{
|
|
qWarning("Skipping info for non-primary stream!");
|
|
}
|
|
return;
|
|
}
|
|
|
|
/*Skip or empty?*/
|
|
if((*skipNext) || value.isEmpty())
|
|
{
|
|
return;
|
|
}
|
|
|
|
/*Playlist file?*/
|
|
if(IS_KEY("Aud_Source"))
|
|
{
|
|
*skipNext = true;
|
|
audioFile.techInfo().setContainerType(QString());
|
|
audioFile.techInfo().setAudioType(QString());
|
|
qWarning("Skipping info for playlist file!");
|
|
return;
|
|
}
|
|
|
|
/*General Section*/
|
|
if(IS_SEC("Gen"))
|
|
{
|
|
if(IS_KEY("Gen_Format"))
|
|
{
|
|
audioFile.techInfo().setContainerType(value);
|
|
}
|
|
else if(IS_KEY("Gen_Format_Profile"))
|
|
{
|
|
audioFile.techInfo().setContainerProfile(value);
|
|
}
|
|
else if(IS_KEY("Gen_Title") || IS_KEY("Gen_Track"))
|
|
{
|
|
audioFile.metaInfo().setTitle(value);
|
|
}
|
|
else if(IS_KEY("Gen_Duration"))
|
|
{
|
|
unsigned int tmp = parseDuration(value);
|
|
if(tmp > 0) audioFile.techInfo().setDuration(tmp);
|
|
}
|
|
else if(IS_KEY("Gen_Artist") || IS_KEY("Gen_Performer"))
|
|
{
|
|
audioFile.metaInfo().setArtist(value);
|
|
}
|
|
else if(IS_KEY("Gen_Album"))
|
|
{
|
|
audioFile.metaInfo().setAlbum(value);
|
|
}
|
|
else if(IS_KEY("Gen_Genre"))
|
|
{
|
|
audioFile.metaInfo().setGenre(value);
|
|
}
|
|
else if(IS_KEY("Gen_Released_Date") || IS_KEY("Gen_Recorded_Date"))
|
|
{
|
|
unsigned int tmp = parseYear(value);
|
|
if(tmp > 0) audioFile.metaInfo().setYear(tmp);
|
|
}
|
|
else if(IS_KEY("Gen_Comment"))
|
|
{
|
|
audioFile.metaInfo().setComment(value);
|
|
}
|
|
else if(IS_KEY("Gen_Track/Position"))
|
|
{
|
|
bool ok = false;
|
|
unsigned int tmp = value.toUInt(&ok);
|
|
if(ok) audioFile.metaInfo().setPosition(tmp);
|
|
}
|
|
else if(IS_KEY("Gen_Cover") || IS_KEY("Gen_Cover_Type"))
|
|
{
|
|
if(*coverType == coverNone)
|
|
{
|
|
*coverType = coverJpeg;
|
|
}
|
|
}
|
|
else if(IS_KEY("Gen_Cover_Mime"))
|
|
{
|
|
QString temp = FIRST_TOK(value);
|
|
if(!temp.compare("image/jpeg", Qt::CaseInsensitive)) *coverType = coverJpeg;
|
|
else if(!temp.compare("image/png", Qt::CaseInsensitive)) *coverType = coverPng;
|
|
else if(!temp.compare("image/gif", Qt::CaseInsensitive)) *coverType = coverGif;
|
|
}
|
|
else if(IS_KEY("Gen_Cover_Data"))
|
|
{
|
|
if(!coverData->isEmpty()) coverData->clear();
|
|
coverData->append(QByteArray::fromBase64(FIRST_TOK(value).toLatin1()));
|
|
}
|
|
else
|
|
{
|
|
qWarning("Unknown key '%s' with value '%s' found!", key.toUtf8().constData(), value.toUtf8().constData());
|
|
}
|
|
return;
|
|
}
|
|
|
|
/*Audio Section*/
|
|
if(IS_SEC("Aud"))
|
|
{
|
|
|
|
if(IS_KEY("Aud_Format"))
|
|
{
|
|
audioFile.techInfo().setAudioType(value);
|
|
}
|
|
else if(IS_KEY("Aud_Format_Profile"))
|
|
{
|
|
audioFile.techInfo().setAudioProfile(value);
|
|
}
|
|
else if(IS_KEY("Aud_Format_Version"))
|
|
{
|
|
audioFile.techInfo().setAudioVersion(value);
|
|
}
|
|
else if(IS_KEY("Aud_Channel(s)"))
|
|
{
|
|
bool ok = false;
|
|
unsigned int tmp = value.toUInt(&ok);
|
|
if(ok) audioFile.techInfo().setAudioChannels(tmp);
|
|
}
|
|
else if(IS_KEY("Aud_SamplingRate"))
|
|
{
|
|
bool ok = false;
|
|
unsigned int tmp = value.toUInt(&ok);
|
|
if(ok) audioFile.techInfo().setAudioSamplerate(tmp);
|
|
}
|
|
else if(IS_KEY("Aud_BitDepth"))
|
|
{
|
|
bool ok = false;
|
|
unsigned int tmp = value.toUInt(&ok);
|
|
if(ok) audioFile.techInfo().setAudioBitdepth(tmp);
|
|
}
|
|
else if(IS_KEY("Aud_Duration"))
|
|
{
|
|
unsigned int tmp = parseDuration(value);
|
|
if(tmp > 0) audioFile.techInfo().setDuration(tmp);
|
|
}
|
|
else if(IS_KEY("Aud_BitRate"))
|
|
{
|
|
bool ok = false;
|
|
unsigned int tmp = value.toUInt(&ok);
|
|
if(ok) audioFile.techInfo().setAudioBitrate(tmp/1000);
|
|
}
|
|
else if(IS_KEY("Aud_BitRate_Mode"))
|
|
{
|
|
if(!value.compare("CBR", Qt::CaseInsensitive)) audioFile.techInfo().setAudioBitrateMode(AudioFileModel::BitrateModeConstant);
|
|
if(!value.compare("VBR", Qt::CaseInsensitive)) audioFile.techInfo().setAudioBitrateMode(AudioFileModel::BitrateModeVariable);
|
|
}
|
|
else if(IS_KEY("Aud_Encoded_Library"))
|
|
{
|
|
audioFile.techInfo().setAudioEncodeLib(value);
|
|
}
|
|
else
|
|
{
|
|
qWarning("Unknown key '%s' with value '%s' found!", key.toUtf8().constData(), value.toUtf8().constData());
|
|
}
|
|
return;
|
|
}
|
|
|
|
/*Section not recognized*/
|
|
qWarning("Unknown section: %s", key.toUtf8().constData());
|
|
}
|
|
|
|
bool AnalyzeTask::checkFile_CDDA(QFile &file)
|
|
{
|
|
file.reset();
|
|
QByteArray data = file.read(128);
|
|
|
|
int i = data.indexOf("RIFF");
|
|
int j = data.indexOf("CDDA");
|
|
int k = data.indexOf("fmt ");
|
|
|
|
return ((i >= 0) && (j >= 0) && (k >= 0) && (k > j) && (j > i));
|
|
}
|
|
|
|
void AnalyzeTask::retrieveCover(AudioFileModel &audioFile, cover_t coverType, const QByteArray &coverData)
|
|
{
|
|
qDebug("Retrieving cover!");
|
|
QString extension;
|
|
|
|
switch(coverType)
|
|
{
|
|
case coverPng:
|
|
extension = QString::fromLatin1("png");
|
|
break;
|
|
case coverGif:
|
|
extension = QString::fromLatin1("gif");
|
|
break;
|
|
default:
|
|
extension = QString::fromLatin1("jpg");
|
|
break;
|
|
}
|
|
|
|
if(!(QImage::fromData(coverData, extension.toUpper().toLatin1().constData()).isNull()))
|
|
{
|
|
QFile coverFile(QString("%1/%2.%3").arg(lamexp_temp_folder2(), lamexp_rand_str(), extension));
|
|
if(coverFile.open(QIODevice::WriteOnly))
|
|
{
|
|
coverFile.write(coverData);
|
|
coverFile.close();
|
|
audioFile.metaInfo().setCover(coverFile.fileName(), true);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
qWarning("Image data seems to be invalid :-(");
|
|
}
|
|
}
|
|
|
|
bool AnalyzeTask::analyzeAvisynthFile(const QString &filePath, AudioFileModel &info)
|
|
{
|
|
QProcess process;
|
|
process.setProcessChannelMode(QProcess::MergedChannels);
|
|
process.setReadChannel(QProcess::StandardOutput);
|
|
process.start(m_avs2wavBin, QStringList() << QDir::toNativeSeparators(filePath) << "?");
|
|
|
|
if(!process.waitForStarted())
|
|
{
|
|
qWarning("AVS2WAV process failed to create!");
|
|
qWarning("Error message: \"%s\"\n", process.errorString().toLatin1().constData());
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
return false;
|
|
}
|
|
|
|
bool bInfoHeaderFound = false;
|
|
|
|
while(process.state() != QProcess::NotRunning)
|
|
{
|
|
if(*m_abortFlag)
|
|
{
|
|
process.kill();
|
|
qWarning("Process was aborted on user request!");
|
|
break;
|
|
}
|
|
|
|
if(!process.waitForReadyRead())
|
|
{
|
|
if(process.state() == QProcess::Running)
|
|
{
|
|
qWarning("AVS2WAV time out. Killing process and skipping file!");
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
return false;
|
|
}
|
|
}
|
|
|
|
QByteArray data;
|
|
|
|
while(process.canReadLine())
|
|
{
|
|
QString line = QString::fromUtf8(process.readLine().constData()).simplified();
|
|
if(!line.isEmpty())
|
|
{
|
|
int index = line.indexOf(':');
|
|
if(index > 0)
|
|
{
|
|
QString key = line.left(index).trimmed();
|
|
QString val = line.mid(index+1).trimmed();
|
|
|
|
if(bInfoHeaderFound && !key.isEmpty() && !val.isEmpty())
|
|
{
|
|
if(key.compare("TotalSeconds", Qt::CaseInsensitive) == 0)
|
|
{
|
|
bool ok = false;
|
|
unsigned int duration = val.toUInt(&ok);
|
|
if(ok) info.techInfo().setDuration(duration);
|
|
}
|
|
if(key.compare("SamplesPerSec", Qt::CaseInsensitive) == 0)
|
|
{
|
|
bool ok = false;
|
|
unsigned int samplerate = val.toUInt(&ok);
|
|
if(ok) info.techInfo().setAudioSamplerate (samplerate);
|
|
}
|
|
if(key.compare("Channels", Qt::CaseInsensitive) == 0)
|
|
{
|
|
bool ok = false;
|
|
unsigned int channels = val.toUInt(&ok);
|
|
if(ok) info.techInfo().setAudioChannels(channels);
|
|
}
|
|
if(key.compare("BitsPerSample", Qt::CaseInsensitive) == 0)
|
|
{
|
|
bool ok = false;
|
|
unsigned int bitdepth = val.toUInt(&ok);
|
|
if(ok) info.techInfo().setAudioBitdepth(bitdepth);
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
if(line.contains("[Audio Info]", Qt::CaseInsensitive))
|
|
{
|
|
info.techInfo().setAudioType("Avisynth");
|
|
info.techInfo().setContainerType("Avisynth");
|
|
bInfoHeaderFound = true;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
process.waitForFinished();
|
|
if(process.state() != QProcess::NotRunning)
|
|
{
|
|
process.kill();
|
|
process.waitForFinished(-1);
|
|
}
|
|
|
|
//Check exit code
|
|
switch(process.exitCode())
|
|
{
|
|
case 0:
|
|
qDebug("Avisynth script was analyzed successfully.");
|
|
return true;
|
|
break;
|
|
case -5:
|
|
qWarning("It appears that Avisynth is not installed on the system!");
|
|
return false;
|
|
break;
|
|
default:
|
|
qWarning("Failed to open the Avisynth script, bad AVS file?");
|
|
return false;
|
|
break;
|
|
}
|
|
}
|
|
|
|
unsigned int AnalyzeTask::parseYear(const QString &str)
|
|
{
|
|
if(str.startsWith("UTC", Qt::CaseInsensitive))
|
|
{
|
|
QDate date = QDate::fromString(str.mid(3).trimmed().left(10), "yyyy-MM-dd");
|
|
if(date.isValid())
|
|
{
|
|
return date.year();
|
|
}
|
|
else
|
|
{
|
|
return 0;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
bool ok = false;
|
|
int year = str.toInt(&ok);
|
|
if(ok && year > 0)
|
|
{
|
|
return year;
|
|
}
|
|
else
|
|
{
|
|
return 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
unsigned int AnalyzeTask::parseDuration(const QString &str)
|
|
{
|
|
bool ok = false;
|
|
unsigned int value = str.toUInt(&ok);
|
|
return ok ? (value/1000) : 0;
|
|
}
|
|
|
|
|
|
////////////////////////////////////////////////////////////
|
|
// Public Functions
|
|
////////////////////////////////////////////////////////////
|
|
|
|
/*NONE*/
|
|
|
|
////////////////////////////////////////////////////////////
|
|
// EVENTS
|
|
////////////////////////////////////////////////////////////
|
|
|
|
/*NONE*/
|