GimpDisplayConfig

GimpDisplayConfig

Synopsis

                    GimpDisplayConfig;
#define             GIMP_CONFIG_DEFAULT_IMAGE_TITLE_FORMAT
#define             GIMP_CONFIG_DEFAULT_IMAGE_STATUS_FORMAT

Object Hierarchy

  GObject
   +----GimpBaseConfig
         +----GimpCoreConfig
               +----GimpDisplayConfig
                     +----GimpGuiConfig

Properties

  "activate-on-focus"        gboolean              : Read / Write / Construct
  "confirm-on-close"         gboolean              : Read / Write / Construct
  "cursor-mode"              GimpCursorMode        : Read / Write / Construct
  "cursor-updating"          gboolean              : Read / Write / Construct
  "default-dot-for-dot"      gboolean              : Read / Write / Construct
  "default-fullscreen-view"  GimpDisplayOptions*   : Read / Write
  "default-snap-to-canvas"   gboolean              : Read / Write / Construct
  "default-snap-to-grid"     gboolean              : Read / Write / Construct
  "default-snap-to-guides"   gboolean              : Read / Write / Construct
  "default-snap-to-path"     gboolean              : Read / Write / Construct
  "default-view"             GimpDisplayOptions*   : Read / Write
  "image-status-format"      gchar*                : Read / Write / Construct
  "image-title-format"       gchar*                : Read / Write / Construct
  "initial-zoom-to-fit"      gboolean              : Read / Write / Construct
  "marching-ants-speed"      gint                  : Read / Write / Construct
  "monitor-resolution-from-windowing-system" gboolean              : Read / Write / Construct
  "monitor-xresolution"      gdouble               : Read / Write / Construct
  "monitor-yresolution"      gdouble               : Read / Write / Construct
  "navigation-preview-size"  GimpViewSize          : Read / Write / Construct
  "perfect-mouse"            gboolean              : Read / Write / Construct
  "resize-windows-on-resize" gboolean              : Read / Write / Construct
  "resize-windows-on-zoom"   gboolean              : Read / Write / Construct
  "show-brush-outline"       gboolean              : Read / Write / Construct
  "show-paint-tool-cursor"   gboolean              : Read / Write / Construct
  "snap-distance"            gint                  : Read / Write / Construct
  "space-bar-action"         GimpSpaceBarAction    : Read / Write / Construct
  "transparency-size"        GimpCheckSize         : Read / Write / Construct
  "transparency-type"        GimpCheckType         : Read / Write / Construct
  "use-event-history"        gboolean              : Read / Write / Construct
  "xor-color"                GimpRGB*              : Read / Write / Construct
  "zoom-quality"             GimpZoomQuality       : Read / Write / Construct

Description

Details

GimpDisplayConfig

typedef struct _GimpDisplayConfig GimpDisplayConfig;


GIMP_CONFIG_DEFAULT_IMAGE_TITLE_FORMAT

#define GIMP_CONFIG_DEFAULT_IMAGE_TITLE_FORMAT  "%D*%f-%p.%i (%t, %L) %wx%h"


GIMP_CONFIG_DEFAULT_IMAGE_STATUS_FORMAT

#define GIMP_CONFIG_DEFAULT_IMAGE_STATUS_FORMAT "%n (%m)"

Property Details

The "activate-on-focus" property

  "activate-on-focus"        gboolean              : Read / Write / Construct

When enabled, an image will become the active image when its image window receives the focus. This is useful for window managers using "click to focus".

Default value: TRUE


The "confirm-on-close" property

  "confirm-on-close"         gboolean              : Read / Write / Construct

Ask for confirmation before closing an image without saving.

Default value: TRUE


The "cursor-mode" property

  "cursor-mode"              GimpCursorMode        : Read / Write / Construct

Sets the type of mouse pointers to use.

Default value: GIMP_CURSOR_MODE_TOOL_ICON


The "cursor-updating" property

  "cursor-updating"          gboolean              : Read / Write / Construct

Context-dependent mouse pointers are helpful. They are enabled by default. However, they require overhead that you may want to do without.

Default value: TRUE


The "default-dot-for-dot" property

  "default-dot-for-dot"      gboolean              : Read / Write / Construct

When enabled, this will ensure that each pixel of an image gets mapped to a pixel on the screen.

Default value: TRUE


The "default-fullscreen-view" property

  "default-fullscreen-view"  GimpDisplayOptions*   : Read / Write

Sets the default settings used when an image is viewed in fullscreen mode.


The "default-snap-to-canvas" property

  "default-snap-to-canvas"   gboolean              : Read / Write / Construct

Snap to the canvas edge by default in new image windows.

Default value: FALSE


The "default-snap-to-grid" property

  "default-snap-to-grid"     gboolean              : Read / Write / Construct

Snap to the grid by default in new image windows.

Default value: FALSE


