REPORTER 22.1

Using Capture to Create a PRIMER Object

Using Capture to create a PRIMER object

From version 13.0 of REPORTER it is possible to specify the size or aspect ratio of the image created from PRIMER . This can be changed in the Image properties section. If you want to specify a particular aspect ratio or graphics size you can change this. The available options for Size are:

  • Free size
  • Fit object box
  • 4:3 aspect ratio
  • 16:9 aspect ratio
  • 16:10 aspect ratio
  • Custom aspect ratio
  • Fixed size

The default option from version 17.0 onwards is Fit object box . With this option, PRIMER will capture an image using a graphics window with the same aspect ratio as the object's dimensions in REPORTER .

In previous versions of REPORTER , the default option was Free size . With this option, the size of the graphics window is calculated by PRIMER . The actual size will depend on what resolution the monitor is and what scale factors you have chosen for the user interface. This can cause problems if the template is created on one type of display (e.g. a 16:9 monitor) but played back on a different ratio monito (e.g. a 4:3 ratio monitor) as the image size can change and so the output from REPORTER can look different. To make output consistent you can use the other options:

Fit object box will make PRIMER create a graphics window that has the same aspect ratio as the object box dragged in REPORTER .
4:3 aspect ratio , 16:9 aspect rati o and 16:10 aspect ratio will make PRIMER create a window with the specified aspect ratio.
Custom aspect ratio or Fixed size allow you specify a custom width and height. Fixed size will make PRIMER create an image with the specified width and height. Custom aspect ratio will make PRIMER create the largest image it can with the aspect ratio width:height.

If you want to specify an image size it should be specified before the capture is done in PRIMER .

To start PRIMER press the Capture button. PRIMER will then automatically record a macro containing all of the commands that you do. When you have finished do File and => to return to REPORTER .
REPORTER will then prompt you to replace any filenames in the macro with variables. You can choose which variables you would like to replace. Alternatively you can replace any variables yourself manually later on (see below).
The Edit PRIMER object information window will then be updated as shown below.

REPORTER will automatically give a name for the bitmap file but you can change it to whatever you want. If required you can edit the macro by using the Edit... button next to the Macro file textbox (which in the above image shows that it contains 25 lines). This is useful to replace any filenames with variables if required (right click with the mouse or press Ctrl+I in the macro to insert variables). The macro will be saved in the REPORTER template.

As well as using a macro a JavaScript can also be specified to run in PRIMER . The Edit... button next to the JavaScript textbox can be used to load and edit a JavaScript. The JavaScript will be saved in the REPORTER template.

If a macro contains picking, dragging or dynamic viewing commands then PRIMER needs to maintain the aspect ratio of the graphics window so that they can be replayed correctly. If it dd not do this then the pick command would pick at a different location and it may not work correctly.
When a macro is recorded REPORTER scans the macro for any picking, dragging or dynamic viewing commands. If the macro does not contain any then the image size can be changed after capturing if required.
For example in the image above a macro has been recorded but as it does not contain any picking, dragging or dynamic viewing commands the Size can be changed from Free size if required.
If the macro does contain picking, dragging or dynamic viewing commands then REPORTER will change the image size to a fixed size and not allow it to be chnaged, to ensure that the macro will replay correctly.
For example in the image below a macro has been recorded but and it as does contain picking, dragging or dynamic viewing commands the Size has been changed to Fixed size and cannot be changed.