Provides access to members that control the properties of a RandomColorRamp. A color ramp that is a list of randomly picked colors.
Product Availability
Description
IRandomColorRamp generates a specified number of unique, equally different, colors. The range of colors can be restricted based on a hue range, value range, or saturation range. The RandomColorRamp is designed around the HSV color model and therefore the colors in a random color ramp may be restricted in terms of hue, saturation, and value. Setting the StartHue and EndHue properties to values between 0 and 360 will restrict the colors that may appear in the ramp. Setting MinValue and MaxValue to between 0 and 100 will restrict the brightness, and setting MinSaturation and MaxSaturation to between 0 and 100 will restrict the purity of the colors in the ramp. Remember when you are setting your ranges that StartHue must alwasy be less than the EndHue, MinSaturation less than MaxSaturation, and MinValue less than MaxValue. If the values are set incorrectly, the RandomColorRamp will use the full range of hue, saturation, or value.
By default, the UseSeed property of the IRandomColorRamp is False. In this case, the RandomColorRamp creates a new random number to use as the seed value for each call to CreateRamp, ensuring that the Colors created are random and different each time CreateRamp is called. If the UseSeed property is set to True, the seed used for the RandomColorRamp is taken from the Seed property, and therefore each time you call CreateRamp with a specific Seed value, the sequence of colors created is unchanged.
Members
Description | ||
---|---|---|
Color | The color at the given index position. Call CreateRamp before calling this method. | |
Colors | The list of colors. Call CreateRamp before calling this method. | |
CreateRamp | Generates a color ramp with length determined by Size value. | |
EndHue | The end hue (0-360). | |
MaxSaturation | The maximum saturation (0-100). | |
MaxValue | The maximum value (0-100). | |
MinSaturation | The minimum saturation (0-100). | |
MinValue | The minimum value (0-100). | |
Name | The name of the color ramp. | |
Seed | The seed of the random number generator. | |
Size | The number of colors that will be generated by the CreateRamp method. | |
StartHue | The start hue (0-360). | |
UseSeed | Indicates if a seed is used when the ramp is generated. Set this property to True without changing the Seed to generate identical color ramps in succession. |
Inherited Interfaces
Interfaces | Description |
---|---|
IColorRamp | Provides access to the methods and properties common to all color ramp objects. |
CoClasses that implement IRandomColorRamp
CoClasses and Classes | Description |
---|---|
RandomColorRamp | Defines a random color ramp, where ramp is a list of randomly picked colors. |
See Also
IColorRamp Interface | IMultiPartColorRamp Interface | IColorRamp.CreateRamp Method | IPresetColorRamp Interface | IAlgorithmicColorRamp Interface | IColorRamp.Color Property | IRandomColorRamp Interface