[Bf-python] BMesh python api proposal.

[Domino Marama]

On 02/20/2012 11:16 AM, Daniel Monteiro Basso wrote:
> On Mon, Feb 20, 2012 at 10:33 AM, Domino Marama
> <domino at dominodesigns.info <mailto:domino at dominodesigns.info>> wrote:
>
>     I think the confusion is because most people read _set as a verb,
>     not a noun.. I'd prefer something more obviously a noun like
>     .select_clump(True)
>
>
> It is actually a verb: "select_set(bool): set selection and flush,
> attribute only sets."
>
> It is the Yoda way of expressing it, object-verb, that makes sense
> because Blender is written in Japanese (just kidding :p )

So it's not SELECT (verb) a SET of things (noun)?

I'd have thought selection_set would have matched the description then,
but that doesn't clarify the flush behaviour. It's why I favoured clump
as it implies you are selecting more than you think :)

Flush is another term that'd need reading up on.. So the description
isn't that useful anyway..

> But my objection is more about things that looks the same but do
> different things... I learn a lot about the API by looking at other
> people's code, and sometimes assumptions about what seems obvious (it
> looks the same it does the same) is reason for losing time wondering
> WhyTF the code doesn't work.
>
>
Well clump is obviously different so I'll take that as a +1 :p

Just kidding, but something like:

select_clump(bool): set item and related features selection state.

seems pretty clear to me.. if "item" and "features" were specific to
context, so "vertex", "edges & faces" etc it'd be totally clear without
needing to dive for the api reference..
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.blender.org/pipermail/bf-python/attachments/20120220/4fffe220/attachment.html>