hive-gimp.verbs.layer — io.github.hive-agi/hive-gimp 0.3.4

PURE. Verbs over GIMP layers and groups: find, create, insert, name, visibility, opacity and offsets. Non-destructive by construction: nothing here merges, clears or deletes; supersede is how a retry replaces a layer (a new layer above it, the old one hidden).

get-by-id clj

(get-by-id id)

The layer with id id, or nil.

get-offsets clj

(get-offsets layer)

The Offsets of layer's top-left corner.

insert clj

(insert image layer {:keys [parent position] :or {position 0}})

Insert layer into image under :parent (nil: top level) at :position (default 0, the top). Answers the layer.

new-group clj

(new-group image {:keys [name as] :or {as (quote hg-group)} :as opts})

A new layer group in image, inserted at :position under :parent and bound to :as (default hg-group). Answers its Ref.

new-layer clj

(new-layer image
           {:keys [name width height type opacity as]
            :or {type :rgba opacity 100 as (quote hg-layer)}
            :as opts})

A new transparent layer in image, sized to the image unless :width and :height say otherwise, inserted at :position under :parent and bound to :as (default hg-layer). Answers its Ref.

NewGroup clj

NewLayer clj

Placement clj

set-name clj

(set-name item item-name)

Rename item. GIMP appends " #1" when the name is taken anywhere in the image. Answers the item.

set-offsets clj

(set-offsets layer {:keys [x y]})

Move layer so its top-left corner is at :x, :y. Answers the layer.

set-opacity clj

(set-opacity layer opacity)

Set layer's opacity, in percent. Answers the layer.

set-visible clj

(set-visible item visible?)

Show or hide item. Answers the item.

supersede clj

(supersede image old opts)

The non-destructive retry: a new layer (NewLayer options, :parent and :position ignored) directly above old in image, then old hidden. Answers the new layer.