pure-data / pddp

Pure Data Documentation Project
9 stars 2 forks source link

document list method to objects with a single inlet, where it gets accepted and truncated to the first value #253

Open porres opened 2 weeks ago

porres commented 2 weeks ago

number and symbol boxes can take lists, where it trunctaes to the 1st element, and this is not documented

umlaeute commented 2 weeks ago

is this different from any other object that has a float xor symbol inlet? does it need to and if not, isn't this already documented (e.g. 2.control.examples/04.messages.pd)

porres commented 2 weeks ago

is this different from any other object that has a float xor symbol inlet?

it seems this didn't use to be the case before we got the list box object

I had to think for a moment of a similar object to test, and, well, slider takes lists as well and truncates indeed.

porres commented 2 weeks ago

Ok, so indeed we have an issue. For consistency reasons, I can't document this in gui boxes but ignore in iemguis...

On the other hand, if there is some sort of hidden and golden rule on how an object with a single inlet behaves with list input, this must be clear somewhere.

I'm now looking for other objects besides the iemguis and the first I see is [makefilename] that also works that way... so, yeah, there is some sort of hidden and golden rule :)

[tabread] follows suit, so does: [expr] [abs] and other unary operators and trigonometric functions [mtof] and other accoustic conversion

and I might be missing others, anyway, I must revert the changes and document this 'rule' somewhere

millerpuckette commented 2 weeks ago

I would suggest a pointer to one common location where it's explained how floats, lists, symbols, and bangs are treated by inlets.  (I think this is in the "theory of operation" already, no?) - otherwise you're copying the same info to over 100 help files.

cheers

Miller

On 10/8/24 11:06 AM, porres wrote:

Ok, so indeed we have an issue. For consistency reasons, I can't document this in gui boxes but ignore in iemguis...

On the other hand, if there is some sort of hidden and golden rule on how an object with a single inlet behaves with list input, this must be clear somewhere.

I'm now looking for other objects besides the iemguis and the first I see is [makefilename] that also works that way... so, yeah, there is some sort of hidden and golden rule :)

[tabread] follows suit, so does: [expr] [abs] and other unary operators and trigonometric functions [mtof] and other accoustic conversion

and I might be missing others, anyway, I must revert the changes and document this 'rule' somewhere

— Reply to this email directly, view it on GitHub https://urldefense.com/v3/__https://github.com/pure-data/pddp/issues/253*issuecomment-2400253740__;Iw!!Mih3wA!CkspTHZcV4ExThf4jqOkYZzom_6y55PDFC2dFw5L_dXbOh0ktqzn2HzSG0fKHZWkJJDKPSWuQDnDJQruqBhw$, or unsubscribe https://urldefense.com/v3/__https://github.com/notifications/unsubscribe-auth/AARTRY4BYJH4LDV34C2FFJTZ2P7HHAVCNFSM6AAAAABPQ4CGSWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIMBQGI2TGNZUGA__;!!Mih3wA!CkspTHZcV4ExThf4jqOkYZzom_6y55PDFC2dFw5L_dXbOh0ktqzn2HzSG0fKHZWkJJDKPSWuQDnDJdysF1Ko$. You are receiving this because you are subscribed to this thread.Message ID: @.***>

porres commented 2 weeks ago

I just reverted the change, I'm changing the title of this issue now

porres commented 2 weeks ago

thinking properly about this, it is in fact the same rule of distributing the list to multiple intlets... but we just have a single inlet :)

well, will try to make this clearer!

porres commented 2 weeks ago

the control tutorial example 04.messages has wrong information where it says that lists get distributed ONLY if the object has more than one inlet... so it needs to be fixed.

Also, there's a section in the manual about this ("2.7.4. Inlets and lists") and we need to improve and also take care there .

I also mean to have an abstraction to include in all reference subpatches with a guide and information on how to read the reference information that would also treat this issue. See https://github.com/pure-data/pddp/issues/96