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 section. If you want to specify a particular aspect ratio or graphics size you can change this. The available options for 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 . 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 . 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:
will make
PRIMER
create a graphics window that has the same aspect ratio as the object box dragged in
REPORTER
.
,
o and
will make
PRIMER
create a window with the specified aspect ratio.
or
allow you specify a custom width and height.
will make
PRIMER
create an image with the specified width and height.
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
button.
PRIMER
will then automatically record a macro containing all of the commands that you do. When you have finished do
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
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 button next to the 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 button next to the 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
can be changed from
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
has been changed to
and cannot be changed.
