Programmer Guide/Command Reference/EVAL/pginit - Revision history

Christian at 18:10, 21 April 2011

2011-04-21T18:10:43Z

← Older revision		Revision as of 20:10, 21 April 2011
Line 5:		Line 5:
	:;<var>N</var>:The requested number of simple polygons:		:;<var>N</var>:The requested number of simple polygons:
	::{\|class="keinrahmen"		::{\|class="keinrahmen"
	\|<var>N</var><=0 \|\|undefined, polygons are counted during initialization		\|<var>N</var>≤0 \|\|undefined, polygons are counted during initialization
	\|-		\|-
	\|<var>N</var>>0 \|\| exactly <var>N</var> simple polygons must be contained in <var>X</var>		\|<var>N</var>>0 \|\| exactly <var>N</var> simple polygons must be contained in <var>X</var>
	\|}		\|}
	:;<var>E</var>:The maximum error for polygon simplification. If <var>E</var><=0 the simplification is skipped.		:;<var>E</var>:The maximum error for polygon simplification. If <var>E</var>≤0 the simplification is skipped.
	:;Result:A [[../#polygons\|polygon-stream]] <var>P</var> containing all simple-polygons defined by <var>X</var>. The function failes if:		:;Result:A [[../#polygons\|polygon-stream]] <var>P</var> containing all simple-polygons defined by <var>X</var>. The function failes if:
	::*no simple polygons can be found or one of the detected polygons is invalid		::*no simple polygons can be found or one of the detected polygons is invalid

193.171.195.48 at 10:30, 21 April 2011

2011-04-21T10:30:44Z

← Older revision		Revision as of 12:30, 21 April 2011
Line 14:		Line 14:
	::*<var>N</var>>0 and the number of polygons defined by <var>X</var> is not equal to <var>N</var>		::*<var>N</var>>0 and the number of polygons defined by <var>X</var> is not equal to <var>N</var>
	;See also: [[../pgget\|pgget]], [[../pgitest\|pgitest]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]		;See also: [[../pgget\|pgget]], [[../pgitest\|pgitest]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]


	[[../#Functions\|<function list>]]		[[../#Functions\|<function list>]]

Toni at 13:00, 18 April 2011

2011-04-18T13:00:47Z

← Older revision		Revision as of 15:00, 18 April 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	Check or ~~initialise~~ a polygon stream.		Check or initialize a polygon stream.
	;Usage:<code>pginit(<var>X</var> {, <var>N</var>=0, {number}<var>E</var>=0} )</code>		;Usage:<code>pginit(<var>X</var> {, <var>N</var>=0, {number}<var>E</var>=0} )</code>
	:;<var>X</var>:A [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>X</var>:A [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.

Toni at 12:45, 18 April 2011

2011-04-18T12:45:07Z

← Older revision		Revision as of 14:45, 18 April 2011
Line 1:		Line 1:
	{{DISPLAYTITLE:{{SUBPAGENAME}}}}		{{DISPLAYTITLE:{{SUBPAGENAME}}}}
	Check or initialise a polygon stream.		Check or initialise a polygon stream.
	;Usage:<code>~~pgInit~~(<var>X</var> {, <var>N</var>=0, {number}<var>E</var>=0} )</code>		;Usage:<code>pginit(<var>X</var> {, <var>N</var>=0, {number}<var>E</var>=0} )</code>
	:;<var>X</var>:A [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.		:;<var>X</var>:A [[../#polygons\|closed point-list]] or a [[../#polygons\|polygon-stream]] defining one or more polygons.
	:;<var>N</var>:The requested number of simple polygons:		:;<var>N</var>:The requested number of simple polygons:
Line 13:		Line 13:
	::*no simple polygons can be found or one of the detected polygons is invalid		::*no simple polygons can be found or one of the detected polygons is invalid
	::*<var>N</var>>0 and the number of polygons defined by <var>X</var> is not equal to <var>N</var>		::*<var>N</var>>0 and the number of polygons defined by <var>X</var> is not equal to <var>N</var>
	;See also: [[../~~pgGet~~\|~~pgGet~~]], [[../~~pgItest~~\|~~pgItest~~]], [[../~~pgIline~~\|~~pgIline~~]], [[../~~pgXgrid~~\|~~pgXgrid~~]], [[../~~pgSplit~~\|~~pgSplit~~]], [[../~~pgTrans~~\|~~pgTrans~~]], [[../~~pgHull~~\|~~pgHull~~]]		;See also: [[../pgget\|pgget]], [[../pgitest\|pgitest]], [[../pgiline\|pgiline]], [[../pgxgrid\|pgxgrid]], [[../pgsplit\|pgsplit]], [[../pgtrans\|pgtrans]], [[../pghull\|pghull]]


	[[../#Functions\|<function list>]]		[[../#Functions\|<function list>]]

Toni at 12:44, 18 April 2011

2011-04-18T12:44:23Z

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:{{SUBPAGENAME}}}}
-=====pginit - initialise polygon=====
+Check or initialise a polygon stream.
-<code>P := pgInit( {pg_cplist}<var>X</var>, {number}<var>N</var>=0, {number}<var>E</var>=0 )</code>
+[[../#Functions|<function list>]]

Toni: moved Programmer Guide/Command Reference/EVAL/pginit - initialise polygon to Programmer Guide/Command Reference/EVAL/pginit

2011-04-01T09:09:04Z

moved Programmer Guide/Command Reference/EVAL/pginit - initialise polygon to Programmer Guide/Command Reference/EVAL/pginit

← Older revision	Revision as of 11:09, 1 April 2011
(No difference)

Admin: 1 revision: Initial import

2010-11-18T16:31:43Z

1 revision: Initial import

← Older revision	Revision as of 18:31, 18 November 2010
(No difference)

193.171.195.8: initial import

2010-05-17T13:05:27Z

initial import

New page

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
=====pginit - initialise polygon=====

=====Usage:=====

<code>P := pgInit( {pg_cplist}<var>X</var>, {number}<var>N</var>=0, {number}<var>E</var>=0 )</code>

=====Function:=====

Initialize polygons from a closed-point-list

=====Parameters:=====

;<var>X</var>

:A point-list defining one or more polygons.

;<var>N</var>

:The requested number of simple polygons:

:<var>N</var><=0 - unknown, computed during initialization

:<var>N</var>>0 - exactly <var>N</var> simple polygons must be contained in <var>X</var>

;<var>E</var>

:The maximum error for polygon simplification, if <var>E</var><=0 the simplification is skipped.

=====Result:=====

A polygon-stream <var>P</var> containing all simple-polygons defined by <var>X</var>.

If <var>N</var>>0, the number of polygons defined by <var>X</var> must be equal to <var>N</var>.

=====Examples:=====

See the example macro <code>polygon_stream</code> in the example script <code>polygon_examples.sts</code>.