VizKit::VisualConfiguration Class Reference

#include <VisualConfiguration.h>

List of all members.

Static Public Member Functions
static void	dispose (void)
static uint8	getMajorReleaseNumberAsBCD (void)
static uint8	getMinorReleaseNumberAsBCD (void)
static uint8	getReleaseRevisionNumber (void)
static uint16 *	getVisualizerShowNameUnicode (long &numberOfCharactersOfVisualizerShowNameUnicode)
Static Public Attributes
static const char *const	visualizerPluginIdentifierName = "VizKit"
static const char *const	visualizerShowName = "VizKit"
static const char *const	kVisualPluginDomainIdentifier
static const uint8	kMajorReleaseNumber = 3
static const uint8	kMinorReleaseNumber = 0
static const uint8	kReleaseRevisionNumber = 0
static const char *const	kCurrentVersionInformationURL = "http://www.imagomat.de/vizkit/download/current_version.txt"
Private Member Functions
	VisualConfiguration ()
	~VisualConfiguration ()
	VisualConfiguration (const VisualConfiguration &other)
VisualConfiguration &	operator= (const VisualConfiguration &other)
void	prepareVisualizerShowNameUnicode (void)
Static Private Member Functions
static VisualConfiguration *	getInstance (void)
static uint8	getBCD (uint8 decimalNumber)
Private Attributes
uint16 *	unicodeShowName
Static Private Attributes
static VisualConfiguration *	theVisualConfiguration = NULL

---

Detailed Description

Common definitions and constants that must be customized for each individual plug-in.

---

Constructor & Destructor Documentation

VisualConfiguration::VisualConfiguration

(

)

[private]

The constructor. VisualConfiguration is a singleton class. The constructor is private. New instance of class can only be created internally.

VisualConfiguration::~VisualConfiguration

(

)

[private]

The destructor. VisualConfiguration is a singleton class. The destructor is private. Instance of class can only be destructed internally.

VizKit::VisualConfiguration::VisualConfiguration

(

const VisualConfiguration &

other

)

[private]

Copy constructor.

Parameters:

other

Another VisualConfiguration.

Remarks:

Explicitely declared in private section and not implemented to enforce uniqueness of singleton pattern.

---

Member Function Documentation

void VisualConfiguration::dispose

(

void

)

[static]

Disposes the VisualConfiguration.

uint8 VisualConfiguration::getBCD

(

uint8

decimalNumber

)

[static, private]

Returns the binary-coded decimal value of a decimal number.

Parameters:

decimalNumber

The decimal number to convert into binary-coded decimal number.

Remarks:

BCD or Binary-coded decimal format is a format where each digit has a range of 0 - 9 (normal binary digits have a range of 0 - 15). Further info on encoding of version information: http://developer.apple.com/technotes/tn/tn1132.html (Technote OV 12- Version Territory) For a discussion of BCD see also documentation of CFBundle's CFBundleGetVersionNumber.

VisualConfiguration * VisualConfiguration::getInstance

(

void

)

[static, private]

Constructs a VisualConfiguration. The VisualConfiguration acts as a singleton. Returns a pointer to the initialised VisualConfiguration.

Returns:

A pointer to the singleton instance.

uint8 VisualConfiguration::getMajorReleaseNumberAsBCD

(

void

)

[static]

Returns the major release number encoded as BCD value.

Returns:

The major release number encoded as BCD value.

Remarks:

The BCD value is passed to iTunes in PlayerRegisterVisualPlugin() by setting the pluginVersion of the PlayerRegisterVisualPluginMessage.

uint8 VisualConfiguration::getMinorReleaseNumberAsBCD

(

void

)

[static]

Returns the minor release number encoded as BCD value.

Returns:

The minor release number encoded as BCD value.

Remarks:

The BCD value is passed to iTunes in PlayerRegisterVisualPlugin() by setting the pluginVersion of the PlayerRegisterVisualPluginMessage.

uint8 VisualConfiguration::getReleaseRevisionNumber

(

void

)

[static]

Returns the release revision number.

Returns:

The release revision number.

Remarks:

The release revision number is not encoded as BCD.

uint16 * VisualConfiguration::getVisualizerShowNameUnicode

(

long &

numberOfCharactersOfVisualizerShowNameUnicode

)

[static]

Returns the unicode-savvy show name of the visualizer.

Returns:

The unicode-savvy show name of the visualizer.

VisualConfiguration& VizKit::VisualConfiguration::operator=

(

const VisualConfiguration &

other

)

[private]

Assignment operator.

Remarks:

Explicitely declared in private section and not implemented to enforce uniqueness of singleton pattern.

void VisualConfiguration::prepareVisualizerShowNameUnicode

(

void

)

[private]

Internal method to prepare the unicode-savvy show name of the visualizer.

---

Member Data Documentation

const char *const VisualConfiguration::kCurrentVersionInformationURL = "http://www.imagomat.de/vizkit/download/current_version.txt" [static]

The URL of the current version information for this visualizer. The text information contains three items, separated by "|": 1) The current version number (major.minor.revision), set each component of the version (including 0). Zero values at the end of the version are dropped when presenting the current version to the user. 2) Info URL (web page with general information about the visualizer or specific information about the advertized version) 3) Download URL (URL pointing to download file of current visualizer) This information is used to prompt the user with update information in case an older version is running. The feature is turned on/off by preference VisualPreferences::kCheckForUpdate.

const uint8 VisualConfiguration::kMajorReleaseNumber = 3 [static]

The major release number of the visualizer (version number). Range: 0 - 99. For instance 1.2.5 means: major release number 1, minor release number 2, revision number 5.

const uint8 VisualConfiguration::kMinorReleaseNumber = 0 [static]

The minor release number of the visualizer (version number). Range: 0 - 9. For instance 1.2.5 means: major release number 1, minor release number 2, revision number 5.

const uint8 VisualConfiguration::kReleaseRevisionNumber = 0 [static]

The revision number of the visualizer (version number). Range: 0 - 255. For instance 1.2.5 means: major release number 1, minor release number 2, revision number 5.

const char* const VizKit::VisualConfiguration::kVisualPluginDomainIdentifier [static]

The identifier of the visualizer plug-in (as used on Mac OS X for preferences identification and as CFBundleIdentifier). Preferences can be stored with the Options Dialog. The values are stored in preferences text file. The preferences file is located at application data (Windows); and on Mac OS X the preferences are stored in Preferences folder inside Library folder in user's home directory. The domain identifier specifies the name of the plist file on Mac OS X. On Windows the domain identifier specifies the name of the folder inside the application data directory.

VisualConfiguration * VisualConfiguration::theVisualConfiguration = NULL [static, private]

VisualConfiguration is a singleton class. Pointer to private instance is handled internally.

uint16* VizKit::VisualConfiguration::unicodeShowName [private]

The name of the visualizer as shown in menu of iTunes (declared as UTF-16 on Windows, declared as UTF-8 on Mac).

Remarks:

Routine The internally stored unicode-savvy show name of the visualizer.

const char *const VisualConfiguration::visualizerPluginIdentifierName = "VizKit" [static]

The name of the visualizer plug-in, the identifier.

const char *const VisualConfiguration::visualizerShowName = "VizKit" [static]

The name of the visualizer as shown in menu of iTunes.

---

The documentation for this class was generated from the following files:

• source/VisualConfiguration.h
• source/VisualConfiguration.cpp