k3b/libk3b/tools/k3bstdguiitems.cpp

/*
 *
 * $Id: k3bstdguiitems.cpp 619556 2007-01-03 17:38:12Z trueg $
 * Copyright (C) 2003 Sebastian Trueg <trueg@k3b.org>
 *
 * This file is part of the K3b project.
 * Copyright (C) 1998-2007 Sebastian Trueg <trueg@k3b.org>
 *
 * 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.
 * See the file "COPYING" for the exact licensing terms.
 */

#include "k3bstdguiitems.h"

#include <tqcheckbox.h>
#include <tqtooltip.h>
#include <tqwhatsthis.h>
#include <tqcombobox.h>
#include <tqframe.h>
#include <tqpalette.h>

#include <klocale.h>


TQCheckBox* K3bStdGuiItems::simulateCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Simulate"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked K3b will perform all writing steps with the "
			   "laser turned off."
			   "<p>This is useful, for example, to test a higher writing speed "
			   "or whether your system is able to write on-the-fly."
			   "<p><b>Caution:</b> DVD+R(W) does not support simulated writing.") );
  TQToolTip::add( c, i18n("Only simulate the writing process") );
  return c;
}

TQCheckBox* K3bStdGuiItems::daoCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Disk at once"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b will write the CD in 'disk at once' mode as "
			   "compared to 'track at once' (TAO)."
			   "<p>It is always recommended to use DAO where possible."
			   "<p><b>Caution:</b> Track pregaps with a length other than 2 seconds are only supported "
			   "in DAO mode.") );
  TQToolTip::add( c, i18n("Write in disk at once mode") );
  return c;
}

TQCheckBox* K3bStdGuiItems::burnproofCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Use Burnfree"), parent, name );
  TQToolTip::add( c, i18n("Enable Burnfree (or Just Link) to avoid buffer underruns") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b enables <em>Burnfree</em> "
			   "(or <em>Just Link</em>). This is "
			   "a feature of the CD writer which avoids buffer underruns."
			   "<p>Without <em>burnfree</em>, if the writer cannot get any more "
			   "data a buffer underrun would occurs, since the writer needs "
			   "a constant stream of data to write the CD."
			   "<p>With <em>burnfree</em> the writer can <em>mark</em> the current "
			   "position of the laser and get back to it when the buffer is filled again;"
			   "but, since this means having little data gaps on the CD, <b>it is "
			   "highly recommended to always choose an appropriate writing "
			   "speed to prevent the usage of burnfree, especially for audio CDs</b> "
			   "(in the worst case one would hear the gap)."
			   "<p><em>Burnfree</em> was formerly known as <em>Burnproof</em>, "
			   "but has since been renamed when it became part of the MMC standard.") );
  return c;
}

TQCheckBox* K3bStdGuiItems::onlyCreateImagesCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Only create image"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b will only create an "
			   "image and not do any actual writing."
			   "<p>The image can later be written to a CD/DVD with most current writing "
			   "programs (including K3b of course).") );
  TQToolTip::add( c, i18n("Only create an image") );
  return c;
}

TQCheckBox* K3bStdGuiItems::createCacheImageCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Create image"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b will create an image before writing "
			   "the files to the CD/DVD. Otherwise the data will be written <em>on-the-fly</em>, "
			   "i.e. no intermediate image will be created."
			   "<p><b>Caution:</b> Although writing on-the-fly should work on most systems, make sure "
			   "the data is sent to the writer fast enough.")
		   + i18n("<p>It is recommended to try a simulation first.") );
  TQToolTip::add( c, i18n("Cache the data to be written on the harddisk") );
  return c;
}

TQCheckBox* K3bStdGuiItems::removeImagesCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Remove image"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b will remove any created images after the "
			   "writing has finished."
			   "<p>Uncheck this if you want to keep the images.") );
  TQToolTip::add( c, i18n("Remove images from disk when finished") );
  return c;
}

TQCheckBox* K3bStdGuiItems::onTheFlyCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("On the fly"), parent, name );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, K3b will not create an image first but write "
			   "the files directly to the CD/DVD."
			   "<p><b>Caution:</b> Although this should work on most systems, make sure "
			   "the data is sent to the writer fast enough.")
		   + i18n("<p>It is recommended to try a simulation first.") );
  TQToolTip::add( c, i18n("Write files directly to CD/DVD without creating an image") );
  return c;
}

