rubyquartz 0.1.2

data/ext/text.c

@@ -0,0 +1,258 @@
+/*
+ * Copyright (c) 2006, The Omni Group. All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1.  Redistributions of source code must retain the above copyright
+ *     notice, this list of conditions and the following disclaimer. 
+ * 2.  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. 
+ * 3.  Neither the name of The Omni Group ("Omni") 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 OMNI AND ITS 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 OMNI OR ITS 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.
+ */ 
+
+#include "text.h"
+
+#include "font.h"
+#include "color.h"
+
+#import <Cocoa/Cocoa.h>
+
+VALUE text_class;
+
+static void _text_clear(Text *text)
+{
+	NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
+	@try {
+		[text->storage removeLayoutManager:text->layoutManager];
+		[text->storage release];
+		text->storage = nil;
+
+		[text->container release];
+		text->container = nil;
+	
+		[text->layoutManager release];
+		text->layoutManager = nil;
+	} @catch (NSException *exc) {
+		NSLog(@"%s -- %@", __PRETTY_FUNCTION__, exc);
+	} @finally {
+		[pool release];
+	}
+}
+
+Text *text_get(VALUE self)
+{
+	// TODO: Subclassability?
+	if (CLASS_OF(self) != text_class)
+		rb_raise(rb_eArgError, "Argument must be a Text");
+
+	Text *text;
+	Data_Get_Struct(self, Text, text);
+	
+	if (!text)
+		rb_raise(rb_eArgError, "No data specified for Text!");
+
+	return text;
+}
+
+static void _text_free(Text *text)
+{
+	if (text) {
+		_text_clear(text);
+		free(text);
+	}
+}
+
+static VALUE _text_alloc(VALUE klass)
+{
+	Text *text = calloc(1, sizeof(*text));
+	return Data_Wrap_Struct(klass, NULL, _text_free, text);
+}
+
+VALUE text_initialize(VALUE self, VALUE string, VALUE font, VALUE color, VALUE alignment)
+{
+	Text *text = text_get(self);
+	NSFont *f = NIL_P(font) ? nil : font_get(font);
+	CGColorRef c = NIL_P(color) ? nil : color_get(color);
+	CFStringRef str = _copy_string_for_str(string);
+	NSTextAlignment align = NUM2UINT(alignment);
+	
+	// Should already be clear...
+	_text_clear(text);
+	
+	NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
+	@try {
+		NSMutableDictionary *attributes = [[NSMutableDictionary alloc] init];
+		if (f)
+			[attributes setObject:f forKey:NSFontAttributeName];
+		if (c) {
+			NSColor *wrapper = color_create_wrapper(c);
+			[attributes setObject:wrapper forKey:NSForegroundColorAttributeName]; // TODO: Are CGColorRef and NSColor bridged?
+			[wrapper release];
+		}
+		
+		NSMutableParagraphStyle *pgStyle = [[NSParagraphStyle defaultParagraphStyle] mutableCopy];
+		[pgStyle setAlignment:align];
+		[attributes setObject:pgStyle forKey:NSParagraphStyleAttributeName];
+		[pgStyle release];
+		
+		text->layoutManager = [[NSLayoutManager alloc] init];
+		[text->layoutManager setBackgroundLayoutEnabled:NO];
+		
+		text->container = [[NSTextContainer alloc] initWithContainerSize:NSMakeSize(1e9, 1e9)];  // TODO: Warn if you try to draw with an 'infinite' width using center or right alignment?
+		[text->container setLineFragmentPadding:0.0f];
+		
+		[text->layoutManager addTextContainer:text->container];
+		
+		text->storage = [[NSTextStorage alloc] initWithString:(NSString *)str attributes:attributes];
+		[attributes release];
+
+		[text->storage addLayoutManager:text->layoutManager];
+		
+		return self;
+	} @catch (NSException *exc) {
+		NSLog(@"%s -- %@", __PRETTY_FUNCTION__, exc);
+	} @finally {
+		[pool release];
+	}
+	rb_raise(rb_eArgError, "Unable to create Text");
+}
+
+static VALUE text_layout_width(VALUE self)
+{
+	Text *text = text_get(self);
+	return rb_float_new([text->container containerSize].width);
+}
+
+static VALUE text_set_layout_width(VALUE self, VALUE width)
+{
+	Text *text = text_get(self);
+	NSSize size = [text->container containerSize];
+	size.width = NUM2DBL(width);
+	[text->container setContainerSize:size];
+	return self;
+}
+
+static VALUE text_height_used(VALUE self)
+{
+	Text *text = text_get(self);
+
+	NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
+	@try {
+		NSLayoutManager *layoutManager = text->layoutManager;
+	
+		float totalHeight = 0.0;
+	    unsigned int glyphCount = [layoutManager numberOfGlyphs];
+	    if (glyphCount > 0) {
+			// forces layout
+		    [layoutManager lineFragmentRectForGlyphAtIndex:glyphCount-1 effectiveRange:NULL];
+
+		    NSTextContainer *textContainer;
+		    NSArray *textContainers = [layoutManager textContainers];
+		    unsigned int tcIndex, tcCount = [textContainers count];
+		    for (tcIndex = 0; tcIndex < tcCount - 1; tcIndex++) {
+		        textContainer = [textContainers objectAtIndex:tcIndex];
+		        NSSize containerSize = [textContainer containerSize];
+		        totalHeight += containerSize.height;
+		    }
+
+		    textContainer = [textContainers lastObject];
+		    NSRect usedRect = [layoutManager usedRectForTextContainer:textContainer];
+		    totalHeight += usedRect.size.height;
+		}
+	    return rb_float_new(totalHeight);
+	} @catch (NSException *exc) {
+		NSLog(@"%s -- %@", __PRETTY_FUNCTION__, exc);
+	} @finally {
+		[pool release];
+	}
+	rb_raise(rb_eException, "Unable to determine text height");
+	return self;
+}
+
+static VALUE text_width_used(VALUE self)
+{
+	Text *text = text_get(self);
+    NSTextStorage *textStorage = text->storage;
+	NSLayoutManager *layoutManager = text->layoutManager;
+	
+	NSAutoreleasePool *pool = [[NSAutoreleasePool alloc] init];
+	@try {
+	    float maximumLineLength = 0.0f;
+	    unsigned int characterCount = [textStorage length];
+	    if (characterCount > 0) {
+		    NSRange glyphRange = [layoutManager glyphRangeForCharacterRange:(NSRange){0, characterCount} actualCharacterRange:NULL];
+		    if (glyphRange.length > 0) {
+			    unsigned int glyphLocation = glyphRange.location;
+			    unsigned int glyphEnd = glyphRange.location + glyphRange.length;
+
+			    while (glyphLocation < glyphEnd) {
+			        // The line fragment rect isn't what we want (if text is right aligned, it will span the width of the line from the left edge of the text container).  We want the glyph bounds...
+			        NSRange lineGlyphRange;
+			        [layoutManager lineFragmentRectForGlyphAtIndex:glyphLocation effectiveRange:&lineGlyphRange];
+
+			        // Look at the last character of the given line.  If it is a line breaking character, don't include it in the measurements.  Otherwise, the glyph bounds will extend to the end of the text container.
+			        NSRange lineCharRange = [layoutManager characterRangeForGlyphRange:lineGlyphRange actualGlyphRange:NULL];
+			        NSRange clippedGlyphRange = lineGlyphRange;
+			        if (lineCharRange.length) {
+			            unichar c = [[textStorage string] characterAtIndex:lineCharRange.location + lineCharRange.length - 1];
+			            if (c == '\n' || c == '\r') { // Other Unicode newline characters?
+			                // Shorten the character range and get the new glyph range
+			                lineCharRange.length--;
+			                clippedGlyphRange = [layoutManager glyphRangeForCharacterRange:lineCharRange actualCharacterRange:NULL];
+			            }
+			        }
+			        if (!clippedGlyphRange.length) {
+				    // Only a newline in this line; still need the update to glyphLocation below, though or we hang as in #20274
+				} else {
+				    NSTextContainer *container = [layoutManager textContainerForGlyphAtIndex:glyphLocation effectiveRange:NULL];
+    
+				    NSRect glyphBounds = [layoutManager boundingRectForGlyphRange:clippedGlyphRange inTextContainer:container];
+    
+				    //NSLog(@"glyphRange = %@, lineFrag = %@, glyphBounds = %@", NSStringFromRange(clippedGlyphRange), NSStringFromRect(lineFrag), NSStringFromRect(glyphBounds));
+    
+				    maximumLineLength = MAX(glyphBounds.size.width, maximumLineLength);
+				}
+
+			        // Step by the unclipped glyph range or we'll go into an infinite loop when we chop off a newline
+			        glyphLocation = lineGlyphRange.location + lineGlyphRange.length;
+			    }
+			}
+		}
+
+	    return rb_float_new(maximumLineLength);
+	} @catch (NSException *exc) {
+		NSLog(@"%s -- %@", __PRETTY_FUNCTION__, exc);
+	} @finally {
+		[pool release];
+	}
+	rb_raise(rb_eException, "Unable to determine text width");
+	return self;
+}
+
+void Init_text(void)
+{
+	text_class = rb_define_class_under(module, "Text", rb_cObject);	
+	rb_define_alloc_func(text_class, _text_alloc);
+	
+	rb_define_private_method(text_class, "_initialize", text_initialize, 4);
+	rb_define_method(text_class, "layout_width", text_layout_width, 0);
+	rb_define_method(text_class, "layout_width=", text_set_layout_width, 1);
+	rb_define_method(text_class, "height_used", text_height_used, 0);
+	rb_define_method(text_class, "width_used", text_width_used, 0);
+}

