See also: Main Index; Alphabetic; Misc; By Author; By Module; By Menu    External Links: The Gimp; Gimp User Manual

The Gimp channel functions

gimp_channel_combine_masks Combine two channel masks.
gimp_channel_copy Copy a channel.
gimp_channel_delete This procedure is deprecated! Use 'gimp_drawable_delete' instead.
gimp_channel_get_color Get the compositing color of the specified channel.
gimp_channel_get_name This procedure is deprecated! Use 'gimp_drawable_get_name' instead.
gimp_channel_get_opacity Get the opacity of the specified channel.
gimp_channel_get_show_masked Get the composite method of the specified channel.
gimp_channel_get_tattoo This procedure is deprecated! Use 'gimp_drawable_get_tattoo' instead.
gimp_channel_get_visible This procedure is deprecated! Use 'gimp_drawable_get_visible' instead.
gimp_channel_new Create a new channel.
gimp_channel_new_from_component Create a new channel from a color component
gimp_channel_ops_duplicate This procedure is deprecated! Use 'gimp_image_duplicate' instead.
gimp_channel_ops_offset This procedure is deprecated! Use 'gimp_drawable_offset' instead.
gimp_channel_set_color Set the compositing color of the specified channel.
gimp_channel_set_name This procedure is deprecated! Use 'gimp_drawable_set_name' instead.
gimp_channel_set_opacity Set the opacity of the specified channel.
gimp_channel_set_show_masked Set the composite method of the specified channel.
gimp_channel_set_tattoo This procedure is deprecated! Use 'gimp_drawable_set_tattoo' instead.
gimp_channel_set_visible This procedure is deprecated! Use 'gimp_drawable_set_visible' instead.
gimp_drawable_is_channel Returns whether the drawable is a channel.
gimp_image_add_channel Add the specified channel to the image.
gimp_image_get_active_channel Returns the specified image's active channel.
gimp_image_get_channel_by_tattoo Find a channel with a given tattoo in an image.
gimp_image_get_channels Returns the list of channels contained in the specified image.
gimp_image_lower_channel Lower the specified layer in the image's layer stack
gimp_image_raise_channel Raise the specified channel in the image's channel stack
gimp_image_remove_channel Remove the specified channel from the image.
gimp_image_set_active_channel Sets the specified image's active channel.
gimp_image_unset_active_channel Unsets the active channel in the specified image.
plug_in_colors_channel_mixer Mix RGB Channels.

gimp_channel_copy

Input:
CHANNELchannelThe channel to copy
Returns:
CHANNELchannel_copyThe newly copied channel
This procedure copies the specified channel and returns the copy.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_delete

Input:
DRAWABLEdrawableThe drawable to delete
Returns: nothing
This procedure is deprecated! Use 'gimp_drawable_delete' instead.
;

gimp_channel_get_color

Input:
CHANNELchannelThe channel
Returns:
COLORcolorThe channel compositing color
This procedure returns the specified channel's compositing color.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_get_name

Input:
DRAWABLEdrawableThe drawable
Returns:
STRINGnameThe drawable name
This procedure is deprecated! Use 'gimp_drawable_get_name' instead.
;

gimp_channel_get_opacity

Input:
CHANNELchannelThe channel
Returns:
SUCCESSopacityThe channel opacity
This procedure returns the specified channel's opacity.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_get_tattoo

Input:
DRAWABLEdrawableThe drawable
Returns:
INT32tattooThe drawable tattoo
This procedure is deprecated! Use 'gimp_drawable_get_tattoo' instead.
;

gimp_channel_get_visible

Input:
DRAWABLEdrawableThe drawable
Returns:
INT32visibleThe drawable visibility
This procedure is deprecated! Use 'gimp_drawable_get_visible' instead.
;

gimp_channel_new

Input:
IMAGEimageThe image to which to add the channel
INT32widthThe channel width: (0 < width)
INT32heightThe channel height: (0 < height)
STRINGnameThe channel name
SUCCESSopacityThe channel opacity: (0 <= opacity <= 100)
COLORcolorThe channel compositing color
Returns:
CHANNELchannelThe newly created channel
This procedure creates a new channel with the specified width and height. Name, opacity, and color are also supplied parameters. The new channel still needs to be added to the image, as this is not automatic. Add the new channel with the 'gimp_image_add_channel' command. Other attributes such as channel show masked, should be set with explicit procedure calls. The channel's contents are undefined initially.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_new_from_component

Input:
IMAGEimageThe image to which to add the channel
INT32componentThe image component: { GIMP_RED_CHANNEL (0), GIMP_GREEN_CHANNEL (1), GIMP_BLUE_CHANNEL (2), GIMP_GRAY_CHANNEL (3), GIMP_INDEXED_CHANNEL (4), GIMP_ALPHA_CHANNEL (5) }
STRINGnameThe channel name
Returns:
CHANNELchannelThe newly created channel
This procedure creates a new channel from a color component.
Shlomi Fish; 2005

gimp_channel_ops_duplicate

