OOColor Class Reference

#include <OOColor.h>

Inheritance diagram for OOColor:

Collaboration diagram for OOColor:

Instance Methods
(OOColor *)	- blendedColorWithFraction:ofColor:
(float)	- redComponent
(float)	- greenComponent
(float)	- blueComponent
(void)	- getRed:green:blue:alpha:
(OORGBAComponents)	- rgbaComponents
(BOOL)	- isBlack
(BOOL)	- isWhite
(float)	- hueComponent
(float)	- saturationComponent
(float)	- brightnessComponent
(void)	- getHue:saturation:brightness:alpha:
(OOHSBAComponents)	- hsbaComponents
(float)	- alphaComponent
(OOColor *)	- premultipliedColor
(OOColor *)	- colorWithBrightnessFactor:
(NSArray *)	- normalizedArray
(NSString *)	- rgbaDescription
(NSString *)	- hsbaDescription
(void)	- setRed:green:blue:alpha: [implementation]
(void)	- setHue:saturation:brightness:alpha: [implementation]
(id)	- copyWithZone: [implementation]
(NSString *)	- descriptionComponents [implementation]
(NSColor *)	- asNSColor

Class Methods
(OOColor *)	+ colorWithHue:saturation:brightness:alpha:
(OOColor *)	+ colorWithRed:green:blue:alpha:
(OOColor *)	+ colorWithWhite:alpha:
(OOColor *)	+ colorWithRGBAComponents:
(OOColor *)	+ colorWithHSBAComponents:
(OOColor *)	+ colorWithDescription:
(OOColor *)	+ brightColorWithDescription:
(OOColor *)	+ colorWithDescription:saturationFactor:
(OOColor *)	+ colorFromString:
(OOColor *)	+ blackColor
(OOColor *)	+ darkGrayColor
(OOColor *)	+ lightGrayColor
(OOColor *)	+ whiteColor
(OOColor *)	+ grayColor
(OOColor *)	+ redColor
(OOColor *)	+ greenColor
(OOColor *)	+ blueColor
(OOColor *)	+ cyanColor
(OOColor *)	+ yellowColor
(OOColor *)	+ magentaColor
(OOColor *)	+ orangeColor
(OOColor *)	+ purpleColor
(OOColor *)	+ brownColor
(OOColor *)	+ clearColor

Private Attributes
float	rgba [4]

Detailed Description

Definition at line 44 of file OOColor.h.

Method Documentation

alphaComponent

- (float) alphaComponent

Definition at line 486 of file OOColor.m.

{
    return rgba[3];
}

References alphaComponent, and rgba.

Referenced by AddMacroColorIfAppropriate(), alphaComponent, HeadUpDisplay(Private)::drawDirectionCue:, fillSquareImageDataWithCloudTexture(), HeadUpDisplay::hudDrawReticleOnTarget, OOBasicMaterial::setAmbientColor:, OOBasicMaterial::setDiffuseColor:, OOBasicMaterial::setEmissionColor:, OOBasicMaterial::setSpecularColor:, and OOSunEntity::setSunColor:.

Here is the call graph for this function:

Here is the caller graph for this function:

asNSColor

- (NSColor *) asNSColor

Provided by category OOColor(NSColorConversion).

Definition at line 35 of file OODebugUtilities.m.

{
    float r, g, b, a;
    [self getRed:&r green:&g blue:&b alpha:&a];
    return [NSColor colorWithDeviceRed:r green:g blue:b alpha:a];
}

Referenced by NSColor(OOColorConversion)::colorWithOOColorDescription:.

Here is the caller graph for this function:

blackColor

+ (OOColor *) blackColor

Definition at line 238 of file OOColor.m.

{
    return [OOColor colorWithWhite:0.0f alpha:1.0f];
}

References blackColor, and colorWithWhite:alpha:.

Referenced by blackColor, and GuiDisplayGen(Internal)::drawGLDisplay:x:y:z:.

Here is the call graph for this function:

Here is the caller graph for this function:

blendedColorWithFraction:ofColor:

- (OOColor *) blendedColorWithFraction:		(float)	fraction
ofColor:		(OOColor *)	color

Definition at line 328 of file OOColor.m.

                                      :(float)fraction ofColor:(OOColor *)color
{
    float   rgba1[4];
    [color getRed:&rgba1[0] green:&rgba1[1] blue:&rgba1[2] alpha:&rgba1[3]];
    
    OOColor *result = [[OOColor alloc] init];
    [result setRed:OOLerp(rgba[0], rgba1[0], fraction)
             green:OOLerp(rgba[1], rgba1[1], fraction)
              blue:OOLerp(rgba[2], rgba1[2], fraction)
             alpha:OOLerp(rgba[3], rgba1[3], fraction)];
    
    return [result autorelease];
}

References getRed:green:blue:alpha:, and setRed:green:blue:alpha:.

Referenced by SkyEntity::initWithColors:col1:andSystemInfo:, SaturatedColorInRange(), OOSunEntity::setSunColor:, Universe::setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, Universe::setUpSpace, and OOSkyDrawable(OOPrivate)::setUpStarsWithColor1:color2:.

Here is the call graph for this function:

Here is the caller graph for this function:

blueColor

+ (OOColor *) blueColor

Definition at line 280 of file OOColor.m.

{
    return [OOColor colorWithRed:0.0f green:0.0f blue:1.0f alpha:1.0f];
}

References blueColor, and colorWithRed:green:blue:alpha:.

Referenced by blueColor, OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, and GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:.

Here is the call graph for this function:

Here is the caller graph for this function:

blueComponent

- (float) blueComponent

Definition at line 362 of file OOColor.m.

{
    return rgba[2];
}

