/* NSAttributedString.m Categories which add capabilities to NSAttributedString Copyright (C) 1999 Free Software Foundation, Inc. Author: Richard Frith-Macdonald Date: July 1999 Modifications: Fred Kiefer Date: June 2000 This file is part of the GNUstep GUI Library. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ #include #include #include #include #include // For the colour name spaces #include #include #include #include "Parsers/rtfConsumer.h" #include "Parsers/RTFProducer.h" /* Cache class pointers to avoid the expensive lookup by string. */ static Class dictionaryClass = nil; static Class stringClass = nil; /* A character set containing characters that separate words. */ static NSCharacterSet *wordBreakCSet = nil; /* A character set containing characters that are legal within words. */ static NSCharacterSet *wordCSet = nil; /* A String containing the attachment character */ static NSString *attachmentString = nil; /* This function initializes all the previous cached values. */ static void cache_init_real () { NSMutableCharacterSet *m; NSCharacterSet *cset; unichar ch = NSAttachmentCharacter; /* Initializes Class pointer cache */ dictionaryClass = [NSDictionary class]; stringClass = [NSString class]; /* Initializes wordBreakCSet */ m = [NSMutableCharacterSet new]; cset = [NSCharacterSet whitespaceAndNewlineCharacterSet]; [m formUnionWithCharacterSet: cset]; cset = [NSCharacterSet punctuationCharacterSet]; [m formUnionWithCharacterSet: cset]; cset = [NSCharacterSet controlCharacterSet]; [m formUnionWithCharacterSet: cset]; cset = [NSCharacterSet illegalCharacterSet]; [m formUnionWithCharacterSet: cset]; wordBreakCSet = [m copy]; RELEASE (m); /* Initializes wordCSet */ wordCSet = [[wordBreakCSet invertedSet] copy]; /* Initializes attachmentString */ attachmentString = [stringClass stringWithCharacters: &ch length: 1]; RETAIN (attachmentString); } /* This inline function calls cache_init_real () the first time it is invoked, and does nothing afterwards. Thus we get both speed (cache_init is inlined and only compares a pointer to nil when the cache has been initialized) and limit memory consumption (we are not copying everywhere the real initialization code, which is in cache_real_init (), which is not inlined.).*/ static inline void cache_init () { if (dictionaryClass == nil) { cache_init_real (); } } @implementation NSAttributedString (AppKit) + (NSAttributedString *) attributedStringWithAttachment: (NSTextAttachment *)attachment { NSDictionary *attributes; cache_init (); attributes = [dictionaryClass dictionaryWithObject: attachment forKey: NSAttachmentAttributeName]; return AUTORELEASE ([[self alloc] initWithString: attachmentString attributes: attributes]); } - (BOOL) containsAttachments { NSRange aRange; cache_init (); aRange = [[self string] rangeOfString: attachmentString]; if (aRange.length > 0) { return YES; } else { return NO; } } - (NSDictionary *) fontAttributesInRange: (NSRange)range { NSDictionary *all; static SEL sel = 0; IMP objForKey; id objects[8]; id keys[8]; int count = 0; if (NSMaxRange(range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -fontAttributesInRange:"]; } all = [self attributesAtIndex: range.location effectiveRange: &range]; if (sel == 0) { sel = @selector (objectForKey:); } objForKey = [all methodForSelector: sel]; #define NSATT_GET_ATTRIBUTE(attribute) \ keys[count] = attribute; \ objects[count] = (*objForKey) (all, sel, keys[count]); \ if (objects[count] != nil) count++; NSATT_GET_ATTRIBUTE (NSFontAttributeName); NSATT_GET_ATTRIBUTE (NSForegroundColorAttributeName); NSATT_GET_ATTRIBUTE (NSBackgroundColorAttributeName); NSATT_GET_ATTRIBUTE (NSUnderlineStyleAttributeName); NSATT_GET_ATTRIBUTE (NSSuperscriptAttributeName); NSATT_GET_ATTRIBUTE (NSBaselineOffsetAttributeName); NSATT_GET_ATTRIBUTE (NSKernAttributeName); NSATT_GET_ATTRIBUTE (NSLigatureAttributeName); #undef NSATT_GET_ATTRIBUTE cache_init (); return [dictionaryClass dictionaryWithObjects: objects forKeys: keys count: count]; } - (NSDictionary*) rulerAttributesInRange: (NSRange)range { id style; cache_init (); if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -rulerAttributesInRange:"]; } style = [self attribute: NSParagraphStyleAttributeName atIndex: range.location effectiveRange: &range]; if (style != nil) { return [dictionaryClass dictionaryWithObject: style forKey: NSParagraphStyleAttributeName]; } return [dictionaryClass dictionary]; } - (unsigned) lineBreakBeforeIndex: (unsigned)location withinRange: (NSRange)aRange { NSString *str = [self string]; unsigned length = [str length]; NSRange scanRange; NSRange startRange; cache_init (); if (NSMaxRange (aRange) > length || location > length) { [NSException raise: NSRangeException format: @"RangeError in method -lineBreakBeforeIndex:withinRange:"]; } if (!NSLocationInRange (location, aRange)) { return NSNotFound; } scanRange = NSMakeRange (aRange.location, location - aRange.location); startRange = [str rangeOfCharacterFromSet: wordBreakCSet options: NSBackwardsSearch | NSLiteralSearch range: scanRange]; if (startRange.length == 0) { return NSNotFound; } else { return NSMaxRange (startRange); } } - (NSRange) doubleClickAtIndex: (unsigned)location { NSString *str = [self string]; unsigned length = [str length]; NSRange scanRange; NSRange startRange; NSRange endRange; cache_init (); if (location > length) { [NSException raise: NSRangeException format: @"RangeError in method -doubleClickAtIndex:"]; } scanRange = NSMakeRange (0, location); startRange = [str rangeOfCharacterFromSet: wordBreakCSet options: NSBackwardsSearch|NSLiteralSearch range: scanRange]; scanRange = NSMakeRange (location, length - location); endRange = [str rangeOfCharacterFromSet: wordBreakCSet options: NSLiteralSearch range: scanRange]; if (startRange.length == 0) { location = 0; } else { location = NSMaxRange (startRange); } if (endRange.length == 0) { length = length - location; } else { length = endRange.location - location; } return NSMakeRange (location, length); } - (unsigned) nextWordFromIndex: (unsigned)location forward: (BOOL)isForward { NSString *str = [self string]; unsigned length = [str length]; NSRange range; if (location > length) { [NSException raise: NSRangeException format: @"RangeError in method -nextWordFromIndex:forward:"]; } cache_init (); if (isForward) { range = NSMakeRange (location, length - location); range = [str rangeOfCharacterFromSet: wordBreakCSet options: NSLiteralSearch range: range]; if (range.length == 0) { return length; } range = NSMakeRange (range.location, length - range.location); range = [str rangeOfCharacterFromSet: wordCSet options: NSLiteralSearch range: range]; if (range.length == 0) { return length; } return range.location; } else { BOOL inWord; inWord = [wordCSet characterIsMember: [str characterAtIndex: location]]; range = NSMakeRange (0, location); if (!inWord) { range = [str rangeOfCharacterFromSet: wordCSet options: NSBackwardsSearch | NSLiteralSearch range: range]; if (range.length == 0) { return 0; } range = NSMakeRange (0, range.location); } range = [str rangeOfCharacterFromSet: wordBreakCSet options: NSBackwardsSearch | NSLiteralSearch range: range]; if (range.length == 0) { return 0; } return NSMaxRange (range); } } - (id) initWithPath: (NSString *)path documentAttributes: (NSDictionary **)dict { // FIXME: This expects the file to be RTFD NSFileWrapper *fw; fw = [[NSFileWrapper alloc] initWithPath: path]; AUTORELEASE (fw); return [self initWithRTFDFileWrapper: fw documentAttributes: dict]; } - (id) initWithURL: (NSURL *)url documentAttributes: (NSDictionary **)dict { NSData *data = [url resourceDataUsingCache: YES]; // FIXME: This expects the URL to point to a HTML page return [self initWithHTML: data baseURL: [url baseURL] documentAttributes: dict]; } - (id) initWithRTFDFileWrapper: (NSFileWrapper *)wrapper documentAttributes: (NSDictionary **)dict { NSAttributedString *new = [RTFConsumer parseRTFD: wrapper documentAttributes: dict]; // We do not return self but the newly created object RELEASE (self); return RETAIN (new); } - (id) initWithRTFD: (NSData*)data documentAttributes: (NSDictionary**)dict { NSFileWrapper *wrapper = [[NSFileWrapper alloc] initWithSerializedRepresentation: data]; NSAttributedString *new = [RTFConsumer parseRTFD: wrapper documentAttributes: dict]; // We do not return self but the newly created object RELEASE (self); RELEASE (wrapper); return RETAIN (new); } - (id) initWithRTF: (NSData *)data documentAttributes: (NSDictionary **)dict { NSAttributedString *new = [RTFConsumer parseRTF: data documentAttributes: dict]; // We do not return self but the newly created object RELEASE (self); return RETAIN (new); } - (id) initWithHTML: (NSData *)data documentAttributes: (NSDictionary **)dict { return [self initWithHTML: data baseURL: nil documentAttributes: dict]; } - (id) initWithHTML: (NSData *)data baseURL: (NSURL *)base documentAttributes: (NSDictionary **)dict { // FIXME: Not implemented return self; } - (NSData *) RTFFromRange: (NSRange)range documentAttributes: (NSDictionary *)dict { return [RTFProducer produceRTF: [self attributedSubstringFromRange: range] documentAttributes: dict]; } - (NSData *) RTFDFromRange: (NSRange)range documentAttributes: (NSDictionary *)dict { return [[RTFProducer produceRTFD: [self attributedSubstringFromRange: range] documentAttributes: dict] serializedRepresentation]; } - (NSFileWrapper *) RTFDFileWrapperFromRange: (NSRange)range documentAttributes: (NSDictionary *)dict { return [RTFProducer produceRTFD: [self attributedSubstringFromRange: range] documentAttributes: dict]; } @end @implementation NSMutableAttributedString (AppKit) - (void) superscriptRange: (NSRange)range { id value; int sValue; NSRange effRange; if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -superscriptRange:"]; } // We take the value from the first character and use it for the whole range value = [self attribute: NSSuperscriptAttributeName atIndex: range.location effectiveRange: &effRange]; if (value != nil) { sValue = [value intValue] + 1; } else { sValue = 1; } [self addAttribute: NSSuperscriptAttributeName value: [NSNumber numberWithInt: sValue] range: range]; } - (void) subscriptRange: (NSRange)range { id value; int sValue; NSRange effRange; if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -subscriptRange:"]; } // We take the value form the first character and use it for the whole range value = [self attribute: NSSuperscriptAttributeName atIndex: range.location effectiveRange: &effRange]; if (value != nil) { sValue = [value intValue] - 1; } else { sValue = -1; } [self addAttribute: NSSuperscriptAttributeName value: [NSNumber numberWithInt: sValue] range: range]; } - (void) unscriptRange: (NSRange)range { if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -unscriptRange:"]; } [self addAttribute: NSSuperscriptAttributeName value: [NSNumber numberWithInt: 0] range: range]; } - (void) applyFontTraits: (NSFontTraitMask)traitMask range: (NSRange)range { NSFont *font; unsigned loc = range.location; NSRange effRange; NSFontManager *fm = [NSFontManager sharedFontManager]; if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -applyFontTraits:range:"]; } while (loc < NSMaxRange (range)) { font = [self attribute: NSFontAttributeName atIndex: loc effectiveRange: &effRange]; if (font != nil && [fm traitsOfFont: font] != traitMask) { font = [fm fontWithFamily: [font familyName] traits: traitMask weight: [fm weightOfFont: font] size: [font pointSize]]; if (font != nil) { [self addAttribute: NSFontAttributeName value: font range: NSIntersectionRange (effRange, range)]; } } loc = NSMaxRange(effRange); } } - (void) setAlignment: (NSTextAlignment)alignment range: (NSRange)range { id value; unsigned loc = range.location; if (NSMaxRange(range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -setAlignment:range:"]; } while (loc < NSMaxRange(range)) { BOOL copiedStyle = NO; NSRange effRange; NSRange newRange; value = [self attribute: NSParagraphStyleAttributeName atIndex: loc effectiveRange: &effRange]; newRange = NSIntersectionRange (effRange, range); if (value == nil) { value = [NSMutableParagraphStyle defaultParagraphStyle]; } else { value = [value mutableCopy]; copiedStyle = YES; } [value setAlignment: alignment]; [self addAttribute: NSParagraphStyleAttributeName value: value range: newRange]; if (copiedStyle == YES) { RELEASE(value); } loc = NSMaxRange (effRange); } } - (void) fixAttributesInRange: (NSRange)range { [self fixFontAttributeInRange: range]; [self fixParagraphStyleAttributeInRange: range]; [self fixAttachmentAttributeInRange: range]; } - (void) fixFontAttributeInRange: (NSRange)range { if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -fixFontAttributeInRange:"]; } // FIXME: Should check for each character if it is supported by the // assigned font } - (void) fixParagraphStyleAttributeInRange: (NSRange)range { NSString *str = [self string]; unsigned loc = range.location; NSRange r; if (NSMaxRange (range) > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -fixParagraphStyleAttributeInRange:"]; } while (loc < NSMaxRange (range)) { NSParagraphStyle *style; NSRange found; unsigned end; // Extend loc to take in entire paragraph if necessary. r = [str lineRangeForRange: NSMakeRange (loc, 1)]; end = NSMaxRange (r); // get the style in effect at the paragraph start. style = [self attribute: NSParagraphStyleAttributeName atIndex: r.location longestEffectiveRange: &found inRange: r]; if (style != nil && NSMaxRange (found) < end) { // Styles differ - add the old style to the remainder of the range. found.location = NSMaxRange (found); found.length = end - found.location; [self addAttribute: NSParagraphStyleAttributeName value: style range: found]; loc = end; } else loc = NSMaxRange (found); } } - (void) fixAttachmentAttributeInRange: (NSRange)aRange { NSString *string = [self string]; unsigned location = aRange.location; unsigned end = NSMaxRange (aRange); cache_init (); if (end > [self length]) { [NSException raise: NSRangeException format: @"RangeError in method -fixAttachmentAttributeInRange:"]; } // Check for attachments with the wrong character while (location < end) { NSDictionary *attr; NSRange range; attr = [self attributesAtIndex: location effectiveRange: &range]; if ([attr objectForKey: NSAttachmentAttributeName] != nil) { unichar buf[range.length]; unsigned pos = 0; unsigned start = range.location; // Leave only one character with the attachment [string getCharacters: buf range: range]; while (pos < range.length && buf[pos] != NSAttachmentCharacter) pos++; if (pos) [self removeAttribute: NSAttachmentAttributeName range: NSMakeRange (start, pos)]; pos++; if (pos < range.length) [self removeAttribute: NSAttachmentAttributeName range: NSMakeRange (start + pos, range.length - pos)]; } location = NSMaxRange (range); } // Check for attachment characters without attachments location = aRange.location; while (location < end) { NSRange range = [string rangeOfString: attachmentString options: NSLiteralSearch range: NSMakeRange (location, end - location)]; NSTextAttachment *attachment; if (!range.length) break; attachment = [self attribute: NSAttachmentAttributeName atIndex: range.location effectiveRange: NULL]; if (attachment == nil) { [self deleteCharactersInRange: NSMakeRange (range.location, 1)]; range.length--; } location = NSMaxRange (range); } } - (void)updateAttachmentsFromPath:(NSString *)path { NSString *string = [self string]; unsigned location = 0; unsigned end = [string length]; cache_init (); while (location < end) { NSRange range = [string rangeOfString: attachmentString options: NSLiteralSearch range: NSMakeRange (location, end - location)]; NSTextAttachment *attachment; NSFileWrapper *fileWrapper; if (!range.length) break; attachment = [self attribute: NSAttachmentAttributeName atIndex: range.location effectiveRange: NULL]; fileWrapper = [attachment fileWrapper]; // FIXME: Is this the correct thing to do? [fileWrapper updateFromPath: [path stringByAppendingPathComponent: [fileWrapper filename]]]; location = NSMaxRange (range); } } @end