[macOS] Adding QuickLook feature (#7491)
* [macOS] Adding QuickLook feature * [macOS] Adding QuickLook support for Conda and Homebrew. * [macOS] Support non-square app icons in thumbnails. * [macOS] adding icon for .FCScript files
This commit is contained in:
@@ -18,7 +18,6 @@ if(BUILD_TEMPLATE)
|
||||
add_subdirectory(Tools/_TEMPLATE_)
|
||||
endif(BUILD_TEMPLATE)
|
||||
|
||||
# "if" clause moved into local CMakeLists.txt file to support Conda and Homebrew builds
|
||||
add_subdirectory(MacAppBundle)
|
||||
|
||||
if(FREECAD_CREATE_MAC_APP)
|
||||
add_subdirectory(MacAppBundle)
|
||||
endif(FREECAD_CREATE_MAC_APP)
|
||||
|
||||
@@ -106,7 +106,7 @@ void Thumbnail::SaveDocFile (Base::Writer &writer) const
|
||||
if (App::GetApplication().GetParameterGroupByPath
|
||||
("User parameter:BaseApp/Preferences/Document")->GetBool("AddThumbnailLogo",true)) {
|
||||
// only scale app icon if an offscreen image could be created
|
||||
appIcon = appIcon.scaled(this->size / 4, this->size /4, Qt::IgnoreAspectRatio, Qt::SmoothTransformation);
|
||||
appIcon = appIcon.scaled(this->size / 4, this->size /4, Qt::KeepAspectRatio, Qt::SmoothTransformation);
|
||||
px = BitmapFactory().merge(QPixmap::fromImage(img), appIcon, BitmapFactoryInst::BottomRight);
|
||||
}
|
||||
else {
|
||||
|
||||
@@ -1,3 +1,27 @@
|
||||
|
||||
#
|
||||
# Build and install QuickLook for FCStd files (org.freecad.fcstd)
|
||||
# This is used by Homebrew and Conda/Mamba scripts alike.
|
||||
#
|
||||
if(FREECAD_CREATE_MAC_APP OR (APPLE AND BUILD_WITH_CONDA))
|
||||
add_subdirectory(QuickLook)
|
||||
install(
|
||||
DIRECTORY "${CMAKE_CURRENT_LIST_DIR}/QuickLook/QuicklookFCStd.qlgenerator"
|
||||
DESTINATION "${CMAKE_INSTALL_PREFIX}/Library/QuickLook"
|
||||
)
|
||||
install(
|
||||
PROGRAMS "${PROJECT_BINARY_DIR}/src/MacAppBundle/QuickLook/QuicklookFCStd.framework/Versions/A/QuicklookFCStd"
|
||||
DESTINATION "${CMAKE_INSTALL_PREFIX}/Library/QuickLook/QuicklookFCStd.qlgenerator/Contents/MacOS/"
|
||||
)
|
||||
endif()
|
||||
|
||||
|
||||
#
|
||||
# Build a Bundle in Homebrew.
|
||||
# This is ignored by Conda/Mamba build scripts.
|
||||
#
|
||||
if(FREECAD_CREATE_MAC_APP)
|
||||
|
||||
set(PYTHON_DIR_BASENAME python${PYTHON_VERSION_MAJOR}.${PYTHON_VERSION_MINOR})
|
||||
|
||||
if(PYTHON_LIBRARY MATCHES "(.*Python\\.framework).*")
|
||||
@@ -122,8 +146,8 @@ file(GLOB CONFIG_GCC "${HOMEBREW_PREFIX}/opt/gcc/lib/gcc/current")
|
||||
execute_process(
|
||||
COMMAND find -L /usr/local/Cellar/nglib -name MacOS
|
||||
OUTPUT_VARIABLE CONFIG_NGLIB)
|
||||
|
||||
install(CODE
|
||||
|
||||
install(CODE
|
||||
"message(STATUS \"Making bundle relocatable...\")
|
||||
# The top-level CMakeLists.txt should prevent multiple package manager
|
||||
# prefixes from being set, so the lib path will resolve correctly...
|
||||
@@ -133,3 +157,5 @@ install(CODE
|
||||
${APP_PATH} ${HOMEBREW_PREFIX}${MACPORTS_PREFIX}/lib ${CONFIG_ICU} ${CONFIG_LLVM} ${CONFIG_GCC} /usr/local/opt ${CONFIG_NGLIB} ${Qt5Core_DIR}/../../.. ${XCTEST_PATH} ${WEBKIT_FRAMEWORK_DIR}
|
||||
)"
|
||||
)
|
||||
|
||||
endif(FREECAD_CREATE_MAC_APP)
|
||||
|
||||
@@ -2,6 +2,56 @@
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>CFBundleDocumentTypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>CFBundleTypeRole</key>
|
||||
<string>Editor</string>
|
||||
<key>CFBundleTypeExtensions</key>
|
||||
<array>
|
||||
<string>FCStd</string>
|
||||
<string>FCMat</string>
|
||||
<string>FCParam</string>
|
||||
</array>
|
||||
<key>CFBundleTypeIconFile</key>
|
||||
<string>freecad-doc.icns</string>
|
||||
<key>LSIsAppleDefaultForType</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>CFBundleTypeRole</key>
|
||||
<string>Editor</string>
|
||||
<key>CFBundleTypeExtensions</key>
|
||||
<array>
|
||||
<string>FCMacro</string>
|
||||
<string>FCScript</string>
|
||||
</array>
|
||||
<key>CFBundleTypeIconFile</key>
|
||||
<string>freecad-script.icns</string>
|
||||
<key>LSIsAppleDefaultForType</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</array>
|
||||
<key>UTExportedTypeDeclarations</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>UTTypeConformsTo</key>
|
||||
<array>
|
||||
<string>public.data</string>
|
||||
</array>
|
||||
<key>UTTypeDescription</key>
|
||||
<string>FreeCAD Document</string>
|
||||
<key>UTTypeIdentifier</key>
|
||||
<string>org.freecad.fcstd</string>
|
||||
<key>UTTypeTagSpecification</key>
|
||||
<dict>
|
||||
<key>public.filename-extension</key>
|
||||
<array>
|
||||
<string>FCStd</string>
|
||||
</array>
|
||||
</dict>
|
||||
</dict>
|
||||
</array>
|
||||
<key>CFBundleDevelopmentRegion</key>
|
||||
<string>English</string>
|
||||
<key>CFBundleExecutable</key>
|
||||
@@ -31,23 +81,8 @@
|
||||
<key>NSHumanReadableCopyright</key>
|
||||
<string></string>
|
||||
<key>NSPrincipalClass</key>
|
||||
<string>NSApplication</string>
|
||||
<string>NSApplication</string>
|
||||
<key>NSHighResolutionCapable</key>
|
||||
<string>True</string>
|
||||
<key>CFBundleDocumentTypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>CFBundleTypeRole</key>
|
||||
<string>Editor</string>
|
||||
<key>CFBundleTypeExtensions</key>
|
||||
<array>
|
||||
<string>FCStd</string>
|
||||
</array>
|
||||
<key>CFBundleTypeIconFile</key>
|
||||
<string>freecad-doc.icns</string>
|
||||
<key>LSIsAppleDefaultForType</key>
|
||||
<true/>
|
||||
</dict>
|
||||
</array>
|
||||
</dict>
|
||||
</plist>
|
||||
|
||||
Binary file not shown.
35
src/MacAppBundle/QuickLook/CMakeLists.txt
Normal file
35
src/MacAppBundle/QuickLook/CMakeLists.txt
Normal file
@@ -0,0 +1,35 @@
|
||||
|
||||
#cmake_minimum_required(VERSION 3.23)
|
||||
#project(FCQuickLook)
|
||||
|
||||
add_library(
|
||||
QuicklookFCStd
|
||||
SHARED
|
||||
GeneratePreviewForURL.m
|
||||
GenerateThumbnailForURL.m
|
||||
main.c
|
||||
)
|
||||
|
||||
set_target_properties(
|
||||
QuicklookFCStd
|
||||
PROPERTIES
|
||||
FRAMEWORK TRUE
|
||||
MACOSX_FRAMEWORK_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/QuicklookFCStd.qlgenerator/Contents/Info.plist"
|
||||
#SUFFIX .qlgenerator
|
||||
)
|
||||
|
||||
target_link_libraries(
|
||||
QuicklookFCStd
|
||||
"-framework AppKit"
|
||||
"-framework ApplicationServices"
|
||||
"-framework CoreData"
|
||||
"-framework CoreFoundation"
|
||||
"-framework CoreServices"
|
||||
"-framework Foundation"
|
||||
"-framework QuickLook"
|
||||
)
|
||||
|
||||
set_target_properties(
|
||||
QuicklookFCStd
|
||||
PROPERTIES LINK_FLAGS "-Wl,-F/Library/Frameworks"
|
||||
)
|
||||
74
src/MacAppBundle/QuickLook/GeneratePreviewForURL.m
Normal file
74
src/MacAppBundle/QuickLook/GeneratePreviewForURL.m
Normal file
@@ -0,0 +1,74 @@
|
||||
#include <CoreFoundation/CoreFoundation.h>
|
||||
#include <CoreServices/CoreServices.h>
|
||||
#include <QuickLook/QuickLook.h>
|
||||
#include <Foundation/Foundation.h>
|
||||
#include <AppKit/AppKit.h>
|
||||
|
||||
/* -----------------------------------------------------------------------------
|
||||
Generate a preview for file
|
||||
|
||||
This function's job is to create preview for designated file
|
||||
----------------------------------------------------------------------------- */
|
||||
|
||||
|
||||
OSStatus GeneratePreviewForURL(void *thisInterface, QLPreviewRequestRef preview, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options)
|
||||
{
|
||||
OSStatus ret = coreFoundationUnknownErr;
|
||||
|
||||
@autoreleasepool {
|
||||
|
||||
// unzip -qq -o -j -d /tmp ~/test.FCStd thumbnails/Thumbnail.png
|
||||
// -qq : be really quiet
|
||||
// -o : overwrite without prompt
|
||||
// -j : don't create archive paths
|
||||
// -d : destination path (create this path)
|
||||
// extracts thumbnails/Thumbnail.png to /tmp/Thumbnail.png .
|
||||
// We add a UUID and use a system temp directory here.
|
||||
|
||||
// TODO: do we need to release any of these resources?
|
||||
NSUUID *uuid = [NSUUID UUID];
|
||||
NSString *uuidPath = [uuid UUIDString];
|
||||
NSString *unzipDstPath = [NSString stringWithFormat:@"%@/%@/", NSTemporaryDirectory(), uuidPath];
|
||||
NSString *unzipDstFile = [NSString stringWithFormat:@"%@%@", unzipDstPath, @"Thumbnail.png"];
|
||||
NSURL *zipFile = (__bridge NSURL *)url;
|
||||
NSTask *task = [NSTask launchedTaskWithLaunchPath:@"/usr/bin/unzip"
|
||||
arguments:@[@"-qq", @"-o", @"-j", @"-d", unzipDstPath, [zipFile path], @"thumbnails/Thumbnail.png"]];
|
||||
[task waitUntilExit];
|
||||
// NSLog(@"%@", unzipDstPath);
|
||||
// NSLog(@"%@", unzipDstFile);
|
||||
|
||||
if ( [[NSFileManager defaultManager] fileExistsAtPath:unzipDstFile] )
|
||||
{
|
||||
// Preview will be drawn in a vectorized context
|
||||
CGSize canvasSize = CGSizeMake(512, 512);
|
||||
CGContextRef cgContext = QLPreviewRequestCreateContext(preview, canvasSize, true, NULL);
|
||||
if(cgContext)
|
||||
{
|
||||
CGDataProviderRef pngDP = CGDataProviderCreateWithFilename([unzipDstFile fileSystemRepresentation]);
|
||||
CGImageRef image = CGImageCreateWithPNGDataProvider(pngDP, NULL, true, kCGRenderingIntentDefault);
|
||||
|
||||
CGContextDrawImage(cgContext,CGRectMake(0, 0, 512, 512), image);
|
||||
|
||||
QLPreviewRequestFlushContext(preview, cgContext);
|
||||
ret = noErr;
|
||||
|
||||
CFRelease(cgContext);
|
||||
CFRelease(image);
|
||||
}
|
||||
}
|
||||
|
||||
if ( [[NSFileManager defaultManager] fileExistsAtPath:unzipDstFile] )
|
||||
[[NSFileManager defaultManager] removeItemAtPath:unzipDstFile error:nil];
|
||||
|
||||
if ( [[NSFileManager defaultManager] fileExistsAtPath:unzipDstPath] )
|
||||
[[NSFileManager defaultManager] removeItemAtPath:unzipDstPath error:nil];
|
||||
}
|
||||
|
||||
return ret;
|
||||
}
|
||||
|
||||
|
||||
void CancelPreviewGeneration(void* thisInterface, QLPreviewRequestRef preview)
|
||||
{
|
||||
// implement only if supported
|
||||
}
|
||||
72
src/MacAppBundle/QuickLook/GenerateThumbnailForURL.m
Normal file
72
src/MacAppBundle/QuickLook/GenerateThumbnailForURL.m
Normal file
@@ -0,0 +1,72 @@
|
||||
#include <CoreFoundation/CoreFoundation.h>
|
||||
#include <CoreServices/CoreServices.h>
|
||||
#include <QuickLook/QuickLook.h>
|
||||
#include <Foundation/Foundation.h>
|
||||
#include <AppKit/AppKit.h>
|
||||
|
||||
/* -----------------------------------------------------------------------------
|
||||
Generate a thumbnail for file
|
||||
|
||||
This function's job is to create thumbnail for designated file as fast as possible
|
||||
----------------------------------------------------------------------------- */
|
||||
|
||||
OSStatus GenerateThumbnailForURL(void *thisInterface, QLThumbnailRequestRef thumbnail, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options, CGSize maxSize)
|
||||
{
|
||||
OSStatus ret = coreFoundationUnknownErr;
|
||||
|
||||
@autoreleasepool {
|
||||
|
||||
// unzip -qq -o -j -d /tmp ~/test.FCStd thumbnails/Thumbnail.png
|
||||
// -qq : be really quiet
|
||||
// -o : overwrite without prompt
|
||||
// -j : don't create archive paths
|
||||
// -d : destination path (create this path)
|
||||
// extracts thumbnails/Thumbnail.png to /tmp/Thumbnail.png .
|
||||
// We add a UUID and use a system temp directory here.
|
||||
|
||||
NSUUID *uuid = [NSUUID UUID];
|
||||
NSString *uuidPath = [uuid UUIDString];
|
||||
NSString *unzipDstPath = [NSString stringWithFormat:@"%@/%@/", NSTemporaryDirectory(), uuidPath];
|
||||
NSString *unzipDstFile = [NSString stringWithFormat:@"%@%@", unzipDstPath, @"Thumbnail.png"];
|
||||
NSURL *zipFile = (__bridge NSURL *)url;
|
||||
NSTask *task = [NSTask launchedTaskWithLaunchPath:@"/usr/bin/unzip"
|
||||
arguments:@[@"-qq", @"-o", @"-j", @"-d", unzipDstPath, [zipFile path], @"thumbnails/Thumbnail.png"]];
|
||||
[task waitUntilExit];
|
||||
// NSLog(@"%@", unzipDstPath);
|
||||
// NSLog(@"%@", unzipDstFile);
|
||||
|
||||
if ( [[NSFileManager defaultManager] fileExistsAtPath:unzipDstFile] )
|
||||
{
|
||||
CGSize canvasSize = CGSizeMake(128, 128);
|
||||
CGContextRef cgContext = QLThumbnailRequestCreateContext(thumbnail, /*maxSize*/canvasSize, true, NULL);
|
||||
if(cgContext)
|
||||
{
|
||||
CGDataProviderRef pngDP = CGDataProviderCreateWithFilename([unzipDstFile fileSystemRepresentation]);
|
||||
CGImageRef image = CGImageCreateWithPNGDataProvider(pngDP, NULL, true, kCGRenderingIntentDefault);
|
||||
CGDataProviderRelease(pngDP);
|
||||
|
||||
CGContextDrawImage(cgContext,CGRectMake(0, 0, 128, 128), image);
|
||||
|
||||
QLThumbnailRequestFlushContext(thumbnail, cgContext);
|
||||
ret = noErr;
|
||||
|
||||
CFRelease(cgContext);
|
||||
CFRelease(image);
|
||||
}
|
||||
}
|
||||
|
||||
if ( [[NSFileManager defaultManager] isDeletableFileAtPath:unzipDstFile] )
|
||||
[[NSFileManager defaultManager] removeItemAtPath:unzipDstFile error:nil];
|
||||
|
||||
if ( [[NSFileManager defaultManager] isDeletableFileAtPath:unzipDstPath] )
|
||||
[[NSFileManager defaultManager] removeItemAtPath:unzipDstPath error:nil];
|
||||
}
|
||||
|
||||
return ret;
|
||||
}
|
||||
|
||||
|
||||
void CancelThumbnailGeneration(void* thisInterface, QLThumbnailRequestRef thumbnail)
|
||||
{
|
||||
// implement only if supported
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>BuildMachineOSBuild</key>
|
||||
<string>21G83</string>
|
||||
<key>CFBundleDevelopmentRegion</key>
|
||||
<string>English</string>
|
||||
<key>CFBundleDocumentTypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>CFBundleTypeRole</key>
|
||||
<string>QLGenerator</string>
|
||||
<key>LSItemContentTypes</key>
|
||||
<array>
|
||||
<string>org.freecad.fcstd</string>
|
||||
</array>
|
||||
</dict>
|
||||
</array>
|
||||
<key>CFBundleExecutable</key>
|
||||
<string>QuicklookFCStd</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>org.freecad.qlgenerator.QuicklookFCStd</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>QuicklookFCStd</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0</string>
|
||||
<key>CFBundleSupportedPlatforms</key>
|
||||
<array>
|
||||
<string>MacOSX</string>
|
||||
</array>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>0</string>
|
||||
<key>CFPlugInDynamicRegisterFunction</key>
|
||||
<string></string>
|
||||
<key>CFPlugInDynamicRegistration</key>
|
||||
<string>YES</string>
|
||||
<key>CFPlugInFactories</key>
|
||||
<dict>
|
||||
<key>F70BD796-FE76-450B-83CC-609688F17873</key>
|
||||
<string>QuickLookGeneratorPluginFactory</string>
|
||||
</dict>
|
||||
<key>CFPlugInTypes</key>
|
||||
<dict>
|
||||
<key>5E2D9680-5022-40FA-B806-43349622E5B9</key>
|
||||
<array>
|
||||
<string>F70BD796-FE76-450B-83CC-609688F17873</string>
|
||||
</array>
|
||||
</dict>
|
||||
<key>CFPlugInUnloadFunction</key>
|
||||
<string></string>
|
||||
<key>DTCompiler</key>
|
||||
<string>com.apple.compilers.llvm.clang.1_0</string>
|
||||
<key>DTPlatformBuild</key>
|
||||
<string>13F100</string>
|
||||
<key>DTPlatformName</key>
|
||||
<string>macosx</string>
|
||||
<key>DTPlatformVersion</key>
|
||||
<string>12.3</string>
|
||||
<key>DTSDKBuild</key>
|
||||
<string>21E226</string>
|
||||
<key>DTSDKName</key>
|
||||
<string>macosx12.3</string>
|
||||
<key>DTXcode</key>
|
||||
<string>1341</string>
|
||||
<key>DTXcodeBuild</key>
|
||||
<string>13F100</string>
|
||||
<key>LSMinimumSystemVersion</key>
|
||||
<string>12.3</string>
|
||||
<key>QLNeedsToBeRunInMainThread</key>
|
||||
<false/>
|
||||
<key>QLPreviewHeight</key>
|
||||
<integer>512</integer>
|
||||
<key>QLPreviewWidth</key>
|
||||
<integer>512</integer>
|
||||
<key>QLSupportsConcurrentRequests</key>
|
||||
<true/>
|
||||
<key>QLThumbnailMinimumSize</key>
|
||||
<real>17</real>
|
||||
<key>UTImportedTypeDeclarations</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>UTTypeConformsTo</key>
|
||||
<array>
|
||||
<string>public.data</string>
|
||||
<string>public.archive</string>
|
||||
</array>
|
||||
<key>UTTypeDescription</key>
|
||||
<string>FreeCAD document</string>
|
||||
<key>UTTypeIdentifier</key>
|
||||
<string>org.freecad.fcstd</string>
|
||||
<key>UTTypeReferenceURL</key>
|
||||
<string>https://wiki.freecad.org/File_Format_FCStd/id</string>
|
||||
<key>UTTypeTagSpecification</key>
|
||||
<dict>
|
||||
<key>public.filename-extension</key>
|
||||
<array>
|
||||
<string>FCStd</string>
|
||||
</array>
|
||||
</dict>
|
||||
</dict>
|
||||
</array>
|
||||
</dict>
|
||||
</plist>
|
||||
212
src/MacAppBundle/QuickLook/main.c
Normal file
212
src/MacAppBundle/QuickLook/main.c
Normal file
@@ -0,0 +1,212 @@
|
||||
//==============================================================================
|
||||
//
|
||||
// DO NO MODIFY THE CONTENT OF THIS FILE
|
||||
//
|
||||
// This file contains the generic CFPlug-in code necessary for your generator
|
||||
// To complete your generator implement the function in GenerateThumbnailForURL/GeneratePreviewForURL.c
|
||||
//
|
||||
//==============================================================================
|
||||
|
||||
#include <CoreFoundation/CoreFoundation.h>
|
||||
#include <CoreFoundation/CFPlugInCOM.h>
|
||||
#include <CoreServices/CoreServices.h>
|
||||
#include <QuickLook/QuickLook.h>
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// constants
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
// Don't modify this line
|
||||
#define PLUGIN_ID "F70BD796-FE76-450B-83CC-609688F17873"
|
||||
|
||||
//
|
||||
// Below is the generic glue code for all plug-ins.
|
||||
//
|
||||
// You should not have to modify this code aside from changing
|
||||
// names if you decide to change the names defined in the Info.plist
|
||||
//
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// typedefs
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
// The thumbnail generation function to be implemented in GenerateThumbnailForURL.c
|
||||
OSStatus GenerateThumbnailForURL(void *thisInterface, QLThumbnailRequestRef thumbnail, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options, CGSize maxSize);
|
||||
void CancelThumbnailGeneration(void* thisInterface, QLThumbnailRequestRef thumbnail);
|
||||
|
||||
// The preview generation function to be implemented in GeneratePreviewForURL.c
|
||||
OSStatus GeneratePreviewForURL(void *thisInterface, QLPreviewRequestRef preview, CFURLRef url, CFStringRef contentTypeUTI, CFDictionaryRef options);
|
||||
void CancelPreviewGeneration(void *thisInterface, QLPreviewRequestRef preview);
|
||||
|
||||
// The layout for an instance of QuickLookGeneratorPlugIn
|
||||
typedef struct __QuickLookGeneratorPluginType
|
||||
{
|
||||
void *conduitInterface;
|
||||
CFUUIDRef factoryID;
|
||||
UInt32 refCount;
|
||||
} QuickLookGeneratorPluginType;
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// prototypes
|
||||
// -----------------------------------------------------------------------------
|
||||
// Forward declaration for the IUnknown implementation.
|
||||
//
|
||||
|
||||
QuickLookGeneratorPluginType *AllocQuickLookGeneratorPluginType(CFUUIDRef inFactoryID);
|
||||
void DeallocQuickLookGeneratorPluginType(QuickLookGeneratorPluginType *thisInstance);
|
||||
HRESULT QuickLookGeneratorQueryInterface(void *thisInstance,REFIID iid,LPVOID *ppv);
|
||||
void *QuickLookGeneratorPluginFactory(CFAllocatorRef allocator,CFUUIDRef typeID);
|
||||
ULONG QuickLookGeneratorPluginAddRef(void *thisInstance);
|
||||
ULONG QuickLookGeneratorPluginRelease(void *thisInstance);
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// myInterfaceFtbl definition
|
||||
// -----------------------------------------------------------------------------
|
||||
// The QLGeneratorInterfaceStruct function table.
|
||||
//
|
||||
static QLGeneratorInterfaceStruct myInterfaceFtbl = {
|
||||
NULL,
|
||||
QuickLookGeneratorQueryInterface,
|
||||
QuickLookGeneratorPluginAddRef,
|
||||
QuickLookGeneratorPluginRelease,
|
||||
NULL,
|
||||
NULL,
|
||||
NULL,
|
||||
NULL
|
||||
};
|
||||
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// AllocQuickLookGeneratorPluginType
|
||||
// -----------------------------------------------------------------------------
|
||||
// Utility function that allocates a new instance.
|
||||
// You can do some initial setup for the generator here if you wish
|
||||
// like allocating globals etc...
|
||||
//
|
||||
QuickLookGeneratorPluginType *AllocQuickLookGeneratorPluginType(CFUUIDRef inFactoryID)
|
||||
{
|
||||
QuickLookGeneratorPluginType *theNewInstance;
|
||||
|
||||
theNewInstance = (QuickLookGeneratorPluginType *)malloc(sizeof(QuickLookGeneratorPluginType));
|
||||
memset(theNewInstance,0,sizeof(QuickLookGeneratorPluginType));
|
||||
|
||||
/* Point to the function table Malloc enough to store the stuff and copy the filler from myInterfaceFtbl over */
|
||||
theNewInstance->conduitInterface = malloc(sizeof(QLGeneratorInterfaceStruct));
|
||||
memcpy(theNewInstance->conduitInterface,&myInterfaceFtbl,sizeof(QLGeneratorInterfaceStruct));
|
||||
|
||||
/* Retain and keep an open instance refcount for each factory. */
|
||||
theNewInstance->factoryID = CFRetain(inFactoryID);
|
||||
CFPlugInAddInstanceForFactory(inFactoryID);
|
||||
|
||||
/* This function returns the IUnknown interface so set the refCount to one. */
|
||||
theNewInstance->refCount = 1;
|
||||
return theNewInstance;
|
||||
}
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// DeallocQuickLookGeneratorPluginType
|
||||
// -----------------------------------------------------------------------------
|
||||
// Utility function that deallocates the instance when
|
||||
// the refCount goes to zero.
|
||||
// In the current implementation generator interfaces are never deallocated
|
||||
// but implement this as this might change in the future
|
||||
//
|
||||
void DeallocQuickLookGeneratorPluginType(QuickLookGeneratorPluginType *thisInstance)
|
||||
{
|
||||
CFUUIDRef theFactoryID;
|
||||
|
||||
theFactoryID = thisInstance->factoryID;
|
||||
/* Free the conduitInterface table up */
|
||||
free(thisInstance->conduitInterface);
|
||||
|
||||
/* Free the instance structure */
|
||||
free(thisInstance);
|
||||
if (theFactoryID){
|
||||
CFPlugInRemoveInstanceForFactory(theFactoryID);
|
||||
CFRelease(theFactoryID);
|
||||
}
|
||||
}
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// QuickLookGeneratorQueryInterface
|
||||
// -----------------------------------------------------------------------------
|
||||
// Implementation of the IUnknown QueryInterface function.
|
||||
//
|
||||
HRESULT QuickLookGeneratorQueryInterface(void *thisInstance,REFIID iid,LPVOID *ppv)
|
||||
{
|
||||
CFUUIDRef interfaceID;
|
||||
|
||||
interfaceID = CFUUIDCreateFromUUIDBytes(kCFAllocatorDefault,iid);
|
||||
|
||||
if (CFEqual(interfaceID,kQLGeneratorCallbacksInterfaceID)){
|
||||
/* If the Right interface was requested, bump the ref count,
|
||||
* set the ppv parameter equal to the instance, and
|
||||
* return good status.
|
||||
*/
|
||||
((QLGeneratorInterfaceStruct *)((QuickLookGeneratorPluginType *)thisInstance)->conduitInterface)->GenerateThumbnailForURL = GenerateThumbnailForURL;
|
||||
((QLGeneratorInterfaceStruct *)((QuickLookGeneratorPluginType *)thisInstance)->conduitInterface)->CancelThumbnailGeneration = CancelThumbnailGeneration;
|
||||
((QLGeneratorInterfaceStruct *)((QuickLookGeneratorPluginType *)thisInstance)->conduitInterface)->GeneratePreviewForURL = GeneratePreviewForURL;
|
||||
((QLGeneratorInterfaceStruct *)((QuickLookGeneratorPluginType *)thisInstance)->conduitInterface)->CancelPreviewGeneration = CancelPreviewGeneration;
|
||||
((QLGeneratorInterfaceStruct *)((QuickLookGeneratorPluginType*)thisInstance)->conduitInterface)->AddRef(thisInstance);
|
||||
*ppv = thisInstance;
|
||||
CFRelease(interfaceID);
|
||||
return S_OK;
|
||||
}else{
|
||||
/* Requested interface unknown, bail with error. */
|
||||
*ppv = NULL;
|
||||
CFRelease(interfaceID);
|
||||
return E_NOINTERFACE;
|
||||
}
|
||||
}
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// QuickLookGeneratorPluginAddRef
|
||||
// -----------------------------------------------------------------------------
|
||||
// Implementation of reference counting for this type. Whenever an interface
|
||||
// is requested, bump the refCount for the instance. NOTE: returning the
|
||||
// refcount is a convention but is not required so don't rely on it.
|
||||
//
|
||||
ULONG QuickLookGeneratorPluginAddRef(void *thisInstance)
|
||||
{
|
||||
((QuickLookGeneratorPluginType *)thisInstance )->refCount += 1;
|
||||
return ((QuickLookGeneratorPluginType*) thisInstance)->refCount;
|
||||
}
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// QuickLookGeneratorPluginRelease
|
||||
// -----------------------------------------------------------------------------
|
||||
// When an interface is released, decrement the refCount.
|
||||
// If the refCount goes to zero, deallocate the instance.
|
||||
//
|
||||
ULONG QuickLookGeneratorPluginRelease(void *thisInstance)
|
||||
{
|
||||
((QuickLookGeneratorPluginType*)thisInstance)->refCount -= 1;
|
||||
if (((QuickLookGeneratorPluginType*)thisInstance)->refCount == 0){
|
||||
DeallocQuickLookGeneratorPluginType((QuickLookGeneratorPluginType*)thisInstance );
|
||||
return 0;
|
||||
}else{
|
||||
return ((QuickLookGeneratorPluginType*) thisInstance )->refCount;
|
||||
}
|
||||
}
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// QuickLookGeneratorPluginFactory
|
||||
// -----------------------------------------------------------------------------
|
||||
void *QuickLookGeneratorPluginFactory(CFAllocatorRef allocator,CFUUIDRef typeID)
|
||||
{
|
||||
QuickLookGeneratorPluginType *result;
|
||||
CFUUIDRef uuid;
|
||||
|
||||
/* If correct type is being requested, allocate an
|
||||
* instance of kQLGeneratorTypeID and return the IUnknown interface.
|
||||
*/
|
||||
if (CFEqual(typeID,kQLGeneratorTypeID)){
|
||||
uuid = CFUUIDCreateFromString(kCFAllocatorDefault,CFSTR(PLUGIN_ID));
|
||||
result = AllocQuickLookGeneratorPluginType(uuid);
|
||||
CFRelease(uuid);
|
||||
return result;
|
||||
}
|
||||
/* If the requested type is incorrect, return NULL. */
|
||||
return NULL;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user