Author DahlitzFlorian
Recipients DahlitzFlorian, cajetan.rodrigues, docs@python, guchao, terry.reedy
Date 2020-05-24.13:56:43
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1590328603.78.0.0683759172712.issue40283@roundup.psfhosted.org>
In-reply-to
Content
I tested it and can confirm the findings from @cajetan.rodrigues. However, this does not seem to be _not_ documented. The documentation clearly states that using a positive value for radius results in a counter-clockwise direction, whereas a negative number results in a clockwise direction. This is true.

Now, let's have a look at using radius _together_ with extent, which is not (clearly) documented as this point. Using a positive value results in the same direction, but in a not full drawn circle. This seems intuitive and is documented:

    If extent is not given, draw the entire circle.
    If extent is not a full circle, one endpoint of the arc is the current pen position.

Using a negative value changes the direction of radius, which does also seem reasonable and intuitive.

My suggestion is not to replace "radius" by "extent" as suggested by @guchao as it is IMHO wrong. But I agree that it would be good to leave a note there or to add examples demonstrating the behaviour of different (signed) values of radius and extent, so the intent and behaviour is clearly documented.
History
Date User Action Args
2020-05-24 13:56:43DahlitzFloriansetrecipients: + DahlitzFlorian, terry.reedy, docs@python, cajetan.rodrigues, guchao
2020-05-24 13:56:43DahlitzFloriansetmessageid: <1590328603.78.0.0683759172712.issue40283@roundup.psfhosted.org>
2020-05-24 13:56:43DahlitzFlorianlinkissue40283 messages
2020-05-24 13:56:43DahlitzFloriancreate