[AD] [ alleg-Bugs-1398948 ] add_clip_rect docs is wrong

["SourceForge.net" <noreply@xxxxxxxxxx>]

Bugs item #1398948, was opened at 2006-01-06 16:46
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105665&aid=1398948&group_id=5665

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Nobody/Anonymous (nobody)
Assigned to: Nobody/Anonymous (nobody)
Summary: add_clip_rect docs is wrong

Initial Comment:
In the html help file, under category "Bitmap Objects"
the caption for add_clip_rect says : "*Expands* a
bitmap's clipping rectangle with a new area."

This is inconsistent with what it says later in the
actual doc entry for add_clip_rect, where it says: "
Sets the clipping rectangle of the specified bitmap as
the *intersection* of its current clipping rectangle
and the rectangle described by the four coordinates."

expanding == making something bigger
intersection == the portion of two rectangles that
matches both (either empty or another rectangle)

Now consider this:
let A be the current clipping rectangle
let B be a rectangle that FULLY includes A

setting B via a call to add_clip_rect would then result
in A still being the resulting clipping rectangle.

In other words, nothing *expands* in this case.

- (Dennis-Busch@xxxxxxxxxx) -


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105665&aid=1398948&group_id=5665