Coin Logo http://www.sim.no
http://www.coin3d.org

Public Member Functions | Friends | List of all members
SbColor4f Class Reference

The SbColor4f class contains the red, green, blue and alpha components which make up a color value.This class is used internally within other classes in Coin. It contains a 4 component vector as a position in the RGB cube with an additional transparency value. More...

#include <Inventor/SbColor4f.h>

Public Member Functions

 SbColor4f (void)
 
 SbColor4f (const SbColor &rgb, const float alpha)
 
 SbColor4f (const SbVec4f &v)
 
 SbColor4f (const float *const rgba)
 
 SbColor4f (const float r, const float g, const float b, const float a=1.0f)
 
void setValue (const float r, const float g, const float b, const float a=1.0f)
 
void setValue (const float col[4])
 
const float * getValue () const
 
void getValue (float &r, float &g, float &b, float &a)
 
SbColor4fsetRGB (const SbColor &col)
 
void getRGB (SbColor &color)
 
SbColor4fsetHSVValue (float h, float s, float v, float a=1.0f)
 
SbColor4fsetHSVValue (const float hsv[3], float alpha=1.0f)
 
void getHSVValue (float &h, float &s, float &v) const
 
void getHSVValue (float hsv[3]) const
 
SbColor4fsetPackedValue (const uint32_t rgba)
 
uint32_t getPackedValue () const
 
float operator[] (const int idx) const
 
float & operator[] (const int idx)
 
SbColor4foperator*= (const float d)
 
SbColor4foperator/= (const float d)
 
SbColor4foperator+= (const SbColor4f &c)
 
SbColor4foperator-= (const SbColor4f &c)
 

Friends

SbColor4f operator* (const SbColor4f &c, const float d)
 
SbColor4f operator* (const float d, const SbColor4f &c)
 
SbColor4f operator/ (const SbColor4f &c, const float d)
 
SbColor4f operator+ (const SbColor4f &v1, const SbColor4f &v2)
 
SbColor4f operator- (const SbColor4f &v1, const SbColor4f &v2)
 
int operator== (const SbColor4f &v1, const SbColor4f &v2)
 
int operator!= (const SbColor4f &v1, const SbColor4f &v2)
 

Detailed Description

The SbColor4f class contains the red, green, blue and alpha components which make up a color value.

This class is used internally within other classes in Coin. It contains a 4 component vector as a position in the RGB cube with an additional transparency value.

The red, green and blue values should be between 0.0 and 1.0, where 0.0 is interpreted as minimum intensity, and 1.0 is maximum intensity. The transparency value is also between 0.0 and 1.0.

SbColor4f contains methods for convenient handling of setting and getting color values as 32 bit packed values or as HSV values.

Note: this class is not part of Open Inventor, but is an extension to the API. Don't use it if you want your code to be compatible with Open Inventor.

See also
SbColor

Constructor & Destructor Documentation

◆ SbColor4f() [1/5]

SbColor4f::SbColor4f ( void  )

Default constructor. The color value will be uninitialized until explicitly set.

◆ SbColor4f() [2/5]

SbColor4f::SbColor4f ( const SbColor rgb,
const float  alpha 
)

Construct and initialize an SbColor4f with the red, green and blue components from the SbColor rgb, and the alpha value from the supplied alpha argument.

◆ SbColor4f() [3/5]

SbColor4f::SbColor4f ( const SbVec4f v)

Construct and initialize an SbColor4f with the red, green, blue and alpha values given by the v vector.

◆ SbColor4f() [4/5]

SbColor4f::SbColor4f ( const float *const  rgba)

Construct and initialize an SbColor4f with the red, green, blue and alpha taken from given rgba array

◆ SbColor4f() [5/5]

SbColor4f::SbColor4f ( const float  r,
const float  g,
const float  b,
const float  a = 1.0f 
)

Construct and initialize an SbColor4f with the given red, green, blue and alpha values.

Member Function Documentation

◆ setValue() [1/2]

void SbColor4f::setValue ( const float  r,
const float  g,
const float  b,
const float  a = 1.0f 
)

Set a new color.

Referenced by setPackedValue(), and SoSFColorRGBA::setValue().

◆ setValue() [2/2]

void SbColor4f::setValue ( const float  col[4])

Set a new color. The elements of the array will be read in turned as red, green, blue and transparency.

◆ getValue() [1/2]

const float * SbColor4f::getValue ( ) const

Return pointer to array of 4 float values representing the red, green, blue and transparency values of the color.

Referenced by SoVRMLDirectionalLight::GLRender(), SoPointLight::GLRender(), SoDirectionalLight::GLRender(), SoVRMLPointLight::GLRender(), SoSpotLight::GLRender(), and SoVRMLSpotLight::GLRender().

◆ getValue() [2/2]

