gimpchannel

Name

gimpchannel -- 

Synopsis



gint32      gimp_channel_new                (gint32 image_ID,
                                             gchar *name,
                                             guint width,
                                             guint height,
                                             gdouble opacity,
                                             GimpRGB *color);
gint32      gimp_channel_copy               (gint32 channel_ID);
gboolean    gimp_channel_delete             (gint32 channel_ID);
gchar*      gimp_channel_get_name           (gint32 channel_ID);
gboolean    gimp_channel_set_name           (gint32 channel_ID,
                                             gchar *name);
gboolean    gimp_channel_get_visible        (gint32 channel_ID);
gboolean    gimp_channel_set_visible        (gint32 channel_ID,
                                             gboolean visible);
gboolean    gimp_channel_get_show_masked    (gint32 channel_ID);
gboolean    gimp_channel_set_show_masked    (gint32 channel_ID,
                                             gboolean show_masked);
gdouble     gimp_channel_get_opacity        (gint32 channel_ID);
gboolean    gimp_channel_set_opacity        (gint32 channel_ID,
                                             gdouble opacity);
gboolean    gimp_channel_get_color          (gint32 channel_ID,
                                             GimpRGB *color);
gboolean    gimp_channel_set_color          (gint32 channel_ID,
                                             GimpRGB *color);
gint        gimp_channel_get_tattoo         (gint32 channel_ID);
gboolean    gimp_channel_set_tattoo         (gint32 channel_ID,
                                             gint tattoo);
#define     gimp_channel_get_image_id
gboolean    gimp_channel_combine_masks      (gint32 channel1_ID,
                                             gint32 channel2_ID,
                                             GimpChannelOps operation,
                                             gint offx,
                                             gint offy);

Description

Details

gimp_channel_new ()

gint32      gimp_channel_new                (gint32 image_ID,
                                             gchar *name,
                                             guint width,
                                             guint height,
                                             gdouble opacity,
                                             GimpRGB *color);

Create a new 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.


gimp_channel_copy ()

gint32      gimp_channel_copy               (gint32 channel_ID);

Copy a channel.

This procedure copies the specified channel and returns the copy.


gimp_channel_delete ()

gboolean    gimp_channel_delete             (gint32 channel_ID);

Delete a channel.

This procedure deletes the specified channel. This must not be done if the gimage containing this channel was already deleted or if the channel was already removed from the image. The only case in which this procedure is useful is if you want to get rid of a channel which has not yet been added to an image.


gimp_channel_get_name ()

gchar*      gimp_channel_get_name           (gint32 channel_ID);

Get the name of the specified channel.

This procedure returns the specified channel's name.


gimp_channel_set_name ()

gboolean    gimp_channel_set_name           (gint32 channel_ID,
                                             gchar *name);

Set the name of the specified channel.

This procedure sets the specified channel's name.


gimp_channel_get_visible ()

gboolean    gimp_channel_get_visible        (gint32 channel_ID);

Get the visibility of the specified channel.

This procedure returns the specified channel's visibility.


gimp_channel_set_visible ()

gboolean    gimp_channel_set_visible        (gint32 channel_ID,
                                             gboolean visible);

Set the visibility of the specified channel.

This procedure sets the specified channel's visibility.


gimp_channel_get_show_masked ()

gboolean    gimp_channel_get_show_masked    (gint32 channel_ID);

Get the composite method of the specified channel.

This procedure returns the specified channel's composite method. If it is non-zero, then the channel is composited with the image so that masked regions are shown. Otherwise, selected regions are shown.


gimp_channel_set_show_masked ()

gboolean    gimp_channel_set_show_masked    (gint32 channel_ID,
                                             gboolean show_masked);

Set the composite method of the specified channel.

This procedure sets the specified channel's composite method. If it is non-zero, then the channel is composited with the image so that masked regions are shown. Otherwise, selected regions are shown.


gimp_channel_get_opacity ()

gdouble     gimp_channel_get_opacity        (gint32 channel_ID);

Get the opacity of the specified channel.

This procedure returns the specified channel's opacity.


gimp_channel_set_opacity ()

gboolean    gimp_channel_set_opacity        (gint32 channel_ID,
                                             gdouble opacity);

Set the opacity of the specified channel.

This procedure sets the specified channel's opacity.


gimp_channel_get_color ()

gboolean    gimp_channel_get_color          (gint32 channel_ID,
                                             GimpRGB *color);

Get the compositing color of the specified channel.

This procedure returns the specified channel's compositing color.


gimp_channel_set_color ()

gboolean    gimp_channel_set_color          (gint32 channel_ID,
                                             GimpRGB *color);

Set the compositing color of the specified channel.

This procedure sets the specified channel's compositing color.


gimp_channel_get_tattoo ()

gint        gimp_channel_get_tattoo         (gint32 channel_ID);

Get the tattoo of the specified channel.

This procedure returns the specified channel's tattoo. A tattoo is a unique and permanent identifier attached to a channel that can be used to uniquely identify a channel within an image even between sessions.


gimp_channel_set_tattoo ()

gboolean    gimp_channel_set_tattoo         (gint32 channel_ID,
                                             gint tattoo);

Set the tattoo of the specified channel.

This procedure sets the specified channel's tattoo. A tattoo is a unique and permanent identifier attached to a channel that can be used to uniquely identify a channel within an image even between sessions.


gimp_channel_get_image_id

#define gimp_channel_get_image_id  gimp_drawable_image


gimp_channel_combine_masks ()

gboolean    gimp_channel_combine_masks      (gint32 channel1_ID,
                                             gint32 channel2_ID,
                                             GimpChannelOps operation,
                                             gint offx,
                                             gint offy);

Combine two channel masks.

This procedure combines two channel masks. The result is stored in the first channel.