References blueComponent, and rgba.

Referenced by AddMacroColorIfAppropriate(), blueComponent, HeadUpDisplay(Private)::drawDirectionCue:, HeadUpDisplay(Private)::drawSurround:, fillSquareImageDataWithCloudTexture(), FloatRGBFromDictColor(), HeadUpDisplay::hudDrawReticleOnTarget, PlanetEntity::initFromDictionary:withAtmosphere:andSeed:, OOBasicMaterial::setAmbientColor:, OOLaserShotEntity::setColor:, OOBasicMaterial::setDiffuseColor:, OOBasicMaterial::setEmissionColor:, OOBasicMaterial::setSpecularColor:, OOSunEntity::setSunColor:, and PlanetEntity(OOPrivate)::setTextureColorForPlanet:inSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

brightColorWithDescription:

+ (OOColor *) brightColorWithDescription:

(id)

description

Definition at line 205 of file OOColor.m.

                                        :(id)description
{
    OOColor *color = [OOColor colorWithDescription:description];
    if (color == nil || 0.5f <= [color brightnessComponent])  return color;
    
    return [OOColor colorWithHue:[color hueComponent] / 360.0f saturation:[color saturationComponent] brightness:0.5f alpha:1.0f];
}

References brightnessComponent, colorWithDescription:, colorWithHue:saturation:brightness:alpha:, hueComponent, nil, and saturationComponent.

Referenced by Universe::setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, and OOEquipmentType::weaponColor.

Here is the call graph for this function:

Here is the caller graph for this function:

brightnessComponent

- (float) brightnessComponent

Definition at line 432 of file OOColor.m.

{
    float maxrgb = (rgba[0] > rgba[1])? ((rgba[0] > rgba[2])? rgba[0]:rgba[2]):((rgba[1] > rgba[2])? rgba[1]:rgba[2]);
    return maxrgb;
}

References brightnessComponent, and rgba.

Referenced by brightColorWithDescription:, and brightnessComponent.

Here is the call graph for this function:

Here is the caller graph for this function:

brownColor

+ (OOColor *) brownColor

Definition at line 316 of file OOColor.m.

{
    return [OOColor colorWithRed:0.6f green:0.4f blue:0.2f alpha:1.0f];
}

References brownColor, and colorWithRed:green:blue:alpha:.

Referenced by brownColor, and OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:.

Here is the call graph for this function:

Here is the caller graph for this function:

clearColor

+ (OOColor *) clearColor

Definition at line 322 of file OOColor.m.

{
    return [OOColor colorWithWhite:0.0f alpha:0.0f];
}

References clearColor, and colorWithWhite:alpha:.

Referenced by clearColor.

Here is the call graph for this function:

Here is the caller graph for this function:

colorFromString:

+ (OOColor *) colorFromString:

(NSString*)

colorFloatString

Definition at line 214 of file OOColor.m.

                             :(NSString*) colorFloatString
{
    float           rgbaValue[4] = { 0.0f, 0.0f, 0.0f, 1.0f };
    NSScanner       *scanner = [NSScanner scannerWithString:colorFloatString];
    float           factor = 1.0f;
    int             i;
    
    for (i = 0; i != 4; ++i)
    {
        if (![scanner scanFloat:&rgbaValue[i]])
        {
            // Less than three floats or non-float, can't parse -> quit
            if (i < 3) return nil;
            
            // If we get here, we only got three components. Make sure alpha is at correct scale:
            rgbaValue[3] /= factor;
        }
        if (1.0f < rgbaValue[i]) factor = 1.0f / 255.0f;
    }
    
    return [OOColor colorWithRed:rgbaValue[0] * factor green:rgbaValue[1] * factor blue:rgbaValue[2] * factor alpha:rgbaValue[3] * factor];
}

References colorWithRed:green:blue:alpha:, and nil.

Referenced by colorWithDescription:saturationFactor:, HeadUpDisplay(Private)::resetGui:withInfo:, and HeadUpDisplay::resetGuis:.

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithBrightnessFactor:

- (OOColor *) colorWithBrightnessFactor:

(float)

factor

Definition at line 502 of file OOColor.m.

                                       :(float)factor
{
    return [OOColor colorWithRed:OOClamp_0_1_f(rgba[0] * factor)
                           green:OOClamp_0_1_f(rgba[1] * factor)
                            blue:OOClamp_0_1_f(rgba[2] * factor)
                           alpha:rgba[3]];
}

References colorWithRed:green:blue:alpha:.

Referenced by OOSkyDrawable(OOPrivate)::setUpNebulaeWithColor1:color2:clusterFactor:nebulaHueFix:alpha:scale:.

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithDescription:

+ (OOColor *) colorWithDescription:

(id)

description

Definition at line 127 of file OOColor.m.

                                  :(id)description
{
    return [self colorWithDescription:description saturationFactor:1.0f];
}

References colorWithDescription:saturationFactor:.