void SbColor4f::getValue ( float &  r,
float &  g,
float &  b,
float &  a 
)

Return components of the stored color.

◆ setRGB()

SbColor4f & SbColor4f::setRGB ( const SbColor col)

◆ getRGB()

void SbColor4f::getRGB ( SbColor color)

Returns the RGB components of this color.

◆ setHSVValue() [1/2]

SbColor4f & SbColor4f::setHSVValue ( float  hue,
float  saturation,
float  value,
float  alpha = 1.0f 
)

Set the color as a hue, saturation, value triplet. The hue component should be normalized to within [0, 1] before you call this method, where 0 is equal to 0° and 1 is equal to 360°.

See also
getHSVValue().

References SoDebugError::postWarning(), and SbColor::setHSVValue().

Referenced by SoMFColorRGBA::set1HSVValue(), SoSFColorRGBA::setHSVValue(), SoMFColorRGBA::setHSVValue(), and setHSVValue().

◆ setHSVValue() [2/2]

SbColor4f & SbColor4f::setHSVValue ( const float  hsv[3],
float  a = 1.0f 
)

Set the color as a hue, saturation, value triplet. The hue component should be normalized to within [0, 1] before you call this method, where 0 is equal to 0° and 1 is equal to 360°.

See also
getHSVValue().

References setHSVValue().

◆ getHSVValue() [1/2]

void SbColor4f::getHSVValue ( float &  h,
float &  s,
float &  v 
) const

Return the color as a hue, saturation, value triplet. Alpha component is ignored.

See also
setHSVValue().

References SbColor::getHSVValue().

Referenced by getHSVValue().

◆ getHSVValue() [2/2]

void SbColor4f::getHSVValue ( float  hsv[3]) const

Return the color as a hue, saturation, value triplet. Alpha component is ignored.

See also
setHSVValue().

References getHSVValue().

◆ setPackedValue()

SbColor4f & SbColor4f::setPackedValue ( const uint32_t  rgba)

Set the color value as a 32 bit combined red/green/blue/alpha value. Each component is 8 bit wide (i.e. from 0x00 to 0xff), and the red value should be stored leftmost, like this: 0xRRGGBBAA.

See also
getPackedValue().

References setValue().

◆ getPackedValue()

uint32_t SbColor4f::getPackedValue ( ) const

Return color as a 32 bit packed integer in the form 0xRRGGBBAA.

See also
setPackedValue().

Referenced by SoVRMLPointSet::GLRender().

◆ operator[]() [1/2]

float SbColor4f::operator[] ( const int  idx) const

Returns the color component represented by the given index idx. 0 is red, 1 is green, 2 is blue and 3 is the transparency value.

◆ operator[]() [2/2]

float & SbColor4f::operator[] ( const int  idx)

Returns the color component represented by the given index idx. 0 is red, 1 is green, 2 is blue and 3 is the transparency value.

◆ operator*=()

SbColor4f & SbColor4f::operator*= ( const float  d)

Multiplies the RGB components by d. The alpha component is left unchanged.

◆ operator/=()

SbColor4f & SbColor4f::operator/= ( const float  d)

Divides the RGB components by d. The alpha component is left unchanged.

◆ operator+=()

SbColor4f & SbColor4f::operator+= ( const SbColor4f c)

Adds the RGB components. Alpha is ignored.

◆ operator-=()

SbColor4f & SbColor4f::operator-= ( const SbColor4f c)

Subtracts the RGB components. Alpha is ignored.

Friends And Related Function Documentation

◆ operator* [1/2]

SbColor4f operator* ( const SbColor4f c,
const float  d 
)
friend

Multiplies the RGB components by d. Alpha is left unchanged.

◆ operator* [2/2]

SbColor4f operator* ( const float  d,
const SbColor4f c 
)
friend

Multiplies the RGB components by d. Alpha is left unchanged.

◆ operator/

SbColor4f operator/ ( const SbColor4f c,
const float  d 
)
friend

Divides the RGB components by d. Alpha is left unchanged.

◆ operator+

SbColor4f operator+ ( const SbColor4f v1,
const SbColor4f v2 
)
friend

Adds the RGB components of the two colors. Alpha is taken from the first color (v1).

◆ operator-

SbColor4f operator- ( const SbColor4f v1,
const SbColor4f v2 
)
friend

Subtracts the RGB components of the two colors. Alpha is taken from the first color (v1).

◆ operator==

int operator== ( const SbColor4f v1,
const SbColor4f v2 
)
friend

Check if two colors are equal. Returns 1 if equal, 0 if unequal.

◆ operator!=

int operator!= ( const SbColor4f v1,
const SbColor4f v2 
)
friend

Check if two colors are unequal. Returns 0 if equal, 1 if unequal.


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

Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.

Generated on Fri Jul 20 2018 for Coin by Doxygen. 1.8.14