SaveLayer

$image\bltlrgss.gif$ Editions $image\bltlrgss.gif$ Related Transactions $image\bltlrgss.gif$ Example

The SaveLayer transaction saves the specified layer, with the specified name, label, format, and rotation (if applicable). This transaction is used to save single layers displayed alone in a document window, or layers within a Spicer Multipage (.das) or Spicer Multilayer Page (.clf). You can choose whether to prompt the user about a conflict between the new file name and an existing one.

Type XTYP_EXECUTE

Syntax [SaveLayer(docwinID, layerID, saveas, "fileName", "layerLabel", checkExistence, formatID, rotation)]

Parameter	Data type	Values	Meaning
docwinID	DWORD	0 \| docwinID	active \| specific
layerID	DWORD	identifier of the layer to save
saveas	BOOL	0 \| 1	existing \| fileName
fileName	string	file name including path to save the layer under. See Remarks.
LayerLabel	string	label, maximum 80 characters
checkExistence	BOOL	0 \| 1	do not check \| check. See Remarks.
FormatID	WORD	0 File Format IDs	use existing format identifier of the new format. See Remarks.
Rotation	WORD	-1 0 \| 1 \| 2 \| 3	keep current rotation apply 0 \| 90 \| 180 \| 270 degrees counter-clockwise (raster only). See Remarks.

Remarks

If the layer is within a Spicer Multipage or a Spicer Multilayer Page document, its location must usually be the same as the document's.

If the checkExistence parameter is set to 1 and a file with the same name already exists, Imagenation will prompt the user before overwriting.

The formatID parameter is ignored if no fileName is specified

The rotation parameter applies only to rasters. If the layer is an edit layer, this parameter is ignored.

Release information

Added in Release 3.40.