Difference between revisions of "Parsedit.php"

Revision as of 17:36, 7 April 2009

parsedit.php is designed to provide access to the camera acquisition related parameters through the web browser. It is easy to create customized parameter view/edit form with specially configured URL. Arguments included in the URL instruct parsedit.php:

• optional page title
• optional image preview and it size
• optional "test" checkbox (and the default state of this checkbox). When enabled the camera compressor will start before the parameter change sequence and stop after the sequence is over so the acquired images will not be overwritten in the circular buffer and could be analyzed
• optional "showseq" checkbox (and its state) that enables debug information output during application of the sequence to the camera and the sensor.
• optional annotated image sequence (useful to see the latencies of the different parameter changes)
• what parameters are to be included in the page and what to do with them:
  • show them in readonly mode
  • include the current parameter value as the default in the input field(s)
  • specify the new parameter value as the default in the input field(s)
  • specify when (to what frame number in the future) the parameter change should be applied. It is possible to schedule several changes to the same parameter.

Parameters are specified in the URL, starting with the "?" before the first parameter, separated by "&". Each parameter may be just a name or a name=value pair. When the page opens, it includes multiple input fields and several control buttons, pressing button "apply" submits the form to the same parsedit.php in POST mode - this is when the new parameter values are applied to the camera. Most controls and parameter names have "tooltips" - short help messages that open when you hold mouse pointer over those page elements.

When you open the parsedit.php with no parameters it shows some usage examples - you may view them why hovering mouse pointer over the links or copy those links and edit them to match your particular application.

All URL parameters belong to one of the two groups - special directives and the actual camera parameters. Here are the directives:

• title=some+page+title - specify page title (parsing escaped special characters, "+" may be used instead of spaces)
• shownumbers - if present, each parameter number is shown in addition to the symbolic name
• embedor embed=0.1 - include preview image, with optional image size relative to page width (10% in the example)
• test (test=0 or test=1) include check box for the test mode, set the default state to off (0) or on (1)
• showseq (showseq=0 or showseq=1) include check box for the debug (show sequence) mode, set the default state to off (0) or on (1)
• images (images=numer_of_images:number_per_row:image_scale) - normally this directive is used from inside the generated page, but it is possible to provide it manually also. In that case it will open the page with the table with the last acquired images and annotate them using the Exif data.

The rest of the parsedit.php url parameters deal with the actual camera parameters.