You are here: Start » Function Reference » Image » Image Basics » CreateImageFromSurface_AnyScales

CreateImageFromSurface_AnyScales

Header:	FIL.h
Namespace:	fil
Module:	Vision3DStandard

Creates a depth image from the Z-values of the input surface.

Applications: Allows for performing 2D operations on 3D data.

Syntax

void fil::CreateImageFromSurface_AnyScales
(
	const fil::Surface& inSurface,
	fil::PlainType::Type inPixelType,
	ftl::Optional<double> inXOffset,
	ftl::Optional<double> inXScale,
	ftl::Optional<double> inYOffset,
	ftl::Optional<double> inYScale,
	ftl::Optional<double> inPixelOffset,
	ftl::Optional<double> inPixelScale,
	ftl::Optional<float> inMissingPointValue,
	fil::Image& outImage,
	ftl::Optional<fil::SurfaceFormat&> outSurfaceFormat = ftl::NIL
)

Parameters

Name	Type	Range	Default	Description
inSurface	const Surface&			Input surface
inPixelType	PlainType::Type		Real	Output image pixel type
inXOffset	Optional<double>		NIL	Offset for the X axis of the output image; if set to Nil, surface X offset is chosen
inXScale	Optional<double>	0.000001 -	NIL	Scale for the X axis of the output image; if set to Nil, surface X scale is chosen
inYOffset	Optional<double>		NIL	Offset for the Y axis of the output image; if set to Nil, surface Y offset is chosen
inYScale	Optional<double>	0.000001 -	NIL	Scale for the Y axis of the output image; if set to Nil, surface Y scale is chosen
inPixelOffset	Optional<double>		NIL	Offset that the input surface values have in the output image; if set to Nil, surface Z offset is chosen
inPixelScale	Optional<double>	0.0 -	1.0D	Scale that the input surface values have in the output image; if set to Nil, surface Z scale is chosen
inMissingPointValue	Optional<float>		0.0f	Value assigned to pixels where point is undefined
outImage	Image&			Input surface depth image
outSurfaceFormat	Optional<SurfaceFormat&>		NIL	Format of the surface that the output image represents

Optional Outputs

The computation of following outputs can be switched off by passing value ftl::NIL to these parameters: outSurfaceFormat.