The "default-snap-to-guides" property

  "default-snap-to-guides"   gboolean              : Read / Write / Construct

Snap to guides by default in new image windows.

Default value: TRUE


The "default-snap-to-path" property

  "default-snap-to-path"     gboolean              : Read / Write / Construct

Snap to the active path by default in new image windows.

Default value: FALSE


The "default-view" property

  "default-view"             GimpDisplayOptions*   : Read / Write

Sets the default settings for the image view.


The "image-status-format" property

  "image-status-format"      gchar*                : Read / Write / Construct

Sets the text to appear in image window status bars.

Default value: "%n (%m)"


The "image-title-format" property

  "image-title-format"       gchar*                : Read / Write / Construct

Sets the text to appear in image window titles.

Default value: "%D*%f-%p.%i (%t, %L) %wx%h"


The "initial-zoom-to-fit" property

  "initial-zoom-to-fit"      gboolean              : Read / Write / Construct

When enabled, this will ensure that the full image is visible after a file is opened, otherwise it will be displayed with a scale of 1:1.

Default value: TRUE


The "marching-ants-speed" property

  "marching-ants-speed"      gint                  : Read / Write / Construct

Speed of marching ants in the selection outline. This value is in milliseconds (less time indicates faster marching).

Allowed values: [10,10000]

Default value: 200


The "monitor-resolution-from-windowing-system" property

  "monitor-resolution-from-windowing-system" gboolean              : Read / Write / Construct

When enabled, GIMP will use the monitor resolution from the windowing system.

Default value: TRUE


The "monitor-xresolution" property

  "monitor-xresolution"      gdouble               : Read / Write / Construct

Sets the monitor's horizontal resolution, in dots per inch. If set to 0, forces the X server to be queried for both horizontal and vertical resolution information.

Allowed values: [0.005,65536]

Default value: 96


The "monitor-yresolution" property

  "monitor-yresolution"      gdouble               : Read / Write / Construct

Sets the monitor's vertical resolution, in dots per inch. If set to 0, forces the X server to be queried for both horizontal and vertical resolution information.

Allowed values: [0.005,65536]

Default value: 96


The "navigation-preview-size" property

  "navigation-preview-size"  GimpViewSize          : Read / Write / Construct

Sets the size of the navigation preview available in the lower right corner of the image window.

Default value: GIMP_VIEW_SIZE_MEDIUM


The "perfect-mouse" property

  "perfect-mouse"            gboolean              : Read / Write / Construct

When enabled, the X server is queried for the mouse's current position on each motion event, rather than relying on the position hint. This means painting with large brushes should be more accurate, but it may be slower. Conversely, on some X servers enabling this option results in faster painting.

Default value: TRUE


The "resize-windows-on-resize" property

  "resize-windows-on-resize" gboolean              : Read / Write / Construct

When enabled, the image window will automatically resize itself whenever the physical image size changes.

Default value: FALSE


The "resize-windows-on-zoom" property

  "resize-windows-on-zoom"   gboolean              : Read / Write / Construct

When enabled, the image window will automatically resize itself when zooming into and out of images.

Default value: FALSE


The "show-brush-outline" property

  "show-brush-outline"       gboolean              : Read / Write / Construct

When enabled, all paint tools will show a preview of the current brush's outline.

Default value: TRUE


The "show-paint-tool-cursor" property

  "show-paint-tool-cursor"   gboolean              : Read / Write / Construct

When enabled, the mouse pointer will be shown over the image while using a paint tool.

Default value: TRUE


The "snap-distance" property

  "snap-distance"            gint                  : Read / Write / Construct

This is the distance in pixels where Guide and Grid snapping activates.

Allowed values: [1,255]

Default value: 8


The "space-bar-action" property

  "space-bar-action"         GimpSpaceBarAction    : Read / Write / Construct

What to do when the space bar is pressed in the image window.

Default value: GIMP_SPACE_BAR_ACTION_PAN


The "transparency-size" property

  "transparency-size"        GimpCheckSize         : Read / Write / Construct

Sets the size of the checkerboard used to display transparency.

Default value: GIMP_CHECK_SIZE_MEDIUM_CHECKS


The "transparency-type" property

  "transparency-type"        GimpCheckType         : Read / Write / Construct

Sets the manner in which transparency is displayed in images.

Default value: GIMP_CHECK_TYPE_GRAY_CHECKS


The "use-event-history" property

  "use-event-history"        gboolean              : Read / Write / Construct

Bugs in event history buffer are frequent so in case of cursor offset problems turning it off helps.

Default value: FALSE


The "xor-color" property

  "xor-color"                GimpRGB*              : Read / Write / Construct


The "zoom-quality" property

  "zoom-quality"             GimpZoomQuality       : Read / Write / Construct

There's a tradeoff between speed and quality of the zoomed-out display.

Default value: GIMP_ZOOM_QUALITY_HIGH