Gimp.ColorConfig

g GObject.GInterface GObject.GInterface Gimp.ConfigInterface Gimp.ConfigInterface GObject.GInterface->Gimp.ConfigInterface GObject.Object GObject.Object Gimp.ColorConfig Gimp.ColorConfig GObject.Object->Gimp.ColorConfig Gimp.ConfigInterface->Gimp.ColorConfig

Subclasses:

None

Methods

Inherited:

GObject.Object (37), Gimp.ConfigInterface (14)

Structs:

GObject.ObjectClass (5)

get_cmyk_color_profile ()

get_display_bpc ()

get_display_color_profile ()

get_display_intent ()

get_display_optimize ()

get_display_profile_from_gdk ()

get_gray_color_profile ()

get_mode ()

get_out_of_gamut_color ()

get_rgb_color_profile ()

get_simulation_bpc ()

get_simulation_color_profile ()

get_simulation_gamut_check ()

get_simulation_intent ()

get_simulation_optimize ()

Virtual Methods

Inherited:

GObject.Object (7)

Properties

Name

Type

Flags

Short Description

cmyk-profile

Gimp.ConfigPath

r/w/c

The CMYK color profile used to convert between RGB and CMYK.

display-optimize

bool

r/w/c

When disabled, image display might be of better quality at the cost of speed.

display-profile

Gimp.ConfigPath

r/w/c

The color profile of your (primary) monitor.

display-profile-from-gdk

bool

r/w/c

When enabled, GIMP will try to use the display color profile from the windowing system. The configured monitor profile is then only used as a fallback.

display-rendering-intent

Gimp.ColorRenderingIntent

r/w/c

How colors are converted from your image’s color space to your display device. Relative colorimetric is usually the best choice. Unless you use a LUT monitor profile (most monitor profiles are matrix), choosing perceptual intent really gives you relative colorimetric.

display-use-black-point-compensation

bool

r/w/c

Do use black point compensation (unless you know you have a reason not to).

gray-profile

Gimp.ConfigPath

r/w/c

The preferred grayscale working space color profile. It will be offered next to the built-in grayscale profile when a color profile can be chosen.

mode

Gimp.ColorManagementMode

r/w/c

How images are displayed on screen.

out-of-gamut-color

Gegl.Color

r/w

The color to use for marking colors which are out of gamut.

rgb-profile

Gimp.ConfigPath

r/w/c

The preferred RGB working space color profile. It will be offered next to the built-in RGB profile when a color profile can be chosen.

show-hsv

bool

r/w/c

Show HSV instead of LCH

show-rgb-u8

bool

r/w/c

Show RGB 0..255 scales

simulation-gamut-check

bool

r/w/c

When enabled, the soft-proofing will mark colors which can not be represented in the target color space.

simulation-optimize

bool

r/w/c

When disabled, soft-proofing might be of better quality at the cost of speed.

simulation-profile

Gimp.ConfigPath

r/w/c

The color profile to use for soft-proofing from your image’s color space to some other color space, including soft-proofing to a printer or other output device profile.

simulation-rendering-intent

Gimp.ColorRenderingIntent

r/w/c

How colors are converted from your image’s color space to the output simulation device (usually your monitor). Try them all and choose what looks the best.

simulation-use-black-point-compensation

bool

r/w/c

Try with and without black point compensation and choose what looks best.

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Class Details

class Gimp.ColorConfig(**kwargs)
Bases:

GObject.Object, Gimp.ConfigInterface

Abstract:

No

Structure:

Gimp.ColorConfigClass

Color management settings.

get_cmyk_color_profile()
Raises:

GLib.Error

Returns:

the default CMYK color profile.

Return type:

Gimp.ColorProfile

New in version 2.10.

get_display_bpc()
Return type:

bool

New in version 2.10.

get_display_color_profile()
Raises:

GLib.Error

Returns:

the default display color profile.

Return type:

Gimp.ColorProfile

New in version 2.10.

get_display_intent()
Return type:

Gimp.ColorRenderingIntent

New in version 2.10.

get_display_optimize()
Return type:

bool

New in version 2.10.

get_display_profile_from_gdk()
Return type:

bool

New in version 2.10.

get_gray_color_profile()
Raises:

GLib.Error

Returns:

the default grayscale color profile.

Return type:

Gimp.ColorProfile

New in version 2.10.

get_mode()
Return type:

Gimp.ColorManagementMode

New in version 2.10.

get_out_of_gamut_color()
Returns:

the [class`Gegl`.Color] to use to represent out-of-gamut pixels.

Return type:

Gegl.Color