Referenced by brightColorWithDescription:, CanonicalizeMaterialSpecifier(), SkyEntity::changeProperty:withDictionary:, GuiDisplayGen::colorFromSetting:defaultValue:, NSColor(OOColorConversion)::colorWithOOColorDescription:, PlayerEntity::dialCustomColor:, GuiDisplayGen(Internal)::drawAdvancedNavArrayAtX:y:z:alpha:usingRoute:optimizedBy:zoom:, HeadUpDisplay(Private)::drawMultiFunctionDisplay:withText:asIndex:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, HeadUpDisplay(Private)::drawSurround:, GuiDisplayGen(Internal)::drawSystemMarker:atX:andY:andZ:withAlpha:andScale:, EquipmentInfoSetProperty(), FlasherSetProperty(), FloatRGBFromDictColor(), GetRGBAArrayFromInfo(), GlobalSetGuiColorSettingForKey(), PlanetEntity(OOPrivate)::initAsAtmosphereForPlanet:dictionary:, SkyEntity::initWithColors:col1:andSystemInfo:, HeadUpDisplay::initWithDictionary:inFile:, OOEquipmentType(Private)::initWithInfo:, OOBasicMaterial::initWithName:configuration:, OODebugMonitor(Private)::normalizeConfigValue:forKey:, PlayerEntity::noteGUIDidChangeFrom:to:refresh:, NSDictionary(OOMateralProperties)::oo_ambientColor, NSDictionary(OOMateralProperties)::oo_diffuseColor, NSDictionary(OOMateralProperties)::oo_emissionColor, NSDictionary(OOMateralProperties)::oo_emissionModulateColor, NSDictionary(OOMateralProperties)::oo_illuminationModulateColor, NSDictionary(OOMateralProperties)::oo_specularColor, NSDictionary(OOMateralProperties)::oo_specularModulateColor, PlanetSetProperty(), PlayerShipSetProperty(), SkyEntity(OOPrivate)::readColor1:andColor2:andColor3:andColor4:fromDictionary:, HeadUpDisplay::resetGuis:, SetGLColourFromInfo(), PlayerEntity(Scripting)::setMissionChoicesDictionary:, OOVisualEffectEntity::setScannerDisplayColor1:, ShipEntity::setScannerDisplayColor1:, OOVisualEffectEntity::setScannerDisplayColor2:, ShipEntity::setScannerDisplayColor2:, ShipEntity::setScannerDisplayColorHostile1:, ShipEntity::setScannerDisplayColorHostile2:, Universe::setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, Universe::setUpBreakPattern:orientation:forDocking:, Universe::setUpSettings, Universe::setUpSpace, ShipSetProperty(), OOShipRegistry(OODataLoader)::validateNewStyleFlasherDeclaration:forShip:fatalError:, and VisualEffectSetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithDescription:saturationFactor:

+ (OOColor *) colorWithDescription:		(id)	description
saturationFactor:		(float)	factor

Definition at line 133 of file OOColor.m.

                                  :(id)description saturationFactor:(float)factor
{
    NSDictionary            *dict = nil;
    OOColor                 *result = nil;
    
    if (description == nil) return nil;
    
    if ([description isKindOfClass:[OOColor class]])
    {
        result = [[description copy] autorelease];
    }
    else if ([description isKindOfClass:[NSString class]])
    {
        if ([description hasSuffix:@"Color"])
        {
            // +fooColor selector
            SEL selector = NSSelectorFromString(description);
            if ([self respondsToSelector:selector])  result = [self performSelector:selector];
        }
        else
        {
            // Some other string
            result = [self colorFromString:description];
        }
    }
    else if ([description isKindOfClass:[NSArray class]])
    {
        result = [self colorFromString:[description componentsJoinedByString:@" "]];
    }
    else if ([description isKindOfClass:[NSDictionary class]])
    {
        dict = description; // Workaround for gnu-gcc's more agressive "multiple methods named..." warnings.
        
        if ([dict objectForKey:@"hue"] != nil)
        {
            // Treat as HSB(A) dictionary
            float h = [dict oo_floatForKey:@"hue"];
            float s = [dict oo_floatForKey:@"saturation" defaultValue:1.0f];
            float b = [dict oo_floatForKey:@"brightness" defaultValue:-1.0f];
            if (b < 0.0f)  b = [dict oo_floatForKey:@"value" defaultValue:1.0f];
            float a = [dict oo_floatForKey:@"alpha" defaultValue:-1.0f];
            if (a < 0.0f)  a = [dict oo_floatForKey:@"opacity" defaultValue:1.0f];
            
            // Not "result =", because we handle the saturation scaling here to allow oversaturation.
            return [OOColor colorWithHue:h / 360.0f saturation:s * factor brightness:b alpha:a];
        }
        else
        {
            // Treat as RGB(A) dictionary
            float r = [dict oo_floatForKey:@"red"];
            float g = [dict oo_floatForKey:@"green"];
            float b = [dict oo_floatForKey:@"blue"];
            float a = [dict oo_floatForKey:@"alpha" defaultValue:-1.0f];
            if (a < 0.0f)  a = [dict oo_floatForKey:@"opacity" defaultValue:1.0f];
            
            result = [OOColor colorWithRed:r green:g blue:b alpha:a];
        }
    }
    
    if (factor != 1.0f && result != nil)
    {
        float h, s, b, a;
        [result getHue:&h saturation:&s brightness:&b alpha:&a];
        h *= 1.0 / 360.0f;  // See note in header.
        s *= factor;
        result = [self colorWithHue:h saturation:s brightness:b alpha:a];
    }
    
    return result;
}

References colorFromString:, colorWithHue:saturation:brightness:alpha:, colorWithRed:green:blue:alpha:, getHue:saturation:brightness:alpha:, and nil.

Referenced by colorWithDescription:, and OOFlasherEntity(Internal)::setUpColors:.

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithHSBAComponents:

+ (OOColor *) colorWithHSBAComponents:

(OOHSBAComponents)

components

Definition at line 118 of file OOColor.m.

                                     :(OOHSBAComponents)components
{
    return [self colorWithHue:components.h / 360.0f
                   saturation:components.s
                   brightness:components.b
                        alpha:components.a];
}

References colorWithHue:saturation:brightness:alpha:.

Here is the call graph for this function:

colorWithHue:saturation:brightness:alpha:

+ (OOColor *) colorWithHue:		(float)	hue
saturation:		(float)	saturation
brightness:		(float)	brightness
alpha:		(float)	alpha