TQCheckBox* K3bStdGuiItems::cdTextCheckbox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Write CD-TEXT"), parent, name );
  TQToolTip::add( c, i18n("Create CD-TEXT entries") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked K3b uses some otherwise-unused space on the audio "
			   "CD to store additional information, like the artist or the CD title."
			   "<p>CD-TEXT is an extension to the audio CD standard introduced by Sony."
			   "<p>CD-TEXT will only be usable on CD players that support this extension "
			   "(mostly car CD players)."
			   "<p>Since a CD-TEXT-enhanced CDs will work in any CD player it is never a bad "
			   "idea to enable this (if you specify CD-TEXT data).") );
  return c;
}


TQComboBox* K3bStdGuiItems::paranoiaModeComboBox( TQWidget* parent, const char* name )
{
  TQComboBox* c = new TQComboBox( parent, name );
  c->insertItem( "0" );
  c->insertItem( "1" );
  c->insertItem( "2" );
  c->insertItem( "3" );
  c->setCurrentItem( 3 );
  TQToolTip::add( c, i18n("Set the paranoia level for reading audio CDs") );
  TQWhatsThis::add( c, i18n("<p>Sets the correction mode for digital audio extraction."
			   "<ul><li>0: No checking, data is copied directly from the drive. "
			   "<li>1: Perform overlapped reading to avoid jitter.</li>"
			   "<li>2: Like 1 but with additional checks of the read audio data.</li>"
			   "<li>3: Like 2 but with additional scratch detection and repair.</li></ul>"
			   "<p><b>The extraction speed reduces from 0 to 3.</b>") );
  return c;
}


TQCheckBox* K3bStdGuiItems::startMultisessionCheckBox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Start multisession CD"), parent, name );
  TQToolTip::add( c, i18n("Do not close the disk to allow additional sessions to be added later") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked K3b will not close the CD, and will write "
			   "a temporary table of contents.</p>"
			   "<p>This allows further sessions to be appended to the CD later.</p>") );
  return c;
}


TQCheckBox* K3bStdGuiItems::normalizeCheckBox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Normalize volume levels"), parent, name );
  TQToolTip::add( c, i18n("Adjust the volume levels of all tracks") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked K3b will adjust the volume of all tracks "
			   "to a standard level. This is useful for things like creating mixes, "
			   "where different recording levels on different albums can cause the volume "
			   "to vary greatly from song to song."
			   "<p><b>Be aware that K3b currently does not support normalizing when writing "
			   "on the fly.</b>") );
  return c;
}


TQCheckBox* K3bStdGuiItems::verifyCheckBox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Verify written data"), parent, name );
  TQToolTip::add( c, i18n("Compare original with written data") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked, then after successfully "
			   "writing the disk K3b will compare the original source data "
			   "with the written data to verify that the disk has been written "
			   "correctly.") );
  return c;
}


TQCheckBox* K3bStdGuiItems::ignoreAudioReadErrorsCheckBox( TQWidget* parent, const char* name )
{
  TQCheckBox* c = new TQCheckBox( i18n("Ignore read errors"), parent, name );
  TQToolTip::add( c, i18n("Skip unreadable audio sectors") );
  TQWhatsThis::add( c, i18n("<p>If this option is checked and K3b is not able to read an "
			   "audio sector from the source CD it will be replaced with zeros "
			   "on the resulting copy."
			   "<p>Since audio CD Player are able to interpolate small errors "
			   "in the data it is no problem to let K3b skip unreadable sectors.") );
  return c;
}


TQFrame* K3bStdGuiItems::horizontalLine( TQWidget* parent, const char* name )
{
  TQFrame* line = new TQFrame( parent, name );
  line->setFrameStyle( TQFrame::HLine | TQFrame::Sunken );
  return line;
}

TQFrame* K3bStdGuiItems::verticalLine( TQWidget* parent, const char* name )
{
  TQFrame* line = new TQFrame( parent, name );
  line->setFrameStyle( TQFrame::VLine | TQFrame::Sunken );
  return line;
}