Initial commit (version 0.2.1)

1 files changed, 85 insertions, 0 deletions

@@ -0,0 +1,85 @@
+//
+//  FontManager.h
+//  FontLabel
+//
+//  Created by Kevin Ballard on 5/5/09.
+//  Copyright © 2009 Zynga Game Networks
+//
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+#import <Foundation/Foundation.h>
+#import <CoreGraphics/CoreGraphics.h>
+
+@class ZFont;
+
+@interface FontManager : NSObject {
+        CFMutableDictionaryRef fonts;
+        NSMutableDictionary *urls;
+}
++ (FontManager *)sharedManager;
+/*!
+    @method     
+    @abstract   Loads a TTF font from the main bundle
+        @param filename The name of the font file to load (with or without extension).
+        @return YES if the font was loaded, NO if an error occurred
+    @discussion If the font has already been loaded, this method does nothing and returns YES.
+                                This method first attempts to load the font by appending .ttf to the filename.
+                                If that file does not exist, it tries the filename exactly as given.
+*/
+- (BOOL)loadFont:(NSString *)filename;
+/*!
+        @method
+        @abstract       Loads a font from the given file URL
+        @param url A file URL that points to a font file
+        @return YES if the font was loaded, NO if an error occurred
+        @discussion If the font has already been loaded, this method does nothing and returns YES.
+*/
+- (BOOL)loadFontURL:(NSURL *)url;
+/*!
+    @method     
+    @abstract   Returns the loaded font with the given filename
+        @param filename The name of the font file that was given to -loadFont:
+        @return A CGFontRef, or NULL if the specified font cannot be found
+    @discussion If the font has not been loaded yet, -loadFont: will be
+                called with the given name first.
+*/
+- (CGFontRef)fontWithName:(NSString *)filename __AVAILABILITY_INTERNAL_DEPRECATED;
+/*!
+        @method
+        @abstract       Returns a ZFont object corresponding to the loaded font with the given filename and point size
+        @param filename The name of the font file that was given to -loadFont:
+        @param pointSize The point size of the font
+        @return A ZFont, or NULL if the specified font cannot be found
+        @discussion If the font has not been loaded yet, -loadFont: will be
+                                called with the given name first.
+*/
+- (ZFont *)zFontWithName:(NSString *)filename pointSize:(CGFloat)pointSize;
+/*!
+        @method
+        @abstract       Returns a ZFont object corresponding to the loaded font with the given file URL and point size
+        @param url A file URL that points to a font file
+        @param pointSize The point size of the font
+        @return A ZFont, or NULL if the specified font cannot be loaded
+        @discussion If the font has not been loaded yet, -loadFontURL: will be called with the given URL first.
+*/
+- (ZFont *)zFontWithURL:(NSURL *)url pointSize:(CGFloat)pointSize;
+/*!
+        @method
+        @abstract   Returns a CFArrayRef of all loaded CGFont objects
+        @return A CFArrayRef of all loaded CGFont objects
+        @description You are responsible for releasing the CFArrayRef
+*/
+- (CFArrayRef)copyAllFonts;
+@end