ps_show(3) [php man page]

PS_SHOW(3)								 1								PS_SHOW(3)

ps_show - Output text

SYNOPSIS

       bool ps_show (resource  $psdoc, string  $text)

DESCRIPTION

	Output	a  text  at  the  current text position. The text position can be set by storing the x and y coordinates into the values textx and
       texty with the function ps_set_value(3). The function will issue an error if a font was not set before with ps_setfont(3).

       ps_show(3) evaluates the following parameters and values as set by ps_set_parameter(3) and ps_set_value(3).

	      o charspacing (value)
		- Distance between two consecutive glyphs. If this value is unequal to zero then all ligatures will be resolved. Values less  than
		zero are allowed.

	      o kerning (parameter)
		- Setting this parameter to "false" will turn off kerning. Kerning is turned on by default.

	      o ligatures (parameter)
		- Setting this parameter to "false" will turn off the use of ligatures. Ligatures are turned on by default.

	      o underline (parameter)
		- Setting this parameter to "true" will turn on underlining. Underlining is turned off by default.

	      o overline (parameter)
		- Setting this parameter to "true" will turn on overlining. Overlining is turned off by default.

	      o strikeout (parameter)
		- Setting this parameter to "true" will turn on striking out. Striking out is turned off by default.

PARAMETERS

	      o $psdoc
		- Resource identifier of the postscript file as returned by ps_new(3).

	      o $text
		- The text to be output.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

SEE ALSO

       ps_continue_text(3), ps_show_xy(3), ps_setfont(3).

PHP Documentation Group 														PS_SHOW(3)

PS_TRANSLATE(3) 							 1							   PS_TRANSLATE(3)

ps_translate - Sets translation

SYNOPSIS

       bool ps_translate (resource  $psdoc, float  $x, float  $y)

DESCRIPTION

	Sets a new initial point of the coordinate system.

PARAMETERS

	      o $psdoc
		- Resource identifier of the postscript file as returned by ps_new(3).

	      o $x
		- x-coordinate of the origin of the translated coordinate system.

	      o $y
		- y-coordinate of the origin of the translated coordinate system.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Translation of the coordinate system

	      <?php
	      function rectangle($ps) {
		  ps_moveto($ps, 0, 0);
		  ps_lineto($ps, 0, 50);
		  ps_lineto($ps, 50, 50);
		  ps_lineto($ps, 50, 0);
		  ps_lineto($ps, 0, 0);
		  ps_stroke($ps);
	      }

	      $ps = ps_new();
	      if (!ps_open_file($ps, "translate.ps")) {
		print "Cannot open PostScript file
";
		exit;
	      }

	      ps_set_info($ps, "Creator", "translate.php");
	      ps_set_info($ps, "Author", "Uwe Steinmann");
	      ps_set_info($ps, "Title", "Translated example");
	      ps_set_info($ps, "BoundingBox", "0 0 596 842");

	      $psfont = ps_findfont($ps, "Helvetica", "", 0);

	      ps_begin_page($ps, 596, 842);
	      ps_set_text_pos($ps, 100, 100);
	      ps_translate($ps, 500, 750);
	      rectangle($ps);
	      ps_translate($ps, -500, -750);
	      ps_setfont($ps, $psfont, 8.0);
	      ps_show($ps, "Text at initial position");
	      ps_end_page($ps);

	      ps_begin_page($ps, 596, 842);
	      ps_set_text_pos($ps, 100, 100);
	      ps_save($ps);
	      ps_translate($ps, 500, 750);
	      rectangle($ps);
	      ps_restore($ps);
	      ps_setfont($ps, $psfont, 8.0);
	      ps_show($ps, "Text at initial position");
	      ps_end_page($ps);

	      ps_delete($ps);
	      ?>

	      The  above  example  demonstrates  two possible ways to place a graphic (in this case just a rectangle) at any position on the page,
	      while the graphic itself uses its own coordinate system. The trick is to change the origin of the current coordinate  system  before
	      drawing the rectangle. The translation has to be undone after the graphic has been drawn.

	       On the second page a slightly different and more elegant approach is applied. Instead of undoing the translation with a second call
	      of ps_translate(3) the graphics context is saved before modifying the coordinate system and restored after drawing the rectangle.

SEE ALSO

       ps_scale(3), ps_rotate(3).

PHP Documentation Group 													   PS_TRANSLATE(3)