data/ext/text.h

@@ -0,0 +1,39 @@
+/*
+Copyright (c) 2006, The Omni Group, Inc. All rights reserved.
+
+OPEN PERMISSION TO USE AND REPRODUCE OMNI SOURCE CODE SOFTWARE
+
+Omni Source Code software is available from The Omni Group on their web
+site at www.omnigroup.com.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+Any original copyright notices and this permission notice shall be included 
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+*/ 
+
+
+@class NSTextStorage, NSTextContainer, NSLayoutManager;
+
+typedef struct {
+	NSTextStorage *storage;
+	NSTextContainer *container;
+	NSLayoutManager *layoutManager;
+} Text;
+
+extern void Init_text(void);
+extern VALUE text_class;
+extern Text *text_get(VALUE self);

data/ext/utilities.c

@@ -0,0 +1,181 @@
+/*
+Copyright (c) 2006, The Omni Group, Inc. All rights reserved.
+
+OPEN PERMISSION TO USE AND REPRODUCE OMNI SOURCE CODE SOFTWARE
+
+Omni Source Code software is available from The Omni Group on their web
+site at www.omnigroup.com.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+Any original copyright notices and this permission notice shall be included 
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+*/ 
+
+
+#include "utilities.h"
+
+#import <Foundation/NSObject.h>
+#import <objc/objc-runtime.h>
+
+VALUE _symbol_for_string(CFStringRef str)
+{
+	CFDataRef utf8 = CFStringCreateExternalRepresentation(kCFAllocatorDefault, str, kCFStringEncodingUTF8, '?');
+	CFIndex utf8Length = CFDataGetLength(utf8);
+	char *utf8Bytes = malloc(utf8Length + 1);
+	memcpy(utf8Bytes, CFDataGetBytePtr(utf8) , utf8Length);
+	utf8Bytes[utf8Length] = '\0';
+	CFRelease(utf8);
+	
+	VALUE symbol = ID2SYM(rb_intern(utf8Bytes));
+	free(utf8Bytes);
+	
+	return symbol;
+}
+
+CFStringRef _copy_string_for_str(VALUE str)
+{
+	// TODO: Unicode?
+	const unsigned char *s = (const unsigned char *)StringValueCStr(str);
+	return CFStringCreateWithBytes(kCFAllocatorDefault, s, strlen((const char *)s), kCFStringEncodingUTF8, false/*isExternalRepresentation*/);
+}
+
+VALUE _value_for_string(CFStringRef str)
+{
+	// TODO: Unicode?
+	// TODO: Check for conversion failure and raise
+	CFDataRef data = CFStringCreateExternalRepresentation(kCFAllocatorDefault, str, kCFStringEncodingUTF8, 0);
+
+	VALUE value = rb_str_new((char *)CFDataGetBytePtr(data), CFDataGetLength(data));
+	
+	if (data)
+		CFRelease(data);
+		
+	return value;
+}
+
+CFURLRef _create_url_for_path(VALUE path)
+{
+	const char *pathCString = StringValueCStr(path); // checks type
+
+	// TODO: Test non-ASCII path 
+	CFStringRef pathString = CFStringCreateWithCString(kCFAllocatorDefault, pathCString, kCFStringEncodingUTF8);
+	CFURLRef url = CFURLCreateWithFileSystemPath(kCFAllocatorDefault, pathString, kCFURLPOSIXPathStyle, false/*isDirectory*/);
+	CFRelease(pathString);
+	
+	if (!url)
+		rb_raise(rb_eException, "Unable to create URL from given path");
+	return url;
+}
+
+CFDataRef _create_data_from_string(VALUE value, Boolean copy)
+{
+	value = rb_str_to_str(value);
+	struct RString *str = RSTRING(value);
+	
+	if (copy)
+		return CFDataCreate(kCFAllocatorDefault, (const UInt8 *)str->ptr, str->len);
+	else
+		return CFDataCreateWithBytesNoCopy(kCFAllocatorDefault, (const UInt8 *)str->ptr, str->len, NULL);
+}
+
+// Common alloc/free handlers for CFType-wrapping classes
+static void _cftype_free(CFTypeRef *cf)
+{
+	if (cf) {
+		if (*cf)
+			CFRelease(*cf);
+		free(cf);
+	}
+}
+
+VALUE _cftype_alloc(VALUE klass)
+{
+	CFTypeRef *cf = calloc(1, sizeof(*cf));
+	return Data_Wrap_Struct(klass, NULL, _cftype_free, cf);
+}
+
+// Doesn't allow NULL to be returned since callers depend on this for ease of use
+CFTypeRef _cftype_get(VALUE self, CFTypeID typeID, const char *typeName)
+{
+	CFTypeRef *cf;
+	Data_Get_Struct(self, CFTypeRef, cf);
+	
+	if (!cf)
+		rb_raise(rb_eArgError, "No data specified for CFType holder!");
+		
+	CFTypeRef result = *cf;
+	if (!result)
+		rb_raise(rb_eArgError, "No %s wrapped in %s", typeName, rb_obj_classname(self));
+		
+	if (CFGetTypeID(result) != typeID)
+		rb_raise(rb_eArgError, "%s is wrapping something other than a %s, type id is %d but should be %d", rb_obj_classname(self), typeName, CFGetTypeID(result), typeID);
+	return result;
+}
+
+void _cftype_set(VALUE self, CFTypeID typeID, const char *typeName, CFTypeRef value)
+{
+	if (value && (CFGetTypeID(value) != typeID))
+		rb_raise(rb_eArgError, "Attempt to set a non-%s value on a %s, type id is %d but should be %d", typeName, rb_obj_classname(self), CFGetTypeID(value), typeID);
+
+	CFTypeRef *cf;
+	Data_Get_Struct(self, CFTypeRef, cf);
+	
+	if (!cf)
+		rb_raise(rb_eArgError, "No data specified for CFType holder!");
+		
+	if (*cf)
+		CFRelease(*cf);
+	*cf = value;
+	if (value)
+		CFRetain(value);
+}
+
+// Doesn't allow nil to be returned since callers depend on this for ease of use
+id _objc_type_get(VALUE self, Class cls)
+{
+	id *obj;
+	Data_Get_Struct(self, id, obj);
+	
+	if (!obj)
+		rb_raise(rb_eArgError, "No data specified for object holder!");
+		
+	id result = *obj;
+	if (!result)
+		rb_raise(rb_eArgError, "No %s wrapped in %s", cls->name, rb_obj_classname(self));
+
+	if (![result isKindOfClass:cls])
+		rb_raise(rb_eArgError, "%s is wrapping something other than a %s", rb_obj_classname(self), cls->name);
+	return result;
+}
+
+void _objc_type_set(VALUE self, Class cls, id value)
+{
+	if (value && ![value isKindOfClass:cls])
+		rb_raise(rb_eArgError, "Attempt to set a non-%s value on a %s", cls->name, rb_obj_classname(self));
+
+	id *obj;
+	Data_Get_Struct(self, id, obj);
+	
+	if (!obj)
+		rb_raise(rb_eArgError, "No data specified for object holder!");
+		
+	if (*obj)
+		[*obj release];
+	*obj = value;
+	if (value)
+		[value retain];
+}