documentation for -annotate XdegreesxYdegrees text

Post any defects you find in the released or beta versions of the ImageMagick software here. Include the ImageMagick version, OS, and any command-line required to reproduce the problem. Got a patch for a bug? Post it here.
Post Reply
User avatar
yecril71pl
Posts: 81
Joined: 2011-02-08T11:06:09-07:00
Authentication code: 8675308
Location: Warsaw, Poland
Contact:

documentation for -annotate XdegreesxYdegrees text

Post by yecril71pl »

I am reading the document ImageMagick: Command-line Options [1]:
The values Xdegrees and Ydegrees control the shears with respect to the , respectively, applied to the text
I beg your pardon? :shock:
Besides, it would be nice if ImageMagick actually recognised the syntax X°×Y°.
___
[1] [url]file:///usr/share/doc/packages/ImageMagick/www/command-line-options.html#annotate[/url]
User avatar
fmw42
Posts: 25562
Joined: 2007-07-02T17:14:51-07:00
Authentication code: 1152
Location: Sunnyvale, California, USA

Re: documentation for -annotate XdegreesxYdegrees text

Post by fmw42 »

XdegreesxYdegrees are just numbers. the "degrees" part is not specified. the function just assumes the values of X and Y are in degrees rather than radians or some other units. Documentation might be better if it said XxY where X and Y are in units of degrees. But it seems clear to me, nevertheless.

Do I misunderstand your question?
User avatar
yecril71pl
Posts: 81
Joined: 2011-02-08T11:06:09-07:00
Authentication code: 8675308
Location: Warsaw, Poland
Contact:

Re: documentation for -annotate XdegreesxYdegrees text

Post by yecril71pl »

Did you read the quoted paragraph? Can you understand it?
Besides, the documented syntax does not work:

Code: Select all

convert 1.tiff -annotate 0 +710 +1570 SAD 1a.tiff
convert: unable to open image `+1570': /usr▒²©Ú64/Image`²©Úÿ @ error/blob.c/OpenBlob/2489.
convert: unable to open image `SAD': /usr▒²©Ú64/Image`²©Úÿ @ error/blob.c/OpenBlob/2489.
Also, note the rubbish displayed in the error messages.
The correct syntax seems to be:
-annotate XxY±tx±ty text
(with no spaces)
Furthermore, the image ../images/annotate.png embedded below the text is not present.
User avatar
magick
Site Admin
Posts: 11064
Joined: 2003-05-31T11:32:55-07:00

Re: documentation for -annotate XdegreesxYdegrees text

Post by magick »

Try this:
  • convert 1.tiff -annotate 0x0+710+1570 SAD 1a.tiff
User avatar
yecril71pl
Posts: 81
Joined: 2011-02-08T11:06:09-07:00
Authentication code: 8675308
Location: Warsaw, Poland
Contact:

Re: documentation for -annotate XdegreesxYdegrees text

Post by yecril71pl »

OTOH, the command

Code: Select all

convert null: -annotate 0 +710 +1570 SAD null:
does not do anything wrong:
convert: unable to open image `+1570': /usr/lib64/ImageMagick-6.6.1/modules-Q16/coders/null.la @ error/blob.c/OpenBlob/2489.
convert: unable to open image `SAD': /usr/lib64/ImageMagick-6.6.1/modules-Q16/coders/null.la @ error/blob.c/OpenBlob/2489.
But try this:

Code: Select all

convert logo: -annotate 0 +710 +1570 SAD null: |&  LANG=C iconv
and the message is screwed up:
convert: unable to open image `+1570': `iconv: illegal input sequence at position 40
Last edited by yecril71pl on 2011-03-05T05:51:21-07:00, edited 1 time in total.
User avatar
fmw42
Posts: 25562
Joined: 2007-07-02T17:14:51-07:00
Authentication code: 1152
Location: Sunnyvale, California, USA

Re: documentation for -annotate XdegreesxYdegrees text

Post by fmw42 »

geometry arguments (including those in annotate) MUST not have spaces in them!

see http://www.imagemagick.org/script/comma ... p#geometry

"The geometry argument might take any of the forms listed in the table below. These will described in more detail in the subsections following the table. The usual form is size[offset], meaning size is required and offset is optional. Occasionally, [size]offset is possible. In no cases are spaces permitted within the geometry argument."
User avatar
yecril71pl
Posts: 81
Joined: 2011-02-08T11:06:09-07:00
Authentication code: 8675308
Location: Warsaw, Poland
Contact:

Re: documentation for -annotate XdegreesxYdegrees text

Post by yecril71pl »

I know the command line is wrong. However, it is not a justification for convert to spit out rubbish to standard error.

It seems, however, that the problem has been partially fixed in 6.6.5. However, from the output of 6.6.1 it seems the presumed format of the error message is library path @ source file, but the library does not come up in 6.6.5. This, however, may be due to the fact that I upgraded libtool to 2.4 (the one distributed with ImageMagick is old and buggy).

Reported downstream.
Post Reply