[Elphel-support] elphel php api / documentation update?

[Michael Aschauer]

applied mentioned changes to the wiki...

m,-


Am 2010-11-03 16:53, schrieb Sebastian Pichelhofer:
> The wiki php documentation is mostly still at 7.X software level so
> any changes or additions that update the functions to 8.X are highly
> appreciated ;)
>
> On Wed, Nov 3, 2010 at 16:49, Michael Aschauer<m at ash.to>  wrote:
>>
>> I just noticed why my camera behaved so unpredictable and unstable recently.
>> It's likely it has nothing to do with heat or hardware problems but a simple
>> (and very stupid) error in the php script I used to change parameters that
>> (could) result in wait_frame calls that never finished.
>>
>> That's most likely my own fault, but there are two problems I see here:
>>
>> * a simple error or example script like below waiting endlessly for a frame
>> that does not arrive soon, renders all webinterfaces or php-scripts via http
>> unusable (until you reboot or kill php)
>> <? elphel_wait_frame_abs(123909090); ?>
>>
>> * the elphel php documentation
>> (http://wiki.elphel.com/index.php?title=PHP_in_Elphel_cameras) is not
>> exactly up to date.
>> at least I found the changes mentioned below...
>>
>> best,
>> m,-
>>
>>
>> ####################################
>>
>> from the wiki:
>>
>> <snip>
>> elphel_set_P_arr
>>
>> long elphel_set_P_arr (array $input)
>>
>> Write multiple camera parameters, provided as an associative array, where
>> keys are parameter names same as defined Elphel_PHP_constants, but without
>> "ELPHEL_" prefix. Values should be numeric and integer, all other types are
>> ignored.
>>
>> Return value - number of successfully processed elements.
>> </snip>
>>
>>
>> whereas according to the source it should be:
>>
>>
>> <snip>
>> long elphel_set_P_arr (array $input, long $frame, long $flag)
>>
>> ...
>>
>> optional arguments:
>>   frame - frame number to write these parameters to - if not specified
>> default framedelay (current frame + 3) is applied)
>>   flag - possible flags?
>>
>> Return value - frame number to which parameters were written
>> </snip>
>>
>>
>> and here's the matching call from parsedit.php:
>>
>> <snip>
>> elphel_set_P_arr ($pgmpars,
>> $frame_zero+$since,ELPHEL_CONST_FRAMEPAIR_FORCE_NEWPROC); /// Are these
>> flags needed?
>> </snip>
>>
>>
>> ####################################
>>
>> Also there are at least two undocumented functions:
>>
>> elphel_wait_frame_abs(long frame)
>>
>> wait for absolute frame number (includes those that are not compressed)
>>
>> elphel_skip_frames(long frames)
>>
>> skip some frames (includes those that are not compressed) - will work even
>> if no frames are compressed
>>
>> _______________________________________________
>> Support-list mailing list
>> Support-list at support.elphel.com
>> http://support.elphel.com/mailman/listinfo/support-list_support.elphel.com
>>


-- 
Michael Aschauer
------------------------
--> www: http//m.ash.to
--> mailto: m at ash.to
--> call: +4369918200236