synthSP(n)

SYNOPSIS

synthSP model-file [ -help ] [ -i filename ] [ -o filename ] [ -c image-columns ] [ -r image-rows ] [ -x resolution ] [ -y resolution ] [ -f focal-length ] [ -s set-name ] [ -N entity-index | -n entity-position ] [ -b background ]

DESCRIPTION

synthSP generates a synthetic image of a polyhedral object. The required inputs are an object model which can be produced using polymdl(n), and the parameters of a transformation between the camera and to model coordinate systems.

Six transformation parameters are required: three rotational parameters, theta, phi and gamma, and three translational, in the x-, y- and z-directions. The data produced by hypoth(n) and verify(n) is suitable. The output image is in PGM P5 format.

OPTIONS

For options that take parameters, there must be a space between the option letter and the parameter.
-help
List the options available and the default values used.
-i filename
Read the transformation parameters from the named file. A dash specifies the standard input.
-o filename
Write the synthetic image to the named file instead of the standard output.
-c image-columns
The width of the image, in pixels. The default is 256.
-r image-rows
The height of the image, in pixels. The default action is to assume that the number of rows is the same as the number of columns.
-f focal-length
The focal length of the simulated camera, in millimetres. The default is 12.0.
-x resolution
The horizontal resolution of the simulated camera CCD, in millimetres per pixel. The default is 0.008.
-y resolution
The vertical resolution of the simulated camera CCD, in millimetres per pixel. The default action is to assume that the vertical resolution is the same as the horizontal resolution.
-s set-name
The name of the .gf set that contains the transformation data. If this option is not specified, the first set in the file will be used.
-N entity-index
The index number of the entity within the .gf set from which the transformation data is to be obtained. The index number is assumed to be the first token of the entity. -n entity-position The position of the entity within the .gf set from which the transformation data is to be obtained. Only one of the options -n and -N may be specified. If neither are given, the first entity in the set is used.
-b grey-level
The grey level value to be used as the background of the image.

SEE ALSO

gf (5), polyhSP (n)

AUTHOR

Copyright (C) 1994 by Steve Procter.
02-Nov-94. Automatically converted by man2html, written by G.Matas (g.matas@ee.surrey.ac.uk)