W3C home > Mailing lists > Public > whatwg@whatwg.org > June 2009

[whatwg] drawImage() - image argument description for animation

From: OmegaJunior <omegajunior@omegajunior.net>
Date: Mon, 22 Jun 2009 23:48:37 +0200
Message-ID: <fdd21a0e0906221448r47bd549av961e89dc33e84b29@mail.gmail.com>
Currently the drawImage() function defines the following behaviour for
its image argument if that happens to represent an animation:

"When the drawImage() method is passed, as its image argument, an
HTMLImageElement representing an animated image, the poster frame of
the animation, or the first frame of the animation if there is no
poster frame, must be used."

This seems grammatically incorrect (but isn't). However, I found it a
bit convoluted, and had to read it several times before understanding
what was intended. Perhaps the following improves its transparency:

"If the HTMLImageElement passed to the drawImage() method represents
an animation, then the poster frame of that animation, or its first
frame if there is no poster frame, must be used."

I'll argue that mentioning that the image is supposed to be passed as
the method's image argument appears redundant, which means it can be
omitted without losing accuracy.

Received on Monday, 22 June 2009 14:48:37 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 22 January 2020 16:59:13 UTC