Definition at line 87 of file OOColor.m.

                          :(float)hue saturation:(float)saturation brightness:(float)brightness alpha:(float)alpha
{
    OOColor* result = [[OOColor alloc] init];
    [result setHue:360.0f * hue saturation:saturation brightness:brightness alpha:alpha];
    return [result autorelease];
}

References setHue:saturation:brightness:alpha:.

Referenced by brightColorWithDescription:, colorWithDescription:saturationFactor:, colorWithHSBAComponents:, PlanetEntity::initFromDictionary:withAtmosphere:andSeed:, SaturatedColorInRange(), ShipEntity::setCommsMessageColor, OOSunEntity::setSunColor:, PlanetEntity(OOPrivate)::setTextureColorForPlanet:inSystem:, Universe::setUpSpace, and ShipEntity::throwSparks.

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithRed:green:blue:alpha:

+ (OOColor *) colorWithRed:		(float)	red
green:		(float)	green
blue:		(float)	blue
alpha:		(float)	alpha

Definition at line 95 of file OOColor.m.

                          :(float)red green:(float)green blue:(float)blue alpha:(float)alpha
{
    OOColor* result = [[OOColor alloc] init];
    [result setRed:red green:green blue:blue alpha:alpha];
    return [result autorelease];
}

References setRed:green:blue:alpha:.

Referenced by OOBasicMaterial::ambientColor, NSColor(OOColorConversion)::asOOColor, blueColor, brownColor, OOFlasherEntity::color, colorFromString:, colorWithBrightnessFactor:, colorWithDescription:saturationFactor:, colorWithRGBAComponents:, colorWithWhite:alpha:, cyanColor, OOBasicMaterial::diffuseColor, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, Universe::drawUniverse, OOBasicMaterial::emmisionColor, greenColor, DustEntity::init, Entity::init, PlanetEntity(OOPrivate)::initAsAtmosphereForPlanet:dictionary:, magentaColor, HeadUpDisplay::OODrawPlanetInfo, orangeColor, premultipliedColor, purpleColor, SkyEntity(OOPrivate)::readColor1:andColor2:andColor3:andColor4:fromDictionary:, redColor, HeadUpDisplay::resetGuis:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, OOSunEntity::setSunColor:, Universe::setUpBreakPattern:orientation:forDocking:, Universe::setUpWitchspaceBetweenSystem:andSystem:, OOBasicMaterial::specularColor, and yellowColor.

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithRGBAComponents:

+ (OOColor *) colorWithRGBAComponents:

(OORGBAComponents)

components

Definition at line 109 of file OOColor.m.

                                     :(OORGBAComponents)components
{
    return [self colorWithRed:components.r
                        green:components.g
                         blue:components.b
                        alpha:components.a];
}

References colorWithRed:green:blue:alpha:.

Referenced by ModulateColor().

Here is the call graph for this function:

Here is the caller graph for this function:

colorWithWhite:alpha:

+ (OOColor *) colorWithWhite:		(float)	white
alpha:		(float)	alpha

Definition at line 103 of file OOColor.m.

                            :(float)white alpha:(float)alpha
{
    return [OOColor colorWithRed:white green:white blue:white alpha:alpha];
}

References colorWithRed:green:blue:alpha:.

Referenced by blackColor, clearColor, darkGrayColor, GuiDisplayGen(Internal)::drawAdvancedNavArrayAtX:y:z:alpha:usingRoute:optimizedBy:zoom:, GuiDisplayGen(Internal)::drawGLDisplay:x:y:z:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, grayColor, lightGrayColor, NSDictionary(OOMateralProperties)::oo_specularColor, and whiteColor.

Here is the call graph for this function:

Here is the caller graph for this function:

copyWithZone:

- (id) copyWithZone: (NSZone *) zone

implementation

Definition at line 80 of file OOColor.m.

                   :(NSZone *)zone
{
    // Copy is implemented as retain since OOColor is immutable.
    return [self retain];
}

cyanColor

+ (OOColor *) cyanColor

Definition at line 286 of file OOColor.m.