Input:
IMAGEimageThe image
Returns:
IMAGEnew_imageThe new, duplicated image
This procedure is deprecated! Use 'gimp_image_duplicate' instead.
;

gimp_channel_ops_offset

Input:
DRAWABLEdrawableThe drawable to offset
INT32wrap_aroundwrap image around or fill vacated regions
INT32fill_typefill vacated regions of drawable with background or transparent: GIMP_OFFSET_BACKGROUND (0) or GIMP_OFFSET_TRANSPARENT (1)
INT32offset_xoffset by this amount in X direction
INT32offset_yoffset by this amount in Y direction
Returns: nothing
This procedure is deprecated! Use 'gimp_drawable_offset' instead.
;

gimp_channel_set_color

Input:
CHANNELchannelThe channel
COLORcolorThe new channel compositing color
Returns: nothing
This procedure sets the specified channel's compositing color.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_set_name

Input:
DRAWABLEdrawableThe drawable
STRINGnameThe new drawable name
Returns: nothing
This procedure is deprecated! Use 'gimp_drawable_set_name' instead.
;

gimp_channel_set_opacity

Input:
CHANNELchannelThe channel
SUCCESSopacityThe new channel opacity (0 <= opacity <= 100)
Returns: nothing
This procedure sets the specified channel's opacity.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_channel_set_tattoo

Input:
DRAWABLEdrawableThe drawable
INT32tattooThe new drawable tattoo
Returns: nothing
This procedure is deprecated! Use 'gimp_drawable_set_tattoo' instead.
;

gimp_channel_set_visible

Input:
DRAWABLEdrawableThe drawable
INT32visibleThe new drawable visibility
Returns: nothing
This procedure is deprecated! Use 'gimp_drawable_set_visible' instead.
;

gimp_image_add_channel

Input:
IMAGEimageThe image
CHANNELchannelThe channel
INT32positionThe channel position
Returns: nothing
This procedure adds the specified channel to the image. The position channel is not currently used, so the channel is always inserted at the top of the channel stack.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_get_active_channel

Input:
IMAGEimageThe image
Returns:
CHANNELactive_channelThe active channel
If there is an active channel, this will return the channel ID, otherwise, -1.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_get_channel_by_tattoo

Input:
IMAGEimageThe image
INT32tattooThe tattoo of the channel to find
Returns:
CHANNELchannelThe channel with the specified tattoo
This procedure returns the channel with the given tattoo in the specified image.
Jay Cox; 1998

gimp_image_get_channels

Input:
IMAGEimageThe image
Returns:
INT32num_channelsThe number of channels contained in the image
INT32ARRAYchannel_idsThe list of channels contained in the image
This procedure returns the list of channels contained in the specified image. This does not include the selection mask, or layer masks. The order is from topmost to bottommost.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_lower_channel

Input:
IMAGEimageThe image
LAYERlayerThe layer to lower
Returns: nothing
This procedure lowers the specified layer one step in the existing layer stack. It will not move the layer if there is no layer below it, or the layer has no alpha channel.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_raise_channel

Input:
IMAGEimageThe image
CHANNELchannelThe channel to raise
Returns: nothing
This procedure raises the specified channel one step in the existing channel stack. It will not move the channel if there is no channel above it.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_remove_channel

Input:
IMAGEimageThe image
CHANNELchannelThe channel
Returns: nothing
This procedure removes the specified channel from the image. If the channel doesn't exist, an error is returned.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_set_active_channel

Input:
IMAGEimageThe image
CHANNELactive_channelThe new image active channel
Returns: nothing
If the channel exists, it is set as the active channel in the image. Any previous active channel or channel is set to inactive. An exception is a previously existing floating selection, in which case this procedure will return an execution error.
Spencer Kimball & Peter Mattis; 1995-1996

gimp_image_unset_active_channel

Input:
IMAGEimageThe image
Returns: nothing
If an active channel exists, it is unset. There then exists no active channel, and if desired, one can be set through a call to 'Set Active Channel'. No error is returned in the case of no existing active channel.
Spencer Kimball & Peter Mattis; 1995-1996

plug_in_colors_channel_mixer

Input:
INT32run_modeInteractive, non-interactive
IMAGEimageInput image (unused)
DRAWABLEdrawableInput drawable
INT32monochromeMonochrome (TRUE or FALSE)
SUCCESSrr_gainSet the red gain for the red channel
SUCCESSrg_gainSet the green gain for the red channel
SUCCESSrb_gainSet the blue gain for the red channel
SUCCESSgr_gainSet the red gain for the green channel
SUCCESSgg_gainSet the green gain for the green channel
SUCCESSgb_gainSet the blue gain for the green channel
SUCCESSbr_gainSet the red gain for the blue channel
SUCCESSbg_gainSet the green gain for the blue channel
SUCCESSbb_gainSet the blue gain for the blue channel
Returns: nothing
This plug-in mixes the RGB channels.
Martin Guldahl <mguldahl@xmission.com>; 2002


The Gimp 2.3.2 (win32)Documentation fresh from PDB22:53:15 Fr 22.07.2005
Generated by pdb2doc.py written by Hans Breuer <Hans@Breuer.org>