_CopySelect, _CopySelectEx, _Paste, _PasteBrightfield, _PasteChannels, _PasteKeepAspect, _PasteRectangle, _PasteSelect, Copy, CopyBinary, CopySelect, CopySelectEx, Paste, PasteBinary, PasteBrightfield, PasteChannels, PasteRectangle, PasteWithName

Copy

This function runs the Edit > Copy command.

Description 

 Copy();

This function copies contents of the picture window to clipboard.

Note

If you can see some temporarily paintings on the screen (e.g. contours after object scanning or lines generated by interactive length measurement) or binary image in overlay, all these additional elements are joined with color (gray) image into one picture in the clipboard. Zoom window and toolbar are not copied. Instead, content of color (gray) image under these windows is copied.

See Also 
_CopySelect, CopySelect, _PasteSelect, PasteRectangle, Paste

CopyBinary

This function runs the Copy Binary command.

Description 

 CopyBinary();

This function copies the current binary image (in case of ND) from the selected (visible) layers into clipboard. The copied binary layers can be inserted into another image or as a new image.

See Also 
PasteBinary, BinLayerCopy

CopySelect

Interactive command to this function: Edit > Copy Selection > Select & Copy

Description 

 CopySelect(
   int  Left,
   int  Top,
   int  Right,
   int  Bottom
);

This function copies the specified region of the current image to clipboard. The margin values depend on the hardware and Windows display driver.

Parameters

int Left

Left margin in pixels.

int Top

Top margin in pixels.

int Right

Right margin in pixels.

int Bottom

Bottom margin in pixels.

Note

If you can see some temporarily paintings on the screen (e.g. contours after object scanning or lines generated by interactive length measurement) or binary image in overlay, all these additional elements are joined with color (gray) image into one picture in the clipboard. Zoom window and Tool bar are not copied. Instead, contents of color (gray) image under these windows are copied.

See Also 
Copy, _CopySelect, _PasteSelect, PasteRectangle, Paste

CopySelectEx

Interactive command to this function: Edit > Copy Selection > Select & Copy Last

Description 

 CopySelectEx(
   int  Left,
   int  Top,
   int  Width,
   int  Height
);

This function copies the specified region of the current image to clipboard.

Parameters

int Left

Left margin in pixels.

int Top

Top margin in pixels.

int Width

Image width in pixels.

int Height

Image height in pixels.

Note

This function is typically called, when you invoke the _CopySelect or the _CopySelectEx. An interactive equivalent is the _CopySelect function.

See Also 
_CopySelect, CopySelect

Paste

Interactive command to this function: Edit > Paste As New Image

Description 

 Paste();

This function pastes the image from clipboard and creates a new image.

Note

If the number of created images exceeds the number defined in the General Options dialog box, the first open images will be closed without saving any changes done to them.

See Also 
PasteWithName, _Paste

PasteBinary

Description 

 PasteBinary();

This function inserts the content of the clipboard to the current image as a binary layer. The clipboard content must contain binary data.

See Also 
CopyBinary, BinLayerCopy

PasteBrightfield

Description 

 PasteBrightfield();

This function inserts the clipboard data to the current image as a Brightfield channel.

See Also 
PasteBinary

PasteChannels

Description 

 PasteChannels();

This function pastes the previously copied channel(s) into the current image.

PasteRectangle

Description 

 PasteRectangle(
   int  Left,
   int  Top,
   int  Right,
   int  Bottom,
   int  Fit
);

This function pastes an image from clipboard to a rectangle in the current image specified by the parameters below. The margin values depend on the hardware and Windows display driver. An interactive equivalent is the _PasteRectangle function.

Parameters

int Left

Left margin in pixels.

int Top

Top margin in pixels.

int Right

Right margin in pixels.

int Bottom

Bottom margin in pixels.

int Fit

Way of image displaying.

0	Pasting without stretching.
1	Pasting with stretching to the rectangle.

Note

If an image in clipboard is a binary image it is pasted to the current binary image, otherwise it is pasted to the current color (gray) image.

See Also 
_PasteRectangle, Copy, _CopySelect, Paste, _PasteSelect, CopySelect

PasteWithName

Description 

 PasteWithName(
   char *DocumentName
);

This function pastes an image from clipboard and creates a new image with the specified name.

Parameters

char *DocumentName

Name of the image (displayed in the image caption).

Note

If the number of created images exceeds the number defined in the General Options dialog box, the first opened images will be closed without saving any changes done to them.

See Also 
Paste, _Paste

_CopySelect

This function runs the Edit > Copy Selection > Select & Copy command.

Description 

 _CopySelect();

This function displays the copy-rectangle cursor and enables you to select an appropriate rectangular image part for copying.

Note

If you can see some temporarily paintings on the screen (e.g. contours after object scanning or lines generated by interactive length measurement) or binary image in overlay, all these additional elements are joined with the color (gray) image into one picture in the clipboard. Zoom window and Toolbar are not copied. Instead, contents of color (gray) image under these windows are copied.

See Also 
Copy, _PasteSelect, PasteRectangle, Paste

_CopySelectEx

This function runs the Edit > Copy Selection > Select & Copy Last command.

Description 

 _CopySelectEx();

This function displays the copy-rectangle cursor and enables you to select a rectangular image part with fixed, last dimensions for copying.

Note

If you can see some temporarily paintings on the screen (e.g. contours after object scanning or lines generated by interactive length measurement) or binary image in overlay, all these additional elements are joined with the color (gray) image into one picture in the clipboard. Zoom window and Toolbar are not copied. Instead, contents of color (gray) image under these windows are copied.

See Also 
Copy, CopySelect, _PasteSelect, PasteRectangle, Paste

_Paste

This function runs the Edit > Paste As New Image command.

Description 

 _Paste();

This function pastes an image from clipboard and creates a new image.

Note

If the number of created images exceeds the number defined in the General Options dialog window, the first opened images will be closed, allowing the user to save any changes in them.

See Also 
Paste, Copy, _CopySelect, _PasteSelect, PasteRectangle, CopySelect

_PasteBrightfield

Description 

 _PasteBrightfield();

_PasteChannels

Description 

 _PasteChannels();

This function pastes a previously copied channel(s) into the current image.

_PasteKeepAspect

This function runs the Edit > Paste > Paste Keep Aspect command.

Description 

 _PasteKeepAspect();

This function pastes the copied selection and keeps its aspect.

_PasteRectangle

Description 

 _PasteRectangle();

This function displays the Paste-Rectangle cursor and enables the user to select an appropriate rectangular image part for pasting.

See Also 
Copy, Paste, _CopySelect, _PasteSelect, PasteRectangle, CopySelect

_PasteSelect

This function runs the Edit > Paste > Select & Paste command.

Description 

 _PasteSelect();

This function displays the paste-origin cursor and enables the user to mark the upper-left origin of the pasted image.

Note

If an image in clipboard is a binary image, it is pasted to the current binary image, otherwise it is pasted to the current color (gray) image.

See Also 
Copy, Paste, _CopySelect, PasteRectangle, CopySelect