New in version 3.0.

get_rgb_color_profile()
Raises:

GLib.Error

Returns:

the default RGB color profile.

Return type:

Gimp.ColorProfile

New in version 2.10.

get_simulation_bpc()
Return type:

bool

New in version 2.10.

get_simulation_color_profile()
Raises:

GLib.Error

Returns:

the default soft-proofing color profile.

Return type:

Gimp.ColorProfile

New in version 2.10.

get_simulation_gamut_check()
Return type:

bool

New in version 2.10.

get_simulation_intent()
Return type:

Gimp.ColorRenderingIntent

New in version 2.10.

get_simulation_optimize()
Return type:

bool

New in version 2.10.

Property Details

Gimp.ColorConfig.props.cmyk_profile
Name:

cmyk-profile

Type:

Gimp.ConfigPath

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT

The CMYK color profile used to convert between RGB and CMYK.

Gimp.ColorConfig.props.display_optimize
Name:

display-optimize

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT

When disabled, image display might be of better quality at the cost of speed.

Gimp.ColorConfig.props.display_profile
Name:

display-profile

Type:

Gimp.ConfigPath

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT

The color profile of your (primary) monitor.

Gimp.ColorConfig.props.display_profile_from_gdk
Name:

display-profile-from-gdk

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT

When enabled, GIMP will try to use the display color profile from the windowing system. The configured monitor profile is then only used as a fallback.

Gimp.ColorConfig.props.display_rendering_intent
Name:

display-rendering-intent

Type:

Gimp.ColorRenderingIntent

Default Value:

Gimp.ColorRenderingIntent.RELATIVE_COLORIMETRIC

Flags:

READABLE, WRITABLE, CONSTRUCT

How colors are converted from your image’s color space to your display device. Relative colorimetric is usually the best choice. Unless you use a LUT monitor profile (most monitor profiles are matrix), choosing perceptual intent really gives you relative colorimetric.

Gimp.ColorConfig.props.display_use_black_point_compensation
Name:

display-use-black-point-compensation

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT

Do use black point compensation (unless you know you have a reason not to).

Gimp.ColorConfig.props.gray_profile
Name:

gray-profile

Type:

Gimp.ConfigPath

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT

The preferred grayscale working space color profile. It will be offered next to the built-in grayscale profile when a color profile can be chosen.

Gimp.ColorConfig.props.mode
Name:

mode

Type:

Gimp.ColorManagementMode

Default Value:

Gimp.ColorManagementMode.DISPLAY

Flags:

READABLE, WRITABLE, CONSTRUCT

How images are displayed on screen.

Gimp.ColorConfig.props.out_of_gamut_color
Name:

out-of-gamut-color

Type:

Gegl.Color

Default Value:

<Color object at 0x000000000000 (GeglColor at 0x00000000)>

Flags:

READABLE, WRITABLE

The color to use for marking colors which are out of gamut.

Gimp.ColorConfig.props.rgb_profile
Name:

rgb-profile

Type:

Gimp.ConfigPath

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT

The preferred RGB working space color profile. It will be offered next to the built-in RGB profile when a color profile can be chosen.

Gimp.ColorConfig.props.show_hsv
Name:

show-hsv

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT

Show HSV instead of LCH

Gimp.ColorConfig.props.show_rgb_u8
Name:

show-rgb-u8

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT

Show RGB 0..255 scales

Gimp.ColorConfig.props.simulation_gamut_check
Name:

simulation-gamut-check

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT

When enabled, the soft-proofing will mark colors which can not be represented in the target color space.

Gimp.ColorConfig.props.simulation_optimize
Name:

simulation-optimize

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT

When disabled, soft-proofing might be of better quality at the cost of speed.

Gimp.ColorConfig.props.simulation_profile
Name:

simulation-profile

Type:

Gimp.ConfigPath

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT

The color profile to use for soft-proofing from your image’s color space to some other color space, including soft-proofing to a printer or other output device profile.

Gimp.ColorConfig.props.simulation_rendering_intent
Name:

simulation-rendering-intent

Type:

Gimp.ColorRenderingIntent

Default Value:

Gimp.ColorRenderingIntent.PERCEPTUAL

Flags:

READABLE, WRITABLE, CONSTRUCT

How colors are converted from your image’s color space to the output simulation device (usually your monitor). Try them all and choose what looks the best.

Gimp.ColorConfig.props.simulation_use_black_point_compensation
Name:

simulation-use-black-point-compensation

Type:

bool

Default Value:

False

Flags:

READABLE, WRITABLE, CONSTRUCT

Try with and without black point compensation and choose what looks best.