Copied: desktop/trunk/lib/cc.class.php (from rev 54, desktop/trunk/lib/main.class.php) (54 => 57)

--- desktop/trunk/lib/main.class.php	2006-12-02 03:09:08 UTC (rev 54)
+++ desktop/trunk/lib/cc.class.php	2006-12-03 19:06:48 UTC (rev 57)
@@ -0,0 +1,242 @@
+<?php
+/**
+ * cc.class.php - callicore's base class
+ *
+ * handles a few base functions - run decides which program to run and
+ * starts it, i18n is used for translation, requirements checked and
+ * autoloading is set up
+ *
+ * This is released under the GPL, see docs/gpl.txt for details
+ *
+ * @author       Elizabeth Smith <emsmith@callicore.net>
+ * @copyright    Elizabeth Smith (c)2006
+ * @link         http://callicore.net/desktop
+ * @license      http://www.opensource.org/licenses/gpl-license.php GPL
+ * @version      $Id$
+ * @since        Php 5.2.0
+ * @package      callicore
+ * @subpackage   desktop
+ * @category     lib
+ * @filesource
+ */
+$gtk = new Gtk();
+/**
+ * CC - checks settings and manages common properties
+ *
+ * Basically a wrapper for important callicore functions
+ * STATIC ONLY
+ */
+class CC
+{
+	/**
+	 * @const VERSION app version number
+	 */
+	const VERSION = '1.0.0-alpha';
+
+	/**
+	 * Icon sizes - these SHOULD be constants - but
+	 * you can't set class constants after the class is defined
+	 * so they're static vars instead - annoying
+	 *
+	 * sizes are 16, 18, 20, 14, 32, 48, 64 and 128 px square
+	 *
+	 * @var GtkEnum
+	 */
+	static public $MENU = Gtk::ICON_SIZE_MENU;
+	static public $SMALL_TOOLBAR = Gtk::ICON_SIZE_SMALL_TOOLBAR;
+	static public $BUTTON = Gtk::ICON_SIZE_BUTTON;
+	static public $LARGE_TOOLBAR = Gtk::ICON_SIZE_LARGE_TOOLBAR;
+	static public $DND = Gtk::ICON_SIZE_DND;
+	static public $DIALOG = Gtk::ICON_SIZE_DIALOG;
+	static public $LARGE;
+	static public $IMAGE;
+
+	/**
+	 * @var string program to run
+	 */
+	static protected $program;
+
+	/**
+	 * public function __construct
+	 *
+	 * forces only static calls
+	 *
+	 * @return void
+	 */
+	public function __construct()
+	{
+		throw new Exception(CC::i18n(
+			'CC contains only static methods can cannot be constructed'));
+	}
+
+	/**
+	 * static public function run
+	 *
+	 * checks for requirements, figures out the right program to run, registers
+	 * base autoload, and does basic theme setup
+	 *
+	 * @param string $program 
+	 * @return void
+	 */
+	static public function run($program = NULL)
+	{
+		// set up translation
+		if(extension_loaded('gettext'))
+		{
+			// we use system locale
+			bindtextdomain('Callicore', DIR . 'locale');
+			textdomain('Callicore');
+		}
+		if(version_compare(PHP_VERSION, '5.1.0', '<'))
+		{
+			trigger_error(self::i18n('You must use php 5.1.0 or higher'), E_USER_ERROR);
+		}
+		$have = get_loaded_extensions();
+		$needed = array('standard', 'pcre', 'date', 'PDO', 'pdo_sqlite', 'php-gtk');
+		$diff = array_diff($needed, $have);
+		if(!empty($diff))
+		{
+			trigger_error(self::i18n('%s : %s', 'The following extensions must be loaded in your php.ini for Callicore to function', implode(', ', $diff)), E_USER_ERROR);
+		}
+		unset($have, $needed, $diff);
+
+		self::$LARGE = Gtk::icon_size_register('gtk-large',64, 64);
+		self::$IMAGE = Gtk::icon_size_register('gtk-image',128, 128);
+		Gtk::rc_parse(DIR . 'stock_icons' . DS . 'stock.rc');
+		Gtk::rc_parse(DIR . 'cc_icons' . DS . 'callicore.rc');
+
+		if(is_null($program))
+		{
+			if(isset($_SERVER['argv']) && isset($_SERVER['argv'][1]))
+			{
+				$program = (string) $_SERVER['argv'][1];
+			}
+		}
+		if(is_null($program))
+		{
+			trigger_error(self::i18n('You must supply a program to run'), E_USER_ERROR);
+		}
+		self::$program = $program;
+		spl_autoload_register(array(__CLASS__, 'autoload'));
+
+		$class = 'CC_' . ucfirst(strtolower($program));
+		new $class();
+
+		unset($class, $program);
+		return;
+	}
+
+	//----------------------------------------------------------------
+	//             static helper functions
+	//----------------------------------------------------------------
+
+	/**
+	 * public static function i18n
+	 *
+	 * wrapper for gettext + sprintf/vsprintf
+	 *
+	 * @param string $string string to translate
+	 * @return string translated string
+	 */
+	public static function i18n($string)
+	{
+		$args = func_get_args();
+		array_shift($args);
+		if(!empty($args) && count($args) == 1 && is_array($args[0]))
+		{
+			$args = $args[0];
+		}
+		if(function_exists('gettext'))
+		{
+			// if we have args, the first item is format only and not translated
+			if(is_array($args) && !empty($args))
+			{
+				$args = array_map('gettext', $args);
+			}
+			else
+			{
+				$string = gettext($string);
+			}
+		}
+		return vsprintf($string, $args);
+	}
+
+	/**
+	 * public static function setDefaultIcon
+	 *
+	 * uses add_builtin_icon and render_icon to make set_default_icon_name work
+	 *
+	 * @param string $icon icon name to use as default
+	 * @return void
+	 */
+	public static function setDefaultIcon($icon)
+	{
+		$theme = GtkIconTheme::get_for_screen(GdkScreen::get_default());
+		$window = new GtkWindow();
+
+		$theme->add_builtin_icon($icon, self::$MENU,
+			$window->render_icon($icon, self::$MENU));
+		$theme->add_builtin_icon($icon, self::$SMALL_TOOLBAR,
+			$window->render_icon($icon, self::$SMALL_TOOLBAR));
+		$theme->add_builtin_icon($icon, self::$BUTTON,
+			$window->render_icon($icon, self::$BUTTON));
+		$theme->add_builtin_icon($icon, self::$LARGE_TOOLBAR,
+			$window->render_icon($icon, self::$LARGE_TOOLBAR));
+		$theme->add_builtin_icon($icon, self::$DND,
+			$window->render_icon($icon, self::$DND));
+		$theme->add_builtin_icon($icon, self::$DIALOG,
+			$window->render_icon($icon, self::$DIALOG));
+		$theme->add_builtin_icon($icon, self::$LARGE,
+			$window->render_icon($icon, self::$LARGE));
+		$theme->add_builtin_icon($icon, self::$IMAGE,
+			$window->render_icon($icon, self::$IMAGE));
+
+		GtkWindow::set_default_icon_name($icon);
+		unset($window, $theme, $icon);
+		return;
+	}
+
+	/**
+	 * static public function autoload
+	 *
+	 * if you have a program class the same name as a base class the program
+	 * one will always be loaded first (as long as it wasn't previously loaded)
+	 * you can add additional autoloads with your programs via spl_register_autoload
+	 *
+	 * @param string $class class to include
+	 * @return bool
+	 */
+	static public function autoload($class)
+	{
+		preg_match_all('/[A-Z][a-z0-9_]*/', str_replace('CC_', '', $class), $matches);
+		$array = array_map('strtolower', $matches[0]);
+		unset($matches, $class);
+		$file = array_pop($array) . '.class.php';
+		if(!empty($array))
+		{
+			$array[] = '';
+		}
+
+		$program = DIR . 'programs' . DS . self::$program . DS . 'lib' . DS . implode(DS, $array) . $file;
+		$lib = DIR . 'lib' . DS . implode(DS, $array) . $file;
+
+		if(file_exists($program))
+		{
+			include $program;
+			$return = TRUE;
+		}
+		elseif(file_exists($lib))
+		{
+			include $lib;
+			$return = TRUE;
+		}
+		else
+		{
+			$return = FALSE;
+		}
+
+		unset($lib, $file, $array, $class, $matches, $program);
+		return $return;
+	}
+}
+?>
\ No newline at end of file