Page Comparison

...

Aptina Imaging software uses sensor specific .ini files for many of its applications. The .ini file contains groups of commands called presets. Each preset has a name enclosed in square brackets, like [83269893 Reset]. Some presets are required for the DevWare application; while others can be added by the user. The DevWare application provides several tools which will allow the user to create and edit ini presets. There is also a function in the ApBase API which allows the user to load a preset from an .ini file in their own custom application (see ap_LoadINIPreset()).

...

List of INI Commands

Command	Definition
83269893 BITFIELD	Write a value to a bitfield of a register.
83269893 DATATYPE	Define the data type and optional valid range of a named register or bitfield.
83269893 DELAY	Delay a certain amount of time (in milliseconds) before continuing.
83269893 ERROR_IF	Output an error message and stop execution if a condition is met.
83269893 FAR1	Write a value to a sensor register on the first attached camera.
83269893 FAR2	Write a value to a sensor register on the second attached camera.
83269893 FIELD_WR	Write to a register or bitfield by name. Command works for any kind of register, variable or SFR.
83269893 ICON	Define the icon for a User Toolbar button.
83269893 IF_FIELD	Similar to LOAD, but conditioned on the value of a register.
83269893 IF_REG	Similar to LOAD, but conditioned on the value of a register.
83269893 IF_SERIAL	Similar to IF_REG, but can access any device on the SHiP bus.
83269893 IMAGE	Set software to expect the given image size and type. Command does not change sensor mode.
83269893 LOAD	Load a preset from an ini file.
83269893 LOAD_PROM	Load a preset from an EEPROM.
83269893 LOG	Add a text string to the Log window.
83269893 MEM	Write a value to an SOC RAM location.
83269893 MEM8	Write a value to an 8-bit SOC RAM location.
83269893 MEM32	Write a value to a 32-bit SOC RAM location.
83269893 MENUITEM	Define sub-menu items for a User Toolbar button.
83269893 OPTION	Set a DevWare Option variable.
83269893 POLL_FIELD	Poll a register. Similar to DELAY, but conditioned on the value of a register.
83269893 POLL_REG	Poll a register. Similar to DELAY, but conditioned on the value of a register.
83269893 POLL_VAR	Poll a variable. Similar to DELAY, but conditioned on the value of a variable.
83269893 PROMPT	Give the user a multiple-choice dialog, or show a message.
83269893 PYTHON	Invoke a one-line Python statement.
83269893 REG	Write a value to a register.
83269893	Write a sequence of register values in one bus transaction.
83269893	Write image data to files.
83269893	Write register values to a file.
83269893	Set or detect the sensor SHiP base address.
83269893	Low-level write to Two-Wire Serial Interface register.
83269893	Write a value to a special function register, on certain sensors.
83269893	Write a value to an 8-bit special function register, on certain sensors.
83269893	Define a keyboard shortcut for a User Toolbar button.
83269893	Set a variable within the software, not on the sensor.
83269893	Define a tooltip for a User Toolbar button.
83269893	Write a value to a firmware variable.
83269893	Write a value to a 32-bit firmware variable.
83269893	Write a value to an 8-bit firmware variable.
83269893	Set the XMCLK (sensor external clock) frequency.

...

Anchor

	MENUITEM
	MENUITEM

MENUITEM = "<menu text>", LOAD= <preset> [, ICON= <icon name>] [,CHECKED|RADIO= <register name>[:<bitfield name>|:<mask>]|STATE:<STATE variable> <condition>] [,ENABLED= <register name>[:<bitfield name>|:<mask>]|STATE:<STATE variable> <condition>][,SHORTCUT=<key combination>] //<comment>

Defines a drop-down menu item for a User Toolbar button in DevWare. Only takes effect if the preset name begins with "Toolbar:" or "Toolbar2:". This command causes the toolbar button behavior to change to a drop-down menu action.

The 83269893 ICON=, CHECKED=, RADIO= and ENABLED= attributes work as in the ICON= command, except they apply only to the menu item, not the toolbar button. The icon file must be a .bmp (32-bpp, R-G-B-alpha) file, 13x13 pixels for the normal Windows text size. SHORTCUT= attribute works like the SHORTCUT= command, but applies only to this menu item.

If ICON= is used then CHECKED= or RADIO= will may have no visible effect depending on OS or GUI library.

The maximum number of menu items on a single toolbar button is 25.

Example: Group multiple presets under one button, with a separator between Parallel and HiSPi.
[Toolbar: 1280x720]
MENUITEM= "Parallel 1280x720 36.19fps", LOAD= Parallel 1280x720 36.19fps XBin2YBin2_BinSum
MENUITEM= "Parallel 1280x720 51.69fps", LOAD= Parallel 1280x720 51.69fps XBin2YSkip2_ColSum2
MENUITEM="-"
MENUITEM= "HiSPi 1280x720 51.69fps", LOAD= HiSPi 1280x720 51.69fps XBin2YSkip2_ColSum2

Example: Image Orientation control for a SMIA sensor using radio button icons
[Toolbar: Orientation]
MENUITEM= "Normal", LOAD= Normal, RADIO= IMAGE_ORIENTATION==0
MENUITEM= "Mirror", LOAD= Horiz Mirror, RADIO= IMAGE_ORIENTATION==1
MENUITEM= "Flip", LOAD= Vertical Flip, RADIO= IMAGE_ORIENTATION==2
MENUITEM= "Rotate 180", LOAD= Rotate 180, RADIO= IMAGE_ORIENTATION==3
[Normal]
FIELD_WR= IMAGE_ORIENTATION, 0
[Horiz Mirror]
FIELD_WR= IMAGE_ORIENTATION, 1
[Vertical Flip]
FIELD_WR= IMAGE_ORIENTATION, 2
[Rotate 180]
FIELD_WR= IMAGE_ORIENTATION, 3

Note: if "LOAD=" is not supplied, then that MENUITEM will be disabled but still displayed.
To to provide visual separators between MENUITEM sections, use MENUITEM= "-".

See also the ICON=, SHORTCUT= and TOOLTIP= commands.

...

Versions Compared

Old Version 35

New Version 36

Key

List of INI Commands