mirror of https://github.com/odrling/Aegisub
132 lines
4.7 KiB
C
132 lines
4.7 KiB
C
|
// Copyright (c) 2008-2009 Niels Martin Hansen
|
||
|
//
|
||
|
// Redistribution and use in source and binary forms, with or without
|
||
|
// modification, are permitted provided that the following conditions are met:
|
||
|
//
|
||
|
// * Redistributions of source code must retain the above copyright notice,
|
||
|
// this list of conditions and the following disclaimer.
|
||
|
// * Redistributions in binary form must reproduce the above copyright notice,
|
||
|
// this list of conditions and the following disclaimer in the documentation
|
||
|
// and/or other materials provided with the distribution.
|
||
|
// * Neither the name of the Aegisub Group nor the names of its contributors
|
||
|
// may be used to endorse or promote products derived from this software
|
||
|
// without specific prior written permission.
|
||
|
//
|
||
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||
|
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
||
|
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||
|
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||
|
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||
|
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||
|
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||
|
// POSSIBILITY OF SUCH DAMAGE.
|
||
|
//
|
||
|
// Aegisub Project http://www.aegisub.org/
|
||
|
//
|
||
|
// $Id$
|
||
|
|
||
|
|
||
|
/// @file util_osx.h
|
||
|
/// @brief OSX Utilities
|
||
|
/// @ingroup libaegisub osx
|
||
|
///
|
||
|
/// Utility functions for running regular *NIX libraries inside application
|
||
|
/// bundles on Apple Macintosh OS X.
|
||
|
///
|
||
|
/// The GetBundle*Directory functions return the paths of directories inside
|
||
|
/// the appliaction bundle where the application can store static data and
|
||
|
/// shared libraries for its own use.
|
||
|
/// (The bundle and its contents should be considered read-only.)
|
||
|
///
|
||
|
/// When linking with this library, be sure to add '-framework CoreFoundation'
|
||
|
/// to the GCC commandline.
|
||
|
///
|
||
|
/// @note All strings returned by these functions are allocated by strdup(), it is
|
||
|
/// the responsibility of the caller to free() them.
|
||
|
/// All of the functions may return NULL on error.
|
||
|
|
||
|
|
||
|
namespace agi {
|
||
|
namespace util {
|
||
|
|
||
|
/// @brief Get the full name of bundle.
|
||
|
/// @return Full name of bundle.
|
||
|
/// Get the full name of the bundle itself.
|
||
|
///
|
||
|
/// @warning May return NULL if the current executable is not inside a bundle.
|
||
|
char * OSX_GetBundlePath();
|
||
|
|
||
|
|
||
|
/// @brief Get the esources directory.
|
||
|
/// @return Resources directory.
|
||
|
///
|
||
|
/// Mainly for user interface elements such as graphics and strings
|
||
|
char * OSX_GetBundleResourcesDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the built-in plugins directory.
|
||
|
/// @return Built-in plugins directory.
|
||
|
///
|
||
|
/// This is generaly only used by native Carbon and Cocoa applications. It is
|
||
|
/// not for general shared libraries.
|
||
|
char * OSX_GetBundleBuiltInPlugInsDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the private Frameworks directory.
|
||
|
/// @return Private Framework directory.
|
||
|
///
|
||
|
/// These are suitable locations for shared libraries.
|
||
|
char * OSX_GetBundlePrivateFrameworksDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the shared Frameworks directory.
|
||
|
/// @return Shared Framework directory.
|
||
|
///
|
||
|
/// @see OSX_GetBundlePrivateFrameworksDirectory()
|
||
|
/// @note Does anyone know the difference between private and shared frameworks
|
||
|
/// inside a bundle?
|
||
|
char * OSX_GetBundleSharedFrameworksDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the shared support directory
|
||
|
/// @return Shared support directory
|
||
|
///
|
||
|
/// This is a suitable location for static configuration files. (Remember,
|
||
|
/// bundle is considered read-only.)
|
||
|
char * OSX_GetBundleSharedSupportDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the support directory
|
||
|
/// @return Support directory
|
||
|
/// @see OSX_GetBundleSharedSupportDirectory()
|
||
|
/// @note Again, what is the difference between Support and SharedSupport?
|
||
|
char * OSX_GetBundleSupportFilesDirectory();
|
||
|
|
||
|
|
||
|
/// @brief Get the main executable path.
|
||
|
/// @return Main executable path.
|
||
|
///
|
||
|
/// The binary run when the user launches the bundle from Finder.
|
||
|
char * OSX_GetBundleExecutablePath();
|
||
|
|
||
|
|
||
|
/// @brief Get the auxillary executable path.
|
||
|
/// @return Auxillary executable path.
|
||
|
///
|
||
|
/// Pass the basename of the executable to get the path.
|
||
|
char * OSX_GetBundleAuxillaryExecutablePath(const char *executableName);
|
||
|
|
||
|
|
||
|
/// @brief Open a URI using the Launcher.
|
||
|
/// @param location URI of file
|
||
|
/// @note If this is a FILE or DIRECTORY the path must be ABSOLUTE no 'file://'
|
||
|
/// @return Error code.
|
||
|
void OSX_OpenLocation(const char *location);
|
||
|
|
||
|
|
||
|
} // namespace io
|
||
|
} // namespace agi
|