Support for "-label" and examples for Layering PSD/TIFF files

[cbitterfield]

I spent two days working on the API connector for python. I am finding it very difficult to create an API call in wand to match the convert command I am using.

The project is to create a layered image with PSD or Layered TIFF. I have this working with "convert". The wand CLI reference is missing "-label" for the layers and the documentation does not demonstrate with an example of how to create a layered image (either in TIFF or PSD) which is different than a frame in a sequenced GIF.

Request(s):

1. Update the API to allow labeling similar to "-label" from the command line for the layer name (not the text label)
2. Update the documentation to so how to create either a layered PSD or TIFF file.

The iterator function does not seem to provide the desired effect. Each layer is based on a set of "()".

This is a template that I use in Python for executing the CLI version of CONVERT. I am trying to do the work via the API.

 # Create Box Cover Command Template
    CMD_TEMPLATE =  """
            $CONVERT \( -size ${WIDTH}x${HEIGHT} -density $DENSITY -label 'background' -background transparent xc:none -depth 8 -set colorspace:auto-grayscale off  \)  \\
            \( -label 'imageA' '${FINALDESTINATION}/${EDGEID}${SUFFIX}${BACK_SUFFIX}${EXT}' \)  \\
            -label 'title' \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity ${TITLE_GRAVITY} -font ${FONT} -pointsize ${TITLESIZE} -fill ${COLOR} label:"${TITLE}" \)  \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \) \\
            -label 'star' \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity ${GRAVITY} -font ${FONT} -pointsize ${STARSIZE} -fill ${COLOR} label:'${STAR}' -splice x250 \)  \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \) \\
            -label 'supporting'   \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity ${GRAVITY} -font  ${FONT} -pointsize ${SUPPORTINGSIZE} -fill ${COLOR} label:'${SUPPORTING}' -splice x550 \)  \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \) \\
            -label 'shorttitle' \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity west -font ${FONT} -interline-spacing -75 -pointsize ${SHORTTITLESIZE} -fill ${COLOR} label:'${SHORTTITLE}'   \) \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \) \\
            -label 'edgeid' \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity Southwest -font ${FONT} -pointsize ${EDGEIDSIZE} -fill ${COLOR} label:'${EDGEID}' \)  \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \)  \\
            -label 'logo' \( \( -size ${WIDTH_DELTA}x${HEIGHT_DELTA}  -background transparent  -gravity SouthEast -font /edge/JobCard2/font/ArialBlack.ttf -pointsize ${EDGEIDSIZE} -interline-spacing -10 -fill ${COLOR} label:'Edge/Picticon' \) \( +clone -background black -shadow 100x3+15+15  \) +swap -composite \)  \\
            -label 'blank' \(  -size ${WIDTH}x${HEIGHT} -background transparent  -gravity SouthEast -font ${FONT} -pointsize ${EDGEIDSIZE} -fill ${COLOR} label:'' \)  \\
            -gravity center -extent ${WIDTH}x${HEIGHT}  ${BOXPSD};  $CONVERT $BOXPSD  -flatten $BOXIMG
            """

[emcconville]

Moving this to discussion as it's not a issue/bug.

Update the API to allow labeling similar to "-label" from the command line for the layer name (not the text label)

The set option -label CLI argument is already supported in Wand through Image.options['label'], or through Image.metadata['label'] -- depending on coder and/or usage.

Update the documentation to [show] how to create either a layered PSD or TIFF file.

It's true that the documentation is behind. Hopefully community members will start sharing solutions in Discussions "Show & Tell", and help each other until a technical writer is willing to contribute to this project.