{
    return [OOColor colorWithRed:0.0f green:1.0f blue:1.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and cyanColor.

Referenced by OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, cyanColor, PlayerEntity(StickMapperInternal)::displayFunctionList:skip:, PlayerEntity(KeyMapperInternal)::displayKeyFunctionList:skip:, GuiDisplayGen(Internal)::drawAdvancedNavArrayAtX:y:z:alpha:usingRoute:optimizedBy:zoom:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, PlayerEntity(KeyMapper)::handleKeyConfigEntryKeys:view:, HeadUpDisplay::initWithDictionary:inFile:, PlayerEntity(Scripting)::refreshMissionScreenTextEntry, OOOXZManager::refreshTextInput:, PlayerEntity(LoadSave)::saveCommanderInputHandler, ShipEntity::setCommsMessageColor, PlayerEntity::setGuiToChartScreenFrom:, PlayerEntity(KeyMapper)::setGuiToKeyConfigEntryScreen, and PlayerEntity(OOLoadSavePrivate)::setGuiToSaveCommanderScreen:.

Here is the call graph for this function:

Here is the caller graph for this function:

darkGrayColor

+ (OOColor *) darkGrayColor

Definition at line 244 of file OOColor.m.

{
    return [OOColor colorWithWhite:1.0f/3.0f alpha:1.0f];
}

References colorWithWhite:alpha:, and darkGrayColor.

Referenced by darkGrayColor, PlayerEntity(Contracts)::setGuiToManifestScreen, and PlayerEntity(Scripting)::setMissionChoicesDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

descriptionComponents

- (NSString *) descriptionComponents

implementation

Definition at line 343 of file OOColor.m.

{
    return [NSString stringWithFormat:@"%g, %g, %g, %g", rgba[0], rgba[1], rgba[2], rgba[3]];
}

References descriptionComponents.

Referenced by descriptionComponents.

Here is the call graph for this function:

Here is the caller graph for this function:

getHue:saturation:brightness:alpha:

- (void) getHue:		(float *)	hue
saturation:		(float *)	saturation
brightness:		(float *)	brightness
alpha:		(float *)	alpha

Definition at line 438 of file OOColor.m.

               :(float *)hue saturation:(float *)saturation brightness:(float *)brightness alpha:(float *)alpha
{
    NSParameterAssert(hue != NULL && saturation != NULL && brightness != NULL && alpha != NULL);
    
    *alpha = rgba[3];
    
    float fRed = rgba[0], fGreen = rgba[1], fBlue = rgba[2];
    float maxrgb = fmax(fRed, fmax(fGreen, fBlue));
    float minrgb = fmin(fRed, fmin(fGreen, fBlue));
    float delta = maxrgb - minrgb + 0.0001f;
    float h = 0.0f;
    if (maxrgb == fRed && fGreen >= fBlue)
    {
        h = 60.0f * (fGreen - fBlue) / delta;
    }
    else if (maxrgb == fRed && fGreen < fBlue)
    {
        h = 60.0f * (fGreen - fBlue) / delta + 360.0f;
    }
    else if (maxrgb == fGreen)
    {
        h = 60.0f * (fBlue - fRed) / delta + 120.0f;
    }
    else if (maxrgb == fBlue)
    {
        h = 60.0f * (fRed - fGreen) / delta + 240.0f;
    }
    
    float s = (maxrgb == 0.0f) ? 0.0f : (1.0f - (minrgb / maxrgb));
    
    *hue = h;
    *saturation = s;
    *brightness = maxrgb;
}

References rgba.

Referenced by colorWithDescription:saturationFactor:, hsbaComponents, SaturatedColorInRange(), and OOSunEntity::setSunColor:.

Here is the caller graph for this function:

getRed:green:blue:alpha:

- (void) getRed:		(float *)	red
green:		(float *)	green
blue:		(float *)	blue
alpha:		(float *)	alpha

Definition at line 368 of file OOColor.m.

               :(float *)red green:(float *)green blue:(float *)blue alpha:(float *)alpha
{
    NSParameterAssert(red != NULL && green != NULL && blue != NULL && alpha != NULL);
    
    *red = rgba[0];
    *green = rgba[1];
    *blue = rgba[2];
    *alpha = rgba[3];
}

References rgba.

Referenced by ApplyColor(), OOColor(NSColorConversion)::asNSColor, blendedColorWithFraction:ofColor:, GuiDisplayGen(Internal)::drawAdvancedNavArrayAtX:y:z:alpha:usingRoute:optimizedBy:zoom:, HeadUpDisplay(Private)::drawCustomLight:, HeadUpDisplay(Private)::drawMultiFunctionDisplay:withText:asIndex:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, GetRGBAArrayFromInfo(), PlanetEntity(OOPrivate)::initAsAtmosphereForPlanet:dictionary:, OOSparkEntity::initWithPosition:velocity:duration:size:color:, normalizedArray, OOVisualEffectEntity::scannerDisplayColorForShip:flash:scannerDisplayColor1:, ShipEntity::scannerDisplayColorForShip:otherShip:isHostile:flash:scannerDisplayColor1:scannerDisplayColor2:scannerDisplayColorH1:, OOLightParticleEntity::setColor:, DustEntity::setDustColor:, GuiDisplayGen::setGLColorFromSetting:defaultValue:alpha:, SetGLColourFromInfo(), OOBreakPatternEntity::setInnerColor:outerColor:, Universe::setLighting, OOSunEntity::setSunColor:, OOCrosshairs(Private)::setUpDataWithPoints:scale:color:overallAlpha:, OOExhaustPlumeEntity::update:, OODefaultShaderSynthesizer::writeDiffuseColorTermIfNeeded, and OODefaultShaderSynthesizer::writeSpecularLighting.

Here is the caller graph for this function:

grayColor

+ (OOColor *) grayColor

Definition at line 262 of file OOColor.m.

{
    return [OOColor colorWithWhite:0.5f alpha:1.0f];
}

References colorWithWhite:alpha:, and grayColor.

Referenced by OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, grayColor, OOOXZManager::gui, PlayerEntity::setGuiToGameOptionsScreen, PlayerEntity::setGuiToLoadSaveScreen, and PlayerEntity::setupStartScreenGui.

Here is the call graph for this function:

Here is the caller graph for this function:

greenColor

+ (OOColor *) greenColor

Definition at line 274 of file OOColor.m.

{
    return [OOColor colorWithRed:0.0f green:1.0f blue:0.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and greenColor.

Referenced by PlayerEntity(Contracts)::buySelectedShip, PlayerEntity(StickMapperInternal)::displayFunctionList:skip:, PlayerEntity(KeyMapperInternal)::displayKeyboardLayoutList:skip:, PlayerEntity(KeyMapperInternal)::displayKeyFunctionList:skip:, GuiDisplayGen(Internal)::drawEquipmentList:z:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, greenColor, OOOXZManager::gui, HeadUpDisplay::hudDrawReticleOnTarget, HeadUpDisplay::initWithDictionary:inFile:, GuiDisplayGen::initWithPixelSize:columns:rows:rowHeight:rowStart:title:, PlayerEntity(OOLoadSavePrivate)::lsCommanders:directory:pageNumber:highlightName:, OOOXZManager::processShowInfoKey, HeadUpDisplay::resetGuis:, GuiDisplayGen::resizeTo:characterHeight:title:, ShipEntity::setCommsMessageColor, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setGuiToInterfacesScreen:, PlayerEntity(KeyMapper)::setGuiToKeyConfigScreen:, PlayerEntity(Contracts)::setGuiToManifestScreen, PlayerEntity::setGuiToMarketScreen, PlayerEntity(LoadSave)::setGuiToScenarioScreen:, PlayerEntity(Contracts)::setGuiToShipyardScreen:, PlayerEntity::setGuiToSystemDataScreenRefreshBackground:, Universe(OOPrivate)::setLibraryTextForDemoShip, PlayerEntity::showInformationForSelectedInterface, PlayerEntity::showInformationForSelectedUpgradeWithFormatString:, OOOXZManager::showInstallOptions, PlayerEntity(OOPrivate)::showMarketScreenHeaders, OOOXZManager::showRemoveOptions, and PlayerEntity(Contracts)::showShipyardInfoForSelection.

Here is the call graph for this function:

Here is the caller graph for this function:

greenComponent

- (float) greenComponent

Definition at line 356 of file OOColor.m.

{
    return rgba[1];
}

References greenComponent, and rgba.

Referenced by AddMacroColorIfAppropriate(), HeadUpDisplay(Private)::drawDirectionCue:, HeadUpDisplay(Private)::drawSurround:, fillSquareImageDataWithCloudTexture(), FloatRGBFromDictColor(), greenComponent, HeadUpDisplay::hudDrawReticleOnTarget, PlanetEntity::initFromDictionary:withAtmosphere:andSeed:, OOBasicMaterial::setAmbientColor:, OOLaserShotEntity::setColor:, OOBasicMaterial::setDiffuseColor:, OOBasicMaterial::setEmissionColor:, OOBasicMaterial::setSpecularColor:, OOSunEntity::setSunColor:, and PlanetEntity(OOPrivate)::setTextureColorForPlanet:inSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

hsbaComponents

- (OOHSBAComponents) hsbaComponents

Definition at line 474 of file OOColor.m.

{
    OOHSBAComponents c;
    [self getHue:&c.h
      saturation:&c.s
      brightness:&c.b
           alpha:&c.a];
    return c;
}

References getHue:saturation:brightness:alpha:, and hsbaComponents.

Referenced by hsbaComponents, and hsbaDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

hsbaDescription

- (NSString *) hsbaDescription

Definition at line 530 of file OOColor.m.

{
    return OOHSBAComponentsDescription([self hsbaComponents]);
}

References hsbaComponents, hsbaDescription, and OOHSBAComponentsDescription().

Referenced by hsbaDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

hueComponent

- (float) hueComponent

Definition at line 399 of file OOColor.m.

{
    float maxrgb = (rgba[0] > rgba[1])? ((rgba[0] > rgba[2])? rgba[0]:rgba[2]):((rgba[1] > rgba[2])? rgba[1]:rgba[2]);
    float minrgb = (rgba[0] < rgba[1])? ((rgba[0] < rgba[2])? rgba[0]:rgba[2]):((rgba[1] < rgba[2])? rgba[1]:rgba[2]);
    float delta = maxrgb - minrgb + 0.0001f;
    float fRed = rgba[0], fGreen = rgba[1], fBlue = rgba[2];
    float hue = 0.0f;
    if (maxrgb == fRed && fGreen >= fBlue)
    {
        hue = 60.0f * (fGreen - fBlue) / delta;
    }
    else if (maxrgb == fRed && fGreen < fBlue)
    {
        hue = 60.0f * (fGreen - fBlue) / delta + 360.0f;
    }
    else if (maxrgb == fGreen)
    {
        hue = 60.0f * (fBlue - fRed) / delta + 120.0f;
    }
    else if (maxrgb == fBlue)
    {
        hue = 60.0f * (fRed - fGreen) / delta + 240.0f;
    }
    return hue;
}

References hueComponent, and rgba.

Referenced by brightColorWithDescription:, and hueComponent.

Here is the call graph for this function:

Here is the caller graph for this function:

isBlack

- (BOOL) isBlack

Definition at line 386 of file OOColor.m.

{
    return rgba[0] == 0.0f && rgba[1] == 0.0f && rgba[2] == 0.0f;
}

References isBlack, and rgba.

Referenced by isBlack.

Here is the call graph for this function:

Here is the caller graph for this function:

isWhite

- (BOOL) isWhite

Definition at line 392 of file OOColor.m.

{
    return rgba[0] == 1.0f && rgba[1] == 1.0f && rgba[2] == 1.0f && rgba[3] == 1.0f;
}

References isWhite, and rgba.

Referenced by isWhite.

Here is the call graph for this function:

Here is the caller graph for this function:

lightGrayColor

+ (OOColor *) lightGrayColor

Definition at line 250 of file OOColor.m.

{
    return [OOColor colorWithWhite:2.0f/3.0f alpha:1.0f];
}

References colorWithWhite:alpha:, and lightGrayColor.

Referenced by ApplyColor(), and lightGrayColor.

Here is the call graph for this function:

Here is the caller graph for this function:

magentaColor

+ (OOColor *) magentaColor

Definition at line 298 of file OOColor.m.

{
    return [OOColor colorWithRed:1.0f green:0.0f blue:1.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and magentaColor.

Referenced by magentaColor, PlayerEntity::setGuiToIntroFirstGo:, and StickProfileScreen(StickProfileInternal)::showScreen.

Here is the call graph for this function:

Here is the caller graph for this function:

normalizedArray

- (NSArray *) normalizedArray

Definition at line 511 of file OOColor.m.

{
    float r, g, b, a;
    [self getRed:&r green:&g blue:&b alpha:&a];
    return [NSArray arrayWithObjects:
        [NSNumber numberWithFloat:r],
        [NSNumber numberWithFloat:g],
        [NSNumber numberWithFloat:b],
        [NSNumber numberWithFloat:a],
        nil];
}

References getRed:green:blue:alpha:, and normalizedArray.

Referenced by AddColorIfAppropriate(), CanonicalizeMaterialSpecifier(), EquipmentInfoGetProperty(), FlasherGetProperty(), OODebugMonitor(Private)::normalizeConfigValue:forKey:, normalizedArray, PlayerShipGetProperty(), ShipGetProperty(), SynthSpecular(), OOShipRegistry(OODataLoader)::validateNewStyleFlasherDeclaration:forShip:fatalError:, and VisualEffectGetProperty().

Here is the call graph for this function:

Here is the caller graph for this function:

orangeColor

+ (OOColor *) orangeColor

Definition at line 304 of file OOColor.m.

{
    return [OOColor colorWithRed:1.0f green:0.5f blue:0.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and orangeColor.

Referenced by OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, PlayerEntity(KeyMapperInternal)::displayKeyFunctionList:skip:, GuiDisplayGen(Internal)::drawEquipmentList:z:, OOOXZManager::gui, PlayerEntity(OOLoadSavePrivate)::lsCommanders:directory:pageNumber:highlightName:, orangeColor, OOOXZManager::refreshTextInput:, PlayerEntity::setGuiToEquipShipScreen:selectingFacingFor:, PlayerEntity::setGuiToIntroFirstGo:, PlayerEntity(KeyMapper)::setGuiToKeyConfigScreen:, and PlayerEntity(OOLoadSavePrivate)::showCommanderShip:.

Here is the call graph for this function:

Here is the caller graph for this function:

premultipliedColor

- (OOColor *) premultipliedColor

Definition at line 492 of file OOColor.m.

{
    if (rgba[3] == 1.0f)  return [[self retain] autorelease];
    return [OOColor colorWithRed:rgba[0] * rgba[3]
                           green:rgba[1] * rgba[3]
                            blue:rgba[2] * rgba[3]
                           alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, premultipliedColor, and rgba.

Referenced by premultipliedColor, and SkyEntity(OOPrivate)::readColor1:andColor2:andColor3:andColor4:fromDictionary:.

Here is the call graph for this function:

Here is the caller graph for this function:

purpleColor

+ (OOColor *) purpleColor

Definition at line 310 of file OOColor.m.

{
    return [OOColor colorWithRed:0.5f green:0.0f blue:0.5f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and purpleColor.

Referenced by purpleColor.

Here is the call graph for this function:

Here is the caller graph for this function:

redColor

+ (OOColor *) redColor

Definition at line 268 of file OOColor.m.

{
    return [OOColor colorWithRed:1.0f green:0.0f blue:0.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and redColor.

Referenced by OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, GuiDisplayGen(Internal)::drawGLDisplay:x:y:z:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, HeadUpDisplay::hudDrawReticleOnTarget, HeadUpDisplay::initWithDictionary:inFile:, OOPlasmaBurstEntity::initWithPosition:, PlayerEntity(OOLoadSavePrivate)::lsCommanders:directory:pageNumber:highlightName:, redColor, PlayerEntity::setGuiToIntroFirstGo:, PlayerEntity(KeyMapper)::setGuiToKeyMapperScreen:resetCurrentRow:, and PlayerEntity(LoadSave)::setGuiToScenarioScreen:.

Here is the call graph for this function:

Here is the caller graph for this function:

redComponent

- (float) redComponent

Definition at line 350 of file OOColor.m.

{
    return rgba[0];
}

References redComponent, and rgba.

Referenced by AddMacroColorIfAppropriate(), HeadUpDisplay(Private)::drawDirectionCue:, HeadUpDisplay(Private)::drawSurround:, fillSquareImageDataWithCloudTexture(), FloatRGBFromDictColor(), HeadUpDisplay::hudDrawReticleOnTarget, PlanetEntity::initFromDictionary:withAtmosphere:andSeed:, redComponent, OOBasicMaterial::setAmbientColor:, OOLaserShotEntity::setColor:, OOBasicMaterial::setDiffuseColor:, OOBasicMaterial::setEmissionColor:, OOBasicMaterial::setSpecularColor:, OOSunEntity::setSunColor:, and PlanetEntity(OOPrivate)::setTextureColorForPlanet:inSystem:.

Here is the call graph for this function:

Here is the caller graph for this function:

rgbaComponents

- (OORGBAComponents) rgbaComponents

Definition at line 379 of file OOColor.m.

{
    OORGBAComponents c = { rgba[0], rgba[1], rgba[2], rgba[3] };
    return c;
}

References rgba, and rgbaComponents.

Referenced by GuiDisplayGen(Internal)::drawSystemMarker:atX:andY:andZ:withAlpha:andScale:, GuiDisplayGen::getLastLines, ModulateColor(), rgbaComponents, and rgbaDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

rgbaDescription

- (NSString *) rgbaDescription

Definition at line 524 of file OOColor.m.

{
    return OORGBAComponentsDescription([self rgbaComponents]);
}

References OORGBAComponentsDescription(), rgbaComponents, and rgbaDescription.

Referenced by OOCombinedEmissionMapGenerator::descriptionComponents, and rgbaDescription.

Here is the call graph for this function:

Here is the caller graph for this function:

saturationComponent

- (float) saturationComponent

Definition at line 425 of file OOColor.m.

{
    float maxrgb = (rgba[0] > rgba[1])? ((rgba[0] > rgba[2])? rgba[0]:rgba[2]):((rgba[1] > rgba[2])? rgba[1]:rgba[2]);
    float minrgb = (rgba[0] < rgba[1])? ((rgba[0] < rgba[2])? rgba[0]:rgba[2]):((rgba[1] < rgba[2])? rgba[1]:rgba[2]);
    return maxrgb == 0.0f ? 0.0f : (1.0f - (minrgb / maxrgb));
}

References rgba, and saturationComponent.

Referenced by brightColorWithDescription:, and saturationComponent.

Here is the call graph for this function:

Here is the caller graph for this function:

setHue:saturation:brightness:alpha:

- (void) setHue: (float) h saturation: (float) s brightness: (float) b alpha: (float) a

implementation

Definition at line 42 of file OOColor.m.

               :(float)h saturation:(float)s brightness:(float)b alpha:(float)a
{
    rgba[3] = a;
    if (s == 0.0f)
    {
        rgba[0] = rgba[1] = rgba[2] = b;
        return;
    }
    float f, p, q, t;
    int i;
    h = fmod(h, 360.0f);
    if (h < 0.0) h += 360.0f;
    h /= 60.0f;
    
    i = floor(h);
    f = h - i;
    p = b * (1.0f - s);
    q = b * (1.0f - (s * f));
    t = b * (1.0f - (s * (1.0f - f)));
    
    switch (i)
    {
        case 0:
            rgba[0] = b;    rgba[1] = t;    rgba[2] = p;    break;
        case 1:
            rgba[0] = q;    rgba[1] = b;    rgba[2] = p;    break;
        case 2:
            rgba[0] = p;    rgba[1] = b;    rgba[2] = t;    break;
        case 3:
            rgba[0] = p;    rgba[1] = q;    rgba[2] = b;    break;
        case 4:
            rgba[0] = t;    rgba[1] = p;    rgba[2] = b;    break;
        case 5:
            rgba[0] = b;    rgba[1] = p;    rgba[2] = q;    break;
    }
}

References rgba.

Referenced by colorWithHue:saturation:brightness:alpha:.

Here is the caller graph for this function:

setRed:green:blue:alpha:

- (void) setRed: (float) r green: (float) g blue: (float) b alpha: (float) a

implementation

Definition at line 33 of file OOColor.m.

               :(float)r green:(float)g blue:(float)b alpha:(float)a
{
    rgba[0] = r;
    rgba[1] = g;
    rgba[2] = b;
    rgba[3] = a;
}

References rgba.

Referenced by blendedColorWithFraction:ofColor:, and colorWithRed:green:blue:alpha:.

Here is the caller graph for this function:

whiteColor

+ (OOColor *) whiteColor

Definition at line 256 of file OOColor.m.

{
    return [OOColor colorWithWhite:1.0f alpha:1.0f];
}

References colorWithWhite:alpha:, and whiteColor.

Referenced by OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, NSDictionary(OOMateralProperties)::oo_specularModulateColor, Universe::resetCommsLogColor, HeadUpDisplay::resetGuis:, Universe(OOPrivate)::setLibraryTextForDemoShip, OOSunEntity::setSunColor:, Universe::setSystemDataForGalaxy:planet:key:value:fromManifest:forLayer:, Universe::setUpSpace, PlayerEntity::setupStartScreenGui, Universe::setUpUniverseFromWitchspace, whiteColor, and OODefaultShaderSynthesizer::writeDiffuseColorTermIfNeeded.

Here is the call graph for this function:

Here is the caller graph for this function:

yellowColor

+ (OOColor *) yellowColor

Definition at line 292 of file OOColor.m.

{
    return [OOColor colorWithRed:1.0f green:1.0f blue:0.0f alpha:1.0f];
}

References colorWithRed:green:blue:alpha:, and yellowColor.

Referenced by Universe::clearGUIs, OOOXZManager(NSURLConnectionDataDelegate)::colorForManifest:, GuiDisplayGen(Internal)::drawAdvancedNavArrayAtX:y:z:alpha:usingRoute:optimizedBy:zoom:, GuiDisplayGen(Internal)::drawStarChart:x:y:z:alpha:, GuiDisplayGen::init, GuiDisplayGen::initWithPixelSize:columns:rows:rowHeight:rowStart:title:, PlayerEntity(OOLoadSavePrivate)::lsCommanders:directory:pageNumber:highlightName:, HeadUpDisplay::resetGuis:, PlayerEntity::setGuiToIntroFirstGo:, PlayerEntity(KeyMapper)::setGuiToKeyMapperScreen:resetCurrentRow:, PlayerEntity::setGuiToMarketScreen, PlayerEntity(Scripting)::setGuiToMissionScreenWithCallback:, Universe(OOPrivate)::setLibraryTextForDemoShip, PlayerEntity(Scripting)::setMissionChoicesDictionary:, GuiDisplayGen::setTextColor:, GuiDisplayGen::setTextCommsColor:, PlayerEntity::setupStartScreenGui, PlayerEntity(OOPrivate)::showMarketCashAndLoadLine, StickProfileScreen(StickProfileInternal)::showScreen, and yellowColor.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

rgba

- (float rgba[4])

private

Definition at line 48 of file OOColor.h.

Referenced by alphaComponent, blueComponent, brightnessComponent, getHue:saturation:brightness:alpha:, getRed:green:blue:alpha:, greenComponent, hueComponent, isBlack, isWhite, premultipliedColor, redComponent, rgbaComponents, saturationComponent, setHue:saturation:brightness:alpha:, and setRed:green:blue:alpha:.

---

The documentation for this class was generated from the following files:

• src/Core/OOColor.h
• src/Core/OOColor.m